page-agent-sdk 2.20.0 → 2.21.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "page-agent-sdk",
-  "version": "2.20.0",
+  "version": "2.21.0",
   "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",
@@ -54,7 +54,8 @@
     "test:browser": "playwright test",
     "test:browser:ui": "playwright test --ui",
     "test:draft-real": "tsx tests/runtime/draft-real-llm.ts",
-    "test:trace-real": "tsx tests/runtime/trace-real-llm.ts"
+    "test:trace-real": "tsx tests/runtime/trace-real-llm.ts",
+    "test:maliang-real": "tsx tests/runtime/maliang-real-llm.ts"
   },
   "keywords": [
     "ai",

package/types/index.d.ts

@@ -147,6 +147,8 @@ export interface SubagentConfig {
   temperature?: number;
   maxTokens?: number;
   maxToolRounds?: number;
+  /** 子 agent 可写路径前缀白名单(给子 agent 写权限;写工具包 path guard,越界 PATH_OUT_OF_SCOPE;整体 set 禁)。subagent-writable Phase 2 */
+  writablePaths?: string[];
 }
 export interface AgentInfo {
   id: string;
@@ -487,7 +489,7 @@ export interface ChatSdkOptions {
   /** 自动乐观锁(默认 true):写入时若 LLM 未传 expectedHash,自动用其最后 get 读到的 hash 比对;设 false 回退「不传 = 不校验」 */
   autoLock?: boolean;
   /** 数据操作审计回调:每次 set/edit/delete/restore 经此回调外发结构化事件(独立于 debug,无需 debug:true);集成方做合规审计/操作追溯 */
-  onAudit?: (entry: { op: string; jsonPath?: string; opDetail?: string; timestamp: number; success: boolean; error?: string }) => void;
+  onAudit?: (entry: { op: string; value?: unknown; detail?: string; timestamp: number }) => void;
   /** 工具呈现模式:simple(默认,主推 read/write 但保留 query/search/eval/snapshot)| advanced(全暴露)| minimal(只 read/write) */
   toolMode?: 'simple' | 'advanced' | 'minimal';
   /** 读写拦截器:read/write 透传给数据工具(脱敏/转换/审计/拒绝 LLM 读写);input/output 在 agent IO 入口/出口预处理 */
@@ -996,7 +998,15 @@ export interface SubagentsController {
   remove(id: string): boolean;
   get(): SubagentConfig[];
 }
-export interface SubagentOptions { [k: string]: any }
+/** spawn_agent / spawn_agents 运行时选项(role/tools/writablePaths 等可运行时覆盖) */
+export interface SubagentOptions {
+  role?: string;
+  tools?: string[];
+  /** 子 agent 可写路径前缀白名单(运行时覆盖;写工具包 path guard,越界 PATH_OUT_OF_SCOPE)。subagent-writable Phase 2 */
+  writablePaths?: string[];
+  model?: string;
+  [k: string]: any;
+}
 export interface SubagentLlmConfig { [k: string]: any }
 
 // checkpoint / dataOps / permissions