page-agent-sdk 3.4.0 → 3.6.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "page-agent-sdk",
-  "version": "3.4.0",
+  "version": "3.6.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",

package/types/index.d.ts

@@ -342,7 +342,7 @@ export interface ContextInspectorMiddleware {
 }
 /** 创建上下文检查中间件(capabilities.contextInspector 默认开) */
 export declare function createContextInspectorMiddleware(opts?: ContextInspectorOptions): ContextInspectorMiddleware;
-export interface McpServerConfig { transport: 'http' | 'sse' | 'websocket'; url: string; name?: string; requestInit?: any; /** 握手超时 ms(默认 15s;fix-hang-and-feedback P1-2);超时按连接失败降级 */ timeoutMs?: number; }
+export interface McpServerConfig { transport: 'http' | 'sse' | 'websocket'; url: string; name?: string; requestInit?: any; /** 握手超时 ms(默认 15s;fix-hang-and-feedback P1-2);超时按连接失败降级 */ timeoutMs?: number; /** 单次工具调用超时 ms(默认 60s);超时该次调用作废回灌自纠,不断连接 */ callTimeoutMs?: number; }
 
 export declare const ChatDialog: DefineComponent<ChatDialogProps>;
 // chatdialog-component-split:原子组件(可拼装/替换,经 ChatDialog 具名 slot 或 L2 自建根组件 provide ctx 后拼装)
@@ -1408,7 +1408,8 @@ export interface CreateRagSubagentOptions {
   [k: string]: any;
 }
 export interface CreateHtmlSubagentOptions {
-  writablePaths: string[];
+  /** 可选:未传时装配期从 schema 顶层自动推断(z.array 元素含 codeField string 的路径);推断不出(开放 schema/嵌套容器/点路径 codeField)须显式传 */
+  writablePaths?: string[];
   codeVfsPrefix?: string;
   id?: string;
   description?: string;
@@ -1424,6 +1425,12 @@ export interface CreateHtmlSubagentOptions {
   codeField?: string;
   /** 自动注入主 agent 委派编排段(含正确 use_<id>);默认 true,false=不注入 */
   orchestratorPrompt?: boolean;
+  /**
+   * 组件工匠笔记;默认 true:子 agent 收口回复 [note] 行沉淀为组件 __pgNotes(随 data 持久化),
+   * 下次委派同组件经文件地图注入("前任的交接":设计决策/用户偏好/踩坑)—— 同组件跨委派设计意图持续。
+   * false 关闭(零沉淀零注入)
+   */
+  craftNotes?: boolean;
   [k: string]: any;
 }
 export declare function createRagSubagent(options: CreateRagSubagentOptions): SubagentConfig;