@webskill/chatbot 0.0.1 → 0.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Chunhui Mo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -133,7 +133,7 @@ implementation (OPFS storage, skills, demo/model providers, console embedding).
   `CompositeUiBridge`, the i18n dictionary. Covered by semver from 0.1.0.
 - **`@experimental`** — A2UI/OpenUI/Vercel surface hosts and snapshot hosts,
   `VercelPayloadPreview`, `configureA2uiMarkdown`, the `probe*` availability
-  helpers, `RendererKind` (renamed in 0.3.0), and the `RunSnapshot` format.
+  helpers, `RendererKind` (renamed in 0.4.0), and the `RunSnapshot` format.
   These may change between 0.0.x releases.
 
 ## License

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { AgentLoopConfig, ApprovalScope, BridgeCapabilities, ExternalSkillProvider, ExternalToolSource, FileSystemProvider, InteractionRequest, InteractionResponse, LlmClient, NetworkPolicy, RenderBlock, RenderResultRequest, RunSnapshot, RunSnapshot as RunSnapshot$1, RuntimePhase, RuntimeRun, ScriptExecutor, TraceEvent, UiBridge, UiSurfaceActionRequest, UiSurfaceActionResponse, UiSurfaceDrafts, UiSurfaceEvent, UiSurfaceSnapshot } from "@webskill/sdk";
+import { AgentLoopConfig, ApprovalScope, BridgeCapabilities, ExternalSkillProvider, ExternalToolSource, FileSystemProvider, InteractionRequest, InteractionResponse, LlmClient, NetworkPolicy, RenderBlock, RenderResultRequest, RunSnapshot, RunSnapshot as RunSnapshot$1, RuntimePhase, ScriptExecutor, UiBridge, UiSurfaceActionRequest, UiSurfaceActionResponse, UiSurfaceDrafts, UiSurfaceEvent, UiSurfaceSnapshot } from "@webskill/sdk";
 import { SandboxMode } from "@webskill/sdk/browser";
 import { ReactBridgeState, SurfaceRegistry, UiSurfaceActionEvent } from "@webskill/sdk/ui-react";
 import "@webskill/sdk/ui";
@@ -452,23 +452,6 @@ declare class ChatEngine {
   resume(runId: string): Promise<void>;
 }
 //#endregion
-//#region src/core/traceSink.d.ts
-/**
- * run trace 落盘格式：与 console 包的共享约定（两包零依赖，console 的
- * createFsTraceSource(fs, chatRoot) 读同一位置），字段名不得擅自变更。
- */
-interface RunTraceFile {
-  runId: string;
-  sessionId: string;
-  startedAt: string;
-  endedAt?: string;
-  status: 'completed' | 'failed' | 'cancelled';
-  activeSkills: string[];
-  events: TraceEvent[];
-}
-/** 写 `<chatRoot>/traces/<runId>.json`；写失败降级 console.warn，不阻断对话 */
-declare function writeRunTrace(fs: FileSystemProvider, chatRoot: string, run: RuntimeRun): Promise<void>;
-//#endregion
 //#region src/i18n.d.ts
 /**
  * chatbot 双语字典：全部 UI 文案的单一来源（英文为主，zh 条目齐全）。
@@ -1229,4 +1212,4 @@ interface ErrorCardProps {
 /** 结构化错误卡：错误码徽章 + 描述 + 建议（engine error 事件 / 失败 run） */
 declare function ErrorCard({ code, message, onDismiss }: ErrorCardProps): import("react").JSX.Element;
 //#endregion
-export { A2uiSurfaceHost, type A2uiSurfaceHostProps, A2uiSurfaceSnapshotHost, type A2uiSurfaceSnapshotHostProps, type AppearanceChange, type ChatAttachmentInput, type ChatAttachmentMeta, ChatEngine, type ChatEngineOptions, type ChatEvent, type ChatLayout, type ChatMessage, type ChatSessionMeta, type ChatTheme, type ChatToolCall, Chatbot, type ChatbotConfig, type ChatbotHostAdapter, type ChatbotProps, CompositeUiBridge, type CompositeUiBridgeDeps, type DownloadableFile, ErrorCard, type ErrorCardProps, InteractionCard, type InteractionCardProps, InterruptedBanner, type InterruptedBannerProps, type LlmConfig, type Locale, OpenUiChannel, OpenUiInteraction, type OpenUiInteractionProps, type OpenUiSession, OpenUiSurfaceHost, type OpenUiSurfaceHostProps, OpenUiSurfaceSnapshotHost, type OpenUiSurfaceSnapshotHostProps, type RendererKind, type ResolvedChatLayout, ResultBlockList, type ResultBlockListProps, ResultBlocksPro, type ResultBlocksProProps, type RunSnapshot, type RunTraceFile, type SandboxExecutorDeps, SettingsDrawer, type SettingsDrawerProps, SkillBadges, VercelPayloadPreview, type VercelPayloadPreviewProps, VercelSurfaceHost, type VercelSurfaceHostProps, VercelSurfaceSnapshotHost, type VercelSurfaceSnapshotHostProps, chatbotDictionary, configureA2uiMarkdown, probeA2uiAvailability, probeOpenUiAvailability, useT, writeRunTrace };
+export { A2uiSurfaceHost, type A2uiSurfaceHostProps, A2uiSurfaceSnapshotHost, type A2uiSurfaceSnapshotHostProps, type AppearanceChange, type ChatAttachmentInput, type ChatAttachmentMeta, ChatEngine, type ChatEngineOptions, type ChatEvent, type ChatLayout, type ChatMessage, type ChatSessionMeta, type ChatTheme, type ChatToolCall, Chatbot, type ChatbotConfig, type ChatbotHostAdapter, type ChatbotProps, CompositeUiBridge, type CompositeUiBridgeDeps, type DownloadableFile, ErrorCard, type ErrorCardProps, InteractionCard, type InteractionCardProps, InterruptedBanner, type InterruptedBannerProps, type LlmConfig, type Locale, OpenUiChannel, OpenUiInteraction, type OpenUiInteractionProps, type OpenUiSession, OpenUiSurfaceHost, type OpenUiSurfaceHostProps, OpenUiSurfaceSnapshotHost, type OpenUiSurfaceSnapshotHostProps, type RendererKind, type ResolvedChatLayout, ResultBlockList, type ResultBlockListProps, ResultBlocksPro, type ResultBlocksProProps, type RunSnapshot, type SandboxExecutorDeps, SettingsDrawer, type SettingsDrawerProps, SkillBadges, VercelPayloadPreview, type VercelPayloadPreviewProps, VercelSurfaceHost, type VercelSurfaceHostProps, VercelSurfaceSnapshotHost, type VercelSurfaceSnapshotHostProps, chatbotDictionary, configureA2uiMarkdown, probeA2uiAvailability, probeOpenUiAvailability, useT };

package/dist/index.js

@@ -6,7 +6,7 @@ import { t as yaml } from "./yaml-C888tCbJ.js";
 import { t as json } from "./json-BOcU6nei.js";
 import { t as typescript } from "./typescript-DAau_Qyl.js";
 import { t as jsx$1 } from "./jsx-D2Jv0wvt.js";
-import { AnthropicClient, FsArtifactStore, FsMemoryStore, FsRunSnapshotStore, FullDisclosureRouter, GoogleGenAiClient, OpenAiCompatibleClient, SkillDiscovery, WebSkillError, WebSkillRuntime, messageOf } from "@webskill/sdk";
+import { AnthropicClient, FsArtifactStore, FsMemoryStore, FsRunSnapshotStore, FsRunTraceStore, FsSessionStore, FullDisclosureRouter, GoogleGenAiClient, OpenAiCompatibleClient, SkillDiscovery, WebSkillError, WebSkillRuntime, messageOf, summarizeToolCalls } from "@webskill/sdk";
 import { BrowserWorkerScriptExecutor } from "@webskill/sdk/browser";
 import { JsonRenderSpecSurface, NativeSpecSurface, OpenUiSpecSurface, ReactBridgeState, UiSurfaceList, UiSurfaceSnapshotList } from "@webskill/sdk/ui-react";
 import { A2UI_SPEC_FORM_PATH, LitRendererBridge, OPENUI_SURFACE_ACTION, VERCEL_SURFACE_ACTION_DATA_PART_TYPE, collectValues, createUiCatalogToolSource, fromA2uiSpecAction, fromA2uiSurfaceAction, fromOpenUiAction, fromOpenUiSurfaceAction, fromVercelSurfaceAction, interactionToFormModel, isUiSpecSurface, loadOpenUiPeers, loadWebSkillLitCatalog, renderMiniChart, shapeInteractionValue, toA2uiSpecMessages, toA2uiSurfaceAction, toA2uiSurfaceMessages, toOpenUiLang, toOpenUiSurfaceLang, toVercelSurfaceDataPart, toVercelToolInvocation, uiCatalog } from "@webskill/sdk/ui";
@@ -41024,31 +41024,11 @@ var CompositeUiBridge = class {
 	}
 };
 
-//#endregion
-//#region src/core/traceSink.ts
-/** 写 `<chatRoot>/traces/<runId>.json`；写失败降级 console.warn，不阻断对话 */
-async function writeRunTrace(fs, chatRoot, run) {
-	const trace = {
-		runId: run.id,
-		sessionId: run.sessionId,
-		startedAt: run.startedAt,
-		...run.endedAt ? { endedAt: run.endedAt } : {},
-		status: run.status === "completed" || run.status === "cancelled" ? run.status : "failed",
-		activeSkills: run.activeSkillNames,
-		events: run.trace
-	};
-	try {
-		await fs.writeText(`${chatRoot}/traces/${run.id}.json`, JSON.stringify(trace, null, 2));
-	} catch (e) {
-		console.warn(`Failed to persist run trace "${run.id}": ${messageOf(e)}`);
-	}
-}
-
 //#endregion
 //#region src/core/chatEngine.ts
 /** 注入模型的单个附件正文上限（超出截断并标注） */
 const ATTACHMENT_TEXT_LIMIT = 32 * 1024;
-/** 会话文件 → 列表元数据（旧会话文件无新字段时照常读） */
+/** sdk 的 `SessionMeta` → chatbot 的列表视图类型（跨层适配，非复刻） */
 const toSessionMeta = (session) => ({
 	id: session.id,
 	createdAt: session.createdAt,
@@ -41137,8 +41117,6 @@ var ChatEngine = class {
 	#listeners = /* @__PURE__ */ new Set();
 	/** runId → 已激活技能累积（skill-activated 事件用；终态清理） */
 	#runSkills = /* @__PURE__ */ new Map();
-	/** runId → callId → 已发出的工具事件种类（live 与 trace 重放去重；同 callId 同事件不重复发） */
-	#emittedToolEvents = /* @__PURE__ */ new Map();
 	/** 当前渲染框架档（复合 uiBridge 分发；setRenderer 热切换） */
 	#renderer;
 	/** a2ui 档交互容器（Chatbot ref 回调注入） */
@@ -41151,10 +41129,22 @@ var ChatEngine = class {
 	#maxHistoryMessages;
 	/** Serializes OPFS draft writes so a slower prior keystroke cannot overwrite a newer value. */
 	#surfaceDraftWrites = /* @__PURE__ */ new Map();
+	/** run trace 落盘（写失败降级 warn，不阻断对话） */
+	#traceStore;
+	/** 会话落盘：本包内引用 `FsSessionStore` 的唯一处 */
+	#sessions;
 	constructor(adapter, options = {}) {
 		this.#adapter = adapter;
 		this.#options = options;
 		this.#chatRoot = (options.chatRoot ?? "/chat").replace(/\/+$/, "");
+		this.#traceStore = new FsRunTraceStore({
+			root: `${this.#chatRoot}/traces`,
+			fs: adapter.storage
+		});
+		this.#sessions = new FsSessionStore({
+			root: `${this.#chatRoot}/sessions`,
+			fs: adapter.storage
+		});
 		this.#renderer = options.renderer ?? "native";
 		this.bridge = new ReactBridgeState({ onSurfaceDraftChange: (runId, surfaceId, value) => this.#persistSurfaceDraft(runId, surfaceId, value) });
 		const accumulate = this.bridge.onTextDelta.bind(this.bridge);
@@ -41218,28 +41208,10 @@ var ChatEngine = class {
 		this.reloadConfig();
 	}
 	async listSessions() {
-		const dir = `${this.#chatRoot}/sessions`;
-		if (!await this.#adapter.storage.exists(dir)) return [];
-		const entries = await this.#adapter.storage.list(dir);
-		const metas = [];
-		for (const entry of entries) {
-			if (entry.type !== "file" || !entry.path.endsWith(".json")) continue;
-			try {
-				const session = JSON.parse(await this.#adapter.storage.readText(entry.path));
-				metas.push(toSessionMeta(session));
-			} catch (e) {
-				console.warn(`Skipping corrupt session file "${entry.path}": ${messageOf(e)}`);
-			}
-		}
-		return metas.sort((a, b) => a.createdAt.localeCompare(b.createdAt));
+		return (await this.#sessions.list({ includeArchived: true })).map(toSessionMeta);
 	}
 	async createSession() {
-		const session = {
-			id: newId("session"),
-			createdAt: (/* @__PURE__ */ new Date()).toISOString(),
-			messages: []
-		};
-		await this.#writeSession(session);
+		const session = await this.#sessions.create({ id: newId("session") });
 		this.#currentSessionId = session.id;
 		return {
 			id: session.id,
@@ -41247,13 +41219,12 @@ var ChatEngine = class {
 		};
 	}
 	async selectSession(id) {
-		const session = await this.#readSession(id);
+		const session = await this.#requireSession(id);
 		this.#currentSessionId = id;
 		return session.messages;
 	}
 	async deleteSession(id) {
-		const path = this.#sessionPath(id);
-		if (await this.#adapter.storage.exists(path)) await this.#adapter.storage.remove(path);
+		await this.#sessions.delete(id);
 		const attachments = `${this.attachmentsRoot}/${id}`;
 		if (await this.#adapter.storage.exists(attachments)) await this.#adapter.storage.remove(attachments, { recursive: true });
 		this.#handles.delete(id);
@@ -41261,36 +41232,32 @@ var ChatEngine = class {
 	}
 	/** 重命名会话：写入 title 并锁定（后续 send 不再用首条消息覆盖） */
 	async renameSession(id, title) {
-		const session = await this.#readSession(id);
-		session.title = title;
-		session.titleLocked = true;
-		await this.#writeSession(session);
+		await this.#sessions.setTitle(id, title, { lock: true });
 		this.#emit({
 			type: "session-updated",
-			session: toSessionMeta(session)
+			session: toSessionMeta(await this.#requireSession(id))
 		});
 	}
 	/** 归档会话（仅标记，消息与 trace 不动） */
 	async archiveSession(id) {
-		await this.#setArchived(id, true);
+		await this.#sessions.setArchived(id, true);
+		this.#emit({
+			type: "session-updated",
+			session: toSessionMeta(await this.#requireSession(id))
+		});
 	}
 	/** 取消归档 */
 	async unarchiveSession(id) {
-		await this.#setArchived(id, false);
-	}
-	async #setArchived(id, archived) {
-		const session = await this.#readSession(id);
-		session.archived = archived;
-		await this.#writeSession(session);
+		await this.#sessions.setArchived(id, false);
 		this.#emit({
 			type: "session-updated",
-			session: toSessionMeta(session)
+			session: toSessionMeta(await this.#requireSession(id))
 		});
 	}
 	/** 重发语义：取该 user 消息文本重新 send（assistant 应答新起一轮；不重写历史） */
 	async retry(messageId) {
 		const sessionId = this.#currentSessionId;
-		const message = (sessionId ? await this.#readSession(sessionId) : void 0)?.messages.find((m) => m.id === messageId);
+		const message = (sessionId ? await this.#sessions.get(sessionId) : void 0)?.messages.find((m) => m.id === messageId);
 		if (!sessionId || !message || message.role !== "user") throw new WebSkillError("VALIDATION_FAILED", `Cannot retry message "${messageId}": no matching user message in the active session`);
 		await this.send(message.text);
 	}
@@ -41300,23 +41267,21 @@ var ChatEngine = class {
 	*/
 	async editAndResend(messageId, text) {
 		const sessionId = this.#currentSessionId;
-		const session = sessionId ? await this.#readSession(sessionId) : void 0;
+		const session = sessionId ? await this.#sessions.get(sessionId) : void 0;
 		const index = session?.messages.findIndex((m) => m.id === messageId) ?? -1;
 		const target = session && index >= 0 ? session.messages[index] : void 0;
-		if (!session || !target || target.role !== "user") throw new WebSkillError("VALIDATION_FAILED", `Cannot edit message "${messageId}": no matching user message in the active session`);
-		session.messages = session.messages.slice(0, index);
-		await this.#writeSession(session);
+		if (!sessionId || !session || !target || target.role !== "user") throw new WebSkillError("VALIDATION_FAILED", `Cannot edit message "${messageId}": no matching user message in the active session`);
+		await this.#sessions.replaceMessages(sessionId, session.messages.slice(0, index));
 		await this.send(text);
 	}
 	/** 从当前会话消息列表删除指定消息并持久化（消息不存在/无当前会话时静默跳过） */
 	async deleteMessage(messageId) {
 		const sessionId = this.#currentSessionId;
 		if (!sessionId) return;
-		const session = await this.#readSession(sessionId);
+		const session = await this.#requireSession(sessionId);
 		const next = session.messages.filter((m) => m.id !== messageId);
 		if (next.length === session.messages.length) return;
-		session.messages = next;
-		await this.#writeSession(session);
+		await this.#sessions.replaceMessages(sessionId, next);
 	}
 	/**
 	* 驱动当前 session 的一轮 run。同 session 并发由 runtime session handle 内部
@@ -41327,7 +41292,7 @@ var ChatEngine = class {
 		if (text.trim() === "" && attachments.length === 0) return;
 		const runtime = await this.#ensureReady();
 		const sessionId = this.#currentSessionId ?? (await this.createSession()).id;
-		const session = await this.#readSession(sessionId);
+		const session = await this.#requireSession(sessionId);
 		const prompt = await this.#withAttachments(text, attachments);
 		const userMessage = {
 			id: newId("msg"),
@@ -41339,9 +41304,8 @@ var ChatEngine = class {
 				kind: "text"
 			})) } : {}
 		};
-		session.messages.push(userMessage);
-		if (!session.title && !session.titleLocked) session.title = text.slice(0, 30);
-		await this.#writeSession(session);
+		await this.#sessions.appendMessages(sessionId, [userMessage]);
+		if (!session.title && !session.titleLocked) await this.#sessions.setTitle(sessionId, text.slice(0, 30));
 		this.#emit({
 			type: "message-complete",
 			message: userMessage
@@ -41349,7 +41313,7 @@ var ChatEngine = class {
 		const handle = this.#sessionHandle(runtime, sessionId);
 		try {
 			const result = await handle.run(prompt);
-			await this.#finishRun(session, result);
+			await this.#finishRun(sessionId, result);
 		} catch (e) {
 			this.#emitError(e);
 		}
@@ -41393,8 +41357,9 @@ var ChatEngine = class {
 				runId
 			});
 			const result = await runtime.resumeRun(runId);
-			const session = await this.#readSessionOrNew(result.run.sessionId);
-			await this.#finishRun(session, result);
+			const sessionId = result.run.sessionId;
+			if (!await this.#sessions.get(sessionId)) await this.#sessions.create({ id: sessionId });
+			await this.#finishRun(sessionId, result);
 		} catch (e) {
 			this.#emitError(e);
 		}
@@ -41557,33 +41522,30 @@ var ChatEngine = class {
 				const callId = data["callId"];
 				if (typeof name !== "string" || typeof callId !== "string") return;
 				const args = typeof data["args"] === "string" ? { args: data["args"] } : {};
-				if (status === "started") {
-					if (this.#markToolEvent(event.runId, callId, "started")) this.#emit({
-						type: "tool-started",
-						runId: event.runId,
-						callId,
-						name,
-						...args
-					});
-				} else if (status === "completed" || status === "failed") {
-					if (this.#markToolEvent(event.runId, callId, status)) this.#emit({
-						type: status === "completed" ? "tool-completed" : "tool-failed",
-						runId: event.runId,
-						callId,
-						name,
-						...args
-					});
-				}
+				if (status === "started") this.#emit({
+					type: "tool-started",
+					runId: event.runId,
+					callId,
+					name,
+					...args
+				});
+				else if (status === "completed" || status === "failed") this.#emit({
+					type: status === "completed" ? "tool-completed" : "tool-failed",
+					runId: event.runId,
+					callId,
+					name,
+					...args
+				});
 			} else if (event.phase === "complete" || event.phase === "fail") this.#runSkills.delete(event.runId);
 		});
 		this.#runtime = runtime;
 		return runtime;
 	}
-	/** run 终态公共路径（send / resume 共用）：工具事件重放 → 消息持久化 → trace 落盘 → 事件 */
-	async #finishRun(session, result) {
+	/** run 终态公共路径（send / resume 共用）：消息持久化 → trace 落盘 → 事件 */
+	async #finishRun(sessionId, result) {
 		const run = result.run;
 		const status = run.status === "completed" || run.status === "cancelled" ? run.status : "failed";
-		const toolCalls = this.#replayToolEvents(run);
+		const toolCalls = summarizeToolCalls(run);
 		const latest = this.bridge.latestResult;
 		const blocks = latest && latest.runId === run.id ? latest.blocks.filter((block) => block.type !== "markdown" || block.text.trim() !== result.output.trim()) : void 0;
 		const surfaces = this.bridge.surfaceSnapshots.filter((snapshot) => snapshot.runId === run.id);
@@ -41598,9 +41560,8 @@ var ChatEngine = class {
 			...surfaces.length > 0 ? { surfaces } : {},
 			...toolCalls.length > 0 ? { toolCalls } : {}
 		};
-		session.messages.push(assistantMessage);
-		await this.#writeSession(session);
-		await writeRunTrace(this.#adapter.storage, this.#chatRoot, run);
+		await this.#sessions.appendMessages(sessionId, [assistantMessage]);
+		await this.#traceStore.put(run);
 		this.#emit({
 			type: "run-completed",
 			runId: run.id,
@@ -41613,67 +41574,6 @@ var ChatEngine = class {
 			message: assistantMessage
 		});
 		this.#runSkills.delete(run.id);
-		this.#emittedToolEvents.delete(run.id);
-	}
-	/**
-	* 工具事件去重标记：live（runtime.events）与 trace 重放共用。
-	* 返回 true 表示该 (runId, callId, kind) 首次标记（应发出事件），false 表示已发过。
-	*/
-	#markToolEvent(runId, callId, kind) {
-		let byCallId = this.#emittedToolEvents.get(runId);
-		if (!byCallId) {
-			byCallId = /* @__PURE__ */ new Map();
-			this.#emittedToolEvents.set(runId, byCallId);
-		}
-		let kinds = byCallId.get(callId);
-		if (!kinds) {
-			kinds = /* @__PURE__ */ new Set();
-			byCallId.set(callId, kinds);
-		}
-		if (kinds.has(kind)) return false;
-		kinds.add(kind);
-		return true;
-	}
-	/**
-	* 工具事件 trace 重放（去重兜底）：live 已发出的 (callId, kind) 不重复发；
-	* 返回该 run 的工具调用终态序列（写入 assistant 消息，trace 为权威来源）。
-	*/
-	#replayToolEvents(run) {
-		const toolCalls = [];
-		for (const event of run.trace) {
-			if (event.type !== "tool.started" && event.type !== "tool.completed" && event.type !== "tool.failed") continue;
-			const name = event.data?.["name"];
-			const callId = event.data?.["callId"];
-			if (typeof name !== "string" || typeof callId !== "string") continue;
-			const args = typeof event.data?.["args"] === "string" ? { args: event.data["args"] } : {};
-			if (event.type === "tool.started") {
-				if (this.#markToolEvent(run.id, callId, "started")) this.#emit({
-					type: "tool-started",
-					runId: run.id,
-					callId,
-					name,
-					...args
-				});
-			} else {
-				const status = event.type === "tool.completed" ? "completed" : "failed";
-				const durationMs = typeof event.data?.["durationMs"] === "number" ? { durationMs: event.data["durationMs"] } : {};
-				if (this.#markToolEvent(run.id, callId, status)) this.#emit({
-					type: status === "completed" ? "tool-completed" : "tool-failed",
-					runId: run.id,
-					callId,
-					name,
-					...args
-				});
-				toolCalls.push({
-					callId,
-					name,
-					status,
-					...args,
-					...durationMs
-				});
-			}
-		}
-		return toolCalls;
 	}
 	#snapshotStore() {
 		return new FsRunSnapshotStore({
@@ -41693,26 +41593,10 @@ var ChatEngine = class {
 		}
 		return handle;
 	}
-	#sessionPath(id) {
-		return `${this.#chatRoot}/sessions/${id}.json`;
-	}
-	async #readSession(id) {
-		const path = this.#sessionPath(id);
-		if (!await this.#adapter.storage.exists(path)) throw new WebSkillError("FS_NOT_FOUND", `Chat session "${id}" not found at ${path}`);
-		return JSON.parse(await this.#adapter.storage.readText(path));
-	}
-	/** resume 用：会话文件被删除时用空会话兜底（恢复不因此失败） */
-	async #readSessionOrNew(id) {
-		const path = this.#sessionPath(id);
-		if (await this.#adapter.storage.exists(path)) return JSON.parse(await this.#adapter.storage.readText(path));
-		return {
-			id,
-			createdAt: (/* @__PURE__ */ new Date()).toISOString(),
-			messages: []
-		};
-	}
-	async #writeSession(session) {
-		await this.#adapter.storage.writeText(this.#sessionPath(session.id), JSON.stringify(session, null, 2));
+	async #requireSession(id) {
+		const session = await this.#sessions.get(id);
+		if (!session) throw new WebSkillError("FS_NOT_FOUND", `Chat session "${id}" not found under ${this.#chatRoot}/sessions`);
+		return session;
 	}
 };
 
@@ -55160,4 +55044,4 @@ function Chatbot({ adapter, config, locale: localeProp, theme: themeProp, render
 }
 
 //#endregion
-export { A2uiSurfaceHost, A2uiSurfaceSnapshotHost, ChatEngine, Chatbot, CompositeUiBridge, ErrorCard, InteractionCard, InterruptedBanner, OpenUiChannel, OpenUiInteraction, OpenUiSurfaceHost, OpenUiSurfaceSnapshotHost, ResultBlockList, ResultBlocksPro, SettingsDrawer, SkillBadges, VercelPayloadPreview, VercelSurfaceHost, VercelSurfaceSnapshotHost, chatbotDictionary, configureA2uiMarkdown, probeA2uiAvailability, probeOpenUiAvailability, useT, writeRunTrace };
+export { A2uiSurfaceHost, A2uiSurfaceSnapshotHost, ChatEngine, Chatbot, CompositeUiBridge, ErrorCard, InteractionCard, InterruptedBanner, OpenUiChannel, OpenUiInteraction, OpenUiSurfaceHost, OpenUiSurfaceSnapshotHost, ResultBlockList, ResultBlocksPro, SettingsDrawer, SkillBadges, VercelPayloadPreview, VercelSurfaceHost, VercelSurfaceSnapshotHost, chatbotDictionary, configureA2uiMarkdown, probeA2uiAvailability, probeOpenUiAvailability, useT };

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@webskill/chatbot",
-  "version": "0.0.1",
+  "version": "0.0.2",
+  "license": "MIT",
   "type": "module",
   "exports": {
     ".": {
@@ -25,7 +26,7 @@
     "@a2ui/web_core": "0.10.5",
     "@lit/context": "^1.1.0",
     "@openuidev/react-lang": "0.2.8",
-    "@webskill/sdk": "^0.2.8",
+    "@webskill/sdk": "^0.3.0",
     "react": ">=19.0.0",
     "react-dom": ">=19.0.0",
     "zod": "^3.25.0 || ^4.0.0"