ISPO SDK
    Preparing search index...

    Interface FilesApi

    Markdown
    interface FilesApi {
        editSession: FilesEditSessionApi;
        list(): Promise<FilesListEntry[]>;
        openWith(args: FilesOpenWithArgs): Promise<FilesOpenWithResult>;
        pick(
            args?: PowerboxOpenArgs,
        ): Promise<PowerboxPickResult | PowerboxPickResult[] | null>;
        publish(args: FilesPublishArgs): Promise<FilesPublishResult>;
        save(args: PowerboxSaveArgs): Promise<PowerboxSaveResult | null>;
    }
    Index
    editSession
    list openWith pick publish save
    editSession: FilesEditSessionApi

    • List this project's OWN published Files entries (spec §19.3). Non- interactive read of the caller's own owner-stamped artifacts — no picker, no gesture, and never another project's Files. Rides the same files.publish two-gate as publish.

      Returns Promise<FilesListEntry[]>

    Authority for files.list

    Reviewed request token: files.publish. Standing capability: files.publish.

    Handle structured ProjectRpcError failures. A timeout does not guarantee cancellation; do not automatically retry effects without a documented idempotency contract. Method authority and recovery. Example, effects, and verification.

    Authority for files.openWith

    Reviewed request token: files.edit. No static standing capability. Resource bindings, identity checks, or interactive consent may still apply.

    Handle structured ProjectRpcError failures. A timeout does not guarantee cancellation; do not automatically retry effects without a documented idempotency contract. Method authority and recovery. Example, effects, and verification.

    Authority for files.pick

    Reviewed request token: files.pick. No static standing capability. Resource bindings, identity checks, or interactive consent may still apply.

    Handle structured ProjectRpcError failures. A timeout does not guarantee cancellation; do not automatically retry effects without a documented idempotency contract. Method authority and recovery. Example, effects, and verification.

    Authority for files.publish

    Reviewed request token: files.publish. Standing capability: files.publish.

    Handle structured ProjectRpcError failures. A timeout does not guarantee cancellation; do not automatically retry effects without a documented idempotency contract. Method authority and recovery. Example, effects, and verification.

    Authority for files.save

    Reviewed request token: files.pick. No static standing capability. Resource bindings, identity checks, or interactive consent may still apply.

    Handle structured ProjectRpcError failures. A timeout does not guarantee cancellation; do not automatically retry effects without a documented idempotency contract. Method authority and recovery. Example, effects, and verification.

    Settings
    Member Visibility

    On This Page
    Properties
    Methods