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

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()`.

package/dist/types/auth.d.ts

@@ -9,12 +9,31 @@
 export type AccessTokenInput = string | {
     envVar: string;
 };
+export type ServiceAccountKeyInput = string | {
+    envVar: string;
+};
+export type ServiceAccountTokenResult = {
+    token: string;
+    /** Absolute expiration time as a Unix timestamp in milliseconds. */
+    expiresAt?: number;
+};
+export type FetchServiceAccountToken = () => Promise<ServiceAccountTokenResult | null>;
+export type ServiceAccountCredentials = {
+    serviceAccountKey: ServiceAccountKeyInput;
+    fetchServiceAccountToken?: never;
+} | {
+    serviceAccountKey?: never;
+    fetchServiceAccountToken: FetchServiceAccountToken;
+};
+export type ServiceAccountAuthOptions = {
+    type: 'serviceAccount';
+} & ServiceAccountCredentials;
 export type AuthOptions = {
     type: 'accessToken';
     accessToken: AccessTokenInput;
 } | {
     type: 'qodercli';
-};
+} | ServiceAccountAuthOptions;
 export type JobTokenRequest = {
     requestId: string;
     reason: 'initial' | 'unauthorized';
@@ -47,5 +66,11 @@ export type SdkAuthPayload = {
     type: 'qodercli';
 } | {
     type: 'jobToken';
-    hostTokenCallback: true;
+    jobTokenProvider: 'host';
+} | {
+    type: 'serviceAccount';
+    serviceAccountKey: string;
+} | {
+    type: 'serviceAccount';
+    serviceAccountTokenProvider: 'host';
 };

package/dist/types/common.d.ts

@@ -5,4 +5,4 @@
  * shim so existing SDK consumer imports (`'./types/common.js'` paths)
  * keep working.
  */
-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 '../protocol/index.js';
+export type { UUID, BetaMessage, BetaRawMessageStreamEvent, BetaUsage, BetaStopReason, MessageParam, NonNullableUsage, AccountInfo, UsageAddOnQuotaBucket, UsageInfo, UsageOrgResourcePackage, UsageQuotaBucket, SessionCreditsUsage, 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 '../protocol/index.js';

package/dist/types/control.d.ts

@@ -5,7 +5,7 @@
  * shim so existing SDK consumer imports keep working.
  */
 export type { QoderModelPurpose } from '../protocol/index.js';
-export type { SDKControlRequest, SDKControlResponse, SDKControlCancelRequest, SDKControlInterruptRequest, SDKControlPermissionRequest, SDKControlInitializeRequest, SDKControlSetPermissionModeRequest, SDKControlSetModelRequest, SDKControlGenerateSessionTitleRequest, SDKControlGenerateSessionTitleResponse, SDKControlAddDirectoriesRequest, SDKControlAddDirectoriesResponse, SDKControlGetModelPolicyRequest, SDKControlGetByokConfigRequest, SDKControlGetByokConfigResponse, SDKControlValidateByokModelRequest, SDKControlValidateByokModelResponse, 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, SDKControlListPluginsRequest, SDKControlListPluginsResponse, SDKControlMcpStatusResponse, SDKControlMcpSetServersResponse, SDKKeepAliveMessage, StdoutMessage, ControlMcpServerConfig, BYOKModelValidationInput, } from '../protocol/index.js';
+export type { SDKControlRequest, SDKControlResponse, SDKControlCancelRequest, SDKControlInterruptRequest, SDKControlInterruptResponse, SDKControlPermissionRequest, SDKControlInitializeRequest, SDKControlSetPermissionModeRequest, SDKControlSetModelRequest, SDKControlGenerateSessionTitleRequest, SDKControlGenerateSessionTitleResponse, SDKControlAddDirectoriesRequest, SDKControlAddDirectoriesResponse, SDKControlGetModelPolicyRequest, SDKControlGetByokConfigRequest, SDKControlGetByokConfigResponse, SDKControlValidateByokModelRequest, SDKControlValidateByokModelResponse, 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, SDKControlListPluginsRequest, SDKControlListPluginsResponse, SDKControlMcpStatusResponse, SDKControlMcpSetServersResponse, SDKKeepAliveMessage, StdoutMessage, ControlMcpServerConfig, BYOKModelValidationInput, } from '../protocol/index.js';
 /** Wire format for fetch_job_token inbound control request from CLI. */
 export type FetchJobTokenWireRequest = {
     subtype: 'fetch_job_token';
@@ -15,4 +15,16 @@ export type FetchJobTokenWireRequest = {
 /** Wire format for fetch_job_token success response. */
 export type FetchJobTokenWireResponse = {
     token: string;
+};
+/** Wire format for Service Account token requests sent by qodercli. */
+export type FetchServiceAccountTokenWireRequest = {
+    subtype: 'fetch_service_account_token';
+    reason: 'initial' | 'expiring' | 'unauthorized';
+    required_scopes: string[];
+    session_id?: string;
+};
+/** Wire format for successful Service Account token responses. */
+export type FetchServiceAccountTokenWireResponse = {
+    token: string;
+    expires_at?: number;
 };

package/dist/types/hooks.d.ts

@@ -5,7 +5,7 @@
  * `../protocol/`. The SDK-local HookEvent/HookInput contract is
  * intentionally narrowed to events supported by SDK user configuration.
  */
-export type { BaseHookInput, PreToolUseHookInput, PostToolUseHookInput, PostToolUseFailureHookInput, UserPromptSubmitHookInput, SessionStartHookInput, SessionEndHookInput, StopHookInput, SubagentStartHookInput, SubagentStopHookInput, PreCompactHookInput, PostCompactHookInput, PermissionRequestHookInput, InstructionsLoadedHookInput, CwdChangedHookInput, FileChangedHookInput, PostToolUseFailureHookSpecificOutput, UserPromptSubmitHookSpecificOutput, SessionStartHookSpecificOutput, SubagentStartHookSpecificOutput, PermissionRequestHookSpecificOutput, CwdChangedHookSpecificOutput, FileChangedHookSpecificOutput, } from '../protocol/index.js';
+export type { BaseHookInput, PreToolUseHookInput, PostToolUseHookInput, PostToolUseFailureHookInput, UserPromptSubmitHookInput, SessionStartHookInput, SessionEndHookInput, StopHookInput, SubagentStartHookInput, SubagentStopHookInput, PreCompactHookInput, PostCompactHookInput, PermissionRequestHookInput, PermissionDeniedHookInput, InstructionsLoadedHookInput, CwdChangedHookInput, FileChangedHookInput, PostToolUseFailureHookSpecificOutput, UserPromptSubmitHookSpecificOutput, SessionStartHookSpecificOutput, SubagentStartHookSpecificOutput, PermissionRequestHookSpecificOutput, CwdChangedHookSpecificOutput, FileChangedHookSpecificOutput, } from '../protocol/index.js';
 import type { AsyncHookJSONOutput as ProtocolAsyncHookJSONOutput, CwdChangedHookSpecificOutput, FileChangedHookSpecificOutput, HookInput as ProtocolHookInput, PostToolUseHookSpecificOutput as ProtocolPostToolUseHookSpecificOutput, PostToolUseFailureHookSpecificOutput, PreToolUseHookSpecificOutput as ProtocolPreToolUseHookSpecificOutput, PermissionRequestHookSpecificOutput, SessionStartHookSpecificOutput, SubagentStartHookSpecificOutput, SyncHookJSONOutput as ProtocolSyncHookJSONOutput, UserPromptSubmitHookSpecificOutput } from '../protocol/index.js';
 import type { HookEventConst } from '../core/constants.js';
 /**

package/dist/types/index.d.ts

@@ -15,11 +15,10 @@ export type { HookEvent, HookPermissionDecision, HookCallback, HookCallbackMatch
 export * from './mcp.js';
 export * from './agents.js';
 export * from './session.js';
+export type { SessionKey, SessionStore, SessionStoreEntry, SessionStoreFlush, } from '../session/session-store.js';
 export * from './settings.js';
 export * from './cloud-agent.js';
 export * from './control.js';
 export * from './model-policy-provider.js';
-export * from './bridge.js';
-export * from './browser.js';
 export * from './tools.js';
-export type { AccessTokenInput, AuthOptions, FetchJobToken, JobTokenAuthOptions, JobTokenRequest, JobTokenResult, } from './auth.js';
+export type { AccessTokenInput, AuthOptions, FetchServiceAccountToken, FetchJobToken, JobTokenAuthOptions, JobTokenRequest, JobTokenResult, ServiceAccountAuthOptions, ServiceAccountCredentials, ServiceAccountKeyInput, ServiceAccountTokenResult, } from './auth.js';

package/dist/types/mcp.d.ts

@@ -9,16 +9,22 @@ import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { McpStdioServerConfig as ProtocolMcpStdioServerConfig, McpSSEServerConfig as ProtocolMcpSSEServerConfig, McpHttpServerConfig as ProtocolMcpHttpServerConfig, McpSdkServerConfig as ProtocolMcpSdkServerConfig } from '../protocol/index.js';
 export type McpServerToolPolicy = {
     name: string;
-    permission_policy: 'always_allow' | 'always_ask' | 'always_deny';
+    permission_policy?: 'always_allow' | 'always_ask' | 'always_deny';
+    exposedName?: string;
+    alwaysLoad?: boolean;
+};
+export type McpStdioServerConfig = ProtocolMcpStdioServerConfig & {
+    tools?: McpServerToolPolicy[];
 };
-export type McpStdioServerConfig = ProtocolMcpStdioServerConfig;
 export type McpSSEServerConfig = ProtocolMcpSSEServerConfig & {
     tools?: McpServerToolPolicy[];
 };
 export type McpHttpServerConfig = ProtocolMcpHttpServerConfig & {
     tools?: McpServerToolPolicy[];
 };
-export type McpSdkServerConfig = ProtocolMcpSdkServerConfig;
+export type McpSdkServerConfig = ProtocolMcpSdkServerConfig & {
+    tools?: McpServerToolPolicy[];
+};
 export type McpServerConfigForProcessTransport = McpStdioServerConfig | McpSSEServerConfig | McpHttpServerConfig | McpSdkServerConfig;
 export type McpServerStatusConfig = McpServerConfigForProcessTransport;
 export type { McpServerStatus, McpSetServersResult, OAuthToken, } from '../protocol/index.js';

package/dist/types/messages.d.ts

@@ -8,14 +8,25 @@
 import type { SDKMessage as ProtocolSDKMessage, SDKStatusMessage as ProtocolSDKStatusMessage, SDKSystemMessage as ProtocolSDKSystemMessage, SDKUserMessage as ProtocolSDKUserMessage, SDKUserMessageReplay as ProtocolSDKUserMessageReplay } from '../protocol/index.js';
 import type { MessageParam, UUID } from './common.js';
 import type { PermissionMode } from './permissions.js';
-export type { SDKAssistantMessage, SDKResultSuccess, SDKResultError, SDKResultMessage, SDKPartialAssistantMessage, SDKCompactBoundaryMessage, SDKAPIRetryMessage, SDKLocalCommandOutputMessage, SDKHookStartedMessage, SDKHookProgressMessage, SDKHookResponseMessage, SDKTaskNotificationMessage, SDKTaskStartedMessage, SDKTaskProgressMessage, SDKSessionStateChangedMessage, SDKSessionTitleChangedMessage, SDKBridgeStateMessage, SDKFilesPersistedEvent, SDKElicitationCompleteMessage, SDKPromptSuggestionMessage, SDKCloudAgentEventMessage, SDKPermissionDenial, } from '../protocol/index.js';
+import type { SessionKey } from '../session/session-store.js';
+export type { SDKAssistantMessage, SDKResultSuccess, SDKResultError, SDKResultMessage, SDKPartialAssistantMessage, SDKCompactBoundaryMessage, SDKAPIRetryMessage, SDKHookStartedMessage, SDKHookProgressMessage, SDKHookResponseMessage, SDKTaskNotificationMessage, SDKTaskStartedMessage, SDKTaskProgressMessage, SDKSessionStateChangedMessage, SDKSessionTitleChangedMessage, SDKFilesPersistedEvent, SDKElicitationCompleteMessage, SDKPromptSuggestionMessage, SDKCloudAgentEventMessage, SDKPermissionDenial, } from '../protocol/index.js';
 export type SDKUserMessage = {
     type: 'user';
     message: MessageParam;
     parent_tool_use_id: string | null;
     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;
@@ -43,7 +54,15 @@ export type SDKPermissionDeniedMessage = {
     uuid: string;
     session_id: string;
 };
-export type SDKMessage = Exclude<ProtocolSDKMessage, ProtocolSDKSystemMessage | ProtocolSDKStatusMessage | ProtocolSDKUserMessage | ProtocolSDKUserMessageReplay> | SDKUserMessage | SDKUserMessageReplay | SDKSystemInitMessage | SDKStatusMessage | SDKPermissionDeniedMessage;
+export type SDKMirrorErrorMessage = {
+    type: 'system';
+    subtype: 'mirror_error';
+    error: string;
+    key: SessionKey;
+    uuid: string;
+    session_id: string;
+};
+export type SDKMessage = Exclude<ProtocolSDKMessage, ProtocolSDKSystemMessage | ProtocolSDKStatusMessage | ProtocolSDKUserMessage | ProtocolSDKUserMessageReplay> | SDKUserMessage | SDKUserMessageReplay | SDKSystemInitMessage | SDKStatusMessage | SDKPermissionDeniedMessage | SDKMirrorErrorMessage;
 export type SDKSystemMessage = Extract<SDKMessage, {
     type: 'system';
 }>;

package/dist/types/options.d.ts

@@ -8,13 +8,15 @@ import type { HookCallbackMatcher, HookEvent } from './hooks.js';
 import type { McpServerConfig, McpServerStatus, McpSetServersResult, OAuthToken } from './mcp.js';
 import type { SDKMessage, SDKUserMessage } from './messages.js';
 import type { Settings } from './settings.js';
-import type { SDKControlInitializeResponse, SDKControlGetContextUsageResponse, SDKControlGenerateSessionTitleResponse, SDKControlAddDirectoriesResponse, SDKControlReloadPluginsResponse, StdoutMessage } from './control.js';
+import type { SDKControlInterruptResponse, SDKControlInitializeResponse, SDKControlGetContextUsageResponse, SDKControlGenerateSessionTitleResponse, SDKControlAddDirectoriesResponse, SDKControlReloadPluginsResponse, StdoutMessage } from './control.js';
 import type { ModelPolicyProvider } from './model-policy-provider.js';
 import type { BYOKModelValidationInput, BYOKProviderInfo } from './byok.js';
 import type { RewindFilesResult } from './session.js';
 import type { CloudAgentOptions } from './cloud-agent.js';
 import type { QueryTransportProviderOption } from '../core/query-transport.js';
 import type { PluginDetails } from './plugins.js';
+import type { SessionStore, SessionStoreFlush } from '../session/session-store.js';
+import type { ModelPromptPatches } from '../protocol/model-prompt-patches.js';
 export type { CanUseTool };
 export type { AuthOptions };
 export type ElicitationRequest = {
@@ -64,6 +66,12 @@ export type Options = {
      *   Prefer the `accessTokenFromEnv()` helper in host code.
      * - `{ type: 'qodercli' }` - Read-only reuse of local `qodercli login`
      *   state. Prefer the `qodercliAuth()` helper in host code.
+     * - `{ type: 'serviceAccount', serviceAccountKey }` - Exchange a Service
+     *   Account key for short-lived model access. Prefer `serviceAccount()` or
+     *   `serviceAccountFromEnv()`.
+     * - `{ type: 'serviceAccount', fetchServiceAccountToken }` - Let the host
+     *   supply and refresh short-lived Service Account tokens through
+     *   `serviceAccount()`.
      * - `{ type: 'jobToken', fetchJobToken }` - Internal first-party host
      *   integration. Prefer the `jobToken(fetchJobToken)` helper in host code.
      *
@@ -109,9 +117,9 @@ export type Options = {
      *   `name` / directory name, or `plugin:skill` for plugin-qualified skills.
      *   Adds `"Skill(<name>)"` for each entry to allowedTools.
      *
-     * This is a context filter, not a sandbox: unlisted skills are hidden from
-     * the model's listing and rejected by the Skill tool, but their files
-     * remain on disk and are reachable via Read/Bash.
+     * This is a context filter, not a security boundary: unlisted skills are
+     * hidden from the model's listing and rejected by the Skill tool, but their
+     * files remain on disk and are reachable via Read/Bash.
      */
     skills?: string[] | 'all';
     extensions?: string[];
@@ -167,11 +175,6 @@ export type Options = {
     model?: string;
     pathToQoderCLIExecutable?: string;
     permissionMode?: PermissionMode;
-    /**
-     * Custom workflow instructions for plan mode. When `permissionMode` is
-     * `plan`, the CLI uses this text as the plan-mode workflow body.
-     */
-    planModeInstructions?: string;
     allowDangerouslySkipPermissions?: boolean;
     /**
      * MCP tool name to use for permission prompts. Mutually exclusive with
@@ -180,7 +183,21 @@ export type Options = {
     permissionPromptToolName?: string;
     plugins?: SdkPluginConfig[];
     promptSuggestions?: boolean;
+    /**
+     * Persist the local session transcript. Defaults to true.
+     *
+     * Set to false for an ephemeral query that cannot be resumed. This option
+     * cannot be combined with sessionStore because external mirroring consumes
+     * locally committed transcript entries.
+     */
+    persistSession?: boolean;
     resume?: string;
+    /** Mirrors locally committed transcript entries to an external store. */
+    sessionStore?: SessionStore;
+    /** `batched` flushes at result boundaries; `eager` drains every CLI frame. */
+    sessionStoreFlush?: SessionStoreFlush;
+    /** Timeout for loading a session from an external store. Defaults to 60 seconds. */
+    loadTimeoutMs?: number;
     sessionId?: string;
     settings?: string | Settings;
     settingSources?: SettingSource[];
@@ -191,6 +208,11 @@ export type Options = {
         preset: 'qodercli';
         append?: string;
     };
+    /**
+     * Prompt patches forwarded to the model service for model-aware system
+     * prompt selection. Route keys are interpreted by the service.
+     */
+    modelRequestPatches?: ModelPromptPatches;
     /**
      * Pull-mode model selection callback.
      *
@@ -263,7 +285,25 @@ export interface SpawnedProcess {
  * 配置 MCP servers 请通过 `Options.mcpServers`（启动时一次性配置）。
  */
 export interface Query extends AsyncGenerator<SDKMessage, void> {
-    interrupt(): Promise<void>;
+    /**
+     * Request interruption of the active turn.
+     *
+     * CLIs advertising `interrupt_receipt_v1` return UUIDs of queued messages
+     * that survive the interrupt. Older CLIs return `undefined`.
+     */
+    interrupt(): Promise<SDKControlInterruptResponse | undefined>;
+    /**
+     * Remove a UUID-stamped async user message while it is still queued.
+     *
+     * Returns `true` only when the CLI removes that UUID from the queue.
+     *
+     * After messages have been dequeued into the in-flight coalesced batch, this
+     * method returns `false`. While that reservation remains active, cancelling
+     * the last UUID-bearing message marks the batch to be dropped; cancelling a
+     * non-representative UUID is a no-op. `false` alone does not prove a batch
+     * was dropped.
+     */
+    cancelAsyncMessage(messageUuid: string): Promise<boolean>;
     setPermissionMode(mode: PermissionMode): Promise<void>;
     setModel(model?: string): Promise<void>;
     /**

package/dist/types/session.d.ts

@@ -26,6 +26,11 @@ export type SessionMessage = {
     session_id: string;
     message: unknown;
     parent_tool_use_id: string | null;
+    /**
+     * Agent ID of the subagent that spawned this subagent. Null for main-session
+     * messages, depth-one subagents, and transcripts without this metadata.
+     */
+    parent_agent_id: string | null;
     /**
      * ISO 8601 timestamp of when this transcript entry was written to the
      * jsonl file. Mirrors the on-disk `timestamp` field. Optional because
@@ -61,16 +66,19 @@ export type SessionMessage = {
         };
     };
 };
-export type ListSessionsOptions = {
+type SessionStoreOptions = {
+    sessionStore?: SessionStore;
+};
+export type ListSessionsOptions = SessionStoreOptions & {
     dir?: string;
     limit?: number;
     offset?: number;
     includeWorktrees?: boolean;
 };
-export type GetSessionInfoOptions = {
+export type GetSessionInfoOptions = SessionStoreOptions & {
     dir?: string;
 };
-export type GetSessionMessagesOptions = {
+export type GetSessionMessagesOptions = SessionStoreOptions & {
     dir?: string;
     limit?: number;
     offset?: number;
@@ -80,15 +88,15 @@ export type GetSessionMessagesOptions = {
      */
     includeSystemMessages?: boolean;
 };
-export type GetSubagentMessagesOptions = {
+export type GetSubagentMessagesOptions = SessionStoreOptions & {
     dir?: string;
     limit?: number;
     offset?: number;
 };
-export type ListSubagentsOptions = {
+export type ListSubagentsOptions = SessionStoreOptions & {
     dir?: string;
 };
-export type SessionMutationOptions = {
+export type SessionMutationOptions = SessionStoreOptions & {
     dir?: string;
 };
 export type ForkSessionOptions = SessionMutationOptions & {
@@ -106,4 +114,6 @@ export type RewindFilesResult = {
     filesChanged?: string[];
     insertions?: number;
     deletions?: number;
-};
+};
+import type { SessionStore } from '../session/session-store.js';
+export {};