@github/copilot-sdk 1.0.0-beta.5 → 1.0.0-beta.7

package/dist/generated/rpc.d.ts

@@ -54,6 +54,18 @@ export type AuthInfoType =
  | "token"
 /** Authentication from a Copilot API token. */
  | "copilot-api-token";
+/**
+ * Runtime-controlled routing state for an open canvas instance.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "CanvasInstanceAvailability".
+ */
+/** @experimental */
+export type CanvasInstanceAvailability = 
+/** The owning provider is currently connected and routing calls will be dispatched normally. */
+"ready"
+/** The owning provider is not currently connected. Routing calls fail with canvas_provider_unavailable until the agent re-issues open_canvas (which rehydrates via a fresh canvas.open) or the provider reconnects. */
+ | "stale";
 /**
  * Coarse command category for grouping and behavior: runtime built-in, skill-backed command, or SDK/client-owned command
  *
@@ -110,7 +122,7 @@ export type ContentFilterMode =
 /** Remove characters that can hide directives. */
  | "hidden_characters";
 /**
- * Server transport type: stdio, http, sse, or memory
+ * Server transport type: stdio, http, sse (deprecated), or memory
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "DiscoveredMcpServerType".
@@ -120,7 +132,7 @@ export type DiscoveredMcpServerType =
 "stdio"
 /** Server communicates over streamable HTTP. */
  | "http"
-/** Server communicates over Server-Sent Events. */
+/** Server communicates over Server-Sent Events (deprecated). */
  | "sse"
 /** Server is backed by an in-memory runtime implementation. */
  | "memory";
@@ -301,6 +313,114 @@ export type SessionLogLevel =
  | "warning"
 /** Error message describing a failure. */
  | "error";
+/**
+ * UI theme preference per SEP-1865
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "McpAppsHostContextDetailsTheme".
+ */
+/** @experimental */
+export type McpAppsHostContextDetailsTheme = 
+/** Light UI theme */
+"light"
+/** Dark UI theme */
+ | "dark";
+/**
+ * Current display mode (SEP-1865)
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "McpAppsHostContextDetailsDisplayMode".
+ */
+/** @experimental */
+export type McpAppsHostContextDetailsDisplayMode = 
+/** Rendered inline within the host conversation surface */
+"inline"
+/** Rendered as a fullscreen overlay */
+ | "fullscreen"
+/** Rendered as a picture-in-picture floating panel */
+ | "pip";
+/**
+ * Allowed values for the `McpAppsHostContextDetailsAvailableDisplayMode` enumeration.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "McpAppsHostContextDetailsAvailableDisplayMode".
+ */
+/** @experimental */
+export type McpAppsHostContextDetailsAvailableDisplayMode = 
+/** Rendered inline within the host conversation surface */
+"inline"
+/** Rendered as a fullscreen overlay */
+ | "fullscreen"
+/** Rendered as a picture-in-picture floating panel */
+ | "pip";
+/**
+ * Platform type for responsive design
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "McpAppsHostContextDetailsPlatform".
+ */
+/** @experimental */
+export type McpAppsHostContextDetailsPlatform = 
+/** Host runs in a web browser */
+"web"
+/** Host runs as a desktop application */
+ | "desktop"
+/** Host runs on a mobile device */
+ | "mobile";
+/**
+ * UI theme preference per SEP-1865
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "McpAppsSetHostContextDetailsTheme".
+ */
+/** @experimental */
+export type McpAppsSetHostContextDetailsTheme = 
+/** Light UI theme */
+"light"
+/** Dark UI theme */
+ | "dark";
+/**
+ * Current display mode (SEP-1865)
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "McpAppsSetHostContextDetailsDisplayMode".
+ */
+/** @experimental */
+export type McpAppsSetHostContextDetailsDisplayMode = 
+/** Rendered inline within the host conversation surface */
+"inline"
+/** Rendered as a fullscreen overlay */
+ | "fullscreen"
+/** Rendered as a picture-in-picture floating panel */
+ | "pip";
+/**
+ * Allowed values for the `McpAppsSetHostContextDetailsAvailableDisplayMode` enumeration.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "McpAppsSetHostContextDetailsAvailableDisplayMode".
+ */
+/** @experimental */
+export type McpAppsSetHostContextDetailsAvailableDisplayMode = 
+/** Rendered inline within the host conversation surface */
+"inline"
+/** Rendered as a fullscreen overlay */
+ | "fullscreen"
+/** Rendered as a picture-in-picture floating panel */
+ | "pip";
+/**
+ * Platform type for responsive design
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "McpAppsSetHostContextDetailsPlatform".
+ */
+/** @experimental */
+export type McpAppsSetHostContextDetailsPlatform = 
+/** Host runs in a web browser */
+"web"
+/** Host runs as a desktop application */
+ | "desktop"
+/** Host runs on a mobile device */
+ | "mobile";
 /**
  * MCP server configuration (stdio process or remote HTTP/SSE)
  *
@@ -1027,11 +1147,11 @@ export interface AccountQuotaSnapshot {
      */
     remainingPercentage: number;
     /**
-     * Number of overage requests made this period
+     * Number of additional usage requests made this period
      */
     overage: number;
     /**
-     * Whether overage is allowed when quota is exhausted
+     * Whether additional usage is allowed when quota is exhausted
      */
     overageAllowedWithExhaustedQuota: boolean;
     /**
@@ -1095,6 +1215,8 @@ export interface AgentInfo {
     model?: string;
     /**
      * MCP server configurations attached to this agent, keyed by server name. Server config shape mirrors the MCP `mcpServers` schema.
+     *
+     * @experimental
      */
     mcpServers?: {
         [k: string]: unknown | undefined;
@@ -1466,6 +1588,220 @@ export interface GhCliAuthInfo {
     token: string;
     copilotUser?: CopilotUserResponse;
 }
+/**
+ * Canvas action that the agent or host can invoke. To discover the input schema for a particular action, call the list_canvas_capabilities tool.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "CanvasAction".
+ */
+/** @experimental */
+export interface CanvasAction {
+    /**
+     * Action name exposed by the canvas provider
+     */
+    name: string;
+    /**
+     * Description of the action
+     */
+    description?: string;
+    inputSchema?: CanvasJsonSchema;
+}
+/**
+ * JSON Schema for canvas open input
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "CanvasJsonSchema".
+ */
+/** @experimental */
+export interface CanvasJsonSchema {
+    [k: string]: unknown | undefined;
+}
+/**
+ * Canvas close parameters.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "CanvasCloseRequest".
+ */
+/** @experimental */
+export interface CanvasCloseRequest {
+    /**
+     * Open canvas instance identifier
+     */
+    instanceId: string;
+}
+/**
+ * Canvas action invocation parameters.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "CanvasInvokeActionRequest".
+ */
+/** @experimental */
+export interface CanvasInvokeActionRequest {
+    /**
+     * Open canvas instance identifier
+     */
+    instanceId: string;
+    /**
+     * Action name to invoke
+     */
+    actionName: string;
+    /**
+     * Action input
+     */
+    input?: {
+        [k: string]: unknown | undefined;
+    };
+}
+/**
+ * Canvas action invocation result.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "CanvasInvokeActionResult".
+ */
+/** @experimental */
+export interface CanvasInvokeActionResult {
+    /**
+     * Provider-supplied action result
+     */
+    result?: {
+        [k: string]: unknown | undefined;
+    };
+}
+/**
+ * Declared canvases available in this session.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "CanvasList".
+ */
+/** @experimental */
+export interface CanvasList {
+    /**
+     * Declared canvases available in this session
+     */
+    canvases: DiscoveredCanvas[];
+}
+/**
+ * Canvas available in the current session.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "DiscoveredCanvas".
+ */
+/** @experimental */
+export interface DiscoveredCanvas {
+    /**
+     * Human-readable canvas name
+     */
+    displayName: string;
+    /**
+     * Short, single-sentence description shown to the agent in canvas catalogs.
+     */
+    description: string;
+    inputSchema?: CanvasJsonSchema;
+    /**
+     * Actions the agent or host may invoke on an open instance
+     */
+    actions?: CanvasAction[];
+    /**
+     * Owning provider identifier
+     */
+    extensionId: string;
+    /**
+     * Owning extension display name, when available
+     */
+    extensionName?: string;
+    /**
+     * Provider-local canvas identifier
+     */
+    canvasId: string;
+}
+/**
+ * Live open-canvas snapshot.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "CanvasListOpenResult".
+ */
+/** @experimental */
+export interface CanvasListOpenResult {
+    /**
+     * Currently open canvas instances
+     */
+    openCanvases: OpenCanvasInstance[];
+}
+/**
+ * Open canvas instance snapshot.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "OpenCanvasInstance".
+ */
+/** @experimental */
+export interface OpenCanvasInstance {
+    /**
+     * Stable caller-supplied canvas instance identifier
+     */
+    instanceId: string;
+    /**
+     * Owning provider identifier
+     */
+    extensionId: string;
+    /**
+     * Owning extension display name, when available
+     */
+    extensionName?: string;
+    /**
+     * Provider-local canvas identifier
+     */
+    canvasId: string;
+    /**
+     * Rendered title
+     */
+    title?: string;
+    /**
+     * Provider-supplied status text
+     */
+    status?: string;
+    /**
+     * URL for web-rendered canvases
+     */
+    url?: string;
+    /**
+     * Input supplied when the instance was opened
+     */
+    input?: {
+        [k: string]: unknown | undefined;
+    };
+    /**
+     * Whether this snapshot came from an idempotent reopen
+     */
+    reopen: boolean;
+    availability: CanvasInstanceAvailability;
+}
+/**
+ * Canvas open parameters.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "CanvasOpenRequest".
+ */
+/** @experimental */
+export interface CanvasOpenRequest {
+    /**
+     * Owning provider identifier. Optional when the canvasId is unique across providers; required to disambiguate when multiple providers register the same canvasId.
+     */
+    extensionId?: string;
+    /**
+     * Provider-local canvas identifier
+     */
+    canvasId: string;
+    /**
+     * Caller-supplied stable instance identifier
+     */
+    instanceId: string;
+    /**
+     * Canvas open input
+     */
+    input?: {
+        [k: string]: unknown | undefined;
+    };
+}
 /**
  * Slash commands available in the session, after applying any include/exclude filters.
  *
@@ -1738,40 +2074,6 @@ export interface ConnectRemoteSessionParams {
      */
     sessionId: string;
 }
-/**
- * Optional connection token presented by the SDK client during the handshake.
- *
- * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "ConnectRequest".
- */
-/** @internal */
-export interface ConnectRequest {
-    /**
-     * Connection token; required when the server was started with COPILOT_CONNECTION_TOKEN
-     */
-    token?: string;
-}
-/**
- * Handshake result reporting the server's protocol version and package version on success.
- *
- * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "ConnectResult".
- */
-/** @internal */
-export interface ConnectResult {
-    /**
-     * Always true on success
-     */
-    ok: true;
-    /**
-     * Server protocol version number
-     */
-    protocolVersion: number;
-    /**
-     * Server package version
-     */
-    version: string;
-}
 /**
  * The currently selected model and reasoning effort for the session.
  *
@@ -2057,6 +2359,12 @@ export interface ExternalToolTextResultForLlmBinaryResultsForLlm {
      * Human-readable description of the binary data
      */
     description?: string;
+    /**
+     * Optional metadata from the producing tool.
+     */
+    metadata?: {
+        [k: string]: unknown | undefined;
+    };
 }
 /**
  * Plain text content block
@@ -2374,6 +2682,19 @@ export interface HistoryCompactContextWindow {
      */
     toolDefinitionsTokens?: number;
 }
+/**
+ * Optional compaction parameters.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "HistoryCompactRequest".
+ */
+/** @experimental */
+export interface HistoryCompactRequest {
+    /**
+     * Optional user-provided instructions to focus the compaction summary
+     */
+    customInstructions?: string;
+}
 /**
  * Compaction outcome with the number of tokens and messages removed, summary text, and the resulting context window breakdown.
  *
@@ -2635,6 +2956,274 @@ export interface LspInitializeRequest {
      */
     force?: boolean;
 }
+/**
+ * MCP server, tool name, and arguments to invoke from an MCP App view.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "McpAppsCallToolRequest".
+ */
+/** @experimental */
+export interface McpAppsCallToolRequest {
+    /**
+     * MCP server hosting the tool
+     */
+    serverName: string;
+    /**
+     * MCP tool name
+     */
+    toolName: string;
+    /**
+     * Tool arguments
+     */
+    arguments?: {
+        [k: string]: unknown | undefined;
+    };
+    /**
+     * **Required.** Server whose ui:// view issued the request. Per SEP-1865 ('callable by the app from this server only'), the call is rejected when this differs from `serverName`, and rejected outright when missing.
+     */
+    originServerName: string;
+}
+/**
+ * Capability negotiation snapshot
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "McpAppsDiagnoseCapability".
+ */
+/** @experimental */
+export interface McpAppsDiagnoseCapability {
+    /**
+     * Whether the session has the `mcp-apps` capability
+     */
+    sessionHasMcpApps: boolean;
+    /**
+     * Whether the MCP_APPS feature flag (or COPILOT_MCP_APPS env override) is on
+     */
+    featureFlagEnabled: boolean;
+    /**
+     * Whether the runtime advertises `extensions.io.modelcontextprotocol/ui` to MCP servers
+     */
+    advertised: boolean;
+}
+/**
+ * MCP server to diagnose MCP Apps wiring for.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "McpAppsDiagnoseRequest".
+ */
+/** @experimental */
+export interface McpAppsDiagnoseRequest {
+    /**
+     * MCP server to probe
+     */
+    serverName: string;
+}
+/**
+ * Diagnostic snapshot of MCP Apps wiring for the named server.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "McpAppsDiagnoseResult".
+ */
+/** @experimental */
+export interface McpAppsDiagnoseResult {
+    capability: McpAppsDiagnoseCapability;
+    server: McpAppsDiagnoseServer;
+}
+/**
+ * What the server returned for this session
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "McpAppsDiagnoseServer".
+ */
+/** @experimental */
+export interface McpAppsDiagnoseServer {
+    /**
+     * Whether the named server is currently connected
+     */
+    connected: boolean;
+    /**
+     * Total tools returned by the server's tools/list
+     */
+    toolCount: number;
+    /**
+     * Tools whose `_meta.ui` is populated (resourceUri and/or visibility set)
+     */
+    toolsWithUiMeta: number;
+    /**
+     * Up to 5 tool names with `_meta.ui` for quick inspection
+     */
+    sampleToolNames: string[];
+}
+/**
+ * Current host context advertised to MCP App guests.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "McpAppsHostContext".
+ */
+/** @experimental */
+export interface McpAppsHostContext {
+    context: McpAppsHostContextDetails;
+}
+/**
+ * Current host context
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "McpAppsHostContextDetails".
+ */
+/** @experimental */
+export interface McpAppsHostContextDetails {
+    theme?: McpAppsHostContextDetailsTheme;
+    /**
+     * BCP-47 locale, e.g. 'en-US'
+     */
+    locale?: string;
+    /**
+     * IANA timezone, e.g. 'America/New_York'
+     */
+    timeZone?: string;
+    displayMode?: McpAppsHostContextDetailsDisplayMode;
+    /**
+     * Display modes the host supports
+     */
+    availableDisplayModes?: McpAppsHostContextDetailsAvailableDisplayMode[];
+    platform?: McpAppsHostContextDetailsPlatform;
+    /**
+     * Host application identifier
+     */
+    userAgent?: string;
+    [k: string]: unknown | undefined;
+}
+/**
+ * MCP server to list app-callable tools for.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "McpAppsListToolsRequest".
+ */
+/** @experimental */
+export interface McpAppsListToolsRequest {
+    /**
+     * MCP server hosting the app
+     */
+    serverName: string;
+    /**
+     * **Required.** Server whose ui:// view issued the request. Per SEP-1865 ('callable by the app from this server only'), the call is rejected when this differs from `serverName`, and rejected outright when missing.
+     */
+    originServerName: string;
+}
+/**
+ * App-callable tools from the named MCP server.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "McpAppsListToolsResult".
+ */
+/** @experimental */
+export interface McpAppsListToolsResult {
+    /**
+     * App-callable tools from the server
+     */
+    tools: {
+        [k: string]: unknown | undefined;
+    }[];
+}
+/**
+ * MCP server and resource URI to fetch.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "McpAppsReadResourceRequest".
+ */
+/** @experimental */
+export interface McpAppsReadResourceRequest {
+    /**
+     * Name of the MCP server hosting the resource
+     */
+    serverName: string;
+    /**
+     * Resource URI (typically ui://...)
+     */
+    uri: string;
+}
+/**
+ * Resource contents returned by the MCP server.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "McpAppsReadResourceResult".
+ */
+/** @experimental */
+export interface McpAppsReadResourceResult {
+    /**
+     * Resource contents returned by the server
+     */
+    contents: McpAppsResourceContent[];
+}
+/**
+ * Schema for the `McpAppsResourceContent` type.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "McpAppsResourceContent".
+ */
+/** @experimental */
+export interface McpAppsResourceContent {
+    /**
+     * The resource URI (typically ui://...)
+     */
+    uri: string;
+    /**
+     * MIME type of the content
+     */
+    mimeType?: string;
+    /**
+     * Text content (e.g. HTML)
+     */
+    text?: string;
+    /**
+     * Base64-encoded binary content
+     */
+    blob?: string;
+    /**
+     * Resource-level metadata (CSP, permissions, etc.)
+     */
+    _meta?: {
+        [k: string]: unknown | undefined;
+    };
+}
+/**
+ * Host context advertised to MCP App guests
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "McpAppsSetHostContextDetails".
+ */
+/** @experimental */
+export interface McpAppsSetHostContextDetails {
+    theme?: McpAppsSetHostContextDetailsTheme;
+    /**
+     * BCP-47 locale, e.g. 'en-US'
+     */
+    locale?: string;
+    /**
+     * IANA timezone, e.g. 'America/New_York'
+     */
+    timeZone?: string;
+    displayMode?: McpAppsSetHostContextDetailsDisplayMode;
+    /**
+     * Display modes the host supports
+     */
+    availableDisplayModes?: McpAppsSetHostContextDetailsAvailableDisplayMode[];
+    platform?: McpAppsSetHostContextDetailsPlatform;
+    /**
+     * Host application identifier
+     */
+    userAgent?: string;
+    [k: string]: unknown | undefined;
+}
+/**
+ * Host context to advertise to MCP App guests.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "McpAppsSetHostContextRequest".
+ */
+/** @experimental */
+export interface McpAppsSetHostContextRequest {
+    context: McpAppsSetHostContextDetails;
+}
 /**
  * The requestId previously passed to executeSampling that should be cancelled.
  *
@@ -3374,21 +3963,50 @@ export interface ModelBilling {
  */
 export interface ModelBillingTokenPrices {
     /**
-     * Price per billing batch of input tokens in nano-AIUs (1 nano-AIU = 0.000000001 AIU, 1 AIU = $0.01 USD)
+     * AI Credits cost per billing batch of input tokens
      */
     inputPrice?: number;
     /**
-     * Price per billing batch of output tokens in nano-AIUs (1 nano-AIU = 0.000000001 AIU, 1 AIU = $0.01 USD)
+     * AI Credits cost per billing batch of output tokens
      */
     outputPrice?: number;
     /**
-     * Price per billing batch of cached tokens in nano-AIUs (1 nano-AIU = 0.000000001 AIU, 1 AIU = $0.01 USD)
+     * AI Credits cost per billing batch of cached tokens
      */
     cachePrice?: number;
     /**
      * Number of tokens per standard billing batch
      */
     batchSize?: number;
+    /**
+     * Maximum context window tokens for the default tier
+     */
+    contextMax?: number;
+    longContext?: ModelBillingTokenPricesLongContext;
+}
+/**
+ * Long context tier pricing (available for models with extended context windows)
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "ModelBillingTokenPricesLongContext".
+ */
+export interface ModelBillingTokenPricesLongContext {
+    /**
+     * AI Credits cost per billing batch of input tokens
+     */
+    inputPrice?: number;
+    /**
+     * AI Credits cost per billing batch of output tokens
+     */
+    outputPrice?: number;
+    /**
+     * AI Credits cost per billing batch of cached tokens
+     */
+    cachePrice?: number;
+    /**
+     * Maximum context window tokens for the long context tier
+     */
+    contextMax?: number;
 }
 /**
  * Override individual model capabilities resolved by the runtime
@@ -5200,6 +5818,30 @@ export interface ScheduleStopRequest {
 export interface ScheduleStopResult {
     entry?: ScheduleEntry;
 }
+/**
+ * Secret values to add to the redaction filter.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SecretsAddFilterValuesRequest".
+ */
+export interface SecretsAddFilterValuesRequest {
+    /**
+     * Raw secret values to register for redaction
+     */
+    values: string[];
+}
+/**
+ * Confirmation that the secret values were registered.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SecretsAddFilterValuesResult".
+ */
+export interface SecretsAddFilterValuesResult {
+    /**
+     * Whether the values were successfully registered
+     */
+    ok: true;
+}
 /**
  * File attachment
  *
@@ -5419,12 +6061,6 @@ export interface SendRequest {
      * If set, the request will fail if the named tool is not available when this message is among the user messages at the start of the current exchange
      */
     requiredTool?: string;
-    /**
-     * Optional provenance tag copied to the resulting user.message event. Supported values are `system`, `command-*`, and `schedule-*`.
-     */
-    source?: {
-        [k: string]: unknown | undefined;
-    };
     agentMode?: SendAgentMode;
     /**
      * Custom HTTP headers to include in outbound model requests for this turn. Merged with session-level provider headers; per-turn headers augment and overwrite session-level headers with the same key.
@@ -6711,6 +7347,8 @@ export interface SessionUpdateOptionsParams {
     isExperimentalMode?: boolean;
     /**
      * Custom model-provider configuration (BYOK). Opaque shape; see `ProviderConfig` in the runtime.
+     *
+     * @experimental
      */
     provider?: {
         [k: string]: unknown | undefined;
@@ -6741,6 +7379,8 @@ export interface SessionUpdateOptionsParams {
     shellProcessFlags?: string[];
     /**
      * Sandbox configuration shape; opaque to SDK consumers. See `SandboxConfig` in the runtime.
+     *
+     * @experimental
      */
     sandboxConfig?: {
         [k: string]: unknown | undefined;
@@ -6820,6 +7460,8 @@ export interface SessionUpdateOptionsParams {
     eventsLogDirectory?: string;
     /**
      * Additional content-exclusion policies to merge into the session's policy set. Opaque shape; see `ContentExclusionApiResponse` in the runtime.
+     *
+     * @experimental
      */
     additionalContentExclusionPolicies?: unknown[];
     /**
@@ -8582,6 +9224,16 @@ export interface WorkspacesSaveLargePasteResult {
         sizeBytes: number;
     } | null;
 }
+/**
+ * Standard MCP CallToolResult
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SessionMcpAppsCallToolResult".
+ */
+/** @experimental */
+export interface SessionMcpAppsCallToolResult {
+    [k: string]: unknown | undefined;
+}
 /**
  * Identifies the target session.
  *
@@ -8634,6 +9286,16 @@ export declare function createServerRpc(connection: MessageConnection): {
          */
         getQuota: (params: AccountGetQuotaRequest) => Promise<AccountGetQuotaResult>;
     };
+    secrets: {
+        /**
+         * Registers secret values for redaction in session logs and exports. The SDK calls this to inject dynamically generated secret values (e.g., OIDC tokens).
+         *
+         * @param params Secret values to add to the redaction filter.
+         *
+         * @returns Confirmation that the secret values were registered.
+         */
+        addFilterValues: (params: SecretsAddFilterValuesRequest) => Promise<SecretsAddFilterValuesResult>;
+    };
     mcp: {
         config: {
             /**
@@ -8864,21 +9526,6 @@ export declare function createServerRpc(connection: MessageConnection): {
         setAdditionalPlugins: (params: SessionsSetAdditionalPluginsRequest) => Promise<SessionsSetAdditionalPluginsResult>;
     };
 };
-/**
- * Create typed server-scoped RPC methods that are part of the SDK's internal
- * surface (e.g. handshake helpers). Not exported on the public client API.
- * @internal
- */
-export declare function createInternalServerRpc(connection: MessageConnection): {
-    /**
-     * Performs the SDK server connection handshake and validates the optional connection token.
-     *
-     * @param params Optional connection token presented by the SDK client during the handshake.
-     *
-     * @returns Handshake result reporting the server's protocol version and package version on success.
-     */
-    connect: (params: ConnectRequest) => Promise<ConnectResult>;
-};
 /** Create typed session-scoped RPC methods. */
 export declare function createSessionRpc(connection: MessageConnection, sessionId: string): {
     /**
@@ -8933,6 +9580,43 @@ export declare function createSessionRpc(connection: MessageConnection, sessionI
         setCredentials: (params: SessionSetCredentialsParams) => Promise<SessionSetCredentialsResult>;
     };
     /** @experimental */
+    canvas: {
+        /**
+         * Lists canvases declared for the session.
+         *
+         * @returns Declared canvases available in this session.
+         */
+        list: () => Promise<CanvasList>;
+        /**
+         * Lists currently open canvas instances for the live session.
+         *
+         * @returns Live open-canvas snapshot.
+         */
+        listOpen: () => Promise<CanvasListOpenResult>;
+        /**
+         * Opens or focuses a canvas instance.
+         *
+         * @param params Canvas open parameters.
+         *
+         * @returns Open canvas instance snapshot.
+         */
+        open: (params: CanvasOpenRequest) => Promise<OpenCanvasInstance>;
+        /**
+         * Closes an open canvas instance.
+         *
+         * @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 */
     model: {
         /**
          * Gets the currently selected model for the session.
@@ -9301,6 +9985,53 @@ export declare function createSessionRpc(connection: MessageConnection, sessionI
              */
             login: (params: McpOauthLoginRequest) => Promise<McpOauthLoginResult>;
         };
+        /** @experimental */
+        apps: {
+            /**
+             * Fetch an MCP resource (typically a `ui://` MCP App bundle, per SEP-1865) from a connected server. Requires the `mcp-apps` session capability.
+             *
+             * @param params MCP server and resource URI to fetch.
+             *
+             * @returns Resource contents returned by the MCP server.
+             */
+            readResource: (params: McpAppsReadResourceRequest) => Promise<McpAppsReadResourceResult>;
+            /**
+             * List tools that an MCP App view is allowed to call (SEP-1865 visibility filter). Returns tools whose `_meta.ui.visibility` is unset (default `["model","app"]`) or includes `"app"`.
+             *
+             * @param params MCP server to list app-callable tools for.
+             *
+             * @returns App-callable tools from the named MCP server.
+             */
+            listTools: (params: McpAppsListToolsRequest) => Promise<McpAppsListToolsResult>;
+            /**
+             * Call an MCP tool from an MCP App view (SEP-1865). Enforces the visibility check that prevents an app iframe from invoking model-only tools. Returns the standard MCP `CallToolResult`.
+             *
+             * @param params MCP server, tool name, and arguments to invoke from an MCP App view.
+             *
+             * @returns Standard MCP CallToolResult
+             */
+            callTool: (params: McpAppsCallToolRequest) => Promise<SessionMcpAppsCallToolResult>;
+            /**
+             * Replace the host context returned to MCP App guests on `ui/initialize`. Hosts use this to advertise theme, locale, or other metadata to the guest UI.
+             *
+             * @param params Host context to advertise to MCP App guests.
+             */
+            setHostContext: (params: McpAppsSetHostContextRequest) => Promise<void>;
+            /**
+             * Read the current host context advertised to MCP App guests.
+             *
+             * @returns Current host context advertised to MCP App guests.
+             */
+            getHostContext: () => Promise<McpAppsHostContext>;
+            /**
+             * Diagnose MCP Apps wiring for a specific MCP server. Reports the session capability, feature-flag state, advertised extension, and how many tools have `_meta.ui` populated.
+             *
+             * @param params MCP server to diagnose MCP Apps wiring for.
+             *
+             * @returns Diagnostic snapshot of MCP Apps wiring for the named server.
+             */
+            diagnose: (params: McpAppsDiagnoseRequest) => Promise<McpAppsDiagnoseResult>;
+        };
     };
     /** @experimental */
     plugins: {
@@ -9740,9 +10471,11 @@ export declare function createSessionRpc(connection: MessageConnection, sessionI
         /**
          * Compacts the session history to reduce context usage.
          *
+         * @param params Optional compaction parameters.
+         *
          * @returns Compaction outcome with the number of tokens and messages removed, summary text, and the resulting context window breakdown.
          */
-        compact: () => Promise<HistoryCompactResult>;
+        compact: (params?: HistoryCompactRequest) => Promise<HistoryCompactResult>;
         /**
          * Truncates persisted session history to a specific event.
          *