@github/copilot-sdk 1.0.6 → 1.0.7-preview.0

package/dist/cjs/client.js

@@ -1055,7 +1055,8 @@ class CopilotClient {
         gitHubToken: config.gitHubToken,
         remoteSession: config.remoteSession,
         cloud: config.cloud,
-        expAssignments: config.expAssignments
+        expAssignments: config.expAssignments,
+        enableManagedSettings: config.enableManagedSettings
       });
       const {
         sessionId: returnedSessionId,
@@ -1245,7 +1246,8 @@ class CopilotClient {
         gitHubToken: config.gitHubToken,
         remoteSession: config.remoteSession,
         openCanvases: config.openCanvases,
-        expAssignments: config.expAssignments
+        expAssignments: config.expAssignments,
+        enableManagedSettings: config.enableManagedSettings
       });
       const { workspacePath, capabilities, openCanvases } = response;
       session["_workspacePath"] = workspacePath;

package/dist/cjs/generated/rpc.js

@@ -321,6 +321,15 @@ function createServerRpc(connection) {
       getDiscoveryPaths: async (params) => connection.sendRequest("instructions.getDiscoveryPaths", params)
     },
     /** @experimental */
+    commands: {
+      /**
+       * Lists the well-known built-in slash commands that work as the first message in a new session (e.g. /plan, /env), without requiring an active session. Commands that depend on session state, authentication, or a synced session are omitted.
+       *
+       * @returns Slash commands available in the session, after applying any include/exclude filters.
+       */
+      list: async () => connection.sendRequest("commands.list", {})
+    },
+    /** @experimental */
     user: {
       /** @experimental */
       settings: {
@@ -656,6 +665,16 @@ function createSessionRpc(connection, sessionId) {
      * @experimental
      */
     send: async (params) => connection.sendRequest("session.send", { sessionId, ...params }),
+    /**
+     * Sends zero or more user messages to the session in a single turn and returns their message IDs. All provided messages are appended to the conversation in order, then exactly one agent turn runs over the resulting history. When the list is empty, one turn runs over the existing history with no new user message. Remote-backed (Mission Control) sessions do not support this method and will return an error.
+     *
+     * @param params Parameters for sending zero or more user messages to the session in a single turn. Remote-backed (Mission Control) sessions do not support this method and will return an error.
+     *
+     * @returns Result of sending zero or more user messages
+     *
+     * @experimental
+     */
+    sendMessages: async (params) => connection.sendRequest("session.sendMessages", { sessionId, ...params }),
     /**
      * Aborts the current agent turn.
      *
@@ -1153,6 +1172,18 @@ function createSessionRpc(connection, sessionId) {
        * @returns Indicates whether the auto-managed `github` MCP server was removed (false when nothing to remove).
        */
       removeGitHub: async () => connection.sendRequest("session.mcp.removeGitHub", { sessionId }),
+      /**
+       * Starts an individual MCP server on the live session from a caller-supplied config. Session-scoped and ephemeral: the server is added to this session's running set only and is reaped when the session ends. Does NOT modify persistent user configuration (`mcp.config.*`), so it does not affect future sessions. The server surfaces through `session.mcp.list` and the `session.mcp_servers_loaded` / `session.mcp_server_status_changed` events like any other server.
+       *
+       * @param params Server name and configuration for an individual MCP server start.
+       */
+      startServer: async (params) => connection.sendRequest("session.mcp.startServer", { sessionId, ...params }),
+      /**
+       * Restarts an individual MCP server on the live session (stops then starts). Omit `config` for a config-free restart-by-name of an already-configured server; supply `config` to restart with a replacement configuration. Session-scoped and ephemeral: does NOT modify persistent user configuration (`mcp.config.*`).
+       *
+       * @param params Server name and optional replacement configuration for an individual MCP server restart. Omit `config` for a config-free restart-by-name of an already-configured server.
+       */
+      restartServer: async (params) => connection.sendRequest("session.mcp.restartServer", { sessionId, ...params }),
       /**
        * Stops an individual MCP server on the session's host.
        *
@@ -1972,18 +2003,6 @@ function createInternalSessionRpc(connection, sessionId) {
        * @returns Result of configuring GitHub MCP.
        */
       configureGitHub: async (params) => connection.sendRequest("session.mcp.configureGitHub", { sessionId, ...params }),
-      /**
-       * Starts an individual MCP server on the session's host.
-       *
-       * @param params Server name and opaque configuration for an individual MCP server start.
-       */
-      startServer: async (params) => connection.sendRequest("session.mcp.startServer", { sessionId, ...params }),
-      /**
-       * Restarts an individual MCP server on the session's host (stops then starts).
-       *
-       * @param params Server name and opaque configuration for an individual MCP server restart.
-       */
-      restartServer: async (params) => connection.sendRequest("session.mcp.restartServer", { sessionId, ...params }),
       /**
        * Registers a pre-connected external MCP client (e.g. IDE) on the session's host. The caller retains lifecycle ownership of the client and transport. Marked internal because the `client` and `transport` arguments are in-process MCP SDK instances that cannot be serialized across the JSON-RPC boundary; once the CLI moves on top of the SDK, external clients will be expressed as transport configs the runtime can construct itself.
        *

package/dist/client.js

@@ -1042,7 +1042,8 @@ class CopilotClient {
         gitHubToken: config.gitHubToken,
         remoteSession: config.remoteSession,
         cloud: config.cloud,
-        expAssignments: config.expAssignments
+        expAssignments: config.expAssignments,
+        enableManagedSettings: config.enableManagedSettings
       });
       const {
         sessionId: returnedSessionId,
@@ -1232,7 +1233,8 @@ class CopilotClient {
         gitHubToken: config.gitHubToken,
         remoteSession: config.remoteSession,
         openCanvases: config.openCanvases,
-        expAssignments: config.expAssignments
+        expAssignments: config.expAssignments,
+        enableManagedSettings: config.enableManagedSettings
       });
       const { workspacePath, capabilities, openCanvases } = response;
       session["_workspacePath"] = workspacePath;

package/dist/generated/rpc.d.ts

@@ -6491,6 +6491,20 @@ export interface McpRemoveGitHubResult {
      */
     removed: boolean;
 }
+/**
+ * Server name and optional replacement configuration for an individual MCP server restart. Omit `config` for a config-free restart-by-name of an already-configured server.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "McpRestartServerRequest".
+ */
+/** @experimental */
+export interface McpRestartServerRequest {
+    /**
+     * Name of the MCP server to restart
+     */
+    serverName: string;
+    config?: McpServerConfig;
+}
 /**
  * Outcome of an MCP sampling execution: success result, failure error, or cancellation.
  *
@@ -6567,6 +6581,20 @@ export interface McpSetEnvValueModeParams {
 export interface McpSetEnvValueModeResult {
     mode: McpSetEnvValueModeDetails;
 }
+/**
+ * Server name and configuration for an individual MCP server start.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "McpStartServerRequest".
+ */
+/** @experimental */
+export interface McpStartServerRequest {
+    /**
+     * Name of the MCP server to start
+     */
+    serverName: string;
+    config: McpServerConfig;
+}
 /**
  * MCP server startup filtering result.
  *
@@ -10468,6 +10496,81 @@ export interface SendAttachmentsToMessageParams {
      */
     attachments: PushAttachment[];
 }
+/**
+ * A single user message to append to the session as part of a `session.sendMessages` turn
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SendMessageItem".
+ */
+/** @experimental */
+export interface SendMessageItem {
+    /**
+     * The user message text
+     */
+    prompt: string;
+    /**
+     * If provided, this is shown in the timeline instead of `prompt`
+     */
+    displayPrompt?: string;
+    /**
+     * Optional attachments (files, directories, selections, blobs, GitHub references) to include with this message
+     */
+    attachments?: Attachment[];
+    /**
+     * 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;
+}
+/**
+ * Parameters for sending zero or more user messages to the session in a single turn. Remote-backed (Mission Control) sessions do not support this method and will return an error.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SendMessagesRequest".
+ */
+/** @experimental */
+export interface SendMessagesRequest {
+    /**
+     * The user messages to append to the conversation, in order. May be empty, in which case a single turn runs over the existing history with no new user message.
+     */
+    messages: SendMessageItem[];
+    mode?: SendMode;
+    /**
+     * If true, adds the messages to the front of the queue instead of the end
+     */
+    prepend?: boolean;
+    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.
+     */
+    requestHeaders?: {
+        [k: string]: string | undefined;
+    };
+    /**
+     * W3C Trace Context traceparent header for distributed tracing of this agent turn
+     */
+    traceparent?: string;
+    /**
+     * W3C Trace Context tracestate header for distributed tracing
+     */
+    tracestate?: string;
+    /**
+     * If true, await completion of the agentic loop for this turn before returning. Defaults to false (fire-and-forget). When true, the result still contains the same `messageIds`; the caller can rely on the agent having processed the messages before the call resolves.
+     */
+    wait?: boolean;
+}
+/**
+ * Result of sending zero or more user messages
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SendMessagesResult".
+ */
+/** @experimental */
+export interface SendMessagesResult {
+    /**
+     * Unique identifiers assigned to the messages, one per provided message in order. Empty when no messages were provided.
+     */
+    messageIds: string[];
+}
 /**
  * Parameters for sending a user message to the session
  *
@@ -15143,6 +15246,15 @@ export declare function createServerRpc(connection: MessageConnection): {
         getDiscoveryPaths: (params: InstructionsGetDiscoveryPathsRequest) => Promise<InstructionDiscoveryPathList>;
     };
     /** @experimental */
+    commands: {
+        /**
+         * Lists the well-known built-in slash commands that work as the first message in a new session (e.g. /plan, /env), without requiring an active session. Commands that depend on session state, authentication, or a synced session are omitted.
+         *
+         * @returns Slash commands available in the session, after applying any include/exclude filters.
+         */
+        list: () => Promise<CommandList>;
+    };
+    /** @experimental */
     user: {
         /** @experimental */
         settings: {
@@ -15422,6 +15534,16 @@ export declare function createSessionRpc(connection: MessageConnection, sessionI
      * @experimental
      */
     send: (params: SendRequest) => Promise<SendResult>;
+    /**
+     * Sends zero or more user messages to the session in a single turn and returns their message IDs. All provided messages are appended to the conversation in order, then exactly one agent turn runs over the resulting history. When the list is empty, one turn runs over the existing history with no new user message. Remote-backed (Mission Control) sessions do not support this method and will return an error.
+     *
+     * @param params Parameters for sending zero or more user messages to the session in a single turn. Remote-backed (Mission Control) sessions do not support this method and will return an error.
+     *
+     * @returns Result of sending zero or more user messages
+     *
+     * @experimental
+     */
+    sendMessages: (params: SendMessagesRequest) => Promise<SendMessagesResult>;
     /**
      * Aborts the current agent turn.
      *
@@ -15919,6 +16041,18 @@ export declare function createSessionRpc(connection: MessageConnection, sessionI
          * @returns Indicates whether the auto-managed `github` MCP server was removed (false when nothing to remove).
          */
         removeGitHub: () => Promise<McpRemoveGitHubResult>;
+        /**
+         * Starts an individual MCP server on the live session from a caller-supplied config. Session-scoped and ephemeral: the server is added to this session's running set only and is reaped when the session ends. Does NOT modify persistent user configuration (`mcp.config.*`), so it does not affect future sessions. The server surfaces through `session.mcp.list` and the `session.mcp_servers_loaded` / `session.mcp_server_status_changed` events like any other server.
+         *
+         * @param params Server name and configuration for an individual MCP server start.
+         */
+        startServer: (params: McpStartServerRequest) => Promise<void>;
+        /**
+         * Restarts an individual MCP server on the live session (stops then starts). Omit `config` for a config-free restart-by-name of an already-configured server; supply `config` to restart with a replacement configuration. Session-scoped and ephemeral: does NOT modify persistent user configuration (`mcp.config.*`).
+         *
+         * @param params Server name and optional replacement configuration for an individual MCP server restart. Omit `config` for a config-free restart-by-name of an already-configured server.
+         */
+        restartServer: (params: McpRestartServerRequest) => Promise<void>;
         /**
          * Stops an individual MCP server on the session's host.
          *

package/dist/generated/rpc.js

@@ -293,6 +293,15 @@ function createServerRpc(connection) {
       getDiscoveryPaths: async (params) => connection.sendRequest("instructions.getDiscoveryPaths", params)
     },
     /** @experimental */
+    commands: {
+      /**
+       * Lists the well-known built-in slash commands that work as the first message in a new session (e.g. /plan, /env), without requiring an active session. Commands that depend on session state, authentication, or a synced session are omitted.
+       *
+       * @returns Slash commands available in the session, after applying any include/exclude filters.
+       */
+      list: async () => connection.sendRequest("commands.list", {})
+    },
+    /** @experimental */
     user: {
       /** @experimental */
       settings: {
@@ -628,6 +637,16 @@ function createSessionRpc(connection, sessionId) {
      * @experimental
      */
     send: async (params) => connection.sendRequest("session.send", { sessionId, ...params }),
+    /**
+     * Sends zero or more user messages to the session in a single turn and returns their message IDs. All provided messages are appended to the conversation in order, then exactly one agent turn runs over the resulting history. When the list is empty, one turn runs over the existing history with no new user message. Remote-backed (Mission Control) sessions do not support this method and will return an error.
+     *
+     * @param params Parameters for sending zero or more user messages to the session in a single turn. Remote-backed (Mission Control) sessions do not support this method and will return an error.
+     *
+     * @returns Result of sending zero or more user messages
+     *
+     * @experimental
+     */
+    sendMessages: async (params) => connection.sendRequest("session.sendMessages", { sessionId, ...params }),
     /**
      * Aborts the current agent turn.
      *
@@ -1125,6 +1144,18 @@ function createSessionRpc(connection, sessionId) {
        * @returns Indicates whether the auto-managed `github` MCP server was removed (false when nothing to remove).
        */
       removeGitHub: async () => connection.sendRequest("session.mcp.removeGitHub", { sessionId }),
+      /**
+       * Starts an individual MCP server on the live session from a caller-supplied config. Session-scoped and ephemeral: the server is added to this session's running set only and is reaped when the session ends. Does NOT modify persistent user configuration (`mcp.config.*`), so it does not affect future sessions. The server surfaces through `session.mcp.list` and the `session.mcp_servers_loaded` / `session.mcp_server_status_changed` events like any other server.
+       *
+       * @param params Server name and configuration for an individual MCP server start.
+       */
+      startServer: async (params) => connection.sendRequest("session.mcp.startServer", { sessionId, ...params }),
+      /**
+       * Restarts an individual MCP server on the live session (stops then starts). Omit `config` for a config-free restart-by-name of an already-configured server; supply `config` to restart with a replacement configuration. Session-scoped and ephemeral: does NOT modify persistent user configuration (`mcp.config.*`).
+       *
+       * @param params Server name and optional replacement configuration for an individual MCP server restart. Omit `config` for a config-free restart-by-name of an already-configured server.
+       */
+      restartServer: async (params) => connection.sendRequest("session.mcp.restartServer", { sessionId, ...params }),
       /**
        * Stops an individual MCP server on the session's host.
        *
@@ -1944,18 +1975,6 @@ function createInternalSessionRpc(connection, sessionId) {
        * @returns Result of configuring GitHub MCP.
        */
       configureGitHub: async (params) => connection.sendRequest("session.mcp.configureGitHub", { sessionId, ...params }),
-      /**
-       * Starts an individual MCP server on the session's host.
-       *
-       * @param params Server name and opaque configuration for an individual MCP server start.
-       */
-      startServer: async (params) => connection.sendRequest("session.mcp.startServer", { sessionId, ...params }),
-      /**
-       * Restarts an individual MCP server on the session's host (stops then starts).
-       *
-       * @param params Server name and opaque configuration for an individual MCP server restart.
-       */
-      restartServer: async (params) => connection.sendRequest("session.mcp.restartServer", { sessionId, ...params }),
       /**
        * Registers a pre-connected external MCP client (e.g. IDE) on the session's host. The caller retains lifecycle ownership of the client and transport. Marked internal because the `client` and `transport` arguments are in-process MCP SDK instances that cannot be serialized across the JSON-RPC boundary; once the CLI moves on top of the SDK, external clients will be expressed as transport configs the runtime can construct itself.
        *

package/dist/generated/session-events.d.ts

@@ -5,7 +5,7 @@
 /**
  * Union of all session event variants emitted by the Copilot CLI runtime.
  */
-export type SessionEvent = StartEvent | ResumeEvent | RemoteSteerableChangedEvent | ErrorEvent | IdleEvent | TitleChangedEvent | ScheduleCreatedEvent | ScheduleCancelledEvent | ScheduleRearmedEvent | AutopilotObjectiveChangedEvent | InfoEvent | WarningEvent | ModelChangeEvent | ModeChangedEvent | SessionLimitsChangedEvent | PermissionsChangedEvent | PlanChangedEvent | TodosChangedEvent | WorkspaceFileChangedEvent | HandoffEvent | TruncationEvent | SnapshotRewindEvent | ShutdownEvent | UsageCheckpointEvent | ContextChangedEvent | UsageInfoEvent | CompactionStartEvent | CompactionCompleteEvent | TaskCompleteEvent | UserMessageEvent | PendingMessagesModifiedEvent | AssistantTurnStartEvent | AssistantIntentEvent | AssistantReasoningEvent | AssistantReasoningDeltaEvent | AssistantToolCallDeltaEvent | AssistantStreamingDeltaEvent | AssistantMessageEvent | AssistantMessageStartEvent | AssistantMessageDeltaEvent | AssistantTurnEndEvent | AssistantIdleEvent | AssistantUsageEvent | ModelCallFailureEvent | AbortEvent | ToolUserRequestedEvent | ToolExecutionStartEvent | ToolExecutionPartialResultEvent | ToolExecutionProgressEvent | ToolExecutionCompleteEvent | SkillInvokedEvent | SubagentStartedEvent | SubagentCompletedEvent | SubagentFailedEvent | SubagentSelectedEvent | SubagentDeselectedEvent | HookStartEvent | HookEndEvent | HookProgressEvent | BinaryAssetEvent | SystemMessageEvent | SystemNotificationEvent | PermissionRequestedEvent | PermissionCompletedEvent | UserInputRequestedEvent | UserInputCompletedEvent | ElicitationRequestedEvent | ElicitationCompletedEvent | SamplingRequestedEvent | SamplingCompletedEvent | McpOauthRequiredEvent | McpOauthCompletedEvent | McpHeadersRefreshRequiredEvent | McpHeadersRefreshCompletedEvent | CustomNotificationEvent | ExternalToolRequestedEvent | ExternalToolCompletedEvent | CommandQueuedEvent | CommandExecuteEvent | CommandCompletedEvent | AutoModeSwitchRequestedEvent | AutoModeSwitchCompletedEvent | SessionLimitsExhaustedRequestedEvent | SessionLimitsExhaustedCompletedEvent | CommandsChangedEvent | CapabilitiesChangedEvent | ExitPlanModeRequestedEvent | ExitPlanModeCompletedEvent | ToolsUpdatedEvent | BackgroundTasksChangedEvent | SkillsLoadedEvent | CustomAgentsUpdatedEvent | McpServersLoadedEvent | McpServerStatusChangedEvent | ExtensionsLoadedEvent | CanvasOpenedEvent | CanvasRegistryChangedEvent | CanvasClosedEvent | CanvasUnavailableEvent | CanvasRecordedEvent | CanvasRemovedEvent | ExtensionsAttachmentsPushedEvent | McpAppToolCallCompleteEvent;
+export type SessionEvent = StartEvent | ResumeEvent | RemoteSteerableChangedEvent | ErrorEvent | IdleEvent | TitleChangedEvent | ScheduleCreatedEvent | ScheduleCancelledEvent | ScheduleRearmedEvent | AutopilotObjectiveChangedEvent | InfoEvent | WarningEvent | ModelChangeEvent | ModeChangedEvent | SessionLimitsChangedEvent | PermissionsChangedEvent | PlanChangedEvent | TodosChangedEvent | WorkspaceFileChangedEvent | HandoffEvent | TruncationEvent | SnapshotRewindEvent | ShutdownEvent | UsageCheckpointEvent | ContextChangedEvent | UsageInfoEvent | CompactionStartEvent | CompactionCompleteEvent | TaskCompleteEvent | UserMessageEvent | PendingMessagesModifiedEvent | AssistantTurnStartEvent | AssistantIntentEvent | AssistantReasoningEvent | AssistantReasoningDeltaEvent | AssistantToolCallDeltaEvent | AssistantStreamingDeltaEvent | AssistantMessageEvent | AssistantMessageStartEvent | AssistantMessageDeltaEvent | AssistantTurnEndEvent | AssistantIdleEvent | AssistantUsageEvent | ModelCallFailureEvent | AbortEvent | ToolUserRequestedEvent | ToolExecutionStartEvent | ToolExecutionPartialResultEvent | ToolExecutionProgressEvent | ToolExecutionCompleteEvent | SkillInvokedEvent | SubagentStartedEvent | SubagentCompletedEvent | SubagentFailedEvent | SubagentSelectedEvent | SubagentDeselectedEvent | HookStartEvent | HookEndEvent | HookProgressEvent | BinaryAssetEvent | SystemMessageEvent | SystemNotificationEvent | PermissionRequestedEvent | PermissionCompletedEvent | UserInputRequestedEvent | UserInputCompletedEvent | ElicitationRequestedEvent | ElicitationCompletedEvent | SamplingRequestedEvent | SamplingCompletedEvent | McpOauthRequiredEvent | McpOauthCompletedEvent | McpHeadersRefreshRequiredEvent | McpHeadersRefreshCompletedEvent | CustomNotificationEvent | ExternalToolRequestedEvent | ExternalToolCompletedEvent | CommandQueuedEvent | CommandExecuteEvent | CommandCompletedEvent | AutoModeSwitchRequestedEvent | AutoModeSwitchCompletedEvent | SessionLimitsExhaustedRequestedEvent | SessionLimitsExhaustedCompletedEvent | AutoModeResolvedEvent | CommandsChangedEvent | CapabilitiesChangedEvent | ExitPlanModeRequestedEvent | ExitPlanModeCompletedEvent | ToolsUpdatedEvent | BackgroundTasksChangedEvent | SkillsLoadedEvent | CustomAgentsUpdatedEvent | McpServersLoadedEvent | McpServerStatusChangedEvent | ExtensionsLoadedEvent | CanvasOpenedEvent | CanvasRegistryChangedEvent | CanvasClosedEvent | CanvasUnavailableEvent | CanvasRecordedEvent | CanvasRemovedEvent | ExtensionsAttachmentsPushedEvent | McpAppToolCallCompleteEvent;
 /**
  * Hosting platform type of the repository (github or ado)
  */
@@ -461,6 +461,16 @@ export type SessionLimitsExhaustedResponseAction =
  | "unset"
 /** Leave the limit unchanged and cancel the blocked model request. */
  | "cancel";
+/**
+ * Coarse request-difficulty bucket for UX explainability
+ */
+export type AutoModeResolvedReasoningBucket = 
+/** The request looks low-reasoning; a lighter model is appropriate. */
+"low"
+/** The request needs a moderate amount of reasoning. */
+ | "medium"
+/** The request looks high-reasoning; a stronger model is appropriate. */
+ | "high";
 /**
  * Exit plan mode action
  */
@@ -3150,6 +3160,10 @@ export interface AssistantMessageData {
      * @experimental
      */
     citations?: Citations;
+    /**
+     * Client-minted request id (x-request-id header) echoed by the server. Distinct from requestId (x-github-request-id) and serviceRequestId (x-copilot-service-request-id).
+     */
+    clientRequestId?: string;
     /**
      * The assistant's text response content
      */
@@ -7497,6 +7511,66 @@ export interface SessionLimitsExhaustedResponse {
      */
     maxAiCredits?: number;
 }
+/**
+ * Session event "session.auto_mode_resolved". Auto Intent resolution: the concrete model the session settled on for the first prompt of an auto-mode session, and why. Lets SDK clients render the chosen model and the full reason it was picked. The core selection fields (chosenModel/reasoningBucket/categoryScores) are stable; the routing-analytics fields (predictedLabel/confidence/candidateModels) mirror the upstream intent service and may evolve, hence the event's experimental stability.
+ */
+/** @experimental */
+export interface AutoModeResolvedEvent {
+    /**
+     * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
+     */
+    agentId?: string;
+    data: AutoModeResolvedData;
+    /**
+     * When true, the event is transient and not persisted to the session event log on disk
+     */
+    ephemeral?: boolean;
+    /**
+     * Unique event identifier (UUID v4), generated when the event is emitted
+     */
+    id: string;
+    /**
+     * ID of the chronologically preceding event in the session, forming a linked chain. Null for the first event.
+     */
+    parentId: string | null;
+    /**
+     * ISO 8601 timestamp when the event was created
+     */
+    timestamp: string;
+    /**
+     * Type discriminator. Always "session.auto_mode_resolved".
+     */
+    type: "session.auto_mode_resolved";
+}
+/**
+ * Auto Intent resolution: the concrete model the session settled on for the first prompt of an auto-mode session, and why. Lets SDK clients render the chosen model and the full reason it was picked. The core selection fields (chosenModel/reasoningBucket/categoryScores) are stable; the routing-analytics fields (predictedLabel/confidence/candidateModels) mirror the upstream intent service and may evolve, hence the event's experimental stability.
+ */
+/** @experimental */
+export interface AutoModeResolvedData {
+    /**
+     * Ordered candidate model list the router returned, when not a fallback
+     */
+    candidateModels?: string[];
+    /**
+     * Per-category classifier scores (0-1) behind the bucket: the granular HYDRA capability scores (reasoning, code_gen, debugging, tool_use), or the binary needs_reasoning/no_reasoning scores when HYDRA didn't run. Lets clients show a breakdown rather than just the bucket.
+     */
+    categoryScores?: {
+        [k: string]: number | undefined;
+    };
+    /**
+     * The concrete model the session will use after any intent refinement
+     */
+    chosenModel: string;
+    /**
+     * Classifier confidence for the predicted label, when available
+     */
+    confidence?: number;
+    /**
+     * The predicted classifier label (e.g. `needs_reasoning`), when available
+     */
+    predictedLabel?: string;
+    reasoningBucket?: AutoModeResolvedReasoningBucket;
+}
 /**
  * Session event "commands.changed". SDK command registration change notification
  */

package/dist/types.d.ts

@@ -1782,6 +1782,13 @@ export interface SessionConfigBase {
      * the identity used for content exclusion, model routing, and quota checks.
      */
     gitHubToken?: string;
+    /**
+     * Opt-in: when true, the runtime self-fetches enterprise managed settings
+     * (bypass-permissions policy) at session bootstrap using the session's
+     * `gitHubToken`. Requires {@link SessionConfigBase.gitHubToken} to be set;
+     * if omitted, the runtime is expected to reject session creation (fail-closed).
+     */
+    enableManagedSettings?: boolean;
     /**
      * When true, skips embedding-based retrieval for this session.
      * Use in multitenant deployments to prevent cross-session information leakage

package/package.json

@@ -4,7 +4,7 @@
     "type": "git",
     "url": "https://github.com/github/copilot-sdk.git"
   },
-  "version": "1.0.6",
+  "version": "1.0.7-preview.0",
   "description": "TypeScript SDK for programmatic control of GitHub Copilot CLI via JSON-RPC",
   "main": "./dist/cjs/index.js",
   "types": "./dist/index.d.ts",
@@ -56,7 +56,7 @@
   "author": "GitHub",
   "license": "MIT",
   "dependencies": {
-    "@github/copilot": "^1.0.69",
+    "@github/copilot": "^1.0.70-0",
     "vscode-jsonrpc": "^8.2.1",
     "zod": "^4.3.6"
   },