@qoder-ai/qoder-agent-sdk 1.0.15 → 1.0.16

package/dist/mcp/sdk-mcp-server.d.ts

@@ -46,6 +46,12 @@ export type SdkMcpToolDefinition<Schema extends AnyZodRawShape = AnyZodRawShape>
      * stripped at the protocol boundary.
      */
     annotations?: ToolAnnotations;
+    /** Optional model-facing name. Requires `alwaysLoad: true`. */
+    exposedName?: string;
+    /** Keep this tool directly available when MCP lazy loading is enabled. */
+    alwaysLoad?: boolean;
+    /** Optional default permission policy for this MCP tool. */
+    permissionPolicy?: 'always_allow' | 'always_ask' | 'always_deny';
     /** Async handler invoked when the tool is called. */
     handler: (args: InferShape<Schema>, extra: RequestHandlerExtra<ServerRequest, ServerNotification>) => Promise<CallToolResult>;
 };
@@ -65,7 +71,7 @@ export type CreateSdkMcpServerOptions = {
  * SDK's `mcpServers` option.
  *
  * NOTE: this factory does **not** call `instance.connect(transport)` itself
- * — that wiring lives in `query.ts` / `browser-query.ts`, where the
+ * — that wiring lives in `query.ts`, where the
  * per-query SdkMcpTransport (with its `sendMcpMessage` callback bound to
  * the query's pending-response map) is constructed. Adding a transport
  * here would either be wrong (no callback to bind to) or would force every
@@ -92,6 +98,12 @@ export type ToolExtras = {
      * `SdkMcpToolDefinition.annotations` for the full coverage matrix.
      */
     annotations?: ToolAnnotations;
+    /** Optional model-facing name. Requires `alwaysLoad: true`. */
+    exposedName?: string;
+    /** Keep this tool directly available when MCP lazy loading is enabled. */
+    alwaysLoad?: boolean;
+    /** Optional default permission policy for this tool. */
+    permissionPolicy?: 'always_allow' | 'always_ask' | 'always_deny';
 };
 /**
  * Helper to define a single tool for use with `createSdkMcpServer`.

package/dist/mcp/tool-policy.d.ts

@@ -0,0 +1,6 @@
+import type { McpServerConfig, McpServerConfigForProcessTransport, McpServerToolPolicy } from '../types/mcp.js';
+import type { McpServerConfigForCliTransport, McpToolRuntimeOverride } from '../protocol/mcp.js';
+export declare function validateMcpToolExtension(serverName: string, policy: McpServerToolPolicy): void;
+export declare function collectMcpToolOverrides(serverName: string, policies: McpServerToolPolicy[]): Record<string, McpToolRuntimeOverride> | undefined;
+export declare function normalizeMcpServerForCli(serverName: string, config: McpServerConfigForProcessTransport, policies?: McpServerToolPolicy[]): McpServerConfigForCliTransport;
+export declare function normalizeRuntimeMcpServersForCli(servers: Record<string, McpServerConfig>): Record<string, McpServerConfigForCliTransport>;

package/dist/protocol/agents.d.ts

@@ -17,12 +17,9 @@ export type AgentDefinition = {
     prompt: string;
     model?: string;
     mcpServers?: AgentMcpServerSpec[];
-    criticalSystemReminder_EXPERIMENTAL?: string;
     skills?: string[];
     initialPrompt?: string;
     maxTurns?: number;
-    background?: boolean;
-    memory?: 'user' | 'project' | 'local';
     effort?: EffortLevel;
     permissionMode?: PermissionMode;
 };

package/dist/protocol/common.d.ts

@@ -164,15 +164,6 @@ export type ThinkingDisabled = {
     type: 'disabled';
 };
 export type ThinkingConfig = ThinkingAdaptive | ThinkingEnabled | ThinkingDisabled;
-export type OutputFormatType = 'json_schema';
-export type JsonSchemaOutputFormat = {
-    type: 'json_schema';
-    schema: Record<string, unknown>;
-};
-export type OutputFormat = JsonSchemaOutputFormat;
-export type BaseOutputFormat = {
-    type: OutputFormatType;
-};
 export type ModelContextWindowEntry = {
     token_count: number;
     is_default?: boolean;

package/dist/protocol/control.d.ts

@@ -13,12 +13,13 @@
  */
 import type { JSONRPCMessage } from '@modelcontextprotocol/sdk/types.js';
 import type { HookEvent, HookInput } from './hooks.js';
-import type { McpServerStatus, McpSetServersResult, McpServerStatusConfig, McpServerConfigForProcessTransport, OAuthToken } from './mcp.js';
+import type { McpServerStatus, McpSetServersResult, McpServerConfigForCliTransport, McpToolRuntimeOverride, OAuthToken } from './mcp.js';
 import type { PermissionMode, PermissionUpdate } from './permissions.js';
 import type { SDKMessage } from './messages.js';
 import type { AgentDefinition, AgentInfo } from './agents.js';
 import type { AccountInfo, FastModeState, ModelInfo, SlashCommand, SdkPluginConfig, UsageInfo } from './common.js';
 import type { PluginDetails } from '../types/plugins.js';
+import type { ModelPromptPatches } from './model-prompt-patches.js';
 export type SDKControlRequest = {
     type: 'control_request';
     request_id: string;
@@ -46,6 +47,23 @@ export type SDKControlCancelRequest = {
 };
 export type SDKControlInterruptRequest = {
     type: 'interrupt';
+    /**
+     * Cancel queued main-thread commands together with the active turn.
+     *
+     * This field requires the CLI capability
+     * `interrupt_cancel_queued_v1`.
+     */
+    cancel_queued?: boolean;
+};
+export type SDKControlInterruptResponse = {
+    /**
+     * UUIDs of queued messages that survive the interrupt and may still run.
+     */
+    still_queued: string[];
+    /**
+     * UUIDs cancelled by an interrupt request with `cancel_queued: true`.
+     */
+    cancelled?: string[];
 };
 export type SDKControlPermissionDecisionReasonType = 'rule' | 'mode' | 'subcommandResults' | 'permissionPromptTool' | 'hook' | 'asyncAgent' | 'workingDir' | 'safetyCheck' | 'classifier' | 'other';
 export type SDKControlPermissionRequest = {
@@ -71,7 +89,7 @@ export type SDKControlPermissionRequest = {
  * (just `{ type: 'sdk', name }`) on the wire and registers the instance
  * locally.
  */
-export type ControlMcpServerConfig = McpServerConfigForProcessTransport | McpServerStatusConfig;
+export type ControlMcpServerConfig = McpServerConfigForCliTransport;
 export type SDKControlInitializeRequest = {
     type: 'initialize';
     model?: string;
@@ -84,12 +102,13 @@ export type SDKControlInitializeRequest = {
     plugins?: SdkPluginConfig[];
     systemPrompt?: string;
     appendSystemPrompt?: string;
+    modelRequestPatches?: ModelPromptPatches;
     excludeDynamicSections?: boolean;
     permissionMode?: PermissionMode;
     maxThinkingTokens?: number;
     enableFileCheckpointing?: boolean;
     sdkMcpServers?: string[];
-    jsonSchema?: Record<string, unknown>;
+    sdkMcpToolOverrides?: Record<string, Record<string, McpToolRuntimeOverride>>;
     promptSuggestions?: boolean;
     supportsCatalogReadyInitialize?: boolean;
     initializeTimeoutMs?: number;
@@ -259,8 +278,8 @@ export type SDKControlRewindFilesRequest = {
     dry_run?: boolean;
 };
 export type SDKControlCancelAsyncMessageRequest = {
-    type: 'cancel_async_message';
-    message_id: string;
+    subtype: 'cancel_async_message';
+    message_uuid: string;
 };
 export type SDKControlSeedReadStateRequest = {
     type: 'seed_read_state';
@@ -308,10 +327,6 @@ export type SDKControlElicitationRequest = {
     options?: string[];
     tool_use_id?: string;
 };
-export type SDKControlStopTaskRequest = {
-    type: 'stop_task';
-    task_id: string;
-};
 export type SDKControlEndSessionRequest = {
     type: 'end_session';
     reason?: string;
@@ -453,7 +468,7 @@ export type SDKControlListPluginsRequest = {
 export type SDKControlListPluginsResponse = {
     plugins: PluginDetails[];
 };
-export type SDKControlRequestInner = SDKControlInterruptRequest | SDKControlPermissionRequest | SDKControlInitializeRequest | SDKControlSetPermissionModeRequest | SDKControlSetModelRequest | SDKControlSetProxyRequest | SDKControlGenerateSessionTitleRequest | SDKControlAddDirectoriesRequest | SDKControlSetMaxThinkingTokensRequest | SDKControlMcpStatusRequest | SDKControlGetContextUsageRequest | SDKControlGetUsageInfoRequest | SDKControlGetModelPolicyRequest | SDKControlAccountInfoRequest | SDKHookCallbackRequest | SDKControlMcpMessageRequest | SDKControlRewindFilesRequest | SDKControlCancelAsyncMessageRequest | SDKControlSeedReadStateRequest | SDKControlMcpSetServersRequest | SDKControlReloadPluginsRequest | SDKControlMcpReconnectRequest | SDKControlMcpToggleRequest | SDKControlApplyFlagSettingsRequest | SDKControlGetSettingsRequest | SDKControlElicitationRequest | SDKControlStopTaskRequest | SDKControlEndSessionRequest | SDKControlChannelEnableRequest | SDKControlMcpInjectTokenRequest | SDKControlMcpAuthenticateRequest | SDKControlMcpOAuthCallbackUrlRequest | SDKControlMcpClearAuthRequest | SDKControlGetByokConfigRequest | SDKControlValidateByokModelRequest | SDKControlListPluginsRequest;
+export type SDKControlRequestInner = SDKControlInterruptRequest | SDKControlPermissionRequest | SDKControlInitializeRequest | SDKControlSetPermissionModeRequest | SDKControlSetModelRequest | SDKControlSetProxyRequest | SDKControlGenerateSessionTitleRequest | SDKControlAddDirectoriesRequest | SDKControlSetMaxThinkingTokensRequest | SDKControlMcpStatusRequest | SDKControlGetContextUsageRequest | SDKControlGetUsageInfoRequest | SDKControlGetModelPolicyRequest | SDKControlAccountInfoRequest | SDKHookCallbackRequest | SDKControlMcpMessageRequest | SDKControlRewindFilesRequest | SDKControlCancelAsyncMessageRequest | SDKControlSeedReadStateRequest | SDKControlMcpSetServersRequest | SDKControlReloadPluginsRequest | SDKControlMcpReconnectRequest | SDKControlMcpToggleRequest | SDKControlApplyFlagSettingsRequest | SDKControlGetSettingsRequest | SDKControlElicitationRequest | SDKControlEndSessionRequest | SDKControlChannelEnableRequest | SDKControlMcpInjectTokenRequest | SDKControlMcpAuthenticateRequest | SDKControlMcpOAuthCallbackUrlRequest | SDKControlMcpClearAuthRequest | SDKControlGetByokConfigRequest | SDKControlValidateByokModelRequest | SDKControlListPluginsRequest;
 export type SDKControlInitializeResponse = {
     commands: SlashCommand[];
     agents: AgentInfo[];
@@ -579,5 +594,14 @@ export type SDKControlMcpAuthenticateResponse = {
 export type SDKKeepAliveMessage = {
     type: 'keep_alive';
 };
-export type StdoutMessage = SDKMessage | SDKControlResponse | SDKControlRequest | SDKControlCancelRequest | SDKKeepAliveMessage;
+/** SDK-internal post-commit transcript frame emitted by local runtimes. */
+export type TranscriptMirrorMessage = {
+    type: 'transcript_mirror';
+    filePath: string;
+    entries: Array<{
+        type: string;
+        [key: string]: unknown;
+    }>;
+};
+export type StdoutMessage = SDKMessage | SDKControlResponse | SDKControlRequest | SDKControlCancelRequest | SDKKeepAliveMessage | TranscriptMirrorMessage;
 export {};

package/dist/protocol/index.d.ts

@@ -13,13 +13,14 @@
  * `satisfies z.ZodType<X>`.
  */
 export { WIRE_PROTOCOL_VERSION, type WireProtocolVersion } from './version.js';
-export type { UUID, BetaMessage, BetaRawMessageStreamEvent, BetaUsage, BetaStopReason, MessageParam, NonNullableUsage, AccountInfo, UsageAddOnQuotaBucket, UsageInfo, UsageOrgResourcePackage, UsageQuotaBucket, ApiKeySource, ExitReason, FastModeState, ConfigScope, SettingSource, SDKAssistantMessageError, SDKStatus, EffortLevel, ThinkingAdaptive, ThinkingEnabled, ThinkingDisabled, ThinkingConfig, OutputFormatType, JsonSchemaOutputFormat, OutputFormat, BaseOutputFormat, ModelInfo, ModelSource, ServerModelJson, ServerModelJsonValue, ModelStrategy, ModelPromotion, LocalizedModelText, ModelContextConfig, ModelContextWindowEntry, ModelEffortEntry, ModelThinkingConfig, ModelThinkingDisabled, ModelThinkingEnabled, PluginInfo, ModelUsage, SlashCommand, ToolConfig, SdkPluginConfig, } from './common.js';
+export type { ModelPromptPatch, ModelPromptPatches, } from './model-prompt-patches.js';
+export type { UUID, BetaMessage, BetaRawMessageStreamEvent, BetaUsage, BetaStopReason, MessageParam, NonNullableUsage, AccountInfo, UsageAddOnQuotaBucket, UsageInfo, UsageOrgResourcePackage, UsageQuotaBucket, ApiKeySource, ExitReason, FastModeState, ConfigScope, SettingSource, SDKAssistantMessageError, SDKStatus, EffortLevel, ThinkingAdaptive, ThinkingEnabled, ThinkingDisabled, ThinkingConfig, ModelInfo, ModelSource, ServerModelJson, ServerModelJsonValue, ModelStrategy, ModelPromotion, LocalizedModelText, ModelContextConfig, ModelContextWindowEntry, ModelEffortEntry, ModelThinkingConfig, ModelThinkingDisabled, ModelThinkingEnabled, PluginInfo, ModelUsage, SlashCommand, ToolConfig, SdkPluginConfig, } from './common.js';
 export type { AICodeTrackingLaunchOptions, QoderAgentLaunchOptions, QoderCliFlagSettings, } from './launch.js';
 export { buildQoderCliFlagSettings, buildQoderCliFlagSettingsArgs, } from './launch.js';
 export type { PermissionMode, PermissionBehavior, PermissionDecisionClassification, PermissionUpdateDestination, PermissionRuleValue, PermissionUpdate, PermissionResult, } from './permissions.js';
 export type { McpStdioServerConfig, McpSSEServerConfig, McpHttpServerConfig, McpSdkServerConfig, McpServerConfigForProcessTransport, McpServerStatus, McpServerStatusConfig, McpSetServersResult, OAuthToken, } from './mcp.js';
-export type { SDKAssistantMessage, SDKUserMessage, SDKUserMessageReplay, SDKResultSuccess, SDKResultError, SDKResultMessage, SDKFileAttachment, SDKSystemMessage, SDKPartialAssistantMessage, SDKCompactBoundaryMessage, SDKStatusMessage, SDKAPIRetryMessage, SDKLocalCommandOutputMessage, SDKHookStartedMessage, SDKHookProgressMessage, SDKHookResponseMessage, SDKTaskNotificationMessage, SDKTaskStartedMessage, SDKTaskProgressMessage, SDKSessionStateChangedMessage, SDKSessionTitleChangedMessage, SDKBridgeStateMessage, SDKFilesPersistedEvent, SDKElicitationCompleteMessage, SDKPromptSuggestionMessage, SDKCloudAgentEventMessage, SDKPermissionDenial, SDKPermissionDeniedMessage, SDKPermissionDeniedReasonType, SDKMessage, } from './messages.js';
+export type { SDKAssistantMessage, SDKUserMessage, SDKUserMessageReplay, SDKResultSuccess, SDKResultError, SDKResultMessage, SDKFileAttachment, SDKSystemMessage, SDKPartialAssistantMessage, SDKCompactBoundaryMessage, SDKStatusMessage, SDKAPIRetryMessage, SDKHookStartedMessage, SDKHookProgressMessage, SDKHookResponseMessage, SDKTaskNotificationMessage, SDKTaskStartedMessage, SDKTaskProgressMessage, SDKSessionStateChangedMessage, SDKSessionTitleChangedMessage, SDKFilesPersistedEvent, SDKElicitationCompleteMessage, SDKPromptSuggestionMessage, SDKCloudAgentEventMessage, SDKPermissionDenial, SDKPermissionDeniedMessage, SDKPermissionDeniedReasonType, SDKMessage, } from './messages.js';
 export type { BaseHookInput, PreToolUseHookInput, PostToolUseHookInput, PostToolUseFailureHookInput, UserPromptSubmitHookInput, SessionStartHookInput, SessionEndHookInput, StopHookInput, StopFailureHookInput, SubagentStartHookInput, SubagentStopHookInput, PreCompactHookInput, PostCompactHookInput, PermissionRequestHookInput, PermissionDeniedHookInput, SetupHookInput, TeammateIdleHookInput, TaskCreatedHookInput, TaskCompletedHookInput, ElicitationHookInput, ElicitationResultHookInput, ConfigChangeHookInput, WorktreeCreateHookInput, WorktreeRemoveHookInput, InstructionsLoadedHookInput, CwdChangedHookInput, FileChangedHookInput, HookInput, PreToolUseHookSpecificOutput, PostToolUseHookSpecificOutput, PostToolUseFailureHookSpecificOutput, UserPromptSubmitHookSpecificOutput, SessionStartHookSpecificOutput, SetupHookSpecificOutput, SubagentStartHookSpecificOutput, PermissionRequestHookSpecificOutput, ElicitationHookSpecificOutput, ElicitationResultHookSpecificOutput, CwdChangedHookSpecificOutput, FileChangedHookSpecificOutput, WorktreeCreateHookSpecificOutput, SyncHookJSONOutput, AsyncHookJSONOutput, HookJSONOutput, HookEvent, } from './hooks.js';
 export type { AgentMcpServerSpec, AgentDefinition, AgentInfo, } from './agents.js';
 export { QoderModelPurpose } from './control.js';
-export type { SDKControlRequest, SDKControlResponse, SDKControlCancelRequest, SDKControlInterruptRequest, SDKControlPermissionRequest, SDKControlInitializeRequest, SDKControlSetPermissionModeRequest, SDKControlSetModelRequest, SDKControlGenerateSessionTitleRequest, SDKControlGenerateSessionTitleResponse, SDKControlAddDirectoriesRequest, SDKControlAddDirectoriesResponse, SDKControlGetModelPolicyRequest, SDKControlGetModelPolicyResponse, SDKControlSetMaxThinkingTokensRequest, SDKControlMcpStatusRequest, SDKControlGetContextUsageRequest, SDKControlGetUsageInfoRequest, SDKControlGetUsageInfoResponse, SDKControlAccountInfoRequest, SDKHookCallbackRequest, SDKControlMcpMessageRequest, SDKControlRewindFilesRequest, SDKControlCancelAsyncMessageRequest, SDKControlSeedReadStateRequest, SDKControlMcpSetServersRequest, SDKControlReloadPluginsRequest, SDKControlMcpReconnectRequest, SDKControlMcpToggleRequest, SDKControlApplyFlagSettingsRequest, SDKControlGetSettingsRequest, SDKControlElicitationRequest, SDKControlStopTaskRequest, SDKControlEndSessionRequest, SDKControlChannelEnableRequest, SDKControlMcpInjectTokenRequest, SDKControlMcpAuthenticateRequest, SDKControlMcpOAuthCallbackUrlRequest, SDKControlMcpClearAuthRequest, SDKControlRequestInner, SDKControlInitializeResponse, SDKControlGetContextUsageResponse, SDKControlReloadPluginsResponse, SDKControlMcpStatusResponse, SDKControlMcpSetServersResponse, SDKControlMcpAuthenticateResponse, SDKControlGetByokConfigRequest, SDKControlGetByokConfigResponse, SDKControlValidateByokModelRequest, SDKControlValidateByokModelResponse, BYOKModelValidationInput, BYOKProviderInfo, BYOKFieldInfo, BYOKModelTypeInfo, BYOKModelInfo, CustomModel, SDKControlListPluginsRequest, SDKControlListPluginsResponse, SDKKeepAliveMessage, StdoutMessage, ControlMcpServerConfig, } from './control.js';
+export type { SDKControlRequest, SDKControlResponse, SDKControlCancelRequest, SDKControlInterruptRequest, SDKControlInterruptResponse, SDKControlPermissionRequest, SDKControlInitializeRequest, SDKControlSetPermissionModeRequest, SDKControlSetModelRequest, SDKControlGenerateSessionTitleRequest, SDKControlGenerateSessionTitleResponse, SDKControlAddDirectoriesRequest, SDKControlAddDirectoriesResponse, SDKControlGetModelPolicyRequest, SDKControlGetModelPolicyResponse, SDKControlSetMaxThinkingTokensRequest, SDKControlMcpStatusRequest, SDKControlGetContextUsageRequest, SDKControlGetUsageInfoRequest, SDKControlGetUsageInfoResponse, SDKControlAccountInfoRequest, SDKHookCallbackRequest, SDKControlMcpMessageRequest, SDKControlRewindFilesRequest, SDKControlCancelAsyncMessageRequest, SDKControlSeedReadStateRequest, SDKControlMcpSetServersRequest, SDKControlReloadPluginsRequest, SDKControlMcpReconnectRequest, SDKControlMcpToggleRequest, SDKControlApplyFlagSettingsRequest, SDKControlGetSettingsRequest, SDKControlElicitationRequest, SDKControlEndSessionRequest, SDKControlChannelEnableRequest, SDKControlMcpInjectTokenRequest, SDKControlMcpAuthenticateRequest, SDKControlMcpOAuthCallbackUrlRequest, SDKControlMcpClearAuthRequest, SDKControlRequestInner, SDKControlInitializeResponse, SDKControlGetContextUsageResponse, SDKControlReloadPluginsResponse, SDKControlMcpStatusResponse, SDKControlMcpSetServersResponse, SDKControlMcpAuthenticateResponse, SDKControlGetByokConfigRequest, SDKControlGetByokConfigResponse, SDKControlValidateByokModelRequest, SDKControlValidateByokModelResponse, BYOKModelValidationInput, BYOKProviderInfo, BYOKFieldInfo, BYOKModelTypeInfo, BYOKModelInfo, CustomModel, SDKControlListPluginsRequest, SDKControlListPluginsResponse, SDKKeepAliveMessage, StdoutMessage, ControlMcpServerConfig, } from './control.js';

package/dist/protocol/index.js

@@ -1 +1 @@
-var r="1.0.0";function i(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}function s(e={}){let t={...e.settings??{}},o=e.aiCodeTracking?.installGitCommitHook;if(o!==void 0){let n=t.aiCodeTracking;t.aiCodeTracking={...i(n)?n:{},installGitCommitHook:o}}return t}function l(e={}){let t=s(e);return Object.keys(t).length===0?[]:["--settings",JSON.stringify(t)]}var p={Main:"main",Plan:"plan",Task:"task",Compact:"compact",Title:"title",Suggestion:"suggestion",Generate:"generate",HookPrompt:"hook_prompt",Subagent:"subagent",WebFetch:"web_fetch",ImageGen:"image_gen",Compression:"compression",Utility:"utility"};export{p as QoderModelPurpose,r as WIRE_PROTOCOL_VERSION,s as buildQoderCliFlagSettings,l as buildQoderCliFlagSettingsArgs};
+var r="1.1.0";function i(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}function s(e={}){let t={...e.settings??{}},o=e.aiCodeTracking?.installGitCommitHook;if(o!==void 0){let n=t.aiCodeTracking;t.aiCodeTracking={...i(n)?n:{},installGitCommitHook:o}}return t}function l(e={}){let t=s(e);return Object.keys(t).length===0?[]:["--settings",JSON.stringify(t)]}var p={Main:"main",Plan:"plan",Task:"task",Compact:"compact",Title:"title",Suggestion:"suggestion",Generate:"generate",HookPrompt:"hook_prompt",Subagent:"subagent",WebFetch:"web_fetch",ImageGen:"image_gen",Compression:"compression",Utility:"utility"};export{p as QoderModelPurpose,r as WIRE_PROTOCOL_VERSION,s as buildQoderCliFlagSettings,l as buildQoderCliFlagSettingsArgs};

package/dist/protocol/mcp.d.ts

@@ -15,22 +15,51 @@ export type McpStdioServerConfig = {
     command: string;
     args?: string[];
     env?: Record<string, string>;
+    /**
+     * Per-server tool-call timeout in milliseconds. Overrides the
+     * MCP_TOOL_TIMEOUT environment variable for this server. Hard wall-clock
+     * limit per call; progress notifications do not extend it. Values below
+     * 1000ms are ignored (falls through to MCP_TOOL_TIMEOUT or the default).
+     */
+    timeout?: number;
 };
 export type McpSSEServerConfig = {
     type: 'sse';
     url: string;
     headers?: Record<string, string>;
+    /**
+     * Per-server tool-call timeout in milliseconds. Overrides the
+     * MCP_TOOL_TIMEOUT environment variable for this server. Hard wall-clock
+     * limit per call; progress notifications do not extend it. Values below
+     * 1000ms are ignored (falls through to MCP_TOOL_TIMEOUT or the default).
+     */
+    timeout?: number;
 };
 export type McpHttpServerConfig = {
     type: 'http';
     url: string;
     headers?: Record<string, string>;
+    /**
+     * Per-server tool-call timeout in milliseconds. Overrides the
+     * MCP_TOOL_TIMEOUT environment variable for this server. Hard wall-clock
+     * limit per call; progress notifications do not extend it. Values below
+     * 1000ms are ignored (falls through to MCP_TOOL_TIMEOUT or the default).
+     */
+    timeout?: number;
 };
 export type McpSdkServerConfig = {
     type: 'sdk';
     name: string;
 };
+export type McpToolRuntimeOverride = {
+    exposedName?: string;
+    alwaysLoad?: boolean;
+};
 export type McpServerConfigForProcessTransport = McpStdioServerConfig | McpSSEServerConfig | McpHttpServerConfig | McpSdkServerConfig;
+/** Internal SDK -> CLI wire shape after public tool policies are normalized. */
+export type McpServerConfigForCliTransport = McpServerConfigForProcessTransport & {
+    toolOverrides?: Record<string, McpToolRuntimeOverride>;
+};
 export type McpServerStatus = {
     name: string;
     status: 'connected' | 'failed' | 'needs-auth' | 'pending' | 'disabled';

package/dist/protocol/messages.d.ts

@@ -18,6 +18,11 @@ export type SDKAssistantMessage = {
     message: BetaMessage;
     parent_tool_use_id: string | null;
     error?: SDKAssistantMessageError;
+    /**
+     * Present when an interrupt truncated the model stream before a stop reason
+     * arrived. The final content block may end mid-token.
+     */
+    aborted?: true;
     uuid: UUID;
     session_id: string;
 };
@@ -28,7 +33,17 @@ export type SDKUserMessage = {
     file_attachments?: SDKFileAttachment[];
     isSynthetic?: boolean;
     tool_use_result?: unknown;
+    /**
+     * Delivery priority. `next` is the default; `now` interrupts the active
+     * turn, while `later` waits for the session to become idle.
+     */
     priority?: 'now' | 'next' | 'later';
+    /**
+     * When false, do not start an assistant turn while the session is idle.
+     * Delivery still follows `priority`: `next` can inject at a safe boundary,
+     * `later` waits for idle, and `now` interrupts the active turn.
+     */
+    shouldQuery?: boolean;
     timestamp?: string;
     uuid?: UUID;
     session_id?: string;
@@ -40,7 +55,17 @@ export type SDKUserMessageReplay = {
     file_attachments?: SDKFileAttachment[];
     isSynthetic?: boolean;
     tool_use_result?: unknown;
+    /**
+     * Delivery priority. `next` is the default; `now` interrupts the active
+     * turn, while `later` waits for the session to become idle.
+     */
     priority?: 'now' | 'next' | 'later';
+    /**
+     * When false, do not start an assistant turn while the session is idle.
+     * Delivery still follows `priority`: `next` can inject at a safe boundary,
+     * `later` waits for idle, and `now` interrupts the active turn.
+     */
+    shouldQuery?: boolean;
     timestamp?: string;
     uuid: UUID;
     session_id: string;
@@ -60,7 +85,6 @@ export type SDKResultSuccess = {
     modelUsage: Record<string, ModelUsage>;
     permission_denials: SDKPermissionDenial[];
     error_code?: number;
-    structured_output?: unknown;
     deferred_tool_use?: unknown;
     terminal_reason?: string | null;
     fast_mode_state?: FastModeState;
@@ -69,7 +93,7 @@ export type SDKResultSuccess = {
 };
 export type SDKResultError = {
     type: 'result';
-    subtype: 'error_during_execution' | 'error_max_turns' | 'error_max_budget_usd' | 'error_max_structured_output_retries';
+    subtype: 'error_during_execution' | 'error_max_turns' | 'error_max_budget_usd';
     duration_ms: number;
     duration_api_ms: number;
     is_error: boolean;
@@ -117,6 +141,13 @@ export type SDKSystemMessage = {
     output_style: string;
     skills: string[];
     plugins: PluginInfo[];
+    /**
+     * Open protocol capability set advertised by the CLI.
+     *
+     * Consumers must check the capability required by each behavior and ignore
+     * unknown values.
+     */
+    capabilities?: string[];
     fast_mode_state?: FastModeState;
     uuid: UUID;
     session_id: string;
@@ -162,13 +193,6 @@ export type SDKAPIRetryMessage = {
     uuid: UUID;
     session_id: string;
 };
-export type SDKLocalCommandOutputMessage = {
-    type: 'system';
-    subtype: 'local_command_output';
-    content: string;
-    uuid: UUID;
-    session_id: string;
-};
 export type SDKHookStartedMessage = {
     type: 'system';
     subtype: 'hook_started';
@@ -268,14 +292,6 @@ export type SDKSessionTitleChangedMessage = {
     uuid: UUID;
     session_id: string;
 };
-export type SDKBridgeStateMessage = {
-    type: 'system';
-    subtype: 'bridge_state';
-    state: string;
-    detail?: string;
-    uuid: UUID;
-    session_id: string;
-};
 export type SDKFilesPersistedEvent = {
     type: 'system';
     subtype: 'files_persisted';
@@ -334,4 +350,4 @@ export type SDKPermissionDeniedMessage = {
     decision_reason_type?: SDKPermissionDeniedReasonType;
     decision_reason?: string;
 };
-export type SDKMessage = SDKAssistantMessage | SDKUserMessage | SDKUserMessageReplay | SDKResultMessage | SDKSystemMessage | SDKPermissionDeniedMessage | SDKPartialAssistantMessage | SDKCompactBoundaryMessage | SDKStatusMessage | SDKAPIRetryMessage | SDKLocalCommandOutputMessage | SDKHookStartedMessage | SDKHookProgressMessage | SDKHookResponseMessage | SDKTaskNotificationMessage | SDKTaskStartedMessage | SDKTaskProgressMessage | SDKSessionStateChangedMessage | SDKSessionTitleChangedMessage | SDKBridgeStateMessage | SDKFilesPersistedEvent | SDKElicitationCompleteMessage | SDKPromptSuggestionMessage | SDKCloudAgentEventMessage;
+export type SDKMessage = SDKAssistantMessage | SDKUserMessage | SDKUserMessageReplay | SDKResultMessage | SDKSystemMessage | SDKPermissionDeniedMessage | SDKPartialAssistantMessage | SDKCompactBoundaryMessage | SDKStatusMessage | SDKAPIRetryMessage | SDKHookStartedMessage | SDKHookProgressMessage | SDKHookResponseMessage | SDKTaskNotificationMessage | SDKTaskStartedMessage | SDKTaskProgressMessage | SDKSessionStateChangedMessage | SDKSessionTitleChangedMessage | SDKFilesPersistedEvent | SDKElicitationCompleteMessage | SDKPromptSuggestionMessage | SDKCloudAgentEventMessage;

package/dist/protocol/model-prompt-patches.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * A server-side patch applied to the system prompt after model routing.
+ */
+export type ModelPromptPatch = {
+    action: 'edit_system_prompt';
+    content: string;
+};
+/**
+ * Model routing key to the ordered prompt patches for that route.
+ *
+ * Route keys are opaque to the SDK and are forwarded without interpretation.
+ */
+export type ModelPromptPatches = Record<string, ModelPromptPatch[]>;

package/dist/protocol/version.d.ts

@@ -21,5 +21,5 @@
  * `system/init` JSONL message. The SDK validates it against the
  * version it was built against using semver.
  */
-export declare const WIRE_PROTOCOL_VERSION: "1.0.0";
+export declare const WIRE_PROTOCOL_VERSION: "1.1.0";
 export type WireProtocolVersion = string;

package/dist/query/query-runner.d.ts

@@ -21,19 +21,22 @@
  * 3. Implements all Query interface methods for the consumer.
  */
 import type { DiagnosticsSink } from '../core/sdk-diagnostics.js';
+import type { ModelPromptPatches } from '../protocol/model-prompt-patches.js';
 import type { Transport } from '../core/transport.js';
 import type { SDKMessage, SDKUserMessage } from '../types/messages.js';
 import type { InternalQuery, OnElicitation } from '../types/options.js';
 import type { FetchJobToken } from '../types/auth.js';
-import type { SDKControlInitializeResponse, SDKControlGetContextUsageResponse, SDKControlGenerateSessionTitleResponse, SDKControlAddDirectoriesResponse, SDKControlReloadPluginsResponse } from '../types/control.js';
+import type { SDKControlInterruptResponse, SDKControlInitializeResponse, SDKControlGetContextUsageResponse, SDKControlGenerateSessionTitleResponse, SDKControlAddDirectoriesResponse, SDKControlReloadPluginsResponse } from '../types/control.js';
 import type { PermissionMode, CanUseTool } from '../types/permissions.js';
 import type { HookCallbackMatcher } from '../types/hooks.js';
 import type { HookEvent as InternalHookEvent } from '../protocol/index.js';
 import type { McpServerConfig, McpServerStatus, McpSetServersResult, OAuthToken } from '../types/mcp.js';
+import type { McpToolRuntimeOverride } from '../protocol/mcp.js';
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { SdkMcpTransport } from '../mcp/sdk-mcp-transport.js';
 import { type PendingMcpResponse } from '../mcp/mcp-handler.js';
 import type { AgentDefinition, AgentInfo } from '../types/agents.js';
+import type { SessionStore, SessionStoreFlush } from '../session/session-store.js';
 import type { PluginDetails } from '../types/plugins.js';
 import type { ModelInfo, SlashCommand, AccountInfo, UsageInfo } from '../types/common.js';
 import type { ModelPolicyProvider } from '../types/model-policy-provider.js';
@@ -42,7 +45,7 @@ import type { BYOKModelValidationInput, BYOKProviderInfo } from '../types/byok.j
 type InitConfig = {
     systemPrompt?: string;
     appendSystemPrompt?: string;
-    planModeInstructions?: string;
+    modelRequestPatches?: ModelPromptPatches;
     agents?: Record<string, AgentDefinition>;
     skills?: string[];
     promptSuggestions?: boolean;
@@ -60,10 +63,10 @@ export declare class QueryRunner implements InternalQuery {
     private readonly sdkMcpServers;
     private readonly sdkMcpTransports;
     private readonly pendingMcpResponses;
+    private readonly sdkMcpToolOverrides;
     private readonly isSingleTurn;
     private readonly canUseTool?;
     private readonly abortController?;
-    private readonly jsonSchema?;
     private readonly initConfig;
     private readonly onElicitation?;
     private readonly onAuthExpired?;
@@ -72,6 +75,7 @@ export declare class QueryRunner implements InternalQuery {
     private readonly controlRequestTimeoutMs;
     private readonly resolveModel?;
     private readonly resolveModelTimeoutMs;
+    private readonly transcriptMirrorBatcher?;
     private initResponse?;
     private initializationPromise?;
     private resultMessage?;
@@ -81,7 +85,7 @@ export declare class QueryRunner implements InternalQuery {
     private protocolHandshakeValidated;
     private firstResultReceived;
     private firstResultReceivedResolve?;
-    constructor(transport: Transport, isSingleTurn: boolean, canUseTool?: CanUseTool, hooks?: Partial<Record<InternalHookEvent, HookCallbackMatcher[]>>, abortController?: AbortController, sdkMcpServers?: Map<string, McpServer>, jsonSchema?: Record<string, unknown>, initConfig?: InitConfig, onElicitation?: OnElicitation, diagnostics?: DiagnosticsSink, onAuthExpired?: () => void, controlRequestTimeoutMs?: number, sdkMcpTransports?: Map<string, SdkMcpTransport>, pendingMcpResponses?: Map<string, PendingMcpResponse>, fetchJobToken?: FetchJobToken, resolveModel?: ModelPolicyProvider, resolveModelTimeoutMs?: number);
+    constructor(transport: Transport, isSingleTurn: boolean, canUseTool?: CanUseTool, hooks?: Partial<Record<InternalHookEvent, HookCallbackMatcher[]>>, abortController?: AbortController, sdkMcpServers?: Map<string, McpServer>, initConfig?: InitConfig, onElicitation?: OnElicitation, diagnostics?: DiagnosticsSink, onAuthExpired?: () => void, controlRequestTimeoutMs?: number, sdkMcpTransports?: Map<string, SdkMcpTransport>, pendingMcpResponses?: Map<string, PendingMcpResponse>, fetchJobToken?: FetchJobToken, resolveModel?: ModelPolicyProvider, resolveModelTimeoutMs?: number, sessionStore?: SessionStore, sessionStoreFlush?: SessionStoreFlush, sdkMcpToolOverrides?: Record<string, Record<string, McpToolRuntimeOverride>>);
     private getRecord;
     private normalizeLogPreview;
     private extractMessagePreview;
@@ -191,7 +195,11 @@ export declare class QueryRunner implements InternalQuery {
     /**
      * Interrupt the current operation.
      */
-    interrupt(): Promise<void>;
+    interrupt(): Promise<SDKControlInterruptResponse | undefined>;
+    /**
+     * Drop a UUID-stamped async user message while it is still queued.
+     */
+    cancelAsyncMessage(messageUuid: string): Promise<boolean>;
     /**
      * Set the permission mode.
      */

package/dist/session/session-fork.d.ts

@@ -1,31 +1,5 @@
 import type { ForkSessionOptions, ForkSessionResult } from '../types/session.js';
 /**
- * Fork a session into a new independent session with fresh UUIDs.
- *
- * Creates a copy of the source session's JSONL file with all UUIDs
- * remapped to new values. This allows the forked session to diverge
- * from the original without sharing message identifiers.
- *
- * Optional parameters:
- * - `upToMessageId` — Only copy messages up to and including this message
- * - `title` — Set a custom title on the forked session
- * - `dir` — Restrict the session search to this working directory
- *
- * @param sessionId - The source session UUID to fork from
- * @param options - Fork options
- * @returns The new session's UUID
- * @throws Error if the source session is not found
- *
- * @example
- * ```ts
- * // Fork the entire session
- * const { sessionId: newId } = await forkSession('abc-123');
- *
- * // Fork up to a specific message with a custom title
- * const { sessionId } = await forkSession('abc-123', {
- *   upToMessageId: 'msg-456',
- *   title: 'Exploration branch',
- * });
- * ```
+ * Fork a session into a new independent session with remapped message IDs.
  */
 export declare function forkSession(sessionId: string, options?: ForkSessionOptions): Promise<ForkSessionResult>;

package/dist/session/session-import.d.ts

@@ -0,0 +1,10 @@
+import type { SessionStore } from './session-store.js';
+export type ImportSessionToStoreOptions = {
+    dir?: string;
+    includeSubagents?: boolean;
+    batchSize?: number;
+};
+/**
+ * Replay a local transcript and its subagent files into a SessionStore.
+ */
+export declare function importSessionToStore(sessionId: string, store: SessionStore, options?: ImportSessionToStoreOptions): Promise<void>;

package/dist/session/session-manager.d.ts

@@ -96,4 +96,6 @@ export declare function listSubagents(sessionId: string, options?: ListSubagents
  * @param options.offset - Number of messages to skip
  * @returns Array of session messages from the subagent
  */
-export declare function getSubagentMessages(sessionId: string, agentId: string, options?: GetSubagentMessagesOptions): Promise<SessionMessage[]>;
+export declare function getSubagentMessages(sessionId: string, agentId: string, options?: GetSubagentMessagesOptions): Promise<SessionMessage[]>;
+/** Delete a session and all child transcripts from a local or external store. */
+export declare function deleteSession(sessionId: string, options?: SessionMutationOptions): Promise<void>;

package/dist/session/session-materializer.d.ts

@@ -0,0 +1,15 @@
+import type { SessionStore } from './session-store.js';
+export type MaterializedSession = {
+    configDir: string;
+    projectKey: string;
+    sessionId: string;
+    cleanup(): Promise<void>;
+};
+export declare function materializeSessionFromStore(options: {
+    store: SessionStore;
+    cwd?: string;
+    resume?: string;
+    continue?: boolean;
+    loadTimeoutMs?: number;
+    env?: Record<string, string | undefined>;
+}): Promise<MaterializedSession | undefined>;

package/dist/session/session-store.d.ts

@@ -0,0 +1,45 @@
+export type SessionStoreEntry = {
+    type: string;
+    uuid?: string;
+    timestamp?: string;
+    [key: string]: unknown;
+};
+export type SessionKey = {
+    projectKey: string;
+    sessionId: string;
+    /** Opaque transcript suffix such as `subagents/agent-<id>` (without `.jsonl`). */
+    subpath?: string;
+};
+export type SessionStoreFlush = 'batched' | 'eager';
+export interface SessionStore {
+    append(key: SessionKey, entries: SessionStoreEntry[]): Promise<void>;
+    load(key: SessionKey): Promise<SessionStoreEntry[] | null>;
+    listSessions?(projectKey: string): Promise<Array<{
+        sessionId: string;
+        mtime: number;
+    }>>;
+    delete?(key: SessionKey): Promise<void>;
+    listSubkeys?(key: Omit<SessionKey, 'subpath'>): Promise<string[]>;
+}
+/** Reference store for tests, examples, and process-local integrations. */
+export declare class InMemorySessionStore implements SessionStore {
+    private readonly entries;
+    private readonly keys;
+    private readonly modifiedAt;
+    private lastModifiedAt;
+    append(key: SessionKey, entries: SessionStoreEntry[]): Promise<void>;
+    load(key: SessionKey): Promise<SessionStoreEntry[] | null>;
+    listSessions(projectKey: string): Promise<Array<{
+        sessionId: string;
+        mtime: number;
+    }>>;
+    delete(key: SessionKey): Promise<void>;
+    listSubkeys(key: Omit<SessionKey, 'subpath'>): Promise<string[]>;
+    /** Return all entries for a key. Intended for tests and local development. */
+    getEntries(key: SessionKey): SessionStoreEntry[];
+    /** Number of stored main transcripts. */
+    get size(): number;
+    /** Remove all stored entries. */
+    clear(): void;
+    private deleteSerialized;
+}

package/dist/session/transcript-mirror.d.ts

@@ -0,0 +1,25 @@
+import type { DiagnosticsSink } from '../core/sdk-diagnostics.js';
+import type { SDKMirrorErrorMessage } from '../types/messages.js';
+import type { SessionKey, SessionStore, SessionStoreEntry, SessionStoreFlush } from './session-store.js';
+export type TranscriptMirrorMessage = {
+    type: 'transcript_mirror';
+    filePath: string;
+    entries: SessionStoreEntry[];
+};
+export declare function isTranscriptMirrorMessage(value: unknown): value is TranscriptMirrorMessage;
+export declare class TranscriptMirrorBatcher {
+    private readonly options;
+    private readonly states;
+    constructor(options: {
+        store: SessionStore;
+        flushMode: SessionStoreFlush;
+        onMirrorError: (message: SDKMirrorErrorMessage) => void;
+        diagnostics?: DiagnosticsSink;
+        appendTimeoutMs?: number;
+        retryDelaysMs?: readonly number[];
+    });
+    enqueue(message: TranscriptMirrorMessage): void;
+    flush(): Promise<void>;
+    private drain;
+}
+export declare function sessionKeyFromTranscriptPath(filePath: string): SessionKey;

package/dist/session/transcript-paths.d.ts

@@ -7,8 +7,7 @@ export declare function homedir(): string;
  * Resolve the config directory that contains `projects/`.
  *
  * Resolution order:
- *   1. `QODER_CONFIG_DIR` — full path override (SDK-only escape hatch for
- *      tests / sandboxed setups; qodercli does not read this). When set,
+ *   1. `QODER_CONFIG_DIR` — full path override shared with qodercli. When set,
  *      `BRAND_CONFIG_DIR_INTERNAL` is NOT appended — the value is used as-is.
  *   2. `<homedir()>/<BRAND_CONFIG_DIR_INTERNAL>` — default, aligned with
  *      qodercli's `Storage.getGlobalConfigDir()`.