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

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.
@@ -1017,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",
@@ -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",
@@ -1879,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

@@ -621,14 +621,6 @@ function createInternalServerRpc(connection) {
        * @returns Dynamic-context board entry count, when available.
        */
       getBoardEntryCount: async (params) => connection.sendRequest("sessions.getBoardEntryCount", params),
-      /**
-       * Cursor-based long-poll for sessions spawned by the runtime (e.g. in response to a Mission Control `start_session` command). The cursor is an opaque token; pass it back to receive only spawn events that occurred AFTER the cursor was issued. Omit the cursor on the first call to receive any events buffered since the runtime started. Internal: this is a CLI background-daemon plumbing primitive. SDK consumers that need to react to runtime-spawned sessions should subscribe to a higher-level event stream rather than driving a long-poll loop.
-       *
-       * @param params Cursor and optional long-poll wait for polling runtime-spawned sessions.
-       *
-       * @returns Batch of spawn events plus a cursor for follow-up polls.
-       */
-      pollSpawnedSessions: async (params) => connection.sendRequest("sessions.pollSpawnedSessions", params),
       /**
        * Registers extension-provided tools on the given session, gated by an optional `enabled` callback. Returns an opaque unsubscribe function the caller must invoke to deregister the tools when the extension is torn down. Marked internal because `loader`, `enabled`, and the returned `unsubscribe` are in-process handles that cannot cross the JSON-RPC boundary. Disappears once extension discovery / launch / tool registration are owned by the runtime: SDK consumers will pass pure config (search paths, disabled ids) via `SessionOptions` and the runtime will resolve, launch, register, and tear down extensions itself.
        *
@@ -1718,6 +1710,20 @@ function createSessionRpc(connection, sessionId) {
        * @returns Token breakdown for the session's current context window, or null if uninitialized.
        */
       contextInfo: async (params) => connection.sendRequest("session.metadata.contextInfo", { sessionId, ...params }),
+      /**
+       * Returns the experimental per-source attribution breakdown of the session's current context window as a flat list of entries (skills, subagents, MCP servers, built-in tools, plugin rollups, system/tool-definition costs, with nesting via parentId), plus the successful compaction count. The heaviest individual messages are available separately via `metadata.getContextHeaviestMessages`. Returns null until the session has initialized its system prompt and tool metadata.
+       *
+       * @returns Per-source attribution breakdown for the session's current context window, or null if uninitialized.
+       */
+      getContextAttribution: async () => connection.sendRequest("session.metadata.getContextAttribution", { sessionId }),
+      /**
+       * Returns the largest individual messages currently in the session's context window, most-expensive first. Companion to `metadata.getContextAttribution`. Returns an empty list until the session has initialized.
+       *
+       * @param params Parameters for the heaviest-messages query.
+       *
+       * @returns The heaviest individual messages in the session's context window, most-expensive first.
+       */
+      getContextHeaviestMessages: async (params) => connection.sendRequest("session.metadata.getContextHeaviestMessages", { sessionId, ...params }),
       /**
        * Records a working-directory/git context change and emits a `session.context_changed` event.
        *
@@ -2086,10 +2092,10 @@ function registerClientGlobalApiHandlers(connection, handlers) {
     if (!handler) throw new Error("No llmInference client-global handler registered");
     return handler.httpRequestChunk(params);
   });
-  connection.onRequest("gitHubTelemetry.event", async (params) => {
+  connection.onNotification("gitHubTelemetry.event", async (params) => {
     const handler = handlers.gitHubTelemetry;
-    if (!handler) throw new Error("No gitHubTelemetry client-global handler registered");
-    return handler.event(params);
+    if (!handler) return;
+    await handler.event(params);
   });
 }
 // Annotate the CommonJS export names for ESM import in node:

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.
@@ -1004,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",
@@ -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",
@@ -1866,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

@@ -756,6 +756,59 @@ export type McpSetEnvValueModeDetails =
 "direct"
 /** Treat MCP server environment values as host-side references to resolve before launch. */
  | "indirect";
+/**
+ * Per-source context-window attribution, or null if the session has not yet been initialized (no system prompt or tool metadata cached).
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SessionContextAttribution".
+ */
+/** @experimental */
+export type SessionContextAttribution = {
+    /**
+     * Total token count of the current context window the entries are measured against (system message + conversation messages + tool definitions — the same total reported by /context). Divide an entry's `tokens` by this to derive its share.
+     */
+    totalTokens: number;
+    /**
+     * Flat list of per-source attribution entries. Group by `kind` and render unrecognized kinds generically. Nesting and rollups are expressed via `parentId`.
+     */
+    entries: {
+        /**
+         * Source category for this entry. Not a closed set — tolerate unknown values. Known values today: `skill`, `subagent`, `mcpServer`, `tool`, `system`, `toolDefinition`, `plugin`.
+         */
+        kind: string;
+        /**
+         * Identifier for this entry, formed by joining its `kind` and source name (e.g. `tool:bash`, `skill:tmux`, `toolDefinition:bash`); unique within the snapshot. Use it to match the same entry across snapshots, to correlate with other APIs (skill/agent/MCP registries), and as the `parentId` target for nesting. Distinct from the human-facing `label`.
+         */
+        id: string;
+        /**
+         * Human-readable display label, e.g. `bash` or `skill: tmux`. Presentation-only; may be localized/reformatted without notice — do not key off it.
+         */
+        label: string;
+        /**
+         * Token count currently in context attributable to this entry.
+         */
+        tokens: number;
+        /**
+         * Optional `id` of the parent entry: e.g. a `plugin` entry parenting its `skill`/`mcpServer` entries, or the `system` entry parenting `toolDefinition` entries. Omitted for top-level entries.
+         */
+        parentId?: string;
+        /**
+         * Supplementary per-entry metadata (e.g. `messageCount`, `role`, `evictable`, `pluginSource`). Values are stringified; parse as needed and ignore unrecognized keys.
+         */
+        attributes?: {
+            [k: string]: string | undefined;
+        };
+    }[];
+    /**
+     * Successful compaction history for the session.
+     */
+    compactions: {
+        /**
+         * Number of successful compactions in this session.
+         */
+        count: number;
+    };
+} | null;
 /**
  * Token breakdown for the current context window, or null if the session has not yet been initialized (no system prompt or tool metadata cached).
  *
@@ -3148,6 +3201,10 @@ export interface SlashCommandInput {
      * Hint to display when command input has not been provided
      */
     hint: string;
+    /**
+     * Optional literal choices the input accepts, each with a human-facing description; clients may render these as selectable options
+     */
+    choices?: SlashCommandInputChoice[];
     /**
      * When true, the command requires non-empty input; clients should render the input hint as required
      */
@@ -3158,6 +3215,23 @@ export interface SlashCommandInput {
      */
     preserveMultilineInput?: boolean;
 }
+/**
+ * A literal choice the command input accepts, with a human-facing description
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SlashCommandInputChoice".
+ */
+/** @experimental */
+export interface SlashCommandInputChoice {
+    /**
+     * The literal choice value (e.g. 'on', 'off', 'show')
+     */
+    name: string;
+    /**
+     * Human-readable description shown alongside the choice
+     */
+    description: string;
+}
 /**
  * Pending command request ID and an optional error if the client handler failed.
  *
@@ -3436,6 +3510,31 @@ export interface ConnectRemoteSessionParams {
      */
     sessionId: string;
 }
+/**
+ * A single large message currently in context.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "ContextHeaviestMessage".
+ */
+/** @experimental */
+export interface ContextHeaviestMessage {
+    /**
+     * Stable identifier for this message within the snapshot.
+     */
+    id: string;
+    /**
+     * Human-readable source label, e.g. `tool: bash` or `skill: tmux`. Presentation-only.
+     */
+    label: string;
+    /**
+     * Role of the chat message (`user`, `assistant`, or `tool`).
+     */
+    role: string;
+    /**
+     * Token count currently in context for this individual message.
+     */
+    tokens: number;
+}
 /**
  * The currently selected model, reasoning effort, and context tier for the session. The context tier reflects `Session.getContextTier()`, restored from the session journal on resume.
  *
@@ -3770,6 +3869,10 @@ export interface ExternalToolTextResultForLlm {
      * Structured content blocks from the tool
      */
     contents?: ExternalToolTextResultForLlmContent[];
+    /**
+     * Tool references returned by a tool-search override: names of deferred tools to surface to the model. When set, the tool result is materialized as `tool_reference` content blocks (rather than plain text) so the model knows which deferred tools are now available.
+     */
+    toolReferences?: string[];
 }
 /**
  * Binary result returned by a tool for the model
@@ -6050,6 +6153,49 @@ export interface MemoryConfiguration {
      */
     enabled: boolean;
 }
+/**
+ * Per-source attribution breakdown for the session's current context window, or null if uninitialized.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "MetadataContextAttributionResult".
+ */
+/** @experimental */
+export interface MetadataContextAttributionResult {
+    /**
+     * Per-source context-window attribution, or null if the session has not yet been initialized (no system prompt or tool metadata cached).
+     */
+    contextAttribution?: SessionContextAttribution | null;
+}
+/**
+ * Parameters for the heaviest-messages query.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "MetadataContextHeaviestMessagesRequest".
+ */
+/** @experimental */
+export interface MetadataContextHeaviestMessagesRequest {
+    /**
+     * Maximum number of messages to return, most-expensive first. Omit for the server default.
+     */
+    limit?: number;
+}
+/**
+ * The heaviest individual messages in the session's context window, most-expensive first.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "MetadataContextHeaviestMessagesResult".
+ */
+/** @experimental */
+export interface MetadataContextHeaviestMessagesResult {
+    /**
+     * Total token count of the current context window, so callers can compute each message's share without a second call.
+     */
+    totalTokens: number;
+    /**
+     * Heaviest messages, most-expensive first.
+     */
+    messages: ContextHeaviestMessage[];
+}
 /**
  * Model identifier and token limits used to compute the context-info breakdown.
  *
@@ -8523,36 +8669,6 @@ export interface PluginUpdateResult {
      */
     skillsInstalled: number;
 }
-/**
- * Batch of spawn events plus a cursor for follow-up polls.
- *
- * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "PollSpawnedSessionsResult".
- */
-/** @experimental */
-export interface PollSpawnedSessionsResult {
-    /**
-     * Spawn events emitted since the supplied cursor.
-     */
-    events: SessionsPollSpawnedSessionsEvent[];
-    /**
-     * Opaque cursor to pass back to receive only events after this batch.
-     */
-    cursor: string;
-}
-/**
- * Schema for the `SessionsPollSpawnedSessionsEvent` type.
- *
- * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "SessionsPollSpawnedSessionsEvent".
- */
-/** @experimental */
-export interface SessionsPollSpawnedSessionsEvent {
-    /**
-     * Session id of the newly-spawned session.
-     */
-    sessionId: string;
-}
 /**
  * BYOK providers and/or models to add to the session's registry at runtime. Both fields are optional; provide providers, models, or both.
  *
@@ -11558,17 +11674,6 @@ export interface SessionsLoadDeferredRepoHooksRequest {
      */
     sessionId: string;
 }
-/** @experimental */
-export interface SessionsPollSpawnedSessionsRequest {
-    /**
-     * Opaque cursor returned by a previous poll. Omit on the first call to receive any spawn events buffered since the runtime started.
-     */
-    cursor?: string;
-    /**
-     * Milliseconds to wait for new spawn events when the cursor is at the tail. 0 (default) returns immediately even if no events are buffered. Capped at 60000ms.
-     */
-    waitMs?: number;
-}
 /**
  * Age threshold and optional flags controlling which old sessions are pruned (or simulated when dryRun is true).
  *
@@ -15778,6 +15883,20 @@ export declare function createSessionRpc(connection: MessageConnection, sessionI
          * @returns Token breakdown for the session's current context window, or null if uninitialized.
          */
         contextInfo: (params: MetadataContextInfoRequest) => Promise<MetadataContextInfoResult>;
+        /**
+         * Returns the experimental per-source attribution breakdown of the session's current context window as a flat list of entries (skills, subagents, MCP servers, built-in tools, plugin rollups, system/tool-definition costs, with nesting via parentId), plus the successful compaction count. The heaviest individual messages are available separately via `metadata.getContextHeaviestMessages`. Returns null until the session has initialized its system prompt and tool metadata.
+         *
+         * @returns Per-source attribution breakdown for the session's current context window, or null if uninitialized.
+         */
+        getContextAttribution: () => Promise<MetadataContextAttributionResult>;
+        /**
+         * Returns the largest individual messages currently in the session's context window, most-expensive first. Companion to `metadata.getContextAttribution`. Returns an empty list until the session has initialized.
+         *
+         * @param params Parameters for the heaviest-messages query.
+         *
+         * @returns The heaviest individual messages in the session's context window, most-expensive first.
+         */
+        getContextHeaviestMessages: (params: MetadataContextHeaviestMessagesRequest) => Promise<MetadataContextHeaviestMessagesResult>;
         /**
          * Records a working-directory/git context change and emits a `session.context_changed` event.
          *

package/dist/generated/rpc.js

@@ -593,14 +593,6 @@ function createInternalServerRpc(connection) {
        * @returns Dynamic-context board entry count, when available.
        */
       getBoardEntryCount: async (params) => connection.sendRequest("sessions.getBoardEntryCount", params),
-      /**
-       * Cursor-based long-poll for sessions spawned by the runtime (e.g. in response to a Mission Control `start_session` command). The cursor is an opaque token; pass it back to receive only spawn events that occurred AFTER the cursor was issued. Omit the cursor on the first call to receive any events buffered since the runtime started. Internal: this is a CLI background-daemon plumbing primitive. SDK consumers that need to react to runtime-spawned sessions should subscribe to a higher-level event stream rather than driving a long-poll loop.
-       *
-       * @param params Cursor and optional long-poll wait for polling runtime-spawned sessions.
-       *
-       * @returns Batch of spawn events plus a cursor for follow-up polls.
-       */
-      pollSpawnedSessions: async (params) => connection.sendRequest("sessions.pollSpawnedSessions", params),
       /**
        * Registers extension-provided tools on the given session, gated by an optional `enabled` callback. Returns an opaque unsubscribe function the caller must invoke to deregister the tools when the extension is torn down. Marked internal because `loader`, `enabled`, and the returned `unsubscribe` are in-process handles that cannot cross the JSON-RPC boundary. Disappears once extension discovery / launch / tool registration are owned by the runtime: SDK consumers will pass pure config (search paths, disabled ids) via `SessionOptions` and the runtime will resolve, launch, register, and tear down extensions itself.
        *
@@ -1690,6 +1682,20 @@ function createSessionRpc(connection, sessionId) {
        * @returns Token breakdown for the session's current context window, or null if uninitialized.
        */
       contextInfo: async (params) => connection.sendRequest("session.metadata.contextInfo", { sessionId, ...params }),
+      /**
+       * Returns the experimental per-source attribution breakdown of the session's current context window as a flat list of entries (skills, subagents, MCP servers, built-in tools, plugin rollups, system/tool-definition costs, with nesting via parentId), plus the successful compaction count. The heaviest individual messages are available separately via `metadata.getContextHeaviestMessages`. Returns null until the session has initialized its system prompt and tool metadata.
+       *
+       * @returns Per-source attribution breakdown for the session's current context window, or null if uninitialized.
+       */
+      getContextAttribution: async () => connection.sendRequest("session.metadata.getContextAttribution", { sessionId }),
+      /**
+       * Returns the largest individual messages currently in the session's context window, most-expensive first. Companion to `metadata.getContextAttribution`. Returns an empty list until the session has initialized.
+       *
+       * @param params Parameters for the heaviest-messages query.
+       *
+       * @returns The heaviest individual messages in the session's context window, most-expensive first.
+       */
+      getContextHeaviestMessages: async (params) => connection.sendRequest("session.metadata.getContextHeaviestMessages", { sessionId, ...params }),
       /**
        * Records a working-directory/git context change and emits a `session.context_changed` event.
        *
@@ -2058,10 +2064,10 @@ function registerClientGlobalApiHandlers(connection, handlers) {
     if (!handler) throw new Error("No llmInference client-global handler registered");
     return handler.httpRequestChunk(params);
   });
-  connection.onRequest("gitHubTelemetry.event", async (params) => {
+  connection.onNotification("gitHubTelemetry.event", async (params) => {
     const handler = handlers.gitHubTelemetry;
-    if (!handler) throw new Error("No gitHubTelemetry client-global handler registered");
-    return handler.event(params);
+    if (!handler) return;
+    await handler.event(params);
   });
 }
 export {

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

@@ -6,9 +6,10 @@ import type { SessionFsProvider } from "./sessionFsProvider.js";
 import type { CopilotRequestHandler } from "./copilotRequestHandler.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.

package/package.json

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