@github/copilot-sdk 1.0.0-beta.9 → 1.0.0

package/dist/generated/rpc.d.ts

@@ -3,7 +3,7 @@
  * Generated from: api.schema.json
  */
 import type { MessageConnection } from "vscode-jsonrpc/node.js";
-import type { AbortReason, EmbeddedBlobResourceContents, EmbeddedTextResourceContents, McpServerSource, McpServerStatus, PermissionPromptRequest, PermissionRule, ReasoningSummary, SessionEvent, SessionMode, ShutdownType, SkillSource, UserToolSessionApproval } from "./session-events.js";
+import type { AbortReason, Attachment, ContextTier, EmbeddedBlobResourceContents, EmbeddedTextResourceContents, McpServerSource, McpServerStatus, PermissionPromptRequest, PermissionRule, ReasoningSummary, SessionEvent, SessionMode, ShutdownType, SkillSource, UserToolSessionApproval } from "./session-events.js";
 /**
  * Where the agent definition was loaded from
  *
@@ -390,7 +390,7 @@ export type FilterMapping = {
  * via the `definition` "InstalledPluginSource".
  */
 /** @experimental */
-export type InstalledPluginSource = string | InstalledPluginSourceGithub | InstalledPluginSourceUrl | InstalledPluginSourceLocal;
+export type InstalledPluginSource = string | InstalledPluginSourceGitHub | InstalledPluginSourceUrl | InstalledPluginSourceLocal;
 /**
  * Category of instruction source — used for merge logic
  *
@@ -637,6 +637,10 @@ export type SessionContextInfo = {
      * Tokens consumed by tool definitions sent to the model (excludes deferred tools)
      */
     toolDefinitionsTokens: number;
+    /**
+     * Tokens consumed by MCP tool definitions (subset of toolDefinitionsTokens, excludes deferred tools)
+     */
+    mcpToolsTokens: number;
     /**
      * Sum of system, conversation and tool-definition tokens
      */
@@ -650,7 +654,7 @@ export type SessionContextInfo = {
      */
     compactionThreshold: number;
     /**
-     * Total context limit for /context display. promptTokenLimit + min(32k or 64k, outputTokenLimit) depending on model.
+     * Total context limit for /context display: promptTokenLimit + outputTokenLimit (the model's full max_output_tokens reserved on top of the prompt budget).
      */
     limit: number;
     /**
@@ -829,6 +833,22 @@ export type PermissionsModifyRulesScope =
 "session"
 /** Persist the rule change for this project location. */
  | "location";
+/**
+ * Optional source for allow-all telemetry. Defaults to `rpc` when omitted for SDK callers.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "PermissionsSetAllowAllSource".
+ */
+/** @experimental */
+export type PermissionsSetAllowAllSource = 
+/** Allow-all was enabled from a CLI command-line flag. */
+"cli_flag"
+/** Allow-all was enabled by a slash command. */
+ | "slash_command"
+/** Allow-all was enabled by confirming autopilot behavior. */
+ | "autopilot_confirmation"
+/** Allow-all was enabled through an RPC caller. */
+ | "rpc";
 /**
  * Optional source for allow-all telemetry. Defaults to `rpc` when omitted for SDK callers.
  *
@@ -845,6 +865,28 @@ export type PermissionsSetApproveAllSource =
  | "autopilot_confirmation"
 /** Allow-all was enabled through an RPC caller. */
  | "rpc";
+/**
+ * Schema for the `PushAttachment` type.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "PushAttachment".
+ */
+/** @experimental */
+export type PushAttachment = PushAttachmentFile | PushAttachmentDirectory | PushAttachmentSelection | PushAttachmentGitHubReference | PushAttachmentBlob | ExtensionContextPushInput;
+/**
+ * Type of GitHub reference
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "PushAttachmentGitHubReferenceType".
+ */
+/** @experimental */
+export type PushAttachmentGitHubReferenceType = 
+/** GitHub issue reference. */
+"issue"
+/** GitHub pull request reference. */
+ | "pr"
+/** GitHub discussion reference. */
+ | "discussion";
 /**
  * Whether this item is a queued user message or a queued slash command / model change
  *
@@ -887,28 +929,6 @@ export type SendAgentMode =
  | "autopilot"
 /** The agent is in shell-focused UI mode. */
  | "shell";
-/**
- * A user message attachment — a file, directory, code selection, blob, or GitHub reference
- *
- * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "SendAttachment".
- */
-/** @experimental */
-export type SendAttachment = SendAttachmentFile | SendAttachmentDirectory | SendAttachmentSelection | SendAttachmentGithubReference | SendAttachmentBlob;
-/**
- * Type of GitHub reference
- *
- * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "SendAttachmentGithubReferenceType".
- */
-/** @experimental */
-export type SendAttachmentGithubReferenceType = 
-/** GitHub issue reference. */
-"issue"
-/** GitHub pull request reference. */
- | "pr"
-/** GitHub discussion reference. */
- | "discussion";
 /**
  * How to deliver the message. `enqueue` (default) appends to the message queue. `immediate` interjects during an in-progress turn.
  *
@@ -989,7 +1009,7 @@ export type SessionFsSqliteQueryType =
  * via the `definition` "SessionInstalledPluginSource".
  */
 /** @experimental */
-export type SessionInstalledPluginSource = string | SessionInstalledPluginSourceGithub | SessionInstalledPluginSourceUrl | SessionInstalledPluginSourceLocal;
+export type SessionInstalledPluginSource = string | SessionInstalledPluginSourceGitHub | SessionInstalledPluginSourceUrl | SessionInstalledPluginSourceLocal;
 /**
  * Public-facing workspace metadata for this session, or null if the session has no associated workspace. Excludes runtime-internal fields (GitHub IDs, summary count, internal flags).
  *
@@ -2025,73 +2045,73 @@ export interface CanvasJsonSchema {
     [k: string]: unknown | undefined;
 }
 /**
- * Canvas close parameters.
+ * Canvas action invocation parameters.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "CanvasCloseRequest".
+ * via the `definition` "CanvasActionInvokeRequest".
  */
 /** @experimental */
-export interface CanvasCloseRequest {
+export interface CanvasActionInvokeRequest {
     /**
      * Open canvas instance identifier
      */
     instanceId: string;
+    /**
+     * Action name to invoke
+     */
+    actionName: string;
+    /**
+     * Action input
+     */
+    input?: {
+        [k: string]: unknown | undefined;
+    };
 }
 /**
- * Host context supplied by the runtime.
+ * Provider-supplied action result.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "CanvasHostContext".
+ * via the `definition` "CanvasActionInvokeResult".
  */
 /** @experimental */
-export interface CanvasHostContext {
-    capabilities?: CanvasHostContextCapabilities;
+export interface CanvasActionInvokeResult {
+    [k: string]: unknown | undefined;
 }
 /**
- * Host capabilities
+ * Canvas close parameters.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "CanvasHostContextCapabilities".
+ * via the `definition` "CanvasCloseRequest".
  */
 /** @experimental */
-export interface CanvasHostContextCapabilities {
+export interface CanvasCloseRequest {
     /**
-     * Whether canvas rendering is supported
+     * Open canvas instance identifier
      */
-    canvases?: boolean;
+    instanceId: string;
 }
 /**
- * Canvas action invocation parameters.
+ * Host context supplied by the runtime.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "CanvasInvokeActionRequest".
+ * via the `definition` "CanvasHostContext".
  */
 /** @experimental */
-export interface CanvasInvokeActionRequest {
-    /**
-     * Open canvas instance identifier
-     */
-    instanceId: string;
-    /**
-     * Action name to invoke
-     */
-    actionName: string;
-    /**
-     * Action input
-     */
-    input?: {
-        [k: string]: unknown | undefined;
-    };
+export interface CanvasHostContext {
+    capabilities?: CanvasHostContextCapabilities;
 }
 /**
- * Provider-supplied action result.
+ * Host capabilities
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "CanvasInvokeActionResult".
+ * via the `definition` "CanvasHostContextCapabilities".
  */
 /** @experimental */
-export interface CanvasInvokeActionResult {
-    [k: string]: unknown | undefined;
+export interface CanvasHostContextCapabilities {
+    /**
+     * Whether canvas rendering is supported
+     */
+    canvases?: boolean;
 }
 /**
  * Declared canvases available in this session.
@@ -2632,7 +2652,7 @@ export interface ConnectRemoteSessionParams {
     sessionId: string;
 }
 /**
- * The currently selected model and reasoning effort for the session.
+ * The currently selected model, reasoning effort, and context tier for the session. The context tier reflects `Session.getContextTier()`, restored from the session journal on resume.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "CurrentModel".
@@ -2647,6 +2667,46 @@ export interface CurrentModel {
      * Reasoning effort level currently applied to the active model, when one is set. Reads `Session.getReasoningEffort()` synchronously after `getSelectedModel()` resolves so the two values are reported as a snapshot.
      */
     reasoningEffort?: string;
+    contextTier?: ContextTier;
+}
+/**
+ * Lightweight metadata for a currently initialized session tool
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "CurrentToolMetadata".
+ */
+/** @experimental */
+export interface CurrentToolMetadata {
+    /**
+     * Model-facing tool name
+     */
+    name: string;
+    /**
+     * Optional MCP/config namespaced tool name
+     */
+    namespacedName?: string;
+    /**
+     * MCP server name for MCP-backed tools
+     */
+    mcpServerName?: string;
+    /**
+     * Raw MCP tool name for MCP-backed tools
+     */
+    mcpToolName?: string;
+    /**
+     * Tool description
+     */
+    description: string;
+    /**
+     * JSON Schema for tool input
+     */
+    input_schema?: {
+        [k: string]: unknown | undefined;
+    };
+    /**
+     * Whether the tool is loaded on demand via tool search
+     */
+    deferLoading?: boolean;
 }
 /**
  * Schema for the `DiscoveredMcpServer` type.
@@ -2816,6 +2876,29 @@ export interface Extension {
      */
     pid?: number;
 }
+/**
+ * Slim input shape for extension_context attachments; identity fields are runtime-derived.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "ExtensionContextPushInput".
+ */
+/** @experimental */
+export interface ExtensionContextPushInput {
+    /**
+     * Attachment type discriminator
+     */
+    type: "extension_context";
+    /**
+     * Human-readable composer pill label
+     */
+    title: string;
+    /**
+     * Caller-supplied JSON payload (required, may be null but not undefined)
+     */
+    payload: {
+        [k: string]: unknown | undefined;
+    };
+}
 /**
  * Extensions discovered for the session, with their current status.
  *
@@ -3352,13 +3435,13 @@ export interface InstalledPlugin {
     source?: InstalledPluginSource;
 }
 /**
- * Schema for the `InstalledPluginSourceGithub` type.
+ * Schema for the `InstalledPluginSourceGitHub` type.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "InstalledPluginSourceGithub".
+ * via the `definition` "InstalledPluginSourceGitHub".
  */
 /** @experimental */
-export interface InstalledPluginSourceGithub {
+export interface InstalledPluginSourceGitHub {
     /**
      * Constant value. Always "github".
      */
@@ -4540,7 +4623,7 @@ export interface ModelBillingTokenPrices {
      */
     batchSize?: number;
     /**
-     * Maximum context window tokens for the default tier
+     * Prompt token budget (max_prompt_tokens) for the default tier. The total context window is this value plus the model's max_output_tokens.
      */
     contextMax?: number;
     longContext?: ModelBillingTokenPricesLongContext;
@@ -4565,7 +4648,7 @@ export interface ModelBillingTokenPricesLongContext {
      */
     cachePrice?: number;
     /**
-     * Maximum context window tokens for the long context tier
+     * Prompt token budget (max_prompt_tokens) for the long context tier. The total context window is this value plus the model's max_output_tokens.
      */
     contextMax?: number;
 }
@@ -4652,6 +4735,19 @@ export interface ModelList {
      */
     models: Model[];
 }
+/**
+ * Optional listing options.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "ModelListRequest".
+ */
+/** @experimental */
+export interface ModelListRequest {
+    /**
+     * If true, bypasses the per-session model list cache and re-fetches from CAPI.
+     */
+    skipCache?: boolean;
+}
 /**
  * Reasoning effort level to apply to the currently selected model.
  *
@@ -4685,7 +4781,7 @@ export interface ModelsListRequest {
     gitHubToken?: string;
 }
 /**
- * Target model identifier and optional reasoning effort, summary, and capability overrides.
+ * Target model identifier and optional reasoning effort, summary, capability overrides, and context tier.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "ModelSwitchToRequest".
@@ -4702,6 +4798,7 @@ export interface ModelSwitchToRequest {
     reasoningEffort?: string;
     reasoningSummary?: ReasoningSummary;
     modelCapabilities?: ModelCapabilitiesOverride;
+    contextTier?: ContextTier;
 }
 /**
  * The model identifier active on the session after the switch.
@@ -6001,6 +6098,7 @@ export interface PermissionsSetAllowAllRequest {
      * Whether to enable full allow-all permissions
      */
     enabled: boolean;
+    source?: PermissionsSetAllowAllSource;
 }
 /**
  * Allow-all toggle for tool permission requests, with an optional telemetry source.
@@ -6186,100 +6284,286 @@ export interface PluginList {
     plugins: Plugin[];
 }
 /**
- * Schema for the `QueuePendingItems` type.
+ * File attachment
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "QueuePendingItems".
+ * via the `definition` "PushAttachmentFile".
  */
 /** @experimental */
-export interface QueuePendingItems {
-    kind: QueuePendingItemsKind;
+export interface PushAttachmentFile {
     /**
-     * Human-readable text to display for this queue entry in the UI
+     * Attachment type discriminator
      */
-    displayText: string;
+    type: "file";
+    /**
+     * Absolute file path
+     */
+    path: string;
+    /**
+     * User-facing display name for the attachment
+     */
+    displayName: string;
+    lineRange?: PushAttachmentFileLineRange;
 }
 /**
- * Snapshot of the session's pending queued items and immediate-steering messages.
+ * Optional line range to scope the attachment to a specific section of the file
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "QueuePendingItemsResult".
+ * via the `definition` "PushAttachmentFileLineRange".
  */
 /** @experimental */
-export interface QueuePendingItemsResult {
+export interface PushAttachmentFileLineRange {
     /**
-     * Pending queued items in submission order. Includes user messages, queued slash commands, and queued model changes; omits internal system items.
+     * Start line number (1-based)
      */
-    items: QueuePendingItems[];
+    start: number;
     /**
-     * Display text for messages currently in the immediate steering queue (interjections sent during a running turn).
+     * End line number (1-based, inclusive)
      */
-    steeringMessages: string[];
+    end: number;
 }
 /**
- * Indicates whether a user-facing pending item was removed.
+ * Directory attachment
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "QueueRemoveMostRecentResult".
+ * via the `definition` "PushAttachmentDirectory".
  */
 /** @experimental */
-export interface QueueRemoveMostRecentResult {
+export interface PushAttachmentDirectory {
     /**
-     * True if a user-facing pending item was removed (LIFO across both queues); false when no removable items remained.
+     * Attachment type discriminator
      */
-    removed: boolean;
+    type: "directory";
+    /**
+     * Absolute directory path
+     */
+    path: string;
+    /**
+     * User-facing display name for the attachment
+     */
+    displayName: string;
 }
 /**
- * Event type to register consumer interest for, used by runtime gating logic.
+ * Code selection attachment from an editor
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "RegisterEventInterestParams".
+ * via the `definition` "PushAttachmentSelection".
  */
 /** @experimental */
-export interface RegisterEventInterestParams {
+export interface PushAttachmentSelection {
     /**
-     * The event type the consumer wants the runtime to treat as 'observed' for behavior-switching gating. Some runtime code paths inspect whether any consumer is interested in a specific event type and choose a different implementation accordingly (e.g. `mcp.oauth_required`: when interest is registered the runtime delegates the full interactive OAuth flow to the consumer; when no interest is registered the runtime installs a browserless fallback that silently reuses cached tokens). SDK clients that long-poll events do NOT automatically appear as listeners to these gating checks — they must explicitly call `registerInterest` for each event type they want the runtime to count as having a consumer. Multiple registrations for the same event type from the same or different consumers are tracked independently and must each be released. See: `mcp.oauth_required`, `sampling.requested`, `auto_mode_switch.requested`, `user_input.requested`, `elicitation.requested`, `command.queued`, `exit_plan_mode.requested`.
+     * Attachment type discriminator
      */
-    eventType: string;
+    type: "selection";
+    /**
+     * Absolute path to the file containing the selection
+     */
+    filePath: string;
+    /**
+     * User-facing display name for the selection
+     */
+    displayName: string;
+    /**
+     * The selected text content
+     */
+    text: string;
+    selection: PushAttachmentSelectionDetails;
 }
 /**
- * Opaque handle representing an event-type interest registration.
+ * Position range of the selection within the file
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "RegisterEventInterestResult".
+ * via the `definition` "PushAttachmentSelectionDetails".
  */
 /** @experimental */
-export interface RegisterEventInterestResult {
-    /**
-     * Opaque handle for this registration. Pass to releaseInterest to release. Each call to registerInterest produces a fresh handle, even when the same eventType is registered multiple times.
-     */
-    handle: string;
+export interface PushAttachmentSelectionDetails {
+    start: PushAttachmentSelectionDetailsStart;
+    end: PushAttachmentSelectionDetailsEnd;
 }
 /**
- * Opaque handle previously returned by `registerInterest` to release.
+ * Start position of the selection
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "ReleaseEventInterestParams".
+ * via the `definition` "PushAttachmentSelectionDetailsStart".
  */
 /** @experimental */
-export interface ReleaseEventInterestParams {
+export interface PushAttachmentSelectionDetailsStart {
     /**
-     * Handle returned by a previous `registerInterest` call. Idempotent: releasing an unknown or already-released handle is a no-op (returns success). When the last outstanding handle for an event type is released, the runtime reverts to its 'no consumer' code path for that event type.
+     * Start line number (0-based)
      */
-    handle: string;
+    line: number;
+    /**
+     * Start character offset within the line (0-based)
+     */
+    character: number;
 }
 /**
- * Optional remote session mode ("off", "export", or "on"); defaults to enabling both export and remote steering.
+ * End position of the selection
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "RemoteEnableRequest".
+ * via the `definition` "PushAttachmentSelectionDetailsEnd".
  */
 /** @experimental */
-export interface RemoteEnableRequest {
-    mode?: RemoteSessionMode;
+export interface PushAttachmentSelectionDetailsEnd {
+    /**
+     * End line number (0-based)
+     */
+    line: number;
+    /**
+     * End character offset within the line (0-based)
+     */
+    character: number;
 }
 /**
- * GitHub URL for the session and a flag indicating whether remote steering is enabled.
+ * GitHub issue, pull request, or discussion reference
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "PushAttachmentGitHubReference".
+ */
+/** @experimental */
+export interface PushAttachmentGitHubReference {
+    /**
+     * Attachment type discriminator
+     */
+    type: "github_reference";
+    /**
+     * Issue, pull request, or discussion number
+     */
+    number: number;
+    /**
+     * Title of the referenced item
+     */
+    title: string;
+    referenceType: PushAttachmentGitHubReferenceType;
+    /**
+     * Current state of the referenced item (e.g., open, closed, merged)
+     */
+    state: string;
+    /**
+     * URL to the referenced item on GitHub
+     */
+    url: string;
+}
+/**
+ * Blob attachment with inline base64-encoded data
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "PushAttachmentBlob".
+ */
+/** @experimental */
+export interface PushAttachmentBlob {
+    /**
+     * Attachment type discriminator
+     */
+    type: "blob";
+    /**
+     * Base64-encoded content
+     */
+    data: string;
+    /**
+     * MIME type of the inline data
+     */
+    mimeType: string;
+    /**
+     * User-facing display name for the attachment
+     */
+    displayName?: string;
+}
+/**
+ * Schema for the `QueuePendingItems` type.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "QueuePendingItems".
+ */
+/** @experimental */
+export interface QueuePendingItems {
+    kind: QueuePendingItemsKind;
+    /**
+     * Human-readable text to display for this queue entry in the UI
+     */
+    displayText: string;
+}
+/**
+ * Snapshot of the session's pending queued items and immediate-steering messages.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "QueuePendingItemsResult".
+ */
+/** @experimental */
+export interface QueuePendingItemsResult {
+    /**
+     * Pending queued items in submission order. Includes user messages, queued slash commands, and queued model changes; omits internal system items.
+     */
+    items: QueuePendingItems[];
+    /**
+     * Display text for messages currently in the immediate steering queue (interjections sent during a running turn).
+     */
+    steeringMessages: string[];
+}
+/**
+ * Indicates whether a user-facing pending item was removed.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "QueueRemoveMostRecentResult".
+ */
+/** @experimental */
+export interface QueueRemoveMostRecentResult {
+    /**
+     * True if a user-facing pending item was removed (LIFO across both queues); false when no removable items remained.
+     */
+    removed: boolean;
+}
+/**
+ * Event type to register consumer interest for, used by runtime gating logic.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "RegisterEventInterestParams".
+ */
+/** @experimental */
+export interface RegisterEventInterestParams {
+    /**
+     * The event type the consumer wants the runtime to treat as 'observed' for behavior-switching gating. Some runtime code paths inspect whether any consumer is interested in a specific event type and choose a different implementation accordingly (e.g. `mcp.oauth_required`: when interest is registered the runtime delegates the full interactive OAuth flow to the consumer; when no interest is registered the runtime installs a browserless fallback that silently reuses cached tokens). SDK clients that long-poll events do NOT automatically appear as listeners to these gating checks — they must explicitly call `registerInterest` for each event type they want the runtime to count as having a consumer. Multiple registrations for the same event type from the same or different consumers are tracked independently and must each be released. See: `mcp.oauth_required`, `sampling.requested`, `auto_mode_switch.requested`, `user_input.requested`, `elicitation.requested`, `command.queued`, `exit_plan_mode.requested`.
+     */
+    eventType: string;
+}
+/**
+ * Opaque handle representing an event-type interest registration.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "RegisterEventInterestResult".
+ */
+/** @experimental */
+export interface RegisterEventInterestResult {
+    /**
+     * Opaque handle for this registration. Pass to releaseInterest to release. Each call to registerInterest produces a fresh handle, even when the same eventType is registered multiple times.
+     */
+    handle: string;
+}
+/**
+ * Opaque handle previously returned by `registerInterest` to release.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "ReleaseEventInterestParams".
+ */
+/** @experimental */
+export interface ReleaseEventInterestParams {
+    /**
+     * Handle returned by a previous `registerInterest` call. Idempotent: releasing an unknown or already-released handle is a no-op (returns success). When the last outstanding handle for an event type is released, the runtime reverts to its 'no consumer' code path for that event type.
+     */
+    handle: string;
+}
+/**
+ * Optional remote session mode ("off", "export", or "on"); defaults to enabling both export and remote steering.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "RemoteEnableRequest".
+ */
+/** @experimental */
+export interface RemoteEnableRequest {
+    mode?: RemoteSessionMode;
+}
+/**
+ * GitHub URL for the session and a flag indicating whether remote steering is enabled.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "RemoteEnableResult".
@@ -6425,190 +6709,21 @@ export interface SecretsAddFilterValuesResult {
     ok: true;
 }
 /**
- * File attachment
- *
- * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "SendAttachmentFile".
- */
-/** @experimental */
-export interface SendAttachmentFile {
-    /**
-     * Attachment type discriminator
-     */
-    type: "file";
-    /**
-     * Absolute file path
-     */
-    path: string;
-    /**
-     * User-facing display name for the attachment
-     */
-    displayName: string;
-    lineRange?: SendAttachmentFileLineRange;
-}
-/**
- * Optional line range to scope the attachment to a specific section of the file
- *
- * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "SendAttachmentFileLineRange".
- */
-/** @experimental */
-export interface SendAttachmentFileLineRange {
-    /**
-     * Start line number (1-based)
-     */
-    start: number;
-    /**
-     * End line number (1-based, inclusive)
-     */
-    end: number;
-}
-/**
- * Directory attachment
- *
- * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "SendAttachmentDirectory".
- */
-/** @experimental */
-export interface SendAttachmentDirectory {
-    /**
-     * Attachment type discriminator
-     */
-    type: "directory";
-    /**
-     * Absolute directory path
-     */
-    path: string;
-    /**
-     * User-facing display name for the attachment
-     */
-    displayName: string;
-}
-/**
- * Code selection attachment from an editor
- *
- * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "SendAttachmentSelection".
- */
-/** @experimental */
-export interface SendAttachmentSelection {
-    /**
-     * Attachment type discriminator
-     */
-    type: "selection";
-    /**
-     * Absolute path to the file containing the selection
-     */
-    filePath: string;
-    /**
-     * User-facing display name for the selection
-     */
-    displayName: string;
-    /**
-     * The selected text content
-     */
-    text: string;
-    selection: SendAttachmentSelectionDetails;
-}
-/**
- * Position range of the selection within the file
- *
- * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "SendAttachmentSelectionDetails".
- */
-/** @experimental */
-export interface SendAttachmentSelectionDetails {
-    start: SendAttachmentSelectionDetailsStart;
-    end: SendAttachmentSelectionDetailsEnd;
-}
-/**
- * Start position of the selection
- *
- * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "SendAttachmentSelectionDetailsStart".
- */
-/** @experimental */
-export interface SendAttachmentSelectionDetailsStart {
-    /**
-     * Start line number (0-based)
-     */
-    line: number;
-    /**
-     * Start character offset within the line (0-based)
-     */
-    character: number;
-}
-/**
- * End position of the selection
- *
- * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "SendAttachmentSelectionDetailsEnd".
- */
-/** @experimental */
-export interface SendAttachmentSelectionDetailsEnd {
-    /**
-     * End line number (0-based)
-     */
-    line: number;
-    /**
-     * End character offset within the line (0-based)
-     */
-    character: number;
-}
-/**
- * GitHub issue, pull request, or discussion reference
- *
- * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "SendAttachmentGithubReference".
- */
-/** @experimental */
-export interface SendAttachmentGithubReference {
-    /**
-     * Attachment type discriminator
-     */
-    type: "github_reference";
-    /**
-     * Issue, pull request, or discussion number
-     */
-    number: number;
-    /**
-     * Title of the referenced item
-     */
-    title: string;
-    referenceType: SendAttachmentGithubReferenceType;
-    /**
-     * Current state of the referenced item (e.g., open, closed, merged)
-     */
-    state: string;
-    /**
-     * URL to the referenced item on GitHub
-     */
-    url: string;
-}
-/**
- * Blob attachment with inline base64-encoded data
+ * Parameters for session.extensions.sendAttachmentsToMessage.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "SendAttachmentBlob".
+ * via the `definition` "SendAttachmentsToMessageParams".
  */
 /** @experimental */
-export interface SendAttachmentBlob {
+export interface SendAttachmentsToMessageParams {
     /**
-     * Attachment type discriminator
+     * Optional canvas instance binding the push for provenance. When supplied, the runtime resolves the canvas, verifies it is owned by the calling extension, and stamps canvasId/instanceId onto each extension_context entry. When omitted, no resolution runs and those fields stay unset on the attachment.
      */
-    type: "blob";
+    instanceId?: string;
     /**
-     * Base64-encoded content
+     * Attachments to push into the next user-message turn. extension_context entries take the slim shape; standard variants take their full AttachmentSchema shape.
      */
-    data: string;
-    /**
-     * MIME type of the inline data
-     */
-    mimeType: string;
-    /**
-     * User-facing display name for the attachment
-     */
-    displayName?: string;
+    attachments: PushAttachment[];
 }
 /**
  * Parameters for sending a user message to the session
@@ -6629,7 +6744,7 @@ export interface SendRequest {
     /**
      * Optional attachments (files, directories, selections, blobs, GitHub references) to include with the message
      */
-    attachments?: SendAttachment[];
+    attachments?: Attachment[];
     mode?: SendMode;
     /**
      * If true, adds the message to the front of the queue instead of the end
@@ -7312,13 +7427,13 @@ export interface SessionInstalledPlugin {
     source?: SessionInstalledPluginSource;
 }
 /**
- * Schema for the `SessionInstalledPluginSourceGithub` type.
+ * Schema for the `SessionInstalledPluginSourceGitHub` type.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "SessionInstalledPluginSourceGithub".
+ * via the `definition` "SessionInstalledPluginSourceGitHub".
  */
 /** @experimental */
-export interface SessionInstalledPluginSourceGithub {
+export interface SessionInstalledPluginSourceGitHub {
     /**
      * Constant value. Always "github".
      */
@@ -7471,6 +7586,25 @@ export interface SessionMetadataSnapshot {
      */
     workspace?: WorkspaceSummary | null;
 }
+/**
+ * The list of models available to this session.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SessionModelList".
+ */
+/** @experimental */
+export interface SessionModelList {
+    /**
+     * Available models, ordered with the most preferred default first.
+     */
+    list: unknown[];
+    /**
+     * Per-quota snapshots returned alongside the model list, keyed by quota type.
+     */
+    quotaSnapshots?: {
+        [k: string]: unknown | undefined;
+    };
+}
 /**
  * Outcome of the prune operation: deleted IDs, dry-run candidates, skipped IDs, total bytes freed, and the dry-run flag.
  *
@@ -8029,6 +8163,10 @@ export interface SessionUpdateOptionsParams {
      * Whether to default custom agents to local-only execution.
      */
     customAgentsLocalOnly?: boolean;
+    /**
+     * When true, the selected custom agent's prompt is not injected into the user message (skill context is still injected). Used by automation triggers where the agent prompt is already in the problem statement.
+     */
+    suppressCustomAgentPrompt?: boolean;
     /**
      * Whether to skip loading custom instruction sources.
      */
@@ -8087,6 +8225,30 @@ export interface SessionUpdateOptionsParams {
      * Whether to expose the `manage_schedule` tool to the agent. The runtime always owns the per-session schedule registry; this flag only controls tool exposure (typically gated to staff users).
      */
     manageScheduleEnabled?: boolean;
+    /**
+     * Whether to skip embedding retrieval pipeline initialization and execution.
+     */
+    skipEmbeddingRetrieval?: boolean;
+    /**
+     * Organization-level custom instructions to inject into the system prompt.
+     */
+    organizationCustomInstructions?: string;
+    /**
+     * Whether to enable loading of `.github/hooks/` filesystem hooks. Separate from the SDK callback hook mechanism.
+     */
+    enableFileHooks?: boolean;
+    /**
+     * Whether to enable host git operations (context resolution, child repo scanning, git info in system prompt).
+     */
+    enableHostGitOperations?: boolean;
+    /**
+     * Whether to enable cross-session store writes and reads.
+     */
+    enableSessionStore?: boolean;
+    /**
+     * Whether to enable skill directory scanning and loading. Falls back to enableConfigDiscovery when unset.
+     */
+    enableSkills?: boolean;
 }
 /**
  * Indicates whether the session options patch was applied successfully.
@@ -8936,6 +9098,19 @@ export interface ToolList {
      */
     tools: Tool[];
 }
+/**
+ * Current lightweight tool metadata snapshot for the session.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "ToolsGetCurrentMetadataResult".
+ */
+/** @experimental */
+export interface ToolsGetCurrentMetadataResult {
+    /**
+     * Current tool metadata, or null when tools have not been initialized yet
+     */
+    tools: CurrentToolMetadata[] | null;
+}
 /**
  * Resolve, build, and validate the runtime tool list for this session. Subagent sessions and consumer flows that need an initialized tool set before `send` invoke this. Default base-class implementation is a no-op for sessions that don't support tool validation.
  *
@@ -10014,6 +10189,10 @@ export declare function createServerRpc(connection: MessageConnection): {
              * @param params MCP server names to disable for new sessions.
              */
             disable: (params: McpConfigDisableRequest) => Promise<void>;
+            /**
+             * Drops this runtime process's in-memory MCP server-definition cache so the next MCP config read observes disk.
+             */
+            reload: () => Promise<void>;
         };
         /**
          * Discovers MCP servers from user, workspace, plugin, and builtin sources.
@@ -10042,6 +10221,20 @@ export declare function createServerRpc(connection: MessageConnection): {
          */
         discover: (params: SkillsDiscoverRequest) => Promise<ServerSkillList>;
     };
+    user: {
+        settings: {
+            /**
+             * Drops this runtime process's in-memory user settings cache so the next settings read observes disk.
+             */
+            reload: () => Promise<void>;
+        };
+    };
+    runtime: {
+        /**
+         * Gracefully shuts down an SDK-owned runtime. The response is sent only after cleanup completes; callers may then terminate the owned runtime process.
+         */
+        shutdown: () => Promise<void>;
+    };
     sessionFs: {
         /**
          * Registers an SDK client as the session filesystem provider.
@@ -10298,27 +10491,30 @@ export declare function createSessionRpc(connection: MessageConnection, sessionI
          * @param params Canvas close parameters.
          */
         close: (params: CanvasCloseRequest) => Promise<void>;
-        /**
-         * Invokes an action on an open canvas instance.
-         *
-         * @param params Canvas action invocation parameters.
-         *
-         * @returns Canvas action invocation result.
-         */
-        invokeAction: (params: CanvasInvokeActionRequest) => Promise<CanvasInvokeActionResult>;
+        /** @experimental */
+        action: {
+            /**
+             * Invokes an action on an open canvas instance.
+             *
+             * @param params Canvas action invocation parameters.
+             *
+             * @returns Canvas action invocation result.
+             */
+            invoke: (params: CanvasActionInvokeRequest) => Promise<CanvasActionInvokeResult>;
+        };
     };
     /** @experimental */
     model: {
         /**
          * Gets the currently selected model for the session.
          *
-         * @returns The currently selected model and reasoning effort for the session.
+         * @returns The currently selected model, reasoning effort, and context tier for the session. The context tier reflects `Session.getContextTier()`, restored from the session journal on resume.
          */
         getCurrent: () => Promise<CurrentModel>;
         /**
          * Switches the session to a model and optional reasoning configuration.
          *
-         * @param params Target model identifier and optional reasoning effort, summary, and capability overrides.
+         * @param params Target model identifier and optional reasoning effort, summary, capability overrides, and context tier.
          *
          * @returns The model identifier active on the session after the switch.
          */
@@ -10331,6 +10527,14 @@ export declare function createSessionRpc(connection: MessageConnection, sessionI
          * @returns Update the session's reasoning effort without changing the selected model. Use `switchTo` instead when you also need to change the model. The runtime stores the effort on the session and applies it to subsequent turns.
          */
         setReasoningEffort: (params: ModelSetReasoningEffortRequest) => Promise<ModelSetReasoningEffortResult>;
+        /**
+         * Lists models available to this session using its own auth and integration context. Connected hosts (CLI TUI, GitHub App) should call this through the session client so remote sessions return the remote CLI's available models rather than the caller's.
+         *
+         * @param params Optional listing options.
+         *
+         * @returns The list of models available to this session.
+         */
+        list: (params?: ModelListRequest) => Promise<SessionModelList>;
     };
     /** @experimental */
     mode: {
@@ -10785,6 +10989,12 @@ export declare function createSessionRpc(connection: MessageConnection, sessionI
          * Reloads extension definitions and processes for the session.
          */
         reload: () => Promise<void>;
+        /**
+         * Push attachments into the next user-message turn from an extension. The host should surface them as composer pills and forward them via the next session.send call. Callable only by extension-owned connections.
+         *
+         * @param params Parameters for session.extensions.sendAttachmentsToMessage.
+         */
+        sendAttachmentsToMessage: (params: SendAttachmentsToMessageParams) => Promise<void>;
     };
     /** @experimental */
     tools: {
@@ -10802,6 +11012,12 @@ export declare function createSessionRpc(connection: MessageConnection, sessionI
          * @returns Resolve, build, and validate the runtime tool list for this session. Subagent sessions and consumer flows that need an initialized tool set before `send` invoke this. Default base-class implementation is a no-op for sessions that don't support tool validation.
          */
         initializeAndValidate: () => Promise<ToolsInitializeAndValidateResult>;
+        /**
+         * Returns lightweight metadata for the session's currently initialized tools.
+         *
+         * @returns Current lightweight tool metadata snapshot for the session.
+         */
+        getCurrentMetadata: () => Promise<ToolsGetCurrentMetadataResult>;
     };
     /** @experimental */
     commands: {
@@ -11442,7 +11658,7 @@ export interface CanvasHandler {
      *
      * @returns Provider-supplied action result.
      */
-    invokeAction(params: CanvasProviderInvokeActionRequest): Promise<CanvasInvokeActionResult>;
+    invoke(params: CanvasProviderInvokeActionRequest): Promise<CanvasActionInvokeResult>;
 }
 /** All client session API handler groups. */
 export interface ClientSessionApiHandlers {