@github/copilot-sdk 1.0.0-beta.9 → 1.0.1

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 | McpAppToolCallCompleteEvent;
+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;
 /**
  * Hosting platform type of the repository (github or ado)
  */
@@ -14,6 +14,14 @@ export type WorkingDirectoryContextHostType =
 "github"
 /** Repository is hosted on Azure DevOps. */
  | "ado";
+/**
+ * Allowed values for the `ContextTier` enumeration.
+ */
+export type ContextTier = 
+/** Default context tier with standard context window size. */
+"default"
+/** Extended context tier with a larger context window. */
+ | "long_context";
 /**
  * Reasoning summary mode used for model calls, if applicable (e.g. "none", "concise", "detailed")
  */
@@ -103,13 +111,13 @@ export type UserMessageAgentMode =
 /** The agent is in shell-focused UI mode. */
  | "shell";
 /**
- * A user message attachment — a file, directory, code selection, blob, or GitHub reference
+ * A user message attachment — a file, directory, code selection, blob, GitHub reference, or extension-supplied context payload
  */
-export type UserMessageAttachment = UserMessageAttachmentFile | UserMessageAttachmentDirectory | UserMessageAttachmentSelection | UserMessageAttachmentGithubReference | UserMessageAttachmentBlob;
+export type Attachment = AttachmentFile | AttachmentDirectory | AttachmentSelection | AttachmentGitHubReference | AttachmentBlob | AttachmentExtensionContext;
 /**
  * Type of GitHub reference
  */
-export type UserMessageAttachmentGithubReferenceType = 
+export type AttachmentGitHubReferenceType = 
 /** GitHub issue reference. */
 "issue"
 /** GitHub pull request reference. */
@@ -427,6 +435,10 @@ export interface StartData {
      */
     alreadyInUse?: boolean;
     context?: WorkingDirectoryContext;
+    /**
+     * Context tier selected at session creation time for models with tiered context pricing; null when no tier is selected (e.g., non-tiered model)
+     */
+    contextTier?: ContextTier | null;
     /**
      * Version string of the Copilot application
      */
@@ -538,6 +550,10 @@ export interface ResumeData {
      */
     alreadyInUse?: boolean;
     context?: WorkingDirectoryContext;
+    /**
+     * Context tier currently selected at resume time; null when no tier is active
+     */
+    contextTier?: ContextTier | null;
     /**
      * When true, tool calls and permission requests left in flight by the previous session lifetime remain pending after resume and the agentic loop awaits their results. User sends are queued behind the pending work until all such requests reach a terminal state. When false (the default), any such tool calls and permission requests are immediately marked as interrupted on resume.
      */
@@ -546,6 +562,10 @@ export interface ResumeData {
      * Total number of persisted events in the session at the time of resume
      */
     eventCount: number;
+    /**
+     * On-disk byte size of the session's persisted events.jsonl file at resume time; omitted when the file does not exist or cannot be stat'd
+     */
+    eventsFileSizeBytes?: number;
     /**
      * Reasoning effort level used for model calls, if applicable (e.g. "none", "low", "medium", "high", "xhigh", "max")
      */
@@ -679,7 +699,7 @@ export interface ErrorData {
     url?: string;
 }
 /**
- * Session event "session.idle". Payload indicating the session is idle with no background agents in flight
+ * Session event "session.idle". Payload indicating the session is idle with no background agents or attached shell commands in flight
  */
 export interface IdleEvent {
     /**
@@ -709,7 +729,7 @@ export interface IdleEvent {
     type: "session.idle";
 }
 /**
- * Payload indicating the session is idle with no background agents in flight
+ * Payload indicating the session is idle with no background agents or attached shell commands in flight
  */
 export interface IdleData {
     /**
@@ -790,6 +810,14 @@ export interface ScheduleCreatedEvent {
  * Scheduled prompt registered via /every or /after
  */
 export interface ScheduleCreatedData {
+    /**
+     * Absolute fire time (epoch milliseconds) for a one-shot calendar schedule
+     */
+    at?: number;
+    /**
+     * 5-field cron expression for a recurring calendar schedule, evaluated in `tz`
+     */
+    cron?: string;
     /**
      * Optional user-facing label shown in the timeline instead of the actual prompt (e.g. `/skill-name args` when the prompt is a skill invocation expansion)
      */
@@ -799,9 +827,9 @@ export interface ScheduleCreatedData {
      */
     id: number;
     /**
-     * Interval between ticks in milliseconds
+     * Interval between ticks in milliseconds (relative-interval schedules)
      */
-    intervalMs: number;
+    intervalMs?: number;
     /**
      * Prompt text that gets enqueued on every tick
      */
@@ -810,6 +838,10 @@ export interface ScheduleCreatedData {
      * Whether the schedule re-arms after each tick (`/every`) or fires once (`/after`)
      */
     recurring?: boolean;
+    /**
+     * IANA timezone the `cron` expression is evaluated in
+     */
+    tz?: string;
 }
 /**
  * Session event "session.schedule_cancelled". Scheduled prompt cancelled from the schedule manager dialog
@@ -1030,9 +1062,7 @@ export interface ModelChangeData {
     /**
      * Context tier after the model change; null explicitly clears a previously selected tier
      */
-    contextTier?: "default"
-    /** Extended context tier with a larger context window. */
-     | "long_context" | null;
+    contextTier?: ContextTier | null;
     /**
      * Newly selected model identifier
      */
@@ -1443,6 +1473,10 @@ export interface ShutdownData {
      * Error description when shutdownType is "error"
      */
     errorReason?: string;
+    /**
+     * On-disk byte size of the session's persisted events.jsonl file at shutdown time; omitted when the file does not exist or cannot be stat'd
+     */
+    eventsFileSizeBytes?: number;
     /**
      * Per-model usage breakdown, keyed by model identifier
      */
@@ -1946,7 +1980,7 @@ export interface UserMessageData {
     /**
      * Files, selections, or GitHub references attached to the message
      */
-    attachments?: UserMessageAttachment[];
+    attachments?: Attachment[];
     /**
      * The user's message text as displayed in the timeline
      */
@@ -1983,12 +2017,12 @@ export interface UserMessageData {
 /**
  * File attachment
  */
-export interface UserMessageAttachmentFile {
+export interface AttachmentFile {
     /**
      * User-facing display name for the attachment
      */
     displayName: string;
-    lineRange?: UserMessageAttachmentFileLineRange;
+    lineRange?: AttachmentFileLineRange;
     /**
      * Absolute file path
      */
@@ -2001,7 +2035,7 @@ export interface UserMessageAttachmentFile {
 /**
  * Optional line range to scope the attachment to a specific section of the file
  */
-export interface UserMessageAttachmentFileLineRange {
+export interface AttachmentFileLineRange {
     /**
      * End line number (1-based, inclusive)
      */
@@ -2014,7 +2048,7 @@ export interface UserMessageAttachmentFileLineRange {
 /**
  * Directory attachment
  */
-export interface UserMessageAttachmentDirectory {
+export interface AttachmentDirectory {
     /**
      * User-facing display name for the attachment
      */
@@ -2031,7 +2065,7 @@ export interface UserMessageAttachmentDirectory {
 /**
  * Code selection attachment from an editor
  */
-export interface UserMessageAttachmentSelection {
+export interface AttachmentSelection {
     /**
      * User-facing display name for the selection
      */
@@ -2040,7 +2074,7 @@ export interface UserMessageAttachmentSelection {
      * Absolute path to the file containing the selection
      */
     filePath: string;
-    selection: UserMessageAttachmentSelectionDetails;
+    selection: AttachmentSelectionDetails;
     /**
      * The selected text content
      */
@@ -2053,14 +2087,14 @@ export interface UserMessageAttachmentSelection {
 /**
  * Position range of the selection within the file
  */
-export interface UserMessageAttachmentSelectionDetails {
-    end: UserMessageAttachmentSelectionDetailsEnd;
-    start: UserMessageAttachmentSelectionDetailsStart;
+export interface AttachmentSelectionDetails {
+    end: AttachmentSelectionDetailsEnd;
+    start: AttachmentSelectionDetailsStart;
 }
 /**
  * End position of the selection
  */
-export interface UserMessageAttachmentSelectionDetailsEnd {
+export interface AttachmentSelectionDetailsEnd {
     /**
      * End character offset within the line (0-based)
      */
@@ -2073,7 +2107,7 @@ export interface UserMessageAttachmentSelectionDetailsEnd {
 /**
  * Start position of the selection
  */
-export interface UserMessageAttachmentSelectionDetailsStart {
+export interface AttachmentSelectionDetailsStart {
     /**
      * Start character offset within the line (0-based)
      */
@@ -2086,12 +2120,12 @@ export interface UserMessageAttachmentSelectionDetailsStart {
 /**
  * GitHub issue, pull request, or discussion reference
  */
-export interface UserMessageAttachmentGithubReference {
+export interface AttachmentGitHubReference {
     /**
      * Issue, pull request, or discussion number
      */
     number: number;
-    referenceType: UserMessageAttachmentGithubReferenceType;
+    referenceType: AttachmentGitHubReferenceType;
     /**
      * Current state of the referenced item (e.g., open, closed, merged)
      */
@@ -2112,7 +2146,7 @@ export interface UserMessageAttachmentGithubReference {
 /**
  * Blob attachment with inline base64-encoded data
  */
-export interface UserMessageAttachmentBlob {
+export interface AttachmentBlob {
     /**
      * Base64-encoded content
      */
@@ -2130,6 +2164,41 @@ export interface UserMessageAttachmentBlob {
      */
     type: "blob";
 }
+/**
+ * Structured context contributed by an extension. Composer pills displayed in the host are forwarded back through session.send.attachments, then rendered into the model prompt as an <extension_context> XML block.
+ */
+export interface AttachmentExtensionContext {
+    /**
+     * Provider-local canvas identifier when the push was bound to a canvas instance
+     */
+    canvasId?: string;
+    /**
+     * ISO 8601 timestamp captured by the runtime when the push was accepted
+     */
+    capturedAt: string;
+    /**
+     * Owning extension identifier. Runtime-derived from the caller's connection when produced via session.extensions.sendAttachmentsToMessage; preserved verbatim on subsequent transports.
+     */
+    extensionId: string;
+    /**
+     * Open canvas instance identifier when the push was bound to a canvas instance
+     */
+    instanceId?: string;
+    /**
+     * Caller-supplied JSON payload
+     */
+    payload?: {
+        [k: string]: unknown | undefined;
+    };
+    /**
+     * Human-readable composer pill label
+     */
+    title: string;
+    /**
+     * Attachment type discriminator
+     */
+    type: "extension_context";
+}
 /**
  * Session event "pending_messages.modified". Empty payload; the event signals that the pending message queue has changed
  */
@@ -2418,6 +2487,10 @@ export interface AssistantMessageData {
      * @experimental
      */
     anthropicAdvisorModel?: string;
+    /**
+     * Provider's completion / response identifier; shared across all chunks of a single API call. Used to group multi-chunk assistant utterances.
+     */
+    apiCallId?: string;
     /**
      * The assistant's text response content
      */
@@ -2971,6 +3044,10 @@ export interface ToolExecutionStartData {
      * Original tool name on the MCP server, when the tool is an MCP tool
      */
     mcpToolName?: string;
+    /**
+     * Model identifier that generated this tool call
+     */
+    model?: string;
     /**
      * @deprecated
      * Tool call ID of the parent tool invocation when this event originates from a sub-agent
@@ -3577,7 +3654,7 @@ export interface SubagentStartedData {
      */
     agentName: string;
     /**
-     * Model the sub-agent will run with, when known at start. Surfaced in the timeline for auto-selected sub-agents (e.g. rubber-duck).
+     * Model the sub-agent will run with, when known at start.
      */
     model?: string;
     /**
@@ -3699,7 +3776,7 @@ export interface SubagentFailedData {
      */
     error: string;
     /**
-     * Model used by the sub-agent (if any model calls succeeded before failure)
+     * Model selected for the sub-agent, when known
      */
     model?: string;
     /**
@@ -3908,6 +3985,10 @@ export interface HookEndError {
      * Human-readable error message
      */
     message: string;
+    /**
+     * Source label of the hook that errored (e.g. the plugin it was loaded from), when known
+     */
+    source?: string;
     /**
      * Error stack trace, when available
      */
@@ -3951,6 +4032,10 @@ export interface HookProgressData {
      * Human-readable progress message from the hook process
      */
     message: string;
+    /**
+     * When true, this status message replaces the previous temporary one instead of accumulating
+     */
+    temporary?: boolean;
 }
 /**
  * Session event "system.message". System/developer instruction content with role and optional template metadata
@@ -6646,6 +6731,92 @@ export interface CanvasRegistryChangedCanvasAction {
      */
     name: string;
 }
+/**
+ * Session event "session.canvas.closed".
+ */
+export interface CanvasClosedEvent {
+    /**
+     * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
+     */
+    agentId?: string;
+    data: CanvasClosedData;
+    /**
+     * 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.canvas.closed".
+     */
+    type: "session.canvas.closed";
+}
+/**
+ * Schema for the `CanvasClosedData` type.
+ */
+export interface CanvasClosedData {
+    /**
+     * Provider-local canvas identifier
+     */
+    canvasId: string;
+    /**
+     * Owning provider identifier
+     */
+    extensionId: string;
+    /**
+     * Stable caller-supplied identifier of the canvas instance that was closed
+     */
+    instanceId: string;
+}
+/**
+ * Session event "session.extensions.attachments_pushed".
+ */
+export interface ExtensionsAttachmentsPushedEvent {
+    /**
+     * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
+     */
+    agentId?: string;
+    data: ExtensionsAttachmentsPushedData;
+    /**
+     * 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.extensions.attachments_pushed".
+     */
+    type: "session.extensions.attachments_pushed";
+}
+/**
+ * Schema for the `ExtensionsAttachmentsPushedData` type.
+ */
+export interface ExtensionsAttachmentsPushedData {
+    /**
+     * Attachments contributed by an extension; the host should surface these as composer pills and forward them via the next session.send call.
+     */
+    attachments: Attachment[];
+}
 /**
  * Session event "mcp_app.tool_call_complete". MCP App view called a tool on a connected MCP server (SEP-1865)
  */

package/dist/index.d.ts

@@ -7,7 +7,7 @@ export { CopilotClient } from "./client.js";
 export { RuntimeConnection } from "./types.js";
 export { BuiltInTools, ToolSet } from "./toolSet.js";
 export { CopilotSession, type AssistantMessageEvent } from "./session.js";
-export { Canvas, CanvasError, createCanvas, type CanvasAction, type CanvasDeclaration, type CanvasHostContext, type CanvasJsonSchema, type CanvasOptions, } from "./canvas.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, 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, 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";

package/dist/session.d.ts

@@ -1,6 +1,6 @@
 import { createSessionRpc } from "./generated/rpc.js";
 import type { OpenCanvasInstance } from "./generated/rpc.js";
-import type { MessageOptions, ReasoningEffort, ModelCapabilitiesOverride, SessionCapabilities, SessionEvent, SessionEventHandler, SessionEventType, SessionUiApi, TypedSessionEventHandler } from "./types.js";
+import type { MessageOptions, ContextTier, ReasoningEffort, ReasoningSummary, ModelCapabilitiesOverride, SessionCapabilities, SessionEvent, SessionEventHandler, SessionEventType, SessionUiApi, TypedSessionEventHandler } from "./types.js";
 /** Assistant message event - the final response from the assistant. */
 export type AssistantMessageEvent = Extract<SessionEvent, {
     type: "assistant.message";
@@ -169,11 +169,15 @@ export declare class CopilotSession {
      * ```
      */
     on(handler: SessionEventHandler): () => void;
+    private upsertOpenCanvasFromEvent;
+    private removeOpenCanvasFromEvent;
+    private removeOpenCanvas;
+    private upsertOpenCanvas;
     /**
-     * Snapshot of canvas instances that were already open when the session was
-     * resumed. Populated from the `session.resume` response; empty for freshly
-     * created sessions. Returns a defensive copy — mutating the returned array
-     * has no effect on the session.
+     * Snapshot of canvas instances currently known to be open for this session.
+     * Populated from the `session.resume` response and live `session.canvas.opened`
+     * and `session.canvas.closed` events. Returns a defensive copy — mutating the
+     * returned array has no effect on the session.
      */
     get openCanvases(): OpenCanvasInstance[];
     private assertElicitation;
@@ -261,6 +265,8 @@ export declare class CopilotSession {
      */
     setModel(model: string, options?: {
         reasoningEffort?: ReasoningEffort;
+        reasoningSummary?: ReasoningSummary;
+        contextTier?: ContextTier;
         modelCapabilities?: ModelCapabilitiesOverride;
     }): Promise<void>;
     /**

package/dist/session.js

@@ -10,6 +10,13 @@ function deserializeHookInput(raw) {
   const { cwd, ...rest } = obj;
   return { ...rest, timestamp: new Date(obj.timestamp), workingDirectory: cwd };
 }
+function isOpenCanvasInstance(value) {
+  if (!value || typeof value !== "object") {
+    return false;
+  }
+  const instance = value;
+  return typeof instance.instanceId === "string" && instance.instanceId.length > 0 && typeof instance.extensionId === "string" && instance.extensionId.length > 0 && typeof instance.canvasId === "string" && instance.canvasId.length > 0 && typeof instance.reopen === "boolean" && (instance.availability === "ready" || instance.availability === "stale");
+}
 class CopilotSession {
   /**
    * Creates a new CopilotSession instance.
@@ -94,6 +101,7 @@ class CopilotSession {
       ...await getTraceContext(this.traceContextProvider),
       sessionId: this.sessionId,
       prompt: options.prompt,
+      displayPrompt: options.displayPrompt,
       attachments: options.attachments,
       mode: options.mode,
       agentMode: options.agentMode,
@@ -243,6 +251,39 @@ class CopilotSession {
       }
     } else if (event.type === "capabilities.changed") {
       this._capabilities = { ...this._capabilities, ...event.data };
+    } else if (event.type === "session.canvas.opened") {
+      this.upsertOpenCanvasFromEvent(event.data);
+    } else if (event.type === "session.canvas.closed") {
+      this.removeOpenCanvasFromEvent(event.data);
+    }
+  }
+  upsertOpenCanvasFromEvent(data) {
+    if (!isOpenCanvasInstance(data)) {
+      console.warn("failed to deserialize session.canvas.opened payload");
+      return;
+    }
+    this.upsertOpenCanvas(data);
+  }
+  removeOpenCanvasFromEvent(data) {
+    if (!data || typeof data !== "object" || typeof data.instanceId !== "string" || data.instanceId.length === 0) {
+      console.warn("failed to deserialize session.canvas.closed payload");
+      return;
+    }
+    this.removeOpenCanvas(data.instanceId);
+  }
+  removeOpenCanvas(instanceId) {
+    this.openCanvasInstances = this.openCanvasInstances.filter(
+      (open) => open.instanceId !== instanceId
+    );
+  }
+  upsertOpenCanvas(instance) {
+    const index = this.openCanvasInstances.findIndex(
+      (open) => open.instanceId === instance.instanceId
+    );
+    if (index >= 0) {
+      this.openCanvasInstances[index] = instance;
+    } else {
+      this.openCanvasInstances.push(instance);
     }
   }
   /**
@@ -409,7 +450,7 @@ class CopilotSession {
           throw toCanvasRpcError(error);
         }
       },
-      async invokeAction(params) {
+      async invoke(params) {
         const canvas = self.canvases.get(params.canvasId);
         if (!canvas) throw new Error(`No canvas registered with id "${params.canvasId}"`);
         const handler = canvas.actionHandlers.get(params.actionName);
@@ -524,10 +565,10 @@ class CopilotSession {
     this._capabilities = capabilities ?? {};
   }
   /**
-   * Snapshot of canvas instances that were already open when the session was
-   * resumed. Populated from the `session.resume` response; empty for freshly
-   * created sessions. Returns a defensive copy — mutating the returned array
-   * has no effect on the session.
+   * Snapshot of canvas instances currently known to be open for this session.
+   * Populated from the `session.resume` response and live `session.canvas.opened`
+   * and `session.canvas.closed` events. Returns a defensive copy — mutating the
+   * returned array has no effect on the session.
    */
   get openCanvases() {
     return [...this.openCanvasInstances];