@qoder-ai/qoder-agent-sdk 1.0.42 → 1.0.43

package/dist/protocol/common.d.ts

@@ -302,6 +302,8 @@ export type ModelInfo = {
     modelId?: string;
     displayName: string;
     description: string;
+    /** English model description supplied by the catalog, when available. */
+    descriptionEn?: string;
     /** `'system'` (Qoder catalog), `'user'` (BYOK), `'organization'`, or `'custom'` (Custom Provider). */
     source?: ModelSource;
     /** Server-designated default for the current scene. */

package/dist/protocol/control.d.ts

@@ -122,6 +122,7 @@ export type SDKControlInitializeRequest = {
     sdkMcpServers?: string[];
     sdkMcpToolOverrides?: Record<string, Record<string, McpToolRuntimeOverride>>;
     promptSuggestions?: boolean;
+    hostActions?: Record<string, never>;
     goalMaxTurns?: number;
     supportsCatalogReadyInitialize?: boolean;
     /** Opts this Host into authoritative model snapshots on the Query stream. */

package/dist/protocol/feedback.d.ts

@@ -0,0 +1,11 @@
+/** Stable Host UI actions reported to the CLI. */
+export declare const HOST_ACTIONS: readonly ["copy_text", "helpful", "not_helpful", "create_branch_task", "copy_markdown", "add_reply_to_task"];
+export type HostAction = (typeof HOST_ACTIONS)[number];
+export type HostActionEvent = {
+    type: 'feedback';
+    subtype: 'action';
+    uuid: string;
+    action: HostAction;
+    session_id: string;
+    parent_result_uuid: string;
+};

package/dist/protocol/index.d.ts

@@ -14,6 +14,7 @@
  */
 export { WIRE_PROTOCOL_VERSION, type WireProtocolVersion } from './version.js';
 export type { ModelPromptPatch, ModelPromptPatches, } from './model-prompt-patches.js';
+export { HOST_ACTIONS, type HostAction, type HostActionEvent, } from './feedback.js';
 export type { UUID, Base64ImageSource, UrlImageSource, URLImageSource, ImageSource, ImageContentBlock, ImageBlockParam, ContentBlock, 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 './common.js';
 export type { AICodeTrackingLaunchOptions, QoderAgentLaunchOptions, QoderCliFlagSettings, } from './launch.js';
 export { buildQoderCliFlagSettings, buildQoderCliFlagSettingsArgs, } from './launch.js';

package/dist/protocol/index.js

@@ -1 +1 @@
-var a="1.4.0";var r=["l1StaticCheck","l2LightweightScan","l3DeepScan"];function i(e){if(e===null||typeof e!="object"||Array.isArray(e))throw new TypeError("securityScan must be an object.");let o=new Set(r),n=Object.keys(e).filter(t=>!o.has(t));if(n.length>0)throw new TypeError(`securityScan contains unknown option${n.length===1?"":"s"}: ${n.join(", ")}.`);for(let t of r){let s=e[t];if(s!==void 0&&typeof s!="boolean")throw new TypeError(`securityScan.${t} must be a boolean.`)}return{l1StaticCheck:e.l1StaticCheck??!1,l2LightweightScan:e.l2LightweightScan??!1,l3DeepScan:e.l3DeepScan??!1}}function p(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}function l(e={}){let o={...e.settings??{}},n=e.aiCodeTracking?.installGitCommitHook;if(n!==void 0){let t=o.aiCodeTracking;o.aiCodeTracking={...p(t)?t:{},installGitCommitHook:n}}return e.securityScan!==void 0&&(o.securityScan=i(e.securityScan)),o}function u(e={}){let o=l(e);return Object.keys(o).length===0?[]:["--settings",JSON.stringify(o)]}var g={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{g as QoderModelPurpose,a as WIRE_PROTOCOL_VERSION,l as buildQoderCliFlagSettings,u as buildQoderCliFlagSettingsArgs};
+var a="1.4.0";var p=["copy_text","helpful","not_helpful","create_branch_task","copy_markdown","add_reply_to_task"];var r=["l1StaticCheck","l2LightweightScan","l3DeepScan"];function i(e){if(e===null||typeof e!="object"||Array.isArray(e))throw new TypeError("securityScan must be an object.");let o=new Set(r),n=Object.keys(e).filter(t=>!o.has(t));if(n.length>0)throw new TypeError(`securityScan contains unknown option${n.length===1?"":"s"}: ${n.join(", ")}.`);for(let t of r){let s=e[t];if(s!==void 0&&typeof s!="boolean")throw new TypeError(`securityScan.${t} must be a boolean.`)}return{l1StaticCheck:e.l1StaticCheck??!1,l2LightweightScan:e.l2LightweightScan??!1,l3DeepScan:e.l3DeepScan??!1}}function u(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}function l(e={}){let o={...e.settings??{}},n=e.aiCodeTracking?.installGitCommitHook;if(n!==void 0){let t=o.aiCodeTracking;o.aiCodeTracking={...u(t)?t:{},installGitCommitHook:n}}return e.securityScan!==void 0&&(o.securityScan=i(e.securityScan)),o}function g(e={}){let o=l(e);return Object.keys(o).length===0?[]:["--settings",JSON.stringify(o)]}var S={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 HOST_ACTIONS,S as QoderModelPurpose,a as WIRE_PROTOCOL_VERSION,l as buildQoderCliFlagSettings,g as buildQoderCliFlagSettingsArgs};

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

@@ -20,6 +20,8 @@
  *
  * 3. Implements all Query interface methods for the consumer.
  */
+import { type HostActionParams } from '../types/host-action.js';
+import type { HostActionEvent } from '../protocol/feedback.js';
 import { type DiagnosticsSink } from '../core/sdk-diagnostics.js';
 import type { ModelPromptPatches } from '../protocol/model-prompt-patches.js';
 import type { Transport } from '../core/transport.js';
@@ -53,6 +55,7 @@ type InitConfig = {
     skills?: string[];
     planMode?: boolean;
     promptSuggestions?: boolean;
+    hostActions?: Record<string, never>;
     goalMaxTurns?: number;
     enableFileCheckpointing?: boolean;
     memory?: SerializableMemoryConfig;
@@ -73,6 +76,7 @@ type InitConfig = {
     requireSessionStoreForkBarrier?: boolean;
 };
 export declare class QueryRunner implements InternalQuery {
+    private readonly hostActionDirect;
     private static readonly CUSTOM_CONTEXT_CAPABILITY;
     private static readonly SELECTED_SKILLS_CAPABILITY;
     private static readonly INITIALIZE_TIMEOUT_MS;
@@ -82,6 +86,7 @@ export declare class QueryRunner implements InternalQuery {
     private static readonly GOAL_MAX_TURNS_CAPABILITY;
     private static readonly PLAN_MODE_CAPABILITY;
     private static readonly SESSION_STORE_FORK_BARRIER_CAPABILITY;
+    private static readonly HOST_ACTION_CAPABILITY;
     private static readonly BYOK_CONFIG_MANAGEMENT_CAPABILITY;
     private static readonly REMOTE_PROJECTION_REQUEST_ID_PREFIX;
     private readonly transport;
@@ -110,6 +115,7 @@ export declare class QueryRunner implements InternalQuery {
     private readonly transcriptMirrorBatcher?;
     private readonly memoryCallbacks?;
     private readonly skillEvolutionCallbacks?;
+    private readonly hostActionFallback?;
     private readonly resolveSessionArtifacts?;
     private resolveStreamInitialization;
     private initResponse?;
@@ -135,7 +141,8 @@ export declare class QueryRunner implements InternalQuery {
     private skillEvolutionFlushPromise?;
     private closePromise?;
     private sessionStoreForkBarrierComplete;
-    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, memoryCallbacks?: MemoryRuntimeCallbacks, skillEvolutionCallbacks?: SkillEvolutionRuntimeCallbacks, resolveSessionArtifacts?: ResolveSessionArtifacts);
+    private inputEnded;
+    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, memoryCallbacks?: MemoryRuntimeCallbacks, skillEvolutionCallbacks?: SkillEvolutionRuntimeCallbacks, resolveSessionArtifacts?: ResolveSessionArtifacts, hostActionFallback?: (event: HostActionEvent) => Promise<void>, hostActionDirect?: boolean);
     private getRecord;
     private normalizeLogPreview;
     private extractMessagePreview;
@@ -163,6 +170,7 @@ export declare class QueryRunner implements InternalQuery {
     private dispatchSkillEvolutionCallbacks;
     private flushBeforeEndInput;
     private performFlushBeforeEndInput;
+    private endTransportInput;
     /**
      * Send a control request to the CLI and wait for the response.
      *
@@ -258,6 +266,7 @@ export declare class QueryRunner implements InternalQuery {
      * Interrupt the current operation.
      */
     interrupt(): Promise<SDKControlInterruptResponse | undefined>;
+    sendHostAction(params: HostActionParams): Promise<void>;
     /**
      * Drop a UUID-stamped async user message while it is still queued.
      */

package/dist/runtime-manifest.json

@@ -1,16 +1,16 @@
 {
   "version": 1,
   "brand": "global",
-  "sdkVersion": "1.0.42",
-  "qoderCliVersion": "1.1.54",
+  "sdkVersion": "1.0.43",
+  "qoderCliVersion": "1.1.55",
   "defaultTransport": "worker",
   "workerRuntime": {
     "packaged": false,
     "delivery": "install",
     "source": "qodercli-worker-runtime",
-    "urlTemplate": "https://download.qoder.com/qodercli/releases/1.1.54/qodercli-worker-runtime-{target}.tgz",
+    "urlTemplate": "https://download.qoder.com/qodercli/releases/1.1.55/qodercli-worker-runtime-{target}.tgz",
     "artifactNameTemplate": "qodercli-worker-runtime-{target}.tgz",
-    "sdkVersion": "1.0.42",
-    "qoderCliVersion": "1.1.54"
+    "sdkVersion": "1.0.43",
+    "qoderCliVersion": "1.1.55"
   }
 }

package/dist/types/host-action.d.ts

@@ -0,0 +1,11 @@
+import type { HostAction, HostActionEvent } from '../protocol/feedback.js';
+/** Explicitly enables Host-to-CLI action events for this Query. */
+export type HostActionOptions = Record<string, never>;
+export type HostActionParams = {
+    /** Stable identity for one Host UI gesture. Reuse it when retrying. */
+    uuid: string;
+    action: HostAction;
+    sessionId: string;
+    parentResultUuid: string;
+};
+export declare function createHostActionEvent(params: HostActionParams): HostActionEvent;

package/dist/types/index.d.ts

@@ -13,6 +13,7 @@ export type { WorkerRuntimeTransportOptions, WorkerTransportOptions, } from '../
 export type { QueryTransportProvider, Transport, } from '../core/transport.js';
 export type { ElicitationRequest, ElicitationResult, OnElicitation, PromptRequestOption, PromptRequest, PromptResponse, SecurityScanOptions, Options, QueryTransportOptions, SpawnOptions, SpawnedProcess, Query, } from './options.js';
 export * from './permissions.js';
+export type { HostActionOptions, HostActionParams } from './host-action.js';
 export type { HookEvent, HookPermissionDecision, HookCallback, HookCallbackMatcher, HookInput, HookSpecificOutput, HookJSONOutput, AsyncHookJSONOutput, SyncHookJSONOutput, BaseHookInput, PreToolUseHookInput, PostToolUseHookInput, PostToolUseFailureHookInput, UserPromptSubmitHookInput, SessionStartHookInput, SessionEndHookInput, StopHookInput, SubagentStartHookInput, SubagentStopHookInput, PreCompactHookInput, PostCompactHookInput, PermissionRequestHookInput, PermissionDeniedHookInput, InstructionsLoadedHookInput, WorktreeCreateHookInput, WorktreeRemoveHookInput, CwdChangedHookInput, FileChangedHookInput, PreToolUseHookSpecificOutput, PostToolUseHookSpecificOutput, PostToolUseFailureHookSpecificOutput, UserPromptSubmitHookSpecificOutput, SessionStartHookSpecificOutput, SubagentStartHookSpecificOutput, PermissionRequestHookSpecificOutput, WorktreeCreateHookSpecificOutput, CwdChangedHookSpecificOutput, FileChangedHookSpecificOutput, } from './hooks.js';
 export * from './mcp.js';
 export * from './agents.js';

package/dist/types/options.d.ts

@@ -21,6 +21,7 @@ import type { MemoryOptions } from './memory.js';
 import type { EvolutionOptions } from './skill-evolution.js';
 import type { SDKGoalSnapshot, SDKGoalStatus, SDKPlanModeSnapshot } from '../protocol/control.js';
 import type { Daemon } from '../daemon/start-daemon.js';
+import type { HostActionOptions, HostActionParams } from './host-action.js';
 import type { ResolveSessionArtifacts } from './artifacts.js';
 export type { CanUseTool };
 export type { AuthOptions };
@@ -284,6 +285,8 @@ export type Options = {
     permissionPromptToolName?: string;
     plugins?: SdkPluginConfig[];
     promptSuggestions?: boolean;
+    /** Explicit opt-in for Host-to-CLI result action events. */
+    hostActions?: HostActionOptions;
     /**
      * Persist the local session transcript. Defaults to true.
      *
@@ -407,6 +410,8 @@ export interface RemoteProjectionCheckpoint {
  * 配置 MCP servers 请通过 `Options.mcpServers`（启动时一次性配置）。
  */
 export interface Query extends AsyncGenerator<SDKMessage, void> {
+    /** Queue a Host UI action for the active CLI or a one-shot fallback process. */
+    sendHostAction(params: HostActionParams): Promise<void>;
     /**
      * Request interruption of the active turn.
      *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qoder-ai/qoder-agent-sdk",
-  "version": "1.0.42",
+  "version": "1.0.43",
   "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.54",
+  "qoderCliVersion": "1.1.55",
   "qoderSdkBrand": "global",
   "license": "SEE LICENSE IN LICENSE"
 }