ISPO SDK
    Preparing search index...

    Interface AgentApi

    Markdown
    interface AgentApi {
        activities: AgentActivitiesApi;
        providers: AgentProvidersApi;
        remote: RemoteCodingApi;
        runs: AgentRunsApi;
        sessions: AgentSessionsApi;
        spawn(input: AgentSpawnInput): Promise<AgentSpawnResult>;
        stop(input: AgentStopInput): Promise<AgentStopResult>;
    }
    Index
    activities: AgentActivitiesApi

    Durable isolated-checkout coding on an explicitly enrolled remote target.

    Experimental private ISPO Cloud finite-run surface. Feature-flagged host side.

    Authority for agent.runs

    Reviewed request token: agent.hostedRuns. Standing capability: agent.hostedRuns.

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

    Authority for agent.spawn

    Reviewed request token: agent.dispatch. Authority depends on the arguments, resource, and caller; check the live capability surface.

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

    • Terminate a running agent terminal by id (kills the underlying process). Gated by agent.dispatch for your own terminals; stopping a terminal you spawned into ANOTHER target additionally needs the agent.orchestrate grant (§10.22). Idempotent: stopping an already-ended terminal resolves { stopped: false } rather than throwing.

      Parameters

      Returns Promise<AgentStopResult>

    Authority for agent.stop

    Reviewed request token: agent.dispatch. Standing capability: agent.dispatch.

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