page-agent-sdk 3.18.0 → 3.19.1

package/dist/page-agent-sdk.js

@@ -113,7 +113,11 @@ async function C(e, t = {}) {
 		temperature: t.temperature ?? e.temperature,
 		maxTokens: t.maxTokens ?? e.maxTokens,
 		...e.baseUrl ? { anthropicApiUrl: x(e.baseUrl) } : {},
-		...e.extraConfig ? { clientOptions: e.extraConfig } : {}
+		...e.extraConfig ? { clientOptions: e.extraConfig } : {},
+		...e.cacheControl ? { invocationKwargs: { cache_control: {
+			type: "ephemeral",
+			...e.cacheControl === !0 ? {} : { ttl: e.cacheControl }
+		} } } : {}
 	});
 }
 //#endregion
@@ -154,10 +158,14 @@ function O(e) {
 	let t = E(e);
 	if (!t || typeof t != "object") return null;
 	let n = t, r = Number(n.prompt_tokens ?? n.promptTokens ?? n.input_tokens ?? n.inputTokens ?? 0) || 0, i = Number(n.completion_tokens ?? n.completionTokens ?? n.output_tokens ?? n.outputTokens ?? 0) || 0, a = Number(n.total_tokens ?? n.totalTokens ?? r + i) || 0;
-	return !r && !i && !a ? null : {
+	if (!r && !i && !a) return null;
+	let o = n.input_token_details, s = Number(n.cache_read_input_tokens ?? n.cacheReadInputTokens ?? o?.cache_read ?? 0) || 0, c = Number(n.cache_creation_input_tokens ?? n.cacheCreationInputTokens ?? o?.cache_creation ?? 0) || 0;
+	return {
 		prompt_tokens: r,
 		completion_tokens: i,
-		total_tokens: a
+		total_tokens: a,
+		...s ? { cache_read_input_tokens: s } : {},
+		...c ? { cache_creation_input_tokens: c } : {}
 	};
 }
 //#endregion
@@ -4997,15 +5005,18 @@ function ku(e) {
 			status: "error"
 		};
 		try {
-			let n = await t.invoke(e.args, e.callConfig ? { configurable: e.callConfig } : void 0), r = typeof n == "string" ? n : JSON.stringify(n);
-			return r = zl(r, {
+			let n = {
+				__pgDataScope: "",
+				...e.callConfig ?? {}
+			}, r = await t.invoke(e.args, { configurable: n }), i = typeof r == "string" ? r : JSON.stringify(r);
+			return i = zl(i, {
 				files: e.state.files,
 				vfsAvailable: ce.some((e) => e.name === "vfs_read"),
 				toolName: e.name,
 				threshold: ne,
 				passThroughChars: I
 			}).content, {
-				content: r,
+				content: i,
 				status: "done"
 			};
 		} catch (e) {
@@ -7295,12 +7306,12 @@ function up(e, t) {
 	return t.some((t) => e === t || e.startsWith(t + ".") || e.startsWith(t + "["));
 }
 function dp(e, t) {
-	let n = e.invoke.bind(e), r = async (e) => {
+	let n = e.invoke.bind(e), r = async (e, r) => {
 		if (Array.isArray(e?.patches) && e.patches.some((e) => !e || typeof e.jsonPath != "string" || !e.jsonPath)) return `PATH_OUT_OF_SCOPE:patches 含无 jsonPath 项(作用于根),子 agent 仅可写 ${t.join(", ")} 范围内子路径。请为每个 patch 指定 jsonPath。`;
-		let r = lp(e);
-		if (!r.length) return `PATH_OUT_OF_SCOPE:子 agent 仅可增量 patch(writablePaths: ${t.join(", ")}),不能整体替换(无 jsonPath)。用 write({patch:{jsonPath,...}}) 增量改。`;
-		for (let e of r) if (!up(e, t)) return `PATH_OUT_OF_SCOPE:子 agent 写 "${e}" 越界(仅可写 ${t.join(", ")})。`;
-		return n(e);
+		let i = lp(e);
+		if (!i.length) return `PATH_OUT_OF_SCOPE:子 agent 仅可增量 patch(writablePaths: ${t.join(", ")}),不能整体替换(无 jsonPath)。用 write({patch:{jsonPath,...}}) 增量改。`;
+		for (let e of i) if (!up(e, t)) return `PATH_OUT_OF_SCOPE:子 agent 写 "${e}" 越界(仅可写 ${t.join(", ")})。`;
+		return r === void 0 ? n(e) : n(e, r);
 	};
 	return new Proxy(e, { get(e, t, n) {
 		return t === "invoke" ? r : Reflect.get(e, t, n);
@@ -11049,7 +11060,7 @@ function Cg(e, n = {}) {
 			resourceStore: p.resourceStore
 		}));
 		let a = Dd(s);
-		return b(a, n), i === void 0 ? `主数据${r ? ` @ ${r}` : ""} = (undefined) (hash=${a})` : `主数据${r ? ` @ ${r}` : ""} = ${Td(i)} (hash=${a})`;
+		return b(a, n), i === void 0 ? `主数据${r ? ` @ ${r}` : ""} = (undefined) (hash=${a})` : (i = vg(i, n === "", C, S), `主数据${r ? ` @ ${r}` : ""} = ${Td(i)} (hash=${a})`);
 	}, {
 		name: "get_data",
 		description: "@deprecated(改用 read,等价且支持 fields/depth/分页)。读取主数据当前值(返回含 hash 供乐观锁);jsonPath 可选读子路径。大结果自动外存 vfs。",
@@ -11275,15 +11286,16 @@ function Cg(e, n = {}) {
 			jsonPath: t.string().optional().describe("只看快照的某子路径(相对主数据根);不传则整个快照"),
 			list: t.boolean().optional().describe("true 则列出快照时间线元信息(序号/操作/标签/时间/大小);不传则查看单条快照内容")
 		})
-	}), ne = r(async ({ expr: e, limit: t }) => {
+	}), ne = r(async ({ expr: e, limit: t }, n) => {
+		let r = v(n);
 		if (typeof s != "object" || !s) return $({
 			code: "NOT_OBJECT",
 			message: `主数据不是对象/数组,无法查询(当前为 ${s === void 0 ? "undefined" : typeof s})`,
 			hint: "query 仅适用于对象/数组;叶子用 get_data 读"
 		});
-		let n = l ? zu(s, o) : s, r;
+		let i = l ? zu(s, o) : s, a;
 		try {
-			r = Uh(n, e);
+			a = Uh(i, e);
 		} catch (t) {
 			return $({
 				code: "JSONPATH_SYNTAX",
@@ -11292,8 +11304,8 @@ function Cg(e, n = {}) {
 				details: { expr: e }
 			});
 		}
-		let i = t ?? 50, a = r.slice(0, i), c = a.map((e) => `{"path":${JSON.stringify(e.path)},"index":${e.index === void 0 ? "null" : e.index},"value":${Td(e.value)}}`);
-		return `{"matched":${r.length},"returned":${a.length},"truncated":${r.length > i},"results":[${c.join(",")}]}`;
+		let c = t ?? 50, u = a.slice(0, c), d = u.map((e) => `{"path":${JSON.stringify(e.path)},"index":${e.index === void 0 ? "null" : e.index},"value":${Td(vg(e.value, r === "", C, S))}}`);
+		return `{"matched":${a.length},"returned":${u.length},"truncated":${a.length > c},"results":[${d.join(",")}]}`;
 	}, {
 		name: "query_data",
 		description: "用 JSONPath 查询主数据(只读):$ 根/.key/[n]/[*]/[?(==/!=/</<=/>/>=,&&/||)]/..key 递归。返回匹配元素 path/index/value(path 可作 write patch 的 jsonPath);大数组筛选定位用它。",
@@ -11464,30 +11476,31 @@ function Cg(e, n = {}) {
 	A(L, (e) => e?.mode === "transform");
 	let re = r(async ({ jsonPath: e, jsonPaths: t, fields: r, depth: i, offset: a, limit: u }, d) => {
 		let f = v(d), m = Dd(s);
-		if (b(m, f), t && t.length) {
-			let e = t.map((e) => {
-				let t = e || "";
-				if (!ju(t, o, l)) return `- ${t || "(根)"}: [PATH_DENIED: 不在 schema 声明字段内]`;
-				let a = t ? vd(s, t) : s;
-				if (!t && l) a = zu(a, o);
+		if (t && t.length) {
+			let e = !1, a = t.map((t) => {
+				let a = t || "";
+				if (!ju(a, o, l)) return `- ${a || "(根)"}: [PATH_DENIED: 不在 schema 声明字段内]`;
+				e = !0;
+				let c = a ? vd(s, a) : s;
+				if (!a && l) c = zu(c, o);
 				else if (l) {
-					let e = Nu(o, t);
-					e && (a = zu(a, e));
+					let e = Nu(o, a);
+					e && (c = zu(c, e));
 				}
-				let c = a;
-				if (p && (c = ag({
-					jp: t,
-					resolved: c,
+				let u = c;
+				if (p && (u = ag({
+					jp: a,
+					resolved: u,
 					resourcesByPath: p.resourcesByPath,
 					resourceStore: p.resourceStore
 				})), n.interceptors?.read) try {
-					c = n.interceptors.read(c);
+					u = n.interceptors.read(u);
 				} catch (e) {
-					return `- ${t}: [READ_INTERCEPT: ${e.message}]`;
+					return `- ${a}: [READ_INTERCEPT: ${e.message}]`;
 				}
-				return r && r.length && (c = Cd(c, r)), i != null && (c = wd(c, i)), c = vg(c, f === "", C, S), c === void 0 ? `- ${t} = (undefined)` : `- ${t} = ${Td(c)}`;
+				return r && r.length && (u = Cd(u, r)), i != null && (u = wd(u, i)), u = vg(u, f === "", C, S), u === void 0 ? `- ${a} = (undefined)` : `- ${a} = ${Td(u)}`;
 			});
-			return `多路径读取(共 ${t.length} 项,hash=${m}):\n${e.join("\n")}`;
+			return e && b(m, f), `多路径读取(共 ${t.length} 项,hash=${m}):\n${a.join("\n")}`;
 		}
 		let h = e || "";
 		if (gd(h)) return $({
@@ -11520,7 +11533,7 @@ function Cg(e, n = {}) {
 				message: `read 拦截器抛错: ${e.message}`
 			});
 		}
-		r && r.length && (_ = Cd(_, r)), i != null && (_ = wd(_, i)), _ = vg(_, f === "", C, S);
+		b(m, f), r && r.length && (_ = Cd(_, r)), i != null && (_ = wd(_, i)), _ = vg(_, f === "", C, S);
 		let y = e ? "" : `主数据说明: ${c}\n格式: 写入值需为 JSON,且通过声明的 schema 校验(校验失败时 write 会返回结构化错误)。字段约束(类型/min/max/enum/必填/默认)见 systemPrompt「可操作数据」段,或用 schema_data({ jsonPath }) 按需查。\n\n`, x = r && r.length ? `(字段裁剪:${r.join(",")})` : "", w = i == null ? "" : `(深度≤${i})`, T = x || w ? ` ${x}${w}` : "";
 		if ((a !== void 0 || u !== void 0) && Array.isArray(_)) {
 			let e = _.length, t = Math.max(0, a ?? 0), n = Math.min(200, Math.max(1, u ?? 50)), r = _.slice(t, t + n), i = t + n < e;
@@ -12420,7 +12433,7 @@ function f_(e, n) {
 	e.debug && !l && console.warn("[page-agent-sdk][summarization] 未构造 llmInvoke(apiKey 缺失?),摘要回退零成本索引摘要");
 	let v = /* @__PURE__ */ ln([]), y = Xp(e.vfs?.initialFiles, {
 		persist: s ? { save: (e) => {
-			G.sessionId && s && s.save(n, G.sessionId, { vfs: e });
+			It({ vfs: e });
 		} } : void 0,
 		maxBytes: e.vfs?.maxBytes,
 		poolBytes: e.vfs?.poolBytes
@@ -12800,14 +12813,20 @@ function f_(e, n) {
 	}
 	let St = /* @__PURE__ */ Cn([]);
 	async function Ct() {
-		s && (St.value = (await s.listSessions(n)).sort((e, t) => t.lastAccessed - e.lastAccessed));
+		if (s) try {
+			St.value = (await s.listSessions(n)).sort((e, t) => t.lastAccessed - e.lastAccessed);
+		} catch (t) {
+			e.debug && console.warn("[page-agent-sdk][persist] refreshSessions 失败(已吞):", t);
+		}
 	}
 	let wt = a_(), Tt = /* @__PURE__ */ new Set();
 	function Et(e) {
-		let t = new AbortController();
-		return e && (e.aborted ? t.abort() : e.addEventListener("abort", () => t.abort(), { once: !0 })), Tt.add(t), {
+		let t = new AbortController(), n = () => t.abort();
+		return e && (e.aborted ? t.abort() : e.addEventListener("abort", n, { once: !0 })), Tt.add(t), {
 			controller: t,
-			untrack: () => Tt.delete(t)
+			untrack: () => {
+				Tt.delete(t), e?.removeEventListener("abort", n);
+			}
 		};
 	}
 	function Dt() {
@@ -12888,16 +12907,17 @@ function f_(e, n) {
 			};
 		},
 		afterRound() {
-			Mt(), Ft();
+			Mt(), Rt();
 		},
 		async send(e, t) {
-			await G.initDone, t ??= {}, t?.mission && je && x.setMission(t.mission);
+			if (await G.initDone, G.refCount <= 0) throw Error("page-agent-sdk: agent 已释放(unmount),拒绝排队中的 send");
+			t ??= {}, t?.mission && je && x.setMission(t.mission);
 			let n = e;
 			if (t.interceptors?.input) try {
 				let r = t.interceptors.input(e);
 				typeof r == "string" && (n = r);
 			} catch {}
-			let r = oe ? t.maxAutoRetries ?? 1 : 0, i = 0, a = !1, o = xt(t.signal);
+			let r = oe ? t.maxAutoRetries ?? 1 : 0, i = 0, a = !1, o = xt(t.signal), c = G.sessionId;
 			for (;;) {
 				a ||= (v.push({
 					role: "user",
@@ -12906,6 +12926,16 @@ function f_(e, n) {
 				}), !0);
 				try {
 					let e = await G.agent.invoke(v, t.signal, o);
+					if (t.signal?.aborted || G.sessionId !== c || G.refCount <= 0) return G.agent?.debugLogs?.value?.push({
+						timestamp: Date.now(),
+						type: "middleware",
+						data: {
+							stage: "orphan_round_dropped",
+							fromSession: c,
+							aborted: !!t.signal?.aborted,
+							sessionChanged: G.sessionId !== c
+						}
+					}), e;
 					if (t.interceptors?.output) try {
 						let n = t.interceptors.output(e);
 						typeof n == "string" && (e = n);
@@ -12943,6 +12973,7 @@ function f_(e, n) {
 		},
 		async batch(e, t, n) {
 			if (await G.initDone, !e.length) return [];
+			if (G.refCount <= 0) throw Error("page-agent-sdk: agent 已释放(unmount),拒绝排队中的 batch");
 			let r = [], i = xt(n);
 			for (let a = 0; a < e.length; a++) {
 				if (n?.aborted) {
@@ -13025,15 +13056,15 @@ function f_(e, n) {
 			if (a.resolve("keep_external"), G.sessionId && s) {
 				if (je) {
 					let e = x.getMission();
-					e && s.save(n, G.sessionId, { mission: e });
+					e && It({ mission: e });
 				}
 				if (Me) {
 					let e = T.getWorkingMemory();
-					e && s.save(n, G.sessionId, { workingMemory: e });
+					e && It({ workingMemory: e });
 				}
 				if (be) {
 					let e = w.getFocuses();
-					s.save(n, G.sessionId, { focus: e.length ? e : null });
+					It({ focus: e.length ? e : null });
 				}
 			}
 			y.flush?.(), await s.flush();
@@ -13042,10 +13073,12 @@ function f_(e, n) {
 				type: "session_restored",
 				sessionId: r,
 				rounds: i.messages?.length ?? 0
-			})), e.memory && s.save(n, G.sessionId, { memory: E.get() || (typeof e.memory == "string" ? e.memory : "") }), Ct(), Nt = void 0, Pt = !1, G.infoTick.value++, r;
+			})), e.memory && It({ memory: E.get() || (typeof e.memory == "string" ? e.memory : "") }), Ct(), Nt = void 0, Pt = !1, G.infoTick.value++, r;
 		},
 		resetSession: () => {
-			Dt(), a.resolve("keep_external"), G.sessionId = $m(), v.splice(0, v.length), y.clear?.(), b.reset([]), e.memory || E.reset(""), x.reset(), T.reset(), w.reset(), L && L.importStack([]), G.agent && (G.agent.debugLogs.value = []), s && s.createSession(G.agentId, e.session?.title, G.sessionId), st({
+			Dt(), a.resolve("keep_external"), G.sessionId = $m(), v.splice(0, v.length), y.clear?.(), b.reset([]), e.memory || E.reset(""), x.reset(), T.reset(), w.reset(), L && L.importStack([]), G.agent && (G.agent.debugLogs.value = []), s && s.createSession(G.agentId, e.session?.title, G.sessionId).catch((t) => {
+				e.debug && console.warn("[page-agent-sdk][persist] createSession 失败(已吞):", t);
+			}), st({
 				type: "session_restored",
 				sessionId: G.sessionId,
 				rounds: 0
@@ -13271,7 +13304,7 @@ function f_(e, n) {
 				}), e.debug && console.log("[page-agent-sdk][restore] 恢复会话", G.sessionId, `${t.messages?.length ?? 0} msgs`)) : e.debug && console.log("[page-agent-sdk][restore] 会话 meta 存在但快照为空", G.sessionId);
 			} else G.sessionId = await s.createSession(n, t.title), e.debug && console.log("[page-agent-sdk][restore] 新建会话(无历史)", G.sessionId);
 		} else G.sessionId = await s.createSession(n, t.title);
-		e.memory && s.save(n, G.sessionId, { memory: E.get() || (typeof e.memory == "string" ? e.memory : "") }), Ct();
+		e.memory && It({ memory: E.get() || (typeof e.memory == "string" ? e.memory : "") }), Ct();
 	}
 	async function kt() {
 		await mt();
@@ -13309,35 +13342,65 @@ function f_(e, n) {
 				try {
 					let e = await l(Uf(t, g)), i = v.indexOf(n);
 					if (i < 0) return;
-					v[i].content = Lf(t, r, e), Ft();
+					v[i].content = Lf(t, r, e), Rt();
 				} catch {}
 			})();
 		}
 	}
 	let Nt, Pt = !1;
-	function Ft() {
+	function Ft(t, n) {
+		e.debug && console.warn(`[page-agent-sdk][persist] ${t} 失败(已吞):`, n);
+		let r = G.agent?.debugLogs;
+		r && r.value.push({
+			timestamp: Date.now(),
+			type: "middleware",
+			data: {
+				stage: "persist_save_failed",
+				kind: t,
+				error: String(n).slice(0, 160)
+			}
+		});
+	}
+	function It(e) {
+		!G.sessionId || !s || s.save(n, G.sessionId, e).catch((e) => Ft("save", e));
+	}
+	function Lt(e, t) {
+		s && s.updateTitle(n, e, t).catch((e) => Ft("updateTitle", e));
+	}
+	function Rt() {
 		if (!G.sessionId || !s) return;
-		let t = JSON.parse(JSON.stringify(v));
-		s.save(n, G.sessionId, { messages: t });
-		let r = G.agent?.getState?.()?.todos ?? [];
-		if (s.save(n, G.sessionId, { todos: r }), je) {
+		if (It({ messages: JSON.parse(JSON.stringify(v)) }), It({ todos: G.agent?.getState?.()?.todos ?? [] }), je) {
 			let e = x.getMission();
-			e && s.save(n, G.sessionId, { mission: e });
+			e && It({ mission: e });
 		}
 		if (Me) {
 			let e = T.getWorkingMemory();
-			e && s.save(n, G.sessionId, { workingMemory: e });
+			e && It({ workingMemory: e });
 		}
 		if (be) {
 			let e = w.getFocuses();
-			s.save(n, G.sessionId, { focus: e.length ? e : null });
+			It({ focus: e.length ? e : null });
 		}
-		oe && L && (s.save(n, G.sessionId, { checkpoints: L.exportStack() }), s.save(n, G.sessionId, { usage: i }));
-		let a = Vm(v);
-		a && a !== Nt && (Nt = a, s.updateTitle(n, G.sessionId, a)), e.autoTitle !== !1 && u && !Pt && v.some((e) => e.role === "user") && v.some((e) => e.role === "assistant") && (Pt = !0, (async () => {
-			let e = await u(v);
-			e && (await s.updateTitle(n, G.sessionId, e), await Ct());
-		})()), e.debug && console.log("[page-agent-sdk][persist] save", G.sessionId, `${v.length} msgs`);
+		oe && L && (It({ checkpoints: L.exportStack() }), It({ usage: i }));
+		let t = Vm(v);
+		if (t && t !== Nt && (Nt = t, Lt(G.sessionId, t)), e.autoTitle !== !1 && u && !Pt && v.some((e) => e.role === "user") && v.some((e) => e.role === "assistant")) {
+			Pt = !0;
+			let e = G.sessionId;
+			(async () => {
+				try {
+					let t = await u(v);
+					if (t && G.refCount > 0 && G.sessionId === e) {
+						try {
+							await s.updateTitle(n, e, t);
+						} catch (e) {
+							Ft("updateTitle", e);
+						}
+						await Ct();
+					}
+				} catch {}
+			})();
+		}
+		e.debug && console.log("[page-agent-sdk][persist] save", G.sessionId, `${v.length} msgs`);
 	}
 	return G.initDone = (async () => {
 		await Ot(), await kt(), e.mcp?.length && (async () => {
@@ -15204,7 +15267,11 @@ var Yv = ["innerHTML"], Xv = {
 			has: (e) => s.has(`${l}:${e}`),
 			toggle: (e) => {
 				let t = `${l}:${e}`;
-				s.has(t) ? s.delete(t) : (s.clear(), s.add(t));
+				if (s.has(t)) s.delete(t);
+				else {
+					for (let e of Array.from(s)) e.startsWith(`${l}:`) && s.delete(e);
+					s.add(t);
+				}
 			}
 		};
 		function d(e) {
@@ -15312,7 +15379,7 @@ var Yv = ["innerHTML"], Xv = {
 			], 2))), 128))])) : Q("", !0)
 		], 2))), 128))])) : Q("", !0);
 	}
-}), [["__scopeId", "data-v-abae31a2"]]);
+}), [["__scopeId", "data-v-558ca64f"]]);
 //#endregion
 //#region node_modules/marked/lib/marked.esm.js
 function $y() {