> ISPO SDK documentation. [HTML](https://ispo.ai/docs/interfaces/core.RemoteCodingSessionsApi.html) · [Documentation index](https://ispo.ai/docs/llms.txt)

# Interface RemoteCodingSessionsApi

```typescript
interface RemoteCodingSessionsApi {
    cancel(
        input: RemoteCodingSessionMutationInput,
    ): Promise<{ session: RemoteCodingSession }>;
    create(
        input: RemoteCodingSessionCreateInput,
    ): Promise<
        {
            preflight?: {
                dirtyExcluded: true;
                dirtyFileCount: number;
                sourceRevision: string;
            };
            session: RemoteCodingSession;
        },
    >;
    events(input: RemoteCodingEventsInput): Promise<RemoteCodingEventsResult>;
    get(
        input: RemoteCodingSessionSelector,
    ): Promise<{ session: RemoteCodingSession }>;
    list(
        input?: RemoteCodingSessionListInput,
    ): Promise<
        { nextCursor?: string; sessions: readonly RemoteCodingSession[] },
    >;
    resume(
        input: RemoteCodingSessionMutationInput,
    ): Promise<{ session: RemoteCodingSession }>;
    send(
        input: RemoteCodingSessionSendInput,
    ): Promise<{ session: RemoteCodingSession }>;
}
```

Types: [cancel](#cancel-1), [RemoteCodingSessionMutationInput](core.RemoteCodingSessionMutationInput.md), [RemoteCodingSession](core.RemoteCodingSession.md), [create](#create-1), [RemoteCodingSessionCreateInput](core.RemoteCodingSessionCreateInput.md), [events](#events-1), [RemoteCodingEventsInput](core.RemoteCodingEventsInput.md), [RemoteCodingEventsResult](core.RemoteCodingEventsResult.md), [get](#get-1), [RemoteCodingSessionSelector](core.RemoteCodingSessionSelector.md), [list](#list-1), [RemoteCodingSessionListInput](core.RemoteCodingSessionListInput.md), [resume](#resume-1), [send](#send-1), [RemoteCodingSessionSendInput](core.RemoteCodingSessionSendInput.md)

##### Index

### <a id="methods"></a>Methods

[cancel](#cancel) [create](#create) [events](#events) [get](#get) [list](#list) [resume](#resume) [send](#send)

## <a id="methods-1"></a>Methods

### <a id="cancel"></a>cancel

*   <a id="cancel-1"></a>
    
    ```typescript
    cancel(
        input: RemoteCodingSessionMutationInput,
    ): Promise<{ session: RemoteCodingSession }>
    ```
    
    Types: [RemoteCodingSessionMutationInput](core.RemoteCodingSessionMutationInput.md), [RemoteCodingSession](core.RemoteCodingSession.md)
    
    #### Parameters
    
    *   input: [RemoteCodingSessionMutationInput](core.RemoteCodingSessionMutationInput.md)
    
    #### Returns Promise<{ session: [RemoteCodingSession](core.RemoteCodingSession.md) }\>
    

**Authority for `agent.remote.sessions.cancel`**

Reviewed request token: `agent.remoteCoding`. Standing capability: `agent.remoteCoding`.

Handle structured `ProjectRpcError` failures. A timeout does not guarantee cancellation; do not automatically retry effects without a documented idempotency contract. [Method authority and recovery](/docs/documents/Method_authority.md).

### <a id="create"></a>create

*   <a id="create-1"></a>
    
    ```typescript
    create(
        input: RemoteCodingSessionCreateInput,
    ): Promise<
        {
            preflight?: {
                dirtyExcluded: true;
                dirtyFileCount: number;
                sourceRevision: string;
            };
            session: RemoteCodingSession;
        },
    >
    ```
    
    Types: [RemoteCodingSessionCreateInput](core.RemoteCodingSessionCreateInput.md), [RemoteCodingSession](core.RemoteCodingSession.md)
    
    #### Parameters
    
    *   input: [RemoteCodingSessionCreateInput](core.RemoteCodingSessionCreateInput.md)
    
    #### Returns Promise<  
        {  
            preflight?: {  
                dirtyExcluded: true;  
                dirtyFileCount: number;  
                sourceRevision: string;  
            };  
            session: [RemoteCodingSession](core.RemoteCodingSession.md);  
        },  
    \>
    

**Authority for `agent.remote.sessions.create`**

Reviewed request token: `agent.remoteCoding`. Standing capability: `agent.remoteCoding`.

Handle structured `ProjectRpcError` failures. A timeout does not guarantee cancellation; do not automatically retry effects without a documented idempotency contract. [Method authority and recovery](/docs/documents/Method_authority.md).

### <a id="events"></a>events

*   <a id="events-1"></a>
    
    ```typescript
    events(input: RemoteCodingEventsInput): Promise<RemoteCodingEventsResult>
    ```
    
    Types: [RemoteCodingEventsInput](core.RemoteCodingEventsInput.md), [RemoteCodingEventsResult](core.RemoteCodingEventsResult.md)
    
    #### Parameters
    
    *   input: [RemoteCodingEventsInput](core.RemoteCodingEventsInput.md)
    
    #### Returns Promise<[RemoteCodingEventsResult](core.RemoteCodingEventsResult.md)\>
    

**Authority for `agent.remote.sessions.events`**

Reviewed request token: `agent.remoteCoding`. Standing capability: `agent.remoteCoding`.

Handle structured `ProjectRpcError` failures. A timeout does not guarantee cancellation; do not automatically retry effects without a documented idempotency contract. [Method authority and recovery](/docs/documents/Method_authority.md).

### <a id="get"></a>get

*   <a id="get-1"></a>
    
    ```typescript
    get(
        input: RemoteCodingSessionSelector,
    ): Promise<{ session: RemoteCodingSession }>
    ```
    
    Types: [RemoteCodingSessionSelector](core.RemoteCodingSessionSelector.md), [RemoteCodingSession](core.RemoteCodingSession.md)
    
    #### Parameters
    
    *   input: [RemoteCodingSessionSelector](core.RemoteCodingSessionSelector.md)
    
    #### Returns Promise<{ session: [RemoteCodingSession](core.RemoteCodingSession.md) }\>
    

**Authority for `agent.remote.sessions.get`**

Reviewed request token: `agent.remoteCoding`. Standing capability: `agent.remoteCoding`.

Handle structured `ProjectRpcError` failures. A timeout does not guarantee cancellation; do not automatically retry effects without a documented idempotency contract. [Method authority and recovery](/docs/documents/Method_authority.md).

### <a id="list"></a>list

*   <a id="list-1"></a>
    
    ```typescript
    list(
        input?: RemoteCodingSessionListInput,
    ): Promise<
        { nextCursor?: string; sessions: readonly RemoteCodingSession[] },
    >
    ```
    
    Types: [RemoteCodingSessionListInput](core.RemoteCodingSessionListInput.md), [RemoteCodingSession](core.RemoteCodingSession.md)
    
    #### Parameters
    
    *   `Optional`input: [RemoteCodingSessionListInput](core.RemoteCodingSessionListInput.md)
    
    #### Returns Promise<{ nextCursor?: string; sessions: readonly [RemoteCodingSession](core.RemoteCodingSession.md)\[\] }\>
    

**Authority for `agent.remote.sessions.list`**

Reviewed request token: `agent.remoteCoding`. Standing capability: `agent.remoteCoding`.

Handle structured `ProjectRpcError` failures. A timeout does not guarantee cancellation; do not automatically retry effects without a documented idempotency contract. [Method authority and recovery](/docs/documents/Method_authority.md).

### <a id="resume"></a>resume

*   <a id="resume-1"></a>
    
    ```typescript
    resume(
        input: RemoteCodingSessionMutationInput,
    ): Promise<{ session: RemoteCodingSession }>
    ```
    
    Types: [RemoteCodingSessionMutationInput](core.RemoteCodingSessionMutationInput.md), [RemoteCodingSession](core.RemoteCodingSession.md)
    
    #### Parameters
    
    *   input: [RemoteCodingSessionMutationInput](core.RemoteCodingSessionMutationInput.md)
    
    #### Returns Promise<{ session: [RemoteCodingSession](core.RemoteCodingSession.md) }\>
    

**Authority for `agent.remote.sessions.resume`**

Reviewed request token: `agent.remoteCoding`. Standing capability: `agent.remoteCoding`.

Handle structured `ProjectRpcError` failures. A timeout does not guarantee cancellation; do not automatically retry effects without a documented idempotency contract. [Method authority and recovery](/docs/documents/Method_authority.md).

### <a id="send"></a>send

*   <a id="send-1"></a>
    
    ```typescript
    send(
        input: RemoteCodingSessionSendInput,
    ): Promise<{ session: RemoteCodingSession }>
    ```
    
    Types: [RemoteCodingSessionSendInput](core.RemoteCodingSessionSendInput.md), [RemoteCodingSession](core.RemoteCodingSession.md)
    
    #### Parameters
    
    *   input: [RemoteCodingSessionSendInput](core.RemoteCodingSessionSendInput.md)
    
    #### Returns Promise<{ session: [RemoteCodingSession](core.RemoteCodingSession.md) }\>
    

**Authority for `agent.remote.sessions.send`**

Reviewed request token: `agent.remoteCoding`. Standing capability: `agent.remoteCoding`.

Handle structured `ProjectRpcError` failures. A timeout does not guarantee cancellation; do not automatically retry effects without a documented idempotency contract. [Method authority and recovery](/docs/documents/Method_authority.md).