page-agent-sdk 3.44.1 → 3.45.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "page-agent-sdk",
3
- "version": "3.44.1",
3
+ "version": "3.45.0",
4
4
  "type": "module",
5
5
  "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.",
6
6
  "main": "./dist/page-agent-sdk.umd.cjs",
@@ -1123,6 +1123,7 @@ export declare function defineTool(opts: {
1123
1123
  description: string;
1124
1124
  schema: any;
1125
1125
  handler: (args: any) => unknown | Promise<unknown>;
1126
+ writeCapable?: boolean | ((args: Record<string, unknown>) => boolean);
1126
1127
  }): any;
1127
1128
  export declare function createDataOps(config: DataConfig, opts?: DataOpsOptions): any[];
1128
1129
  /** 整体 set 写入纯函数:schema 校验 + 快照 + merge/替换 + audit。set_data / write(set) / draft_commit 共用。返回 {ok,hash,data} 或 {ok:false,error} */
package/types/index.d.ts CHANGED
@@ -1548,6 +1548,8 @@ export declare function defineTool(opts: {
1548
1548
  description: string;
1549
1549
  schema: any;
1550
1550
  handler: (args: any) => unknown | Promise<unknown>;
1551
+ /** 等效写标注:声明本工具会变更宿主数据(如编辑器结构工具);生效于零工具门禁/fact-sheet/stale-read 失效与 evidence 审计账本。布尔或 args 判定函数(条件写);缺省 false */
1552
+ writeCapable?: boolean | ((args: Record<string, unknown>) => boolean);
1551
1553
  }): any;
1552
1554
  export declare function createDataOps(config: DataConfig, opts?: DataOpsOptions): any[];
1553
1555
  /** 整体 set 写入纯函数:schema 校验 + 快照 + merge/替换 + audit。set_data / write(set) / draft_commit 共用。返回 {ok,hash,data} 或 {ok:false,error} */