@ai-gui/devtools 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Liang Li
+
+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

@@ -0,0 +1,21 @@
+# @ai-gui/devtools
+
+Framework-agnostic AIGUI runtime timeline and deterministic stream simulator.
+
+```ts
+import { Renderer, createActionRuntime, CardStore } from "@ai-gui/core"
+import { createDevTools, createStreamSimulator } from "@ai-gui/devtools"
+
+const renderer = new Renderer({ debug: true })
+const cards = new CardStore({ debug: true })
+const actions = createActionRuntime({ registry, cardStore: cards, debug: true })
+const devtools = createDevTools({ maxEvents: 500 })
+
+devtools.attach(renderer, actions, cards)
+devtools.subscribe(console.log)
+
+const simulator = createStreamSimulator(markdown, { chunkSize: 4, delayMs: 20 })
+await renderer.feed(simulator.stream)
+```
+
+`snapshot()` returns a bounded, globally ordered timeline. Core redacts credentials and text-level Bearer/query secrets before observers receive events and bounds payload construction. Debug may still contain application business data or form PII that cannot be recognized automatically, so use custom `redact` rules for those fields. Devtools also supports bounded event retention, `clear()`, and `destroy()`.

package/dist/index.cjs

@@ -0,0 +1,271 @@
+"use strict";
+
+//#region src/index.ts
+const DEFAULT_SENSITIVE_KEY_PARTS = [
+	"authorization",
+	"auth",
+	"accesstoken",
+	"refreshtoken",
+	"clientsecret",
+	"credentials",
+	"cookie",
+	"setcookie",
+	"proxyauthorization",
+	"password",
+	"passwd",
+	"apikey",
+	"secret",
+	"token"
+];
+function createDevTools(options = {}) {
+	const maxEvents = positiveInteger(options.maxEvents, 1e3, "maxEvents");
+	const maxStringLength = positiveInteger(options.maxStringLength, 4096, "maxStringLength");
+	const maxDepth = positiveInteger(options.maxDepth, 24, "maxDepth");
+	const maxNodes = positiveInteger(options.maxNodes, 2e4, "maxNodes");
+	const now = options.now ?? Date.now;
+	const timeline = [];
+	const listeners = new Set();
+	const detachments = new Set();
+	let sequence = 0;
+	let dropped = 0;
+	let destroyed = false;
+	const record = (event) => {
+		if (destroyed) return;
+		const entry = Object.freeze({
+			type: event.type,
+			source: event.source,
+			timestamp: now(),
+			sequence: ++sequence,
+			sourceSequence: event.sequence,
+			data: limitValue(event.data, {
+				maxStringLength,
+				maxDepth,
+				maxNodes,
+				redact: options.redact
+			})
+		});
+		timeline.push(entry);
+		if (timeline.length > maxEvents) {
+			dropped += timeline.length - maxEvents;
+			timeline.splice(0, timeline.length - maxEvents);
+		}
+		for (const listener of listeners) try {
+			listener(entry);
+		} catch {}
+	};
+	const api = {
+		attach(...targets) {
+			if (destroyed) throw new Error("DevTools has been destroyed");
+			const listener = (event) => record(event);
+			const current = [];
+			try {
+				for (const target of targets) current.push(target.subscribeDebug(listener));
+			} catch (error) {
+				for (const unsubscribe of current) unsubscribe();
+				throw error;
+			}
+			const detach = () => {
+				if (!detachments.delete(detach)) return;
+				for (const unsubscribe of current) unsubscribe();
+			};
+			detachments.add(detach);
+			return detach;
+		},
+		subscribe(listener) {
+			if (destroyed) return () => {};
+			listeners.add(listener);
+			return () => listeners.delete(listener);
+		},
+		snapshot() {
+			return timeline.map((event) => ({
+				...event,
+				data: cloneValue(event.data)
+			}));
+		},
+		clear() {
+			timeline.length = 0;
+			dropped = 0;
+		},
+		stats() {
+			return {
+				retained: timeline.length,
+				dropped
+			};
+		},
+		destroy() {
+			if (destroyed) return;
+			destroyed = true;
+			for (const detach of [...detachments]) detach();
+			listeners.clear();
+			timeline.length = 0;
+		}
+	};
+	return api;
+}
+function limitValue(value, options) {
+	const seen = new WeakSet();
+	let nodes = 0;
+	const visit = (input, key, path, depth) => {
+		nodes++;
+		if (nodes > options.maxNodes) return "[MAX_NODES]";
+		if (isSensitiveKey(key) || options.redact?.({
+			key,
+			path,
+			value: input
+		})) return "[REDACTED]";
+		if (typeof input === "string") {
+			const safe = redactText(input);
+			return safe.length > options.maxStringLength ? `${safe.slice(0, options.maxStringLength)}[TRUNCATED]` : safe;
+		}
+		if (input === null || typeof input === "number" || typeof input === "boolean") return input;
+		if (typeof input !== "object") return String(input);
+		if (depth >= options.maxDepth) return "[MAX_DEPTH]";
+		if (seen.has(input)) return "[CIRCULAR]";
+		seen.add(input);
+		try {
+			if (Array.isArray(input)) return input.map((item, index) => visit(item, "", [...path, index], depth + 1));
+			const output = {};
+			for (const [childKey, child] of Object.entries(input)) output[childKey] = visit(child, childKey, [...path, childKey], depth + 1);
+			return output;
+		} finally {
+			seen.delete(input);
+		}
+	};
+	return visit(value, "", [], 0);
+}
+function isSensitiveKey(key) {
+	const normalized = key.toLowerCase().replace(/[^a-z0-9]/g, "");
+	return normalized !== "" && DEFAULT_SENSITIVE_KEY_PARTS.some((part) => normalized.includes(part));
+}
+function redactText(value) {
+	return value.replace(/\bBearer\s+[^\s,;]+/gi, "Bearer [REDACTED]").replace(/([?&](?:access[_-]?token|refresh[_-]?token|client[_-]?secret|api[_-]?key|password|passwd|token|secret)=)[^&#\s]*/gi, "$1[REDACTED]").replace(/\b((?:access[_-]?token|refresh[_-]?token|client[_-]?secret|api[_-]?key|password|passwd|token|secret)\s*[:=]\s*)[^\s,;]+/gi, "$1[REDACTED]");
+}
+function cloneValue(value) {
+	if (Array.isArray(value)) return value.map(cloneValue);
+	if (value && typeof value === "object") return Object.fromEntries(Object.entries(value).map(([key, child]) => [key, cloneValue(child)]));
+	return value;
+}
+function positiveInteger(value, fallback, name) {
+	if (value === void 0) return fallback;
+	if (!Number.isSafeInteger(value) || value <= 0) throw new TypeError(`${name} must be a positive integer`);
+	return value;
+}
+const STREAM_FIXTURES = Object.freeze({
+	markdown: "# Streaming demo\n\nThis paragraph arrives in deterministic chunks.",
+	card: "```card:demo\n{\"id\":\"demo-card\",\"title\":\"Fixture card\",\"count\":1}\n```",
+	unicode: "UTF-8 boundaries: 你好, مرحبا, 🙂."
+});
+function createStreamSimulator(input, options = {}) {
+	const chunkSize = positiveInteger(options.chunkSize, 8, "chunkSize");
+	const delayMs = nonNegativeNumber(options.delayMs, 0, "delayMs");
+	const bytes = new TextEncoder().encode(input);
+	let currentState = "running";
+	let offset = 0;
+	let wake;
+	let timer;
+	let settleDelay;
+	let pending;
+	const waitUntilRunning = async () => {
+		while (currentState === "paused") await new Promise((resolve) => {
+			wake = resolve;
+		});
+	};
+	const finishWaits = () => {
+		if (timer !== void 0) clearTimeout(timer);
+		timer = void 0;
+		settleDelay?.();
+		settleDelay = void 0;
+		wake?.();
+		wake = void 0;
+	};
+	const waitDelay = () => new Promise((resolve) => {
+		if (delayMs === 0 || isCancelled()) return resolve();
+		settleDelay = resolve;
+		timer = setTimeout(() => {
+			timer = void 0;
+			settleDelay = void 0;
+			resolve();
+		}, delayMs);
+	});
+	const iterator = {
+		next() {
+			if (pending) return pending;
+			pending = (async () => {
+				await waitUntilRunning();
+				if (isCancelled()) return {
+					done: true,
+					value: void 0
+				};
+				await waitDelay();
+				if (isCancelled()) return {
+					done: true,
+					value: void 0
+				};
+				await waitUntilRunning();
+				if (isCancelled()) return {
+					done: true,
+					value: void 0
+				};
+				if (offset >= bytes.length) {
+					currentState = "completed";
+					return {
+						done: true,
+						value: void 0
+					};
+				}
+				const chunk = bytes.slice(offset, Math.min(offset + chunkSize, bytes.length));
+				offset += chunk.length;
+				return {
+					done: false,
+					value: chunk
+				};
+			})().finally(() => {
+				pending = void 0;
+			});
+			return pending;
+		},
+		async return() {
+			if (currentState !== "completed") currentState = "cancelled";
+			finishWaits();
+			await pending;
+			return {
+				done: true,
+				value: void 0
+			};
+		}
+	};
+	const stream = { [Symbol.asyncIterator]: () => iterator };
+	return {
+		stream,
+		pause() {
+			if (currentState === "running") currentState = "paused";
+		},
+		resume() {
+			if (currentState !== "paused") return;
+			currentState = "running";
+			wake?.();
+			wake = void 0;
+		},
+		cancel() {
+			if (currentState === "completed" || currentState === "cancelled") return;
+			currentState = "cancelled";
+			finishWaits();
+		},
+		state() {
+			return currentState;
+		}
+	};
+	function isCancelled() {
+		return currentState === "cancelled";
+	}
+}
+function nonNegativeNumber(value, fallback, name) {
+	if (value === void 0) return fallback;
+	if (!Number.isFinite(value) || value < 0) throw new TypeError(`${name} must be a non-negative number`);
+	return value;
+}
+
+//#endregion
+exports.STREAM_FIXTURES = STREAM_FIXTURES
+exports.createDevTools = createDevTools
+exports.createStreamSimulator = createStreamSimulator

package/dist/index.d.cts

@@ -0,0 +1,56 @@
+import { DebugEventTarget, DebugSource } from "@ai-gui/core";
+
+//#region src/index.d.ts
+interface TimelineEvent {
+  type: string;
+  source: DebugSource;
+  timestamp: number;
+  sequence: number;
+  sourceSequence: number;
+  data: Record<string, unknown>;
+}
+interface RedactContext {
+  key: string;
+  path: readonly (string | number)[];
+  value: unknown;
+}
+interface DevToolsOptions {
+  maxEvents?: number;
+  maxStringLength?: number;
+  maxDepth?: number;
+  maxNodes?: number;
+  redact?: (context: RedactContext) => boolean;
+  now?: () => number;
+}
+interface DevToolsStats {
+  retained: number;
+  dropped: number;
+}
+interface DevTools {
+  attach(...targets: DebugEventTarget[]): () => void;
+  subscribe(listener: (event: TimelineEvent) => void): () => void;
+  snapshot(): TimelineEvent[];
+  clear(): void;
+  stats(): DevToolsStats;
+  destroy(): void;
+}
+declare function createDevTools(options?: DevToolsOptions): DevTools;
+type StreamSimulatorState = "running" | "paused" | "completed" | "cancelled";
+interface StreamSimulatorOptions {
+  chunkSize?: number;
+  delayMs?: number;
+}
+interface StreamSimulator {
+  stream: AsyncIterable<Uint8Array>;
+  pause(): void;
+  resume(): void;
+  cancel(): void;
+  state(): StreamSimulatorState;
+}
+declare const STREAM_FIXTURES: Readonly<{
+  markdown: "# Streaming demo\n\nThis paragraph arrives in deterministic chunks.";
+  card: "```card:demo\n{\"id\":\"demo-card\",\"title\":\"Fixture card\",\"count\":1}\n```";
+  unicode: "UTF-8 boundaries: 你好, مرحبا, 🙂.";
+}>;
+declare function createStreamSimulator(input: string, options?: StreamSimulatorOptions): StreamSimulator; //#endregion
+export { DevTools, DevToolsOptions, DevToolsStats, RedactContext, STREAM_FIXTURES, StreamSimulator, StreamSimulatorOptions, StreamSimulatorState, TimelineEvent, createDevTools, createStreamSimulator };

package/dist/index.d.ts

@@ -0,0 +1,56 @@
+import { DebugEventTarget, DebugSource } from "@ai-gui/core";
+
+//#region src/index.d.ts
+interface TimelineEvent {
+  type: string;
+  source: DebugSource;
+  timestamp: number;
+  sequence: number;
+  sourceSequence: number;
+  data: Record<string, unknown>;
+}
+interface RedactContext {
+  key: string;
+  path: readonly (string | number)[];
+  value: unknown;
+}
+interface DevToolsOptions {
+  maxEvents?: number;
+  maxStringLength?: number;
+  maxDepth?: number;
+  maxNodes?: number;
+  redact?: (context: RedactContext) => boolean;
+  now?: () => number;
+}
+interface DevToolsStats {
+  retained: number;
+  dropped: number;
+}
+interface DevTools {
+  attach(...targets: DebugEventTarget[]): () => void;
+  subscribe(listener: (event: TimelineEvent) => void): () => void;
+  snapshot(): TimelineEvent[];
+  clear(): void;
+  stats(): DevToolsStats;
+  destroy(): void;
+}
+declare function createDevTools(options?: DevToolsOptions): DevTools;
+type StreamSimulatorState = "running" | "paused" | "completed" | "cancelled";
+interface StreamSimulatorOptions {
+  chunkSize?: number;
+  delayMs?: number;
+}
+interface StreamSimulator {
+  stream: AsyncIterable<Uint8Array>;
+  pause(): void;
+  resume(): void;
+  cancel(): void;
+  state(): StreamSimulatorState;
+}
+declare const STREAM_FIXTURES: Readonly<{
+  markdown: "# Streaming demo\n\nThis paragraph arrives in deterministic chunks.";
+  card: "```card:demo\n{\"id\":\"demo-card\",\"title\":\"Fixture card\",\"count\":1}\n```";
+  unicode: "UTF-8 boundaries: 你好, مرحبا, 🙂.";
+}>;
+declare function createStreamSimulator(input: string, options?: StreamSimulatorOptions): StreamSimulator; //#endregion
+export { DevTools, DevToolsOptions, DevToolsStats, RedactContext, STREAM_FIXTURES, StreamSimulator, StreamSimulatorOptions, StreamSimulatorState, TimelineEvent, createDevTools, createStreamSimulator };

package/dist/index.js

@@ -0,0 +1,267 @@
+//#region src/index.ts
+const DEFAULT_SENSITIVE_KEY_PARTS = [
+	"authorization",
+	"auth",
+	"accesstoken",
+	"refreshtoken",
+	"clientsecret",
+	"credentials",
+	"cookie",
+	"setcookie",
+	"proxyauthorization",
+	"password",
+	"passwd",
+	"apikey",
+	"secret",
+	"token"
+];
+function createDevTools(options = {}) {
+	const maxEvents = positiveInteger(options.maxEvents, 1e3, "maxEvents");
+	const maxStringLength = positiveInteger(options.maxStringLength, 4096, "maxStringLength");
+	const maxDepth = positiveInteger(options.maxDepth, 24, "maxDepth");
+	const maxNodes = positiveInteger(options.maxNodes, 2e4, "maxNodes");
+	const now = options.now ?? Date.now;
+	const timeline = [];
+	const listeners = new Set();
+	const detachments = new Set();
+	let sequence = 0;
+	let dropped = 0;
+	let destroyed = false;
+	const record = (event) => {
+		if (destroyed) return;
+		const entry = Object.freeze({
+			type: event.type,
+			source: event.source,
+			timestamp: now(),
+			sequence: ++sequence,
+			sourceSequence: event.sequence,
+			data: limitValue(event.data, {
+				maxStringLength,
+				maxDepth,
+				maxNodes,
+				redact: options.redact
+			})
+		});
+		timeline.push(entry);
+		if (timeline.length > maxEvents) {
+			dropped += timeline.length - maxEvents;
+			timeline.splice(0, timeline.length - maxEvents);
+		}
+		for (const listener of listeners) try {
+			listener(entry);
+		} catch {}
+	};
+	const api = {
+		attach(...targets) {
+			if (destroyed) throw new Error("DevTools has been destroyed");
+			const listener = (event) => record(event);
+			const current = [];
+			try {
+				for (const target of targets) current.push(target.subscribeDebug(listener));
+			} catch (error) {
+				for (const unsubscribe of current) unsubscribe();
+				throw error;
+			}
+			const detach = () => {
+				if (!detachments.delete(detach)) return;
+				for (const unsubscribe of current) unsubscribe();
+			};
+			detachments.add(detach);
+			return detach;
+		},
+		subscribe(listener) {
+			if (destroyed) return () => {};
+			listeners.add(listener);
+			return () => listeners.delete(listener);
+		},
+		snapshot() {
+			return timeline.map((event) => ({
+				...event,
+				data: cloneValue(event.data)
+			}));
+		},
+		clear() {
+			timeline.length = 0;
+			dropped = 0;
+		},
+		stats() {
+			return {
+				retained: timeline.length,
+				dropped
+			};
+		},
+		destroy() {
+			if (destroyed) return;
+			destroyed = true;
+			for (const detach of [...detachments]) detach();
+			listeners.clear();
+			timeline.length = 0;
+		}
+	};
+	return api;
+}
+function limitValue(value, options) {
+	const seen = new WeakSet();
+	let nodes = 0;
+	const visit = (input, key, path, depth) => {
+		nodes++;
+		if (nodes > options.maxNodes) return "[MAX_NODES]";
+		if (isSensitiveKey(key) || options.redact?.({
+			key,
+			path,
+			value: input
+		})) return "[REDACTED]";
+		if (typeof input === "string") {
+			const safe = redactText(input);
+			return safe.length > options.maxStringLength ? `${safe.slice(0, options.maxStringLength)}[TRUNCATED]` : safe;
+		}
+		if (input === null || typeof input === "number" || typeof input === "boolean") return input;
+		if (typeof input !== "object") return String(input);
+		if (depth >= options.maxDepth) return "[MAX_DEPTH]";
+		if (seen.has(input)) return "[CIRCULAR]";
+		seen.add(input);
+		try {
+			if (Array.isArray(input)) return input.map((item, index) => visit(item, "", [...path, index], depth + 1));
+			const output = {};
+			for (const [childKey, child] of Object.entries(input)) output[childKey] = visit(child, childKey, [...path, childKey], depth + 1);
+			return output;
+		} finally {
+			seen.delete(input);
+		}
+	};
+	return visit(value, "", [], 0);
+}
+function isSensitiveKey(key) {
+	const normalized = key.toLowerCase().replace(/[^a-z0-9]/g, "");
+	return normalized !== "" && DEFAULT_SENSITIVE_KEY_PARTS.some((part) => normalized.includes(part));
+}
+function redactText(value) {
+	return value.replace(/\bBearer\s+[^\s,;]+/gi, "Bearer [REDACTED]").replace(/([?&](?:access[_-]?token|refresh[_-]?token|client[_-]?secret|api[_-]?key|password|passwd|token|secret)=)[^&#\s]*/gi, "$1[REDACTED]").replace(/\b((?:access[_-]?token|refresh[_-]?token|client[_-]?secret|api[_-]?key|password|passwd|token|secret)\s*[:=]\s*)[^\s,;]+/gi, "$1[REDACTED]");
+}
+function cloneValue(value) {
+	if (Array.isArray(value)) return value.map(cloneValue);
+	if (value && typeof value === "object") return Object.fromEntries(Object.entries(value).map(([key, child]) => [key, cloneValue(child)]));
+	return value;
+}
+function positiveInteger(value, fallback, name) {
+	if (value === void 0) return fallback;
+	if (!Number.isSafeInteger(value) || value <= 0) throw new TypeError(`${name} must be a positive integer`);
+	return value;
+}
+const STREAM_FIXTURES = Object.freeze({
+	markdown: "# Streaming demo\n\nThis paragraph arrives in deterministic chunks.",
+	card: "```card:demo\n{\"id\":\"demo-card\",\"title\":\"Fixture card\",\"count\":1}\n```",
+	unicode: "UTF-8 boundaries: 你好, مرحبا, 🙂."
+});
+function createStreamSimulator(input, options = {}) {
+	const chunkSize = positiveInteger(options.chunkSize, 8, "chunkSize");
+	const delayMs = nonNegativeNumber(options.delayMs, 0, "delayMs");
+	const bytes = new TextEncoder().encode(input);
+	let currentState = "running";
+	let offset = 0;
+	let wake;
+	let timer;
+	let settleDelay;
+	let pending;
+	const waitUntilRunning = async () => {
+		while (currentState === "paused") await new Promise((resolve) => {
+			wake = resolve;
+		});
+	};
+	const finishWaits = () => {
+		if (timer !== void 0) clearTimeout(timer);
+		timer = void 0;
+		settleDelay?.();
+		settleDelay = void 0;
+		wake?.();
+		wake = void 0;
+	};
+	const waitDelay = () => new Promise((resolve) => {
+		if (delayMs === 0 || isCancelled()) return resolve();
+		settleDelay = resolve;
+		timer = setTimeout(() => {
+			timer = void 0;
+			settleDelay = void 0;
+			resolve();
+		}, delayMs);
+	});
+	const iterator = {
+		next() {
+			if (pending) return pending;
+			pending = (async () => {
+				await waitUntilRunning();
+				if (isCancelled()) return {
+					done: true,
+					value: void 0
+				};
+				await waitDelay();
+				if (isCancelled()) return {
+					done: true,
+					value: void 0
+				};
+				await waitUntilRunning();
+				if (isCancelled()) return {
+					done: true,
+					value: void 0
+				};
+				if (offset >= bytes.length) {
+					currentState = "completed";
+					return {
+						done: true,
+						value: void 0
+					};
+				}
+				const chunk = bytes.slice(offset, Math.min(offset + chunkSize, bytes.length));
+				offset += chunk.length;
+				return {
+					done: false,
+					value: chunk
+				};
+			})().finally(() => {
+				pending = void 0;
+			});
+			return pending;
+		},
+		async return() {
+			if (currentState !== "completed") currentState = "cancelled";
+			finishWaits();
+			await pending;
+			return {
+				done: true,
+				value: void 0
+			};
+		}
+	};
+	const stream = { [Symbol.asyncIterator]: () => iterator };
+	return {
+		stream,
+		pause() {
+			if (currentState === "running") currentState = "paused";
+		},
+		resume() {
+			if (currentState !== "paused") return;
+			currentState = "running";
+			wake?.();
+			wake = void 0;
+		},
+		cancel() {
+			if (currentState === "completed" || currentState === "cancelled") return;
+			currentState = "cancelled";
+			finishWaits();
+		},
+		state() {
+			return currentState;
+		}
+	};
+	function isCancelled() {
+		return currentState === "cancelled";
+	}
+}
+function nonNegativeNumber(value, fallback, name) {
+	if (value === void 0) return fallback;
+	if (!Number.isFinite(value) || value < 0) throw new TypeError(`${name} must be a non-negative number`);
+	return value;
+}
+
+//#endregion
+export { STREAM_FIXTURES, createDevTools, createStreamSimulator };

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@ai-gui/devtools",
+  "version": "0.3.0",
+  "description": "Framework-agnostic runtime timeline and stream simulator for AIGUI.",
+  "keywords": [
+    "aigui",
+    "devtools",
+    "timeline",
+    "debug",
+    "streaming"
+  ],
+  "license": "MIT",
+  "author": "Liang Li <ll_faw@hotmail.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/liliang-cn/aigui.git",
+    "directory": "packages/devtools"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@ai-gui/core": "0.3.0"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "test": "pnpm --dir ../.. exec vitest run --project devtools",
+    "typecheck": "tsc --noEmit"
+  }
+}