@qoder-ai/qoder-agent-sdk 1.0.19 → 1.0.21

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/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

@@ -256,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;
 };
@@ -274,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';
@@ -356,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/index.d.ts

@@ -4,5 +4,7 @@
  * This is the main entry point for the Qoder Agent SDK query functionality.
  */
 export { query } from './query.js';
+export { startup } from './startup.js';
+export type { StartupParams, WarmQuery } from './startup.js';
 export { QueryRunner } from './query-runner.js';
 export { generateRequestId, createControlRequest, createControlResponse, createControlErrorResponse, isControlResponse, isControlRequest, isControlCancelRequest, isKeepAlive, isStreamlinedText, isStreamlinedToolUseSummary, isPostTurnSummary, isResultMessage, } from './control-protocol.js';

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/query/startup.d.ts

@@ -0,0 +1,11 @@
+import type { Options, Query } from '../types/options.js';
+import type { SDKUserMessage } from '../types/messages.js';
+export interface WarmQuery extends AsyncDisposable {
+    query(prompt: string | AsyncIterable<SDKUserMessage>): Query;
+    close(): void;
+}
+export interface StartupParams {
+    options?: Options;
+    initializeTimeoutMs?: number;
+}
+export declare function startup(params?: StartupParams): Promise<WarmQuery>;

package/dist/runtime-manifest.json

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

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/settings/resolve-settings.d.ts

@@ -0,0 +1,2 @@
+import type { ResolveSettingsOptions, ResolvedSettings } from '../types/settings.js';
+export declare function resolveSettings(options?: ResolveSettingsOptions): Promise<ResolvedSettings>;

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';
@@ -311,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>;
     /**
@@ -380,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/plugins.d.ts

@@ -48,4 +48,56 @@ export type UninstallPluginResult = {
     pluginId: string;
     fullyRemoved: boolean;
     reverseDependents: string[];
+};
+export type PluginValidationSeverity = 'error' | 'warning';
+export type PluginValidationPhase = 'target' | 'manifest' | 'component' | 'load-simulation' | 'installability';
+export type PluginValidationPosition = {
+    line: number;
+    character: number;
+};
+export type PluginValidationLocation = {
+    path: string;
+    jsonPointer?: string;
+    range?: {
+        start: PluginValidationPosition;
+        end: PluginValidationPosition;
+    };
+};
+export type PluginValidationDiagnostic = {
+    severity: PluginValidationSeverity;
+    code: string;
+    message: string;
+    phase: PluginValidationPhase;
+    location?: PluginValidationLocation;
+    suggestion?: string;
+};
+export type PluginValidationReport = {
+    schemaVersion: 1;
+    validator: {
+        name: 'qodercli';
+        version: string;
+    };
+    valid: boolean;
+    target: {
+        inputPath: string;
+        resolvedPath: string;
+        manifestPath?: string;
+    };
+    plugin?: {
+        name: string;
+        version?: string;
+        displayName?: string;
+    };
+    diagnostics: PluginValidationDiagnostic[];
+    summary: {
+        errorCount: number;
+        warningCount: number;
+        componentCount: number;
+    };
+    resources?: PluginResources;
+};
+export type ValidatePluginOptions = {
+    cliPath?: string;
+    env?: Record<string, string>;
+    signal?: AbortSignal;
 };

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/settings.d.ts

@@ -1,4 +1,5 @@
 import type { PermissionMode } from './permissions.js';
+import type { SettingSource } from './options.js';
 /**
  * Settings fields with a verified qodercli execution path.
  *
@@ -42,13 +43,25 @@ export interface Settings {
     }>;
     [k: string]: unknown;
 }
+export type ResolvedSettingSource = SettingSource;
 export type ResolvedSettingsSource = {
-    source: 'user' | 'project' | 'local' | 'managed' | 'flag' | string;
+    source: ResolvedSettingSource;
     settings: Settings;
     path?: string;
 };
+export type SettingsProvenanceEntry = {
+    source: ResolvedSettingSource;
+    path?: string;
+};
+export type ResolveSettingsOptions = {
+    /** Directory used to resolve project and local settings. */
+    cwd?: string;
+    /** Filesystem settings sources to load. Omit for all sources; pass [] for none. */
+    settingSources?: SettingSource[];
+};
 export type ResolvedSettings = {
     effective: Settings;
+    provenance: Record<string, SettingsProvenanceEntry>;
     sources: ResolvedSettingsSource[];
 };
 /**

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,14 @@ 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;
-    error?: string;
+    task_type: string;
+    command?: string;
 };
 export type TaskCreateInput = {
     subject: string;
@@ -327,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 | TaskCreateInput | TaskGetInput | TaskUpdateInput | TaskListInput | ExitPlanModeInput | ConfigInput | EnterWorktreeInput | ExitWorktreeInput | TodoWriteInput | ListMcpResourcesInput | ReadMcpResourceInput | McpInput;
+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;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qoder-ai/qoder-agent-sdk",
-  "version": "1.0.19",
+  "version": "1.0.21",
   "description": "TypeScript SDK for building Qoder-powered coding agents.",
   "type": "module",
   "main": "dist/index.js",
@@ -50,7 +50,7 @@
   "peerDependencies": {
     "zod": "^3.25.0 || ^4.0.0"
   },
-  "qoderCliVersion": "1.1.16",
+  "qoderCliVersion": "1.1.20",
   "qoderSdkBrand": "global",
   "license": "SEE LICENSE IN LICENSE"
 }

package/scripts/postinstall.cjs

@@ -143,6 +143,7 @@ function normalizePlatformOverride(value) {
     'linux-x64',
     'linux-x64-baseline',
     'linux-x64-musl',
+    'openharmony-arm64',
     'windows-arm64',
     'windows-x64',
   ]);
@@ -182,6 +183,15 @@ function getPlatformTarget() {
     }
   }
 
+  // HarmonyOS reports process.platform === 'openharmony'. Only aarch64 is
+  // produced; the artifact is qodercli-openharmony-arm64.tar.gz.
+  if (process.platform === 'openharmony') {
+    if (process.arch !== 'arm64') {
+      throw new Error(`Unsupported OpenHarmony architecture: ${process.arch}`);
+    }
+    return 'openharmony-arm64';
+  }
+
   throw new Error(`Unsupported platform: ${process.platform}/${process.arch}`);
 }