@github/copilot-sdk 1.0.7-preview.3 → 1.0.8-preview.0

package/dist/generated/rpc.d.ts

@@ -484,6 +484,79 @@ export type ExternalToolTextResultForLlmContentResourceLinkIconTheme =
  */
 /** @experimental */
 export type ExternalToolTextResultForLlmContentResourceDetails = EmbeddedTextResourceContents | EmbeddedBlobResourceContents;
+/**
+ * Kind of factory progress line.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "FactoryLogLineKind".
+ */
+/** @experimental */
+export type FactoryLogLineKind = 
+/** A narrator log line. */
+"log"
+/** A named factory phase marker. */
+ | "phase";
+/**
+ * Machine-readable factory run failure.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "FactoryRunFailure".
+ */
+/** @experimental */
+export type FactoryRunFailure = {
+    kind: FactoryRunFailureKind;
+    /**
+     * Approved effective ceiling that was reached.
+     */
+    value: number;
+    /**
+     * Factory run identifier.
+     */
+    runId: string;
+    type: "factory_limit_reached";
+} | {
+    /**
+     * Factory run identifier whose changed limits were declined.
+     */
+    runId: string;
+    /**
+     * Human-readable reason the resume did not proceed.
+     */
+    reason: string;
+    type: "factory_resume_declined";
+};
+/**
+ * Cumulative resource ceiling that stopped a factory run.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "FactoryRunFailureKind".
+ */
+/** @experimental */
+export type FactoryRunFailureKind = 
+/** The run admitted the approved maximum total number of subagents. */
+"maxTotalSubagents"
+/** The run reached the approved timeout deadline. */
+ | "timeout";
+/**
+ * Current or terminal state of a factory run.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "FactoryRunStatus".
+ */
+/** @experimental */
+export type FactoryRunStatus = 
+/** The run was minted and is awaiting approval. */
+"pending"
+/** The run is executing. */
+ | "running"
+/** The run completed successfully. */
+ | "completed"
+/** The run was interrupted while resource budget remained. */
+ | "halted"
+/** The run was cancelled before completion. */
+ | "cancelled"
+/** The factory body failed or reached a cumulative resource ceiling. */
+ | "error";
 /**
  * Content filtering mode to apply to all tools, or a map of tool name to content filtering mode.
  *
@@ -784,6 +857,18 @@ export type McpHeadersHandlePendingHeadersRefreshRequest = {
 } | {
     kind: "none";
 };
+/**
+ * Consumer allowed to call an MCP tool.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "McpToolUiVisibility".
+ */
+/** @experimental */
+export type McpToolUiVisibility = 
+/** The model may call the tool. */
+"model"
+/** An MCP App view may call the tool. */
+ | "app";
 /**
  * Host response to the pending OAuth request.
  *
@@ -4558,6 +4643,340 @@ export interface ExternalToolTextResultForLlmContentResource {
     type: "resource";
     resource: ExternalToolTextResultForLlmContentResourceDetails;
 }
+/**
+ * Parameters for cooperatively aborting a factory body.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "FactoryAbortRequest".
+ */
+/** @experimental */
+export interface FactoryAbortRequest {
+    /**
+     * Target session identifier
+     */
+    sessionId: string;
+    /**
+     * Factory run identifier.
+     */
+    runId: string;
+}
+/**
+ * Acknowledgement that a factory request was accepted.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "FactoryAckResult".
+ */
+/** @experimental */
+export interface FactoryAckResult {
+}
+/**
+ * Options for one factory-scoped subagent call.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "FactoryAgentOptions".
+ */
+/** @experimental */
+export interface FactoryAgentOptions {
+    /**
+     * Optional label distinguishing otherwise identical memoized agent calls.
+     */
+    label?: string;
+    /**
+     * Optional JSON Schema for structured agent output.
+     */
+    schema?: {
+        [k: string]: unknown | undefined;
+    };
+    /**
+     * Optional model identifier for the subagent.
+     */
+    model?: string;
+}
+/**
+ * Parameters for one factory-scoped subagent call.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "FactoryAgentRequest".
+ */
+/** @experimental */
+export interface FactoryAgentRequest {
+    /**
+     * Factory run identifier that owns the subagent.
+     */
+    factoryRunId: string;
+    /**
+     * Prompt to send to the subagent.
+     */
+    prompt: string;
+    opts: FactoryAgentOptions;
+}
+/**
+ * Result of one factory-scoped subagent call.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "FactoryAgentResult".
+ */
+/** @experimental */
+export interface FactoryAgentResult {
+    /**
+     * Agent result, omitted when the agent produced no result.
+     */
+    result?: {
+        [k: string]: unknown | undefined;
+    };
+}
+/**
+ * Parameters for cancelling a factory run.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "FactoryCancelRequest".
+ */
+/** @experimental */
+export interface FactoryCancelRequest {
+    /**
+     * Factory run identifier.
+     */
+    runId: string;
+}
+/**
+ * Parameters sent to the owning extension to execute a factory closure.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "FactoryExecuteRequest".
+ */
+/** @experimental */
+export interface FactoryExecuteRequest {
+    /**
+     * Target session identifier
+     */
+    sessionId: string;
+    /**
+     * Registered factory name.
+     */
+    name: string;
+    /**
+     * Factory run identifier.
+     */
+    runId: string;
+    /**
+     * Factory input value.
+     */
+    args: {
+        [k: string]: unknown | undefined;
+    };
+}
+/**
+ * Result returned by an extension factory closure.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "FactoryExecuteResult".
+ */
+/** @experimental */
+export interface FactoryExecuteResult {
+    /**
+     * Factory result value.
+     */
+    result: {
+        [k: string]: unknown | undefined;
+    };
+}
+/**
+ * Parameters for retrieving a factory run.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "FactoryGetRunRequest".
+ */
+/** @experimental */
+export interface FactoryGetRunRequest {
+    /**
+     * Factory run identifier.
+     */
+    runId: string;
+}
+/**
+ * Parameters for reading a factory journal entry.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "FactoryJournalGetRequest".
+ */
+/** @experimental */
+export interface FactoryJournalGetRequest {
+    /**
+     * Factory run identifier.
+     */
+    runId: string;
+    /**
+     * Namespaced journal key.
+     */
+    key: string;
+}
+/**
+ * Result of reading a factory journal entry.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "FactoryJournalGetResult".
+ */
+/** @experimental */
+export interface FactoryJournalGetResult {
+    /**
+     * Whether the journal contained the requested key.
+     */
+    hit: boolean;
+    /**
+     * Cached JSON result. The hit field distinguishes a cached JSON null from a miss.
+     */
+    resultJson?: {
+        [k: string]: unknown | undefined;
+    };
+}
+/**
+ * Parameters for storing a factory journal entry.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "FactoryJournalPutRequest".
+ */
+/** @experimental */
+export interface FactoryJournalPutRequest {
+    /**
+     * Factory run identifier.
+     */
+    runId: string;
+    /**
+     * Namespaced journal key.
+     */
+    key: string;
+    /**
+     * JSON result to memoize.
+     */
+    resultJson: {
+        [k: string]: unknown | undefined;
+    };
+}
+/**
+ * One ordered factory progress line.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "FactoryLogLine".
+ */
+/** @experimental */
+export interface FactoryLogLine {
+    /**
+     * Monotonic sequence number within the factory run.
+     */
+    seq: number;
+    kind: FactoryLogLineKind;
+    /**
+     * Progress text.
+     */
+    text: string;
+}
+/**
+ * Parameters for recording factory progress.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "FactoryLogRequest".
+ */
+/** @experimental */
+export interface FactoryLogRequest {
+    /**
+     * Factory run identifier.
+     */
+    runId: string;
+    /**
+     * Ordered progress lines to append.
+     */
+    lines: FactoryLogLine[];
+}
+/**
+ * Wire-only per-invocation factory resource ceiling overrides.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "FactoryRunLimits".
+ */
+/** @experimental */
+export interface FactoryRunLimits {
+    /**
+     * Maximum number of factory subagents that may run concurrently.
+     */
+    maxConcurrentSubagents?: number;
+    /**
+     * Maximum total number of factory subagents that may be admitted.
+     */
+    maxTotalSubagents?: number;
+    /**
+     * Factory active-run timeout in milliseconds.
+     */
+    timeout?: number;
+}
+/**
+ * Parameters for invoking a registered factory.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "FactoryRunRequest".
+ */
+/** @experimental */
+export interface FactoryRunRequest {
+    /**
+     * Registered factory name.
+     */
+    name: string;
+    /**
+     * Factory input value.
+     */
+    args: {
+        [k: string]: unknown | undefined;
+    };
+    options?: RunOptions;
+}
+/**
+ * Options controlling factory invocation.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "RunOptions".
+ */
+/** @experimental */
+export interface RunOptions {
+    limits?: FactoryRunLimits;
+    /**
+     * Run identifier whose journal and progress should seed this resumed run.
+     */
+    resumeFromRunId?: string;
+}
+/**
+ * Complete current or terminal factory run envelope.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "FactoryRunResult".
+ */
+/** @experimental */
+export interface FactoryRunResult {
+    /**
+     * Factory run identifier.
+     */
+    runId: string;
+    status: FactoryRunStatus;
+    /**
+     * Completed factory result.
+     */
+    result?: {
+        [k: string]: unknown | undefined;
+    };
+    /**
+     * Error message for an errored run.
+     */
+    error?: string;
+    failure?: FactoryRunFailure;
+    /**
+     * Reason for a halted or cancelled run.
+     */
+    reason?: string;
+    /**
+     * Partial journal and progress snapshot for a halted, cancelled, or errored run.
+     */
+    snapshot?: {
+        [k: string]: unknown | undefined;
+    };
+}
 /**
  * Optional user prompt to combine with the fleet orchestration instructions.
  *
@@ -5224,13 +5643,17 @@ export interface LlmInferenceHttpRequestStartRequest {
     headers: LlmInferenceHeaders;
     transport?: LlmInferenceHttpRequestStartTransport;
     /**
-     * Stable per-agent-instance id attributing this request to a specific agent trajectory. Present when the request originates from an agent turn; absent for requests issued outside any agent context (e.g. some SDK callers). A request with an `agentId` but no `parentAgentId` is a root-agent request; one carrying both is a subagent request. Sourced from the runtime's per-request agent context and surfaced on the envelope independently of transport, so it is available for both first-party (CAPI) and BYOK/custom-provider requests; on the CAPI transport the runtime derives the upstream `X-Agent-Task-Id` header from this same context. Consumers routing each provider call to a training trajectory should key on this rather than on lifecycle events, since it is available on the request path before sampling.
+     * Stable identity of the agent trajectory that issued this request. Present when the request originates from an agent turn; absent for requests outside any agent context. This is the same identity used by lifecycle and bridged session events and remains constant across turns and retries.
      */
     agentId?: string;
     /**
-     * Id of the parent agent that spawned the agent issuing this request. Present only for subagent requests; absent for root-agent requests and non-agent requests. Combined with `agentId`, this lets consumers attribute a call to a child trajectory versus the root. Like `agentId`, it comes from the runtime's per-request agent context independently of transport; on the CAPI transport the runtime derives the upstream `X-Parent-Agent-Id` header from this same context.
+     * Stable identity of the immediate parent trajectory. Present for child trajectories such as subagents and conversation-sampling requests; absent for root-agent and non-agent requests.
      */
     parentAgentId?: string;
+    /**
+     * Identity of the agent invocation (one agentic loop) that issued this request. It remains fixed across physical retries within the invocation and is distinct from the stable trajectory `agentId`. A caller-supplied invocation id always takes precedence (this covers auxiliary calls that have no model call id). Otherwise, first-party CAPI requests fall back to the runtime's agent task id — the same value the runtime emits as the `X-Agent-Task-Id` header — while custom-provider requests fall back to the model call id.
+     */
+    agentInvocationId?: string;
     /**
      * Coarse classification of the interaction that produced this request. Open string for forward-compatibility; known values include `conversation-agent`, `conversation-subagent`, `conversation-sampling`, `conversation-background`, `conversation-compaction`, and `conversation-user`. Absent when the runtime did not classify the request. Comes from the runtime's per-request agent context independently of transport; on the CAPI transport the runtime derives the upstream `X-Interaction-Type` header from this same context.
      */
@@ -6392,7 +6815,7 @@ export interface McpListToolsResult {
     tools: McpTools[];
 }
 /**
- * MCP tool metadata with tool name and optional description.
+ * MCP tool metadata with tool name, optional description, and normalized MCP Apps discovery metadata.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "McpTools".
@@ -6407,6 +6830,24 @@ export interface McpTools {
      * Tool description, when provided.
      */
     description?: string;
+    ui?: McpToolUi;
+}
+/**
+ * Normalized MCP Apps discovery metadata from a tool's `_meta.ui` block.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "McpToolUi".
+ */
+/** @experimental */
+export interface McpToolUi {
+    /**
+     * URI of the tool's MCP App resource, typically a `ui://` resource identifier. Use `session.mcp.resources.read` to fetch its HTML and resource metadata.
+     */
+    resourceUri?: string;
+    /**
+     * Tool visibility advertised by the server. When absent, MCP Apps defaults apply.
+     */
+    visibility?: McpToolUiVisibility[];
 }
 /**
  * Pending MCP OAuth request ID and host-provided token or cancellation response.
@@ -7102,7 +7543,7 @@ export interface SessionWorkingDirectoryContext {
     baseCommit?: string;
 }
 /**
- * Notify the session that its working directory context has changed. Emits a `session.context_changed` event so consumers (telemetry, OTel tracker, ACP, the timeline UI) can react. Use this when the host has detected a cwd/branch/repo change outside the session's normal lifecycle (e.g., after a shell command in interactive mode).
+ * Notify the session that its working directory context has changed. Emits a `session.context_changed` event so consumers (telemetry, OTel tracker, ACP, the timeline UI) can react. Use this when the host has detected a cwd/branch/repo change outside the session's normal lifecycle (e.g., after a shell command in interactive mode). For a local session, a report whose `cwd` diverges from the session's current working directory is ignored (the call still succeeds but records nothing and emits no event); move a local session's working directory via `metadata.setWorkingDirectory` instead.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "MetadataRecordContextChangeResult".
@@ -10597,6 +11038,14 @@ export interface SandboxConfig {
      * Whether to auto-add the current working directory to readwritePaths. Default: true.
      */
     addCurrentWorkingDirectory?: boolean;
+    /**
+     * Whether to inject the Copilot GitHub token as an `http.<host>.extraheader` so authenticated HTTPS git works inside the sandbox without the shell-based credential helper the sandbox blocks. Default: false (opt-in).
+     */
+    gitAuth?: boolean;
+    /**
+     * Whether to export `GH_TOKEN` so the `gh` CLI authenticates inside the sandbox without the OS keyring the sandbox blocks. Default: false (opt-in).
+     */
+    ghAuth?: boolean;
 }
 /**
  * User-managed sandbox policy fragment merged into the auto-discovered base policy.
@@ -11034,6 +11483,10 @@ export interface ServerSkillList {
      * All discovered skills across all sources
      */
     skills: ServerSkill[];
+    /**
+     * Messages for skills that failed to load (e.g. malformed SKILL.md). Empty when host skills are excluded so host-local paths are not disclosed to multitenant callers.
+     */
+    errors?: string[];
 }
 /**
  * Current activity flags for the session.
@@ -11749,6 +12202,10 @@ export interface SessionModelList {
      * Available models, ordered with the most preferred default first. Includes both Copilot (CAPI) models and any registry BYOK models; a BYOK model appears under its provider-qualified selection id (`provider/id`).
      */
     list: unknown[];
+    /**
+     * Cost categories for the full CAPI catalog, including picker-disabled models that Auto may select. Metadata only; entries absent from `list` are not manually selectable.
+     */
+    modelPriceCategories?: SessionModelPriceCategory[];
     /**
      * Per-quota snapshots returned alongside the model list, keyed by quota type.
      */
@@ -11756,6 +12213,17 @@ export interface SessionModelList {
         [k: string]: unknown | undefined;
     };
 }
+/**
+ * Cost-category metadata for a CAPI model.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SessionModelPriceCategory".
+ */
+/** @experimental */
+export interface SessionModelPriceCategory {
+    id: string;
+    priceCategory: ModelPickerPriceCategory;
+}
 /**
  * Session construction options.
  *
@@ -13097,6 +13565,10 @@ export interface SessionUpdateOptionsResult {
      * Whether the operation succeeded
      */
     success: boolean;
+    /**
+     * Number of hooks loaded from installed plugins, returned when installedPlugins is updated
+     */
+    pluginHookCount?: number;
 }
 /**
  * User-requested shell execution cancellation handle.
@@ -14795,6 +15267,10 @@ export interface UsageMetricsCodeChanges {
 export interface UsageMetricsModelMetric {
     requests: UsageMetricsModelMetricRequests;
     usage: UsageMetricsModelMetricUsage;
+    /**
+     * Latest known prompt-cache expiration for this model. A timestamp in the past indicates that the observed cache has expired.
+     */
+    cacheExpiresAt?: string;
     /**
      * Accumulated nano-AI units cost for this model
      */
@@ -15964,6 +16440,68 @@ export declare function createSessionRpc(connection: MessageConnection, sessionI
         };
     };
     /** @experimental */
+    factory: {
+        /**
+         * Runs a registered factory by name at the top level.
+         *
+         * @param params Parameters for invoking a registered factory.
+         *
+         * @returns Complete current or terminal factory run envelope.
+         */
+        run: (params: FactoryRunRequest) => Promise<FactoryRunResult>;
+        /**
+         * Gets the current or settled envelope for a factory run.
+         *
+         * @param params Parameters for retrieving a factory run.
+         *
+         * @returns Complete current or terminal factory run envelope.
+         */
+        getRun: (params: FactoryGetRunRequest) => Promise<FactoryRunResult>;
+        /**
+         * Requests cancellation of a factory run and returns its run envelope.
+         *
+         * @param params Parameters for cancelling a factory run.
+         *
+         * @returns Complete current or terminal factory run envelope.
+         */
+        cancel: (params: FactoryCancelRequest) => Promise<FactoryRunResult>;
+        /**
+         * Records a batch of ordered factory progress lines.
+         *
+         * @param params Parameters for recording factory progress.
+         *
+         * @returns Acknowledgement that a factory request was accepted.
+         */
+        log: (params: FactoryLogRequest) => Promise<FactoryAckResult>;
+        /**
+         * Runs one factory-scoped subagent and returns its result.
+         *
+         * @param params Parameters for one factory-scoped subagent call.
+         *
+         * @returns Result of one factory-scoped subagent call.
+         */
+        agent: (params: FactoryAgentRequest) => Promise<FactoryAgentResult>;
+        /** @experimental */
+        journal: {
+            /**
+             * Reads a memoized factory journal entry.
+             *
+             * @param params Parameters for reading a factory journal entry.
+             *
+             * @returns Result of reading a factory journal entry.
+             */
+            get: (params: FactoryJournalGetRequest) => Promise<FactoryJournalGetResult>;
+            /**
+             * Stores a memoized factory journal entry.
+             *
+             * @param params Parameters for storing a factory journal entry.
+             *
+             * @returns Acknowledgement that a factory request was accepted.
+             */
+            put: (params: FactoryJournalPutRequest) => Promise<FactoryAckResult>;
+        };
+    };
+    /** @experimental */
     model: {
         /**
          * Gets the currently selected model for the session.
@@ -16321,7 +16859,7 @@ export declare function createSessionRpc(connection: MessageConnection, sessionI
          */
         list: () => Promise<McpServerList>;
         /**
-         * Lists the tools exposed by a connected MCP server on this session's host.
+         * Lists the tools exposed by a connected MCP server on this session's host. This performs a live `tools/list` request. Tool UI metadata is returned independently of whether MCP Apps rendering is enabled for the session.
          *
          * @param params Server name whose tool list should be returned.
          *
@@ -16996,11 +17534,11 @@ export declare function createSessionRpc(connection: MessageConnection, sessionI
          */
         getContextHeaviestMessages: (params: MetadataContextHeaviestMessagesRequest) => Promise<MetadataContextHeaviestMessagesResult>;
         /**
-         * Records a working-directory/git context change and emits a `session.context_changed` event.
+         * Records a working-directory/git context change and emits a `session.context_changed` event. For a local session, a report whose `cwd` diverges from the session's current working directory is ignored (the call still succeeds but records nothing and emits no event): a local session's working directory is authoritative and is moved via `metadata.setWorkingDirectory` (or an SDK `session.resume` that supplies a `workingDirectory`), not by this method.
          *
          * @param params Updated working-directory/git context to record on the session.
          *
-         * @returns Notify the session that its working directory context has changed. Emits a `session.context_changed` event so consumers (telemetry, OTel tracker, ACP, the timeline UI) can react. Use this when the host has detected a cwd/branch/repo change outside the session's normal lifecycle (e.g., after a shell command in interactive mode).
+         * @returns Notify the session that its working directory context has changed. Emits a `session.context_changed` event so consumers (telemetry, OTel tracker, ACP, the timeline UI) can react. Use this when the host has detected a cwd/branch/repo change outside the session's normal lifecycle (e.g., after a shell command in interactive mode). For a local session, a report whose `cwd` diverges from the session's current working directory is ignored (the call still succeeds but records nothing and emits no event); move a local session's working directory via `metadata.setWorkingDirectory` instead.
          */
         recordContextChange: (params: MetadataRecordContextChangeRequest) => Promise<MetadataRecordContextChangeResult>;
         /**
@@ -17223,6 +17761,26 @@ export interface ProviderTokenHandler {
      */
     getToken(params: ProviderTokenAcquireRequest): Promise<ProviderTokenAcquireResult>;
 }
+/** Handler for `factory` client session API methods. */
+/** @experimental */
+export interface FactoryHandler {
+    /**
+     * Asks the owning extension connection to execute a registered factory closure.
+     *
+     * @param params Parameters sent to the owning extension to execute a factory closure.
+     *
+     * @returns Result returned by an extension factory closure.
+     */
+    execute(params: FactoryExecuteRequest): Promise<FactoryExecuteResult>;
+    /**
+     * Asks the owning extension connection to abort a running factory cooperatively.
+     *
+     * @param params Parameters for cooperatively aborting a factory body.
+     *
+     * @returns Acknowledgement that a factory request was accepted.
+     */
+    abort(params: FactoryAbortRequest): Promise<FactoryAckResult>;
+}
 /** Handler for `sessionFs` client session API methods. */
 /** @experimental */
 export interface SessionFsHandler {
@@ -17352,6 +17910,7 @@ export interface CanvasHandler {
 /** All client session API handler groups. */
 export interface ClientSessionApiHandlers {
     providerToken?: ProviderTokenHandler;
+    factory?: FactoryHandler;
     sessionFs?: SessionFsHandler;
     canvas?: CanvasHandler;
 }
@@ -17362,6 +17921,18 @@ export interface ClientSessionApiHandlers {
  * function uses `getHandlers` to resolve the session's handlers.
  */
 export declare function registerClientSessionApiHandlers(connection: MessageConnection, getHandlers: (sessionId: string) => ClientSessionApiHandlers): void;
+/** Handler for `hooks` client global API methods. */
+/** @experimental */
+export interface HooksHandler {
+    /**
+     * Dispatches one SDK callback hook from the runtime to the connection that registered it. Internal transport plumbing: clients opt in through session initialization and the Rust hook processor owns ordering, policy, timeout, and callback routing.
+     *
+     * @param params Runtime-owned wire payload for a server-to-client hook callback invocation.
+     *
+     * @returns Optional output returned by an SDK callback hook.
+     */
+    invoke(params: HookInvokeRequest): Promise<HookInvokeResponse>;
+}
 /** Handler for `llmInference` client global API methods. */
 /** @experimental */
 export interface LlmInferenceHandler {
@@ -17394,6 +17965,7 @@ export interface GitHubTelemetryHandler {
 }
 /** All client global API handler groups. */
 export interface ClientGlobalApiHandlers {
+    hooks?: HooksHandler;
     llmInference?: LlmInferenceHandler;
     gitHubTelemetry?: GitHubTelemetryHandler;
 }