@github/copilot-sdk 1.0.29-preview.0 → 1.0.29-preview.2

package/dist/generated/rpc.d.ts

@@ -5701,6 +5701,18 @@ export type SessionLimitPredictionUnavailableReason =
  */
 /** @experimental */
 export type SessionListEntry = LocalSessionMetadataValue | RemoteSessionMetadataValue;
+/**
+ * Peer boundary evaluated in the process hosting the native session.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SessionManagementScope".
+ */
+/** @experimental */
+export type SessionManagementScope = 
+/** Eligible local peers sharing the resolved configuration directory. */
+"all"
+/** Only peers hosted in this native runtime process. */
+ | "in-process";
 /**
  * Public-facing workspace metadata for this session, or null if the session has no associated workspace. Excludes runtime-internal fields (GitHub IDs, summary count, internal flags).
  *
@@ -5874,7 +5886,7 @@ export type SessionsOpenProgressStep =
 "load-session"
 /** Validating that the local repository matches the remote session's repository. */
  | "validate-repo"
-/** Checking the local working tree for uncommitted changes that would block the handoff. */
+/** Checking the local working tree for uncommitted changes, which stay in place and are carried onto the checked-out branch. */
  | "check-changes"
 /** Checking out the branch associated with the remote session in the local working tree. */
  | "checkout-branch"
@@ -8716,7 +8728,7 @@ export interface AgentsDiscoverRequest {
      */
     agentDirectories?: string[];
     /**
-     * Optional list of project directory paths to scan for project-scoped agents. When omitted or empty, only user/plugin/remote-independent agents are returned (no project scan).
+     * Optional list of project directory paths to scan for project-scoped agents. When omitted or empty, no project is scanned: user-level and globally enabled plugin agents are still returned, but agents of a plugin enabled only in a repository's settings are not.
      */
     projectPaths?: string[];
     /**
@@ -9170,6 +9182,19 @@ export interface AutopilotObjectiveState {
      */
     creditLimit?: AutopilotObjectiveCreditLimit;
 }
+/**
+ * Client-resolved preference for retaining autopilot mode after objective completion or pause.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "AutopilotObjectiveSetStayInAutopilotRequest".
+ */
+/** @experimental */
+export interface AutopilotObjectiveSetStayInAutopilotRequest {
+    /**
+     * Whether an objective's requested return to interactive mode is suppressed.
+     */
+    value: boolean;
+}
 /** @experimental */
 export interface AutopilotOptions {
     /**
@@ -17740,6 +17765,43 @@ export interface ManagedPluginRetryEntry {
      */
     error?: string;
 }
+/**
+ * An opted-in local session, reported by its live owner.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "ManagedSessionInfo".
+ */
+/** @experimental */
+export interface ManagedSessionInfo {
+    /**
+     * Live peer's session identifier.
+     */
+    sessionId: string;
+    /**
+     * Human-readable peer name.
+     */
+    name: string;
+    /**
+     * Peer's current working directory.
+     */
+    cwd: string;
+    /**
+     * Peer's local session-state directory containing events.jsonl, when known.
+     */
+    sessionStatePath?: string;
+    /**
+     * Either idle or busy. A busy session may still accept messages.
+     */
+    state: string;
+    /**
+     * Peer's selected model, when known.
+     */
+    model?: string;
+    /**
+     * The session that created this root through session management, if any.
+     */
+    parentSessionId?: string;
+}
 /**
  * Lock state and provenance of one managed setting.
  *
@@ -23901,6 +23963,24 @@ export interface PermissionRulesSet {
      */
     denied: PermissionRule[];
 }
+/**
+ * Available permission modes, derived from current session policy.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "PermissionsCapabilities".
+ */
+/** @experimental */
+export interface PermissionsCapabilities {
+    /**
+     * Whether LLM-assisted approval is enabled for this session.
+     */
+    assistedApproval: boolean;
+    /**
+     * Whether managed policy currently permits unconditional approval.
+     * Stays true while managed policy is still resolving.
+     */
+    bypassPermissions: boolean;
+}
 /**
  * No parameters.
  *
@@ -25286,6 +25366,19 @@ export interface ProviderSessionToken {
      */
     expiresAt?: string;
 }
+/**
+ * Credential-free provider configuration status for the selected model.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "ProviderStatus".
+ */
+/** @experimental */
+export interface ProviderStatus {
+    /**
+     * Whether the selected model uses a custom provider instead of requiring GitHub authentication.
+     */
+    hasCustomProvider: boolean;
+}
 /**
  * Authoritative BYOK provider and model registry snapshot to apply atomically to the session.
  *
@@ -29063,6 +29156,282 @@ export interface SessionManagedSettings {
      */
     permissions?: SessionManagedPermissions;
 }
+/**
+ * Closes one live opted-in descendant without deleting its saved history or closing its children.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SessionManagementCloseRequest".
+ */
+/** @experimental */
+export interface SessionManagementCloseRequest {
+    /**
+     * Live created descendant whose owning host should close it.
+     */
+    targetSessionId: string;
+}
+/**
+ * Completion of the existing non-deleting close lifecycle.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SessionManagementCloseResult".
+ */
+/** @experimental */
+export interface SessionManagementCloseResult {
+    /**
+     * True after the owning host has completed the existing session-close lifecycle.
+     */
+    closed: boolean;
+}
+/**
+ * Updates the session's live policy without changing persistent host settings.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SessionManagementConfigureRequest".
+ */
+/** @experimental */
+export interface SessionManagementConfigureRequest {
+    /**
+     * Expected workspace for host activation. Required when enabling an interactive CLI session.
+     */
+    cwd?: string;
+    /**
+     * Enabling resets all session management operations to enabled, then applies overrides.
+     */
+    enabled?: boolean;
+    /**
+     * Peer boundary. Preserved when the master switch changes.
+     */
+    scope?: SessionManagementScope;
+    /**
+     * Individual tool overrides, applied after the master switch.
+     */
+    tools?: SessionManagementToolOverrides;
+    /**
+     * Bind creation to this SDK connection's sessionManagement.create callback.
+     */
+    hasCreateHandler?: boolean;
+}
+/**
+ * Per-operation overrides for an enabled session management policy.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SessionManagementToolOverrides".
+ */
+/** @experimental */
+export interface SessionManagementToolOverrides {
+    /**
+     * Allow discovering eligible peer sessions.
+     */
+    list?: boolean;
+    /**
+     * Allow requesting an independent session from the owning host.
+     */
+    create?: boolean;
+    /**
+     * Allow delivering peer text to another eligible session.
+     */
+    message?: boolean;
+    /**
+     * Allow closing this session's live created descendants.
+     */
+    close?: boolean;
+}
+/**
+ * Host callback. The host owns workspace records, UI, approval routing and cleanup.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SessionManagementCreateHostRequest".
+ */
+/** @experimental */
+export interface SessionManagementCreateHostRequest {
+    /**
+     * Target session identifier
+     */
+    sessionId: string;
+    /**
+     * The originating session; the host must not escalate its permissions.
+     */
+    parentSessionId: string;
+    /**
+     * Runtime-allocated identity. The host must create a fresh session with this exact ID.
+     */
+    newSessionId: string;
+    /**
+     * The new session must use this workspace and configuration directory.
+     */
+    cwd: string;
+    /**
+     * Parent's resolved configuration directory, which the host must preserve.
+     */
+    configDir: string;
+    /**
+     * Must not be broadened by the creating host.
+     */
+    permissionMode: PermissionMode;
+    /**
+     * Effective model to apply when creating the child.
+     */
+    model?: string;
+    /**
+     * Provider owning the effective model, when specified.
+     */
+    providerId?: string;
+    /**
+     * Effective reasoning effort, when specified.
+     */
+    reasoningEffort?: string;
+    /**
+     * Effective model-supported context tier, when specified.
+     */
+    contextTier?: ContextTier;
+    /**
+     * The host must preserve the parent's current model restrictions.
+     */
+    allowedModels?: string[];
+    /**
+     * Optional short name supplied for the independent session.
+     */
+    name?: string;
+}
+/**
+ * Requests a separate session. Omitted launch options inherit the caller's current configuration.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SessionManagementCreateRequest".
+ */
+/** @experimental */
+export interface SessionManagementCreateRequest {
+    /**
+     * Initial task, delivered as peer text after successful creation.
+     */
+    prompt: string;
+    /**
+     * Optional short name for the independent session.
+     */
+    name?: string;
+    /**
+     * Absolute working directory. Defaults to the parent's current directory.
+     */
+    cwd?: string;
+    /**
+     * Optional model override; omission uses the parent's current model.
+     */
+    model?: string;
+    /**
+     * Optional effort supported by the selected model.
+     */
+    reasoningEffort?: string;
+    /**
+     * Uses the selected model's supported default or long-context tier, not an arbitrary token count.
+     */
+    contextTier?: ContextTier;
+}
+/**
+ * Identifies a session owned and supervised by the creating host.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SessionManagementCreateResult".
+ */
+/** @experimental */
+export interface SessionManagementCreateResult {
+    /**
+     * Runtime-allocated identifier of the newly created session.
+     */
+    sessionId: string;
+}
+/**
+ * Lists opted-in local peers. The caller is omitted.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SessionManagementListRequest".
+ */
+/** @experimental */
+export interface SessionManagementListRequest {
+    /**
+     * Optional exact working-directory filter.
+     */
+    cwd?: string;
+}
+/**
+ * Eligible live peers reported by their owning runtimes.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SessionManagementListResult".
+ */
+/** @experimental */
+export interface SessionManagementListResult {
+    /**
+     * Matching peers, excluding the caller.
+     */
+    sessions: ManagedSessionInfo[];
+}
+/**
+ * Sends peer text, never human approval, to another opted-in session.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SessionManagementMessageRequest".
+ */
+/** @experimental */
+export interface SessionManagementMessageRequest {
+    /**
+     * Eligible live peer that should receive the message.
+     */
+    targetSessionId: string;
+    /**
+     * Nonempty UTF-8 text, at most 16 KiB.
+     */
+    message: string;
+}
+/**
+ * Acceptance is not a completed turn or a reply.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SessionManagementMessageResult".
+ */
+/** @experimental */
+export interface SessionManagementMessageResult {
+    /**
+     * True when the destination has accepted the peer message.
+     */
+    accepted: boolean;
+    /**
+     * Destination title captured by the receiving runtime at message admission.
+     */
+    targetSessionName?: string;
+}
+/**
+ * Opt-in policy for local session management.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SessionManagementPolicy".
+ */
+/** @experimental */
+export interface SessionManagementPolicy {
+    /**
+     * Master switch. Off by default.
+     */
+    enabled: boolean;
+    /**
+     * Discovery and direct access boundary. Defaults to all eligible local peers.
+     */
+    scope: SessionManagementScope;
+    /**
+     * Allow listing opted-in sessions in this configuration directory.
+     */
+    list: boolean;
+    /**
+     * Allow requesting a new session from the owning host.
+     */
+    create: boolean;
+    /**
+     * Allow sending a peer message to another opted-in session.
+     */
+    message: boolean;
+    /**
+     * Allow closing sessions created by this session or its descendants. On by default.
+     */
+    close: boolean;
+}
 /**
  * Records which IDE the host is connected to, or clears it.
  *
@@ -36548,7 +36917,7 @@ export interface WorkspacesStatFileResult {
 /** @experimental */
 export interface WorkspacesTruncateSummariesRequest {
     /**
-     * Number of newest summaries to keep.
+     * Highest checkpoint number to keep. Checkpoints 1 through keepCount (the oldest) are kept and every later checkpoint is deleted; 0 deletes all.
      */
     keepCount: number;
 }
@@ -38805,6 +39174,49 @@ export declare function createServerRpc(connection: MessageConnection): {
 };
 /** Create typed session-scoped RPC methods. */
 export declare function createSessionRpc(connection: MessageConnection, sessionId: string): {
+    /** @experimental */
+    management: {
+        /**
+         * Updates opt-in session management policy live. Enabling the master enables all tools before applying individual overrides. Opt-in is scoped to the session's configuration directory.
+         *
+         * @param params Updates the session's live policy without changing persistent host settings.
+         *
+         * @returns Opt-in policy for local session management.
+         */
+        configure: (params: SessionManagementConfigureRequest) => Promise<SessionManagementPolicy>;
+        /**
+         * Lists other live, opted-in sessions in the same configuration directory. Requires the list tool to be enabled.
+         *
+         * @param params Lists opted-in local peers. The caller is omitted.
+         *
+         * @returns Eligible live peers reported by their owning runtimes.
+         */
+        list: (params: SessionManagementListRequest) => Promise<SessionManagementListResult>;
+        /**
+         * Injects peer text into an opted-in session. Wakes an idle agent and safely queues delivery to a busy agent. Acceptance does not imply an answer or completed task.
+         *
+         * @param params Sends peer text, never human approval, to another opted-in session.
+         *
+         * @returns Acceptance is not a completed turn or a reply.
+         */
+        message: (params: SessionManagementMessageRequest) => Promise<SessionManagementMessageResult>;
+        /**
+         * Asks the owning host to create and supervise a separate session, preserving permissions and model restrictions. Omitted model, reasoning effort, context tier and cwd inherit the caller's current values; explicit overrides use normal model validation and workspace trust. Records durable creation lineage before delivering the initial task as peer text. Returns the new session ID, not task completion. Requires the create tool and a host creation handler.
+         *
+         * @param params Requests a separate session. Omitted launch options inherit the caller's current configuration.
+         *
+         * @returns Identifies a session owned and supervised by the creating host.
+         */
+        create: (params: SessionManagementCreateRequest) => Promise<SessionManagementCreateResult>;
+        /**
+         * Closes a live opted-in session created by the caller or one of its descendants, preserving saved history and leaving descendants open. Requires the close capability to be enabled. Self, ancestors, siblings and unrelated sessions cannot be closed.
+         *
+         * @param params Closes one live opted-in descendant without deleting its saved history or closing its children.
+         *
+         * @returns Completion of the existing non-deleting close lifecycle.
+         */
+        close: (params: SessionManagementCloseRequest) => Promise<SessionManagementCloseResult>;
+    };
     /** @experimental */
     providers: {
         /**
@@ -39443,6 +39855,12 @@ export declare function createSessionRpc(connection: MessageConnection, sessionI
          * @returns Canonical runtime state for the session's current autopilot objective.
          */
         getState: () => Promise<AutopilotObjectiveGetStateResult>;
+        /**
+         * Sets whether completing or pausing this session's objective preserves autopilot mode. This in-memory preference defaults to false and must be reapplied when attaching a client.
+         *
+         * @param params Client-resolved preference for retaining autopilot mode after objective completion or pause.
+         */
+        setStayInAutopilot: (params: AutopilotObjectiveSetStayInAutopilotRequest) => Promise<void>;
     };
     /** @experimental */
     completions: {
@@ -40182,6 +40600,12 @@ export declare function createSessionRpc(connection: MessageConnection, sessionI
          * @returns The selectable model entries and selection ids synthesized for the synchronized BYOK models.
          */
         sync: (params: ProviderSyncRequest) => Promise<ProviderSyncResult>;
+        /**
+         * Returns credential-free provider configuration status for the selected model. This does not validate provider credentials or contact the provider.
+         *
+         * @returns Credential-free provider configuration status for the selected model.
+         */
+        getStatus: () => Promise<ProviderStatus>;
         /**
          * Withdraws named host-managed models from the session's BYOK registry, leaving every other entry untouched. The scoped counterpart to `provider.sync`: a snapshot can only describe entries the caller knows about, so using it to remove one model silently withdraws rows registered by another source, such as a plugin calling `provider.add` at runtime. Naming what to remove leaves unrelated entries alone. Selection ids that are not registered are ignored, so withdrawal is idempotent. A provider is removed only when one of the withdrawn models was the last entry referencing it; a provider that simply has no models, which is the normal state while its rows are supplied by catalog discovery, is left in place.
          *
@@ -40522,6 +40946,12 @@ export declare function createSessionRpc(connection: MessageConnection, sessionI
          * @returns Current permission mode.
          */
         getMode: () => Promise<PermissionsGetModeResult>;
+        /**
+         * Returns the approval modes currently available under the session's feature and managed permission policy. This read does not change permissions; mutations must still check their authoritative result because policy may change.
+         *
+         * @returns Available permission modes, derived from current session policy.
+         */
+        getCapabilities: () => Promise<PermissionsCapabilities>;
         /**
          * Adds or removes session-scoped or location-scoped permission rules.
          *

package/dist/generated/rpc.js

@@ -2146,6 +2146,49 @@ function createInternalServerRpc(connection) {
 }
 function createSessionRpc(connection, sessionId) {
   return {
+    /** @experimental */
+    management: {
+      /**
+       * Updates opt-in session management policy live. Enabling the master enables all tools before applying individual overrides. Opt-in is scoped to the session's configuration directory.
+       *
+       * @param params Updates the session's live policy without changing persistent host settings.
+       *
+       * @returns Opt-in policy for local session management.
+       */
+      configure: async (params) => connection.sendRequest("session.management.configure", { ...params, sessionId }),
+      /**
+       * Lists other live, opted-in sessions in the same configuration directory. Requires the list tool to be enabled.
+       *
+       * @param params Lists opted-in local peers. The caller is omitted.
+       *
+       * @returns Eligible live peers reported by their owning runtimes.
+       */
+      list: async (params) => connection.sendRequest("session.management.list", { ...params, sessionId }),
+      /**
+       * Injects peer text into an opted-in session. Wakes an idle agent and safely queues delivery to a busy agent. Acceptance does not imply an answer or completed task.
+       *
+       * @param params Sends peer text, never human approval, to another opted-in session.
+       *
+       * @returns Acceptance is not a completed turn or a reply.
+       */
+      message: async (params) => connection.sendRequest("session.management.message", { ...params, sessionId }),
+      /**
+       * Asks the owning host to create and supervise a separate session, preserving permissions and model restrictions. Omitted model, reasoning effort, context tier and cwd inherit the caller's current values; explicit overrides use normal model validation and workspace trust. Records durable creation lineage before delivering the initial task as peer text. Returns the new session ID, not task completion. Requires the create tool and a host creation handler.
+       *
+       * @param params Requests a separate session. Omitted launch options inherit the caller's current configuration.
+       *
+       * @returns Identifies a session owned and supervised by the creating host.
+       */
+      create: async (params) => connection.sendRequest("session.management.create", { ...params, sessionId }),
+      /**
+       * Closes a live opted-in session created by the caller or one of its descendants, preserving saved history and leaving descendants open. Requires the close capability to be enabled. Self, ancestors, siblings and unrelated sessions cannot be closed.
+       *
+       * @param params Closes one live opted-in descendant without deleting its saved history or closing its children.
+       *
+       * @returns Completion of the existing non-deleting close lifecycle.
+       */
+      close: async (params) => connection.sendRequest("session.management.close", { ...params, sessionId })
+    },
     /** @experimental */
     providers: {
       /**
@@ -2783,7 +2826,13 @@ function createSessionRpc(connection, sessionId) {
        *
        * @returns Canonical runtime state for the session's current autopilot objective.
        */
-      getState: async () => connection.sendRequest("session.autopilotObjective.getState", { sessionId })
+      getState: async () => connection.sendRequest("session.autopilotObjective.getState", { sessionId }),
+      /**
+       * Sets whether completing or pausing this session's objective preserves autopilot mode. This in-memory preference defaults to false and must be reapplied when attaching a client.
+       *
+       * @param params Client-resolved preference for retaining autopilot mode after objective completion or pause.
+       */
+      setStayInAutopilot: async (params) => connection.sendRequest("session.autopilotObjective.setStayInAutopilot", { ...params, sessionId })
     },
     /** @experimental */
     completions: {
@@ -3523,6 +3572,12 @@ function createSessionRpc(connection, sessionId) {
        * @returns The selectable model entries and selection ids synthesized for the synchronized BYOK models.
        */
       sync: async (params) => connection.sendRequest("session.provider.sync", { ...params, sessionId }),
+      /**
+       * Returns credential-free provider configuration status for the selected model. This does not validate provider credentials or contact the provider.
+       *
+       * @returns Credential-free provider configuration status for the selected model.
+       */
+      getStatus: async () => connection.sendRequest("session.provider.getStatus", { sessionId }),
       /**
        * Withdraws named host-managed models from the session's BYOK registry, leaving every other entry untouched. The scoped counterpart to `provider.sync`: a snapshot can only describe entries the caller knows about, so using it to remove one model silently withdraws rows registered by another source, such as a plugin calling `provider.add` at runtime. Naming what to remove leaves unrelated entries alone. Selection ids that are not registered are ignored, so withdrawal is idempotent. A provider is removed only when one of the withdrawn models was the last entry referencing it; a provider that simply has no models, which is the normal state while its rows are supplied by catalog discovery, is left in place.
        *
@@ -3863,6 +3918,12 @@ function createSessionRpc(connection, sessionId) {
        * @returns Current permission mode.
        */
       getMode: async () => connection.sendRequest("session.permissions.getMode", { sessionId }),
+      /**
+       * Returns the approval modes currently available under the session's feature and managed permission policy. This read does not change permissions; mutations must still check their authoritative result because policy may change.
+       *
+       * @returns Available permission modes, derived from current session policy.
+       */
+      getCapabilities: async () => connection.sendRequest("session.permissions.getCapabilities", { sessionId }),
       /**
        * Adds or removes session-scoped or location-scoped permission rules.
        *

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

@@ -730,7 +730,7 @@ export type UserMessageAgentMode =
 /**
  * A user message attachment — a file, directory, code selection, blob, GitHub reference, GitHub-anchored pointer, or extension-supplied context payload
  */
-export type Attachment = AttachmentFile | AttachmentDirectory | AttachmentSelection | AttachmentGitHubReference | AttachmentGitHubCommit | AttachmentGitHubRelease | AttachmentGitHubActionsJob | AttachmentGitHubRepository | AttachmentGitHubFileDiff | AttachmentGitHubTreeComparison | AttachmentGitHubUrl | AttachmentGitHubFile | AttachmentGitHubSnippet | AttachmentBlob | AttachmentExtensionContext;
+export type Attachment = AttachmentFile | AttachmentDirectory | AttachmentSelection | AttachmentGitHubReference | AttachmentGitHubCommit | AttachmentGitHubRelease | AttachmentGitHubActionsJob | AttachmentGitHubRepository | AttachmentGitHubFileDiff | AttachmentGitHubTreeComparison | AttachmentGitHubUrl | AttachmentGitHubFile | AttachmentGitHubSnippet | AttachmentBlob | AttachmentExtensionContext | AttachmentSessionReference;
 /**
  * Why the binary data is absent: it exceeded the inline size limit, or its asset was unavailable
  */
@@ -6349,6 +6349,28 @@ export interface AttachmentExtensionContext {
      */
     type: "extension_context";
 }
+/**
+ * An ID-bound reference to an eligible live session. Supplies identity context only, without sending a message, reading history, or granting permission.
+ */
+/** @experimental */
+export interface AttachmentSessionReference {
+    /**
+     * User-visible mention label captured when the reference was selected.
+     */
+    displayName?: string;
+    /**
+     * Character offset of the selected mention in the displayed prompt.
+     */
+    mentionIndex?: number;
+    /**
+     * Stable identity of the selected session, never resolved from its title.
+     */
+    sessionId: string;
+    /**
+     * Attachment type discriminator.
+     */
+    type: "session_reference";
+}
 /**
  * Session event "pending_messages.modified". Empty payload; the event signals that the pending message queue has changed
  */

package/dist/index.d.ts

@@ -13,5 +13,5 @@ export { defineWorkflow, WorkflowResumeError, isWorkflowRunTerminal } from "./wo
 export { Canvas, CanvasError, createCanvas, type CanvasAction, type CanvasDeclaration, type CanvasHostContext, type CanvasHostContextCapabilities, type CanvasJsonSchema, type CanvasOptions, } from "./canvas.js";
 export { defineTool, approveAll, createAttributedPermissionResult, convertMcpCallToolResult, createSessionFsAdapter, CopilotRequestHandler, CopilotWebSocketHandler, CopilotWebSocketCloseStatus, CopilotWebSocketForwarder, SessionFsSqliteTransactionFailure, SessionFsWriteFailure, SYSTEM_MESSAGE_SECTIONS, } from "./types.js";
 export type * from "./generated/session-events.js";
-export type { AskUserVariant, CommandContext, CommandDefinition, CommandHandler, CanvasProviderIdentity, CloudSessionOptions, CloudSessionRepository, AuthIdentityMetadata, AuthInfoType, ConnectorAccountRequest, ConnectorAvailability, ConnectorCapabilities, ConnectorCatalogEntry, ConnectorCatalogResult, ConnectorCatalogStatus, ConnectorConnectRequest, ConnectorConnectResult, ConnectorContinueRequest, ConnectorDisconnectResult, ConnectorMcpStatus, ConnectorReconcileRequest, ConnectorRuntimeStatus, ConnectorSessionAccount, ConnectorSessionAccountResult, ConnectorStatus, AutoModeSwitchHandler, AutoModeSwitchRequest, AutoModeSwitchResponse, AgentStopHandler, AgentStopHookInput, AgentStopHookOutput, SubagentStartHandler, SubagentStartHookInput, SubagentStartHookOutput, SubagentStopHandler, SubagentStopHookInput, SubagentStopHookOutput, UserPromptTransformedHandler, UserPromptTransformedHookInput, UserPromptTransformedHookOutput, CopilotClientInfo, CopilotClientMode, CopilotClientOptions, EntraAuthConfig, EntraAuthOptions, EntraTokenProvider, EntraTokenProviderArgs, EntraTokenProviderResult, InstallationConfirmationHandler, InstallationConfirmationRequest, InstallationConfirmationResponse, InstallationDecision, InstallationReview, McpInstallationReview, CopilotExpAssignmentResponse, StdioRuntimeConnection, InProcessRuntimeConnection, TcpRuntimeConnection, UriRuntimeConnection, ChildProcessRuntimeConnection, CustomAgentConfig, ElicitationFieldValue, ElicitationHandler, ElicitationParams, ElicitationContext, ElicitationResult, ElicitationSchema, ElicitationSchemaField, ExpConfigEntry, ExpFlagValue, ExitPlanModeHandler, ExitPlanModeRequest, ExitPlanModeResult, ExtensionLaunchProfile, ExtensionLaunchProvider, ExtensionLaunchProviderResolveRequest, ExtensionLaunchProviderResolveResult, ExtensionInfo, KerberosAuthAcquireRequest, KerberosAuthConfig, KerberosAuthMode, KerberosAuthScope, ForegroundSessionInfo, GetAuthStatusResponse, GetStatusResponse, HostDiagnostics, HostErrorReportingStatus, GitHubMcpToolConfig, GitHubTelemetryNotification, GitHubTelemetryEvent, GitHubTelemetryClientInfo, GitHubTokenAcquireReason, GitHubTokenAcquireResult, GitHubTokenProvider, GitHubTokenProviderArgs, GitHubTokenProviderResult, InfiniteSessionConfig, LargeToolOutputConfig, MemoryConfiguration, UiInputOptions, MCPStdioServerConfig, MCPHTTPServerConfig, MCPServerConfig, DefaultAgentConfig, BearerTokenProvider, ExtensionContextAttachment, MessageOptions, ResponseSchema, MessageSource, ManagedSettings, ManagedSettingsPermissions, ModelBilling, ModelBillingTokenPrices, ModelBillingTokenPricesLongContext, AutoTier, CapiSessionOptions, CurrentModel, ModelSwitchAutoTierResult, ModelSwitchAutoTierStatus, ModelCapabilities, ModelCapabilitiesOverride, ModelInfo, ModelPolicy, NamedProviderConfig, PermissionHandler, PermissionRequest, PermissionRequestedData, PermissionRequestedEvent, PermissionRequestResult, AttributedPermissionResult, PermissionDecisionContext, PermissionDecisionOutcome, PermissionDecisionSource, PermissionDecisionSurface, PermissionResponseCapability, ProviderConfig, ProviderConfigModelProvider, ProviderModelConfig, ProviderTokenArgs, RemoteSessionMode, SandboxConfigSource, ResumeSessionConfig, TranscriptRecovery, SectionOverride, SectionOverrideAction, SectionTransformFn, SessionCapabilities, SessionConfig, SessionConfigBase, WorkingDirectoryTrust, SessionEvent, SessionEventHandler, SessionEventPayload, SessionEventType, SessionLifecycleEvent, SessionLifecycleEventMetadata, SessionLifecycleEventType, SessionLifecycleHandler, SessionHooks, SessionCreatedEvent, SessionDeletedEvent, SessionUpdatedEvent, SessionForegroundEvent, SessionBackgroundEvent, SessionContext, SessionListFilter, SessionMetadata, SessionUiApi, SessionFsConfig, SessionFsProvider, SessionFsByteRange, SessionFsFileInfo, SessionFsSqliteQueryResult, SessionFsSqliteQueryType, SessionFsSqliteProvider, SessionFsSqliteStatement, SessionFsSqliteTransactionErrorClass, SkillProvider, SkillProviderCallOptions, SkillProviderDescriptor, CopilotRequestContext, SystemMessageAppendConfig, SystemMessageConfig, SystemMessageCustomizeConfig, SystemMessageReplaceConfig, SystemMessageSection, TelemetryConfig, TraceContext, TraceContextProvider, Tool, ToolHandler, ToolInvocation, ToolNamespace, CurrentToolMetadata, ToolTelemetry, ToolResultObject, ToolSearchConfig, ImageGenerationConfig, TypedSessionEventHandler, TypedSessionLifecycleHandler, ZodSchema, } from "./types.js";
+export type { AskUserVariant, CommandContext, CommandDefinition, CommandHandler, CanvasProviderIdentity, CloudSessionOptions, CloudSessionRepository, AuthIdentityMetadata, AuthInfoType, ConnectorAccountRequest, ConnectorAvailability, ConnectorCapabilities, ConnectorCatalogEntry, ConnectorCatalogResult, ConnectorCatalogStatus, ConnectorConnectRequest, ConnectorConnectResult, ConnectorContinueRequest, ConnectorDisconnectResult, ConnectorMcpStatus, ConnectorReconcileRequest, ConnectorRuntimeStatus, ConnectorSessionAccount, ConnectorSessionAccountResult, ConnectorStatus, AutoModeSwitchHandler, AutoModeSwitchRequest, AutoModeSwitchResponse, AgentStopHandler, AgentStopHookInput, AgentStopHookOutput, SubagentStartHandler, SubagentStartHookInput, SubagentStartHookOutput, SubagentStopHandler, SubagentStopHookInput, SubagentStopHookOutput, UserPromptTransformedHandler, UserPromptTransformedHookInput, UserPromptTransformedHookOutput, CopilotClientInfo, CopilotClientMode, CopilotClientOptions, EntraAuthConfig, EntraAuthOptions, EntraTokenProvider, EntraTokenProviderArgs, EntraTokenProviderResult, InstallationConfirmationHandler, InstallationConfirmationRequest, InstallationConfirmationResponse, InstallationDecision, InstallationReview, McpInstallationReview, CopilotExpAssignmentResponse, StdioRuntimeConnection, InProcessRuntimeConnection, TcpRuntimeConnection, UriRuntimeConnection, ChildProcessRuntimeConnection, CustomAgentConfig, ElicitationFieldValue, ElicitationHandler, ElicitationParams, ElicitationContext, ElicitationResult, ElicitationSchema, ElicitationSchemaField, ExpConfigEntry, ExpFlagValue, ExitPlanModeHandler, ExitPlanModeRequest, ExitPlanModeResult, ExtensionLaunchProfile, ExtensionLaunchProvider, ExtensionLaunchProviderResolveRequest, ExtensionLaunchProviderResolveResult, ExtensionInfo, KerberosAuthAcquireRequest, KerberosAuthConfig, KerberosAuthMode, KerberosAuthScope, ForegroundSessionInfo, GetAuthStatusResponse, GetStatusResponse, HostDiagnostics, HostErrorReportingStatus, GitHubMcpToolConfig, GitHubTelemetryNotification, GitHubTelemetryEvent, GitHubTelemetryClientInfo, GitHubTokenAcquireReason, GitHubTokenAcquireResult, GitHubTokenProvider, GitHubTokenProviderArgs, GitHubTokenProviderResult, InfiniteSessionConfig, LargeToolOutputConfig, MemoryConfiguration, UiInputOptions, MCPStdioServerConfig, MCPHTTPServerConfig, MCPServerConfig, DefaultAgentConfig, BearerTokenProvider, ExtensionContextAttachment, MessageOptions, ResponseSchema, MessageSource, ManagedSettings, ManagedSettingsPermissions, ModelBilling, ModelBillingTokenPrices, ModelBillingTokenPricesLongContext, AutoTier, CapiSessionOptions, CurrentModel, ModelSwitchAutoTierResult, ModelSwitchAutoTierStatus, ModelCapabilities, ModelCapabilitiesOverride, ModelInfo, ModelPolicy, NamedProviderConfig, PermissionHandler, PermissionRequest, PermissionRequestedData, PermissionRequestedEvent, PermissionRequestResult, AttributedPermissionResult, PermissionDecisionContext, PermissionDecisionOutcome, PermissionDecisionSource, PermissionDecisionSurface, PermissionResponseCapability, ProviderConfig, ProviderConfigModelProvider, ProviderModelConfig, ProviderTokenArgs, RemoteSessionMode, SandboxConfigSource, ResumeSessionConfig, TranscriptRecovery, SectionOverride, SectionOverrideAction, SectionTransformFn, SessionCapabilities, SessionConfig, SessionConfigBase, WorkingDirectoryTrust, SessionEvent, SessionEventHandler, SessionEventPayload, SessionEventType, SessionLifecycleEvent, SessionLifecycleEventMetadata, SessionLifecycleEventType, SessionLifecycleHandler, SessionHooks, SessionCreatedEvent, SessionDeletedEvent, SessionUpdatedEvent, SessionForegroundEvent, SessionBackgroundEvent, SessionContext, SessionListFilter, SessionMetadata, SessionUiApi, SessionFsConfig, SessionFsProvider, SessionFsByteRange, SessionFsFileInfo, SessionFsSqliteQueryResult, SessionFsSqliteQueryType, SessionFsSqliteProvider, SessionFsSqliteStatement, SessionFsSqliteTransactionErrorClass, SkillProvider, SessionCreationHandler, ManagedSessionInfo, SessionManagementCloseRequest, SessionManagementCloseResult, SessionManagementConfigureRequest, SessionManagementCreateHostRequest, SessionManagementCreateRequest, SessionManagementCreateResult, SessionManagementListRequest, SessionManagementListResult, SessionManagementMessageRequest, SessionManagementMessageResult, SessionManagementPolicy, SessionManagementScope, SessionManagementToolOverrides, SkillProviderCallOptions, SkillProviderDescriptor, CopilotRequestContext, SystemMessageAppendConfig, SystemMessageConfig, SystemMessageCustomizeConfig, SystemMessageReplaceConfig, SystemMessageSection, TelemetryConfig, TraceContext, TraceContextProvider, Tool, ToolHandler, ToolInvocation, ToolNamespace, CurrentToolMetadata, ToolTelemetry, ToolResultObject, ToolSearchConfig, ImageGenerationConfig, TypedSessionEventHandler, TypedSessionLifecycleHandler, ZodSchema, } from "./types.js";
 export type { JsonValue, WorkflowRunOptions, WorkflowResumeOptions, WorkflowLimitOverrides, WorkflowResumeErrorCode, SessionWorkflowApi, WorkflowAgentOptions, WorkflowContext, WorkflowDefinition, WorkflowHandle, WorkflowJsonSchema, WorkflowLimits, WorkflowMeta, WorkflowPipelineStage, WorkflowStepOptions, WorkflowRunResult, WorkflowRunStatus, WorkflowRunSummary, WorkflowListRunsOptions, WorkflowRunsPage, WorkflowRunDetail, WorkflowProgressPage, WorkflowProgressLine, WorkflowPhaseObservation, WorkflowPhaseStatus, WorkflowAgentContextObservation, WorkflowAgentModelObservation, WorkflowAgentReasoningEffortObservation, WorkflowAgentSummary, } from "./workflow.js";