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

package/dist/daemon/daemon-connection.d.ts

@@ -7,12 +7,15 @@ import type { DiagnosticsSink } from "../core/sdk-diagnostics.js";
 export declare const SESSION_STORE_FILE_CHECKPOINTING_CAPABILITY = "session_store_file_checkpointing_v1";
 export declare const SESSION_STORE_FORK_BARRIER_CAPABILITY = "session_store_fork_barrier_v1";
 /**
- * 心跳判死阈值：30s 无任何入站帧即判 daemon 失活。与 CLI 仓
- * DAEMON_KEEP_ALIVE_INTERVAL_MS（5s 发送周期，本值 = 6 周期）镜像；能力常量
+ * 心跳判死阈值：120s 无任何入站字节即判 daemon 失活。与 CLI 仓
+ * DAEMON_KEEP_ALIVE_INTERVAL_MS（5s 发送周期，本值 = 24 周期）镜像；能力常量
  * DAEMON_KEEP_ALIVE_CAPABILITY 同为两仓镜像，靠握手协商门控——组合不匹配时
  * 最多不武装看门狗，不会误判。
+ *
+ * 阈值取 120s 而不是 30s：daemon 是共享进程，AI 代码统计等可选后台工作可能在
+ * 主线程上产生数十秒的计算停顿；30s 会把「忙」误判成「死」，连带终止全部会话。
  */
-export declare const DAEMON_HEARTBEAT_TIMEOUT_MS = 30000;
+export declare const DAEMON_HEARTBEAT_TIMEOUT_MS = 120000;
 export declare const DAEMON_KEEP_ALIVE_CAPABILITY = "daemon_keep_alive_v1";
 /**
  * daemon 会话 close 改成「关信道即回包、后台排干 teardown」的能力位（CLI 仓镜像）。
@@ -63,6 +66,12 @@ export interface DaemonInitializeOptions {
      * An empty string clears a previously configured proxy.
      */
     proxy?: string;
+    /**
+     * Proxy bypass list applied during the handshake (`daemon_proxy_bypass_v1`).
+     * Replaces `NO_PROXY` / `no_proxy` in the daemon process; an empty string
+     * clears both.
+     */
+    noProxy?: string;
 }
 export type DaemonRequestHandler = (request: DaemonControlRequestFrame) => Promise<JsonValue>;
 export declare class DaemonRpcError extends Error {
@@ -111,7 +120,12 @@ export interface DaemonSessionIdClaim {
 export declare class DaemonHeartbeatTimeoutError extends Error {
     readonly code = "DAEMON_HEARTBEAT_TIMEOUT";
     readonly elapsedMs: number;
-    constructor(elapsedMs: number);
+    /**
+     * 判死时是否正处在一条未收完的帧中间：区分「daemon 完全静默」与「大帧传到一半
+     * 停住」。两者都是连接级失败；该字段只用于现场归因，不改变判定与传播路径。
+     */
+    readonly partialFrame: boolean;
+    constructor(elapsedMs: number, partialFrame?: boolean);
 }
 export declare class DaemonConnection {
     private readonly input;
@@ -156,11 +170,20 @@ export declare class DaemonConnection {
     private readonly describeUnexpectedClose;
     private readonly diagnostics;
     /**
-     * 心跳看门狗：最近一次入站帧的单调钟时刻（任意入站帧都刷新——有正常会话流量
-     * 时天然免检，keep_alive 只是空闲期保底节拍）。单调钟使机器睡眠/唤醒后差值仍小，
-     * 不误杀。看门狗定时器与阈值见 armHeartbeatWatchdog。
+     * 心跳看门狗：最近一次**入站字节**的单调钟时刻（每个 chunk 都刷新——有正常会话
+     * 流量时天然免检，keep_alive 只是空闲期保底节拍）。
+     *
+     * 不能等整行收完再刷新：一条大帧（单个 tool 结果可达数 MiB）在慢速管道上可能连续
+     * 传输超过阈值，期间字节一直在到达、事件循环也正常，只是换行符还没出现。以行为
+     * 单位会把它误判成「daemon 失活」，进而 fail() 整条连接、连带杀掉全部会话。
+     * 单调钟使机器睡眠/唤醒后差值仍小，不误杀。看门狗定时器与阈值见 armHeartbeatWatchdog。
      */
     private lastInboundAt;
+    /**
+     * 是否正处在一条尚未收完的 NDJSON 帧中间。只用于判死时的诊断：区分「daemon 完全
+     * 静默」与「大帧传到一半停住」，不参与是否判死的判定（后者只看字节进展）。
+     */
+    private inboundFrameInProgress;
     private heartbeatWatchdog;
     private readonly heartbeatTimeoutMs;
     constructor(options: DaemonConnectionOptions);
@@ -170,8 +193,21 @@ export declare class DaemonConnection {
     /**
      * Switches the daemon-level (process-wide) proxy, or clears it with
      * `undefined` / `null` / an empty string. Returns the normalized value.
+     *
+     * `noProxy` omitted leaves the current bypass list unchanged; `null`
+     * restores the value inherited at daemon startup; a string replaces both
+     * `NO_PROXY` and `no_proxy`.
+     */
+    setProxy(proxy?: string | null, noProxy?: string | null): Promise<string | null>;
+    /**
+     * Same as `setProxy`, but also returns the effective bypass list. Gated on
+     * `daemon_proxy_bypass_v1` when `noProxy` is supplied so an older CLI cannot
+     * silently ignore the field.
      */
-    setProxy(proxy?: string | null): Promise<string | null>;
+    setProxySettings(proxy?: string | null, noProxy?: string | null): Promise<{
+        proxy: string | null;
+        noProxy: string | null;
+    }>;
     /**
      * 同步占用一个声明 id。opening/open 直接抛冲突；closing 则排队，ready 在
      * 前一次 close 出清后兑现。未声明 id（daemon 现 mint）不会撞，调用方不占用。

package/dist/daemon/global-daemon.d.ts

@@ -8,6 +8,8 @@ export interface InitDaemonOptions {
     /** 语义同 `StartDaemonOptions.executableArgs`。 */
     executableArgs?: string[];
     proxy?: string;
+    /** 语义同 `StartDaemonOptions.noProxy`。 */
+    noProxy?: string;
     /** 语义同 `StartDaemonOptions.vpcEndpoint`。 */
     vpcEndpoint?: string;
     env?: Record<string, string | undefined>;

package/dist/daemon/ndjson.d.ts

@@ -0,0 +1,12 @@
+/**
+ * JSON.stringify leaves U+2028/U+2029 raw inside strings. They are valid JSON,
+ * but Node's readline treats them as line breaks, which splits one NDJSON frame
+ * into several. Escape them so every reader that only honours "\n" stays compatible.
+ */
+export declare function escapeJsonLineSeparators(line: string): string;
+/**
+ * Split an NDJSON stream on "\n" only. CRLF is accepted by stripping the
+ * trailing "\r"; U+2028/U+2029 remain content and are never treated as
+ * terminators.
+ */
+export declare function readNdjsonLines(input: AsyncIterable<Buffer | string>): AsyncGenerator<string>;

package/dist/daemon/protocol.d.ts

@@ -28,6 +28,13 @@ export declare const DAEMON_VALIDATE_PLUGINS_CAPABILITY = "daemon_validate_plugi
  * and switch it later via `daemon.setproxy`.
  */
 export declare const DAEMON_PROXY_CAPABILITY = "daemon_proxy_v1";
+/**
+ * The daemon accepts a `no_proxy` bypass list alongside the process-wide proxy
+ * (`initialize` and `daemon.setproxy`), and applies it to its own environment.
+ * Older CLIs ignore the field, so callers must gate on this capability instead
+ * of assuming the bypass list was applied.
+ */
+export declare const DAEMON_PROXY_BYPASS_CAPABILITY = "daemon_proxy_bypass_v1";
 export type JsonPrimitive = string | number | boolean | null;
 export type JsonValue = JsonPrimitive | JsonValue[] | {
     [key: string]: JsonValue;
@@ -78,12 +85,26 @@ export interface DaemonSessionUpdatedStatusEventFrame {
 export interface KeepAliveFrame {
     type: "keep_alive";
 }
+/**
+ * Connection-level fatal signal emitted by the CLI when its NDJSON reader
+ * cannot recover the frame boundary (for example one user message split into
+ * multiple lines). It carries metadata only, never frame content.
+ */
+export interface DaemonProtocolErrorFrame {
+    type: "protocol_error";
+    code: string;
+    message?: string;
+    malformed_lines?: number;
+    malformed_bytes?: number;
+    last_frame_type?: string;
+    last_frame_session_id?: string;
+}
 /** A raw Query message carrying a daemon-local Session route. */
 export type DaemonWireSessionMessage = JsonObject & {
     type: string;
     session_id?: string;
 };
-export type DaemonProtocolFrame = DaemonControlRequestFrame | DaemonControlResponseFrame | DaemonSessionUpdatedStatusEventFrame | KeepAliveFrame | DaemonWireSessionMessage;
+export type DaemonProtocolFrame = DaemonControlRequestFrame | DaemonControlResponseFrame | DaemonSessionUpdatedStatusEventFrame | KeepAliveFrame | DaemonProtocolErrorFrame | DaemonWireSessionMessage;
 export type InitializeDaemonParams = {
     daemon_protocol_version: typeof DAEMON_PROTOCOL_VERSION;
     sdk_version: string;
@@ -102,6 +123,12 @@ export type InitializeDaemonParams = {
      * empty string clears a previously configured proxy.
      */
     proxy?: string;
+    /**
+     * Proxy bypass list applied during the handshake (`daemon_proxy_bypass_v1`).
+     * Replaces `NO_PROXY` / `no_proxy` in the daemon process; an empty string
+     * clears both.
+     */
+    no_proxy?: string;
 };
 export type InitializeDaemonResult = {
     daemon_protocol_version: typeof DAEMON_PROTOCOL_VERSION;
@@ -260,9 +287,17 @@ export type DaemonValidatePluginsResult = {
 export type DaemonSetProxyParams = {
     /** `null` clears the daemon-level proxy. */
     proxy: string | null;
+    /**
+     * Replaces the daemon's `NO_PROXY` / `no_proxy`. `null` restores the value
+     * inherited at daemon startup; an empty string clears both. Omitted leaves
+     * the current bypass list unchanged.
+     */
+    no_proxy?: string | null;
 };
 export type DaemonSetProxyResult = {
     proxy: string | null;
+    /** Present only when the request carried `no_proxy`. */
+    no_proxy?: string | null;
 };
 export type DaemonGetUsageInfoParams = Record<string, never>;
 export type DaemonGetUsageInfoResult = {

package/dist/daemon/start-daemon.d.ts

@@ -39,6 +39,12 @@ export interface StartDaemonOptions {
      * at any later point, whenever something first triggers the landing.
      */
     initializeTimeoutMs?: number;
+    /**
+     * 心跳看门狗阈值（ms）：超过这段时间没有任何入站字节即判 daemon 失活。
+     * 缺省 120s；0 关闭看门狗（逃生口）。只在 CLI 协商出 `daemon_keep_alive_v1` 后生效。
+     * 宿主一般不需要调整；测试与受限环境用它缩短判定窗口。
+     */
+    heartbeatTimeoutMs?: number;
     pathToQoderCLIExecutable?: string;
     /**
      * 运行 CLI 脚本入口的解释器（node/bun/deno 等），语义与 `query()` 的
@@ -55,6 +61,12 @@ export interface StartDaemonOptions {
      * 账号面与所有会话（`daemon_proxy_v1`）。运行期可用 `daemon.setProxy()` 切换。
      */
     proxy?: string;
+    /**
+     * daemon 进程级代理绕过名单：握手时随 `daemon.initialize` 写入
+     * `NO_PROXY` / `no_proxy`（`daemon_proxy_bypass_v1`）。空串表示清空；
+     * 运行期可用 `daemon.setProxy(proxy, { noProxy })` 切换或恢复。
+     */
+    noProxy?: string;
     /**
      * VPC private-deployment endpoint for the daemon process (CN deployments only).
      * Written to `QODERCN_VPC_ENDPOINT` / `QODER_VPC_ENDPOINT` before spawn; the CLI
@@ -105,13 +117,26 @@ export interface Daemon {
      * Set or clear the daemon-level (process-wide) proxy for every Session.
      * `undefined` / `null` / an empty string clears it. Requires
      * `daemon_proxy_v1`; resolves with the normalized proxy (or null).
+     *
+     * `options.noProxy` replaces the daemon's bypass list (`null` restores the
+     * value inherited at startup, an empty string clears it). Supplying it
+     * requires `daemon_proxy_bypass_v1`; omitting it leaves the current list
+     * unchanged.
      */
-    setProxy(proxy?: string | null): Promise<string | null>;
+    setProxy(proxy?: string | null, options?: {
+        noProxy?: string | null;
+    }): Promise<string | null>;
     /**
      * The daemon-level proxy currently in effect (`null` when unset/cleared, or
      * when the CLI does not support `daemon_proxy_v1`).
      */
     getProxy(): string | null;
+    /**
+     * The daemon-level proxy bypass list currently tracked by the SDK (`null`
+     * when unset/cleared or when the CLI does not support
+     * `daemon_proxy_bypass_v1`).
+     */
+    getNoProxy(): string | null;
     /**
      * Explicitly lands credentials and reports whether the daemon is authenticated.
      *
@@ -182,6 +207,12 @@ interface InternalDaemonRuntime {
     /** Local CLI launch context for feedback that bypasses the daemon. */
     readonly hostActionLaunch: {
         proxy?: string;
+        /**
+         * `undefined` uses the env as-is; `null` also uses the env (the CLI
+         * restored its startup value); a string overrides `NO_PROXY` / `no_proxy`
+         * for the one-shot CLI launch.
+         */
+        noProxy?: string | null;
         cliPath?: string;
         env?: Record<string, string | undefined>;
     };
@@ -198,6 +229,11 @@ interface InternalDaemonRuntime {
      * when the CLI ignored the handshake proxy). Updated by `setProxy`.
      */
     proxy: string | null;
+    /**
+     * The daemon-level proxy bypass list currently applied by the CLI (`null`
+     * when unset, or when the CLI does not support bypass updates).
+     */
+    noProxy: string | null;
     readonly transportProvider: QueryTransportProvider<ProcessTransportOptions>;
 }
 export declare function getDaemonRuntime(daemon: Daemon): InternalDaemonRuntime | undefined;

package/dist/index.d.ts

@@ -60,7 +60,7 @@ export type { DaemonFallbackReason, DaemonInitResult, InitDaemonOptions, } from
 export { startDaemon } from './daemon/start-daemon.js';
 export type { Daemon, DaemonState, DaemonSessionInfo, SessionRuntimeState, StartDaemonOptions, } from './daemon/start-daemon.js';
 export type { DaemonGetModelsParams, DaemonValidateByokModelParams, DaemonValidatePluginsParams, DaemonSetProxyParams, } from './daemon/protocol.js';
-export { DAEMON_PROXY_CAPABILITY, DAEMON_VALIDATE_PLUGINS_CAPABILITY, } from './daemon/protocol.js';
+export { DAEMON_PROXY_BYPASS_CAPABILITY, DAEMON_PROXY_CAPABILITY, DAEMON_VALIDATE_PLUGINS_CAPABILITY, } from './daemon/protocol.js';
 export { DEFAULT_RUNTIME_TRANSPORT, } from './core/default-runtime.js';
 export { ProcessTransport, QoderCliProcessError, } from './core/process-transport.js';
 export { hasResolvableQoderWorkerRuntime, QoderWorkerRuntimeError, WorkerTransport, resolveQoderWorkerRuntimePath, } from './core/worker-transport.js';
@@ -96,7 +96,7 @@ export type { AccessTokenInput, AuthOptions, FetchServiceAccountToken, ServiceAc
  */
 export type { FetchJobToken, JobTokenAuthOptions, JobTokenRequest, JobTokenResult, } from './types/auth.js';
 export type { Base64ImageSource, UrlImageSource, URLImageSource, ImageSource, ImageContentBlock, ImageBlockParam, ContentBlock, MessageParam, AccountInfo, UsageAddOnQuotaBucket, UsageInfo, UsageOrgResourcePackage, UsageQuotaBucket, SessionCreditsUsage, ApiKeySource, ExitReason, FastModeState, ConfigScope, SettingSource, SDKAssistantMessageError, SDKStatus, EffortLevel, ThinkingAdaptive, ThinkingEnabled, ThinkingDisabled, ThinkingConfig, ModelInfo, ModelSource, ServerModelJson, ServerModelJsonValue, ModelStrategy, ModelPromotion, LocalizedModelText, ModelContextConfig, ModelContextWindowEntry, ModelEffortEntry, ModelThinkingConfig, ModelThinkingDisabled, ModelThinkingEnabled, ModelUsage, NonNullableUsage, SlashCommand, ToolConfig, SdkPluginConfig, } from './types/common.js';
-export type { SDKMessage, SDKAssistantMessage, SDKToolNonExecutionKind, SDKToolResultMeta, SDKMessageOrigin, SDKSelectedSkill, SDKArtifactInfo, SDKArtifactUpdateMessage, SDKAvailableModelsUpdateMessage, SDKCommandsChangedMessage, SDKUserMessage, SDKUserMessageReplay, SDKResultMessage, SDKResultSuccess, SDKResultError, SDKSystemMessage, SDKSystemInitMessage, SDKSystemMessageSubtype, SDKSystemMessageBySubtype, SDKPartialAssistantMessage, SDKCompactBoundaryMessage, SDKStatusMessage, SDKAPIRetryMessage, SDKModelQueueStatusMessage, SDKControlRequestProgressMessage, SDKCommandLifecycleMessage, SDKHookStartedMessage, SDKHookProgressMessage, SDKHookResponseMessage, SDKPermissionDeniedMessage, SDKMirrorErrorMessage, SDKTaskNotificationMessage, SDKTaskStartedMessage, SDKTaskProgressMessage, SDKTaskUpdatedMessage, SDKBackgroundTasksChangedMessage, SDKSessionStateChangedMessage, SDKPlanModeChangedMessage, SDKSessionTitleChangedMessage, SDKFilesPersistedEvent, SDKElicitationCompleteMessage, SDKPromptSuggestionMessage, SDKCloudAgentEventMessage, SDKMemoryGenerationMessage, SDKMemoryConsumptionMessage, SDKSkillEvolutionMessage, SDKAgentsMdSizeWarningMessage, SDKPermissionDenial, } from './types/messages.js';
+export type { SDKMessage, SDKAssistantMessage, SDKToolNonExecutionKind, SDKToolResultMeta, SDKMessageOrigin, SDKSelectedSkill, SDKArtifactInfo, SDKArtifactUpdateMessage, SDKAvailableModelsUpdateMessage, SDKCommandsChangedMessage, SDKUserMessage, SDKUserMessageReplay, SDKResultMessage, SDKResultSuccess, SDKResultError, SDKSystemMessage, SDKSystemInitMessage, SDKSystemMessageSubtype, SDKSystemMessageBySubtype, SDKPartialAssistantMessage, SDKCompactBoundaryMessage, SDKStatusMessage, SDKAPIRetryMessage, SDKModelQueueStatusMessage, SDKControlRequestProgressMessage, SDKCommandLifecycleMessage, SDKToolProgressMessage, SDKHookDiagnosticsMessage, SDKHookStartedMessage, SDKHookProgressMessage, SDKHookResponseMessage, SDKPermissionDeniedMessage, SDKMirrorErrorMessage, SDKTaskNotificationMessage, SDKTaskStartedMessage, SDKTaskProgressMessage, SDKTaskUpdatedMessage, SDKBackgroundTasksChangedMessage, SDKSessionStateChangedMessage, SDKPlanModeChangedMessage, SDKSessionTitleChangedMessage, SDKFilesPersistedEvent, SDKElicitationCompleteMessage, SDKPromptSuggestionMessage, SDKCloudAgentEventMessage, SDKMemoryGenerationMessage, SDKMemoryConsumptionMessage, SDKSkillEvolutionMessage, SDKAgentsMdSizeWarningMessage, SDKPermissionDenial, } from './types/messages.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';