minimal-agent 0.18.9 → 0.18.11

package/src/tools/shared/fileState.js

@@ -16,6 +16,7 @@ export function recordRead(absPath, opts, state = defaultState) {
             && st.size === prev.size;
         const sameRegionUnchanged = sameSnapshot
             && prev.offset === opts?.offset
+            && prev.column === opts?.column
             && prev.limit === opts?.limit;
         const reads = sameRegionUnchanged ? (prev.reads ?? 1) + 1 : 1;
         // A bounded Read may be repeated in several adjacent calls.  Keep the
@@ -64,6 +65,7 @@ export function recordRead(absPath, opts, state = defaultState) {
             truncated: opts?.truncated ?? false,
             partial,
             offset: opts?.offset,
+            column: opts?.column,
             limit: opts?.limit,
             reads,
             ...(opts?.contentHash ? { contentHash: opts.contentHash } : {}),

package/src/tools/shared/fileState.ts

@@ -7,6 +7,7 @@ export interface FileStateEntry {
   truncated: boolean;
   partial: boolean;
   offset?: number;
+  column?: number;
   limit?: number;
   reads?: number;
   /** SHA-256 is recorded only for a complete read. */
@@ -42,6 +43,7 @@ export function recordRead(
     truncated?: boolean;
     partial?: boolean;
     offset?: number;
+    column?: number;
     limit?: number;
     contentHash?: string;
     range?: FileReadRange;
@@ -57,6 +59,7 @@ export function recordRead(
       && st.size === prev.size;
     const sameRegionUnchanged = sameSnapshot
       && prev.offset === opts?.offset
+      && prev.column === opts?.column
       && prev.limit === opts?.limit;
     const reads = sameRegionUnchanged ? (prev.reads ?? 1) + 1 : 1;
 
@@ -107,6 +110,7 @@ export function recordRead(
       truncated: opts?.truncated ?? false,
       partial,
       offset: opts?.offset,
+      column: opts?.column,
       limit: opts?.limit,
       reads,
       ...(opts?.contentHash ? { contentHash: opts.contentHash } : {}),

package/src/tools/shared/readBudget.js

@@ -0,0 +1,12 @@
+/** Conservative chars/token reservation works for mixed code and CJK text.
+ * A response's parallel Read calls share this closure, not separate quotas.
+ */
+export function createReadBudget(remainingTokens) {
+    let available = Math.max(0, Math.floor(remainingTokens * 0.5));
+    const perRead = Math.min(1_000_000, Math.max(1000, Math.floor(available / 2)));
+    return (requested = Math.min(240_000, perRead)) => {
+        const granted = Math.min(Math.max(0, requested), perRead, available);
+        available -= granted;
+        return granted;
+    };
+}

package/src/tools/shared/readBudget.ts

@@ -0,0 +1,12 @@
+/** Conservative chars/token reservation works for mixed code and CJK text.
+ * A response's parallel Read calls share this closure, not separate quotas.
+ */
+export function createReadBudget(remainingTokens: number) {
+  let available = Math.max(0, Math.floor(remainingTokens * 0.5));
+  const perRead = Math.min(1_000_000, Math.max(1000, Math.floor(available / 2)));
+  return (requested = Math.min(240_000, perRead)) => {
+    const granted = Math.min(Math.max(0, requested), perRead, available);
+    available -= granted;
+    return granted;
+  };
+}

package/src/tools/toolPromptGuides.js

@@ -88,7 +88,7 @@ export const BUILTIN_TOOL_PROMPT_GUIDES = {
 //      测试就是从这次真实回归里补的，锁住"压缩后仍要包含这些内容"而不是简单地
 //      锁住某个具体的压缩产物。
 export const CONTRACT_DESCRIPTION_OVERRIDES = {
-    Read: '读取文本、图片、Notebook 或 PDF。文本 offset 从 1 开始；截断后缩小 limit 重读区间，不能跳过未显示内容。PDF 用 pages 指定范围，一次最多 20 页。',
+    Read: '读取文本、图片、Notebook 或 PDF。offset 从 1 开始；大范围阅读可提高 limit/max_chars，实际预算由 Runtime 分配。按回执 offset/column 续读，不能跳过截断行。PDF 用 pages，一次最多 20 页。',
     Edit: '精确替换已有文本。先 Read 最新内容，old_string 必须唯一；多处相同替换传 replace_all=true。new_string 按字面写入。',
     Write: '创建文件或整体覆盖；新文件可直接写入。覆盖已有文件前须完整 Read（一次全量或分段覆盖全部范围）且内容未变化；仅有局部读取时使用 Edit/ApplyPatch。',
     ApplyPatch: '提交 Codex 格式补丁，必须用 *** Begin Patch / *** End Patch 包络，不接受裸 git diff。支持 Add/Update/Delete File、Move to；路径相对工作区。先校验，写入失败尝试回滚，不保证跨文件断电原子性。',
@@ -112,7 +112,7 @@ export const CONTRACT_DESCRIPTION_OVERRIDES = {
     Advisor: '向无工具权限的顾问模型请求一次结构化第二意见。默认 reviewMode=brief 只给重点短评；完整代码审查用 full，并提供范围、基线和证据。full 不扩大上下文或输出预算，材料不足时必须说明未完成。',
     // 保留决策必填条件，与 schema 的 superRefine 一致；不能只概括成“记录决定”。
     AdvisorDecision: '记录主 Agent 对顾问第二意见的 accept、partial 或 reject 判断；是否采纳由主 Agent 决定，登记不是执行许可。partial 同时填 acceptedPoints/rejectedPoints；reject 填 rejectedPoints，列出被拒绝点及依据；evidenceRefs 只引用真实 tool_call_id，没有引用则记录待验证。登记失败不阻止任务继续。',
-    MultiEdit: '同文件有序批量精确替换，先 Read；全部匹配成功才写盘。old_string 非空且唯一，或显式 replace_all。后续匹配前序生成文本会被拒绝，请合并 edits。',
+    MultiEdit: '同文件有序批量精确替换，先 Read 相关范围；全部匹配成功才写盘。old_string 非空且唯一，或显式 replace_all。后续匹配前序生成文本会被拒绝，请合并 edits。操作条数不等于替换次数，diff 预览可能不完整。',
     LSP: '查询定义、引用、类型、符号和诊断。line/character 为 1-based UTF-16；尚未收到诊断不等于没有错误，编辑前读取源码。',
     WebFetch: '读取已知 HTTP(S) URL 的静态文本，HTML 转 Markdown；不执行 JavaScript、不继承登录态。PDF/图片用 Download 后 Read；动态页面用 WebBrowser。',
     WebSearch: 'Tavily 搜索返回标题、URL、片段及可选综合答案，不是完整原文或浏览器。重要结论读取来源正文；按子问题查询，重试改变关键词或来源。recency 控制时效，历史范围用 start_date/end_date，none 关闭自动时效；advanced 更慢，news 偏新闻。需配置 Tavily。',

package/src/tools/toolPromptGuides.ts

@@ -105,7 +105,7 @@ export const BUILTIN_TOOL_PROMPT_GUIDES: Readonly<Record<string, ToolPromptGuide
 //      测试就是从这次真实回归里补的，锁住"压缩后仍要包含这些内容"而不是简单地
 //      锁住某个具体的压缩产物。
 export const CONTRACT_DESCRIPTION_OVERRIDES: Readonly<Record<string, string | (() => string)>> = {
-  Read: '读取文本、图片、Notebook 或 PDF。文本 offset 从 1 开始；截断后缩小 limit 重读区间，不能跳过未显示内容。PDF 用 pages 指定范围，一次最多 20 页。',
+  Read: '读取文本、图片、Notebook 或 PDF。offset 从 1 开始；大范围阅读可提高 limit/max_chars，实际预算由 Runtime 分配。按回执 offset/column 续读，不能跳过截断行。PDF 用 pages，一次最多 20 页。',
   Edit: '精确替换已有文本。先 Read 最新内容，old_string 必须唯一；多处相同替换传 replace_all=true。new_string 按字面写入。',
   Write: '创建文件或整体覆盖；新文件可直接写入。覆盖已有文件前须完整 Read（一次全量或分段覆盖全部范围）且内容未变化；仅有局部读取时使用 Edit/ApplyPatch。',
   ApplyPatch: '提交 Codex 格式补丁，必须用 *** Begin Patch / *** End Patch 包络，不接受裸 git diff。支持 Add/Update/Delete File、Move to；路径相对工作区。先校验，写入失败尝试回滚，不保证跨文件断电原子性。',
@@ -130,7 +130,7 @@ export const CONTRACT_DESCRIPTION_OVERRIDES: Readonly<Record<string, string | ((
   Advisor: '向无工具权限的顾问模型请求一次结构化第二意见。默认 reviewMode=brief 只给重点短评；完整代码审查用 full，并提供范围、基线和证据。full 不扩大上下文或输出预算，材料不足时必须说明未完成。',
   // 保留决策必填条件，与 schema 的 superRefine 一致；不能只概括成“记录决定”。
   AdvisorDecision: '记录主 Agent 对顾问第二意见的 accept、partial 或 reject 判断；是否采纳由主 Agent 决定，登记不是执行许可。partial 同时填 acceptedPoints/rejectedPoints；reject 填 rejectedPoints，列出被拒绝点及依据；evidenceRefs 只引用真实 tool_call_id，没有引用则记录待验证。登记失败不阻止任务继续。',
-  MultiEdit: '同文件有序批量精确替换，先 Read；全部匹配成功才写盘。old_string 非空且唯一，或显式 replace_all。后续匹配前序生成文本会被拒绝，请合并 edits。',
+  MultiEdit: '同文件有序批量精确替换，先 Read 相关范围；全部匹配成功才写盘。old_string 非空且唯一，或显式 replace_all。后续匹配前序生成文本会被拒绝，请合并 edits。操作条数不等于替换次数，diff 预览可能不完整。',
   LSP: '查询定义、引用、类型、符号和诊断。line/character 为 1-based UTF-16；尚未收到诊断不等于没有错误，编辑前读取源码。',
   WebFetch: '读取已知 HTTP(S) URL 的静态文本，HTML 转 Markdown；不执行 JavaScript、不继承登录态。PDF/图片用 Download 后 Read；动态页面用 WebBrowser。',
   WebSearch: 'Tavily 搜索返回标题、URL、片段及可选综合答案，不是完整原文或浏览器。重要结论读取来源正文；按子问题查询，重试改变关键词或来源。recency 控制时效，历史范围用 start_date/end_date，none 关闭自动时效；advanced 更慢，news 偏新闻。需配置 Tavily。',

package/src/tools/types.js

@@ -11,11 +11,7 @@ export const DEFAULT_MAX_RESULT_SIZE_CHARS = 30_000;
 /** Read 工具默认行数上限（与 kakadeai 主仓库一致） */
 export const MAX_LINES_TO_READ = 2000;
 /**
- * Read 工具默认字节上限（防止超大文件灌进上下文）。
- * 基于 200K 上下文窗口设计：
- * - system prompt + 工具定义 ≈ 30KB
- * - 对话历史 ≈ 100KB
- * - 单次读取安全上限 ≈ 256KB（~64K tokens）
- * 超过此限制请用 offset/limit 分段读。
+ * Text input IO ceiling, independent of the model's returned-content budget.
+ * Read windows are bounded separately and can reserve runtime context capacity.
  */
 export const MAX_FILE_SIZE_BYTES = 1024 * 1024 * 1024; // 1 GiB; returned content remains independently bounded

package/src/tools/types.ts

@@ -14,11 +14,7 @@ export const DEFAULT_MAX_RESULT_SIZE_CHARS = 30_000;
 export const MAX_LINES_TO_READ = 2000;
 
 /**
- * Read 工具默认字节上限（防止超大文件灌进上下文）。
- * 基于 200K 上下文窗口设计：
- * - system prompt + 工具定义 ≈ 30KB
- * - 对话历史 ≈ 100KB
- * - 单次读取安全上限 ≈ 256KB（~64K tokens）
- * 超过此限制请用 offset/limit 分段读。
+ * Text input IO ceiling, independent of the model's returned-content budget.
+ * Read windows are bounded separately and can reserve runtime context capacity.
  */
 export const MAX_FILE_SIZE_BYTES = 1024 * 1024 * 1024; // 1 GiB; returned content remains independently bounded

package/src/types.ts

@@ -291,8 +291,8 @@ export interface FilePatchSummary {
   unifiedDiff?: string;
   beforeHash?: string;
   afterHash: string;
-  additions: number;
-  deletions: number;
+  additions?: number;
+  deletions?: number;
   truncated: boolean;
   omittedReason?: 'too_large';
 }
@@ -397,6 +397,9 @@ export interface AdvisorCheckpointMetadata extends AdvisorVersions {
 
 export interface AdvisorConsultationMetadata extends AdvisorVersions {
   kind: 'advisor_consultation';
+  /** Host-recorded trigger, distinct from who emitted the tool call. Absent in old history. */
+  triggerSource?: 'checkpoint' | 'model';
+  triggerReason?: string;
   consultationId: string;
   checkpoint: AdvisorCheckpoint;
   checkpointKey: string;
@@ -570,6 +573,10 @@ export type ToolResult = { problem?: ToolProblemOutcome; observation?: ReadObser
  * 避免按工具名写特判分支。
  */
 export interface ToolCallContext {
+  /** Run-local host initialization shared with Advisor; never a model argument. */
+  advisorConsultation?: AdvisorConsultationMetadata;
+  /** Shared per-model-response read allowance; reservations happen before IO. */
+  reserveReadChars?: (requested?: number) => number;
   /** Host presentation only; cannot grant tools to a delegated agent. */
   output?: import('./runtime/outputContract.js').OutputContract;
   /** Live effective catalog, including per-turn restrictions. */