@github/copilot-sdk 1.0.5-preview.1 → 1.0.6-preview.0

package/dist/cjs/client.js

@@ -280,7 +280,8 @@ class CopilotClient {
   /** Connection-level session filesystem config, set via constructor option. */
   sessionFsConfig = null;
   requestHandler = null;
-  llmInferenceHandlers = {};
+  onGitHubTelemetry;
+  clientGlobalHandlers = {};
   /**
    * Typed server-scoped RPC methods.
    * @throws Error if the client is not connected
@@ -381,7 +382,8 @@ class CopilotClient {
     this.onGetTraceContext = options.onGetTraceContext;
     this.sessionFsConfig = options.sessionFs ?? null;
     this.requestHandler = options.requestHandler ?? null;
-    this.setupLlmInference();
+    this.onGitHubTelemetry = options.onGitHubTelemetry;
+    this.setupClientGlobalHandlers();
     const effectiveEnv = options.env ?? process.env;
     this.resolvedEnv = effectiveEnv;
     this.resolvedCliPath = conn.kind === "stdio" || conn.kind === "tcp" ? conn.path ?? effectiveEnv.COPILOT_CLI_PATH ?? getBundledCliPath() : void 0;
@@ -461,19 +463,29 @@ class CopilotClient {
     }
     session.clientSessionApis.sessionFs = (0, import_sessionFsProvider.createSessionFsAdapter)(provider);
   }
-  setupLlmInference() {
-    if (!this.requestHandler) {
-      return;
-    }
-    this.llmInferenceHandlers = {
-      llmInference: (0, import_copilotRequestHandler.createCopilotRequestAdapter)(this.requestHandler, () => {
+  setupClientGlobalHandlers() {
+    const handlers = {};
+    if (this.requestHandler) {
+      handlers.llmInference = (0, import_copilotRequestHandler.createCopilotRequestAdapter)(this.requestHandler, () => {
         if (!this.connection) {
           return void 0;
         }
         this._rpc ??= (0, import_rpc.createServerRpc)(this.connection);
         return this._rpc;
-      })
-    };
+      });
+    }
+    if (this.onGitHubTelemetry) {
+      const onGitHubTelemetry = this.onGitHubTelemetry;
+      handlers.gitHubTelemetry = {
+        event: async (notification) => {
+          try {
+            await onGitHubTelemetry(notification);
+          } catch {
+          }
+        }
+      };
+    }
+    this.clientGlobalHandlers = handlers;
   }
   /**
    * Starts the CLI server and establishes a connection.
@@ -997,11 +1009,14 @@ class CopilotClient {
         availableTools: toolFilterOptions.availableTools,
         excludedTools: toolFilterOptions.excludedTools,
         toolFilterPrecedence: toolFilterOptions.toolFilterPrecedence,
+        excludedBuiltinAgents: config.excludedBuiltinAgents,
         provider: bearerWireProvider,
         capi: config.capi,
         providers: bearerWireProviders,
         models: config.models,
         enableSessionTelemetry: config.enableSessionTelemetry,
+        enableCitations: config.enableCitations,
+        sessionLimits: config.sessionLimits,
         modelCapabilities: config.modelCapabilities,
         largeOutput: toWireLargeOutput(config.largeOutput),
         requestPermission: !!config.onPermissionRequest,
@@ -1014,6 +1029,7 @@ class CopilotClient {
         workingDirectory: config.workingDirectory,
         streaming: config.streaming,
         includeSubAgentStreamingEvents: config.includeSubAgentStreamingEvents ?? true,
+        ...this.onGitHubTelemetry != null ? { enableGitHubTelemetryForwarding: true } : {},
         mcpServers: toWireMcpServers(config.mcpServers),
         mcpOAuthTokenStorage: config.mcpOAuthTokenStorage,
         envValueMode: "direct",
@@ -1150,12 +1166,6 @@ class CopilotClient {
     }
     this.sessions.set(sessionId, session);
     this.setupSessionFs(session, config);
-    if (config.onMcpAuthRequest) {
-      await this.connection.sendRequest("session.eventLog.registerInterest", {
-        sessionId,
-        eventType: "mcp.oauth_required"
-      });
-    }
     const toolFilterOptions = this.resolveToolFilterOptions(config);
     try {
       const response = await this.connection.sendRequest("session.resume", {
@@ -1171,6 +1181,9 @@ class CopilotClient {
         excludedTools: toolFilterOptions.excludedTools,
         toolFilterPrecedence: toolFilterOptions.toolFilterPrecedence,
         enableSessionTelemetry: config.enableSessionTelemetry,
+        excludedBuiltinAgents: config.excludedBuiltinAgents,
+        enableCitations: config.enableCitations,
+        sessionLimits: config.sessionLimits,
         tools: config.tools?.map((tool) => ({
           name: tool.name,
           description: tool.description,
@@ -1214,6 +1227,7 @@ class CopilotClient {
         enableSkills: config.enableSkills,
         streaming: config.streaming,
         includeSubAgentStreamingEvents: config.includeSubAgentStreamingEvents ?? true,
+        ...this.onGitHubTelemetry != null ? { enableGitHubTelemetryForwarding: true } : {},
         mcpServers: toWireMcpServers(config.mcpServers),
         mcpOAuthTokenStorage: config.mcpOAuthTokenStorage,
         envValueMode: "direct",
@@ -1237,6 +1251,12 @@ class CopilotClient {
       session["_workspacePath"] = workspacePath;
       session.setCapabilities(capabilities);
       session.setOpenCanvases(openCanvases ?? []);
+      if (config.onMcpAuthRequest) {
+        await this.connection.sendRequest("session.eventLog.registerInterest", {
+          sessionId,
+          eventType: "mcp.oauth_required"
+        });
+      }
       await this.updateSessionOptionsForMode(session, config);
     } catch (e) {
       this.sessions.delete(sessionId);
@@ -1873,7 +1893,7 @@ stderr: ${stderrOutput}`
       if (!session) throw new Error(`No session found for sessionId: ${sessionId}`);
       return session.clientSessionApis;
     });
-    (0, import_rpc.registerClientGlobalApiHandlers)(this.connection, this.llmInferenceHandlers);
+    (0, import_rpc.registerClientGlobalApiHandlers)(this.connection, this.clientGlobalHandlers);
     this.connection.onClose(() => {
       this.state = "disconnected";
     });

package/dist/cjs/generated/rpc.js

@@ -901,6 +901,23 @@ function createSessionRpc(connection, sessionId) {
       diff: async (params) => connection.sendRequest("session.workspaces.diff", { sessionId, ...params })
     },
     /** @experimental */
+    completions: {
+      /**
+       * Gets the characters that should trigger host-driven completions for the session. Empty disables host-driven completions (e.g. local sessions, or a relay host that does not advertise them).
+       *
+       * @returns Characters that, when typed in the composer, should trigger a `completions.request`. Empty when the session has no host-driven completions (e.g. local sessions, or a relay host that does not advertise `completionTriggerCharacters`).
+       */
+      getTriggerCharacters: async () => connection.sendRequest("session.completions.getTriggerCharacters", { sessionId }),
+      /**
+       * Requests host-driven completion items for the current composer input. Returns an empty list when the host has no items or does not support completions.
+       *
+       * @param params Request host-driven completions for the current composer input.
+       *
+       * @returns Host-driven completion items for the current composer input. Empty when the host returns no items or does not support completions.
+       */
+      request: async (params) => connection.sendRequest("session.completions.request", { sessionId, ...params })
+    },
+    /** @experimental */
     instructions: {
       /**
        * Gets instruction sources loaded for the session.
@@ -1457,6 +1474,14 @@ function createSessionRpc(connection, sessionId) {
        * @returns Indicates whether the pending UI request was resolved by this call.
        */
       handlePendingAutoModeSwitch: async (params) => connection.sendRequest("session.ui.handlePendingAutoModeSwitch", { sessionId, ...params }),
+      /**
+       * Resolves a pending `session_limits_exhausted.requested` event with the user's selected limit action.
+       *
+       * @param params Request ID of a pending `session_limits_exhausted.requested` event and the user's selected limit action.
+       *
+       * @returns Indicates whether the pending UI request was resolved by this call.
+       */
+      handlePendingSessionLimitsExhausted: async (params) => connection.sendRequest("session.ui.handlePendingSessionLimitsExhausted", { sessionId, ...params }),
       /**
        * Resolves a pending `exit_plan_mode.requested` event with the user's response.
        *
@@ -2061,6 +2086,11 @@ function registerClientGlobalApiHandlers(connection, handlers) {
     if (!handler) throw new Error("No llmInference client-global handler registered");
     return handler.httpRequestChunk(params);
   });
+  connection.onNotification("gitHubTelemetry.event", async (params) => {
+    const handler = handlers.gitHubTelemetry;
+    if (!handler) return;
+    await handler.event(params);
+  });
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/client.d.ts

@@ -36,7 +36,8 @@ export declare class CopilotClient {
     /** Connection-level session filesystem config, set via constructor option. */
     private sessionFsConfig;
     private requestHandler;
-    private llmInferenceHandlers;
+    private onGitHubTelemetry?;
+    private clientGlobalHandlers;
     /**
      * Typed server-scoped RPC methods.
      * @throws Error if the client is not connected
@@ -80,7 +81,7 @@ export declare class CopilotClient {
     private parseCliUrl;
     private validateSessionFsConfig;
     private setupSessionFs;
-    private setupLlmInference;
+    private setupClientGlobalHandlers;
     /**
      * Starts the CLI server and establishes a connection.
      *

package/dist/client.js

@@ -267,7 +267,8 @@ class CopilotClient {
   /** Connection-level session filesystem config, set via constructor option. */
   sessionFsConfig = null;
   requestHandler = null;
-  llmInferenceHandlers = {};
+  onGitHubTelemetry;
+  clientGlobalHandlers = {};
   /**
    * Typed server-scoped RPC methods.
    * @throws Error if the client is not connected
@@ -368,7 +369,8 @@ class CopilotClient {
     this.onGetTraceContext = options.onGetTraceContext;
     this.sessionFsConfig = options.sessionFs ?? null;
     this.requestHandler = options.requestHandler ?? null;
-    this.setupLlmInference();
+    this.onGitHubTelemetry = options.onGitHubTelemetry;
+    this.setupClientGlobalHandlers();
     const effectiveEnv = options.env ?? process.env;
     this.resolvedEnv = effectiveEnv;
     this.resolvedCliPath = conn.kind === "stdio" || conn.kind === "tcp" ? conn.path ?? effectiveEnv.COPILOT_CLI_PATH ?? getBundledCliPath() : void 0;
@@ -448,19 +450,29 @@ class CopilotClient {
     }
     session.clientSessionApis.sessionFs = createSessionFsAdapter(provider);
   }
-  setupLlmInference() {
-    if (!this.requestHandler) {
-      return;
-    }
-    this.llmInferenceHandlers = {
-      llmInference: createCopilotRequestAdapter(this.requestHandler, () => {
+  setupClientGlobalHandlers() {
+    const handlers = {};
+    if (this.requestHandler) {
+      handlers.llmInference = createCopilotRequestAdapter(this.requestHandler, () => {
         if (!this.connection) {
           return void 0;
         }
         this._rpc ??= createServerRpc(this.connection);
         return this._rpc;
-      })
-    };
+      });
+    }
+    if (this.onGitHubTelemetry) {
+      const onGitHubTelemetry = this.onGitHubTelemetry;
+      handlers.gitHubTelemetry = {
+        event: async (notification) => {
+          try {
+            await onGitHubTelemetry(notification);
+          } catch {
+          }
+        }
+      };
+    }
+    this.clientGlobalHandlers = handlers;
   }
   /**
    * Starts the CLI server and establishes a connection.
@@ -984,11 +996,14 @@ class CopilotClient {
         availableTools: toolFilterOptions.availableTools,
         excludedTools: toolFilterOptions.excludedTools,
         toolFilterPrecedence: toolFilterOptions.toolFilterPrecedence,
+        excludedBuiltinAgents: config.excludedBuiltinAgents,
         provider: bearerWireProvider,
         capi: config.capi,
         providers: bearerWireProviders,
         models: config.models,
         enableSessionTelemetry: config.enableSessionTelemetry,
+        enableCitations: config.enableCitations,
+        sessionLimits: config.sessionLimits,
         modelCapabilities: config.modelCapabilities,
         largeOutput: toWireLargeOutput(config.largeOutput),
         requestPermission: !!config.onPermissionRequest,
@@ -1001,6 +1016,7 @@ class CopilotClient {
         workingDirectory: config.workingDirectory,
         streaming: config.streaming,
         includeSubAgentStreamingEvents: config.includeSubAgentStreamingEvents ?? true,
+        ...this.onGitHubTelemetry != null ? { enableGitHubTelemetryForwarding: true } : {},
         mcpServers: toWireMcpServers(config.mcpServers),
         mcpOAuthTokenStorage: config.mcpOAuthTokenStorage,
         envValueMode: "direct",
@@ -1137,12 +1153,6 @@ class CopilotClient {
     }
     this.sessions.set(sessionId, session);
     this.setupSessionFs(session, config);
-    if (config.onMcpAuthRequest) {
-      await this.connection.sendRequest("session.eventLog.registerInterest", {
-        sessionId,
-        eventType: "mcp.oauth_required"
-      });
-    }
     const toolFilterOptions = this.resolveToolFilterOptions(config);
     try {
       const response = await this.connection.sendRequest("session.resume", {
@@ -1158,6 +1168,9 @@ class CopilotClient {
         excludedTools: toolFilterOptions.excludedTools,
         toolFilterPrecedence: toolFilterOptions.toolFilterPrecedence,
         enableSessionTelemetry: config.enableSessionTelemetry,
+        excludedBuiltinAgents: config.excludedBuiltinAgents,
+        enableCitations: config.enableCitations,
+        sessionLimits: config.sessionLimits,
         tools: config.tools?.map((tool) => ({
           name: tool.name,
           description: tool.description,
@@ -1201,6 +1214,7 @@ class CopilotClient {
         enableSkills: config.enableSkills,
         streaming: config.streaming,
         includeSubAgentStreamingEvents: config.includeSubAgentStreamingEvents ?? true,
+        ...this.onGitHubTelemetry != null ? { enableGitHubTelemetryForwarding: true } : {},
         mcpServers: toWireMcpServers(config.mcpServers),
         mcpOAuthTokenStorage: config.mcpOAuthTokenStorage,
         envValueMode: "direct",
@@ -1224,6 +1238,12 @@ class CopilotClient {
       session["_workspacePath"] = workspacePath;
       session.setCapabilities(capabilities);
       session.setOpenCanvases(openCanvases ?? []);
+      if (config.onMcpAuthRequest) {
+        await this.connection.sendRequest("session.eventLog.registerInterest", {
+          sessionId,
+          eventType: "mcp.oauth_required"
+        });
+      }
       await this.updateSessionOptionsForMode(session, config);
     } catch (e) {
       this.sessions.delete(sessionId);
@@ -1860,7 +1880,7 @@ stderr: ${stderrOutput}`
       if (!session) throw new Error(`No session found for sessionId: ${sessionId}`);
       return session.clientSessionApis;
     });
-    registerClientGlobalApiHandlers(this.connection, this.llmInferenceHandlers);
+    registerClientGlobalApiHandlers(this.connection, this.clientGlobalHandlers);
     this.connection.onClose(() => {
       this.state = "disconnected";
     });

package/dist/generated/rpc.d.ts

@@ -3,7 +3,7 @@
  * Generated from: api.schema.json
  */
 import type { MessageConnection } from "vscode-jsonrpc/node.js";
-import type { AbortReason, Attachment, ContextTier, EmbeddedBlobResourceContents, EmbeddedTextResourceContents, McpServerSource, McpServerStatus, PermissionPromptRequest, PermissionRule, ReasoningSummary, ResponseLimitsConfig, SessionEvent, SessionMode, ShutdownType, SkillSource, UserToolSessionApproval } from "./session-events.js";
+import type { AbortReason, Attachment, ContextTier, EmbeddedBlobResourceContents, EmbeddedTextResourceContents, McpServerSource, McpServerStatus, PermissionPromptRequest, PermissionRule, ReasoningSummary, SessionEvent, SessionLimitsConfig, SessionMode, ShutdownType, SkillSource, UserToolSessionApproval } from "./session-events.js";
 /**
  * Initial authentication info for the session.
  *
@@ -12,6 +12,20 @@ import type { AbortReason, Attachment, ContextTier, EmbeddedBlobResourceContents
  */
 /** @experimental */
 export type AuthInfo = HMACAuthInfo | EnvAuthInfo | TokenAuthInfo | CopilotApiTokenAuthInfo | UserAuthInfo | GhCliAuthInfo | ApiKeyAuthInfo;
+/**
+ * Resolved Anthropic adaptive-thinking capability for a model.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "AdaptiveThinkingSupport".
+ */
+/** @experimental */
+export type AdaptiveThinkingSupport = 
+/** The model does not accept thinking.type='adaptive' */
+"unsupported"
+/** The model accepts adaptive thinking but also accepts thinking.type='enabled' */
+ | "optional"
+/** The model only accepts adaptive thinking and rejects thinking.type='enabled' with HTTP 400 (e.g. opus-4.7/4.8) */
+ | "required";
 /**
  * Which tier this directory belongs to
  *
@@ -1720,6 +1734,22 @@ export type UIExitPlanModeAction =
  | "autopilot"
 /** Exit plan mode and continue in autopilot mode with parallel subagent execution. */
  | "autopilot_fleet";
+/**
+ * User action selected for an exhausted session limit.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "UISessionLimitsExhaustedResponseAction".
+ */
+/** @experimental */
+export type UISessionLimitsExhaustedResponseAction = 
+/** Increase the current max by an exact AI Credits amount. */
+"add"
+/** Set a new absolute max AI Credits value. */
+ | "set"
+/** Remove the current session limit. */
+ | "unset"
+/** Leave the limit unchanged and cancel the blocked model request. */
+ | "cancel";
 /**
  * Type of change represented by this file diff.
  *
@@ -1871,6 +1901,7 @@ export interface CopilotUserResponse {
     quota_snapshots?: CopilotUserResponseQuotaSnapshots;
     restricted_telemetry?: boolean;
     is_staff?: boolean;
+    te?: boolean;
     token_based_billing?: boolean;
     can_upgrade_plan?: boolean;
     quota_reset_date_utc?: string;
@@ -3252,6 +3283,78 @@ export interface CommandsRespondToQueuedCommandResult {
      */
     success: boolean;
 }
+/**
+ * Characters that, when typed in the composer, should trigger a `completions.request`. Empty when the session has no host-driven completions (e.g. local sessions, or a relay host that does not advertise `completionTriggerCharacters`).
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "CompletionsGetTriggerCharactersResult".
+ */
+/** @experimental */
+export interface CompletionsGetTriggerCharactersResult {
+    /**
+     * Trigger characters advertised by the host (e.g. `["@", "#"]`). Empty disables host-driven completions for the session.
+     */
+    triggerCharacters: string[];
+}
+/**
+ * Request host-driven completions for the current composer input.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "CompletionsRequestRequest".
+ */
+/** @experimental */
+export interface CompletionsRequestRequest {
+    /**
+     * The full composed composer input.
+     */
+    text: string;
+    /**
+     * Cursor offset within `text`, in UTF-16 code units.
+     */
+    offset: number;
+}
+/**
+ * Host-driven completion items for the current composer input. Empty when the host returns no items or does not support completions.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "CompletionsRequestResult".
+ */
+/** @experimental */
+export interface CompletionsRequestResult {
+    /**
+     * Completion items in host-ranked order.
+     */
+    items: SessionCompletionItem[];
+}
+/**
+ * A single host-driven completion. Accepting an item replaces `[rangeStart, rangeEnd)` (UTF-16 code units) in the composer with `insertText`; when the range is absent, the active token around the cursor is replaced.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SessionCompletionItem".
+ */
+/** @experimental */
+export interface SessionCompletionItem {
+    /**
+     * Text spliced into the composer when the item is accepted.
+     */
+    insertText: string;
+    /**
+     * Start of the replacement range in `text`, in UTF-16 code units.
+     */
+    rangeStart?: number;
+    /**
+     * End (exclusive) of the replacement range in `text`, in UTF-16 code units.
+     */
+    rangeEnd?: number;
+    /**
+     * Primary display label for the picker row. Falls back to `insertText` when absent.
+     */
+    label?: string;
+    /**
+     * Render-kind hint for the picker row (e.g. `"document"`, `"directory"`), derived from the host's display kind.
+     */
+    kind?: string;
+}
 /**
  * Metadata for a connected remote session.
  *
@@ -3955,6 +4058,125 @@ export interface FolderTrustCheckResult {
      */
     trusted: boolean;
 }
+/**
+ * Client environment metadata describing the process that produced a telemetry event.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "GitHubTelemetryClientInfo".
+ */
+/** @experimental */
+export interface GitHubTelemetryClientInfo {
+    /**
+     * Copilot CLI version string.
+     */
+    cli_version: string;
+    /**
+     * Operating system platform (e.g. darwin, linux, win32).
+     */
+    os_platform: string;
+    /**
+     * Operating system version string.
+     */
+    os_version: string;
+    /**
+     * Operating system architecture (e.g. arm64, x64).
+     */
+    os_arch: string;
+    /**
+     * Node.js runtime version string.
+     */
+    node_version: string;
+    /**
+     * Copilot subscription plan, when known.
+     */
+    copilot_plan?: string;
+    /**
+     * Type of client.
+     */
+    client_type?: string;
+    /**
+     * Name of the client application.
+     */
+    client_name?: string;
+    /**
+     * Whether the user is a GitHub/Microsoft staff member.
+     */
+    is_staff?: boolean;
+    /**
+     * Stable machine identifier for the device.
+     */
+    dev_device_id?: string;
+}
+/**
+ * A single telemetry event in the runtime's native GitHub-shaped telemetry format, forwarded verbatim to opted-in hosts. The `restricted` flag on the enclosing GitHubTelemetryNotification distinguishes standard from restricted events; the payload shape is identical for both.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "GitHubTelemetryEvent".
+ */
+/** @experimental */
+export interface GitHubTelemetryEvent {
+    /**
+     * Event type/kind (e.g. get_completion_with_tools_turn, tool_call_executed).
+     */
+    kind: string;
+    /**
+     * Timestamp when the event was created (ISO 8601 format).
+     */
+    created_at?: string;
+    /**
+     * Reference to the model call that produced this event.
+     */
+    model_call_id?: string;
+    /**
+     * String-valued properties as a map from key to value.
+     */
+    properties: {
+        [k: string]: string | undefined;
+    };
+    /**
+     * Numeric metrics as a map from key to value.
+     */
+    metrics: {
+        [k: string]: number | undefined;
+    };
+    /**
+     * Experiment assignment context.
+     */
+    exp_assignment_context?: string;
+    /**
+     * Feature flags enabled for this session, as a map from flag to value.
+     */
+    features?: {
+        [k: string]: string | undefined;
+    };
+    /**
+     * Session identifier the event belongs to.
+     */
+    session_id?: string;
+    /**
+     * Copilot tracking ID for user-level attribution.
+     */
+    copilot_tracking_id?: string;
+    client?: GitHubTelemetryClientInfo;
+}
+/**
+ * Payload for a `gitHubTelemetry.event` notification: a single GitHub telemetry event the runtime forwards to a host connection that opted into telemetry forwarding for the session.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "GitHubTelemetryNotification".
+ */
+/** @experimental */
+export interface GitHubTelemetryNotification {
+    /**
+     * Session the telemetry event belongs to.
+     */
+    sessionId: string;
+    /**
+     * Whether this is a restricted telemetry event (cli.restricted_telemetry). Hosts must route restricted events to first-party Microsoft stores only.
+     */
+    restricted: boolean;
+    event: GitHubTelemetryEvent;
+}
 /**
  * Pending external tool call request ID, with the tool result or an error describing why it failed.
  *
@@ -6089,6 +6311,7 @@ export interface ModelCapabilitiesSupports {
      * Whether this model supports reasoning effort configuration
      */
     reasoningEffort?: boolean;
+    adaptive_thinking?: AdaptiveThinkingSupport;
 }
 /**
  * Token limits for prompts, outputs, and context window
@@ -6275,6 +6498,7 @@ export interface ModelCapabilitiesOverrideSupports {
      * Whether this model supports reasoning effort configuration
      */
     reasoningEffort?: boolean;
+    adaptive_thinking?: AdaptiveThinkingSupport;
 }
 /**
  * Token limits for prompts, outputs, and context window
@@ -9063,7 +9287,7 @@ export interface QueueRemoveMostRecentResult {
 /** @experimental */
 export interface RegisterEventInterestParams {
     /**
-     * The event type the consumer wants the runtime to treat as 'observed' for behavior-switching gating. Some runtime code paths inspect whether any consumer is interested in a specific event type and choose a different implementation accordingly (e.g. `mcp.oauth_required`: when interest is registered the runtime delegates the full interactive OAuth flow to the consumer; when no interest is registered the runtime installs a browserless fallback that silently reuses cached tokens). SDK clients that long-poll events do NOT automatically appear as listeners to these gating checks — they must explicitly call `registerInterest` for each event type they want the runtime to count as having a consumer. Multiple registrations for the same event type from the same or different consumers are tracked independently and must each be released. See: `mcp.oauth_required`, `sampling.requested`, `auto_mode_switch.requested`, `user_input.requested`, `elicitation.requested`, `command.queued`, `exit_plan_mode.requested`.
+     * The event type the consumer wants the runtime to treat as 'observed' for behavior-switching gating. Some runtime code paths inspect whether any consumer is interested in a specific event type and choose a different implementation accordingly (e.g. `mcp.oauth_required`: when interest is registered the runtime delegates the full interactive OAuth flow to the consumer; when no interest is registered the runtime installs a browserless fallback that silently reuses cached tokens). SDK clients that long-poll events do NOT automatically appear as listeners to these gating checks — they must explicitly call `registerInterest` for each event type they want the runtime to count as having a consumer. Multiple registrations for the same event type from the same or different consumers are tracked independently and must each be released. See: `mcp.oauth_required`, `sampling.requested`, `auto_mode_switch.requested`, `session_limits_exhausted.requested`, `user_input.requested`, `elicitation.requested`, `command.queued`, `exit_plan_mode.requested`.
      */
     eventType: string;
 }
@@ -10506,9 +10730,9 @@ export interface SessionMetadataSnapshot {
      */
     selectedModel?: string;
     /**
-     * Current response limits for the session, or null when no limits are active
+     * Current session limits, or null when no limits are active
      */
-    responseLimits: ResponseLimitsConfig | null;
+    sessionLimits: SessionLimitsConfig | 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).
      */
@@ -10632,6 +10856,10 @@ export interface SessionOpenOptions {
      * Denylist of tool names.
      */
     excludedTools?: string[];
+    /**
+     * Built-in subagent names to exclude from this session. Excluded built-ins are hidden from agent discovery and cannot be dispatched unless a custom agent with the same name is available.
+     */
+    excludedBuiltinAgents?: string[];
     /**
      * Whether shell-script safety heuristics are enabled.
      */
@@ -10721,7 +10949,7 @@ export interface SessionOpenOptions {
      */
     maxInlineBinaryBytes?: number;
     modelCapabilitiesOverrides?: ModelCapabilitiesOverride;
-    responseLimits?: ResponseLimitsConfig;
+    sessionLimits?: SessionLimitsConfig;
     /**
      * Runtime context discriminator for agent filtering.
      */
@@ -11580,6 +11808,10 @@ export interface SessionUpdateOptionsParams {
      * Denylist of tool names for this session.
      */
     excludedTools?: string[];
+    /**
+     * Built-in subagent names to exclude from this session. Excluded built-ins are hidden from agent discovery and cannot be dispatched unless a custom agent with the same name is available.
+     */
+    excludedBuiltinAgents?: string[];
     toolFilterPrecedence?: OptionsUpdateToolFilterPrecedence;
     /**
      * Whether shell-script safety heuristics are enabled.
@@ -11719,9 +11951,9 @@ export interface SessionUpdateOptionsParams {
     enableSkills?: boolean;
     contextTier?: OptionsUpdateContextTier;
     /**
-     * Optional response limits. Pass null to clear the response limits.
+     * Optional session limits. Pass null to clear the session limits.
      */
-    responseLimits?: ResponseLimitsConfig | null;
+    sessionLimits?: SessionLimitsConfig | null;
 }
 /**
  * Indicates whether the session options patch was applied successfully.
@@ -13212,6 +13444,38 @@ export interface UIHandlePendingSamplingRequest {
 export interface UIHandlePendingSamplingResponse {
     [k: string]: unknown | undefined;
 }
+/**
+ * Request ID of a pending `session_limits_exhausted.requested` event and the user's selected limit action.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "UIHandlePendingSessionLimitsExhaustedRequest".
+ */
+/** @experimental */
+export interface UIHandlePendingSessionLimitsExhaustedRequest {
+    /**
+     * The unique request ID from the session_limits_exhausted.requested event
+     */
+    requestId: string;
+    response: UISessionLimitsExhaustedResponse;
+}
+/**
+ * The user's selected action for an exhausted session limit.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "UISessionLimitsExhaustedResponse".
+ */
+/** @experimental */
+export interface UISessionLimitsExhaustedResponse {
+    action: UISessionLimitsExhaustedResponseAction;
+    /**
+     * AI Credits to add to the current max when action is 'add'.
+     */
+    additionalAiCredits?: number;
+    /**
+     * New absolute max AI Credits when action is 'set'.
+     */
+    maxAiCredits?: number;
+}
 /**
  * Request ID of a pending `user_input.requested` event and the user's response.
  *
@@ -14697,6 +14961,23 @@ export declare function createSessionRpc(connection: MessageConnection, sessionI
         diff: (params: WorkspacesDiffRequest) => Promise<WorkspaceDiffResult>;
     };
     /** @experimental */
+    completions: {
+        /**
+         * Gets the characters that should trigger host-driven completions for the session. Empty disables host-driven completions (e.g. local sessions, or a relay host that does not advertise them).
+         *
+         * @returns Characters that, when typed in the composer, should trigger a `completions.request`. Empty when the session has no host-driven completions (e.g. local sessions, or a relay host that does not advertise `completionTriggerCharacters`).
+         */
+        getTriggerCharacters: () => Promise<CompletionsGetTriggerCharactersResult>;
+        /**
+         * Requests host-driven completion items for the current composer input. Returns an empty list when the host has no items or does not support completions.
+         *
+         * @param params Request host-driven completions for the current composer input.
+         *
+         * @returns Host-driven completion items for the current composer input. Empty when the host returns no items or does not support completions.
+         */
+        request: (params: CompletionsRequestRequest) => Promise<CompletionsRequestResult>;
+    };
+    /** @experimental */
     instructions: {
         /**
          * Gets instruction sources loaded for the session.
@@ -15253,6 +15534,14 @@ export declare function createSessionRpc(connection: MessageConnection, sessionI
          * @returns Indicates whether the pending UI request was resolved by this call.
          */
         handlePendingAutoModeSwitch: (params: UIHandlePendingAutoModeSwitchRequest) => Promise<UIHandlePendingResult>;
+        /**
+         * Resolves a pending `session_limits_exhausted.requested` event with the user's selected limit action.
+         *
+         * @param params Request ID of a pending `session_limits_exhausted.requested` event and the user's selected limit action.
+         *
+         * @returns Indicates whether the pending UI request was resolved by this call.
+         */
+        handlePendingSessionLimitsExhausted: (params: UIHandlePendingSessionLimitsExhaustedRequest) => Promise<UIHandlePendingResult>;
         /**
          * Resolves a pending `exit_plan_mode.requested` event with the user's response.
          *
@@ -15876,9 +16165,20 @@ export interface LlmInferenceHandler {
      */
     httpRequestChunk(params: LlmInferenceHttpRequestChunkRequest): Promise<LlmInferenceHttpRequestChunkResult>;
 }
+/** Handler for `gitHubTelemetry` client global API methods. */
+/** @experimental */
+export interface GitHubTelemetryHandler {
+    /**
+     * Forwards a single GitHub telemetry event to a host connection that opted into telemetry forwarding for the session.
+     *
+     * @param params Payload for a `gitHubTelemetry.event` notification: a single GitHub telemetry event the runtime forwards to a host connection that opted into telemetry forwarding for the session.
+     */
+    event(params: GitHubTelemetryNotification): Promise<void>;
+}
 /** All client global API handler groups. */
 export interface ClientGlobalApiHandlers {
     llmInference?: LlmInferenceHandler;
+    gitHubTelemetry?: GitHubTelemetryHandler;
 }
 /**
  * Register client global API handlers on a JSON-RPC connection.

package/dist/generated/rpc.js

@@ -873,6 +873,23 @@ function createSessionRpc(connection, sessionId) {
       diff: async (params) => connection.sendRequest("session.workspaces.diff", { sessionId, ...params })
     },
     /** @experimental */
+    completions: {
+      /**
+       * Gets the characters that should trigger host-driven completions for the session. Empty disables host-driven completions (e.g. local sessions, or a relay host that does not advertise them).
+       *
+       * @returns Characters that, when typed in the composer, should trigger a `completions.request`. Empty when the session has no host-driven completions (e.g. local sessions, or a relay host that does not advertise `completionTriggerCharacters`).
+       */
+      getTriggerCharacters: async () => connection.sendRequest("session.completions.getTriggerCharacters", { sessionId }),
+      /**
+       * Requests host-driven completion items for the current composer input. Returns an empty list when the host has no items or does not support completions.
+       *
+       * @param params Request host-driven completions for the current composer input.
+       *
+       * @returns Host-driven completion items for the current composer input. Empty when the host returns no items or does not support completions.
+       */
+      request: async (params) => connection.sendRequest("session.completions.request", { sessionId, ...params })
+    },
+    /** @experimental */
     instructions: {
       /**
        * Gets instruction sources loaded for the session.
@@ -1429,6 +1446,14 @@ function createSessionRpc(connection, sessionId) {
        * @returns Indicates whether the pending UI request was resolved by this call.
        */
       handlePendingAutoModeSwitch: async (params) => connection.sendRequest("session.ui.handlePendingAutoModeSwitch", { sessionId, ...params }),
+      /**
+       * Resolves a pending `session_limits_exhausted.requested` event with the user's selected limit action.
+       *
+       * @param params Request ID of a pending `session_limits_exhausted.requested` event and the user's selected limit action.
+       *
+       * @returns Indicates whether the pending UI request was resolved by this call.
+       */
+      handlePendingSessionLimitsExhausted: async (params) => connection.sendRequest("session.ui.handlePendingSessionLimitsExhausted", { sessionId, ...params }),
       /**
        * Resolves a pending `exit_plan_mode.requested` event with the user's response.
        *
@@ -2033,6 +2058,11 @@ function registerClientGlobalApiHandlers(connection, handlers) {
     if (!handler) throw new Error("No llmInference client-global handler registered");
     return handler.httpRequestChunk(params);
   });
+  connection.onNotification("gitHubTelemetry.event", async (params) => {
+    const handler = handlers.gitHubTelemetry;
+    if (!handler) return;
+    await handler.event(params);
+  });
 }
 export {
   createInternalServerRpc,

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 | ResponseLimitsChangedEvent | PermissionsChangedEvent | PlanChangedEvent | TodosChangedEvent | WorkspaceFileChangedEvent | HandoffEvent | TruncationEvent | SnapshotRewindEvent | ShutdownEvent | ContextChangedEvent | UsageInfoEvent | CompactionStartEvent | CompactionCompleteEvent | TaskCompleteEvent | UserMessageEvent | PendingMessagesModifiedEvent | AssistantTurnStartEvent | AssistantIntentEvent | AssistantReasoningEvent | AssistantReasoningDeltaEvent | 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 | 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 | 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;
 /**
  * Hosting platform type of the repository (github or ado)
  */
@@ -415,6 +415,18 @@ export type AutoModeSwitchResponse =
  | "yes_always"
 /** Do not switch models. */
  | "no";
+/**
+ * User action selected for an exhausted session limit.
+ */
+export type SessionLimitsExhaustedResponseAction = 
+/** Increase the current max by an exact AI Credits amount. */
+"add"
+/** Set a new absolute max AI Credits value. */
+ | "set"
+/** Remove the current session limit. */
+ | "unset"
+/** Leave the limit unchanged and cancel the blocked model request. */
+ | "cancel";
 /**
  * Exit plan mode action
  */
@@ -573,7 +585,6 @@ export interface StartData {
      * Whether this session supports remote steering via GitHub
      */
     remoteSteerable?: boolean;
-    responseLimits?: ResponseLimitsConfig;
     /**
      * Model selected at session creation time, if any
      */
@@ -582,6 +593,7 @@ export interface StartData {
      * Unique identifier for the session
      */
     sessionId: string;
+    sessionLimits?: SessionLimitsConfig;
     /**
      * ISO 8601 timestamp when the session was created
      */
@@ -626,11 +638,11 @@ export interface WorkingDirectoryContext {
     repositoryHost?: string;
 }
 /**
- * Optional response limits.
+ * Optional session limits.
  */
-export interface ResponseLimitsConfig {
+export interface SessionLimitsConfig {
     /**
-     * Maximum AI Credits allowed while responding to one top-level user message.
+     * Maximum AI Credits allowed across the session's current accounting window.
      */
     maxAiCredits?: number;
 }
@@ -698,10 +710,6 @@ export interface ResumeData {
      * Whether this session supports remote steering via GitHub
      */
     remoteSteerable?: boolean;
-    /**
-     * Response limits currently configured at resume time; null when no limits are active
-     */
-    responseLimits?: ResponseLimitsConfig | null;
     /**
      * ISO 8601 timestamp when the session was resumed
      */
@@ -710,6 +718,10 @@ export interface ResumeData {
      * Model currently selected at resume time
      */
     selectedModel?: string;
+    /**
+     * Session limits currently configured at resume time; null when no limits are active
+     */
+    sessionLimits?: SessionLimitsConfig | null;
     /**
      * True when this resume attached to a session that the runtime already had running in-memory (for example, an extension joining a session another client was actively driving). False (or omitted) for cold resumes — the runtime had to reconstitute the session from its persisted event log.
      */
@@ -1294,14 +1306,14 @@ export interface ModeChangedData {
     previousMode: SessionMode;
 }
 /**
- * Session event "session.response_limits_changed". Response limits update details. Null clears the limits.
+ * Session event "session.session_limits_changed". Session limits update details. Null clears the limits.
  */
-export interface ResponseLimitsChangedEvent {
+export interface SessionLimitsChangedEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
      */
     agentId?: string;
-    data: ResponseLimitsChangedData;
+    data: SessionLimitsChangedData;
     /**
      * When true, the event is transient and not persisted to the session event log on disk
      */
@@ -1319,18 +1331,18 @@ export interface ResponseLimitsChangedEvent {
      */
     timestamp: string;
     /**
-     * Type discriminator. Always "session.response_limits_changed".
+     * Type discriminator. Always "session.session_limits_changed".
      */
-    type: "session.response_limits_changed";
+    type: "session.session_limits_changed";
 }
 /**
- * Response limits update details. Null clears the limits.
+ * Session limits update details. Null clears the limits.
  */
-export interface ResponseLimitsChangedData {
+export interface SessionLimitsChangedData {
     /**
-     * Current response limits for the session, or null when no limits are active
+     * Current session limits, or null when no limits are active
      */
-    responseLimits: ResponseLimitsConfig | null;
+    sessionLimits: SessionLimitsConfig | null;
 }
 /**
  * Session event "session.permissions_changed". Permissions change details carrying the aggregate allow-all boolean transition.
@@ -1857,6 +1869,45 @@ export interface ShutdownTokenDetail {
      */
     tokenCount: number;
 }
+/**
+ * Session event "session.usage_checkpoint". Durable session usage checkpoint for reconstructing aggregate accounting on resume
+ */
+export interface UsageCheckpointEvent {
+    /**
+     * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
+     */
+    agentId?: string;
+    data: UsageCheckpointData;
+    /**
+     * 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.usage_checkpoint".
+     */
+    type: "session.usage_checkpoint";
+}
+/**
+ * Durable session usage checkpoint for reconstructing aggregate accounting on resume
+ */
+export interface UsageCheckpointData {
+    /**
+     * Session-wide accumulated nano-AI units cost at checkpoint time
+     */
+    totalNanoAiu: number;
+}
 /**
  * Session event "session.context_changed". Updated working directory and git context after the change
  */
@@ -3034,6 +3085,10 @@ export interface AssistantMessageData {
      * Readable reasoning text from the model's extended thinking
      */
     reasoningText?: string;
+    /**
+     * OpenAI-compatible wire field the provider used for reasoning (e.g. reasoning_content/reasoning). Populated only when non-canonical, so the dialect round-trips across turns.
+     */
+    reasoningWireField?: string;
     /**
      * GitHub request tracing ID (x-github-request-id header) for correlating with server-side logs
      */
@@ -5447,6 +5502,14 @@ export interface PermissionRequestRead {
      * Path of the file or directory being read
      */
     path: string;
+    /**
+     * True when the model has requested to run this search outside the sandbox (it set requestSandboxBypass: true and the host opted in via sandbox.allowBypass). This is a request, not a grant: the search runs unsandboxed only if the user approves this permission request. Hosts should highlight the elevated risk in the approval UI.
+     */
+    requestSandboxBypass?: boolean;
+    /**
+     * Model-provided justification for the sandbox-bypass request. Only meaningful when requestSandboxBypass is true.
+     */
+    requestSandboxBypassReason?: string;
     /**
      * Tool call ID that triggered this permission request
      */
@@ -7118,6 +7181,107 @@ export interface AutoModeSwitchCompletedData {
     requestId: string;
     response: AutoModeSwitchResponse;
 }
+/**
+ * Session event "session_limits_exhausted.requested". Session limit exhaustion notification requiring user action.
+ */
+export interface SessionLimitsExhaustedRequestedEvent {
+    /**
+     * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
+     */
+    agentId?: string;
+    data: SessionLimitsExhaustedRequestedData;
+    /**
+     * Always true for events that are transient and not persisted to the session event log on disk.
+     */
+    ephemeral: true;
+    /**
+     * 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_limits_exhausted.requested".
+     */
+    type: "session_limits_exhausted.requested";
+}
+/**
+ * Session limit exhaustion notification requiring user action.
+ */
+export interface SessionLimitsExhaustedRequestedData {
+    /**
+     * Configured max AI Credits for the current accounting window.
+     */
+    maxAiCredits: number;
+    /**
+     * Unique identifier for this request; used to respond via session.ui.handlePendingSessionLimitsExhausted().
+     */
+    requestId: string;
+    /**
+     * AI Credits already consumed in the current accounting window.
+     */
+    usedAiCredits: number;
+}
+/**
+ * Session event "session_limits_exhausted.completed". Session limit exhaustion prompt completion notification.
+ */
+export interface SessionLimitsExhaustedCompletedEvent {
+    /**
+     * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
+     */
+    agentId?: string;
+    data: SessionLimitsExhaustedCompletedData;
+    /**
+     * Always true for events that are transient and not persisted to the session event log on disk.
+     */
+    ephemeral: true;
+    /**
+     * 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_limits_exhausted.completed".
+     */
+    type: "session_limits_exhausted.completed";
+}
+/**
+ * Session limit exhaustion prompt completion notification.
+ */
+export interface SessionLimitsExhaustedCompletedData {
+    /**
+     * Request ID of the resolved request; clients should dismiss any UI for this request.
+     */
+    requestId: string;
+    response: SessionLimitsExhaustedResponse;
+}
+/**
+ * The user's selected action for an exhausted session limit.
+ */
+export interface SessionLimitsExhaustedResponse {
+    action: SessionLimitsExhaustedResponseAction;
+    /**
+     * AI Credits to add to the current max when action is 'add'.
+     */
+    additionalAiCredits?: number;
+    /**
+     * New absolute max AI Credits when action is 'set'.
+     */
+    maxAiCredits?: number;
+}
 /**
  * Session event "commands.changed". SDK command registration change notification
  */

package/dist/index.d.ts

@@ -10,4 +10,4 @@ export { CopilotSession, type AssistantMessageEvent } from "./session.js";
 export { Canvas, CanvasError, createCanvas, type CanvasAction, type CanvasDeclaration, type CanvasHostContext, type CanvasHostContextCapabilities, type CanvasJsonSchema, type CanvasOptions, } from "./canvas.js";
 export { defineTool, approveAll, convertMcpCallToolResult, createSessionFsAdapter, CopilotRequestHandler, CopilotWebSocketHandler, CopilotWebSocketCloseStatus, CopilotWebSocketForwarder, SYSTEM_MESSAGE_SECTIONS, } from "./types.js";
 export type * from "./generated/session-events.js";
-export type { CommandContext, CommandDefinition, CommandHandler, CloudSessionOptions, CloudSessionRepository, AutoModeSwitchHandler, AutoModeSwitchRequest, AutoModeSwitchResponse, CopilotClientMode, CopilotClientOptions, StdioRuntimeConnection, TcpRuntimeConnection, UriRuntimeConnection, CustomAgentConfig, ElicitationFieldValue, ElicitationHandler, ElicitationParams, ElicitationContext, ElicitationResult, ElicitationSchema, ElicitationSchemaField, ExitPlanModeHandler, ExitPlanModeRequest, ExitPlanModeResult, ExtensionInfo, ForegroundSessionInfo, GetAuthStatusResponse, GetStatusResponse, InfiniteSessionConfig, LargeToolOutputConfig, MemoryConfiguration, UiInputOptions, MCPStdioServerConfig, MCPHTTPServerConfig, MCPServerConfig, DefaultAgentConfig, BearerTokenProvider, MessageOptions, ModelBilling, ModelBillingTokenPrices, ModelBillingTokenPricesLongContext, CapiSessionOptions, ModelCapabilities, ModelCapabilitiesOverride, ModelInfo, ModelPolicy, NamedProviderConfig, PermissionHandler, PermissionRequest, PermissionRequestResult, ProviderConfig, ProviderModelConfig, ProviderTokenArgs, RemoteSessionMode, ResumeSessionConfig, SectionOverride, SectionOverrideAction, SectionTransformFn, SessionCapabilities, SessionConfig, SessionConfigBase, SessionEvent, SessionEventHandler, SessionEventPayload, SessionEventType, SessionLifecycleEvent, SessionLifecycleEventMetadata, SessionLifecycleEventType, SessionLifecycleHandler, SessionCreatedEvent, SessionDeletedEvent, SessionUpdatedEvent, SessionForegroundEvent, SessionBackgroundEvent, SessionContext, SessionListFilter, SessionMetadata, SessionUiApi, SessionFsConfig, SessionFsProvider, SessionFsFileInfo, SessionFsSqliteQueryResult, SessionFsSqliteQueryType, SessionFsSqliteProvider, CopilotRequestContext, SystemMessageAppendConfig, SystemMessageConfig, SystemMessageCustomizeConfig, SystemMessageReplaceConfig, SystemMessageSection, TelemetryConfig, TraceContext, TraceContextProvider, Tool, ToolHandler, ToolInvocation, ToolTelemetry, ToolResultObject, TypedSessionEventHandler, TypedSessionLifecycleHandler, ZodSchema, } from "./types.js";
+export type { CommandContext, CommandDefinition, CommandHandler, CloudSessionOptions, CloudSessionRepository, AutoModeSwitchHandler, AutoModeSwitchRequest, AutoModeSwitchResponse, CopilotClientMode, CopilotClientOptions, StdioRuntimeConnection, TcpRuntimeConnection, UriRuntimeConnection, CustomAgentConfig, ElicitationFieldValue, ElicitationHandler, ElicitationParams, ElicitationContext, ElicitationResult, ElicitationSchema, ElicitationSchemaField, ExitPlanModeHandler, ExitPlanModeRequest, ExitPlanModeResult, ExtensionInfo, ForegroundSessionInfo, GetAuthStatusResponse, GetStatusResponse, GitHubTelemetryNotification, GitHubTelemetryEvent, GitHubTelemetryClientInfo, InfiniteSessionConfig, LargeToolOutputConfig, MemoryConfiguration, UiInputOptions, MCPStdioServerConfig, MCPHTTPServerConfig, MCPServerConfig, DefaultAgentConfig, BearerTokenProvider, MessageOptions, ModelBilling, ModelBillingTokenPrices, ModelBillingTokenPricesLongContext, CapiSessionOptions, ModelCapabilities, ModelCapabilitiesOverride, ModelInfo, ModelPolicy, NamedProviderConfig, PermissionHandler, PermissionRequest, PermissionRequestResult, ProviderConfig, ProviderModelConfig, ProviderTokenArgs, RemoteSessionMode, ResumeSessionConfig, SectionOverride, SectionOverrideAction, SectionTransformFn, SessionCapabilities, SessionConfig, SessionConfigBase, SessionEvent, SessionEventHandler, SessionEventPayload, SessionEventType, SessionLifecycleEvent, SessionLifecycleEventMetadata, SessionLifecycleEventType, SessionLifecycleHandler, SessionCreatedEvent, SessionDeletedEvent, SessionUpdatedEvent, SessionForegroundEvent, SessionBackgroundEvent, SessionContext, SessionListFilter, SessionMetadata, SessionUiApi, SessionFsConfig, SessionFsProvider, SessionFsFileInfo, SessionFsSqliteQueryResult, SessionFsSqliteQueryType, SessionFsSqliteProvider, CopilotRequestContext, SystemMessageAppendConfig, SystemMessageConfig, SystemMessageCustomizeConfig, SystemMessageReplaceConfig, SystemMessageSection, TelemetryConfig, TraceContext, TraceContextProvider, Tool, ToolHandler, ToolInvocation, ToolTelemetry, ToolResultObject, TypedSessionEventHandler, TypedSessionLifecycleHandler, ZodSchema, } from "./types.js";

package/dist/types.d.ts

@@ -4,11 +4,12 @@
 import type { Canvas } from "./canvas.js";
 import type { SessionFsProvider } from "./sessionFsProvider.js";
 import type { CopilotRequestHandler } from "./copilotRequestHandler.js";
-import type { ReasoningSummary, SessionEvent as GeneratedSessionEvent } from "./generated/session-events.js";
+import type { ReasoningSummary, SessionLimitsConfig, SessionEvent as GeneratedSessionEvent } from "./generated/session-events.js";
 import type { CopilotSession } from "./session.js";
-import type { ModelBillingTokenPrices, OpenCanvasInstance, RemoteSessionMode } from "./generated/rpc.js";
+import type { GitHubTelemetryNotification, ModelBillingTokenPrices, OpenCanvasInstance, RemoteSessionMode } from "./generated/rpc.js";
 import type { ToolSet } from "./toolSet.js";
 export type { RemoteSessionMode } from "./generated/rpc.js";
+export type { GitHubTelemetryNotification, GitHubTelemetryEvent, GitHubTelemetryClientInfo, } from "./generated/rpc.js";
 export type { ModelBillingTokenPrices, ModelBillingTokenPricesLongContext, } from "./generated/rpc.js";
 export type SessionEvent = GeneratedSessionEvent;
 export type { ReasoningSummary } from "./generated/session-events.js";
@@ -270,6 +271,17 @@ export interface CopilotClientOptions {
      * @experimental
      */
     requestHandler?: CopilotRequestHandler;
+    /**
+     * Experimental. Receives GitHub telemetry events the runtime forwards to
+     * this connection. When set, the client opts each session it creates or
+     * resumes into telemetry forwarding and dispatches each
+     * `gitHubTelemetry.event` notification to this connection-global handler;
+     * each {@link GitHubTelemetryNotification} carries its originating
+     * `sessionId`.
+     *
+     * @experimental
+     */
+    onGitHubTelemetry?: (notification: GitHubTelemetryNotification) => void | Promise<void>;
     /**
      * Server-wide idle timeout for sessions in seconds.
      * Sessions without activity for this duration are automatically cleaned up.
@@ -1510,6 +1522,12 @@ export interface SessionConfigBase {
      * is disabled even if it also matches `availableTools`.
      */
     excludedTools?: string[] | ToolSet;
+    /**
+     * Names of built-in agents to exclude from the session. Excluded built-in
+     * agents are hidden from discovery and cannot be selected or invoked unless
+     * a custom agent with the same name is configured.
+     */
+    excludedBuiltinAgents?: string[];
     /**
      * Custom provider configuration (BYOK - Bring Your Own Key).
      * When specified, uses the provided API endpoint instead of the Copilot API.
@@ -1554,6 +1572,18 @@ export interface SessionConfigBase {
      * This is independent of the OpenTelemetry configuration in {@link CopilotClientOptions.telemetry}.
      */
     enableSessionTelemetry?: boolean;
+    /**
+     * Enables native model citations for supported providers.
+     *
+     * @experimental
+     */
+    enableCitations?: boolean;
+    /**
+     * Limits applied to this session's current accounting window.
+     *
+     * @experimental
+     */
+    sessionLimits?: SessionLimitsConfig;
     /**
      * When true, the runtime skips loading custom-instruction sources
      * (e.g. `.github/copilot-instructions.md`, `AGENTS.md`, `CLAUDE.md`).

package/package.json

@@ -4,7 +4,7 @@
     "type": "git",
     "url": "https://github.com/github/copilot-sdk.git"
   },
-  "version": "1.0.5-preview.1",
+  "version": "1.0.6-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.66-2",
+    "@github/copilot": "^1.0.67",
     "vscode-jsonrpc": "^8.2.1",
     "zod": "^4.3.6"
   },