@qoder-ai/qoder-agent-sdk 1.0.54 → 1.0.56

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

@@ -615,4 +615,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 | 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;
@@ -133,6 +134,11 @@ export declare class QueryRunner implements InternalQuery {
      * `--plugin-dir` 配置的插件。详见 DaemonAccountQueryPlane 的头注释。
      */
     private readonly daemonAccountQueries?;
+    /**
+     * daemon 绑定时读取当前 daemon 级代理。存在即表示本 Query 不能单独切代理：
+     * `setProxy` 只允许与 daemon 当前值一致（no-op），不一致直接报错。
+     */
+    private readonly daemonProxyProvider?;
     private resolveStreamInitialization;
     private initResponse?;
     private latestCommands;
@@ -160,7 +166,7 @@ export declare class QueryRunner implements InternalQuery {
     private closePromise?;
     private sessionStoreForkBarrierComplete;
     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, daemonAccountQueries?: DaemonAccountQueryPlane);
+    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, daemonAccountQueries?: DaemonAccountQueryPlane, daemonProxyProvider?: () => string | null);
     private getRecord;
     private normalizeLogPreview;
     private extractMessagePreview;
@@ -307,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 激活来隐式增加轮次预算。 */
@@ -341,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.54",
-  "qoderCliVersion": "1.1.74",
+  "sdkVersion": "1.0.56",
+  "qoderCliVersion": "1.1.78",
   "defaultTransport": "worker",
   "workerRuntime": {
     "packaged": false,
     "delivery": "install",
     "source": "qodercli-worker-runtime",
-    "urlTemplate": "https://download.qoder.com/qodercli/releases/1.1.74/qodercli-worker-runtime-{target}.tgz",
+    "urlTemplate": "https://download.qoder.com/qodercli/releases/1.1.78/qodercli-worker-runtime-{target}.tgz",
     "artifactNameTemplate": "qodercli-worker-runtime-{target}.tgz",
-    "sdkVersion": "1.0.54",
-    "qoderCliVersion": "1.1.74"
+    "sdkVersion": "1.0.56",
+    "qoderCliVersion": "1.1.78"
   }
 }

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, 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/dist/types/plugins.d.ts

@@ -130,9 +130,26 @@ export type PluginValidationReport = {
     };
     resources?: PluginResources;
 };
+/**
+ * The daemon surface `validatePlugin` needs. A real `Daemon` satisfies it
+ * structurally; hosts inject their handle so validation can run in-process.
+ */
+export type PluginValidationDaemon = {
+    readonly state: string;
+    supportsCapability(capability: string): boolean;
+    validatePlugins(paths: readonly string[], options?: {
+        configDir?: string;
+    }): Promise<PluginValidationReport[]>;
+};
 export type ValidatePluginOptions = {
     /** Optional qodercli executable or qoder Worker runtime entry override. */
     cliPath?: string;
     env?: Record<string, string>;
     signal?: AbortSignal;
+    /**
+     * Optional daemon handle. When it is ready and advertises
+     * `daemon_validate_plugins_v1`, validation runs inside the daemon instead of
+     * spawning a Worker process; otherwise it falls back transparently.
+     */
+    daemon?: PluginValidationDaemon;
 };

package/package.json

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