@qoder-ai/qoder-agent-sdk 1.0.58 → 1.0.59

package/dist/protocol/control.d.ts

@@ -188,6 +188,7 @@ export type SDKControlSetProxyRequest = {
     proxy: string | null;
 };
 export type SDKControlGenerateSessionTitleRequest = {
+    source_user_message_id?: string;
     type: 'generate_session_title';
     description: string;
     persist?: boolean;

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, 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 { SDKAssistantMessage, SDKHostToolUseMessage, SDKHostToolResultMessage, SDKCodeModeHostResult, 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

@@ -11,7 +11,7 @@
  * `@google/gemini-cli-core/protocol/schemas` are kept aligned via
  * `satisfies z.ZodType<...>` against these types.
  */
-import type { BetaMessage, BetaRawMessageStreamEvent, MessageParam, UUID, SDKAssistantMessageError, FastModeState, ApiKeySource, ModelUsage, NonNullableUsage, PluginInfo, ModelInfo, SlashCommand, SDKStatus } from './common.js';
+import type { BetaMessage, BetaRawMessageStreamEvent, MessageParam, UUID, SDKAssistantMessageError, FastModeState, ApiKeySource, ModelUsage, NonNullableUsage, ContentBlock, PluginInfo, ModelInfo, SlashCommand, SDKStatus } from './common.js';
 import type { PermissionMode } from './permissions.js';
 import type { MemoryConsumptionResult, MemoryGenerationResult } from './memory.js';
 import type { SkillEvolutionResult } from './skill-evolution.js';
@@ -73,6 +73,8 @@ export type SDKUserMessage = {
     message: MessageParam;
     parent_tool_use_id: string | null;
     custom_context?: Record<string, string>;
+    /** Additional Qoder headers for this input's first main-model request and its retries. */
+    extra_headers?: Record<string, string>;
     /** SDK telemetry metadata; started_at_ms/submitted_at_ms use Unix milliseconds. */
     extra?: Record<string, unknown>;
     /** The client has resolved slash commands, so a leading slash is literal input. */
@@ -239,6 +241,14 @@ export type SDKCompactBoundaryMessage = {
             tail_uuid: UUID;
         };
     };
+    /** 本次压缩的累计用量，包含失败尝试和重试；缺失 credits 表示未知。 */
+    usage?: {
+        context_usage_ratio?: number;
+        credits?: number;
+    };
+    /** 用于费用去重和归因的全部压缩请求 ID。 */
+    modelRequestIds?: string[];
+    agent_id?: string;
     uuid: UUID;
     session_id: string;
 };
@@ -247,6 +257,14 @@ export type SDKStatusMessage = {
     subtype: 'status';
     status: SDKStatus;
     permissionMode?: PermissionMode;
+    /** 本次压缩的累计用量，包含失败尝试和重试；缺失 credits 表示未知。 */
+    usage?: {
+        context_usage_ratio?: number;
+        credits?: number;
+    };
+    /** 用于费用去重和归因的全部压缩请求 ID。 */
+    modelRequestIds?: string[];
+    agent_id?: string;
     uuid: UUID;
     session_id: string;
 };
@@ -661,5 +679,55 @@ export type SDKToolProgressMessage = {
     /** Omitted when the preview is truncated and the producer only has an estimate. */
     total_lines?: number;
     preview_truncated?: boolean;
+    /** Native MCP progress for the call identified by tool_use_id. */
+    mcp?: {
+        server_name: string;
+        progress: number;
+        total?: number;
+        message?: string;
+    };
+};
+/** Native child tool result for the host, optionally persisted in a CodeMode call delta. */
+export type SDKCodeModeHostResult = {
+    content: string | ContentBlock[];
+    is_error?: boolean;
+    tool_use_result?: unknown;
+    tool_result_meta?: SDKToolResultMeta[];
+};
+type SDKHostToolEnvelope = {
+    type: 'system';
+    code_mode_tool_use_id: string;
+    uuid: UUID;
+    session_id: string;
+    parent_tool_use_id: string | null;
+};
+/** Host notification for a child tool call. Model usage and stop information belong to assistant messages. */
+export type SDKHostToolUseMessage = SDKHostToolEnvelope & {
+    subtype: 'host_tool_use';
+    message: {
+        role: 'assistant';
+        content: [
+            {
+                type: 'tool_use';
+                id: string;
+                name: string;
+                input: Record<string, unknown>;
+            }
+        ];
+    };
+};
+/** Output-only notification for a child tool result. */
+export type SDKHostToolResultMessage = SDKHostToolEnvelope & Pick<SDKCodeModeHostResult, 'tool_use_result' | 'tool_result_meta'> & {
+    subtype: 'host_tool_result';
+    message: {
+        role: 'user';
+        content: [
+            {
+                type: 'tool_result';
+                tool_use_id: string;
+            } & Pick<SDKCodeModeHostResult, 'content' | 'is_error'>
+        ];
+    };
 };
-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;
+export type SDKMessage = SDKHostToolUseMessage | SDKHostToolResultMessage | 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;
+export {};

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

@@ -47,9 +47,10 @@ import type { MemoryRuntimeCallbacks, SerializableMemoryConfig } from '../types/
 import type { SkillEvolutionRuntimeCallbacks, SerializableEvolutionConfig } from '../types/skill-evolution.js';
 import type { ResolveSessionArtifacts } from '../types/artifacts.js';
 import type { BYOKModelValidationInput, BYOKProviderInfo, ByokConfigCheckResult, ByokConfigInfo, ByokConfigReference, CheckByokConfigInput, CreateByokConfigInput, DeleteByokConfigInput, UpdateByokConfigInput } from '../types/byok.js';
-/** Init config passed to the initialize control request. */
+/** Query initialization and input settings. */
 type InitConfig = {
     sdkStartedAtMs?: number;
+    extraHeaders?: Record<string, string>;
     systemPrompt?: string;
     appendSystemPrompt?: string;
     modelRequestPatches?: ModelPromptPatches;
@@ -80,6 +81,7 @@ type InitConfig = {
 };
 export declare class QueryRunner implements InternalQuery {
     private readonly hostActionDirect;
+    private extraHeadersSent;
     private static readonly CUSTOM_CONTEXT_CAPABILITY;
     private static readonly SELECTED_SKILLS_CAPABILITY;
     private static readonly INITIALIZE_TIMEOUT_MS;
@@ -349,6 +351,7 @@ export declare class QueryRunner implements InternalQuery {
     generateSessionTitle(description: string, options?: {
         persist?: boolean;
         customContext?: Record<string, string>;
+        sourceUserMessageId?: 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.58",
-  "qoderCliVersion": "1.1.81",
+  "sdkVersion": "1.0.59",
+  "qoderCliVersion": "1.1.83",
   "defaultTransport": "worker",
   "workerRuntime": {
     "packaged": false,
     "delivery": "install",
     "source": "qodercli-worker-runtime",
-    "urlTemplate": "https://download.qoder.com/qodercli/releases/1.1.81/qodercli-worker-runtime-{target}.tgz",
+    "urlTemplate": "https://download.qoder.com/qodercli/releases/1.1.83/qodercli-worker-runtime-{target}.tgz",
     "artifactNameTemplate": "qodercli-worker-runtime-{target}.tgz",
-    "sdkVersion": "1.0.58",
-    "qoderCliVersion": "1.1.81"
+    "sdkVersion": "1.0.59",
+    "qoderCliVersion": "1.1.83"
   }
 }

package/dist/types/messages.d.ts

@@ -9,12 +9,14 @@ 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, 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 { SDKHostToolUseMessage, SDKHostToolResultMessage, SDKCodeModeHostResult, 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;
     parent_tool_use_id: string | null;
     custom_context?: Record<string, string>;
+    /** Additional Qoder headers for this input's first main-model request and its retries. */
+    extra_headers?: Record<string, string>;
     /** SDK telemetry metadata; started_at_ms/submitted_at_ms use Unix milliseconds. */
     extra?: Record<string, unknown>;
     /**

package/dist/types/options.d.ts

@@ -67,6 +67,16 @@ export type SecurityScanOptions = {
     l3DeepScan?: boolean;
 };
 export type Options = {
+    /** 当前 Query 的业务类型；产品身份在 initDaemon/startDaemon 中配置。 */
+    business?: {
+        type: string;
+    };
+    /**
+     * Additional Qoder inference headers for the first main-model request of the
+     * first queryable input, including network retries. Later requests and
+     * subagents do not inherit them. Existing built-in headers take precedence.
+     */
+    extraHeaders?: Record<string, string>;
     /**
      * Optional controller for defining when the host ends the session. Calling
      * `abort()` closes the session and ends message iteration.
@@ -514,6 +524,9 @@ export interface Query extends AsyncGenerator<SDKMessage, void> {
      */
     generateSessionTitle(description: string, options?: {
         persist?: boolean;
+        /** 原用户消息的 uuid；标题正文不参与业务归属匹配。 */
+        sourceUserMessageId?: string;
+        customContext?: Record<string, string>;
     }): Promise<SDKControlGenerateSessionTitleResponse['title']>;
     /**
      * Ask a one-off question using the current conversation context without

package/package.json

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