@github/copilot-sdk 1.0.0-beta.5 → 1.0.0-beta.6

package/dist/generated/rpc.d.ts

@@ -1027,11 +1027,11 @@ export interface AccountQuotaSnapshot {
      */
     remainingPercentage: number;
     /**
-     * Number of overage requests made this period
+     * Number of additional usage requests made this period
      */
     overage: number;
     /**
-     * Whether overage is allowed when quota is exhausted
+     * Whether additional usage is allowed when quota is exhausted
      */
     overageAllowedWithExhaustedQuota: boolean;
     /**
@@ -1097,7 +1097,9 @@ export interface AgentInfo {
      * MCP server configurations attached to this agent, keyed by server name. Server config shape mirrors the MCP `mcpServers` schema.
      */
     mcpServers?: {
-        [k: string]: unknown | undefined;
+        [k: string]: {
+            [k: string]: unknown | undefined;
+        } | undefined;
     };
     /**
      * Skill names preloaded into this agent's context. Omitted means none.
@@ -1738,40 +1740,6 @@ export interface ConnectRemoteSessionParams {
      */
     sessionId: string;
 }
-/**
- * Optional connection token presented by the SDK client during the handshake.
- *
- * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "ConnectRequest".
- */
-/** @internal */
-export interface ConnectRequest {
-    /**
-     * Connection token; required when the server was started with COPILOT_CONNECTION_TOKEN
-     */
-    token?: string;
-}
-/**
- * Handshake result reporting the server's protocol version and package version on success.
- *
- * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "ConnectResult".
- */
-/** @internal */
-export interface ConnectResult {
-    /**
-     * Always true on success
-     */
-    ok: true;
-    /**
-     * Server protocol version number
-     */
-    protocolVersion: number;
-    /**
-     * Server package version
-     */
-    version: string;
-}
 /**
  * The currently selected model and reasoning effort for the session.
  *
@@ -2024,7 +1992,9 @@ export interface ExternalToolTextResultForLlm {
      * Optional tool-specific telemetry
      */
     toolTelemetry?: {
-        [k: string]: unknown | undefined;
+        [k: string]: {
+            [k: string]: unknown | undefined;
+        } | undefined;
     };
     /**
      * Base64-encoded binary results returned to the model
@@ -2374,6 +2344,19 @@ export interface HistoryCompactContextWindow {
      */
     toolDefinitionsTokens?: number;
 }
+/**
+ * Optional compaction parameters.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "HistoryCompactRequest".
+ */
+/** @experimental */
+export interface HistoryCompactRequest {
+    /**
+     * Optional user-provided instructions to focus the compaction summary
+     */
+    customInstructions?: string;
+}
 /**
  * Compaction outcome with the number of tokens and messages removed, summary text, and the resulting context window breakdown.
  *
@@ -5200,6 +5183,30 @@ export interface ScheduleStopRequest {
 export interface ScheduleStopResult {
     entry?: ScheduleEntry;
 }
+/**
+ * Secret values to add to the redaction filter.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SecretsAddFilterValuesRequest".
+ */
+export interface SecretsAddFilterValuesRequest {
+    /**
+     * Raw secret values to register for redaction
+     */
+    values: string[];
+}
+/**
+ * Confirmation that the secret values were registered.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SecretsAddFilterValuesResult".
+ */
+export interface SecretsAddFilterValuesResult {
+    /**
+     * Whether the values were successfully registered
+     */
+    ok: true;
+}
 /**
  * File attachment
  *
@@ -5946,7 +5953,9 @@ export interface SessionFsSqliteQueryResult {
      * For SELECT: array of row objects. For others: empty array.
      */
     rows: {
-        [k: string]: unknown | undefined;
+        [k: string]: {
+            [k: string]: unknown | undefined;
+        } | undefined;
     }[];
     /**
      * Column names from the result set
@@ -6821,7 +6830,9 @@ export interface SessionUpdateOptionsParams {
     /**
      * Additional content-exclusion policies to merge into the session's policy set. Opaque shape; see `ContentExclusionApiResponse` in the runtime.
      */
-    additionalContentExclusionPolicies?: unknown[];
+    additionalContentExclusionPolicies?: {
+        [k: string]: unknown | undefined;
+    }[];
     /**
      * Whether to expose the `manage_schedule` tool to the agent. The runtime always owns the per-session schedule registry; this flag only controls tool exposure (typically gated to staff users).
      */
@@ -7656,7 +7667,9 @@ export interface Tool {
      * JSON Schema for the tool's input parameters
      */
     parameters?: {
-        [k: string]: unknown | undefined;
+        [k: string]: {
+            [k: string]: unknown | undefined;
+        } | undefined;
     };
     /**
      * Optional instructions for how to use this tool effectively
@@ -8634,6 +8647,16 @@ export declare function createServerRpc(connection: MessageConnection): {
          */
         getQuota: (params: AccountGetQuotaRequest) => Promise<AccountGetQuotaResult>;
     };
+    secrets: {
+        /**
+         * Registers secret values for redaction in session logs and exports. The SDK calls this to inject dynamically generated secret values (e.g., OIDC tokens).
+         *
+         * @param params Secret values to add to the redaction filter.
+         *
+         * @returns Confirmation that the secret values were registered.
+         */
+        addFilterValues: (params: SecretsAddFilterValuesRequest) => Promise<SecretsAddFilterValuesResult>;
+    };
     mcp: {
         config: {
             /**
@@ -8864,21 +8887,6 @@ export declare function createServerRpc(connection: MessageConnection): {
         setAdditionalPlugins: (params: SessionsSetAdditionalPluginsRequest) => Promise<SessionsSetAdditionalPluginsResult>;
     };
 };
-/**
- * Create typed server-scoped RPC methods that are part of the SDK's internal
- * surface (e.g. handshake helpers). Not exported on the public client API.
- * @internal
- */
-export declare function createInternalServerRpc(connection: MessageConnection): {
-    /**
-     * Performs the SDK server connection handshake and validates the optional connection token.
-     *
-     * @param params Optional connection token presented by the SDK client during the handshake.
-     *
-     * @returns Handshake result reporting the server's protocol version and package version on success.
-     */
-    connect: (params: ConnectRequest) => Promise<ConnectResult>;
-};
 /** Create typed session-scoped RPC methods. */
 export declare function createSessionRpc(connection: MessageConnection, sessionId: string): {
     /**
@@ -9740,9 +9748,11 @@ export declare function createSessionRpc(connection: MessageConnection, sessionI
         /**
          * Compacts the session history to reduce context usage.
          *
+         * @param params Optional compaction parameters.
+         *
          * @returns Compaction outcome with the number of tokens and messages removed, summary text, and the resulting context window breakdown.
          */
-        compact: () => Promise<HistoryCompactResult>;
+        compact: (params?: HistoryCompactRequest) => Promise<HistoryCompactResult>;
         /**
          * Truncates persisted session history to a specific event.
          *

package/dist/generated/rpc.js

@@ -38,6 +38,16 @@ function createServerRpc(connection) {
        */
       getQuota: async (params) => connection.sendRequest("account.getQuota", params)
     },
+    secrets: {
+      /**
+       * Registers secret values for redaction in session logs and exports. The SDK calls this to inject dynamically generated secret values (e.g., OIDC tokens).
+       *
+       * @param params Secret values to add to the redaction filter.
+       *
+       * @returns Confirmation that the secret values were registered.
+       */
+      addFilterValues: async (params) => connection.sendRequest("secrets.addFilterValues", params)
+    },
     mcp: {
       config: {
         /**
@@ -1142,9 +1152,11 @@ function createSessionRpc(connection, sessionId) {
       /**
        * Compacts the session history to reduce context usage.
        *
+       * @param params Optional compaction parameters.
+       *
        * @returns Compaction outcome with the number of tokens and messages removed, summary text, and the resulting context window breakdown.
        */
-      compact: async () => connection.sendRequest("session.history.compact", { sessionId }),
+      compact: async (params) => connection.sendRequest("session.history.compact", { sessionId, ...params }),
       /**
        * Truncates persisted session history to a specific event.
        *

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

@@ -1325,7 +1325,7 @@ export interface ShutdownData {
     /**
      * Total number of premium API requests used during the session
      */
-    totalPremiumRequests: number;
+    totalPremiumRequests?: number;
 }
 /**
  * Aggregate code change metrics for the session
@@ -1368,11 +1368,11 @@ export interface ShutdownModelMetricRequests {
     /**
      * Cumulative cost multiplier for requests to this model
      */
-    cost: number;
+    cost?: number;
     /**
      * Total number of API requests made to this model
      */
-    count: number;
+    count?: number;
 }
 /**
  * Schema for the `ShutdownModelMetricTokenDetail` type.
@@ -1604,6 +1604,10 @@ export interface CompactionCompleteData {
      * Token count from non-system messages (user, assistant, tool) after compaction
      */
     conversationTokens?: number;
+    /**
+     * User-supplied focus instructions provided to a manual `/compact` invocation. Omitted for automatic compaction and for manual compaction with no focus text.
+     */
+    customInstructions?: string;
     /**
      * Error message if compaction failed
      */
@@ -2257,7 +2261,9 @@ export interface AssistantMessageData {
     /**
      * Raw Anthropic content array with advisor blocks (server_tool_use, advisor_tool_result) for verbatim round-tripping
      */
-    anthropicAdvisorBlocks?: unknown[];
+    anthropicAdvisorBlocks?: {
+        [k: string]: unknown | undefined;
+    }[];
     /**
      * Anthropic advisor model ID used for this response, for timeline display on replay
      */
@@ -2633,11 +2639,11 @@ export interface AssistantUsageQuotaSnapshot {
      */
     isUnlimitedEntitlement: boolean;
     /**
-     * Number of requests over the entitlement limit
+     * Number of additional usage requests made this period
      */
     overage: number;
     /**
-     * Whether overage is allowed when quota is exhausted
+     * Whether additional usage is allowed when quota is exhausted
      */
     overageAllowedWithExhaustedQuota: boolean;
     /**
@@ -3011,6 +3017,10 @@ export interface ToolExecutionCompleteData {
      */
     parentToolCallId?: string;
     result?: ToolExecutionCompleteResult;
+    /**
+     * Whether this tool execution ran inside a sandbox container
+     */
+    sandboxed?: boolean;
     /**
      * Whether the tool execution completed successfully
      */
@@ -3023,7 +3033,9 @@ export interface ToolExecutionCompleteData {
      * Tool-specific telemetry data (e.g., CodeQL check counts, grep match counts)
      */
     toolTelemetry?: {
-        [k: string]: unknown | undefined;
+        [k: string]: {
+            [k: string]: unknown | undefined;
+        } | undefined;
     };
     /**
      * Identifier for the agent loop turn this tool was invoked in, matching the corresponding assistant.turn_start event
@@ -3730,7 +3742,9 @@ export interface SystemMessageMetadata {
      * Template variables used when constructing the prompt
      */
     variables?: {
-        [k: string]: unknown | undefined;
+        [k: string]: {
+            [k: string]: unknown | undefined;
+        } | undefined;
     };
 }
 /**
@@ -4976,7 +4990,9 @@ export interface ElicitationRequestedSchema {
      * Form field definitions, keyed by field name
      */
     properties: {
-        [k: string]: unknown | undefined;
+        [k: string]: {
+            [k: string]: unknown | undefined;
+        } | undefined;
     };
     /**
      * List of required field names

package/dist/index.d.ts

@@ -4,7 +4,8 @@
  * JSON-RPC based SDK for programmatic control of GitHub Copilot CLI
  */
 export { CopilotClient } from "./client.js";
+export { RuntimeConnection } from "./types.js";
 export { CopilotSession, type AssistantMessageEvent } from "./session.js";
 export { defineTool, approveAll, convertMcpCallToolResult, createSessionFsAdapter, SYSTEM_PROMPT_SECTIONS, } from "./types.js";
 export type * from "./generated/session-events.js";
-export type { CommandContext, CommandDefinition, CommandHandler, CloudSessionOptions, CloudSessionRepository, AutoModeSwitchHandler, AutoModeSwitchRequest, AutoModeSwitchResponse, ConnectionState, CopilotClientOptions, CustomAgentConfig, ElicitationFieldValue, ElicitationHandler, ElicitationParams, ElicitationContext, ElicitationResult, ElicitationSchema, ElicitationSchemaField, ExitPlanModeHandler, ExitPlanModeRequest, ExitPlanModeResult, ForegroundSessionInfo, GetAuthStatusResponse, GetStatusResponse, InfiniteSessionConfig, InputOptions, MCPStdioServerConfig, MCPHTTPServerConfig, MCPServerConfig, DefaultAgentConfig, MessageOptions, ModelBilling, ModelCapabilities, ModelCapabilitiesOverride, ModelInfo, ModelPolicy, PermissionHandler, PermissionRequest, PermissionRequestResult, ProviderConfig, RemoteSessionMode, ResumeSessionConfig, SectionOverride, SectionOverrideAction, SectionTransformFn, SessionCapabilities, SessionConfig, SessionEvent, SessionEventHandler, SessionEventPayload, SessionEventType, SessionLifecycleEvent, SessionLifecycleEventType, SessionLifecycleHandler, SessionContext, SessionListFilter, SessionMetadata, SessionUiApi, SessionFsConfig, SessionFsProvider, SessionFsFileInfo, SessionFsSqliteQueryResult, SessionFsSqliteQueryType, SessionFsSqliteProvider, SystemMessageAppendConfig, SystemMessageConfig, SystemMessageCustomizeConfig, SystemMessageReplaceConfig, SystemPromptSection, TelemetryConfig, TraceContext, TraceContextProvider, Tool, ToolHandler, ToolInvocation, ToolResultObject, TypedSessionEventHandler, TypedSessionLifecycleHandler, ZodSchema, } from "./types.js";
+export type { CommandContext, CommandDefinition, CommandHandler, CloudSessionOptions, CloudSessionRepository, AutoModeSwitchHandler, AutoModeSwitchRequest, AutoModeSwitchResponse, ConnectionState, CopilotClientOptions, StdioRuntimeConnection, TcpRuntimeConnection, UriRuntimeConnection, CustomAgentConfig, ElicitationFieldValue, ElicitationHandler, ElicitationParams, ElicitationContext, ElicitationResult, ElicitationSchema, ElicitationSchemaField, ExitPlanModeHandler, ExitPlanModeRequest, ExitPlanModeResult, 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, SystemPromptSection, TelemetryConfig, TraceContext, TraceContextProvider, Tool, ToolHandler, ToolInvocation, ToolTelemetry, ToolResultObject, TypedSessionEventHandler, TypedSessionLifecycleHandler, ZodSchema, } from "./types.js";

package/dist/index.js

@@ -1,4 +1,5 @@
 import { CopilotClient } from "./client.js";
+import { RuntimeConnection } from "./types.js";
 import { CopilotSession } from "./session.js";
 import {
   defineTool,
@@ -10,6 +11,7 @@ import {
 export {
   CopilotClient,
   CopilotSession,
+  RuntimeConnection,
   SYSTEM_PROMPT_SECTIONS,
   approveAll,
   convertMcpCallToolResult,

package/dist/session.d.ts

@@ -1,12 +1,5 @@
-/**
- * Copilot Session - represents a single conversation session with the Copilot CLI.
- * @module session
- */
-import type { MessageConnection } from "vscode-jsonrpc/node.js";
 import { createSessionRpc } from "./generated/rpc.js";
-import type { ClientSessionApiHandlers } from "./generated/rpc.js";
-import type { CommandHandler, AutoModeSwitchHandler, AutoModeSwitchRequest, AutoModeSwitchResponse, ElicitationHandler, ElicitationContext, ExitPlanModeHandler, ExitPlanModeRequest, ExitPlanModeResult, MessageOptions, PermissionHandler, PermissionRequestResult, ReasoningEffort, ModelCapabilitiesOverride, SectionTransformFn, SessionCapabilities, SessionEvent, SessionEventHandler, SessionEventType, SessionHooks, SessionUiApi, Tool, ToolHandler, TraceContextProvider, TypedSessionEventHandler, UserInputHandler, UserInputResponse } from "./types.js";
-export declare const NO_RESULT_PERMISSION_V2_ERROR = "Permission handlers cannot return 'no-result' when connected to a protocol v2 server.";
+import type { MessageOptions, ReasoningEffort, 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";
@@ -54,18 +47,6 @@ export declare class CopilotSession {
     private _rpc;
     private traceContextProvider?;
     private _capabilities;
-    /** @internal Client session API handlers, populated by CopilotClient during create/resume. */
-    clientSessionApis: ClientSessionApiHandlers;
-    /**
-     * Creates a new CopilotSession instance.
-     *
-     * @param sessionId - The unique identifier for this session
-     * @param connection - The JSON-RPC message connection to the Copilot CLI
-     * @param workspacePath - Path to the session workspace directory (when infinite sessions enabled)
-     * @param traceContextProvider - Optional callback to get W3C Trace Context for outbound RPCs
-     * @internal This constructor is internal. Use {@link CopilotClient.createSession} to create sessions.
-     */
-    constructor(sessionId: string, connection: MessageConnection, _workspacePath?: string | undefined, traceContextProvider?: TraceContextProvider);
     /**
      * Typed session-scoped RPC methods.
      */
@@ -112,6 +93,7 @@ export declare class CopilotSession {
      * });
      * ```
      */
+    send(prompt: string): Promise<string>;
     send(options: MessageOptions): Promise<string>;
     /**
      * Sends a message to this session and waits until the session becomes idle.
@@ -136,6 +118,7 @@ export declare class CopilotSession {
      * console.log(response?.data.content); // "4"
      * ```
      */
+    sendAndWait(prompt: string, timeout?: number): Promise<AssistantMessageEvent | undefined>;
     sendAndWait(options: MessageOptions, timeout?: number): Promise<AssistantMessageEvent | undefined>;
     /**
      * Subscribes to events from this session.
@@ -183,191 +166,11 @@ export declare class CopilotSession {
      * ```
      */
     on(handler: SessionEventHandler): () => void;
-    /**
-     * Dispatches an event to all registered handlers.
-     * Also handles broadcast request events internally (external tool calls, permissions).
-     *
-     * @param event - The session event to dispatch
-     * @internal This method is for internal use by the SDK.
-     */
-    _dispatchEvent(event: SessionEvent): void;
-    /**
-     * Handles broadcast request events by executing local handlers and responding via RPC.
-     * Handlers are dispatched as fire-and-forget — rejections propagate as unhandled promise
-     * rejections, consistent with standard EventEmitter / event handler semantics.
-     * @internal
-     */
-    private _handleBroadcastEvent;
-    /**
-     * Executes a tool handler and sends the result back via RPC.
-     * @internal
-     */
-    private _executeToolAndRespond;
-    /**
-     * Executes a permission handler and sends the result back via RPC.
-     * @internal
-     */
-    private _executePermissionAndRespond;
-    /**
-     * Executes a command handler and sends the result back via RPC.
-     * @internal
-     */
-    private _executeCommandAndRespond;
-    /**
-     * Registers custom tool handlers for this session.
-     *
-     * Tools with handlers allow the assistant to execute custom functions automatically.
-     * Declaration-only tools are surfaced as events and left pending for the consumer.
-     *
-     * @param tools - An array of tool definitions with their handlers, or undefined to clear all tools
-     * @internal This method is typically called internally when creating a session with tools.
-     */
-    registerTools(tools?: Tool[]): void;
-    /**
-     * Retrieves a registered tool handler by name.
-     *
-     * @param name - The name of the tool to retrieve
-     * @returns The tool handler if found, or undefined
-     * @internal This method is for internal use by the SDK.
-     */
-    getToolHandler(name: string): ToolHandler | undefined;
-    /**
-     * Registers command handlers for this session.
-     *
-     * @param commands - An array of command definitions with handlers, or undefined to clear
-     * @internal This method is typically called internally when creating/resuming a session.
-     */
-    registerCommands(commands?: {
-        name: string;
-        handler: CommandHandler;
-    }[]): void;
-    /**
-     * Registers the elicitation handler for this session.
-     *
-     * @param handler - The handler to invoke when the server dispatches an elicitation request
-     * @internal This method is typically called internally when creating/resuming a session.
-     */
-    registerElicitationHandler(handler?: ElicitationHandler): void;
-    /**
-     * Registers the exit-plan-mode handler for this session.
-     *
-     * @param handler - The handler to invoke when the server dispatches an exit-plan-mode request
-     * @internal This method is typically called internally when creating/resuming a session.
-     */
-    registerExitPlanModeHandler(handler?: ExitPlanModeHandler): void;
-    /**
-     * Registers the auto-mode-switch handler for this session.
-     *
-     * @param handler - The handler to invoke when the server dispatches an auto-mode-switch request
-     * @internal This method is typically called internally when creating/resuming a session.
-     */
-    registerAutoModeSwitchHandler(handler?: AutoModeSwitchHandler): void;
-    /**
-     * Handles an elicitation.requested broadcast event.
-     * Invokes the registered handler and responds via handlePendingElicitation RPC.
-     * @internal
-     */
-    _handleElicitationRequest(context: ElicitationContext, requestId: string): Promise<void>;
-    /**
-     * Handles an exitPlanMode.request callback from the runtime.
-     * @internal
-     */
-    _handleExitPlanModeRequest(request: ExitPlanModeRequest): Promise<ExitPlanModeResult>;
-    /**
-     * Handles an autoModeSwitch.request callback from the runtime.
-     * @internal
-     */
-    _handleAutoModeSwitchRequest(request: AutoModeSwitchRequest): Promise<AutoModeSwitchResponse>;
-    /**
-     * Sets the host capabilities for this session.
-     *
-     * @param capabilities - The capabilities object from the create/resume response
-     * @internal This method is typically called internally when creating/resuming a session.
-     */
-    setCapabilities(capabilities?: SessionCapabilities): void;
     private assertElicitation;
     private _elicitation;
     private _confirm;
     private _select;
     private _input;
-    /**
-     * Registers a handler for permission requests.
-     *
-     * When the assistant needs permission to perform certain actions (e.g., file operations),
-     * this handler is called to approve or deny the request.
-     *
-     * @param handler - The permission handler function, or undefined to remove the handler
-     * @internal This method is typically called internally when creating a session.
-     */
-    registerPermissionHandler(handler?: PermissionHandler): void;
-    /**
-     * Registers a user input handler for ask_user requests.
-     *
-     * When the agent needs input from the user (via ask_user tool),
-     * this handler is called to provide the response.
-     *
-     * @param handler - The user input handler function, or undefined to remove the handler
-     * @internal This method is typically called internally when creating a session.
-     */
-    registerUserInputHandler(handler?: UserInputHandler): void;
-    /**
-     * Registers hook handlers for session lifecycle events.
-     *
-     * Hooks allow custom logic to be executed at various points during
-     * the session lifecycle (before/after tool use, session start/end, etc.).
-     *
-     * @param hooks - The hook handlers object, or undefined to remove all hooks
-     * @internal This method is typically called internally when creating a session.
-     */
-    registerHooks(hooks?: SessionHooks): void;
-    /**
-     * Registers transform callbacks for system message sections.
-     *
-     * @param callbacks - Map of section ID to transform callback, or undefined to clear
-     * @internal This method is typically called internally when creating a session.
-     */
-    registerTransformCallbacks(callbacks?: Map<string, SectionTransformFn>): void;
-    /**
-     * Handles a systemMessage.transform request from the runtime.
-     * Dispatches each section to its registered transform callback.
-     *
-     * @param sections - Map of section IDs to their current rendered content
-     * @returns A promise that resolves with the transformed sections
-     * @internal This method is for internal use by the SDK.
-     */
-    _handleSystemMessageTransform(sections: Record<string, {
-        content: string;
-    }>): Promise<{
-        sections: Record<string, {
-            content: string;
-        }>;
-    }>;
-    /**
-     * Handles a permission request in the v2 protocol format (synchronous RPC).
-     * Used as a back-compat adapter when connected to a v2 server.
-     *
-     * @param request - The permission request data from the CLI
-     * @returns A promise that resolves with the permission decision
-     * @internal This method is for internal use by the SDK.
-     */
-    _handlePermissionRequestV2(request: unknown): Promise<PermissionRequestResult>;
-    /**
-     * Handles a user input request from the Copilot CLI.
-     *
-     * @param request - The user input request data from the CLI
-     * @returns A promise that resolves with the user's response
-     * @internal This method is for internal use by the SDK.
-     */
-    _handleUserInputRequest(request: unknown): Promise<UserInputResponse>;
-    /**
-     * Handles a hooks invocation from the Copilot CLI.
-     *
-     * @param hookType - The type of hook being invoked
-     * @param input - The input data for the hook
-     * @returns A promise that resolves with the hook output, or undefined
-     * @internal This method is for internal use by the SDK.
-     */
-    _handleHooksInvoke(hookType: string, input: unknown): Promise<unknown>;
     /**
      * Retrieves all events and messages from this session's history.
      *
@@ -379,7 +182,7 @@ export declare class CopilotSession {
      *
      * @example
      * ```typescript
-     * const events = await session.getMessages();
+     * const events = await session.getEvents();
      * for (const event of events) {
      *   if (event.type === "assistant.message") {
      *     console.log("Assistant:", event.data.content);
@@ -387,7 +190,7 @@ export declare class CopilotSession {
      * }
      * ```
      */
-    getMessages(): Promise<SessionEvent[]>;
+    getEvents(): Promise<SessionEvent[]>;
     /**
      * Disconnects this session and releases all in-memory resources (event handlers,
      * tool handlers, permission handlers).
@@ -410,16 +213,6 @@ export declare class CopilotSession {
      * ```
      */
     disconnect(): Promise<void>;
-    /**
-     * @deprecated Use {@link disconnect} instead. This method will be removed in a future release.
-     *
-     * Disconnects this session and releases all in-memory resources.
-     * Session data on disk is preserved for later resumption.
-     *
-     * @returns A promise that resolves when the session is disconnected
-     * @throws Error if the connection fails
-     */
-    destroy(): Promise<void>;
     /** Enables `await using session = ...` syntax for automatic cleanup. */
     [Symbol.asyncDispose](): Promise<void>;
     /**