@tembo-io/sdk 0.13.0 → 0.15.0

package/dist/cjs/resources/sessions/inputs.d.ts

@@ -0,0 +1,112 @@
+import { APIResource } from '../../resource';
+import { APIPromise } from '../../api-promise';
+import type { RequestOptions } from '../../internal/request-options';
+export declare class Inputs extends APIResource {
+    /**
+     * List pending questions for the active session agent.
+     *
+     * @param {string} sessionID
+     * @param {RequestOptions} [options] - Options to apply to the request, such as headers and an abort signal.
+     * @returns {APIPromise<InputListResponse>} List session inputs
+     *
+     * @example
+     * ```ts
+     * const input = await client.sessions.inputs.list('7c9e6679-7425-40de-944b-e07fc1f90ae7');
+     * ```
+     */
+    list(sessionID: string, options?: RequestOptions): APIPromise<InputListResponse>;
+    /**
+     * Answer a pending session question.
+     *
+     * @param {string} inputID
+     * @param {InputUpdateParams} params - The parameters to send with the request.
+     * @param {RequestOptions} [options] - Options to apply to the request, such as headers and an abort signal.
+     * @returns {APIPromise<InputUpdateResponse>} Update a session input
+     *
+     * @example
+     * ```ts
+     * const input = await client.sessions.inputs.update('inputId', {
+     *   sessionId: '7c9e6679-7425-40de-944b-e07fc1f90ae7',
+     *   answers: {},
+     * });
+     * ```
+     */
+    update(inputID: string, params: InputUpdateParams, options?: RequestOptions): APIPromise<InputUpdateResponse>;
+}
+export interface InputListResponse {
+    items: Array<InputListResponse.Item>;
+    nextCursor: null;
+}
+export declare namespace InputListResponse {
+    interface Item {
+        /**
+         * @minLength 1
+         */
+        id: string;
+        toolCallId: string;
+        status: 'pending' | 'answered';
+        /**
+         * @minItems 1
+         */
+        questions: Array<Item.Question>;
+    }
+    namespace Item {
+        interface Question {
+            id: string;
+            header: string;
+            question: string;
+            isOther: boolean;
+            isSecret: boolean;
+            options: Array<Question.Option>;
+        }
+        namespace Question {
+            interface Option {
+                label: string;
+                description: string;
+            }
+        }
+    }
+}
+export interface InputUpdateParams {
+    /**
+     * Path param
+     * @format uuid
+     */
+    sessionId: string;
+    /**
+     * Body param: Answers keyed by question ID. Send an empty object to skip the questions.
+     */
+    answers: Record<string, Array<string>>;
+}
+export interface InputUpdateResponse {
+    /**
+     * @minLength 1
+     */
+    id: string;
+    toolCallId: string;
+    status: 'pending' | 'answered';
+    /**
+     * @minItems 1
+     */
+    questions: Array<InputUpdateResponse.Question>;
+}
+export declare namespace InputUpdateResponse {
+    interface Question {
+        id: string;
+        header: string;
+        question: string;
+        isOther: boolean;
+        isSecret: boolean;
+        options: Array<Question.Option>;
+    }
+    namespace Question {
+        interface Option {
+            label: string;
+            description: string;
+        }
+    }
+}
+export declare namespace Inputs {
+    export { type InputListResponse as InputListResponse, type InputUpdateResponse as InputUpdateResponse, type InputUpdateParams as InputUpdateParams, };
+}
+//# sourceMappingURL=inputs.d.ts.map

package/dist/cjs/resources/sessions/inputs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inputs.d.ts","sourceRoot":"","sources":["../../../../src/resources/sessions/inputs.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAGrE,qBAAa,MAAO,SAAQ,WAAW;IACrC;;;;;;;;;;;OAWG;IACH,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,iBAAiB,CAAC;IAIhF;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CACJ,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,iBAAiB,EACzB,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,mBAAmB,CAAC;CAOnC;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,KAAK,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IACrC,UAAU,EAAE,IAAI,CAAC;CAClB;AAED,yBAAiB,iBAAiB,CAAC;IACjC,UAAiB,IAAI;QACnB;;WAEG;QACH,EAAE,EAAE,MAAM,CAAC;QACX,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,SAAS,GAAG,UAAU,CAAC;QAC/B;;WAEG;QACH,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;KACjC;IAED,UAAiB,IAAI,CAAC;QACpB,UAAiB,QAAQ;YACvB,EAAE,EAAE,MAAM,CAAC;YACX,MAAM,EAAE,MAAM,CAAC;YACf,QAAQ,EAAE,MAAM,CAAC;YACjB,OAAO,EAAE,OAAO,CAAC;YACjB,QAAQ,EAAE,OAAO,CAAC;YAClB,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;SACjC;QAED,UAAiB,QAAQ,CAAC;YACxB,UAAiB,MAAM;gBACrB,KAAK,EAAE,MAAM,CAAC;gBACd,WAAW,EAAE,MAAM,CAAC;aACrB;SACF;KACF;CACF;AAED,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,SAAS,GAAG,UAAU,CAAC;IAC/B;;OAEG;IACH,SAAS,EAAE,KAAK,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC;CAChD;AAED,yBAAiB,mBAAmB,CAAC;IACnC,UAAiB,QAAQ;QACvB,EAAE,EAAE,MAAM,CAAC;QACX,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,EAAE,OAAO,CAAC;QAClB,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;KACjC;IAED,UAAiB,QAAQ,CAAC;QACxB,UAAiB,MAAM;YACrB,KAAK,EAAE,MAAM,CAAC;YACd,WAAW,EAAE,MAAM,CAAC;SACrB;KACF;CACF;AACD,MAAM,CAAC,OAAO,WAAW,MAAM,CAAC;IAC9B,OAAO,EACL,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,KAAK,mBAAmB,IAAI,mBAAmB,EAC/C,KAAK,iBAAiB,IAAI,iBAAiB,GAC5C,CAAC;CACH"}

package/dist/cjs/resources/sessions/inputs.js

@@ -0,0 +1,48 @@
+"use strict";
+// File generated from our OpenAPI spec by Scalar. See README.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Inputs = void 0;
+const resource_1 = require("../../resource");
+const path_1 = require("../../internal/utils/path");
+class Inputs extends resource_1.APIResource {
+    /**
+     * List pending questions for the active session agent.
+     *
+     * @param {string} sessionID
+     * @param {RequestOptions} [options] - Options to apply to the request, such as headers and an abort signal.
+     * @returns {APIPromise<InputListResponse>} List session inputs
+     *
+     * @example
+     * ```ts
+     * const input = await client.sessions.inputs.list('7c9e6679-7425-40de-944b-e07fc1f90ae7');
+     * ```
+     */
+    list(sessionID, options) {
+        return this._client.get((0, path_1.path) `/v1/sessions/${sessionID}/inputs`, options);
+    }
+    /**
+     * Answer a pending session question.
+     *
+     * @param {string} inputID
+     * @param {InputUpdateParams} params - The parameters to send with the request.
+     * @param {RequestOptions} [options] - Options to apply to the request, such as headers and an abort signal.
+     * @returns {APIPromise<InputUpdateResponse>} Update a session input
+     *
+     * @example
+     * ```ts
+     * const input = await client.sessions.inputs.update('inputId', {
+     *   sessionId: '7c9e6679-7425-40de-944b-e07fc1f90ae7',
+     *   answers: {},
+     * });
+     * ```
+     */
+    update(inputID, params, options) {
+        const { sessionId, ...body } = params;
+        return this._client.patch((0, path_1.path) `/v1/sessions/${sessionId}/inputs/${inputID}`, {
+            body,
+            ...options,
+        });
+    }
+}
+exports.Inputs = Inputs;
+//# sourceMappingURL=inputs.js.map

package/dist/cjs/resources/sessions/inputs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inputs.js","sourceRoot":"","sources":["../../../../src/resources/sessions/inputs.ts"],"names":[],"mappings":";AAAA,6EAA6E;;;AAE7E,6CAA6C;AAG7C,oDAAiE;AAEjE,MAAa,MAAO,SAAQ,sBAAW;IACrC;;;;;;;;;;;OAWG;IACH,IAAI,CAAC,SAAiB,EAAE,OAAwB;QAC9C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAY,EAAA,gBAAgB,SAAS,SAAS,EAAE,OAAO,CAAC,CAAC;IACnF,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CACJ,OAAe,EACf,MAAyB,EACzB,OAAwB;QAExB,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QACtC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAA,WAAY,EAAA,gBAAgB,SAAS,WAAW,OAAO,EAAE,EAAE;YACnF,IAAI;YACJ,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;CACF;AA5CD,wBA4CC"}

package/dist/cjs/resources/sessions/queue.d.ts

@@ -0,0 +1,34 @@
+import { APIResource } from '../../resource';
+import { APIPromise } from '../../api-promise';
+import type { RequestOptions } from '../../internal/request-options';
+export declare class Queue extends APIResource {
+    /**
+     * Replace the order of messages waiting in a session queue.
+     *
+     * @param {string} sessionID
+     * @param {QueueUpdateParams} body - The request body to send.
+     * @param {RequestOptions} [options] - Options to apply to the request, such as headers and an abort signal.
+     * @returns {APIPromise<QueueUpdateResponse>} Update a session queue
+     *
+     * @example
+     * ```ts
+     * const queue = await client.sessions.queue.update('7c9e6679-7425-40de-944b-e07fc1f90ae7', {
+     *   messageIds: ['7c9e6679-7425-40de-944b-e07fc1f90ae7'],
+     * });
+     * ```
+     */
+    update(sessionID: string, body: QueueUpdateParams, options?: RequestOptions): APIPromise<QueueUpdateResponse>;
+}
+export interface QueueUpdateParams {
+    /**
+     * @maxItems 500
+     */
+    messageIds: Array<string>;
+}
+export interface QueueUpdateResponse {
+    messageIds: Array<string>;
+}
+export declare namespace Queue {
+    export { type QueueUpdateResponse as QueueUpdateResponse, type QueueUpdateParams as QueueUpdateParams };
+}
+//# sourceMappingURL=queue.d.ts.map

package/dist/cjs/resources/sessions/queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../../../src/resources/sessions/queue.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAGrE,qBAAa,KAAM,SAAQ,WAAW;IACpC;;;;;;;;;;;;;;OAcG;IACH,MAAM,CACJ,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,iBAAiB,EACvB,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,mBAAmB,CAAC;CAGnC;AAED,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CAC3B;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CAC3B;AACD,MAAM,CAAC,OAAO,WAAW,KAAK,CAAC;IAC7B,OAAO,EAAE,KAAK,mBAAmB,IAAI,mBAAmB,EAAE,KAAK,iBAAiB,IAAI,iBAAiB,EAAE,CAAC;CACzG"}

package/dist/cjs/resources/sessions/queue.js

@@ -0,0 +1,28 @@
+"use strict";
+// File generated from our OpenAPI spec by Scalar. See README.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Queue = void 0;
+const resource_1 = require("../../resource");
+const path_1 = require("../../internal/utils/path");
+class Queue extends resource_1.APIResource {
+    /**
+     * Replace the order of messages waiting in a session queue.
+     *
+     * @param {string} sessionID
+     * @param {QueueUpdateParams} body - The request body to send.
+     * @param {RequestOptions} [options] - Options to apply to the request, such as headers and an abort signal.
+     * @returns {APIPromise<QueueUpdateResponse>} Update a session queue
+     *
+     * @example
+     * ```ts
+     * const queue = await client.sessions.queue.update('7c9e6679-7425-40de-944b-e07fc1f90ae7', {
+     *   messageIds: ['7c9e6679-7425-40de-944b-e07fc1f90ae7'],
+     * });
+     * ```
+     */
+    update(sessionID, body, options) {
+        return this._client.put((0, path_1.path) `/v1/sessions/${sessionID}/queue`, { body, ...options });
+    }
+}
+exports.Queue = Queue;
+//# sourceMappingURL=queue.js.map

package/dist/cjs/resources/sessions/queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.js","sourceRoot":"","sources":["../../../../src/resources/sessions/queue.ts"],"names":[],"mappings":";AAAA,6EAA6E;;;AAE7E,6CAA6C;AAG7C,oDAAiE;AAEjE,MAAa,KAAM,SAAQ,sBAAW;IACpC;;;;;;;;;;;;;;OAcG;IACH,MAAM,CACJ,SAAiB,EACjB,IAAuB,EACvB,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAY,EAAA,gBAAgB,SAAS,QAAQ,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC/F,CAAC;CACF;AAvBD,sBAuBC"}

package/dist/cjs/resources/sessions/sessions.d.ts

@@ -7,12 +7,21 @@ import * as SourcesAPI from './sources';
 import { Sources, type SourceListResponse, type SourceRetrieveResponse, type SourceListParams } from './sources';
 import * as DiffsAPI from './diffs';
 import { Diffs, type DiffListResponse, type DiffRetrieveResponse, type DiffListParams, type DiffRetrieveParams } from './diffs';
+import * as InputsAPI from './inputs';
+import { Inputs, type InputListResponse, type InputUpdateResponse, type InputUpdateParams } from './inputs';
+import * as QueueAPI from './queue';
+import { Queue, type QueueUpdateResponse, type QueueUpdateParams } from './queue';
+import * as CommandsAPI from './commands';
+import { Commands, type CommandListResponse } from './commands';
 export declare class Sessions extends APIResource {
     events: PublicSessionEvents;
     sources: SourcesAPI.Sources;
     diffs: DiffsAPI.Diffs;
+    inputs: InputsAPI.Inputs;
+    queue: QueueAPI.Queue;
+    commands: CommandsAPI.Commands;
     /**
-     * List sessions you have permission to access, with cursor pagination.
+     * List and search sessions, including active or archived sessions, with repository, project, creator, and source filters and cursor pagination.
      *
      * @param {SessionListParams} [query] - The parameters to send with the request.
      * @param {RequestOptions} [options] - Options to apply to the request, such as headers and an abort signal.
@@ -31,7 +40,7 @@ export declare class Sessions extends APIResource {
      */
     list(query?: SessionListParams | null | undefined, options?: RequestOptions): APIPromise<SessionListResponse>;
     /**
-     * Create a session for a task. Provide the initial prompt in description and optionally configure its repositories and agent.
+     * Create a session for a task. Provide the initial prompt in description and optionally configure its repositories, agent, Build (normal) or Plan (planning) mode, and private or workspace visibility.
      *
      * @param {SessionCreateParams} body - The request body to send.
      * @param {RequestOptions} [options] - Options to apply to the request, such as headers and an abort signal.
@@ -66,7 +75,7 @@ export declare class Sessions extends APIResource {
      */
     retrieve(sessionID: string, options?: RequestOptions): APIPromise<SessionRetrieveResponse>;
     /**
-     * Update the configuration of a session you have permission to access.
+     * Update a session: archive or restore it, set priority, rename it, change agent/model, switch between Build (normal) and Plan (planning) modes, configure its workspace and branches, or change visibility between private and visible to workspace (public). Archiving uses level=0; restoring archived sessions uses level=1 and does not restart work. Use pins to pin or unpin sessions.
      *
      * @param {string} sessionID
      * @param {SessionUpdateParams} body - The request body to send.
@@ -80,7 +89,7 @@ export declare class Sessions extends APIResource {
      */
     update(sessionID: string, body: SessionUpdateParams, options?: RequestOptions): APIPromise<SessionUpdateResponse>;
     /**
-     * Delete a session you have permission to access.
+     * Archive a session and stop its VM without permanently deleting it. Equivalent to updateSession with level=0; restore with updateSession and level=1.
      *
      * @param {string} sessionID
      * @param {RequestOptions} [options] - Options to apply to the request, such as headers and an abort signal.
@@ -109,7 +118,7 @@ export declare class Sessions extends APIResource {
      */
     fork(sessionID: string, body: SessionForkParams, options?: RequestOptions): APIPromise<SessionForkResponse>;
     /**
-     * Interrupt active session work and continue with the next queued message.
+     * Interrupt active session work without archiving it. Continue with the next queued message, or set cancelQueued=true to cancel pending messages too.
      *
      * @param {string} sessionID
      * @param {SessionStopParams} [params] - The parameters to send with the request.
@@ -241,52 +250,93 @@ export declare namespace SessionDocumentNode {
 }
 export interface SessionListParams {
     /**
+     * Filter sessions created by this automation agent.
      * @format uuid
      */
     agentId?: string;
+    /**
+     * Filter by creator IDs, supplied as a comma-separated list.
+     */
     createdBy?: Array<string>;
     /**
+     * Only sessions created after this ISO 8601 timestamp.
      * @format date-time
      */
     createdAfter?: string;
     /**
+     * Continuation cursor from the previous response nextCursor. Omit for the first page; null nextCursor means there are no more pages.
      * @maxLength 500
      */
     cursor?: string;
     /**
+     * Maximum number of items to return in one page. Use nextCursor from the response to fetch more items.
      * @default 50
      * @minimum 1
      * @maximum 100
      */
     limit?: number;
+    /**
+     * Exclude sessions pinned by the authenticated user.
+     */
     excludePinned?: boolean;
+    /**
+     * Filter by external source IDs, supplied as a comma-separated list.
+     */
     externalIds?: Array<string>;
+    /**
+     * Filter by whether a session has an assigned project.
+     */
     hasProject?: boolean;
     /**
-     * @default true
+     * Include archived sessions in the all-state view. Defaults to true; state=archived explicitly selects archived sessions.
      */
     includeArchived?: boolean;
     /**
+     * Include totalCount. Not supported with state=active.
      * @default false
      */
     includeTotal?: boolean;
+    /**
+     * Filter by participant IDs, supplied as a comma-separated list.
+     */
     participant?: Array<string>;
+    /**
+     * Filter by pending reviewer keys, supplied as a comma-separated list.
+     */
     pendingReviewerKeys?: Array<string>;
+    /**
+     * Filter by project IDs, supplied as a comma-separated list.
+     */
     projectIds?: Array<string>;
+    /**
+     * Filter by linked pull request statuses: open, merged, or closed, supplied as a comma-separated list.
+     */
     pullRequestStatuses?: Array<'open' | 'merged' | 'closed'>;
+    /**
+     * Filter by repository IDs, supplied as a comma-separated list.
+     */
     repositoryIds?: Array<string>;
     /**
+     * Search session titles, task prompts, kinds, and source names or types.
      * @minLength 1
      * @maxLength 1000
      */
     search?: string;
     /**
+     * Timestamp used to sort sessions, newest first.
      * @default lastQueuedAt
      */
     sortBy?: 'lastQueuedAt' | 'createdAt' | 'updatedAt';
+    /**
+     * Filter by session source IDs, supplied as a comma-separated list.
+     */
     sourceIds?: Array<string>;
+    /**
+     * Filter by session source types, supplied as a comma-separated list.
+     */
     sourceTypes?: Array<string>;
     /**
+     * Select all sessions, currently active work, or archived sessions. Use archived to find sessions to restore.
      * @default all
      */
     state?: 'all' | 'active' | 'archived';
@@ -435,39 +485,58 @@ export interface SessionCreateParams {
      */
     description: string;
     /**
+     * Agent and model key to run, such as claudeCode:claude-fable-5-1. Omit to use the default.
      * @minLength 1
      * @maxLength 500
      */
     agent?: string;
     /**
+     * Git branch to start work from. Omit or use null for the repository default.
      * @minLength 1
      * @maxLength 500
      */
     baseBranch?: string | null;
     /**
+     * MCP server or connection IDs to enable for the session.
      * @default []
      * @maxItems 100
      */
     mcpServers?: Array<string>;
+    /**
+     * Project environment to use for the workspace. Omit or use null for the default.
+     */
     projectId?: string | null;
+    /**
+     * VM size for the session workspace.
+     */
     sandboxSize?: 'nano' | 'micro' | 'small' | 'medium' | 'large' | 'xl' | 'xxl' | 'ultra';
     /**
+     * Default target branch for pull requests created by the session.
      * @minLength 1
      * @maxLength 500
      */
     targetBranch?: string | null;
+    /**
+     * Session visibility: private or visible to workspace (public).
+     */
     visibility?: 'private' | 'public';
+    /**
+     * Agent-specific runtime options, such as reasoning effort.
+     */
     agentOptions?: SessionCreateParams.AgentOptions;
     /**
+     * Git branch for this session. Omit or use null to generate a branch name.
      * @minLength 1
      * @maxLength 500
      */
     branchName?: string | null;
     /**
+     * Repository IDs to make available in the session workspace.
      * @maxItems 100
      */
     codeRepositoryIds?: Array<string>;
     /**
+     * Optional caller-supplied session UUID. Omit to generate one.
      * @format uuid
      */
     id?: string;
@@ -476,11 +545,21 @@ export interface SessionCreateParams {
      */
     richContent?: SessionDocumentNode & MessagesAPI.TipTapDocument;
     /**
+     * Pull request to associate with the session. Requires richContent.
      * @format uuid
      */
     pullRequestId?: string;
+    /**
+     * Whether to queue the initial task immediately instead of only creating the session.
+     */
     queueRightAway?: boolean;
+    /**
+     * Whether to create a chat session or a terminal session.
+     */
     sessionMode?: 'chat' | 'terminal';
+    /**
+     * Coding agent to start in a terminal session.
+     */
     startupAgent?: 'claudeCode' | 'codex' | 'opencode' | 'pi' | 'amp' | 'cursor';
 }
 export declare namespace SessionCreateParams {
@@ -490,7 +569,13 @@ export declare namespace SessionCreateParams {
          * @maxLength 100
          */
         reasoningLevel?: string;
+        /**
+         * Use Build (normal) to execute work or Plan (planning) to plan before writing code.
+         */
         mode?: 'normal' | 'planning';
+        /**
+         * Preferred execution speed when supported by the selected runtime.
+         */
         speed?: 'normal' | 'fast' | 'ultrafast';
         goal?: AgentOptions.Goal;
     }
@@ -898,50 +983,75 @@ export declare namespace SessionRetrieveResponse {
 }
 export interface SessionUpdateParams {
     /**
+     * Change the agent and model key. Null clears the session override.
      * @minLength 1
      * @maxLength 500
      */
     agent?: string | null;
+    /**
+     * Change agent-specific runtime options, such as reasoning effort.
+     */
     agentOptions?: SessionUpdateParams.AgentOptions;
     /**
+     * Change the starting Git branch. Null clears the session override.
      * @minLength 1
      * @maxLength 500
      */
     baseBranch?: string | null;
     /**
+     * Change the session Git branch name. Null clears the stored name.
      * @minLength 1
      * @maxLength 500
      */
     branchName?: string | null;
     /**
+     * Replace the initial task prompt; only the session creator can change it. Use createMessage to send a follow-up task.
      * @minLength 1
      * @maxLength 1000000
      */
     description?: string;
+    /**
+     * Replace the initial prompt rich-text document, or null to clear it. Only the session creator can change it.
+     */
     richContent?: (SessionDocumentNode & MessagesAPI.TipTapDocument) | null;
     /**
-     * Set 0 to archive the session and stop its VM, or 1 to restore it without restarting work. Omit to preserve the current level.
+     * Archive or restore the session and set its priority: 0 archives and stops its VM; 1 restores without restarting work; 2–100 also keep it unarchived and set its priority level. Omit to preserve the current level.
      * @minimum 0
      * @maximum 100
      */
     level?: number;
     /**
+     * Replace the enabled MCP server or connection IDs. An empty array clears the selection.
      * @maxItems 100
      */
     mcpServers?: Array<string>;
+    /**
+     * Switch between Build (normal) and Plan (planning) modes.
+     */
     mode?: 'normal' | 'planning';
+    /**
+     * Change the project environment used for the workspace. Null clears the session override.
+     */
     projectId?: string | null;
+    /**
+     * Change the workspace VM size. Null clears the session override.
+     */
     sandboxSize?: 'nano' | 'micro' | 'small' | 'medium' | 'large' | 'xl' | 'xxl' | 'ultra' | null;
     /**
+     * Change the default pull request target branch. Null clears the session override.
      * @minLength 1
      * @maxLength 500
      */
     targetBranch?: string | null;
     /**
+     * Rename the session.
      * @minLength 1
      * @maxLength 1000
      */
     title?: string;
+    /**
+     * Change session visibility: private or visible to workspace (public). Only the session creator can change it.
+     */
     visibility?: 'private' | 'public';
 }
 export declare namespace SessionUpdateParams {
@@ -951,7 +1061,13 @@ export declare namespace SessionUpdateParams {
          * @maxLength 100
          */
         reasoningLevel?: string;
+        /**
+         * Use Build (normal) to execute work or Plan (planning) to plan before writing code.
+         */
         mode?: 'normal' | 'planning';
+        /**
+         * Preferred execution speed when supported by the selected runtime.
+         */
         speed?: 'normal' | 'fast' | 'ultrafast';
         goal?: AgentOptions.Goal;
     }
@@ -1170,11 +1286,13 @@ export interface SessionDeleteResponse {
 }
 export interface SessionForkParams {
     /**
+     * Optional first task for the independent fork. Existing messages are not replayed.
      * @minLength 1
      * @maxLength 1000000
      */
     prompt?: string;
     /**
+     * Display title for the forked session.
      * @minLength 1
      * @maxLength 1000
      */
@@ -1382,6 +1500,9 @@ export declare namespace SessionForkResponse {
     }
 }
 export interface SessionStopParams {
+    /**
+     * Also cancel pending queued messages instead of continuing with the next queued message. Does not archive the session.
+     */
     cancelQueued?: boolean;
 }
 export interface SessionStopResponse {
@@ -1407,8 +1528,12 @@ export interface SessionStopResponse {
     cancelledRuntimeTurns: number;
 }
 export interface SessionListEventsParams {
+    /**
+     * Continuation cursor from the previous response nextCursor. Omit for the first page; null nextCursor means there are no more pages.
+     */
     cursor?: string | number;
     /**
+     * Maximum number of items to return in one page. Use nextCursor from the response to fetch more items.
      * @default 50
      * @minimum 1
      * @maximum 100
@@ -1454,5 +1579,8 @@ export declare namespace Sessions {
     export { type SessionEventData as SessionEventData, type SessionDocumentNode as SessionDocumentNode, type SessionListResponse as SessionListResponse, type SessionCreateResponse as SessionCreateResponse, type SessionRetrieveResponse as SessionRetrieveResponse, type SessionUpdateResponse as SessionUpdateResponse, type SessionDeleteResponse as SessionDeleteResponse, type SessionForkResponse as SessionForkResponse, type SessionStopResponse as SessionStopResponse, type SessionListEventsResponse as SessionListEventsResponse, type SessionListParams as SessionListParams, type SessionCreateParams as SessionCreateParams, type SessionUpdateParams as SessionUpdateParams, type SessionForkParams as SessionForkParams, type SessionStopParams as SessionStopParams, type SessionListEventsParams as SessionListEventsParams, };
     export { Sources as Sources, type SourceListResponse as SourceListResponse, type SourceRetrieveResponse as SourceRetrieveResponse, type SourceListParams as SourceListParams, };
     export { Diffs as Diffs, type DiffListResponse as DiffListResponse, type DiffRetrieveResponse as DiffRetrieveResponse, type DiffListParams as DiffListParams, type DiffRetrieveParams as DiffRetrieveParams, };
+    export { Inputs as Inputs, type InputListResponse as InputListResponse, type InputUpdateResponse as InputUpdateResponse, type InputUpdateParams as InputUpdateParams, };
+    export { Queue as Queue, type QueueUpdateResponse as QueueUpdateResponse, type QueueUpdateParams as QueueUpdateParams, };
+    export { Commands as Commands, type CommandListResponse as CommandListResponse };
 }
 //# sourceMappingURL=sessions.d.ts.map