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

package/dist/protocol/agents.d.ts

@@ -10,6 +10,7 @@ import type { McpServerConfigForProcessTransport } from './mcp.js';
 import type { EffortLevel } from './common.js';
 import type { PermissionMode } from './permissions.js';
 export type AgentMcpServerSpec = string | Record<string, McpServerConfigForProcessTransport>;
+export type AgentMemoryScope = 'user' | 'project' | 'local';
 export type AgentDefinition = {
     description: string;
     tools?: string[];
@@ -22,6 +23,12 @@ export type AgentDefinition = {
     maxTurns?: number;
     effort?: EffortLevel;
     permissionMode?: PermissionMode;
+    /** Run this agent asynchronously whenever it is invoked. */
+    background?: boolean;
+    /** Persistent memory scope loaded for this agent. */
+    memory?: AgentMemoryScope;
+    /** Isolate this agent in a temporary git worktree. */
+    isolation?: 'worktree';
 };
 export type AgentInfo = {
     name: string;

package/dist/protocol/control.d.ts

@@ -281,6 +281,12 @@ export type SDKControlRewindFilesRequest = {
     user_message_id: string;
     dry_run?: boolean;
 };
+export type SDKControlRewindRequest = {
+    type: 'rewind';
+    user_message_id: string;
+    scope?: 'conversation' | 'files' | 'both';
+    dry_run?: boolean;
+};
 export type SDKControlCancelAsyncMessageRequest = {
     subtype: 'cancel_async_message';
     message_uuid: string;
@@ -472,7 +478,25 @@ 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 | SDKControlEndSessionRequest | SDKControlChannelEnableRequest | SDKControlMcpInjectTokenRequest | SDKControlMcpAuthenticateRequest | SDKControlMcpOAuthCallbackUrlRequest | SDKControlMcpClearAuthRequest | SDKControlGetByokConfigRequest | SDKControlValidateByokModelRequest | SDKControlListPluginsRequest;
+/** Stop one running task by its stable public task ID. */
+export type SDKControlStopTaskRequest = {
+    subtype: 'stop_task';
+    task_id: string;
+};
+/**
+ * Move foreground Bash/Agent executions into the background. With a tool use
+ * ID only the matching execution is targeted; without it all eligible
+ * foreground executions are targeted.
+ */
+export type SDKControlBackgroundTasksRequest = {
+    subtype: 'background_tasks';
+    tool_use_id?: string;
+};
+export type SDKControlBackgroundTasksResponse = {
+    /** Present for a targeted tool use. Bulk backgrounding may omit the body. */
+    backgrounded?: boolean;
+};
+export type SDKControlRequestInner = SDKControlInterruptRequest | SDKControlPermissionRequest | SDKControlInitializeRequest | SDKControlSetPermissionModeRequest | SDKControlSetModelRequest | SDKControlSetProxyRequest | SDKControlGenerateSessionTitleRequest | SDKControlAddDirectoriesRequest | SDKControlSetMaxThinkingTokensRequest | SDKControlMcpStatusRequest | SDKControlGetContextUsageRequest | SDKControlGetUsageInfoRequest | SDKControlGetModelPolicyRequest | SDKControlAccountInfoRequest | SDKHookCallbackRequest | SDKControlMcpMessageRequest | SDKControlRewindFilesRequest | SDKControlRewindRequest | SDKControlCancelAsyncMessageRequest | SDKControlSeedReadStateRequest | SDKControlMcpSetServersRequest | SDKControlReloadPluginsRequest | SDKControlMcpReconnectRequest | SDKControlMcpToggleRequest | SDKControlApplyFlagSettingsRequest | SDKControlGetSettingsRequest | SDKControlElicitationRequest | SDKControlEndSessionRequest | SDKControlChannelEnableRequest | SDKControlMcpInjectTokenRequest | SDKControlMcpAuthenticateRequest | SDKControlMcpOAuthCallbackUrlRequest | SDKControlMcpClearAuthRequest | SDKControlGetByokConfigRequest | SDKControlValidateByokModelRequest | SDKControlListPluginsRequest | SDKControlStopTaskRequest | SDKControlBackgroundTasksRequest;
 export type SDKControlInitializeResponse = {
     commands: SlashCommand[];
     agents: AgentInfo[];
@@ -486,6 +510,8 @@ export type SDKControlInitializeResponse = {
     models: ModelInfo[];
     account: AccountInfo;
     fast_mode_state?: FastModeState;
+    /** Optional features implemented by the connected CLI control channel. */
+    capabilities?: string[];
 };
 export type SDKControlGetContextUsageResponse = {
     categories: Array<{

package/dist/protocol/hooks.d.ts

@@ -15,6 +15,8 @@ export type BaseHookInput = {
     session_id: string;
     transcript_path: string;
     cwd: string;
+    /** Human-readable display name of the model responsible for this event. */
+    model?: string;
     permission_mode?: string;
     agent_id?: string;
     agent_type?: string;
@@ -48,7 +50,6 @@ export type SessionStartHookInput = BaseHookInput & {
     hook_event_name: 'SessionStart';
     source: 'startup' | 'resume' | 'clear' | 'compact';
     agent_type?: string;
-    model?: string;
 };
 export type SessionEndHookInput = BaseHookInput & {
     hook_event_name: 'SessionEnd';

package/dist/protocol/index.d.ts

@@ -19,8 +19,8 @@ export type { AICodeTrackingLaunchOptions, QoderAgentLaunchOptions, QoderCliFlag
 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, SDKHookStartedMessage, SDKHookProgressMessage, SDKHookResponseMessage, SDKTaskNotificationMessage, SDKTaskStartedMessage, SDKTaskProgressMessage, SDKSessionStateChangedMessage, SDKSessionTitleChangedMessage, 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, SDKTaskUpdatedMessage, SDKBackgroundTasksChangedMessage, 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 type { AgentMcpServerSpec, AgentDefinition, AgentInfo, AgentMemoryScope, } from './agents.js';
 export { QoderModelPurpose } 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';
+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, SDKControlRewindRequest, 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, SDKControlStopTaskRequest, SDKControlBackgroundTasksRequest, SDKControlBackgroundTasksResponse, SDKKeepAliveMessage, StdoutMessage, ControlMcpServerConfig, } from './control.js';

package/dist/protocol/index.js

@@ -1 +1 @@
-var r="1.1.0";function i(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}function n(e={}){let t={...e.settings??{}},o=e.aiCodeTracking?.installGitCommitHook;if(o!==void 0){let s=t.aiCodeTracking;t.aiCodeTracking={...i(s)?s:{},installGitCommitHook:o}}return t}function l(e={}){let t=n(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,n as buildQoderCliFlagSettings,l as buildQoderCliFlagSettingsArgs};
+var r="1.2.0";function i(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}function n(e={}){let t={...e.settings??{}},o=e.aiCodeTracking?.installGitCommitHook;if(o!==void 0){let s=t.aiCodeTracking;t.aiCodeTracking={...i(s)?s:{},installGitCommitHook:o}}return t}function l(e={}){let t=n(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,n as buildQoderCliFlagSettings,l as buildQoderCliFlagSettingsArgs};

package/dist/protocol/messages.d.ts

@@ -17,6 +17,8 @@ export type SDKAssistantMessage = {
     type: 'assistant';
     message: BetaMessage;
     parent_tool_use_id: string | null;
+    /** Qoder model request ID, present only when explicitly enabled in the CLI. */
+    request_id?: string;
     error?: SDKAssistantMessageError;
     /**
      * Present when an interrupt truncated the model stream before a stop reason
@@ -254,9 +256,12 @@ export type SDKTaskStartedMessage = {
     task_id: string;
     tool_use_id?: string;
     description: string;
+    subagent_type?: string;
     task_type?: string;
     workflow_name?: string;
     prompt?: string;
+    /** Final tool set available to the subagent after policy filtering. */
+    tools?: string[];
     uuid: UUID;
     session_id: string;
 };
@@ -272,10 +277,42 @@ export type SDKTaskProgressMessage = {
         duration_ms: number;
     };
     last_tool_name?: string;
+    subagent_type?: string;
     summary?: string;
     uuid: UUID;
     session_id: string;
 };
+export type SDKTaskUpdatedMessage = {
+    type: 'system';
+    subtype: 'task_updated';
+    task_id: string;
+    /** Wire-safe task fields that changed. Consumers merge this patch. */
+    patch: {
+        status?: 'pending' | 'running' | 'completed' | 'failed' | 'killed' | 'paused';
+        description?: string;
+        end_time?: number;
+        total_paused_ms?: number;
+        error?: string;
+        is_backgrounded?: boolean;
+    };
+    uuid: UUID;
+    session_id: string;
+};
+export type SDKBackgroundTasksChangedMessage = {
+    type: 'system';
+    subtype: 'background_tasks_changed';
+    /**
+     * Every live background task after the change. This has REPLACE semantics:
+     * consumers replace their current background task set with this payload.
+     */
+    tasks: Array<{
+        task_id: string;
+        task_type: string;
+        description: string;
+    }>;
+    uuid: UUID;
+    session_id: string;
+};
 export type SDKSessionStateChangedMessage = {
     type: 'system';
     subtype: 'session_state_changed';
@@ -354,4 +391,4 @@ export type SDKPermissionDeniedMessage = {
     decision_reason_type?: SDKPermissionDeniedReasonType;
     decision_reason?: string;
 };
-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;
+export type SDKMessage = SDKAssistantMessage | SDKUserMessage | SDKUserMessageReplay | SDKResultMessage | SDKSystemMessage | SDKPermissionDeniedMessage | SDKPartialAssistantMessage | SDKCompactBoundaryMessage | SDKStatusMessage | SDKAPIRetryMessage | SDKHookStartedMessage | SDKHookProgressMessage | SDKHookResponseMessage | SDKTaskNotificationMessage | SDKTaskStartedMessage | SDKTaskProgressMessage | SDKTaskUpdatedMessage | SDKBackgroundTasksChangedMessage | SDKSessionStateChangedMessage | SDKSessionTitleChangedMessage | SDKFilesPersistedEvent | SDKElicitationCompleteMessage | SDKPromptSuggestionMessage | SDKCloudAgentEventMessage;

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.1.0";
+export declare const WIRE_PROTOCOL_VERSION: "1.2.0";
 export type WireProtocolVersion = string;

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

@@ -53,6 +53,7 @@ type InitConfig = {
 };
 export declare class QueryRunner implements InternalQuery {
     private static readonly INITIALIZE_TIMEOUT_MS;
+    private static readonly BACKGROUND_TASKS_CAPABILITY;
     private readonly transport;
     private readonly inputStream;
     private readonly pendingRequests;
@@ -84,6 +85,7 @@ export declare class QueryRunner implements InternalQuery {
     private closed;
     private authExpiredFired;
     private protocolHandshakeValidated;
+    private cliCapabilities?;
     private firstResultReceived;
     private firstResultReceivedResolve?;
     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>>, fetchServiceAccountToken?: FetchServiceAccountToken);
@@ -202,11 +204,15 @@ export declare class QueryRunner implements InternalQuery {
      * Drop a UUID-stamped async user message while it is still queued.
      */
     cancelAsyncMessage(messageUuid: string): Promise<boolean>;
+    /** Stop one task without aborting the active main-session turn. */
+    stopTask(taskId: string): Promise<void>;
+    /** Move one or all eligible foreground tasks into the background. */
+    backgroundTasks(toolUseId?: string): Promise<boolean>;
+    private requireCliCapability;
     /**
      * Set the permission mode.
      */
     setPermissionMode(mode: PermissionMode): Promise<void>;
-    private hasBidirectionalNeeds;
     private waitForFirstResult;
     /**
      * Set the model.
@@ -289,6 +295,13 @@ export declare class QueryRunner implements InternalQuery {
     rewindFiles(userMessageId: string, options?: {
         dryRun?: boolean;
     }): Promise<import('../types/session.js').RewindFilesResult>;
+    /**
+     * Rewind the active conversation branch, its file checkpoints, or both.
+     */
+    rewind(userMessageId: string, options?: {
+        scope?: import('../types/session.js').RewindScope;
+        dryRun?: boolean;
+    }): Promise<import('../types/session.js').RewindResult>;
     /**
      * Seed read state for a file.
      */

package/dist/runtime-manifest.json

@@ -1,8 +1,16 @@
 {
   "version": 1,
-  "defaultTransport": "process",
+  "brand": "global",
+  "sdkVersion": "1.0.20",
+  "qoderCliVersion": "1.1.18",
+  "defaultTransport": "worker",
   "workerRuntime": {
     "packaged": false,
-    "delivery": "package"
+    "delivery": "install",
+    "source": "qodercli-worker-runtime",
+    "url": "https://download.qoder.com/qodercli/releases/1.1.18/qodercli-worker-runtime-universal.tgz",
+    "artifactName": "qodercli-worker-runtime-universal.tgz",
+    "sdkVersion": "1.0.20",
+    "qoderCliVersion": "1.1.18"
   }
 }

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

@@ -34,10 +34,11 @@ export declare function getSessionInfo(sessionId: string, options?: GetSessionIn
 /**
  * Get messages from a session transcript.
  *
- * Parses the JSONL transcript, rebuilds the latest main conversation chain via
- * `parentUuid`, and returns visible user/assistant messages in chronological
- * order. Supports pagination via offset/limit. Set `includeSystemMessages` to
- * include chain system entries such as compact boundaries.
+ * Parses the JSONL transcript, follows the session's persisted active leaf
+ * (falling back to the latest main leaf for legacy transcripts), and returns
+ * visible user/assistant messages in chronological order. Supports pagination
+ * via offset/limit. Set `includeSystemMessages` to include chain system entries
+ * such as compact boundaries.
  *
  * @param sessionId - The session UUID
  * @param options.dir - Restrict search to this working directory

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

@@ -1,6 +1,6 @@
-export declare const BRAND_CONFIG_DIR_INTERNAL = ".qoder";
-export declare const ENV_HOME = "QODER_CLI_HOME";
-export declare const ENV_CONFIG_DIR = "QODER_CONFIG_DIR";
+export declare const BRAND_CONFIG_DIR_INTERNAL: string;
+export declare const ENV_HOME: string;
+export declare const ENV_CONFIG_DIR: string;
 export declare const MAX_SANITIZED_LENGTH = 200;
 export declare function homedir(): string;
 /**

package/dist/types/agents.d.ts

@@ -3,4 +3,4 @@
  *
  * Source of truth is `../protocol/`.
  */
-export type { AgentDefinition, AgentInfo, AgentMcpServerSpec, } from '../protocol/index.js';
+export type { AgentDefinition, AgentInfo, AgentMemoryScope, AgentMcpServerSpec, } 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, 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';
+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, SDKControlRewindRequest, SDKControlCancelAsyncMessageRequest, SDKControlSeedReadStateRequest, SDKControlMcpSetServersRequest, SDKControlReloadPluginsRequest, SDKControlMcpReconnectRequest, SDKControlMcpToggleRequest, SDKControlApplyFlagSettingsRequest, SDKControlGetSettingsRequest, SDKControlElicitationRequest, SDKControlEndSessionRequest, SDKControlChannelEnableRequest, SDKControlMcpInjectTokenRequest, SDKControlMcpAuthenticateRequest, SDKControlMcpOAuthCallbackUrlRequest, SDKControlMcpClearAuthRequest, SDKControlRequestInner, SDKControlInitializeResponse, SDKControlGetContextUsageResponse, SDKControlReloadPluginsResponse, SDKControlListPluginsRequest, SDKControlListPluginsResponse, SDKControlStopTaskRequest, SDKControlBackgroundTasksRequest, SDKControlBackgroundTasksResponse, 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';

package/dist/types/messages.d.ts

@@ -9,7 +9,7 @@ import type { SDKMessage as ProtocolSDKMessage, SDKStatusMessage as ProtocolSDKS
 import type { MessageParam, UUID } from './common.js';
 import type { PermissionMode } from './permissions.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 { SDKAssistantMessage, SDKResultSuccess, SDKResultError, SDKResultMessage, SDKPartialAssistantMessage, SDKCompactBoundaryMessage, SDKAPIRetryMessage, SDKHookStartedMessage, SDKHookProgressMessage, SDKHookResponseMessage, SDKTaskNotificationMessage, SDKTaskStartedMessage, SDKTaskProgressMessage, SDKTaskUpdatedMessage, SDKBackgroundTasksChangedMessage, SDKSessionStateChangedMessage, SDKSessionTitleChangedMessage, SDKFilesPersistedEvent, SDKElicitationCompleteMessage, SDKPromptSuggestionMessage, SDKCloudAgentEventMessage, SDKPermissionDenial, } from '../protocol/index.js';
 export type SDKUserMessage = {
     type: 'user';
     message: MessageParam;

package/dist/types/options.d.ts

@@ -11,7 +11,7 @@ import type { Settings } from './settings.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 { RewindFilesResult, RewindResult, RewindScope } from './session.js';
 import type { CloudAgentOptions } from './cloud-agent.js';
 import type { QueryTransportProviderOption } from '../core/query-transport.js';
 import type { PluginDetails } from './plugins.js';
@@ -89,7 +89,7 @@ export type Options = {
     /**
      * Selects the local query transport.
      *
-     * - omitted: use `ProcessTransport.default` and spawn qodercli as a child process.
+     * - omitted: use the transport baked into the installed SDK package.
      * - `ProcessTransport.default`: spawn qodercli as a child process.
      * - `WorkerTransport.default`: run qoder-worker-runtime in a Node worker thread.
      * - `new WorkerTransport({ ... })`: run worker runtime with provider options.
@@ -173,6 +173,13 @@ export type Options = {
     mcpServers?: Record<string, McpServerConfig>;
     allowedMcpServerNames?: string[];
     model?: string;
+    /**
+     * Path to a local Qoder runtime.
+     *
+     * Native binaries and ordinary JavaScript CLI entries use ProcessTransport.
+     * Recognized `qoder-worker-runtime*.mjs` entries use WorkerTransport. An
+     * explicit `transport` provider takes precedence over this automatic choice.
+     */
     pathToQoderCLIExecutable?: string;
     permissionMode?: PermissionMode;
     allowDangerouslySkipPermissions?: boolean;
@@ -304,6 +311,14 @@ export interface Query extends AsyncGenerator<SDKMessage, void> {
      * was dropped.
      */
     cancelAsyncMessage(messageUuid: string): Promise<boolean>;
+    /** Stop one running task without interrupting the main session turn. */
+    stopTask(taskId: string): Promise<void>;
+    /**
+     * Move foreground Bash/Agent executions into the background. When a tool
+     * use ID is provided only that execution is targeted; otherwise all
+     * eligible foreground executions are targeted.
+     */
+    backgroundTasks(toolUseId?: string): Promise<boolean>;
     setPermissionMode(mode: PermissionMode): Promise<void>;
     setModel(model?: string): Promise<void>;
     /**
@@ -373,6 +388,15 @@ export interface Query extends AsyncGenerator<SDKMessage, void> {
     rewindFiles(userMessageId: string, options?: {
         dryRun?: boolean;
     }): Promise<RewindFilesResult>;
+    /**
+     * Rewind the active local CLI session to immediately before a historical
+     * top-level user input. The edited replacement must be submitted as a new
+     * user message with a new UUID after this Promise resolves successfully.
+     */
+    rewind(userMessageId: string, options?: {
+        scope?: RewindScope;
+        dryRun?: boolean;
+    }): Promise<RewindResult>;
     seedReadState(path: string, mtime: number): Promise<void>;
     /**
      * 主动驱动 MCP OAuth：拉起 OAuth 流程，返回授权 URL 让 host 引导用户跳转。

package/dist/types/session.d.ts

@@ -115,5 +115,33 @@ export type RewindFilesResult = {
     insertions?: number;
     deletions?: number;
 };
+/** Which parts of a local CLI session should be rewound. */
+export type RewindScope = 'conversation' | 'files' | 'both';
+/** Outcome of a full session rewind request. */
+export type RewindStatus = 'ready' | 'success' | 'partial' | 'rejected';
+export type RewindFileFailure = {
+    path: string;
+    error: string;
+};
+/**
+ * Result returned by {@link Query.rewind}.
+ *
+ * `ready` is only returned for a successful dry run. `partial` means the
+ * conversation branch was rewound but one or more files could not be
+ * restored; callers should surface the failures before submitting a new
+ * edited input.
+ */
+export type RewindResult = {
+    status: RewindStatus;
+    targetUserMessageId: string;
+    scope: RewindScope;
+    retainedLeafId?: string | null;
+    removedMessageIds?: string[];
+    filesChanged?: string[];
+    insertions?: number;
+    deletions?: number;
+    failedFiles?: RewindFileFailure[];
+    error?: string;
+};
 import type { SessionStore } from '../session/session-store.js';
 export {};

package/dist/types/tools.d.ts

@@ -1,13 +1,61 @@
+import type { PermissionMode } from './permissions.js';
 export type AgentInput = {
+    description: string;
     prompt: string;
-    agent?: string;
-    timeout_ms?: number;
-};
-export type AgentOutput = {
-    result: string;
-    agent?: string;
-    error?: string;
+    subagent_type?: string;
+    model?: string;
+    mode?: PermissionMode;
+    run_in_background?: boolean;
+    name?: string;
+    /** @deprecated Ignored. Named teammates use the session's implicit team. */
+    team_name?: string;
+    /** `default` disables definition-level worktree isolation for this invocation. */
+    isolation?: 'default' | 'worktree';
+};
+export type AgentToolCompletionResult = {
+    kind: 'agent-result';
+    agentId?: string;
+    agentType: string;
+    content: string;
+    state: 'running' | 'completed' | 'error' | 'cancelled';
+    apiError?: string;
+    terminateReason?: 'ERROR' | 'TIMEOUT' | 'GOAL' | 'MAX_TURNS' | 'ABORTED' | 'ERROR_NO_COMPLETE_TASK_CALL';
+    terminationDetails?: {
+        maxTurns?: number;
+    };
+    outputPath?: string;
+    transcriptPath?: string;
+    worktreePath?: string;
+    remoteContextId?: string;
+    remoteTaskId?: string;
+};
+export type AgentToolBackgroundLaunchResult = {
+    isAsync: true;
+    status: 'async_launched';
+    agentId: string;
+    description: string;
+    resolvedModel?: string;
+    prompt: string;
+    outputFile: string;
+    canReadOutputFile?: boolean;
 };
+export type AgentToolTeammateSpawnedResult = {
+    status: 'teammate_spawned';
+    prompt: string;
+    teammate_id: string;
+    agent_id: string;
+    agent_type?: string;
+    model?: string;
+    name: string;
+    color?: string;
+    tmux_session_name: 'in-process';
+    tmux_window_name: 'in-process';
+    tmux_pane_id: 'in-process';
+    team_name: string;
+    is_splitpane: false;
+    plan_mode_required: boolean;
+};
+export type AgentOutput = AgentToolCompletionResult | AgentToolBackgroundLaunchResult | AgentToolTeammateSpawnedResult;
 export type BashInput = {
     command: string;
     timeout?: number;
@@ -177,18 +225,70 @@ export type NotebookEditOutput = {
     notebook_path: string;
     error?: string;
 };
-export type TaskOutputInput = {
-    task_id: string;
-    output: string;
-};
 export type TaskStopInput = {
     task_id: string;
-    reason?: string;
 };
 export type TaskStopOutput = {
-    success: boolean;
+    message: string;
     task_id: string;
+    task_type: string;
+    command?: string;
+};
+export type TaskCreateInput = {
+    subject: string;
+    description: string;
+    activeForm?: string;
+    metadata?: Record<string, unknown>;
+};
+export type TaskCreateOutput = {
+    task: {
+        id: string;
+        subject: string;
+    };
+};
+export type TaskGetInput = {
+    taskId: string;
+};
+export type TaskGetOutput = {
+    task: {
+        id: string;
+        subject: string;
+        description: string;
+        status: 'pending' | 'in_progress' | 'completed';
+        blocks: string[];
+        blockedBy: string[];
+    } | null;
+};
+export type TaskUpdateInput = {
+    taskId: string;
+    subject?: string;
+    description?: string;
+    activeForm?: string;
+    status?: 'pending' | 'in_progress' | 'completed' | 'deleted';
+    addBlocks?: string[];
+    addBlockedBy?: string[];
+    owner?: string;
+    metadata?: Record<string, unknown>;
+};
+export type TaskUpdateOutput = {
+    success: boolean;
+    taskId: string;
+    updatedFields: string[];
     error?: string;
+    statusChange?: {
+        from: string;
+        to: string;
+    };
+};
+export type TaskListInput = Record<string, never>;
+export type TaskListOutput = {
+    tasks: Array<{
+        id: string;
+        subject: string;
+        status: 'pending' | 'in_progress' | 'completed';
+        owner?: string;
+        blockedBy: string[];
+    }>;
 };
 export type ExitPlanModeInput = {
     confirm?: boolean;
@@ -271,5 +371,5 @@ export type McpOutput = {
     content: unknown;
     isError?: boolean;
 };
-export type ToolInputSchemas = AgentInput | BashInput | FileReadInput | FileEditInput | FileWriteInput | GlobInput | GrepInput | WebFetchInput | WebSearchInput | AskUserQuestionInput | NotebookEditInput | TaskOutputInput | TaskStopInput | ExitPlanModeInput | ConfigInput | EnterWorktreeInput | ExitWorktreeInput | TodoWriteInput | ListMcpResourcesInput | ReadMcpResourceInput | McpInput;
-export type ToolOutputSchemas = AgentOutput | BashOutput | FileReadOutput | FileEditOutput | FileWriteOutput | GlobOutput | GrepOutput | WebFetchOutput | WebSearchOutput | AskUserQuestionOutput | NotebookEditOutput | TaskStopOutput | ExitPlanModeOutput | ConfigOutput | EnterWorktreeOutput | ExitWorktreeOutput | TodoWriteOutput | ListMcpResourcesOutput | McpOutput;
+export type ToolInputSchemas = AgentInput | BashInput | FileReadInput | FileEditInput | FileWriteInput | GlobInput | GrepInput | WebFetchInput | WebSearchInput | AskUserQuestionInput | NotebookEditInput | TaskStopInput | TaskCreateInput | TaskGetInput | TaskUpdateInput | TaskListInput | ExitPlanModeInput | ConfigInput | EnterWorktreeInput | ExitWorktreeInput | TodoWriteInput | ListMcpResourcesInput | ReadMcpResourceInput | McpInput;
+export type ToolOutputSchemas = AgentOutput | BashOutput | FileReadOutput | FileEditOutput | FileWriteOutput | GlobOutput | GrepOutput | WebFetchOutput | WebSearchOutput | AskUserQuestionOutput | NotebookEditOutput | TaskStopOutput | TaskCreateOutput | TaskGetOutput | TaskUpdateOutput | TaskListOutput | ExitPlanModeOutput | ConfigOutput | EnterWorktreeOutput | ExitWorktreeOutput | TodoWriteOutput | ListMcpResourcesOutput | McpOutput;