@qoder-ai/qoder-agent-sdk 1.0.57 → 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.57",
-  "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.57",
-    "qoderCliVersion": "1.1.81"
+    "sdkVersion": "1.0.59",
+    "qoderCliVersion": "1.1.83"
   }
 }

package/dist/types/index.d.ts

@@ -6,12 +6,9 @@ export * from './common.js';
 export * from './messages.js';
 export * from './memory.js';
 export * from './artifacts.js';
-export type { DefaultRuntimeTransport } from '../core/default-runtime.js';
 export type { QueryTransportCreateOptions, QueryTransportProviderOption, } from '../core/query-transport.js';
-export type { ProcessTransportOptions } from '../core/process-transport.js';
-export type { WorkerRuntimeTransportOptions, WorkerTransportOptions, } from '../core/worker-transport.js';
 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 type { ElicitationRequest, ElicitationResult, OnElicitation, PromptRequestOption, PromptRequest, PromptResponse, SecurityScanOptions, Options, QueryTransportOptions, 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';

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

@@ -1,4 +1,4 @@
-import type { Readable, Writable } from 'stream';
+import type { Readable, Writable } from 'node:stream';
 import type { CloseDiagnosticEvent } from './close-diagnostics.js';
 import type { ElicitResult } from '@modelcontextprotocol/sdk/types.js';
 import type { AuthOptions, InternalAuthOptions } from './auth.js';
@@ -9,7 +9,7 @@ import type { HookCallbackMatcher, HookEvent } from './hooks.js';
 import type { McpServerConfig, McpServerStatus, McpSetServersResult, OAuthToken } from './mcp.js';
 import type { SDKMessage, SDKUserMessage } from './messages.js';
 import type { Settings } from './settings.js';
-import type { SDKControlInterruptResponse, SDKControlInitializeResponse, SDKControlGetContextUsageResponse, SDKControlGenerateSessionTitleResponse, AskSideQuestionOptions, SideQuestionResult, SDKControlAddDirectoriesResponse, SDKControlReloadPluginsResponse, SDKControlReloadSkillsResponse, StdoutMessage } from './control.js';
+import type { SDKControlInterruptResponse, SDKControlInitializeResponse, SDKControlGetContextUsageResponse, SDKControlGenerateSessionTitleResponse, AskSideQuestionOptions, SideQuestionResult, SDKControlAddDirectoriesResponse, SDKControlReloadPluginsResponse, SDKControlReloadSkillsResponse } from './control.js';
 import type { ModelPolicyProvider } from './model-policy-provider.js';
 import type { BYOKModelValidationInput, BYOKProviderInfo, ByokConfigCheckResult, ByokConfigInfo, ByokConfigReference, CheckByokConfigInput, CreateByokConfigInput, DeleteByokConfigInput, UpdateByokConfigInput } from './byok.js';
 import type { RewindFilesResult, RewindResult, RewindScope } from './session.js';
@@ -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.
@@ -99,9 +109,9 @@ export type Options = {
      * - `{ type: 'jobToken', fetchJobToken }` - Internal first-party host
      *   integration. Prefer the `jobToken(fetchJobToken)` helper in host code.
      *
-     * Required for direct `query()` sessions. A Query using `options.daemon`
-     * inherits authentication configured when the daemon was started and must
-     * omit this field.
+     * Required unless `options.daemon` refers to a daemon that was started with
+     * its own credentials. Every other query starts the process-wide daemon with
+     * these credentials.
      */
     auth?: InternalAuthOptions;
     additionalDirectories?: string[];
@@ -124,13 +134,17 @@ export type Options = {
      */
     experimentalCloudAgent?: CloudAgentOptions;
     /**
-     * Selects the local query transport.
+     * Selects the shared daemon's launch carrier for the first implicit daemon
+     * start.
      *
-     * - omitted: use the transport baked into the installed SDK package.
-     * - `ProcessTransport.default`: spawn qodercli as a child process.
-     * - `WorkerTransport.default`: run qoder-worker-runtime in a Node worker thread.
-     * - `new WorkerTransport({ ... })`: run worker runtime with provider options.
+     * - omitted: the daemon uses the package's `DEFAULT_RUNTIME_TRANSPORT`.
+     * - `ProcessTransport.default`: launch qodercli as a process carrier.
+     * - `WorkerTransport.default`: launch the bundled worker runtime.
+     * - `new WorkerTransport({ ... })`: launch the given worker runtime.
      * - custom `QueryTransportProvider`: provide a fresh transport per query.
+     *
+     * Once the daemon is ready, a query with a different launch mode is rejected
+     * with `DaemonConfigurationConflictError`.
      */
     transport?: QueryTransportOptions;
     agent?: string;
@@ -245,11 +259,6 @@ export type Options = {
      * disable.
      */
     controlRequestTimeoutMs?: number;
-    /**
-     * Grace period in milliseconds before the local transport terminates qodercli
-     * after closing stdin. Defaults to 2000.
-     */
-    closeGraceMs?: number;
     includePartialMessages?: boolean;
     includeHookEvents?: boolean;
     /** Opt in to bounded foreground shell previews via tool_progress on supported daemons. Defaults to off. */
@@ -265,11 +274,10 @@ export type Options = {
     allowedMcpServerNames?: string[];
     model?: string;
     /**
-     * Path to a local Qoder runtime.
+     * Path to the local Qoder CLI entry that the daemon process launches.
      *
-     * Native binaries and ordinary JavaScript CLI entries use ProcessTransport.
-     * Recognized `qoder-worker-runtime*.mjs` entries use WorkerTransport. An
-     * explicit `transport` provider takes precedence over this automatic choice.
+     * Native binaries and JavaScript CLI entries are both supported; a script
+     * entry runs through `executable` (or the SDK host's Node binary).
      */
     pathToQoderCLIExecutable?: string;
     permissionMode?: PermissionMode;
@@ -361,6 +369,11 @@ export type Options = {
      * logging, but is not forwarded to qodercli.
      */
     debugFile?: string;
+    /**
+     * Accepted for compatibility with the former per-query transport. The
+     * shared daemon owns process termination, so this value is ignored.
+     */
+    closeGraceMs?: number;
     spawnQoderCLIProcess?: (options: SpawnOptions) => SpawnedProcess;
 };
 export interface SpawnOptions {
@@ -511,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
@@ -652,12 +668,4 @@ export interface InternalQuery extends Query {
     reconnectMcpServer(serverName: string): Promise<void>;
     mcpClearAuth(serverName: string): Promise<void>;
     injectMcpToken(serverName: string, token: OAuthToken): Promise<void>;
-}
-export interface Transport {
-    initialize(): Promise<void>;
-    write(data: string): void | Promise<void>;
-    close(): void;
-    isReady(): boolean;
-    readMessages(): AsyncGenerator<StdoutMessage, void, unknown>;
-    endInput(): void;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qoder-ai/qoder-agent-sdk",
-  "version": "1.0.57",
+  "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"
 }