page-agent-sdk 2.29.0 → 2.31.0

package/package.json

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

@@ -163,6 +163,7 @@ export interface SubagentConfig {
   skills?: SkillSpec[];
   temperature?: number;
   maxTokens?: number;
+  /** 子 agent 工具调用轮次上限(默认 10);大 JSON 子任务可调大 */
   maxToolRounds?: number;
   /** 子 agent 可写路径前缀白名单(给子 agent 写权限;写工具包 path guard,越界 PATH_OUT_OF_SCOPE;整体 set 禁)。subagent-writable Phase 2 */
   writablePaths?: string[];
@@ -476,6 +477,8 @@ export interface SessionSnapshot {
   mission?: Mission;
   /** 跨压缩工作记忆 path/hash 备忘(context-persist-resilience:刷新后少重复 read;capabilities.workingMemory 开启时写入) */
   workingMemory?: WorkingMemory;
+  /** 上下文聚焦焦点(focus-auto-switch:刷新/切会话后聚焦状态保留;capabilities.focus 开启时写入;null=清除标记) */
+  focus?: Focus | null;
 }
 export type StorageEvent =
   | { type: 'degraded'; reason: string }
@@ -588,6 +591,7 @@ export interface ChatSdkOptions {
   /** 内存中保留的对话轮数上限(默认 50);超限把最旧轮次压缩为摘要 system 消息(防 OOM);0 关闭 */
   maxMemoryRounds?: number;
   debug?: boolean;
+  /** agent 工具调用轮次上限(默认 10);大 JSON 分块构建(draft_write×N + draft_commit + read 确认)是多轮场景,可能触顶被截断,建议调大到 20-30 */
   maxToolRounds?: number;
   /** 规划阶段总轮次预算(默认 5);planning 状态下超限 → write_todos/update_todo 回灌,防"光规划不执行"死循环。与 maxIterations 正交 */
   maxPlanRevisions?: number;
@@ -1158,6 +1162,9 @@ export interface ContextManagerOptions { [k: string]: any }
 export interface CompressionStats { [k: string]: any }
 
 // 模型能力 / token 估算 / offload 阈值
+export declare const MIN_CONTEXT_WINDOW: number;
+/** 判定错误是否为上下文超限(模型输入超 contextWindow);复用 langchain ContextOverflowError + 兜底正则。harden-context-resilience */
+export declare function isContextLengthError(err: unknown): boolean;
 export declare function resolveModelCaps(model: string): any;
 export declare function estimateTokens(text: string): number;
 export declare function offloadThresholdChars(contextWindow: number): number;