@qoder-ai/qoder-agent-sdk 1.0.50 → 1.0.52

package/dist/protocol/control.d.ts

@@ -635,6 +635,7 @@ export type ByokConfigCheckResult = {
 };
 export type SDKControlListByokConfigsRequest = {
     type: 'list_byok_configs';
+    uid?: string;
 };
 export type SDKControlListByokConfigsResponse = {
     configs: ByokConfigInfo[];

package/dist/query/daemon-account-queries.d.ts

@@ -0,0 +1,57 @@
+/**
+ * daemon 账号级查询面（窄接口）。
+ *
+ * 这是 QueryRunner 在「daemon 绑定的 Query」上把账号级查询改道到守护进程时唯一依赖的
+ * 契约。它只暴露 10 个账号级查询；**不包含** `Daemon` 的生命周期与写操作成员
+ * （`stop()` / `state` / `renameSession()` / `deleteSession()`），也**不包含**
+ * daemon 专属的会话目录查询 `listSessions`。
+ *
+ * 为什么 `listSessions` 不进这里：它是 **daemon 专属接口**，`Query` 上没有对应成员，
+ * 因此不存在「把 Query 的既有接口代理到 daemon」这回事。本接口的职责只有一件——把
+ * `Query` **本来就有**的账号级查询在 daemon 形态下改道到 `daemon.*`，绝不借它给
+ * `Query` 扩新能力。要给 `Query` 加成员，就得同时实现它的每一个实现者
+ * （`QueryRunner` 与 `CloudAgentQuery`），漏一个就是编译期破坏；需要会话目录的宿主
+ * 直接用 `Daemon.listSessions(cwd?)`，那条不经本接口。
+ *
+ * 同理 rename/delete 虽然也接受 cwd，但它们是**写操作**（改标题、删记录），属于宿主经
+ * `Daemon` 直接掌握的能力，绝不下放给 QueryRunner。
+ *
+ * 也**不包含** `listPlugins`——它看着像账号级查询，其实是会话级的。worker 协议里
+ * `list_plugins` 读的是会话自己的 Config（headlessSession.ts:9198），而 daemon 的
+ * `daemon.list_plugins` 读 daemon 根 Config；用户经 `--plugin-dir`（即 Query 的
+ * `plugins` 选项）配置的插件只装进会话 Config，根 Config 永远看不到。把它列进来会
+ * 让 daemon 绑定的 Query 静默返回一份缺了会话插件的清单——比报错更难发现。
+ * 故 `Query.listPlugins()` 一律走会话面（CLI 侧已注册会话级 `list_plugins`）；
+ * 需要账号级清单的宿主直接用 `Daemon.listPlugins()`，那条不经本接口。
+ *
+ * 为什么是窄接口而不是直接传整个 `Daemon`：
+ *
+ * 1. 职责隔离。QueryRunner 只负责把只读查询路由到 daemon 面，它不该、也不能持有
+ *    或操作 daemon 的生命周期。把整个 `Daemon` 塞进来会让 QueryRunner 凭空获得关闭
+ *    daemon、改名/删除会话等与本职责无关的权力——那是 startDaemon() 的调用方
+ *    （宿主）才应该掌握的能力。
+ * 2. 可测性。窄接口让单测可以用一个只实现这些方法的假对象钉住路由，不必启动
+ *    真实 daemon 进程，也不必构造完整的 `Daemon`。
+ * 3. 结构化兼容。TypeScript 是结构化类型：真正的 `Daemon` 天然满足这个更窄的接口，
+ *    所以 `query()` 在 daemon 绑定分支里直接把 `options.daemon` 传进来即可，无需适配层。
+ *
+ * 方法名与签名刻意与 `Daemon`（`../daemon/start-daemon.js`）保持一致，而不是与 `Query`
+ * 的对外方法名一致——这样 `Daemon` 能被直接赋值给本接口。QueryRunner 负责把 Query 的
+ * 对外语义（吞错、可空性、入参形状）适配到这些 daemon 方法上，契约差异收敛在
+ * QueryRunner 一侧，不外泄到本接口。
+ */
+import type { DaemonGetModelsParams, DaemonValidateByokModelParams } from '../daemon/protocol.js';
+import type { BYOKProviderInfo, ByokConfigCheckResult, ByokConfigInfo, ByokConfigReference, CheckByokConfigInput, CreateByokConfigInput, DeleteByokConfigInput, UpdateByokConfigInput } from '../protocol/control.js';
+import type { AccountInfo, ModelInfo, UsageInfo } from '../protocol/common.js';
+export interface DaemonAccountQueryPlane {
+    getModels(options?: DaemonGetModelsParams): Promise<ModelInfo[]>;
+    getByokConfig(): Promise<BYOKProviderInfo[]>;
+    validateByokModel(input: DaemonValidateByokModelParams): Promise<boolean>;
+    listByokConfigs(): Promise<ByokConfigInfo[]>;
+    createByokConfig(input: CreateByokConfigInput): Promise<ByokConfigReference>;
+    updateByokConfig(input: UpdateByokConfigInput): Promise<void>;
+    deleteByokConfig(target: DeleteByokConfigInput): Promise<void>;
+    checkByokConfig(input: CheckByokConfigInput): Promise<ByokConfigCheckResult>;
+    getUsageInfo(): Promise<UsageInfo | null>;
+    accountInfo(): Promise<AccountInfo>;
+}

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

@@ -32,6 +32,7 @@ import type { SDKPlanModeSnapshot, SDKGoalSnapshot, SDKGoalStatus, SDKControlInt
 import type { PermissionMode, CanUseTool } from '../types/permissions.js';
 import type { HookCallbackMatcher } from '../types/hooks.js';
 import type { HookEvent as InternalHookEvent } from '../protocol/index.js';
+import type { DaemonAccountQueryPlane } from './daemon-account-queries.js';
 import type { McpServerConfig, McpServerStatus, McpSetServersResult, OAuthToken } from '../types/mcp.js';
 import type { McpToolRuntimeOverride } from '../protocol/mcp.js';
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
@@ -119,10 +120,24 @@ export declare class QueryRunner implements InternalQuery {
     private readonly skillEvolutionCallbacks?;
     private readonly hostActionFallback?;
     private readonly resolveSessionArtifacts?;
+    /**
+     * daemon 绑定时注入的账号级查询窄接口。存在即表示这条 Query 挂在守护进程上，
+     * 10 个账号级方法（getAvailableModels / listByokProviders / validateByokModel /
+     * 4 个 BYOK 配置管理 / accountInfo / getUsageInfo）必须改道到 daemon 面，
+     * 而不是往会话面发控制请求——CLI 按设计不在会话面注册这些方法，
+     * 落到会话面只会回 `Unsupported control request type`。缺省（普通 worker /
+     * process Query）时这些方法照旧走会话面。
+     *
+     * `listPlugins` 刻意**不在**这 10 个里：它是会话级语义（读会话自己的 Config），
+     * 改道到账号级 `daemon.list_plugins` 会静默漏掉用户经 `plugins` 选项 /
+     * `--plugin-dir` 配置的插件。详见 DaemonAccountQueryPlane 的头注释。
+     */
+    private readonly daemonAccountQueries?;
     private resolveStreamInitialization;
     private initResponse?;
     private latestCommands;
     private initializationPromise?;
+    private rejectInitialization?;
     private resultMessage?;
     /**
      * True only while the latest completed turn is an error result and no newer
@@ -145,7 +160,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);
+    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);
     private getRecord;
     private normalizeLogPreview;
     private extractMessagePreview;
@@ -242,6 +257,8 @@ export declare class QueryRunner implements InternalQuery {
      * CLI and waits for the system init message.
      */
     initialize(): Promise<SDKControlInitializeResponse>;
+    private startInitialization;
+    private failInitialization;
     private performInitialize;
     private completeSessionStoreForkBarrier;
     private flushTranscriptMirrorForLifecycle;
@@ -360,7 +377,9 @@ export declare class QueryRunner implements InternalQuery {
      * Validate a BYOK provider/model/API-key combination through the CLI.
      */
     validateByokModel(input: BYOKModelValidationInput): Promise<boolean | null>;
-    listByokConfigs(): Promise<ByokConfigInfo[]>;
+    listByokConfigs(options?: {
+        uid: string;
+    }): Promise<ByokConfigInfo[]>;
     createByokConfig(input: CreateByokConfigInput): Promise<ByokConfigReference>;
     updateByokConfig(input: UpdateByokConfigInput): Promise<void>;
     deleteByokConfig(target: DeleteByokConfigInput): Promise<void>;

package/dist/runtime-manifest.json

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

package/dist/types/close-diagnostics.d.ts

@@ -0,0 +1,10 @@
+/** 关闭诊断仅包含 SDK 生成的标识和固定阶段，不携带输入、路径或原始异常。 */
+export interface CloseDiagnosticEvent {
+    readonly correlationId: string;
+    readonly component: 'query' | 'worker';
+    readonly stage: 'close' | 'flush' | 'memory_flush' | 'skill_flush' | 'mcp_close' | 'transport_close' | 'read_loop' | 'transcript_flush' | 'initialize' | 'worker_exit' | 'worker_exit_observed' | 'terminate' | 'artifacts';
+    readonly outcome: 'started' | 'completed' | 'failed';
+    readonly elapsedMs: number;
+    readonly exitCode?: number;
+    readonly errorCode?: 'SDK_CLOSE_STAGE_FAILED';
+}

package/dist/types/options.d.ts

@@ -1,4 +1,5 @@
 import type { Readable, Writable } from 'stream';
+import type { CloseDiagnosticEvent } from './close-diagnostics.js';
 import type { ElicitResult } from '@modelcontextprotocol/sdk/types.js';
 import type { AuthOptions, InternalAuthOptions } from './auth.js';
 import type { AgentDefinition, AgentInfo } from './agents.js';
@@ -345,6 +346,8 @@ export type Options = {
      * @default 500
      */
     resolveModelTimeoutMs?: number;
+    /** 脱敏的关闭阶段通知；无需启用 debug，不等待回调完成，回调错误不影响关闭。 */
+    onCloseDiagnostic?: (event: CloseDiagnosticEvent) => void;
     /**
      * Enable SDK debug logging and forward `--debug` to the qodercli child
      * process. Without `debugFile`, SDK debug output is written to `stderr`
@@ -553,8 +556,11 @@ export interface Query extends AsyncGenerator<SDKMessage, void> {
      * List persisted UID-scoped BYOK models plus User-scope Custom Providers.
      * Credentials are never returned. Use listByokProviders() for the server
      * provider/model catalog.
+     * 传入 UID 时要求只读能力，供 bare 查询本地摘要；省略时沿用完整管理通道。
      */
-    listByokConfigs(): Promise<ByokConfigInfo[]>;
+    listByokConfigs(options?: {
+        uid: string;
+    }): Promise<ByokConfigInfo[]>;
     /** Persist a server BYOK model or User-scope Custom Provider. */
     createByokConfig(input: CreateByokConfigInput): Promise<ByokConfigReference>;
     /** Update an existing BYOK entry by its stable storage key/provider id. */

package/package.json

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