page-agent-sdk 3.10.0 → 3.10.1

package/dist/page-agent-sdk.js

@@ -24742,4 +24742,4 @@ function bD(e) {
 	return qg(e, pD);
 }
 //#endregion
-export { BS as ApprovalBar, sh as CAPABILITIES, uh as CONTEXT_PRESETS, fD as ChatDialog, p_ as ChatHeader, lC as ChatInput, qx as CodePreview, xm as CompressDecisionSchema, ZS as ConflictBar, Ip as DEFAULT_SYSTEM_PROMPT, JE as DebugDrawer, y_ as FocusBar, Ex as HLJS_BLOCK_MAX_CHARS, Qp as HTML_VOID_TAGS, pf as HUMAN_CONFIRM_TOOL_NAME, Hl as MIN_CONTEXT_WINDOW, Yx as MessageContent, bS as MessageList, fS as MessageRow, OS as QueuedBar, Pf as STOP_WORDS, dD as SkillPanel, dd as UNSAFE_KEYS, Cg as actionsToInspectInfo, Sg as actionsToTools, Fl as agentError, kp as analyzeContext, wd as applyPatchToClone, Dd as applyPatchToLive, Pl as asAgentError, Lp as buildDataPrompt, Rp as buildSystemPrompt, Zg as chatContextKey, Xh as commitSetToBind, Fp as connectMcp, C as constructLlmFromConfig, S as constructOpenLlmSync, Xg as copyText, Tu as createAgent, ff as createApprovalMiddleware, Qg as createChatContext, bD as createChatSdk, Cf as createCheckpointManager, wf as createCheckpointMiddleware, Nm as createConflictManager, Ap as createContextInspectorMiddleware, ig as createDataOps, mm as createHtmlFormatCheck, _m as createHtmlSubagent, gf as createHumanConfirmMiddleware, hf as createHumanConfirmTool, eh as createMemoryBackend, af as createMemoryMiddleware, y as createProxyLlm, yD as createRagSubagent, Hd as createSandboxRunner, lh as createSdkEvents, Bg as createSerialRunner, ih as createSessionStore, Ig as createSkillStore, op as createSubagentMiddleware, Wf as createSubagentTracker, lp as createSubagentsMiddleware, Ag as createUsageHintsMiddleware, up as createVerifyMiddleware, Hp as createVfs, nh as createWebStorageBackend, gp as createWriteBackCheck, _d as deepClone, Eg as defineDataToolset, Wd as defineSkill, vm as defineTool, gd as deleteByPath, Sm as deriveTitle, Hu as describeSchemaNode, fu as detectGarbledToolCall, Ad as diffObjects, ug as domToStructure, fg as domTools, Tg as domToolsStatic, If as estimateMessageTokens, Lf as estimateRoundTokens, Wl as estimateTokens, T as extractReasoningDelta, td as extractSchemaHint, jp as extractText, w as extractTextDelta, E as extractUsage, og as fetchDocTools, wg as fetchTools, Yh as filterByToolMode, Uu as formatConstraints, Al as formatZodIssues, md as getByPath, dg as getDomTool, hg as getEnvSummary, ku as getSchemaAtPath, Eu as getSchemaTopKeys, ql as getTraceMetrics, Cd as hashValue, pm as htmlFragmentSkill, Xu as htmlOrchestratorPrompt, Rf as indexSummarize, vg as inspectEnvTool, yg as inspectTools, Cm as isChatModel, ru as isContextLengthError, Du as isPathAllowed, Km as isQuotaError, fd as isUnsafePath, wh as jpEval, Ml as jsonParseError, bd as limitDepth, Mx as markedToHtml, vd as maybeParseValue, Ed as moveByPath, x as normalizeBaseUrl, D as normalizeUsage, Kl as offloadPassThroughChars, Gl as offloadThresholdChars, Yu as presets, Iu as projectBySchema, Fu as projectBySchemaDeep, yd as projectFields, zf as recallRounds, Nx as renderMarkdownHtml, Wu as renderSchemaHint, Gu as renderSchemaOverview, Ju as renderSchemaShallow, ch as resolveCapabilities, fh as resolveContextOptions, oh as resolveDialogConfig, Mm as resolveLlm, Ul as resolveModelCaps, ah as resolveStorage, kd as restoreInPlace, Od as restoreLive, Nl as routeError, Ud as runHostScript, Oh as runSandboxedScript, pd as safeMerge, mg as safeSerialize, xd as safeStringify, Eh as searchJson, Dg as selectBuiltinTools, hd as setByPath, Bf as shouldTriggerCompression, b as stripStainlessFetch, Zu as systemPromptHelpers, Ff as tokenize, $ as toolError, Ou as unwrapSchema, Yg as useChat, $g as useChatContext, em as validateHtmlFormat, e as z, jl as zodError };
+export { BS as ApprovalBar, sh as CAPABILITIES, uh as CONTEXT_PRESETS, fD as ChatDialog, p_ as ChatHeader, lC as ChatInput, qx as CodePreview, xm as CompressDecisionSchema, ZS as ConflictBar, Ip as DEFAULT_SYSTEM_PROMPT, JE as DebugDrawer, y_ as FocusBar, Ex as HLJS_BLOCK_MAX_CHARS, Qp as HTML_VOID_TAGS, pf as HUMAN_CONFIRM_TOOL_NAME, Hl as MIN_CONTEXT_WINDOW, Yx as MessageContent, bS as MessageList, fS as MessageRow, OS as QueuedBar, Pf as STOP_WORDS, dD as SkillPanel, dd as UNSAFE_KEYS, Cg as actionsToInspectInfo, Sg as actionsToTools, Fl as agentError, kp as analyzeContext, wd as applyPatchToClone, Dd as applyPatchToLive, Pl as asAgentError, Lp as buildDataPrompt, Rp as buildSystemPrompt, Zg as chatContextKey, Xh as commitSetToBind, Fp as connectMcp, C as constructLlmFromConfig, S as constructOpenLlmSync, Xg as copyText, Tu as createAgent, ff as createApprovalMiddleware, Qg as createChatContext, bD as createChatSdk, Cf as createCheckpointManager, wf as createCheckpointMiddleware, Nm as createConflictManager, Ap as createContextInspectorMiddleware, ig as createDataOps, mm as createHtmlFormatCheck, _m as createHtmlSubagent, gf as createHumanConfirmMiddleware, hf as createHumanConfirmTool, eh as createMemoryBackend, af as createMemoryMiddleware, y as createProxyLlm, yD as createRagSubagent, Hd as createSandboxRunner, lh as createSdkEvents, Bg as createSerialRunner, ih as createSessionStore, Ig as createSkillStore, op as createSubagentMiddleware, Wf as createSubagentTracker, lp as createSubagentsMiddleware, Ag as createUsageHintsMiddleware, up as createVerifyMiddleware, Hp as createVfs, nh as createWebStorageBackend, gp as createWriteBackCheck, _d as deepClone, Eg as defineDataToolset, Wd as defineSkill, vm as defineTool, gd as deleteByPath, Sm as deriveTitle, Hu as describeSchemaNode, fu as detectGarbledToolCall, hu as detectTransitionalReply, Ad as diffObjects, ug as domToStructure, fg as domTools, Tg as domToolsStatic, If as estimateMessageTokens, Lf as estimateRoundTokens, Wl as estimateTokens, T as extractReasoningDelta, td as extractSchemaHint, jp as extractText, w as extractTextDelta, E as extractUsage, og as fetchDocTools, wg as fetchTools, Yh as filterByToolMode, Uu as formatConstraints, Al as formatZodIssues, md as getByPath, dg as getDomTool, hg as getEnvSummary, ku as getSchemaAtPath, Eu as getSchemaTopKeys, ql as getTraceMetrics, Cd as hashValue, pm as htmlFragmentSkill, Xu as htmlOrchestratorPrompt, Rf as indexSummarize, vg as inspectEnvTool, yg as inspectTools, Cm as isChatModel, ru as isContextLengthError, Du as isPathAllowed, Km as isQuotaError, fd as isUnsafePath, wh as jpEval, Ml as jsonParseError, bd as limitDepth, Mx as markedToHtml, vd as maybeParseValue, Ed as moveByPath, x as normalizeBaseUrl, D as normalizeUsage, Kl as offloadPassThroughChars, Gl as offloadThresholdChars, Yu as presets, Iu as projectBySchema, Fu as projectBySchemaDeep, yd as projectFields, zf as recallRounds, Nx as renderMarkdownHtml, Wu as renderSchemaHint, Gu as renderSchemaOverview, Ju as renderSchemaShallow, ch as resolveCapabilities, fh as resolveContextOptions, oh as resolveDialogConfig, Mm as resolveLlm, Ul as resolveModelCaps, ah as resolveStorage, kd as restoreInPlace, Od as restoreLive, Nl as routeError, Ud as runHostScript, Oh as runSandboxedScript, pd as safeMerge, mg as safeSerialize, xd as safeStringify, Eh as searchJson, Dg as selectBuiltinTools, hd as setByPath, Bf as shouldTriggerCompression, b as stripStainlessFetch, Zu as systemPromptHelpers, Ff as tokenize, $ as toolError, Ou as unwrapSchema, Yg as useChat, $g as useChatContext, em as validateHtmlFormat, e as z, jl as zodError };

package/dist/page-agent-sdk.umd.cjs

@@ -308,4 +308,4 @@ app.mount('#app');
 
 `):`未检索到与「${e}」相关的内容。可换关键词或扩大 topK 重试。`}catch(e){return`检索出错:${e.message}。可换关键词重试。`}},{name:e,description:`语义检索知识库(组件文档/UI 规范/业务规则等),返回相关片段。需要查阅文档才能回答或配置时用;可多次调用不同关键词。`,schema:t.z.object({query:t.z.string().describe(`检索关键词或自然语言问题`),topK:t.z.number().int().positive().optional().describe(`期望召回数量(默认使用系统配置)`)})})}function hD(e,n){return(0,r.tool)(async({source:e})=>{try{let t=await n(e),r=Array.isArray(t)?t:[t];return r.length?r.map((e,t)=>`【${t+1}】${e.source?`来源:${e.source}\n`:``}${e.content}`).join(`
 
-`):`未加载到「${e}」。检查 source 是否正确。`}catch(e){return`加载出错:${e.message}。`}},{name:e,description:`按 source 加载指定文档(文档 id/URL/key);已知要查的具体文档用此工具精确加载。`,schema:t.z.object({source:t.z.string().describe(`文档标识(id/URL/key)`)})})}function gD(e){let{retriever:t,loader:n,useVfs:r=!0,id:i=`rag`,description:a,topK:o=5,searchToolName:s=`search_docs`,loadToolName:c=`load_doc`,maxToolRounds:l=8,summarization:u,skills:d,extraTools:f}=e;if(!t&&!n&&r===!1)throw Error(`[page-agent-sdk][createRagSubagent] 至少配一种知识源:retriever / loader / useVfs(true)`);let p=[];t&&p.push(mD(s,t,o)),n&&p.push(hD(c,n)),f&&p.push(...f);let m=r?[`vfs_grep`,`vfs_read`,`vfs_json_read`]:void 0;return{id:i,description:a??`检索知识库(组件文档/UI 规范/业务规则),返回有依据的结构化结论。需要查阅文档才能回答或决定如何配置时委派`,systemPrompt:dD,tools:p.length?p:void 0,allowedTools:m,skills:d??[pD],maxToolRounds:l,...u===void 0?{}:{summarization:u}}}function _D(e){return Wg(e,uD)}e.ApprovalBar=LS,e.CAPABILITIES=ih,e.CONTEXT_PRESETS=sh,e.ChatDialog=lD,e.ChatHeader=u_,e.ChatInput=oC,e.CodePreview=Wx,e.CompressDecisionSchema=vm,e.ConflictBar=JS,e.DEFAULT_SYSTEM_PROMPT=Np,e.DebugDrawer=GE,e.FocusBar=g_,e.HLJS_BLOCK_MAX_CHARS=Cx,e.HTML_VOID_TAGS=Yp,e.HUMAN_CONFIRM_TOOL_NAME=uf,e.MIN_CONTEXT_WINDOW=zl,e.MessageContent=Kx,e.MessageList=_S,e.MessageRow=lS,e.QueuedBar=TS,e.STOP_WORDS=jf,e.SkillPanel=cD,e.UNSAFE_KEYS=cd,e.actionsToInspectInfo=bg,e.actionsToTools=yg,e.agentError=Ml,e.analyzeContext=Ep,e.applyPatchToClone=xd,e.applyPatchToLive=wd,e.asAgentError=jl,e.buildDataPrompt=Pp,e.buildSystemPrompt=Fp,e.chatContextKey=Jg,e.commitSetToBind=qh,e.connectMcp=Mp,e.constructLlmFromConfig=b,e.constructOpenLlmSync=y,e.copyText=qg,e.createAgent=Su,e.createApprovalMiddleware=lf,e.createChatContext=Yg,e.createChatSdk=_D,e.createCheckpointManager=bf,e.createCheckpointMiddleware=xf,e.createConflictManager=Am,e.createContextInspectorMiddleware=Dp,e.createDataOps=tg,e.createHtmlFormatCheck=dm,e.createHtmlSubagent=mm,e.createHumanConfirmMiddleware=pf,e.createHumanConfirmTool=ff,e.createMemoryBackend=Zm,e.createMemoryMiddleware=tf,e.createProxyLlm=g,e.createRagSubagent=gD,e.createSandboxRunner=zd,e.createSdkEvents=oh,e.createSerialRunner=Lg,e.createSessionStore=th,e.createSkillStore=Ng,e.createSubagentMiddleware=rp,e.createSubagentTracker=Vf,e.createSubagentsMiddleware=op,e.createUsageHintsMiddleware=Dg,e.createVerifyMiddleware=sp,e.createVfs=zp,e.createWebStorageBackend=$m,e.createWriteBackCheck=pp,e.deepClone=md,e.defineDataToolset=Cg,e.defineSkill=Vd,e.defineTool=hm,e.deleteByPath=pd,e.deriveTitle=ym,e.describeSchemaNode=zu,e.detectGarbledToolCall=lu,e.diffObjects=Dd,e.domToStructure=sg,e.domTools=lg,e.domToolsStatic=Sg,e.estimateMessageTokens=Nf,e.estimateRoundTokens=Pf,e.estimateTokens=Vl,e.extractReasoningDelta=S,e.extractSchemaHint=Qu,e.extractText=Op,e.extractTextDelta=x,e.extractUsage=C,e.fetchDocTools=rg,e.fetchTools=xg,e.filterByToolMode=Kh,e.formatConstraints=Bu,e.formatZodIssues=Dl,e.getByPath=dd,e.getDomTool=cg,e.getEnvSummary=fg,e.getSchemaAtPath=Eu,e.getSchemaTopKeys=Cu,e.getTraceMetrics=Wl,e.hashValue=bd,e.htmlFragmentSkill=um,e.htmlOrchestratorPrompt=qu,e.indexSummarize=Ff,e.inspectEnvTool=hg,e.inspectTools=gg,e.isChatModel=bm,e.isContextLengthError=eu,e.isPathAllowed=wu,e.isQuotaError=Um,e.isUnsafePath=ld,e.jpEval=xh,e.jsonParseError=kl,e.limitDepth=_d,e.markedToHtml=kx,e.maybeParseValue=hd,e.moveByPath=Cd,e.normalizeBaseUrl=v,e.normalizeUsage=w,e.offloadPassThroughChars=Ul,e.offloadThresholdChars=Hl,e.presets=Ku,e.projectBySchema=Nu,e.projectBySchemaDeep=Mu,e.projectFields=gd,e.recallRounds=If,e.renderMarkdownHtml=Ax,e.renderSchemaHint=Vu,e.renderSchemaOverview=Hu,e.renderSchemaShallow=Gu,e.resolveCapabilities=ah,e.resolveContextOptions=lh,e.resolveDialogConfig=rh,e.resolveLlm=km,e.resolveModelCaps=Bl,e.resolveStorage=nh,e.restoreInPlace=Ed,e.restoreLive=Td,e.routeError=Al,e.runHostScript=Bd,e.runSandboxedScript=Th,e.safeMerge=ud,e.safeSerialize=dg,e.safeStringify=vd,e.searchJson=Ch,e.selectBuiltinTools=wg,e.setByPath=fd,e.shouldTriggerCompression=Lf,e.stripStainlessFetch=_,e.systemPromptHelpers=Ju,e.tokenize=Mf,e.toolError=$,e.unwrapSchema=Tu,e.useChat=Kg,e.useChatContext=Xg,e.validateHtmlFormat=Zp,Object.defineProperty(e,"z",{enumerable:!0,get:function(){return t.z}}),e.zodError=Ol});
+`):`未加载到「${e}」。检查 source 是否正确。`}catch(e){return`加载出错:${e.message}。`}},{name:e,description:`按 source 加载指定文档(文档 id/URL/key);已知要查的具体文档用此工具精确加载。`,schema:t.z.object({source:t.z.string().describe(`文档标识(id/URL/key)`)})})}function gD(e){let{retriever:t,loader:n,useVfs:r=!0,id:i=`rag`,description:a,topK:o=5,searchToolName:s=`search_docs`,loadToolName:c=`load_doc`,maxToolRounds:l=8,summarization:u,skills:d,extraTools:f}=e;if(!t&&!n&&r===!1)throw Error(`[page-agent-sdk][createRagSubagent] 至少配一种知识源:retriever / loader / useVfs(true)`);let p=[];t&&p.push(mD(s,t,o)),n&&p.push(hD(c,n)),f&&p.push(...f);let m=r?[`vfs_grep`,`vfs_read`,`vfs_json_read`]:void 0;return{id:i,description:a??`检索知识库(组件文档/UI 规范/业务规则),返回有依据的结构化结论。需要查阅文档才能回答或决定如何配置时委派`,systemPrompt:dD,tools:p.length?p:void 0,allowedTools:m,skills:d??[pD],maxToolRounds:l,...u===void 0?{}:{summarization:u}}}function _D(e){return Wg(e,uD)}e.ApprovalBar=LS,e.CAPABILITIES=ih,e.CONTEXT_PRESETS=sh,e.ChatDialog=lD,e.ChatHeader=u_,e.ChatInput=oC,e.CodePreview=Wx,e.CompressDecisionSchema=vm,e.ConflictBar=JS,e.DEFAULT_SYSTEM_PROMPT=Np,e.DebugDrawer=GE,e.FocusBar=g_,e.HLJS_BLOCK_MAX_CHARS=Cx,e.HTML_VOID_TAGS=Yp,e.HUMAN_CONFIRM_TOOL_NAME=uf,e.MIN_CONTEXT_WINDOW=zl,e.MessageContent=Kx,e.MessageList=_S,e.MessageRow=lS,e.QueuedBar=TS,e.STOP_WORDS=jf,e.SkillPanel=cD,e.UNSAFE_KEYS=cd,e.actionsToInspectInfo=bg,e.actionsToTools=yg,e.agentError=Ml,e.analyzeContext=Ep,e.applyPatchToClone=xd,e.applyPatchToLive=wd,e.asAgentError=jl,e.buildDataPrompt=Pp,e.buildSystemPrompt=Fp,e.chatContextKey=Jg,e.commitSetToBind=qh,e.connectMcp=Mp,e.constructLlmFromConfig=b,e.constructOpenLlmSync=y,e.copyText=qg,e.createAgent=Su,e.createApprovalMiddleware=lf,e.createChatContext=Yg,e.createChatSdk=_D,e.createCheckpointManager=bf,e.createCheckpointMiddleware=xf,e.createConflictManager=Am,e.createContextInspectorMiddleware=Dp,e.createDataOps=tg,e.createHtmlFormatCheck=dm,e.createHtmlSubagent=mm,e.createHumanConfirmMiddleware=pf,e.createHumanConfirmTool=ff,e.createMemoryBackend=Zm,e.createMemoryMiddleware=tf,e.createProxyLlm=g,e.createRagSubagent=gD,e.createSandboxRunner=zd,e.createSdkEvents=oh,e.createSerialRunner=Lg,e.createSessionStore=th,e.createSkillStore=Ng,e.createSubagentMiddleware=rp,e.createSubagentTracker=Vf,e.createSubagentsMiddleware=op,e.createUsageHintsMiddleware=Dg,e.createVerifyMiddleware=sp,e.createVfs=zp,e.createWebStorageBackend=$m,e.createWriteBackCheck=pp,e.deepClone=md,e.defineDataToolset=Cg,e.defineSkill=Vd,e.defineTool=hm,e.deleteByPath=pd,e.deriveTitle=ym,e.describeSchemaNode=zu,e.detectGarbledToolCall=lu,e.detectTransitionalReply=fu,e.diffObjects=Dd,e.domToStructure=sg,e.domTools=lg,e.domToolsStatic=Sg,e.estimateMessageTokens=Nf,e.estimateRoundTokens=Pf,e.estimateTokens=Vl,e.extractReasoningDelta=S,e.extractSchemaHint=Qu,e.extractText=Op,e.extractTextDelta=x,e.extractUsage=C,e.fetchDocTools=rg,e.fetchTools=xg,e.filterByToolMode=Kh,e.formatConstraints=Bu,e.formatZodIssues=Dl,e.getByPath=dd,e.getDomTool=cg,e.getEnvSummary=fg,e.getSchemaAtPath=Eu,e.getSchemaTopKeys=Cu,e.getTraceMetrics=Wl,e.hashValue=bd,e.htmlFragmentSkill=um,e.htmlOrchestratorPrompt=qu,e.indexSummarize=Ff,e.inspectEnvTool=hg,e.inspectTools=gg,e.isChatModel=bm,e.isContextLengthError=eu,e.isPathAllowed=wu,e.isQuotaError=Um,e.isUnsafePath=ld,e.jpEval=xh,e.jsonParseError=kl,e.limitDepth=_d,e.markedToHtml=kx,e.maybeParseValue=hd,e.moveByPath=Cd,e.normalizeBaseUrl=v,e.normalizeUsage=w,e.offloadPassThroughChars=Ul,e.offloadThresholdChars=Hl,e.presets=Ku,e.projectBySchema=Nu,e.projectBySchemaDeep=Mu,e.projectFields=gd,e.recallRounds=If,e.renderMarkdownHtml=Ax,e.renderSchemaHint=Vu,e.renderSchemaOverview=Hu,e.renderSchemaShallow=Gu,e.resolveCapabilities=ah,e.resolveContextOptions=lh,e.resolveDialogConfig=rh,e.resolveLlm=km,e.resolveModelCaps=Bl,e.resolveStorage=nh,e.restoreInPlace=Ed,e.restoreLive=Td,e.routeError=Al,e.runHostScript=Bd,e.runSandboxedScript=Th,e.safeMerge=ud,e.safeSerialize=dg,e.safeStringify=vd,e.searchJson=Ch,e.selectBuiltinTools=wg,e.setByPath=fd,e.shouldTriggerCompression=Lf,e.stripStainlessFetch=_,e.systemPromptHelpers=Ju,e.tokenize=Mf,e.toolError=$,e.unwrapSchema=Tu,e.useChat=Kg,e.useChatContext=Xg,e.validateHtmlFormat=Zp,Object.defineProperty(e,"z",{enumerable:!0,get:function(){return t.z}}),e.zodError=Ol});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "page-agent-sdk",
-  "version": "3.10.0",
+  "version": "3.10.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/index.d.ts

@@ -15,6 +15,10 @@ export interface ProxyLlmOptions {
   headers?: Record<string, string>;
 }
 export declare function createProxyLlm(opts: ProxyLlmOptions): import('@langchain/core/language_models/chat_models').BaseChatModel;
+/** 检测 garbled 工具调用文本(DeepSeek DSML/伪 XML 泄漏到正文) */
+export declare function detectGarbledToolCall(content: string): boolean;
+/** 检测过程性收口(短文本 + 过渡模式如「我先看看…稍后委派」+ 无完成动词)—— createAgent 据此有界回灌(≤2) */
+export declare function detectTransitionalReply(content: string): boolean;
 export interface ConstructOpts {
   temperature?: number;
   maxTokens?: number;