@github/copilot-sdk 1.0.4 → 1.0.5-preview.1

package/dist/generated/rpc.d.ts

@@ -3,13 +3,14 @@
  * Generated from: api.schema.json
  */
 import type { MessageConnection } from "vscode-jsonrpc/node.js";
-import type { AbortReason, Attachment, ContextTier, 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, ResponseLimitsConfig, SessionEvent, SessionMode, ShutdownType, SkillSource, UserToolSessionApproval } from "./session-events.js";
 /**
  * Initial authentication info for the session.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "AuthInfo".
  */
+/** @experimental */
 export type AuthInfo = HMACAuthInfo | EnvAuthInfo | TokenAuthInfo | CopilotApiTokenAuthInfo | UserAuthInfo | GhCliAuthInfo | ApiKeyAuthInfo;
 /**
  * Which tier this directory belongs to
@@ -243,6 +244,7 @@ export type ConnectedRemoteSessionMetadataKind =
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "ContentFilterMode".
  */
+/** @experimental */
 export type ContentFilterMode = 
 /** Leave MCP tool result content unchanged. */
 "none"
@@ -256,6 +258,7 @@ export type ContentFilterMode =
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "DiscoveredMcpServerType".
  */
+/** @experimental */
 export type DiscoveredMcpServerType = 
 /** Server communicates over stdio with a local child process. */
 "stdio"
@@ -356,7 +359,7 @@ export type ExternalToolTextResultForLlmBinaryResultsForLlmType =
  * via the `definition` "ExternalToolTextResultForLlmContent".
  */
 /** @experimental */
-export type ExternalToolTextResultForLlmContent = ExternalToolTextResultForLlmContentText | ExternalToolTextResultForLlmContentTerminal | ExternalToolTextResultForLlmContentImage | ExternalToolTextResultForLlmContentAudio | ExternalToolTextResultForLlmContentResourceLink | ExternalToolTextResultForLlmContentResource;
+export type ExternalToolTextResultForLlmContent = ExternalToolTextResultForLlmContentText | ExternalToolTextResultForLlmContentTerminal | ExternalToolTextResultForLlmContentShellExit | ExternalToolTextResultForLlmContentImage | ExternalToolTextResultForLlmContentAudio | ExternalToolTextResultForLlmContentResourceLink | ExternalToolTextResultForLlmContentResource;
 /**
  * Theme variant this icon is intended for
  *
@@ -383,6 +386,7 @@ export type ExternalToolTextResultForLlmContentResourceDetails = EmbeddedTextRes
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "FilterMapping".
  */
+/** @experimental */
 export type FilterMapping = {
     [k: string]: ContentFilterMode;
 } | ContentFilterMode;
@@ -612,6 +616,7 @@ export type McpAppsSetHostContextDetailsPlatform =
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "McpServerConfig".
  */
+/** @experimental */
 export type McpServerConfig = McpServerConfigStdio | McpServerConfigHttp;
 /**
  * Set to `true` to use defaults, or provide an object with additional auth or OIDC settings.
@@ -619,6 +624,7 @@ export type McpServerConfig = McpServerConfigStdio | McpServerConfigHttp;
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "McpServerAuthConfig".
  */
+/** @experimental */
 export type McpServerAuthConfig = boolean | McpServerAuthConfigRedirectPort;
 /**
  * Controls if tools provided by this server can be loaded on demand via tool search (auto) or always included in the initial tool list (never)
@@ -626,6 +632,7 @@ export type McpServerAuthConfig = boolean | McpServerAuthConfigRedirectPort;
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "McpServerConfigDeferTools".
  */
+/** @experimental */
 export type McpServerConfigDeferTools = 
 /** Tools may be deferred under certain conditions */
 "auto"
@@ -637,6 +644,7 @@ export type McpServerConfigDeferTools =
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "McpServerConfigHttpType".
  */
+/** @experimental */
 export type McpServerConfigHttpType = 
 /** Streamable HTTP transport. */
 "http"
@@ -648,11 +656,30 @@ export type McpServerConfigHttpType =
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "McpServerConfigHttpOauthGrantType".
  */
+/** @experimental */
 export type McpServerConfigHttpOauthGrantType = 
 /** Interactive browser-based authorization code flow with PKCE. */
 "authorization_code"
 /** Headless client credentials flow using the configured OAuth client. */
  | "client_credentials";
+/**
+ * Host response: supply dynamic headers or decline this refresh.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "McpHeadersHandlePendingHeadersRefreshRequest".
+ */
+/** @experimental */
+export type McpHeadersHandlePendingHeadersRefreshRequest = {
+    /**
+     * Headers to overlay onto the MCP request. Dynamic headers override static config headers but do not replace SDK-managed request headers.
+     */
+    headers: {
+        [k: string]: string | undefined;
+    };
+    kind: "headers";
+} | {
+    kind: "none";
+};
 /**
  * Host response to the pending OAuth request.
  *
@@ -669,10 +696,6 @@ export type McpOauthPendingRequestResponse = {
      * OAuth token type. Defaults to Bearer when omitted.
      */
     tokenType?: string;
-    /**
-     * Refresh token supplied by the host, if available.
-     */
-    refreshToken?: string;
     /**
      * Token lifetime in seconds, if known.
      */
@@ -812,6 +835,7 @@ export type MetadataSnapshotRemoteMetadataTaskType =
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "ModelPolicyState".
  */
+/** @experimental */
 export type ModelPolicyState = 
 /** The model is enabled by policy. */
 "enabled"
@@ -825,6 +849,7 @@ export type ModelPolicyState =
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "ModelPickerCategory".
  */
+/** @experimental */
 export type ModelPickerCategory = 
 /** Lightweight model category optimized for faster, lower-cost interactions. */
 "lightweight"
@@ -838,6 +863,7 @@ export type ModelPickerCategory =
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "ModelPickerPriceCategory".
  */
+/** @experimental */
 export type ModelPickerPriceCategory = 
 /** Lowest relative token cost tier. */
 "low"
@@ -1092,7 +1118,7 @@ export type ProviderEndpointTransport =
  * via the `definition` "PushAttachment".
  */
 /** @experimental */
-export type PushAttachment = PushAttachmentFile | PushAttachmentDirectory | PushAttachmentSelection | PushAttachmentGitHubReference | PushAttachmentBlob | ExtensionContextPushInput;
+export type PushAttachment = PushAttachmentFile | PushAttachmentDirectory | PushAttachmentSelection | PushAttachmentGitHubReference | PushAttachmentGitHubCommit | PushAttachmentGitHubRelease | PushAttachmentGitHubActionsJob | PushAttachmentGitHubRepository | PushAttachmentGitHubFileDiff | PushAttachmentGitHubTreeComparison | PushAttachmentGitHubUrl | PushAttachmentGitHubFile | PushAttachmentGitHubSnippet | PushAttachmentBlob | ExtensionContextPushInput;
 /**
  * Type of GitHub reference
  *
@@ -1241,6 +1267,7 @@ export type SessionFsReaddirWithTypesEntryType =
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "SessionFsSetProviderConventions".
  */
+/** @experimental */
 export type SessionFsSetProviderConventions = 
 /** Paths use Windows path conventions. */
 "windows"
@@ -1456,6 +1483,18 @@ export type SessionSource =
  | "remote"
 /** Return both local and remote sessions. */
  | "all";
+/**
+ * Sharing status for a synced session. "repo" makes the session visible to anyone with read access to the repository; "unshared" restricts it to the creator and collaborators.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SessionVisibilityStatus".
+ */
+/** @experimental */
+export type SessionVisibilityStatus = 
+/** The session is visible to repository readers. */
+"repo"
+/** The session is restricted to its creator and collaborators. */
+ | "unshared";
 /**
  * Signal to send (default: SIGTERM)
  *
@@ -1487,7 +1526,7 @@ export type SkillDiscoveryScope =
 /** A configured custom skill directory. */
  | "custom";
 /**
- * Result of invoking the slash command (text output, prompt to send to the agent, or completion).
+ * Result of invoking the slash command (text output, prompt to send to the agent, completion, or subcommand selection).
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "SlashCommandInvocationResult".
@@ -1512,6 +1551,14 @@ export type SubagentSettings = {
      * Names of subagents the user has turned off; they cannot be dispatched
      */
     disabledSubagents?: string[];
+    /**
+     * Maximum number of subagents that can run concurrently; applies to usage-based billing users only
+     */
+    maxConcurrency?: number;
+    /**
+     * Maximum subagent nesting depth; applies to usage-based billing users only
+     */
+    maxDepth?: number;
 } | null;
 /**
  * Context tier override for matching subagents
@@ -1721,6 +1768,7 @@ export type WorkspacesWorkspaceDetailsHostType =
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "AccountGetAllUsersResult".
  */
+/** @experimental */
 export type AccountGetAllUsersResult = AccountAllUsers[];
 /**
  * Parameters for aborting the current turn
@@ -1755,6 +1803,7 @@ export interface AbortResult {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "AccountAllUsers".
  */
+/** @experimental */
 export interface AccountAllUsers {
     authInfo: AuthInfo;
     /**
@@ -1768,6 +1817,7 @@ export interface AccountAllUsers {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "HMACAuthInfo".
  */
+/** @experimental */
 export interface HMACAuthInfo {
     /**
      * HMAC-based authentication used by GitHub-internal services.
@@ -1789,6 +1839,7 @@ export interface HMACAuthInfo {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "CopilotUserResponse".
  */
+/** @experimental */
 export interface CopilotUserResponse {
     login?: string;
     access_type_sku?: string;
@@ -1839,6 +1890,7 @@ export interface CopilotUserResponse {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "CopilotUserResponseEndpoints".
  */
+/** @experimental */
 export interface CopilotUserResponseEndpoints {
     api?: string;
     "origin-tracker"?: string;
@@ -1851,6 +1903,7 @@ export interface CopilotUserResponseEndpoints {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "CopilotUserResponseQuotaSnapshots".
  */
+/** @experimental */
 export interface CopilotUserResponseQuotaSnapshots {
     chat?: CopilotUserResponseQuotaSnapshotsChat;
     completions?: CopilotUserResponseQuotaSnapshotsCompletions;
@@ -1876,6 +1929,7 @@ export interface CopilotUserResponseQuotaSnapshots {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "CopilotUserResponseQuotaSnapshotsChat".
  */
+/** @experimental */
 export interface CopilotUserResponseQuotaSnapshotsChat {
     entitlement?: number;
     overage_count?: number;
@@ -1896,6 +1950,7 @@ export interface CopilotUserResponseQuotaSnapshotsChat {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "CopilotUserResponseQuotaSnapshotsCompletions".
  */
+/** @experimental */
 export interface CopilotUserResponseQuotaSnapshotsCompletions {
     entitlement?: number;
     overage_count?: number;
@@ -1916,6 +1971,7 @@ export interface CopilotUserResponseQuotaSnapshotsCompletions {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "CopilotUserResponseQuotaSnapshotsPremiumInteractions".
  */
+/** @experimental */
 export interface CopilotUserResponseQuotaSnapshotsPremiumInteractions {
     entitlement?: number;
     overage_count?: number;
@@ -1936,6 +1992,7 @@ export interface CopilotUserResponseQuotaSnapshotsPremiumInteractions {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "EnvAuthInfo".
  */
+/** @experimental */
 export interface EnvAuthInfo {
     /**
      * Personal access token (PAT) or server-to-server token sourced from an environment variable.
@@ -1965,6 +2022,7 @@ export interface EnvAuthInfo {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "TokenAuthInfo".
  */
+/** @experimental */
 export interface TokenAuthInfo {
     /**
      * SDK-side token authentication; the host configured the token directly via the SDK.
@@ -1986,6 +2044,7 @@ export interface TokenAuthInfo {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "CopilotApiTokenAuthInfo".
  */
+/** @experimental */
 export interface CopilotApiTokenAuthInfo {
     /**
      * Direct Copilot API authentication via the `GITHUB_COPILOT_API_TOKEN` + `COPILOT_API_URL` environment-variable pair. The token itself is read from the environment by the runtime, not carried in this struct.
@@ -2003,6 +2062,7 @@ export interface CopilotApiTokenAuthInfo {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "UserAuthInfo".
  */
+/** @experimental */
 export interface UserAuthInfo {
     /**
      * OAuth user authentication. The token itself is held in the runtime's secret token store (keyed by host+login) and is NOT carried in this struct.
@@ -2024,6 +2084,7 @@ export interface UserAuthInfo {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "GhCliAuthInfo".
  */
+/** @experimental */
 export interface GhCliAuthInfo {
     /**
      * Authentication via the `gh` CLI's saved credentials.
@@ -2049,6 +2110,7 @@ export interface GhCliAuthInfo {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "ApiKeyAuthInfo".
  */
+/** @experimental */
 export interface ApiKeyAuthInfo {
     /**
      * API-key authentication for non-GitHub LLM providers (e.g. when running BYOM-style).
@@ -2070,6 +2132,7 @@ export interface ApiKeyAuthInfo {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "AccountGetCurrentAuthResult".
  */
+/** @experimental */
 export interface AccountGetCurrentAuthResult {
     authInfo?: AuthInfo;
     /**
@@ -2077,6 +2140,7 @@ export interface AccountGetCurrentAuthResult {
      */
     authErrors?: string[];
 }
+/** @experimental */
 export interface AccountGetQuotaRequest {
     /**
      * GitHub token for per-user quota lookup. When provided, resolves this token to determine the user's quota instead of using the global auth.
@@ -2089,6 +2153,7 @@ export interface AccountGetQuotaRequest {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "AccountGetQuotaResult".
  */
+/** @experimental */
 export interface AccountGetQuotaResult {
     /**
      * Quota snapshots keyed by type (e.g., chat, completions, premium_interactions)
@@ -2103,6 +2168,7 @@ export interface AccountGetQuotaResult {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "AccountQuotaSnapshot".
  */
+/** @experimental */
 export interface AccountQuotaSnapshot {
     /**
      * Whether the user has an unlimited usage entitlement
@@ -2143,6 +2209,7 @@ export interface AccountQuotaSnapshot {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "AccountLoginRequest".
  */
+/** @experimental */
 export interface AccountLoginRequest {
     /**
      * GitHub host URL
@@ -2163,6 +2230,7 @@ export interface AccountLoginRequest {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "AccountLoginResult".
  */
+/** @experimental */
 export interface AccountLoginResult {
     /**
      * Whether the credential was persisted to a secure store (system keychain, or the config file when plaintext storage is enabled). False when no secure store was available and the token was not saved, so the consumer can decide how to proceed.
@@ -2175,6 +2243,7 @@ export interface AccountLoginResult {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "AccountLogoutRequest".
  */
+/** @experimental */
 export interface AccountLogoutRequest {
     authInfo: AuthInfo;
 }
@@ -2184,6 +2253,7 @@ export interface AccountLogoutRequest {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "AccountLogoutResult".
  */
+/** @experimental */
 export interface AccountLogoutResult {
     /**
      * Whether other authenticated users remain after logout
@@ -3326,6 +3396,7 @@ export interface CurrentToolMetadata {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "DiscoveredMcpServer".
  */
+/** @experimental */
 export interface DiscoveredMcpServer {
     /**
      * Server name (config key)
@@ -3667,6 +3738,39 @@ export interface ExternalToolTextResultForLlmContentTerminal {
      */
     cwd?: string;
 }
+/**
+ * Shell command exit metadata with optional output preview
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "ExternalToolTextResultForLlmContentShellExit".
+ */
+/** @experimental */
+export interface ExternalToolTextResultForLlmContentShellExit {
+    /**
+     * Content block type discriminator
+     */
+    type: "shell_exit";
+    /**
+     * Shell id, as assigned by Copilot runtime
+     */
+    shellId: string;
+    /**
+     * Exit code from the completed shell command
+     */
+    exitCode: number;
+    /**
+     * Working directory where the shell command was executed
+     */
+    cwd?: string;
+    /**
+     * Output associated with this shell command, if available. May be partial, truncated, or a preview; not guaranteed to be full output.
+     */
+    outputPreview?: string;
+    /**
+     * Whether outputPreview is known to be incomplete or truncated
+     */
+    outputTruncated?: boolean;
+}
 /**
  * Image content block with base64-encoded data
  *
@@ -4115,6 +4219,10 @@ export interface InstalledPluginInfo {
      * Marketplace the plugin came from. Empty string ("") for direct repo / URL / local installs.
      */
     marketplace: string;
+    /**
+     * Opaque, stable hash identifying a direct (non-marketplace) install source. Present only for direct repo / URL / local installs; absent for marketplace plugins. Same source yields the same id; distinct sources never collide.
+     */
+    directSourceId?: string;
     /**
      * Installed version (when reported by the plugin manifest)
      */
@@ -5023,6 +5131,7 @@ export interface McpCancelSamplingExecutionResult {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "McpConfigAddRequest".
  */
+/** @experimental */
 export interface McpConfigAddRequest {
     /**
      * Unique name for the MCP server
@@ -5036,6 +5145,7 @@ export interface McpConfigAddRequest {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "McpServerConfigStdio".
  */
+/** @experimental */
 export interface McpServerConfigStdio {
     /**
      * Tools to include. Defaults to all tools if not specified.
@@ -5078,6 +5188,7 @@ export interface McpServerConfigStdio {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "McpServerAuthConfigRedirectPort".
  */
+/** @experimental */
 export interface McpServerAuthConfigRedirectPort {
     /**
      * Fixed port for the OAuth redirect callback server.
@@ -5090,6 +5201,7 @@ export interface McpServerAuthConfigRedirectPort {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "McpServerConfigHttp".
  */
+/** @experimental */
 export interface McpServerConfigHttp {
     /**
      * Tools to include. Defaults to all tools if not specified.
@@ -5134,6 +5246,7 @@ export interface McpServerConfigHttp {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "McpConfigDisableRequest".
  */
+/** @experimental */
 export interface McpConfigDisableRequest {
     /**
      * Names of MCP servers to disable. Each server is added to the persisted disabled list so new sessions skip it. Already-disabled names are ignored. Active sessions keep their current connections until they end.
@@ -5146,6 +5259,7 @@ export interface McpConfigDisableRequest {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "McpConfigEnableRequest".
  */
+/** @experimental */
 export interface McpConfigEnableRequest {
     /**
      * Names of MCP servers to enable. Each server is removed from the persisted disabled list so new sessions spawn it. Unknown or already-enabled names are ignored.
@@ -5158,6 +5272,7 @@ export interface McpConfigEnableRequest {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "McpConfigList".
  */
+/** @experimental */
 export interface McpConfigList {
     /**
      * All MCP servers from user config, keyed by name
@@ -5172,6 +5287,7 @@ export interface McpConfigList {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "McpConfigRemoveRequest".
  */
+/** @experimental */
 export interface McpConfigRemoveRequest {
     /**
      * Name of the MCP server to remove
@@ -5184,6 +5300,7 @@ export interface McpConfigRemoveRequest {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "McpConfigUpdateRequest".
  */
+/** @experimental */
 export interface McpConfigUpdateRequest {
     /**
      * Name of the MCP server to update
@@ -5223,6 +5340,7 @@ export interface McpDisableRequest {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "McpDiscoverRequest".
  */
+/** @experimental */
 export interface McpDiscoverRequest {
     /**
      * Working directory used as context for discovery (e.g., plugin resolution)
@@ -5235,6 +5353,7 @@ export interface McpDiscoverRequest {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "McpDiscoverResult".
  */
+/** @experimental */
 export interface McpDiscoverResult {
     /**
      * MCP servers discovered from all sources
@@ -5323,6 +5442,33 @@ export interface McpFilteredServer {
      */
     enterpriseName?: string;
 }
+/**
+ * MCP headers refresh request id and the host response.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "McpHeadersHandlePendingHeadersRefreshRequestRequest".
+ */
+/** @experimental */
+export interface McpHeadersHandlePendingHeadersRefreshRequestRequest {
+    /**
+     * Headers refresh request identifier from mcp.headers_refresh_required
+     */
+    requestId: string;
+    result: McpHeadersHandlePendingHeadersRefreshRequest;
+}
+/**
+ * Indicates whether the pending MCP headers refresh response was accepted.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "McpHeadersHandlePendingHeadersRefreshRequestResult".
+ */
+/** @experimental */
+export interface McpHeadersHandlePendingHeadersRefreshRequestResult {
+    /**
+     * Whether the response was accepted. False if the request was unknown, timed out, or already resolved.
+     */
+    success: boolean;
+}
 /**
  * Host-level state, omitted when no MCP host is initialized.
  *
@@ -5892,6 +6038,7 @@ export interface MetadataSnapshotRemoteMetadataRepository {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "Model".
  */
+/** @experimental */
 export interface Model {
     /**
      * Model identifier (e.g., "claude-sonnet-4.5")
@@ -5921,6 +6068,7 @@ export interface Model {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "ModelCapabilities".
  */
+/** @experimental */
 export interface ModelCapabilities {
     supports?: ModelCapabilitiesSupports;
     limits?: ModelCapabilitiesLimits;
@@ -5931,6 +6079,7 @@ export interface ModelCapabilities {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "ModelCapabilitiesSupports".
  */
+/** @experimental */
 export interface ModelCapabilitiesSupports {
     /**
      * Whether this model supports vision/image input
@@ -5947,6 +6096,7 @@ export interface ModelCapabilitiesSupports {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "ModelCapabilitiesLimits".
  */
+/** @experimental */
 export interface ModelCapabilitiesLimits {
     /**
      * Maximum number of prompt/input tokens
@@ -5968,6 +6118,7 @@ export interface ModelCapabilitiesLimits {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "ModelCapabilitiesLimitsVision".
  */
+/** @experimental */
 export interface ModelCapabilitiesLimitsVision {
     /**
      * MIME types the model accepts
@@ -5988,6 +6139,7 @@ export interface ModelCapabilitiesLimitsVision {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "ModelPolicy".
  */
+/** @experimental */
 export interface ModelPolicy {
     state: ModelPolicyState;
     /**
@@ -6001,12 +6153,17 @@ export interface ModelPolicy {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "ModelBilling".
  */
+/** @experimental */
 export interface ModelBilling {
     /**
      * Billing cost multiplier relative to the base rate
      */
     multiplier?: number;
     tokenPrices?: ModelBillingTokenPrices;
+    /**
+     * Whole-number percentage discount (0-100) applied to usage billed through this model. Populated for the synthetic `auto` model, where requests routed by auto-mode are billed at a reduced rate; absent for concrete models.
+     */
+    discountPercent?: number;
 }
 /**
  * Token-level pricing information for this model
@@ -6014,6 +6171,7 @@ export interface ModelBilling {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "ModelBillingTokenPrices".
  */
+/** @experimental */
 export interface ModelBillingTokenPrices {
     /**
      * AI Credits cost per billing batch of input tokens
@@ -6057,6 +6215,7 @@ export interface ModelBillingTokenPrices {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "ModelBillingTokenPricesLongContext".
  */
+/** @experimental */
 export interface ModelBillingTokenPricesLongContext {
     /**
      * AI Credits cost per billing batch of input tokens
@@ -6166,6 +6325,7 @@ export interface ModelCapabilitiesOverrideLimitsVision {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "ModelList".
  */
+/** @experimental */
 export interface ModelList {
     /**
      * List of available models with full metadata
@@ -6211,6 +6371,7 @@ export interface ModelSetReasoningEffortResult {
      */
     reasoningEffort: string;
 }
+/** @experimental */
 export interface ModelsListRequest {
     /**
      * GitHub token for per-user model listing. When provided, resolves this token to determine the user's Copilot plan and available models instead of using the global auth.
@@ -7483,6 +7644,7 @@ export interface PermissionsFolderTrustAddTrustedResult {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "PermissionsGetAllowAllRequest".
  */
+/** @experimental */
 export interface PermissionsGetAllowAllRequest {
 }
 /**
@@ -7565,6 +7727,7 @@ export interface PermissionsPathsAddResult {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "PermissionsPathsListRequest".
  */
+/** @experimental */
 export interface PermissionsPathsListRequest {
 }
 /**
@@ -7586,6 +7749,7 @@ export interface PermissionsPathsUpdatePrimaryResult {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "PermissionsPendingRequestsRequest".
  */
+/** @experimental */
 export interface PermissionsPendingRequestsRequest {
 }
 /**
@@ -7594,6 +7758,7 @@ export interface PermissionsPendingRequestsRequest {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "PermissionsResetSessionApprovalsRequest".
  */
+/** @experimental */
 export interface PermissionsResetSessionApprovalsRequest {
 }
 /**
@@ -7708,6 +7873,7 @@ export interface PermissionUrlsSetUnrestrictedModeParams {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "PingRequest".
  */
+/** @experimental */
 export interface PingRequest {
     /**
      * Optional message to echo back
@@ -7720,6 +7886,7 @@ export interface PingRequest {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "PingResult".
  */
+/** @experimental */
 export interface PingResult {
     /**
      * Echoed message (or default greeting)
@@ -8043,6 +8210,10 @@ export interface PluginsUninstallRequest {
      * Plugin name or "plugin@marketplace" spec to uninstall. When ambiguous, prefer the fully-qualified spec.
      */
     name: string;
+    /**
+     * Stable source identity for a direct (non-marketplace) install. Disambiguates uninstall when multiple installed plugins share the same name.
+     */
+    directSourceId?: string | null;
 }
 /**
  * Name (or spec) of the plugin to update.
@@ -8541,6 +8712,279 @@ export interface PushAttachmentGitHubReference {
      */
     url: string;
 }
+/**
+ * Pointer to a GitHub commit.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "PushAttachmentGitHubCommit".
+ */
+/** @experimental */
+export interface PushAttachmentGitHubCommit {
+    /**
+     * Attachment type discriminator
+     */
+    type: "github_commit";
+    repo: PushGitHubRepoRef;
+    /**
+     * Full commit SHA
+     */
+    oid: string;
+    /**
+     * First line of the commit message
+     */
+    message: string;
+    /**
+     * URL to the commit on GitHub
+     */
+    url: string;
+}
+/**
+ * Pointer to a GitHub repository.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "PushGitHubRepoRef".
+ */
+/** @experimental */
+export interface PushGitHubRepoRef {
+    /**
+     * Numeric GitHub repository id
+     */
+    id?: number;
+    /**
+     * Repository name (without owner)
+     */
+    name: string;
+    /**
+     * Repository owner login (user or organization)
+     */
+    owner: string;
+}
+/**
+ * Pointer to a GitHub release.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "PushAttachmentGitHubRelease".
+ */
+/** @experimental */
+export interface PushAttachmentGitHubRelease {
+    /**
+     * Attachment type discriminator
+     */
+    type: "github_release";
+    repo: PushGitHubRepoRef;
+    /**
+     * Git tag the release is anchored to
+     */
+    tagName: string;
+    /**
+     * Human-readable release name
+     */
+    name: string;
+    /**
+     * URL to the release on GitHub
+     */
+    url: string;
+}
+/**
+ * Pointer to a GitHub Actions job.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "PushAttachmentGitHubActionsJob".
+ */
+/** @experimental */
+export interface PushAttachmentGitHubActionsJob {
+    /**
+     * Attachment type discriminator
+     */
+    type: "github_actions_job";
+    repo: PushGitHubRepoRef;
+    /**
+     * Job id within the workflow run
+     */
+    jobId: number;
+    /**
+     * Display name of the job
+     */
+    jobName: string;
+    /**
+     * Display name of the workflow the job ran in
+     */
+    workflowName: string;
+    /**
+     * URL to the job on GitHub
+     */
+    url: string;
+    /**
+     * Terminal conclusion of the job when finished (e.g., success, failure, cancelled). Absent for in-progress jobs.
+     */
+    conclusion?: string;
+}
+/**
+ * Pointer to a GitHub repository.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "PushAttachmentGitHubRepository".
+ */
+/** @experimental */
+export interface PushAttachmentGitHubRepository {
+    /**
+     * Attachment type discriminator
+     */
+    type: "github_repository";
+    repo: PushGitHubRepoRef;
+    /**
+     * URL to the repository on GitHub
+     */
+    url: string;
+    /**
+     * Short description of the repository
+     */
+    description?: string;
+    /**
+     * Git ref this attachment is anchored at (branch, tag, or commit). When absent the default branch is implied.
+     */
+    ref?: string;
+}
+/**
+ * Pointer to a single-file diff. At least one of `head` and `base` must be present.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "PushAttachmentGitHubFileDiff".
+ */
+/** @experimental */
+export interface PushAttachmentGitHubFileDiff {
+    /**
+     * Attachment type discriminator
+     */
+    type: "github_file_diff";
+    /**
+     * URL to the diff on GitHub (e.g., a commit, compare, or PR-file URL)
+     */
+    url: string;
+    head?: PushAttachmentGitHubFileDiffSide;
+    base?: PushAttachmentGitHubFileDiffSide;
+}
+/**
+ * One side of a file diff (head or base)
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "PushAttachmentGitHubFileDiffSide".
+ */
+/** @experimental */
+export interface PushAttachmentGitHubFileDiffSide {
+    repo: PushGitHubRepoRef;
+    /**
+     * Git ref (branch, tag, or commit SHA) the file is read at
+     */
+    ref: string;
+    /**
+     * Repository-relative path to the file
+     */
+    path: string;
+}
+/**
+ * Pointer to a comparison between two git revisions.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "PushAttachmentGitHubTreeComparison".
+ */
+/** @experimental */
+export interface PushAttachmentGitHubTreeComparison {
+    /**
+     * Attachment type discriminator
+     */
+    type: "github_tree_comparison";
+    /**
+     * URL to the comparison on GitHub
+     */
+    url: string;
+    base: PushAttachmentGitHubTreeComparisonSide;
+    head: PushAttachmentGitHubTreeComparisonSide;
+}
+/**
+ * One side of a tree comparison (head or base)
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "PushAttachmentGitHubTreeComparisonSide".
+ */
+/** @experimental */
+export interface PushAttachmentGitHubTreeComparisonSide {
+    repo: PushGitHubRepoRef;
+    /**
+     * Git revision (branch, tag, or commit SHA)
+     */
+    revision: string;
+}
+/**
+ * Generic GitHub URL reference.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "PushAttachmentGitHubUrl".
+ */
+/** @experimental */
+export interface PushAttachmentGitHubUrl {
+    /**
+     * Attachment type discriminator
+     */
+    type: "github_url";
+    /**
+     * URL to the GitHub resource
+     */
+    url: string;
+}
+/**
+ * Pointer to a file in a GitHub repository at a specific ref.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "PushAttachmentGitHubFile".
+ */
+/** @experimental */
+export interface PushAttachmentGitHubFile {
+    /**
+     * Attachment type discriminator
+     */
+    type: "github_file";
+    repo: PushGitHubRepoRef;
+    /**
+     * Git ref the file is read at (branch, tag, or commit SHA)
+     */
+    ref: string;
+    /**
+     * Repository-relative path to the file
+     */
+    path: string;
+    /**
+     * URL to the file on GitHub
+     */
+    url: string;
+}
+/**
+ * Pointer to a line range inside a file in a GitHub repository.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "PushAttachmentGitHubSnippet".
+ */
+/** @experimental */
+export interface PushAttachmentGitHubSnippet {
+    /**
+     * Attachment type discriminator
+     */
+    type: "github_snippet";
+    repo: PushGitHubRepoRef;
+    /**
+     * Git ref the file is read at (branch, tag, or commit SHA)
+     */
+    ref: string;
+    /**
+     * Repository-relative path to the file
+     */
+    path: string;
+    /**
+     * URL to the snippet on GitHub (with line anchor)
+     */
+    url: string;
+    lineRange: PushAttachmentFileLineRange;
+}
 /**
  * Blob attachment with inline base64-encoded data
  *
@@ -9188,6 +9632,7 @@ export interface ScheduleStopResult {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "SecretsAddFilterValuesRequest".
  */
+/** @experimental */
 export interface SecretsAddFilterValuesRequest {
     /**
      * Raw secret values to register for redaction
@@ -9200,6 +9645,7 @@ export interface SecretsAddFilterValuesRequest {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "SecretsAddFilterValuesResult".
  */
+/** @experimental */
 export interface SecretsAddFilterValuesResult {
     /**
      * Whether the values were successfully registered
@@ -9321,6 +9767,7 @@ export interface ServerInstructionSourceList {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "ServerSkill".
  */
+/** @experimental */
 export interface ServerSkill {
     /**
      * Unique identifier for the skill
@@ -9358,6 +9805,7 @@ export interface ServerSkill {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "ServerSkillList".
  */
+/** @experimental */
 export interface ServerSkillList {
     /**
      * All discovered skills across all sources
@@ -9692,6 +10140,7 @@ export interface SessionFsRmRequest {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "SessionFsSetProviderCapabilities".
  */
+/** @experimental */
 export interface SessionFsSetProviderCapabilities {
     /**
      * Whether the provider supports SQLite query/exists operations
@@ -9704,6 +10153,7 @@ export interface SessionFsSetProviderCapabilities {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "SessionFsSetProviderRequest".
  */
+/** @experimental */
 export interface SessionFsSetProviderRequest {
     /**
      * Initial working directory for sessions
@@ -9722,6 +10172,7 @@ export interface SessionFsSetProviderRequest {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "SessionFsSetProviderResult".
  */
+/** @experimental */
 export interface SessionFsSetProviderResult {
     /**
      * Whether the provider was set successfully
@@ -10054,6 +10505,10 @@ export interface SessionMetadataSnapshot {
      * Currently selected model identifier, if any
      */
     selectedModel?: string;
+    /**
+     * Current response limits for the session, or null when no limits are active
+     */
+    responseLimits: ResponseLimitsConfig | null;
     /**
      * 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).
      */
@@ -10195,6 +10650,10 @@ export interface SessionOpenOptions {
      */
     logInteractiveShells?: boolean;
     envValueMode?: SessionOpenOptionsEnvValueMode;
+    /**
+     * Whether to include instructions from every MCP server in the system prompt instead of only allowlisted servers.
+     */
+    allowAllMcpServerInstructions?: boolean;
     /**
      * Additional directories to search for skills.
      */
@@ -10262,6 +10721,7 @@ export interface SessionOpenOptions {
      */
     maxInlineBinaryBytes?: number;
     modelCapabilitiesOverrides?: ModelCapabilitiesOverride;
+    responseLimits?: ResponseLimitsConfig;
     /**
      * Runtime context discriminator for agent filtering.
      */
@@ -10623,6 +11083,10 @@ export interface SessionSetCredentialsResult {
      * Whether the operation succeeded
      */
     success: boolean;
+    /**
+     * Whether the session ended up with a populated `copilotUser` for the installed credentials. `true` when the supplied credential already carried `copilotUser` or it was successfully re-resolved server-side. `false` when the credential is installed without `copilotUser` — either re-resolution failed, or the variant cannot be re-resolved from the credential alone (only the raw-token variants `token`, `env`, and `gh-cli` can). In both `false` cases the token swap still applied, but plan/quota/billing metadata is degraded. Present whenever a credential was supplied; omitted only when no credential was supplied (no-op call).
+     */
+    copilotUserResolved?: boolean;
 }
 /**
  * UUID prefix to resolve to a unique session ID.
@@ -11135,6 +11599,10 @@ export interface SessionUpdateOptionsParams {
      */
     logInteractiveShells?: boolean;
     envValueMode?: OptionsUpdateEnvValueMode;
+    /**
+     * Whether to include instructions from every MCP server in the system prompt instead of only allowlisted servers.
+     */
+    allowAllMcpServerInstructions?: boolean;
     /**
      * Additional directories to search for skills.
      */
@@ -11250,6 +11718,10 @@ export interface SessionUpdateOptionsParams {
      */
     enableSkills?: boolean;
     contextTier?: OptionsUpdateContextTier;
+    /**
+     * Optional response limits. Pass null to clear the response limits.
+     */
+    responseLimits?: ResponseLimitsConfig | null;
 }
 /**
  * Indicates whether the session options patch was applied successfully.
@@ -11461,6 +11933,7 @@ export interface SkillList {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "SkillsConfigSetDisabledSkillsRequest".
  */
+/** @experimental */
 export interface SkillsConfigSetDisabledSkillsRequest {
     /**
      * List of skill names to disable
@@ -11486,6 +11959,7 @@ export interface SkillsDisableRequest {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "SkillsDiscoverRequest".
  */
+/** @experimental */
 export interface SkillsDiscoverRequest {
     /**
      * Optional list of project directory paths to scan for project-scoped skills
@@ -12175,6 +12649,7 @@ export interface TelemetrySetFeatureOverridesRequest {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "Tool".
  */
+/** @experimental */
 export interface Tool {
     /**
      * Tool identifier (e.g., "bash", "grep", "str_replace_editor")
@@ -12205,6 +12680,7 @@ export interface Tool {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "ToolList".
  */
+/** @experimental */
 export interface ToolList {
     /**
      * List of available built-in tools with metadata
@@ -12239,6 +12715,7 @@ export interface ToolsInitializeAndValidateResult {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "ToolsListRequest".
  */
+/** @experimental */
 export interface ToolsListRequest {
     /**
      * Optional model ID — when provided, the returned tool list reflects model-specific overrides
@@ -13019,6 +13496,120 @@ export interface UserRequestedShellCommandResult {
      */
     error?: string;
 }
+/**
+ * A single user setting's effective value alongside its default, so consumers can render settings left at their default.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "UserSettingMetadata".
+ */
+/** @experimental */
+export interface UserSettingMetadata {
+    /**
+     * The effective value: the user's value if set, otherwise the default.
+     */
+    value: {
+        [k: string]: unknown | undefined;
+    };
+    /**
+     * The centrally-known default for this setting (null when no default is registered).
+     */
+    default: {
+        [k: string]: unknown | undefined;
+    };
+    /**
+     * True when the user has not set an explicit value for this setting (i.e. it is left at its default). Reflects whether the user has overridden the key, not whether the effective value happens to equal the default — a key explicitly set to a value identical to the default still reports false.
+     */
+    isDefault: boolean;
+}
+/**
+ * Per-key metadata for every known user setting (settings.json overlaid with the legacy config.json, config.json wins), including settings left at their default. Excludes repository- and enterprise-managed overrides.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "UserSettingsGetResult".
+ */
+/** @experimental */
+export interface UserSettingsGetResult {
+    /**
+     * Every known user setting keyed by setting name, each with its effective value, default, and whether it is at the default.
+     */
+    settings: {
+        [k: string]: UserSettingMetadata;
+    };
+}
+/**
+ * Partial user settings to write to settings.json. Each top-level key is written individually, replacing the existing value; a key whose value is null is removed.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "UserSettingsSetRequest".
+ */
+/** @experimental */
+export interface UserSettingsSetRequest {
+    /**
+     * Partial user settings to write, as a free-form object keyed by setting name
+     */
+    settings: {
+        [k: string]: unknown | undefined;
+    };
+}
+/**
+ * Outcome of writing user settings.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "UserSettingsSetResult".
+ */
+/** @experimental */
+export interface UserSettingsSetResult {
+    /**
+     * Top-level keys whose write landed in settings.json but is shadowed by a value still present in the legacy config.json (config.json wins on read). The write does not take effect until the legacy value is removed.
+     */
+    shadowedKeys: string[];
+}
+/**
+ * Current sharing status and shareable GitHub URL for a session.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "VisibilityGetResult".
+ */
+/** @experimental */
+export interface VisibilityGetResult {
+    /**
+     * Whether the session has been synced to Mission Control (i.e. has a GitHub task). When false, the session cannot be shared and `status`/`shareUrl` are absent.
+     */
+    synced: boolean;
+    status?: SessionVisibilityStatus;
+    /**
+     * Shareable GitHub URL for the session. Present when the session is synced and the URL can be resolved.
+     */
+    shareUrl?: string;
+}
+/**
+ * Desired sharing status for the session.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "VisibilitySetRequest".
+ */
+/** @experimental */
+export interface VisibilitySetRequest {
+    status: SessionVisibilityStatus;
+}
+/**
+ * Effective sharing status and shareable GitHub URL after updating session visibility.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "VisibilitySetResult".
+ */
+/** @experimental */
+export interface VisibilitySetResult {
+    /**
+     * Whether the session has been synced to Mission Control (i.e. has a GitHub task). When false, the visibility change could not be applied and `status`/`shareUrl` are absent.
+     */
+    synced: boolean;
+    status?: SessionVisibilityStatus;
+    /**
+     * Shareable GitHub URL for the session. Present when the session is synced and the URL can be resolved.
+     */
+    shareUrl?: string;
+}
 /**
  * A single changed file and its unified diff.
  *
@@ -13303,8 +13894,11 @@ export declare function createServerRpc(connection: MessageConnection): {
      * @param params Optional message to echo back to the caller.
      *
      * @returns Server liveness response, including the echoed message, current server timestamp, and protocol version.
+     *
+     * @experimental
      */
     ping: (params: PingRequest) => Promise<PingResult>;
+    /** @experimental */
     models: {
         /**
          * Lists Copilot models available to the authenticated user.
@@ -13315,6 +13909,7 @@ export declare function createServerRpc(connection: MessageConnection): {
          */
         list: (params: ModelsListRequest) => Promise<ModelList>;
     };
+    /** @experimental */
     tools: {
         /**
          * Lists built-in tools available for a model.
@@ -13325,6 +13920,7 @@ export declare function createServerRpc(connection: MessageConnection): {
          */
         list: (params: ToolsListRequest) => Promise<ToolList>;
     };
+    /** @experimental */
     account: {
         /**
          * Gets Copilot quota usage for the authenticated user or supplied GitHub token.
@@ -13363,6 +13959,7 @@ export declare function createServerRpc(connection: MessageConnection): {
          */
         logout: (params: AccountLogoutRequest) => Promise<AccountLogoutResult>;
     };
+    /** @experimental */
     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).
@@ -13373,7 +13970,9 @@ export declare function createServerRpc(connection: MessageConnection): {
          */
         addFilterValues: (params: SecretsAddFilterValuesRequest) => Promise<SecretsAddFilterValuesResult>;
     };
+    /** @experimental */
     mcp: {
+        /** @experimental */
         config: {
             /**
              * Lists MCP servers from user configuration.
@@ -13515,7 +14114,9 @@ export declare function createServerRpc(connection: MessageConnection): {
             refresh: (params: PluginsMarketplacesRefreshRequest) => Promise<MarketplaceRefreshResult>;
         };
     };
+    /** @experimental */
     skills: {
+        /** @experimental */
         config: {
             /**
              * Replaces the global list of disabled skills.
@@ -13538,8 +14139,6 @@ export declare function createServerRpc(connection: MessageConnection): {
          * @param params Optional project paths to enumerate.
          *
          * @returns Canonical locations where skills can be created so the runtime will recognize them.
-         *
-         * @experimental
          */
         getDiscoveryPaths: (params: SkillsGetDiscoveryPathsRequest) => Promise<SkillDiscoveryPathList>;
     };
@@ -13581,20 +14180,38 @@ export declare function createServerRpc(connection: MessageConnection): {
          */
         getDiscoveryPaths: (params: InstructionsGetDiscoveryPathsRequest) => Promise<InstructionDiscoveryPathList>;
     };
+    /** @experimental */
     user: {
+        /** @experimental */
         settings: {
             /**
              * Drops this runtime process's in-memory user settings cache so the next settings read observes disk.
              */
             reload: () => Promise<void>;
+            /**
+             * Lists every known user setting (settings.json overlaid with the legacy config.json, config.json wins), each with its effective value, its default, and whether it is at the default — so settings the user has never set still appear with their default value. Does not include repository- or enterprise-managed overrides that the runtime layers on top at session time.
+             *
+             * @returns Per-key metadata for every known user setting (settings.json overlaid with the legacy config.json, config.json wins), including settings left at their default. Excludes repository- and enterprise-managed overrides.
+             */
+            get: () => Promise<UserSettingsGetResult>;
+            /**
+             * Writes one or more user settings to settings.json, replacing each provided top-level key. A key whose value is null is removed. Returns the keys whose new value is shadowed by a legacy config.json entry (config.json wins on read), which the runtime leaves in place — such writes do not take effect until the legacy value is removed.
+             *
+             * @param params Partial user settings to write to settings.json. Each top-level key is written individually, replacing the existing value; a key whose value is null is removed.
+             *
+             * @returns Outcome of writing user settings.
+             */
+            set: (params: UserSettingsSetRequest) => Promise<UserSettingsSetResult>;
         };
     };
+    /** @experimental */
     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>;
     };
+    /** @experimental */
     sessionFs: {
         /**
          * Registers an SDK client as the session filesystem provider.
@@ -13862,7 +14479,7 @@ export declare function createSessionRpc(connection: MessageConnection, sessionI
      */
     shutdown: (params: ShutdownRequest) => Promise<void>;
     /** @experimental */
-    auth: {
+    gitHubAuth: {
         /**
          * Gets authentication status and account metadata for the session.
          *
@@ -14346,6 +14963,17 @@ export declare function createSessionRpc(connection: MessageConnection, sessionI
             login: (params: McpOauthLoginRequest) => Promise<McpOauthLoginResult>;
         };
         /** @experimental */
+        headers: {
+            /**
+             * Responds to a pending MCP dynamic headers refresh request. Hosts that subscribe to `mcp.headers_refresh_required` use this to provide short-lived per-server headers or to indicate that no dynamic headers are available for this refresh.
+             *
+             * @param params MCP headers refresh request id and the host response.
+             *
+             * @returns Indicates whether the pending MCP headers refresh response was accepted.
+             */
+            handlePendingHeadersRefreshRequest: (params: McpHeadersHandlePendingHeadersRefreshRequestRequest) => Promise<McpHeadersHandlePendingHeadersRefreshRequestResult>;
+        };
+        /** @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.
@@ -14524,7 +15152,7 @@ export declare function createSessionRpc(connection: MessageConnection, sessionI
          *
          * @param params Slash command name and optional raw input string to invoke.
          *
-         * @returns Result of invoking the slash command (text output, prompt to send to the agent, or completion).
+         * @returns Result of invoking the slash command (text output, prompt to send to the agent, completion, or subcommand selection).
          */
         invoke: (params: CommandsInvokeRequest) => Promise<SlashCommandInvocationResult>;
         /**
@@ -15043,6 +15671,23 @@ export declare function createSessionRpc(connection: MessageConnection, sessionI
         notifySteerableChanged: (params: RemoteNotifySteerableChangedRequest) => Promise<RemoteNotifySteerableChangedResult>;
     };
     /** @experimental */
+    visibility: {
+        /**
+         * Returns the session's current Mission Control sharing status and shareable GitHub URL. Reflects whether the synced session is visible to repository readers ("repo") or restricted to its creator and collaborators ("unshared").
+         *
+         * @returns Current sharing status and shareable GitHub URL for a session.
+         */
+        get: () => Promise<VisibilityGetResult>;
+        /**
+         * Sets the session's Mission Control sharing status, controlling whether the synced session is visible to repository readers. Returns the effective status and shareable GitHub URL after the change.
+         *
+         * @param params Desired sharing status for the session.
+         *
+         * @returns Effective sharing status and shareable GitHub URL after updating session visibility.
+         */
+        set: (params: VisibilitySetRequest) => Promise<VisibilitySetResult>;
+    };
+    /** @experimental */
     schedule: {
         /**
          * Lists the session's currently active scheduled prompts.