@qoder-ai/qoder-agent-sdk 1.0.55 → 1.0.57

package/dist/protocol/control.d.ts

@@ -122,6 +122,7 @@ export type SDKControlInitializeRequest = {
     sdkMcpServers?: string[];
     sdkMcpToolOverrides?: Record<string, Record<string, McpToolRuntimeOverride>>;
     promptSuggestions?: boolean;
+    includeShellProgress?: boolean;
     hostActions?: Record<string, never>;
     goalMaxTurns?: number;
     supportsCatalogReadyInitialize?: boolean;
@@ -190,6 +191,8 @@ export type SDKControlGenerateSessionTitleRequest = {
     type: 'generate_session_title';
     description: string;
     persist?: boolean;
+    /** Opaque per-turn inference identity; defaults to options.customContext. */
+    custom_context?: Record<string, string>;
 };
 export type SDKControlGenerateSessionTitleResponse = {
     title: string | null;
@@ -207,6 +210,8 @@ export type AskSideQuestionOptions = {
     signal?: AbortSignal;
     /** Previous side-question exchanges to include as local context. */
     history?: readonly SideQuestionHistoryEntry[];
+    /** Overrides options.customContext for this control request only. */
+    customContext?: Record<string, string>;
 };
 export type SideQuestionRefusalFallback = {
     originalModel: string;
@@ -223,6 +228,8 @@ export type SDKControlSideQuestionRequest = {
     subtype: 'side_question';
     question: string;
     history?: SideQuestionHistoryEntry[];
+    /** Opaque per-turn inference identity; defaults to options.customContext. */
+    custom_context?: Record<string, string>;
 };
 export type SDKControlSideQuestionResponse = {
     response: string | null;
@@ -829,6 +836,8 @@ export type SDKControlSetGoalRequest = {
     objective?: string;
     status?: SDKGoalStatus;
     credits_budget?: number | null;
+    /** Opaque per-turn inference identity used by goal kickoff turns. */
+    custom_context?: Record<string, string>;
 };
 export type SDKControlSetGoalResponse = {
     goal: SDKGoalSnapshot | null;

package/dist/protocol/index.d.ts

@@ -22,7 +22,7 @@ export type { EffectiveMemoryConfig, MemoryConsumptionFile, MemoryConsumptionRes
 export type { EffectiveEvolutionConfig, EffectiveSkillEvolutionConfig, SerializableEvolutionConfig, SerializableSkillEvolutionConfig, SerializableSkillEvolutionGenerationOptions, SkillEvolutionGateInput, SkillEvolutionGateResult, SkillEvolutionMode, SkillEvolutionResult, SkillEvolutionSuggestion, } from './skill-evolution.js';
 export type { PermissionMode, PermissionBehavior, PermissionScope, CanUseToolPermissionKind, CanUseToolPermissionOption, CanUseToolPermissionDetails, 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, SDKToolNonExecutionKind, SDKToolResultMeta, SDKMessageOrigin, SDKSelectedSkill, SDKUserMessage, SDKUserMessageReplay, SDKResultSuccess, SDKResultError, SDKResultMessage, SDKFileAttachment, SDKSystemMessage, SDKArtifactInfo, SDKArtifactUpdateMessage, SDKAvailableModelsUpdateMessage, SDKCommandsChangedMessage, SDKPartialAssistantMessage, SDKCompactBoundaryMessage, SDKStatusMessage, SDKAPIRetryMessage, SDKModelQueueStatusMessage, SDKControlRequestProgressMessage, SDKCommandLifecycleMessage, SDKHookStartedMessage, SDKHookProgressMessage, SDKHookResponseMessage, SDKTaskNotificationMessage, SDKTaskStartedMessage, SDKTaskProgressMessage, SDKTaskUpdatedMessage, SDKBackgroundTasksChangedMessage, SDKSessionStateChangedMessage, SDKPlanModeChangedMessage, SDKGoalUpdatedMessage, SDKGoalClearedMessage, SDKSessionTitleChangedMessage, SDKFilesPersistedEvent, SDKElicitationCompleteMessage, SDKPromptSuggestionMessage, SDKCloudAgentEventMessage, SDKMemoryGenerationMessage, SDKMemoryConsumptionMessage, SDKSkillEvolutionMessage, SDKAgentsMdSizeWarningMessage, SDKPermissionDenial, SDKPermissionDeniedMessage, SDKPermissionDeniedReasonType, SDKMessage, } from './messages.js';
+export type { SDKAssistantMessage, SDKToolNonExecutionKind, SDKToolResultMeta, SDKMessageOrigin, SDKSelectedSkill, SDKUserMessage, SDKUserMessageReplay, SDKResultSuccess, SDKResultError, SDKResultMessage, SDKFileAttachment, SDKSystemMessage, SDKArtifactInfo, SDKArtifactUpdateMessage, SDKAvailableModelsUpdateMessage, SDKCommandsChangedMessage, SDKPartialAssistantMessage, SDKCompactBoundaryMessage, SDKStatusMessage, SDKAPIRetryMessage, SDKModelQueueStatusMessage, SDKControlRequestProgressMessage, SDKCommandLifecycleMessage, SDKToolProgressMessage, SDKHookDiagnosticsMessage, SDKHookStartedMessage, SDKHookProgressMessage, SDKHookResponseMessage, SDKTaskNotificationMessage, SDKTaskStartedMessage, SDKTaskProgressMessage, SDKTaskUpdatedMessage, SDKBackgroundTasksChangedMessage, SDKSessionStateChangedMessage, SDKPlanModeChangedMessage, SDKGoalUpdatedMessage, SDKGoalClearedMessage, SDKSessionTitleChangedMessage, SDKFilesPersistedEvent, SDKElicitationCompleteMessage, SDKPromptSuggestionMessage, SDKCloudAgentEventMessage, SDKMemoryGenerationMessage, SDKMemoryConsumptionMessage, SDKSkillEvolutionMessage, SDKAgentsMdSizeWarningMessage, 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, AgentMemoryScope, } from './agents.js';
 export { QoderModelPurpose } from './control.js';

package/dist/protocol/messages.d.ts

@@ -169,6 +169,8 @@ export type SDKResultError = {
     modelUsage: Record<string, ModelUsage>;
     permission_denials: SDKPermissionDenial[];
     errors: string[];
+    /** 服务端业务说明，仅做必要脱敏；缺失时省略，与 CLI 展示文案 errors 独立。 */
+    error_message?: string;
     error_code?: number | string;
     terminal_reason?: string | null;
     fast_mode_state?: FastModeState;
@@ -297,6 +299,27 @@ export type SDKCommandLifecycleMessage = {
     uuid: UUID;
     session_id: string;
 };
+/** Existing static configuration diagnostics; no Hook execution is performed.
+ * Delivery is scheduled in the background and may follow the refresh response.
+ * Each message replaces the previous diagnostics. An empty complete result means
+ * no issues were reported by existing checks, not that Hooks can run successfully.
+ */
+export type SDKHookDiagnosticsMessage = {
+    type: 'system';
+    subtype: 'hook_diagnostics';
+    read_status: 'complete' | 'partial' | 'failed';
+    checked_at: string;
+    diagnostics: Array<{
+        code: 'hook_validation_error' | 'settings_load_error' | 'plugin_hook_load_error' | 'hook_reload_error';
+        message: string;
+        event?: string;
+        field?: string;
+        /** Opaque configuration entry reference; changes when the entry changes. */
+        hook_ref?: string;
+    }>;
+    uuid: UUID;
+    session_id: string;
+};
 export type SDKHookStartedMessage = {
     type: 'system';
     subtype: 'hook_started';
@@ -615,4 +638,28 @@ export type SDKCommandsChangedMessage = {
     uuid: UUID;
     session_id: string;
 };
-export type SDKMessage = SDKAgentsMdSizeWarningMessage | SDKAssistantMessage | SDKUserMessage | SDKUserMessageReplay | SDKResultMessage | SDKSystemMessage | SDKArtifactUpdateMessage | SDKAvailableModelsUpdateMessage | SDKCommandsChangedMessage | SDKPermissionDeniedMessage | SDKPartialAssistantMessage | SDKCompactBoundaryMessage | SDKStatusMessage | SDKAPIRetryMessage | SDKModelQueueStatusMessage | SDKControlRequestProgressMessage | SDKCommandLifecycleMessage | SDKHookStartedMessage | SDKHookProgressMessage | SDKHookResponseMessage | SDKTaskNotificationMessage | SDKTaskStartedMessage | SDKTaskProgressMessage | SDKTaskUpdatedMessage | SDKBackgroundTasksChangedMessage | SDKSessionStateChangedMessage | SDKPlanModeChangedMessage | SDKGoalUpdatedMessage | SDKGoalClearedMessage | SDKSessionTitleChangedMessage | SDKFilesPersistedEvent | SDKElicitationCompleteMessage | SDKPromptSuggestionMessage | SDKCloudAgentEventMessage | SDKMemoryGenerationMessage | SDKMemoryConsumptionMessage | SDKSkillEvolutionMessage;
+/** Tool progress; optional shell output is a bounded replacement snapshot, never an append delta. */
+export type SDKToolProgressMessage = {
+    type: 'tool_progress';
+    uuid: string;
+    session_id: string;
+    tool_use_id: string;
+    tool_name: string;
+    parent_tool_use_id: string | null;
+    elapsed_time_seconds: number;
+    task_id?: string;
+    heartbeat?: boolean;
+    /** Shell snapshot identity and ordering; absent on elapsed-only notifications. */
+    execution_id?: string;
+    progress_sequence?: number;
+    phase?: 'running' | 'ended';
+    started_at_ms?: number;
+    elapsed_ms?: number;
+    /** UTF-8 preview capped at 4096 bytes. Totals describe the complete output. */
+    output?: string;
+    total_bytes?: number;
+    /** Omitted when the preview is truncated and the producer only has an estimate. */
+    total_lines?: number;
+    preview_truncated?: boolean;
+};
+export type SDKMessage = SDKToolProgressMessage | SDKAgentsMdSizeWarningMessage | SDKAssistantMessage | SDKUserMessage | SDKUserMessageReplay | SDKResultMessage | SDKSystemMessage | SDKArtifactUpdateMessage | SDKAvailableModelsUpdateMessage | SDKCommandsChangedMessage | SDKPermissionDeniedMessage | SDKPartialAssistantMessage | SDKCompactBoundaryMessage | SDKStatusMessage | SDKAPIRetryMessage | SDKModelQueueStatusMessage | SDKControlRequestProgressMessage | SDKCommandLifecycleMessage | SDKHookDiagnosticsMessage | SDKHookStartedMessage | SDKHookProgressMessage | SDKHookResponseMessage | SDKTaskNotificationMessage | SDKTaskStartedMessage | SDKTaskProgressMessage | SDKTaskUpdatedMessage | SDKBackgroundTasksChangedMessage | SDKSessionStateChangedMessage | SDKPlanModeChangedMessage | SDKGoalUpdatedMessage | SDKGoalClearedMessage | SDKSessionTitleChangedMessage | SDKFilesPersistedEvent | SDKElicitationCompleteMessage | SDKPromptSuggestionMessage | SDKCloudAgentEventMessage | SDKMemoryGenerationMessage | SDKMemoryConsumptionMessage | SDKSkillEvolutionMessage;

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

@@ -57,6 +57,7 @@ type InitConfig = {
     skills?: string[];
     planMode?: boolean;
     promptSuggestions?: boolean;
+    includeShellProgress?: boolean;
     hostActions?: Record<string, never>;
     goalMaxTurns?: number;
     enableFileCheckpointing?: boolean;
@@ -312,6 +313,7 @@ export declare class QueryRunner implements InternalQuery {
         objective?: string;
         status?: SDKGoalStatus;
         creditsBudget?: number | null;
+        customContext?: Record<string, string>;
     }): Promise<SDKGoalSnapshot | null>;
     setGoalMaxTurns(maxTurns: number | null): Promise<number>;
     /** 显式用户恢复，不通过 setGoal 激活来隐式增加轮次预算。 */
@@ -346,6 +348,7 @@ export declare class QueryRunner implements InternalQuery {
      */
     generateSessionTitle(description: string, options?: {
         persist?: boolean;
+        customContext?: Record<string, string>;
     }): Promise<SDKControlGenerateSessionTitleResponse['title']>;
     askSideQuestion(question: string, options?: AskSideQuestionOptions): Promise<SideQuestionResult | null>;
     /**

package/dist/runtime-manifest.json

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

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, SDKArtifactInfo, SDKArtifactUpdateMessage, SDKAvailableModelsUpdateMessage, SDKCommandsChangedMessage, SDKResultSuccess, SDKResultError, SDKResultMessage, SDKPartialAssistantMessage, SDKCompactBoundaryMessage, SDKAPIRetryMessage, SDKModelQueueStatusMessage, SDKControlRequestProgressMessage, SDKCommandLifecycleMessage, SDKHookStartedMessage, SDKHookProgressMessage, SDKHookResponseMessage, SDKTaskNotificationMessage, SDKTaskStartedMessage, SDKTaskProgressMessage, SDKTaskUpdatedMessage, SDKBackgroundTasksChangedMessage, SDKSessionStateChangedMessage, SDKPlanModeChangedMessage, SDKSessionTitleChangedMessage, SDKFilesPersistedEvent, SDKElicitationCompleteMessage, SDKPromptSuggestionMessage, SDKCloudAgentEventMessage, SDKMemoryGenerationMessage, SDKMemoryConsumptionMessage, SDKSkillEvolutionMessage, SDKAgentsMdSizeWarningMessage, SDKPermissionDenial, SDKMessageOrigin, SDKSelectedSkill, SDKToolNonExecutionKind, SDKToolResultMeta, } from '../protocol/index.js';
+export type { SDKAssistantMessage, SDKArtifactInfo, SDKArtifactUpdateMessage, SDKAvailableModelsUpdateMessage, SDKCommandsChangedMessage, SDKResultSuccess, SDKResultError, SDKResultMessage, SDKPartialAssistantMessage, SDKCompactBoundaryMessage, SDKAPIRetryMessage, SDKModelQueueStatusMessage, SDKControlRequestProgressMessage, SDKCommandLifecycleMessage, SDKToolProgressMessage, SDKHookDiagnosticsMessage, SDKHookStartedMessage, SDKHookProgressMessage, SDKHookResponseMessage, SDKTaskNotificationMessage, SDKTaskStartedMessage, SDKTaskProgressMessage, SDKTaskUpdatedMessage, SDKBackgroundTasksChangedMessage, SDKSessionStateChangedMessage, SDKPlanModeChangedMessage, SDKSessionTitleChangedMessage, SDKFilesPersistedEvent, SDKElicitationCompleteMessage, SDKPromptSuggestionMessage, SDKCloudAgentEventMessage, SDKMemoryGenerationMessage, SDKMemoryConsumptionMessage, SDKSkillEvolutionMessage, SDKAgentsMdSizeWarningMessage, SDKPermissionDenial, SDKMessageOrigin, SDKSelectedSkill, SDKToolNonExecutionKind, SDKToolResultMeta, } from '../protocol/index.js';
 export type SDKUserMessage = {
     type: 'user';
     message: MessageParam;

package/dist/types/options.d.ts

@@ -252,6 +252,8 @@ export type Options = {
     closeGraceMs?: number;
     includePartialMessages?: boolean;
     includeHookEvents?: boolean;
+    /** Opt in to bounded foreground shell previews via tool_progress on supported daemons. Defaults to off. */
+    includeShellProgress?: boolean;
     maxTurns?: number;
     /**
      * Maximum turns copied into Goals created later in this Query.

package/package.json

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