@github/copilot-sdk-win32-x64 1.0.17-preview.0 → 1.0.17-preview.1

package/copilot-sdk/generated/rpc.d.ts

@@ -3289,6 +3289,18 @@ export type McpServerCardEmbeddedKind = "embedded";
  */
 /** @experimental */
 export type McpPlanInstallResult = McpPlanInstallPlanned | CatalogNegotiationRefusedError | CatalogHandleRejectedError | CatalogInvalidRequestError | CatalogAuthenticationRequiredError | CatalogPolicyRejectedError | CatalogNetworkFailureError | CatalogUnsafeRetrievalError | CatalogMalformedCardError | CatalogContractViolationError | CatalogUnavailableTransportError | CatalogNotInstallableError | CatalogUnavailableError;
+/**
+ * The sender role of an MCP prompt message.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "McpPromptRole".
+ */
+/** @experimental */
+export type McpPromptRole = 
+/** A message from the user. */
+"user"
+/** A message from the assistant. */
+ | "assistant";
 /**
  * MCP server configuration (stdio, remote HTTP/SSE, or in-process)
  *
@@ -14475,6 +14487,23 @@ export interface McpOauthCancelLoginResult {
      */
     cancelled: boolean;
 }
+/**
+ * Host-delivered callback for a runtime-managed MCP OAuth login.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "McpOauthCompleteRequest".
+ */
+/** @experimental */
+export interface McpOauthCompleteRequest {
+    /**
+     * Opaque identifier returned by session.mcp.oauth.login for the pending external callback.
+     */
+    authorizationId: string;
+    /**
+     * Full externally visible HTTPS callback URL received by the host, including the authorization response query parameters. Applications behind a reverse proxy must reconstruct the public URL rather than passing an internal proxy URL.
+     */
+    callbackUrl: string;
+}
 /**
  * Pending MCP OAuth request ID and host-provided token or cancellation response.
  *
@@ -14503,7 +14532,7 @@ export interface McpOauthHandlePendingResult {
     success: boolean;
 }
 /**
- * Remote MCP server name and optional overrides controlling reauthentication, OAuth client display name, callback success-page copy, and static OAuth client selection.
+ * Remote MCP server name and optional overrides controlling reauthentication, OAuth client display name, callback handling, and static OAuth client selection.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "McpOauthLoginRequest".
@@ -14539,6 +14568,10 @@ export interface McpOauthLoginRequest {
      */
     publicClient?: boolean;
     grantType?: McpOauthLoginGrantType;
+    /**
+     * Optional externally visible HTTPS redirect URI for a host-managed callback endpoint. When supplied, the runtime still owns discovery, PKCE, token exchange, persistence, and reconnect, but does not bind a loopback listener or terminate HTTPS. The URI must not contain query parameters or a fragment and must be registered for the selected CIMD, DCR, or static OAuth client.
+     */
+    redirectUri?: string;
     /**
      * Required for owned login. Consumes the exact prepareLogin handle once.
      * Set forceReauth and display options during preparation, not consumption.
@@ -14563,9 +14596,13 @@ export interface McpOauthLoginResult {
     loginId?: string;
     status?: McpOwnedOauthLoginStatus;
     /**
-     * URL the caller should open in a browser to complete OAuth. Omitted when cached tokens were still valid and no browser interaction was needed — the server is already reconnected in that case. When present, the runtime starts the callback listener before returning and continues the flow in the background; completion is signaled via session.mcp_server_status_changed.
+     * URL the caller should open in a browser to complete OAuth. Omitted when cached tokens were still valid and no browser interaction was needed — the server is already reconnected in that case. For the default loopback flow, the runtime starts its listener before returning. With redirectUri, the host receives the callback and completes it through session.mcp.oauth.complete. The runtime continues the flow in the background and signals completion via session.mcp_server_status_changed.
      */
     authorizationUrl?: string;
+    /**
+     * Opaque authorization identifier returned only for a host-managed redirect URI. The runtime also sends it as the OAuth state value, so the callback endpoint can read state and pass it with the full callback URL to session.mcp.oauth.complete.
+     */
+    authorizationId?: string;
 }
 /**
  * Effect-free preparation bound to the existing local session, requester and installation, with frozen options.
@@ -14798,6 +14835,235 @@ export interface McpPrepareInstallRequest {
     source: McpServerCardReference;
     secretStorage: McpInstallationSecretStorage;
 }
+/**
+ * An MCP prompt descriptor. Server-provided non-standard fields are exposed under `additionalProperties`.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "McpPrompt".
+ */
+/** @experimental */
+export interface McpPrompt {
+    /**
+     * The programmatic name of the prompt
+     */
+    name: string;
+    /**
+     * Human-readable display title
+     */
+    title?: string;
+    /**
+     * Description of what this prompt provides
+     */
+    description?: string;
+    /**
+     * Arguments accepted by the prompt
+     */
+    arguments?: McpPromptArgument[];
+    /**
+     * Icons associated with this prompt
+     */
+    icons?: McpPromptIcon[];
+    /**
+     * Prompt-level metadata
+     */
+    _meta?: {
+        [k: string]: JsonValue | undefined;
+    };
+    /**
+     * Server-provided non-standard descriptor fields
+     */
+    additionalProperties?: {
+        [k: string]: JsonValue | undefined;
+    };
+}
+/**
+ * An argument accepted by an MCP prompt.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "McpPromptArgument".
+ */
+/** @experimental */
+export interface McpPromptArgument {
+    /**
+     * Name of the argument
+     */
+    name: string;
+    /**
+     * Description of the argument
+     */
+    description?: string;
+    /**
+     * Whether the argument is required; omission is distinct from false
+     */
+    required?: boolean;
+    /**
+     * Argument-level metadata
+     */
+    _meta?: {
+        [k: string]: JsonValue | undefined;
+    };
+    /**
+     * Server-provided non-standard argument fields
+     */
+    additionalProperties?: {
+        [k: string]: JsonValue | undefined;
+    };
+}
+/**
+ * An MCP prompt icon with standard size hints and preserved non-standard fields.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "McpPromptIcon".
+ */
+/** @experimental */
+export interface McpPromptIcon {
+    /**
+     * Icon URI
+     */
+    src: string;
+    /**
+     * Icon MIME type, when known
+     */
+    mimeType?: string;
+    /**
+     * Icon sizes, such as `48x48` or `any`
+     */
+    sizes?: string[];
+    /**
+     * Theme hint for this icon
+     */
+    theme?: string;
+    /**
+     * Server-provided non-standard icon fields
+     */
+    additionalProperties?: {
+        [k: string]: JsonValue | undefined;
+    };
+}
+/**
+ * An MCP prompt message with opaque JSON content preserved without flattening or content-type filtering.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "McpPromptMessage".
+ */
+/** @experimental */
+export interface McpPromptMessage {
+    role: McpPromptRole;
+    /**
+     * The original MCP content block, including nested metadata and unfamiliar content types
+     */
+    content: JsonValue;
+    /**
+     * Message-level metadata
+     */
+    _meta?: {
+        [k: string]: JsonValue | undefined;
+    };
+    /**
+     * Server-provided non-standard message fields
+     */
+    additionalProperties?: {
+        [k: string]: JsonValue | undefined;
+    };
+}
+/**
+ * MCP server, prompt name, and optional string-valued arguments.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "McpPromptsGetRequest".
+ */
+/** @experimental */
+export interface McpPromptsGetRequest {
+    /**
+     * Name of the MCP server hosting the prompt
+     */
+    serverName: string;
+    /**
+     * The programmatic name of the prompt
+     */
+    promptName: string;
+    /**
+     * String-valued arguments to pass to the prompt
+     */
+    arguments?: {
+        [k: string]: string | undefined;
+    };
+}
+/**
+ * Prompt messages returned by the MCP server without sending them to the model.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "McpPromptsGetResult".
+ */
+/** @experimental */
+export interface McpPromptsGetResult {
+    /**
+     * Description of the prompt
+     */
+    description?: string;
+    /**
+     * Ordered prompt messages
+     */
+    messages: McpPromptMessage[];
+    /**
+     * MCP result metadata
+     */
+    _meta?: {
+        [k: string]: JsonValue | undefined;
+    };
+    /**
+     * Server-provided non-standard result fields
+     */
+    additionalProperties?: {
+        [k: string]: JsonValue | undefined;
+    };
+}
+/**
+ * MCP server whose prompts to enumerate.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "McpPromptsListRequest".
+ */
+/** @experimental */
+export interface McpPromptsListRequest {
+    /**
+     * Name of the MCP server whose prompts to enumerate
+     */
+    serverName: string;
+    /**
+     * Opaque MCP pagination cursor from a prior `nextCursor` value
+     */
+    cursor?: string;
+}
+/**
+ * One page of prompts advertised by the named MCP server.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "McpPromptsListResult".
+ */
+/** @experimental */
+export interface McpPromptsListResult {
+    /**
+     * Prompts advertised by the server
+     */
+    prompts: McpPrompt[];
+    /**
+     * Opaque cursor for the next page, if the server has more prompts
+     */
+    nextCursor?: string;
+    /**
+     * MCP result metadata
+     */
+    _meta?: {
+        [k: string]: JsonValue | undefined;
+    };
+    /**
+     * Server-provided non-standard result fields
+     */
+    additionalProperties?: {
+        [k: string]: JsonValue | undefined;
+    };
+}
 /**
  * Indicates whether the auto-managed `github` MCP server was removed (false when nothing to remove).
  *
@@ -23932,7 +24198,7 @@ export interface ShellCancelUserRequestedRequest {
     requestId: string;
 }
 /**
- * Shell command to run, with optional working directory and timeout in milliseconds.
+ * Shell command to run, with optional working directory and timeout in milliseconds. Spawn failures return an RPC error.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "ShellExecRequest".
@@ -23953,7 +24219,7 @@ export interface ShellExecRequest {
     timeout?: number;
 }
 /**
- * Identifier of the spawned process, used to correlate streamed output and exit notifications.
+ * Identifier of the spawned shell process, usable with shell.kill while the process is running.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "ShellExecResult".
@@ -23961,7 +24227,7 @@ export interface ShellExecRequest {
 /** @experimental */
 export interface ShellExecResult {
     /**
-     * Unique identifier for tracking streamed output
+     * Identifier usable with shell.kill while the process is running
      */
     processId: string;
 }
@@ -30579,11 +30845,17 @@ export declare function createSessionRpc(connection: MessageConnection, sessionI
             /**
              * Starts OAuth authentication for a remote MCP server. Owned servers require the original one-use prepareLogin handle and exact installation ID; manual servers retain the existing direct login behaviour.
              *
-             * @param params Remote MCP server name and optional overrides controlling reauthentication, OAuth client display name, callback success-page copy, and static OAuth client selection.
+             * @param params Remote MCP server name and optional overrides controlling reauthentication, OAuth client display name, callback handling, and static OAuth client selection.
              *
              * @returns OAuth authorization URL the caller should open, or empty when cached tokens already authenticated the server.
              */
             login: (params: McpOauthLoginRequest) => Promise<McpOauthLoginResult>;
+            /**
+             * Completes a runtime-managed MCP OAuth login after the authorization server redirects to a host-managed callback URL.
+             *
+             * @param params Host-delivered callback for a runtime-managed MCP OAuth login.
+             */
+            complete: (params: McpOauthCompleteRequest) => Promise<void>;
             /**
              * Passively probes a configured remote MCP server to classify whether OAuth is required or a cached/override token is accepted. Does not start OAuth, emit pending OAuth requests, or mutate MCP connection state.
              *
@@ -30694,6 +30966,25 @@ export declare function createSessionRpc(connection: MessageConnection, sessionI
              */
             listTemplates: (params: McpResourcesListTemplatesRequest) => Promise<McpResourcesListTemplatesResult>;
         };
+        /** @experimental */
+        prompts: {
+            /**
+             * Enumerate one page of prompts a connected MCP server exposes (proxies MCP `prompts/list`). Pass `cursor` to continue from a prior result's `nextCursor`.
+             *
+             * @param params MCP server whose prompts to enumerate.
+             *
+             * @returns One page of prompts advertised by the named MCP server.
+             */
+            list: (params: McpPromptsListRequest) => Promise<McpPromptsListResult>;
+            /**
+             * Get a prompt's messages from a connected MCP server (proxies MCP `prompts/get`). Content is preserved as opaque JSON. Does not send messages to the model, execute tools, or fetch referenced resources.
+             *
+             * @param params MCP server, prompt name, and optional string-valued arguments.
+             *
+             * @returns Prompt messages returned by the MCP server without sending them to the model.
+             */
+            get: (params: McpPromptsGetRequest) => Promise<McpPromptsGetResult>;
+        };
     };
     /** @experimental */
     diagnostics: {
@@ -31468,11 +31759,11 @@ export declare function createSessionRpc(connection: MessageConnection, sessionI
     /** @experimental */
     shell: {
         /**
-         * Starts a shell command and streams output through session notifications. The command runs as the leader of its own process group (POSIX) or in a dedicated job object (Windows), so a forced termination — via "shell.kill", the request timeout, or session disposal — signals that whole group/job rather than only the direct child. Two gaps are worth planning for: a command that exits on its own does not trigger that teardown, and on POSIX a descendant that moves itself into a new session or process group (for example via "setsid") leaves the signalled group, so either can leave a background process running.
+         * Starts a shell command, returning an RPC error if it cannot be spawned. The command runs as the leader of its own process group (POSIX) or in a dedicated job object (Windows), so a forced termination — via "shell.kill", the request timeout, or session disposal — signals that whole group/job rather than only the direct child. Two gaps are worth planning for: a command that exits on its own does not trigger that teardown, and on POSIX a descendant that moves itself into a new session or process group (for example via "setsid") leaves the signalled group, so either can leave a background process running.
          *
-         * @param params Shell command to run, with optional working directory and timeout in milliseconds.
+         * @param params Shell command to run, with optional working directory and timeout in milliseconds. Spawn failures return an RPC error.
          *
-         * @returns Identifier of the spawned process, used to correlate streamed output and exit notifications.
+         * @returns Identifier of the spawned shell process, usable with shell.kill while the process is running.
          */
         exec: (params: ShellExecRequest) => Promise<ShellExecResult>;
         /**

package/copilot-sdk/generated/session-events.d.ts

@@ -6477,6 +6477,12 @@ export interface ToolExecutionProgressData {
      * Human-readable progress status message (e.g., from an MCP server)
      */
     progressMessage: string;
+    /**
+     * Client-only structured progress metadata. Not model-facing tool output.
+     *
+     * @experimental
+     */
+    structuredContent?: JsonValue;
     /**
      * Tool call ID this progress notification belongs to
      */
@@ -11306,6 +11312,10 @@ export interface AutoModeResolvedData {
      * The routing method the server applied, when Auto Intent ran
      */
     routingMethod?: string;
+    /**
+     * Short human-readable sentence from the routing service explaining why this model was chosen, for display alongside the model. Present only when the service supplied one: it is omitted for on-device selections, when the service did not provide an explanation, and when a replayed decision made no routing call. The text is display-only and drawn from a fixed catalogue; several distinct routing categories share identical wording, so it cannot be used to recover the category or keyed on programmatically.
+     */
+    selectionReason?: string;
     /**
      * Whether a sticky model choice overrode the router result
      */