page-agent-sdk 2.13.0 → 2.14.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "page-agent-sdk",
-  "version": "2.13.0",
+  "version": "2.14.0",
   "type": "module",
   "description": "Browser-native AI agent SDK: chat dialog + ReAct tool-calling + schema-validated JSON ops. Vue bundled, framework-agnostic. Works with DeepSeek/OpenAI/MCP.",
   "main": "./dist/page-agent-sdk.umd.cjs",
@@ -17,6 +17,18 @@
       "import": "./dist/page-agent-sdk.js",
       "require": "./dist/page-agent-sdk.umd.cjs"
     },
+    "./storage": {
+      "types": "./types/index.d.ts",
+      "import": "./dist/page-agent-sdk.js"
+    },
+    "./query": {
+      "types": "./types/index.d.ts",
+      "import": "./dist/page-agent-sdk.js"
+    },
+    "./llm": {
+      "types": "./types/index.d.ts",
+      "import": "./dist/page-agent-sdk.js"
+    },
     "./style.css": "./dist/page-agent-sdk.css"
   },
   "files": [
@@ -76,6 +88,7 @@
   },
   "devDependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
+    "@playwright/test": "^1.62.1",
     "@vitejs/plugin-vue": "^6.0.7",
     "tsx": "^4.23.1",
     "typescript": "^7.0.2",

package/types/index.d.ts

@@ -601,6 +601,16 @@ export interface ConflictInfo {
 }
 
 export declare function createChatSdk(options: ChatSdkOptions): ChatSdk;
+// ============ system prompt 构建(promptBuilder,refactor-module-extraction 从 createChatSdk 抽离)============
+/** 默认 systemPrompt(用户未传 systemPrompt 时用);含身份 + 能力概述 + 可靠写入规则 */
+export declare const DEFAULT_SYSTEM_PROMPT: string;
+/** 拼接「可操作数据」段(从 data schema .describe() 自动提取注入) */
+export declare function buildDataPrompt(data: DataConfig | undefined): string;
+/**
+ * 统一 systemPrompt base 段入口:处理 appendReliableWriteRules 分支 + '---' 分割线。
+ * 传 systemPrompt 默认追加 reliableWriteRules(设 appendReliableWriteRules:false 关闭);不传用 DEFAULT_SYSTEM_PROMPT(已内置)。纯函数。
+ */
+export declare function buildSystemPrompt(opts: { systemPrompt?: string; appendReliableWriteRules?: boolean }): string;
 export declare function defineTool(opts: {
   name: string;
   description: string;
@@ -609,6 +619,57 @@ export declare function defineTool(opts: {
 }): any;
 export declare function createDataOps(config: DataConfig, opts?: DataOpsOptions): any[];
 export declare function filterByToolMode(tools: any[], mode?: 'simple' | 'advanced' | 'minimal'): any[];
+// ============ 通用 JSON 操作纯函数(jsonUtils,refactor-module-extraction 从 dataOps 抽离;零依赖,经 ./query subpath 按需引入)============
+export type EditOp = 'set' | 'remove' | 'merge' | 'append';
+export declare const UNSAFE_KEYS: Set<string>;
+export declare function isUnsafePath(path: string): boolean;
+export declare function safeMerge(target: Record<string, any>, src: unknown): void;
+export declare function getByPath(obj: unknown, path: string): unknown;
+export declare function setByPath(obj: unknown, path: string, value: unknown): void;
+export declare function deleteByPath(obj: unknown, path: string): boolean;
+export declare function deepClone<T>(v: T): T;
+export declare function maybeParseValue(v: unknown): { parsed?: unknown; parseError?: unknown };
+export declare function projectFields(obj: unknown, fields: string[]): unknown;
+export declare function limitDepth(obj: unknown, depth: number): unknown;
+export declare function safeStringify(value: unknown, maxLen?: number): string;
+export declare function hashValue(value: unknown): string;
+export declare function applyPatchToClone(clone: any, op: EditOp, jsonPath: string, value: unknown): string | null;
+export declare function applyPatchToLive(bind: any, op: EditOp, jsonPath: string, value: unknown): void;
+export declare function restoreLive(bind: any, snapshotVal: unknown): void;
+export declare function restoreInPlace(live: Record<string, unknown> | unknown[], snapshotVal: unknown): void;
+// ============ schema 白名单投影纯函数(schemaUtils,refactor-module-extraction 从 dataOps 抽离)============
+export declare function getSchemaTopKeys(schema: any): string[] | null;
+export declare function isPathAllowed(jsonPath: string, schema: any | null, allowKeys: string[] | null): boolean;
+export declare function unwrapSchema(schema: any): any;
+export declare function getSchemaAtPath(schema: any, jsonPath: string): any | null;
+export declare function projectBySchemaDeep(obj: unknown, schema: any | null): unknown;
+export declare function projectBySchema(obj: unknown, allowKeys: string[] | null): unknown;
+// ============ 上下文索引纯函数(contextIndex,refactor-module-extraction 期二 从 useContextManager 抽离)============
+export declare const STOP_WORDS: Set<string>;
+export declare function tokenize(text: string): string[];
+export declare function estimateMessageTokens(m: any): number;
+export declare function estimateRoundTokens(r: any): number;
+export declare function indexSummarize(older: any[], preserve?: Set<string>): string;
+export declare function recallRounds(older: any[], query: string, topK: number): any[];
+// ============ LLM 解析(llmResolver,refactor-module-extraction 期二 从 createChatSdk 抽离)============
+export declare function isChatModel(v: unknown): boolean;
+export declare function resolveLlm(options: any): { modelCaps: any; summaryLlmInvoke: ((prompt: string) => Promise<string>) | undefined };
+// ============ 乐观锁冲突管理器(conflictManager,refactor-module-extraction 期二 从 createChatSdk 抽离)============
+export interface ConflictManager {
+  pendingConflict: import('vue').Ref<any | null>;
+  set(info: any): Promise<any>;
+  resolve(action: any): void;
+}
+export declare function createConflictManager(getEmit?: () => (((e: any) => void) | undefined)): ConflictManager;
+// ============ 配置解析 + 事件系统(optionsResolver/events,refactor-module-extraction 期三)============
+export declare function resolveStorage(storage: any): any | null;
+export declare function resolveDialogConfig(opts: any): any;
+export interface SdkEvents {
+  listeners: Set<(e: any) => void>;
+  emit: (e: any) => void;
+  hook(handler: (e: any) => void): () => void;
+}
+export declare function createSdkEvents(onEvent?: (e: any) => void): SdkEvents;
 export declare function selectBuiltinTools(caps: { dataOps?: boolean; fetch?: boolean } | undefined, dataOps: any[], fetchDocs: any[]): any[];
 export declare function createUsageHintsMiddleware(caps: { planning?: boolean; dataOps?: boolean; subagent?: boolean } | undefined, hasDataOps: boolean, toolMode?: 'simple' | 'advanced' | 'minimal'): any;
 export declare const fetchDocTools: any[];