@zqagent/core 0.3.12 → 0.3.16

package/dist/{TurnEngine-BU4R7q_0.d.ts → TurnEngine-C8qqbilC.d.ts}

@@ -353,6 +353,17 @@ declare class OpenAIProvider implements ProviderClient {
      */
     private _apiMode;
     constructor(opts: {
+        /**
+         * API Key。
+         *
+         * - 显式 `""`（含纯空白）：**明确表示该端点不需要鉴权**（本地 Ollama /
+         *   llama.cpp、内网网关），不会回落到环境变量，SDK 收到占位 Key。
+         * - `undefined`：回落到 `OPENAI_API_KEY`；两者都没有时抛错（多数情况是
+         *   真的没配，早点给出可读提示好过让用户对着 401 猜）。
+         *
+         * 调用方不要用「配置里 Key 为空」来推断无需鉴权：那也可能只是还没填，
+         * 见 `LlmProviderEntry.noApiKey`。
+         */
         apiKey?: string;
         baseURL?: string;
         /** LLM 请求日志根目录，按日期分目录，不传则不记录 */
@@ -570,6 +581,17 @@ interface CompactionState {
  * 外部通过消费生成器产出的事件流来渲染实时进度、执行审批等。
  */
 
+/** 待注入的 steering 项（文本 + 可选的附件） */
+/**
+ * 一轮 / 一条用户消息的发起人（控制面用户）。
+ *
+ * 设备被共享时，同一会话里会有多个账号发起的任务；节点本地直连、桌面端与
+ * 未接入控制面的场景没有这个信息，此时为 undefined。
+ */
+interface TurnActor {
+    /** 控制面用户 id */
+    id: string;
+}
 /** TurnEngine 构造参数 */
 interface TurnEngineOpts {
     /** LLM Provider（流式调用） */
@@ -664,6 +686,8 @@ declare class TurnEngine {
     private _lastContextTokens;
     /** 压缩无进展时的消息条数快照；-1 表示无冷却 */
     private _compactStalledAt;
+    /** 溢出兜底：已 400 时无条件淘汰旧工具结果（下一次成功调用后复位） */
+    private _overflowElide;
     /** 显式配置的上下文窗口大小（token 数），未设置时为 undefined（走自动检测） */
     private _contextWindow;
     /** 压缩触发阈值比例（默认 0.8） */
@@ -716,7 +740,7 @@ declare class TurnEngine {
      */
     private _routeAttachments;
     /** 排队 steering 消息（下一迭代间隙注入为 user 消息） */
-    queueSteering(text: string, attachments?: MessageAttachment[], attachmentRefs?: StoredAttachment[]): void;
+    queueSteering(text: string, attachments?: MessageAttachment[], attachmentRefs?: StoredAttachment[], actor?: TurnActor): void;
     /**
      * 撤销一条尚未注入的 steering。
      *
@@ -735,7 +759,9 @@ declare class TurnEngine {
      */
     run(userInput: string, taskId?: string, attachments?: MessageAttachment[], 
     /** 附件落盘引用（由会话层先存盘再传入）：消息与事件只带它，不带 base64 */
-    attachmentRefs?: StoredAttachment[]): AsyncGenerator<WsEvent>;
+    attachmentRefs?: StoredAttachment[], 
+    /** 发起人（控制面用户）：设备共享时用于区分是谁发起的本轮 */
+    actor?: TurnActor): AsyncGenerator<WsEvent>;
     /** 重试 (仅在 Provider 错误后可用) */
     retry(): AsyncGenerator<WsEvent>;
     /** 从持久化的挂起点恢复 Turn (对齐 Python 版 resume) */
@@ -844,4 +870,4 @@ declare class TurnEngine {
     private _scanRecentFiles;
 }
 
-export { ApprovalOutcome as A, type CompactionStartInfo as C, type Decision as D, type EngineHook as E, Mode as M, OpenAIProvider as O, type ProviderClient as P, type ShellPolicy as S, TurnEngine as T, type WsEvent as W, type CompactionDoneInfo as a, EventType as b, type EngineErrorInfo as c, type Approver as d, type CompactionTrigger as e, PermissionEngine as f, type PermissionRequest as g, type ShellSandboxStatus as h, type TurnEngineOpts as i };
+export { ApprovalOutcome as A, type CompactionStartInfo as C, type Decision as D, type EngineHook as E, Mode as M, OpenAIProvider as O, type ProviderClient as P, type ShellPolicy as S, TurnEngine as T, type WsEvent as W, type CompactionDoneInfo as a, EventType as b, type EngineErrorInfo as c, type Approver as d, type CompactionTrigger as e, PermissionEngine as f, type PermissionRequest as g, type ShellSandboxStatus as h, type TurnActor as i, type TurnEngineOpts as j };

package/dist/{TurnEngine-BSciNywD.d.cts → TurnEngine-DKSczYaA.d.cts}

@@ -353,6 +353,17 @@ declare class OpenAIProvider implements ProviderClient {
      */
     private _apiMode;
     constructor(opts: {
+        /**
+         * API Key。
+         *
+         * - 显式 `""`（含纯空白）：**明确表示该端点不需要鉴权**（本地 Ollama /
+         *   llama.cpp、内网网关），不会回落到环境变量，SDK 收到占位 Key。
+         * - `undefined`：回落到 `OPENAI_API_KEY`；两者都没有时抛错（多数情况是
+         *   真的没配，早点给出可读提示好过让用户对着 401 猜）。
+         *
+         * 调用方不要用「配置里 Key 为空」来推断无需鉴权：那也可能只是还没填，
+         * 见 `LlmProviderEntry.noApiKey`。
+         */
         apiKey?: string;
         baseURL?: string;
         /** LLM 请求日志根目录，按日期分目录，不传则不记录 */
@@ -570,6 +581,17 @@ interface CompactionState {
  * 外部通过消费生成器产出的事件流来渲染实时进度、执行审批等。
  */
 
+/** 待注入的 steering 项（文本 + 可选的附件） */
+/**
+ * 一轮 / 一条用户消息的发起人（控制面用户）。
+ *
+ * 设备被共享时，同一会话里会有多个账号发起的任务；节点本地直连、桌面端与
+ * 未接入控制面的场景没有这个信息，此时为 undefined。
+ */
+interface TurnActor {
+    /** 控制面用户 id */
+    id: string;
+}
 /** TurnEngine 构造参数 */
 interface TurnEngineOpts {
     /** LLM Provider（流式调用） */
@@ -664,6 +686,8 @@ declare class TurnEngine {
     private _lastContextTokens;
     /** 压缩无进展时的消息条数快照；-1 表示无冷却 */
     private _compactStalledAt;
+    /** 溢出兜底：已 400 时无条件淘汰旧工具结果（下一次成功调用后复位） */
+    private _overflowElide;
     /** 显式配置的上下文窗口大小（token 数），未设置时为 undefined（走自动检测） */
     private _contextWindow;
     /** 压缩触发阈值比例（默认 0.8） */
@@ -716,7 +740,7 @@ declare class TurnEngine {
      */
     private _routeAttachments;
     /** 排队 steering 消息（下一迭代间隙注入为 user 消息） */
-    queueSteering(text: string, attachments?: MessageAttachment[], attachmentRefs?: StoredAttachment[]): void;
+    queueSteering(text: string, attachments?: MessageAttachment[], attachmentRefs?: StoredAttachment[], actor?: TurnActor): void;
     /**
      * 撤销一条尚未注入的 steering。
      *
@@ -735,7 +759,9 @@ declare class TurnEngine {
      */
     run(userInput: string, taskId?: string, attachments?: MessageAttachment[], 
     /** 附件落盘引用（由会话层先存盘再传入）：消息与事件只带它，不带 base64 */
-    attachmentRefs?: StoredAttachment[]): AsyncGenerator<WsEvent>;
+    attachmentRefs?: StoredAttachment[], 
+    /** 发起人（控制面用户）：设备共享时用于区分是谁发起的本轮 */
+    actor?: TurnActor): AsyncGenerator<WsEvent>;
     /** 重试 (仅在 Provider 错误后可用) */
     retry(): AsyncGenerator<WsEvent>;
     /** 从持久化的挂起点恢复 Turn (对齐 Python 版 resume) */
@@ -844,4 +870,4 @@ declare class TurnEngine {
     private _scanRecentFiles;
 }
 
-export { ApprovalOutcome as A, type CompactionStartInfo as C, type Decision as D, type EngineHook as E, Mode as M, OpenAIProvider as O, type ProviderClient as P, type ShellPolicy as S, TurnEngine as T, type WsEvent as W, type CompactionDoneInfo as a, EventType as b, type EngineErrorInfo as c, type Approver as d, type CompactionTrigger as e, PermissionEngine as f, type PermissionRequest as g, type ShellSandboxStatus as h, type TurnEngineOpts as i };
+export { ApprovalOutcome as A, type CompactionStartInfo as C, type Decision as D, type EngineHook as E, Mode as M, OpenAIProvider as O, type ProviderClient as P, type ShellPolicy as S, TurnEngine as T, type WsEvent as W, type CompactionDoneInfo as a, EventType as b, type EngineErrorInfo as c, type Approver as d, type CompactionTrigger as e, PermissionEngine as f, type PermissionRequest as g, type ShellSandboxStatus as h, type TurnActor as i, type TurnEngineOpts as j };

package/dist/{conflictGuard-BBOOIxxK.d.cts → conflictGuard-BuICnWEI.d.cts}

@@ -21,6 +21,14 @@ declare class ConflictGuard {
     private readonly digests;
     /** 记录一次读取：后续写入将以这个版本为基准 */
     noteRead(absPath: string, content: string): void;
+    /**
+     * 记录一次读取，指纹由调用方流式计算。
+     *
+     * 大文件不该为了算指纹而把整篇内容读进内存：`read_file` 用流式读取时
+     * 逐块 update 哈希，最后把结果交进来。指纹算法必须与 {@link contentDigest}
+     * 一致（sha256 hex 前 16 位），否则同一文件在读/写两侧会得出不同值。
+     */
+    noteReadDigest(absPath: string, digest: string): void;
     /** 记录一次自己的写入：更新基准，避免同会话连续写触发误报 */
     noteWrite(absPath: string, content: string): void;
     /** 是否读过该文件（用于判断「有没有保护」） */

package/dist/{conflictGuard-BBOOIxxK.d.ts → conflictGuard-BuICnWEI.d.ts}

@@ -21,6 +21,14 @@ declare class ConflictGuard {
     private readonly digests;
     /** 记录一次读取：后续写入将以这个版本为基准 */
     noteRead(absPath: string, content: string): void;
+    /**
+     * 记录一次读取，指纹由调用方流式计算。
+     *
+     * 大文件不该为了算指纹而把整篇内容读进内存：`read_file` 用流式读取时
+     * 逐块 update 哈希，最后把结果交进来。指纹算法必须与 {@link contentDigest}
+     * 一致（sha256 hex 前 16 位），否则同一文件在读/写两侧会得出不同值。
+     */
+    noteReadDigest(absPath: string, digest: string): void;
     /** 记录一次自己的写入：更新基准，避免同会话连续写触发误报 */
     noteWrite(absPath: string, content: string): void;
     /** 是否读过该文件（用于判断「有没有保护」） */