page-agent-sdk 3.42.0 → 3.43.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "page-agent-sdk",
-  "version": "3.42.0",
+  "version": "3.43.1",
   "type": "module",
   "description": "AI agent SDK for web pages — embed a chat assistant that edits page data via schema-validated tools. A lighter, framework-agnostic alternative to CopilotKit/LangChain for in-page JSON-editing agents. Vue-bundled; works with DeepSeek, OpenAI, MCP.",
   "main": "./dist/page-agent-sdk.umd.cjs",

package/types/headless.d.ts

@@ -318,7 +318,7 @@ export interface AgentInfo {
   memory: string;
   middleware: string[];
   todos: { id: string; content: string; status: string }[];
-  /** 规划阶段防死循环状态(maxPlanRevisions 预算;planning 关闭时 inPlanning 恒 false) */
+  /** 规划阶段防死循环状态(rounds = 计划修订次数,调研轮不计;planning 关闭时 inPlanning 恒 false) */
   planPhase?: { inPlanning: boolean; rounds: number; limit: number };
   /** 当前任务目标锚点(mission 中间件;未开启/未 capture → undefined) */
   mission?: Mission;
@@ -492,11 +492,6 @@ export interface DataConfig {
    *  配置后 read 受保护路径返占位符(精确值不入 LLM 消息流),写侧强制(freeze 拒/verbatim 展开校验)。
    *  opt-in:未配(默认)全部行为零变化 */
   resources?: ResourceProtectSpec[];
-  /**
-   * 装配期工具白名单(main-surface-slim Phase 1):`'high'` 预设(全量减旧四件 get/set/edit/delete_data)/
-   * 具体名单(按名过滤,未装配名 warn 留痕)。不传 = 全量零回归;仅首次装配生效,运行时 setData 忽略。
-   */
-  tools?: string[] | 'high';
 }
 /** createDataOps 选项(审计回调 / 快照上限 / 乐观锁) */
 export interface DataOpsOptions {
@@ -506,11 +501,6 @@ export interface DataOpsOptions {
   onConflict?: (conflict: ConflictInfo) => Promise<ConflictResolution>;
   /** 冲突监听字段白名单(任意深度字段名):声明后仅这些字段的值变动触发自动冲突检测(位置不敏感);未声明 = 不开自动检测(仅显式 expectedHash 校验);['*'] = 全字段检测(旧 autoLock 行为) */
   conflictWatchFields?: string[];
-  /**
-   * 装配期工具白名单(main-surface-slim Phase 1):`'high'` 预设(全量减旧四件 get/set/edit/delete_data)/
-   * 具体名单(按名过滤,未装配名 warn 留痕)。不传 = 全量零回归。
-   */
-  tools?: string[] | 'high';
 }
 
 /** 数据操作控制器(运行时替换配置;createDataOps 返回的工具数组上以不可枚举属性 `controller` 挂载) */
@@ -816,7 +806,7 @@ export interface ChatSdkOptions {
   permissions?: PermissionRule[];
   /** 自定义中间件(注入到内置中间件之后;可拦截/观察模型调用、工具、prompt) */
   middleware?: any[];
-    vfs?: { initialFiles?: Record<string, string>; maxBytes?: number; poolBytes?: { largeResults?: number; drafts?: number; userFiles?: number }; mainTools?: boolean };
+    vfs?: { initialFiles?: Record<string, string>; maxBytes?: number; poolBytes?: { largeResults?: number; drafts?: number; userFiles?: number } };
   /** 每个数据对象最多保留快照数(默认 20) */
   maxSnapshots?: number;
   /** 乐观锁冲突裁决策略(默认 'ask'):ask=挂起 pendingConflict 等人工 resolveConflict;overwrite=agent 强制覆盖(宿主与 agent 争同一份数据且 agent 优先时用,冲突自动收口不挂起,无人值守场景防永挂);keep_external=自动保留外部修改(agent 收到提示重新 read)。自动裁决仍外发 conflict 事件(conflict.autoResolved 标记) */
@@ -828,9 +818,9 @@ export interface ChatSdkOptions {
   /** 内存中保留的对话轮数上限(默认 50);超限把最旧轮次压缩为摘要 system 消息(防 OOM);0 关闭 */
   maxMemoryRounds?: number;
   debug?: boolean;
-  /** agent 工具调用轮次上限(默认 15);大 JSON 分块构建(draft_write×N + draft_commit + read 确认)是多轮场景,可能触顶被截断,建议调大到 20-30 */
+  /** agent 工具调用轮次上限(3.43 起默认 30);整页多组件搭建等计划规模天然需要多轮,预算吃紧时 SDK 自动注入两档轮次预算提示引导收口 */
   maxToolRounds?: number;
-  /** 规划阶段总轮次预算(默认 5);planning 状态下超限 → write_todos/update_todo 回灌,防"光规划不执行"死循环。与 maxIterations 正交 */
+  /** 计划修订次数上限(默认 5,只计 write_todos 调用,调研轮不计);超限 → 改计划形态的调用回灌(update_todo 纯 status/evidence 进度跟踪放行),防"反复改计划不执行"死循环。与 maxIterations 正交 */
   maxPlanRevisions?: number;
   /** 模型调用失败自动重试次数(默认 2;网络/429/5xx 重试,4xx 与 abort 不重试) */
   maxRetries?: number;

package/types/index.d.ts

@@ -654,7 +654,7 @@ export interface AgentInfo {
   memory: string;
   middleware: string[];
   todos: { id: string; content: string; status: string }[];
-  /** 规划阶段防死循环状态(maxPlanRevisions 预算;planning 关闭时 inPlanning 恒 false) */
+  /** 规划阶段防死循环状态(rounds = 计划修订次数,调研轮不计;planning 关闭时 inPlanning 恒 false) */
   planPhase?: { inPlanning: boolean; rounds: number; limit: number };
   /** 当前任务目标锚点(mission 中间件;未开启/未 capture → undefined) */
   mission?: Mission;
@@ -856,11 +856,6 @@ export interface DataConfig {
    *  配置后 read 受保护路径返占位符(精确值不入 LLM 消息流),写侧强制(freeze 拒/verbatim 展开校验)。
    *  opt-in:未配(默认)全部行为零变化 */
   resources?: ResourceProtectSpec[];
-  /**
-   * 装配期工具白名单(main-surface-slim Phase 1):`'high'` 预设(全量减旧四件 get/set/edit/delete_data)/
-   * 具体名单(按名过滤,未装配名 warn 留痕)。不传 = 全量零回归;仅首次装配生效,运行时 setData 忽略。
-   */
-  tools?: string[] | 'high';
 }
 /** createDataOps 选项(审计回调 / 快照上限 / 乐观锁) */
 export interface DataOpsOptions {
@@ -870,11 +865,6 @@ export interface DataOpsOptions {
   onConflict?: (conflict: ConflictInfo) => Promise<ConflictResolution>;
   /** 冲突监听字段白名单(任意深度字段名):声明后仅这些字段的值变动触发自动冲突检测(位置不敏感);未声明 = 不开自动检测(仅显式 expectedHash 校验);['*'] = 全字段检测(旧 autoLock 行为) */
   conflictWatchFields?: string[];
-  /**
-   * 装配期工具白名单(main-surface-slim Phase 1):`'high'` 预设(全量减旧四件 get/set/edit/delete_data)/
-   * 具体名单(按名过滤,未装配名 warn 留痕)。不传 = 全量零回归。
-   */
-  tools?: string[] | 'high';
 }
 
 /** 数据操作控制器(运行时替换配置;createDataOps 返回的工具数组上以不可枚举属性 `controller` 挂载) */
@@ -1205,7 +1195,7 @@ export interface ChatSdkOptions {
   permissions?: PermissionRule[];
   /** 自定义中间件(注入到内置中间件之后;可拦截/观察模型调用、工具、prompt) */
   middleware?: any[];
-    vfs?: { initialFiles?: Record<string, string>; maxBytes?: number; poolBytes?: { largeResults?: number; drafts?: number; userFiles?: number }; mainTools?: boolean };
+    vfs?: { initialFiles?: Record<string, string>; maxBytes?: number; poolBytes?: { largeResults?: number; drafts?: number; userFiles?: number } };
   /** 每个数据对象最多保留快照数(默认 20) */
   maxSnapshots?: number;
   /** 乐观锁冲突裁决策略(默认 'ask'):ask=挂起 pendingConflict 等人工 resolveConflict;overwrite=agent 强制覆盖(宿主与 agent 争同一份数据且 agent 优先时用,冲突自动收口不挂起,无人值守场景防永挂);keep_external=自动保留外部修改(agent 收到提示重新 read)。自动裁决仍外发 conflict 事件(conflict.autoResolved 标记) */
@@ -1217,9 +1207,9 @@ export interface ChatSdkOptions {
   /** 内存中保留的对话轮数上限(默认 50);超限把最旧轮次压缩为摘要 system 消息(防 OOM);0 关闭 */
   maxMemoryRounds?: number;
   debug?: boolean;
-  /** agent 工具调用轮次上限(默认 15);大 JSON 分块构建(draft_write×N + draft_commit + read 确认)是多轮场景,可能触顶被截断,建议调大到 20-30 */
+  /** agent 工具调用轮次上限(3.43 起默认 30);整页多组件搭建等计划规模天然需要多轮,预算吃紧时 SDK 自动注入两档轮次预算提示引导收口 */
   maxToolRounds?: number;
-  /** 规划阶段总轮次预算(默认 5);planning 状态下超限 → write_todos/update_todo 回灌,防"光规划不执行"死循环。与 maxIterations 正交 */
+  /** 计划修订次数上限(默认 5,只计 write_todos 调用,调研轮不计);超限 → 改计划形态的调用回灌(update_todo 纯 status/evidence 进度跟踪放行),防"反复改计划不执行"死循环。与 maxIterations 正交 */
   maxPlanRevisions?: number;
   /** 模型调用失败自动重试次数(默认 2;网络/429/5xx 重试,4xx 与 abort 不重试) */
   maxRetries?: number;