@github/copilot-sdk 1.0.1 → 1.0.2

package/dist/generated/rpc.js

@@ -206,7 +206,17 @@ function createServerRpc(connection) {
        *
        * @returns Skills discovered across global and project sources.
        */
-      discover: async (params) => connection.sendRequest("skills.discover", params)
+      discover: async (params) => connection.sendRequest("skills.discover", params),
+      /**
+       * Returns the canonical directories where a client may create skills that the runtime will recognize, including ones that do not exist yet. Project directories become active once created.
+       *
+       * @param params Optional project paths to enumerate.
+       *
+       * @returns Canonical locations where skills can be created so the runtime will recognize them.
+       *
+       * @experimental
+       */
+      getDiscoveryPaths: async (params) => connection.sendRequest("skills.getDiscoveryPaths", params)
     },
     /** @experimental */
     agents: {
@@ -217,7 +227,15 @@ function createServerRpc(connection) {
        *
        * @returns Agents discovered across user, project, plugin, and remote sources.
        */
-      discover: async (params) => connection.sendRequest("agents.discover", params)
+      discover: async (params) => connection.sendRequest("agents.discover", params),
+      /**
+       * Returns the canonical directories where a client may create custom agents that the runtime will recognize, including ones that do not exist yet. Project directories become active once created.
+       *
+       * @param params Optional project paths to include when enumerating agent discovery directories.
+       *
+       * @returns Canonical locations where custom agents can be created so the runtime will recognize them.
+       */
+      getDiscoveryPaths: async (params) => connection.sendRequest("agents.getDiscoveryPaths", params)
     },
     /** @experimental */
     instructions: {
@@ -228,7 +246,15 @@ function createServerRpc(connection) {
        *
        * @returns Instruction sources discovered across user, repository, and plugin sources.
        */
-      discover: async (params) => connection.sendRequest("instructions.discover", params)
+      discover: async (params) => connection.sendRequest("instructions.discover", params),
+      /**
+       * Returns the canonical files and directories where a client may create custom instructions that the runtime will recognize, including ones that do not exist yet. Repository targets become active once created.
+       *
+       * @param params Optional project paths to include when enumerating instruction discovery targets.
+       *
+       * @returns Canonical files and directories where custom instructions can be created so the runtime will recognize them.
+       */
+      getDiscoveryPaths: async (params) => connection.sendRequest("instructions.getDiscoveryPaths", params)
     },
     user: {
       settings: {
@@ -698,7 +724,13 @@ function createSessionRpc(connection, sessionId) {
        *
        * @returns Todo rows read from the session SQL database. Empty when no session database is available.
        */
-      readSqlTodos: async () => connection.sendRequest("session.plan.readSqlTodos", { sessionId })
+      readSqlTodos: async () => connection.sendRequest("session.plan.readSqlTodos", { sessionId }),
+      /**
+       * Reads todo rows AND dependency edges from the session SQL database for structured progress UI. Same defensive behavior as readSqlTodos — returns empty arrays when the database, tables, or columns aren't available. Clients should call this on session start and after every `session.todos_changed` event to refresh structured-UI rendering.
+       *
+       * @returns Todo rows + dependency edges read from the session SQL database.
+       */
+      readSqlTodosWithDependencies: async () => connection.sendRequest("session.plan.readSqlTodosWithDependencies", { sessionId })
     },
     /** @experimental */
     workspaces: {
@@ -1081,6 +1113,17 @@ function createSessionRpc(connection, sessionId) {
       reload: async (params) => connection.sendRequest("session.plugins.reload", { sessionId, ...params })
     },
     /** @experimental */
+    provider: {
+      /**
+       * Returns the provider endpoint and credentials the session is currently configured to talk to, so the caller can make inference calls directly against the same backend the session uses.
+       *
+       * @param params Optional model identifier to scope the endpoint snapshot to.
+       *
+       * @returns A snapshot of the provider endpoint the session is currently configured to talk to.
+       */
+      getEndpoint: async (params) => connection.sendRequest("session.provider.getEndpoint", { sessionId, ...params })
+    },
+    /** @experimental */
     options: {
       /**
        * Patches the genuinely-mutable subset of session options.
@@ -1152,7 +1195,15 @@ function createSessionRpc(connection, sessionId) {
        *
        * @returns Current lightweight tool metadata snapshot for the session.
        */
-      getCurrentMetadata: async () => connection.sendRequest("session.tools.getCurrentMetadata", { sessionId })
+      getCurrentMetadata: async () => connection.sendRequest("session.tools.getCurrentMetadata", { sessionId }),
+      /**
+       * Updates the current session's live subagent settings after user settings change. The persisted user settings remain the source of truth for future sessions.
+       *
+       * @param params Subagent settings to apply to the current session
+       *
+       * @returns Empty result after applying subagent settings
+       */
+      updateSubagentSettings: async (params) => connection.sendRequest("session.tools.updateSubagentSettings", { sessionId, ...params })
     },
     /** @experimental */
     commands: {

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 | AutopilotObjectiveChangedEvent | InfoEvent | WarningEvent | ModelChangeEvent | ModeChangedEvent | PermissionsChangedEvent | PlanChangedEvent | WorkspaceFileChangedEvent | HandoffEvent | TruncationEvent | SnapshotRewindEvent | ShutdownEvent | ContextChangedEvent | UsageInfoEvent | CompactionStartEvent | CompactionCompleteEvent | TaskCompleteEvent | UserMessageEvent | PendingMessagesModifiedEvent | AssistantTurnStartEvent | AssistantIntentEvent | AssistantReasoningEvent | AssistantReasoningDeltaEvent | AssistantStreamingDeltaEvent | AssistantMessageEvent | AssistantMessageStartEvent | AssistantMessageDeltaEvent | AssistantTurnEndEvent | AssistantUsageEvent | ModelCallFailureEvent | AbortEvent | ToolUserRequestedEvent | ToolExecutionStartEvent | ToolExecutionPartialResultEvent | ToolExecutionProgressEvent | ToolExecutionCompleteEvent | SkillInvokedEvent | SubagentStartedEvent | SubagentCompletedEvent | SubagentFailedEvent | SubagentSelectedEvent | SubagentDeselectedEvent | HookStartEvent | HookEndEvent | HookProgressEvent | SystemMessageEvent | SystemNotificationEvent | PermissionRequestedEvent | PermissionCompletedEvent | UserInputRequestedEvent | UserInputCompletedEvent | ElicitationRequestedEvent | ElicitationCompletedEvent | SamplingRequestedEvent | SamplingCompletedEvent | McpOauthRequiredEvent | McpOauthCompletedEvent | CustomNotificationEvent | ExternalToolRequestedEvent | ExternalToolCompletedEvent | CommandQueuedEvent | CommandExecuteEvent | CommandCompletedEvent | AutoModeSwitchRequestedEvent | AutoModeSwitchCompletedEvent | CommandsChangedEvent | CapabilitiesChangedEvent | ExitPlanModeRequestedEvent | ExitPlanModeCompletedEvent | ToolsUpdatedEvent | BackgroundTasksChangedEvent | SkillsLoadedEvent | CustomAgentsUpdatedEvent | McpServersLoadedEvent | McpServerStatusChangedEvent | ExtensionsLoadedEvent | CanvasOpenedEvent | CanvasRegistryChangedEvent | CanvasClosedEvent | ExtensionsAttachmentsPushedEvent | McpAppToolCallCompleteEvent;
+export type SessionEvent = StartEvent | ResumeEvent | RemoteSteerableChangedEvent | ErrorEvent | IdleEvent | TitleChangedEvent | ScheduleCreatedEvent | ScheduleCancelledEvent | AutopilotObjectiveChangedEvent | InfoEvent | WarningEvent | ModelChangeEvent | ModeChangedEvent | PermissionsChangedEvent | PlanChangedEvent | TodosChangedEvent | WorkspaceFileChangedEvent | HandoffEvent | TruncationEvent | SnapshotRewindEvent | ShutdownEvent | ContextChangedEvent | UsageInfoEvent | CompactionStartEvent | CompactionCompleteEvent | TaskCompleteEvent | UserMessageEvent | PendingMessagesModifiedEvent | AssistantTurnStartEvent | AssistantIntentEvent | AssistantReasoningEvent | AssistantReasoningDeltaEvent | AssistantStreamingDeltaEvent | AssistantMessageEvent | AssistantMessageStartEvent | AssistantMessageDeltaEvent | AssistantTurnEndEvent | 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 | CustomNotificationEvent | ExternalToolRequestedEvent | ExternalToolCompletedEvent | CommandQueuedEvent | CommandExecuteEvent | CommandCompletedEvent | AutoModeSwitchRequestedEvent | AutoModeSwitchCompletedEvent | CommandsChangedEvent | CapabilitiesChangedEvent | ExitPlanModeRequestedEvent | ExitPlanModeCompletedEvent | ToolsUpdatedEvent | BackgroundTasksChangedEvent | SkillsLoadedEvent | CustomAgentsUpdatedEvent | McpServersLoadedEvent | McpServerStatusChangedEvent | ExtensionsLoadedEvent | CanvasOpenedEvent | CanvasRegistryChangedEvent | CanvasClosedEvent | ExtensionsAttachmentsPushedEvent | McpAppToolCallCompleteEvent;
 /**
  * Hosting platform type of the repository (github or ado)
  */
@@ -164,6 +164,51 @@ export type AbortReason =
  | "remote_command"
 /** An MCP server delivered a user.abort notification. */
  | "user_abort";
+/**
+ * Allowed values for the `ToolExecutionStartToolDescriptionMetaUIVisibility` enumeration.
+ */
+export type ToolExecutionStartToolDescriptionMetaUIVisibility = 
+/** Tool is callable by the model (LLM tool surface) */
+"model"
+/** Tool is callable by the MCP App view (iframe) via session.mcp.apps.callTool */
+ | "app";
+/**
+ * A model-facing binary result as persisted: full inline data, a size-omitted marker, or a deduplicated asset reference
+ */
+/** @experimental */
+export type PersistedBinaryResult = PersistedBinaryImage | OmittedBinaryResult | BinaryAssetReference;
+/**
+ * Binary result type discriminator. Use "image" for images and "resource" for other binary data.
+ */
+export type PersistedBinaryImageType = 
+/** Binary image data. */
+"image"
+/** Other binary resource data. */
+ | "resource";
+/**
+ * Why the binary data is absent: it exceeded the inline size limit, or its asset was unavailable
+ */
+export type OmittedBinaryOmittedReason = 
+/** Bytes exceeded the session's inline size limit. */
+"too_large"
+/** The referenced binary asset could not be found (e.g. a truncated log). */
+ | "asset_unavailable";
+/**
+ * Binary result type discriminator. Use "image" for images and "resource" for other binary data.
+ */
+export type OmittedBinaryType = 
+/** Binary image data. */
+"image"
+/** Other binary resource data. */
+ | "resource";
+/**
+ * Binary result type discriminator. Use "image" for images and "resource" for other binary data.
+ */
+export type BinaryAssetReferenceType = 
+/** Binary image data. */
+"image"
+/** Other binary resource data. */
+ | "resource";
 /**
  * A content block within a tool result, which may be text, terminal output, image, audio, or a resource
  */
@@ -198,6 +243,14 @@ export type SkillInvokedTrigger =
  | "agent-invoked"
 /** Skill content loaded as part of another context, such as a configured custom agent or subagent. */
  | "context-load";
+/**
+ * Binary asset type discriminator. Use "image" for images and "resource" otherwise.
+ */
+export type BinaryAssetType = 
+/** Binary image data. */
+"image"
+/** Other binary resource data. */
+ | "resource";
 /**
  * Message role: "system" for system prompts, "developer" for developer-injected instructions
  */
@@ -375,7 +428,11 @@ export type ExtensionsLoadedExtensionSource =
 /** Extension discovered from the current project. */
 "project"
 /** Extension discovered from the user's extension directory. */
- | "user";
+ | "user"
+/** Extension contributed by an installed plugin. */
+ | "plugin"
+/** Extension discovered from the current session's state directory. */
+ | "session";
 /**
  * Current status: running, disabled, failed, or starting
  */
@@ -1198,6 +1255,41 @@ export interface PlanChangedEvent {
 export interface PlanChangedData {
     operation: PlanChangedOperation;
 }
+/**
+ * Session event "session.todos_changed". Signal-only event: the agent's todos or todo_deps table was written to. No payload — clients should call session.plan.readSqlTodosWithDependencies() to fetch the current state. Events arrive in order; clients can debounce on arrival if needed.
+ */
+export interface TodosChangedEvent {
+    /**
+     * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
+     */
+    agentId?: string;
+    data: TodosChangedData;
+    /**
+     * 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.todos_changed".
+     */
+    type: "session.todos_changed";
+}
+/**
+ * Signal-only event: the agent's todos or todo_deps table was written to. No payload — clients should call session.plan.readSqlTodosWithDependencies() to fetch the current state. Events arrive in order; clients can debounce on arrival if needed.
+ */
+export interface TodosChangedData {
+}
 /**
  * Session event "session.workspace_file_changed". Workspace file change details including path and operation type
  */
@@ -2475,18 +2567,6 @@ export interface AssistantMessageEvent {
  * Assistant response containing text content, optional tool requests, and interaction metadata
  */
 export interface AssistantMessageData {
-    /**
-     * Raw Anthropic content array with advisor blocks (server_tool_use, advisor_tool_result) for verbatim round-tripping
-     *
-     * @experimental
-     */
-    anthropicAdvisorBlocks?: unknown[];
-    /**
-     * Anthropic advisor model ID used for this response, for timeline display on replay
-     *
-     * @experimental
-     */
-    anthropicAdvisorModel?: string;
     /**
      * Provider's completion / response identifier; shared across all chunks of a single API call. Used to group multi-chunk assistant utterances.
      */
@@ -2536,6 +2616,7 @@ export interface AssistantMessageData {
      * GitHub request tracing ID (x-github-request-id header) for correlating with server-side logs
      */
     requestId?: string;
+    serverTools?: AssistantMessageServerTools;
     /**
      * Copilot service request ID (x-copilot-service-request-id header) for CAPI log correlation
      */
@@ -2549,6 +2630,19 @@ export interface AssistantMessageData {
      */
     turnId?: string;
 }
+/**
+ * Neutral provider-tagged server-side tool-use payload (tool search, advisor) for verbatim round-tripping
+ */
+/** @experimental */
+export interface AssistantMessageServerTools {
+    advisorModel?: string;
+    functionCallNamespaces?: {
+        [k: string]: string | undefined;
+    };
+    items?: unknown[];
+    provider: string;
+    rawContentBlocks?: unknown[];
+}
 /**
  * A tool invocation request from the assistant
  */
@@ -2762,6 +2856,11 @@ export interface AssistantUsageData {
      * Number of tokens written to prompt cache
      */
     cacheWriteTokens?: number;
+    /**
+     * Whether the model response was blocked or truncated by content filtering (finish_reason === 'content_filter'). For Anthropic models this corresponds to a 'refusal' stop reason.
+     */
+    contentFilterTriggered?: boolean;
+    copilotUsage?: AssistantUsageCopilotUsage;
     /**
      * Model multiplier cost for billing purposes
      *
@@ -2772,6 +2871,10 @@ export interface AssistantUsageData {
      * Duration of the API call in milliseconds
      */
     duration?: number;
+    /**
+     * Finish reason reported by the model for this API call (e.g. "stop", "length", "tool_calls", "content_filter"). Normalized to OpenAI vocabulary; for Anthropic models a "refusal" stop reason maps to "content_filter".
+     */
+    finishReason?: string;
     /**
      * What initiated this API call (e.g., "sub-agent", "mcp-sampling"); absent for user-initiated calls
      */
@@ -2818,6 +2921,15 @@ export interface AssistantUsageData {
      */
     timeToFirstTokenMs?: number;
 }
+/**
+ * Per-request cost and usage data from the CAPI copilot_usage response field
+ */
+export interface AssistantUsageCopilotUsage {
+    /**
+     * Total cost in nano-AI units for this request
+     */
+    totalNanoAiu: number;
+}
 /**
  * Token usage detail for a single billing category
  */
@@ -3057,6 +3169,7 @@ export interface ToolExecutionStartData {
      * Unique identifier for this tool call
      */
     toolCallId: string;
+    toolDescription?: ToolExecutionStartToolDescription;
     /**
      * Name of the tool being executed
      */
@@ -3066,6 +3179,39 @@ export interface ToolExecutionStartData {
      */
     turnId?: string;
 }
+/**
+ * Tool definition metadata, present for MCP tools with MCP Apps support
+ */
+export interface ToolExecutionStartToolDescription {
+    _meta?: ToolExecutionStartToolDescriptionMeta;
+    /**
+     * Tool description
+     */
+    description?: string;
+    /**
+     * Tool name
+     */
+    name: string;
+}
+/**
+ * MCP Apps metadata for UI resource association
+ */
+export interface ToolExecutionStartToolDescriptionMeta {
+    ui?: ToolExecutionStartToolDescriptionMetaUI;
+}
+/**
+ * Schema for the `ToolExecutionStartToolDescriptionMetaUI` type.
+ */
+export interface ToolExecutionStartToolDescriptionMetaUI {
+    /**
+     * URI of the UI resource
+     */
+    resourceUri?: string;
+    /**
+     * Who can access this tool
+     */
+    visibility?: ToolExecutionStartToolDescriptionMetaUIVisibility[];
+}
 /**
  * Session event "tool.execution_partial_result". Streaming tool execution output for incremental result display
  */
@@ -3246,6 +3392,12 @@ export interface ToolExecutionCompleteError {
  * Tool execution result on success
  */
 export interface ToolExecutionCompleteResult {
+    /**
+     * Model-facing binary results (base64 inline or size-omitted markers) sent to the LLM for this tool call
+     *
+     * @experimental
+     */
+    binaryResultsForLlm?: PersistedBinaryResult[];
     /**
      * Concise tool result text sent to the LLM for chat completion, potentially truncated for token efficiency
      */
@@ -3258,8 +3410,93 @@ export interface ToolExecutionCompleteResult {
      * Full detailed tool result for UI/timeline display, preserving complete content such as diffs. Falls back to content when absent.
      */
     detailedContent?: string;
+    /**
+     * Structured content (arbitrary JSON) returned verbatim by the MCP tool
+     */
+    structuredContent?: {
+        [k: string]: unknown | undefined;
+    };
     uiResource?: ToolExecutionCompleteUIResource;
 }
+/**
+ * Binary result returned by a tool for the model
+ */
+export interface PersistedBinaryImage {
+    /**
+     * Base64-encoded binary data
+     */
+    data: string;
+    /**
+     * Human-readable description of the binary data
+     */
+    description?: string;
+    /**
+     * Optional metadata from the producing tool.
+     */
+    metadata?: {
+        [k: string]: unknown | undefined;
+    };
+    /**
+     * MIME type of the binary data
+     */
+    mimeType: string;
+    type: PersistedBinaryImageType;
+}
+/**
+ * A binary result whose data was omitted from persistence due to the inline size limit
+ */
+/** @experimental */
+export interface OmittedBinaryResult {
+    /**
+     * Decoded byte length of the omitted binary data
+     */
+    byteLength: number;
+    /**
+     * Human-readable description of the binary data
+     */
+    description?: string;
+    /**
+     * Optional metadata from the producing tool.
+     */
+    metadata?: {
+        [k: string]: unknown | undefined;
+    };
+    /**
+     * MIME type of the omitted binary data
+     */
+    mimeType: string;
+    omittedReason: OmittedBinaryOmittedReason;
+    type: OmittedBinaryType;
+}
+/**
+ * A reference to binary data persisted once on a session.binary_asset event and shared by id
+ */
+/** @experimental */
+export interface BinaryAssetReference {
+    /**
+     * Content-addressed id of the session.binary_asset event that holds this binary's bytes (e.g. "sha256:...").
+     */
+    assetId: string;
+    /**
+     * Decoded byte length of the referenced binary data
+     */
+    byteLength: number;
+    /**
+     * Human-readable description of the binary data
+     */
+    description?: string;
+    /**
+     * Optional metadata from the producing tool.
+     */
+    metadata?: {
+        [k: string]: unknown | undefined;
+    };
+    /**
+     * MIME type of the referenced binary data
+     */
+    mimeType: string;
+    type: BinaryAssetReferenceType;
+}
 /**
  * Plain text content block
  */
@@ -3602,7 +3839,7 @@ export interface SkillInvokedData {
      */
     pluginVersion?: string;
     /**
-     * Source identifier for where the skill was discovered. Known values include: project (workspace skill), inherited (parent-directory skill), personal-copilot (~/.copilot/skills), personal-agents (~/.agents/skills), personal-claude (~/.claude/skills), custom (configured directory), plugin (installed plugin), builtin (bundled runtime skill), and remote (org/enterprise skill)
+     * Source identifier for where the skill was discovered. Known values include: project (workspace skill), inherited (parent-directory skill), personal-copilot (~/.copilot/skills), personal-agents (~/.agents/skills), custom (configured directory), plugin (installed plugin), builtin (bundled runtime skill), and remote (org/enterprise skill)
      */
     source?: string;
     trigger?: SkillInvokedTrigger;
@@ -4037,6 +4274,69 @@ export interface HookProgressData {
      */
     temporary?: boolean;
 }
+/**
+ * Session event "session.binary_asset". Canonical bytes for a content-addressed binary asset shared by reference across events
+ */
+/** @experimental */
+export interface BinaryAssetEvent {
+    /**
+     * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
+     */
+    agentId?: string;
+    data: BinaryAssetData;
+    /**
+     * 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.binary_asset".
+     */
+    type: "session.binary_asset";
+}
+/**
+ * Canonical bytes for a content-addressed binary asset shared by reference across events
+ */
+export interface BinaryAssetData {
+    /**
+     * Content-addressed id for this binary asset (e.g. "sha256:...").
+     */
+    assetId: string;
+    /**
+     * Decoded byte length of the binary asset
+     */
+    byteLength: number;
+    /**
+     * Base64-encoded binary data
+     */
+    data: string;
+    /**
+     * Human-readable description of the binary data
+     */
+    description?: string;
+    /**
+     * Optional metadata from the producing tool.
+     */
+    metadata?: {
+        [k: string]: unknown | undefined;
+    };
+    /**
+     * MIME type of the binary asset
+     */
+    mimeType: string;
+    type: BinaryAssetType;
+}
 /**
  * Session event "system.message". System/developer instruction content with role and optional template metadata
  */
@@ -6554,7 +6854,7 @@ export interface ExtensionsLoadedData {
  */
 export interface ExtensionsLoadedExtension {
     /**
-     * Source-qualified extension ID (e.g., 'project:my-ext', 'user:auth-helper')
+     * Source-qualified extension ID (e.g., 'project:my-ext', 'user:auth-helper', 'plugin:my-plugin:my-ext')
      */
     id: string;
     /**

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, 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, UiInputOptions, MCPStdioServerConfig, MCPHTTPServerConfig, MCPServerConfig, DefaultAgentConfig, MessageOptions, ModelBilling, ModelCapabilities, ModelCapabilitiesOverride, ModelInfo, ModelPolicy, PermissionHandler, PermissionRequest, PermissionRequestResult, ProviderConfig, 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, 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, InfiniteSessionConfig, LargeToolOutputConfig, MemoryConfiguration, UiInputOptions, MCPStdioServerConfig, MCPHTTPServerConfig, MCPServerConfig, DefaultAgentConfig, MessageOptions, ModelBilling, ModelBillingTokenPrices, ModelBillingTokenPricesLongContext, ModelCapabilities, ModelCapabilitiesOverride, ModelInfo, ModelPolicy, PermissionHandler, PermissionRequest, PermissionRequestResult, ProviderConfig, 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, SystemMessageAppendConfig, SystemMessageConfig, SystemMessageCustomizeConfig, SystemMessageReplaceConfig, SystemMessageSection, TelemetryConfig, TraceContext, TraceContextProvider, Tool, ToolHandler, ToolInvocation, ToolTelemetry, ToolResultObject, TypedSessionEventHandler, TypedSessionLifecycleHandler, ZodSchema, } from "./types.js";

package/dist/session.js

@@ -33,6 +33,9 @@ class CopilotSession {
     this._workspacePath = _workspacePath;
     this.traceContextProvider = traceContextProvider;
   }
+  sessionId;
+  connection;
+  _workspacePath;
   eventHandlers = /* @__PURE__ */ new Set();
   typedEventHandlers = /* @__PURE__ */ new Map();
   toolHandlers = /* @__PURE__ */ new Map();

package/dist/types.d.ts

@@ -5,10 +5,10 @@ import type { Canvas } from "./canvas.js";
 import type { SessionFsProvider } from "./sessionFsProvider.js";
 import type { ReasoningSummary, SessionEvent as GeneratedSessionEvent } from "./generated/session-events.js";
 import type { CopilotSession } from "./session.js";
-import type { RemoteSessionMode } from "./generated/rpc.js";
-import type { OpenCanvasInstance } from "./generated/rpc.js";
+import type { ModelBillingTokenPrices, OpenCanvasInstance, RemoteSessionMode } from "./generated/rpc.js";
 import type { ToolSet } from "./toolSet.js";
 export type { RemoteSessionMode } from "./generated/rpc.js";
+export type { ModelBillingTokenPrices, ModelBillingTokenPricesLongContext, } from "./generated/rpc.js";
 export type SessionEvent = GeneratedSessionEvent;
 export type { ReasoningSummary } from "./generated/session-events.js";
 export type { SessionFsProvider } from "./sessionFsProvider.js";
@@ -43,6 +43,8 @@ export type TraceContextProvider = () => TraceContext | Promise<TraceContext>;
 export interface TelemetryConfig {
     /** OTLP HTTP endpoint URL for trace/metric export. Sets OTEL_EXPORTER_OTLP_ENDPOINT. */
     otlpEndpoint?: string;
+    /** OTLP HTTP protocol for all signals. Sets OTEL_EXPORTER_OTLP_PROTOCOL. */
+    otlpProtocol?: "http/json" | "http/protobuf";
     /** File path for JSON-lines trace output. Sets COPILOT_OTEL_FILE_EXPORTER_PATH. */
     filePath?: string;
     /** Exporter backend type: "otlp-http" or "file". Sets COPILOT_OTEL_EXPORTER_TYPE. */
@@ -370,6 +372,13 @@ export interface Tool<TArgs = unknown> {
      * When true, the tool can execute without a permission prompt.
      */
     skipPermission?: boolean;
+    /**
+     * Controls whether the tool may be deferred (loaded lazily via tool search)
+     * rather than always pre-loaded. When `"auto"`, the tool can be deferred and
+     * surfaced through tool search. When `"never"`, the tool is always pre-loaded.
+     * Optional; defaults to `"auto"`.
+     */
+    defer?: "auto" | "never";
 }
 /**
  * Helper to define a tool with Zod schema and get type inference for the handler.
@@ -381,6 +390,7 @@ export declare function defineTool<T = unknown>(name: string, config: {
     handler?: ToolHandler<T>;
     overridesBuiltInTool?: boolean;
     skipPermission?: boolean;
+    defer?: "auto" | "never";
 }): Tool<T>;
 /**
  * Context passed to a command handler when a command is executed.
@@ -1199,6 +1209,16 @@ export interface InfiniteSessionConfig {
      */
     bufferExhaustionThreshold?: number;
 }
+/**
+ * Configuration for the memory feature, which lets the agent persist and recall
+ * information across turns.
+ */
+export interface MemoryConfiguration {
+    /**
+     * Whether the memory feature is enabled for this session.
+     */
+    enabled: boolean;
+}
 /**
  * Configuration for handling large tool outputs.
  *
@@ -1566,6 +1586,10 @@ export interface SessionConfigBase {
      * Set to `{ enabled: false }` to disable.
      */
     infiniteSessions?: InfiniteSessionConfig;
+    /**
+     * Memory configuration for the session. When omitted, the runtime default applies.
+     */
+    memory?: MemoryConfiguration;
     /**
      * GitHub token for per-session authentication.
      * When provided, the runtime resolves this token into a full GitHub identity
@@ -1964,7 +1988,10 @@ export interface ModelPolicy {
  * Model billing information
  */
 export interface ModelBilling {
+    /** Billing cost multiplier relative to the base rate */
     multiplier?: number;
+    /** Token-level pricing information for this model */
+    tokenPrices?: ModelBillingTokenPrices;
 }
 /**
  * Information about an available model