@ulearning/ai-generative-frame 0.0.0-stage → 1.0.0-next.0

package/dist/spec/actions.d.ts

@@ -0,0 +1,40 @@
+import type { Catalog } from "./catalog.js";
+import { type ExpressionContext } from "./expressions.js";
+import type { SpecStateStore } from "./state.js";
+import type { ActionBinding } from "./types.js";
+/** Where an action was dispatched from. */
+export type ActionSource = {
+    elementId?: string;
+    /** The event name, or the watched path for `watch`. */
+    trigger?: string;
+    /** Whether a component's event or a `watch` binding dispatched the action. */
+    kind?: "event" | "watch";
+};
+export type ActionHandler = (params: Record<string, unknown>, context: ActionSource & {
+    state: SpecStateStore;
+}) => unknown;
+export type ActionDispatcherOptions = {
+    store: SpecStateStore;
+    catalog?: Catalog;
+    /** Handlers by action name; they take precedence over `onAction`. */
+    handlers?: Record<string, ActionHandler>;
+    /** Called for catalog actions without a handler. */
+    onAction?: (name: string, params: Record<string, unknown>, context: ActionSource & {
+        state: SpecStateStore;
+    }) => unknown;
+    /** Reports actions that fail or are unknown instead of throwing. */
+    onError?: (error: Error, binding: ActionBinding) => void;
+};
+export type ActionDispatcher = (bindings: ActionBinding | readonly ActionBinding[] | undefined, context: Omit<ExpressionContext, "state" | "event"> & ActionSource & {
+    /** The payload the event carried, read by `{ $event }`. */
+    payload?: unknown;
+}) => Promise<unknown[]>;
+/**
+ * Creates the function elements use to run their bound actions: params are
+ * resolved against current state (and the event payload), `setState` writes
+ * the store, and every other action goes to a host handler. Actions in a list
+ * run in order, see state written by the ones before them, and stop at the
+ * first one that fails.
+ */
+export declare function createActionDispatcher(options: ActionDispatcherOptions): ActionDispatcher;
+//# sourceMappingURL=actions.d.ts.map

package/dist/spec/actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.d.ts","mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAW;AACxC,OAAO,EAAgB,KAAK,iBAAiB,EAAE,MAAM,kBAAe;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAS;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAS;AAE5C;AACA,MAAM,MAAM,YAAY,GAAG;IACzB,SAAS,CAAC,EAAE,MAAM;IAClB;IACA,OAAO,CAAC,EAAE,MAAM;IAChB;IACA,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO;CACzB;AAED,MAAM,MAAM,aAAa,GAAG,CAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,YAAY,GAAG;IAAE,KAAK,EAAE,cAAc;CAAE,KAC9C,OAAO;AAEZ,MAAM,MAAM,uBAAuB,GAAG;IACpC,KAAK,EAAE,cAAc;IACrB,OAAO,CAAC,EAAE,OAAO;IACjB;IACA,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC;IACxC;IACA,QAAQ,CAAC,EAAE,CACT,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,YAAY,GAAG;QAAE,KAAK,EAAE,cAAc;KAAE,KAC9C,OAAO;IACZ;IACA,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,aAAa,KAAK,IAAI;CACzD;AAED,MAAM,MAAM,gBAAgB,GAAG,CAC7B,QAAQ,EAAE,aAAa,GAAG,SAAS,aAAa,EAAE,GAAG,SAAS,EAC9D,OAAO,EAAE,IAAI,CAAC,iBAAiB,EAAE,OAAO,GAAG,OAAO,CAAC,GACjD,YAAY,GAAG;IACb;IACA,OAAO,CAAC,EAAE,OAAO;CAClB,KACA,OAAO,CAAC,OAAO,EAAE,CAAC;AAEvB;;;;;;;AAOA,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,uBAAuB,GAC/B,gBAAgB","names":[],"ignoreList":[],"sources":["../../src/spec/actions.ts"],"sourcesContent":[null]}

package/dist/spec/actions.js

@@ -0,0 +1,53 @@
+import { resolveValue } from "./expressions.js";
+// src/spec/actions.ts
+/**
+* Creates the function elements use to run their bound actions: params are
+* resolved against current state (and the event payload), `setState` writes
+* the store, and every other action goes to a host handler. Actions in a list
+* run in order, see state written by the ones before them, and stop at the
+* first one that fails.
+*/
+function createActionDispatcher(options) {
+	const report = (error, binding) => {
+		const normalized = error instanceof Error ? error : new Error(String(error));
+		if (options.onError) options.onError(normalized, binding);
+		else console.warn(`[generative-frame] action "${binding.action}" failed:`, normalized);
+	};
+	return async (bindings, context) => {
+		const list = bindings === void 0 ? [] : Array.isArray(bindings) ? bindings : [bindings];
+		const results = [];
+		for (const binding of list) {
+			const { payload, elementId, trigger, kind, ...scope } = context;
+			const params = resolveValue(binding.params ?? {}, {
+				...scope,
+				state: options.store.getState(),
+				event: payload
+			}) ?? {};
+			const source = {
+				...elementId !== void 0 ? { elementId } : {},
+				...trigger !== void 0 ? { trigger } : {},
+				...kind !== void 0 ? { kind } : {},
+				state: options.store
+			};
+			try {
+				const handler = options.handlers?.[binding.action];
+				if (handler) results.push(await handler(params, source));
+				else if (binding.action === "setState") {
+					if (typeof params["path"] !== "string") throw new Error("setState needs a string `path`");
+					options.store.set(params["path"], params["value"]);
+					results.push(void 0);
+				} else if (options.catalog && !options.catalog.action(binding.action)) throw new Error(`Unknown action "${binding.action}"`);
+				else if (options.onAction) results.push(await options.onAction(binding.action, params, source));
+				else throw new Error(`No handler for action "${binding.action}"`);
+			} catch (error) {
+				report(error, binding);
+				results.push(void 0);
+				break;
+			}
+		}
+		return results;
+	};
+}
+export { createActionDispatcher };
+
+//# sourceMappingURL=actions.js.map

package/dist/spec/actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.js","names":[],"sources":["../../src/spec/actions.ts"],"sourcesContent":["import type { Catalog } from \"./catalog\";\nimport { resolveValue, type ExpressionContext } from \"./expressions\";\nimport type { SpecStateStore } from \"./state\";\nimport type { ActionBinding } from \"./types\";\n\n/** Where an action was dispatched from. */\nexport type ActionSource = {\n  elementId?: string;\n  /** The event name, or the watched path for `watch`. */\n  trigger?: string;\n  /** Whether a component's event or a `watch` binding dispatched the action. */\n  kind?: \"event\" | \"watch\";\n};\n\nexport type ActionHandler = (\n  params: Record<string, unknown>,\n  context: ActionSource & { state: SpecStateStore },\n) => unknown;\n\nexport type ActionDispatcherOptions = {\n  store: SpecStateStore;\n  catalog?: Catalog;\n  /** Handlers by action name; they take precedence over `onAction`. */\n  handlers?: Record<string, ActionHandler>;\n  /** Called for catalog actions without a handler. */\n  onAction?: (\n    name: string,\n    params: Record<string, unknown>,\n    context: ActionSource & { state: SpecStateStore },\n  ) => unknown;\n  /** Reports actions that fail or are unknown instead of throwing. */\n  onError?: (error: Error, binding: ActionBinding) => void;\n};\n\nexport type ActionDispatcher = (\n  bindings: ActionBinding | readonly ActionBinding[] | undefined,\n  context: Omit<ExpressionContext, \"state\" | \"event\"> &\n    ActionSource & {\n      /** The payload the event carried, read by `{ $event }`. */\n      payload?: unknown;\n    },\n) => Promise<unknown[]>;\n\n/**\n * Creates the function elements use to run their bound actions: params are\n * resolved against current state (and the event payload), `setState` writes\n * the store, and every other action goes to a host handler. Actions in a list\n * run in order, see state written by the ones before them, and stop at the\n * first one that fails.\n */\nexport function createActionDispatcher(\n  options: ActionDispatcherOptions,\n): ActionDispatcher {\n  const report = (error: unknown, binding: ActionBinding) => {\n    const normalized =\n      error instanceof Error ? error : new Error(String(error));\n    if (options.onError) options.onError(normalized, binding);\n    else\n      console.warn(\n        `[generative-frame] action \"${binding.action}\" failed:`,\n        normalized,\n      );\n  };\n\n  return async (bindings, context) => {\n    const list =\n      bindings === undefined\n        ? []\n        : Array.isArray(bindings)\n          ? bindings\n          : [bindings];\n    const results: unknown[] = [];\n    for (const binding of list as ActionBinding[]) {\n      const { payload, elementId, trigger, kind, ...scope } = context;\n      const params = (resolveValue(binding.params ?? {}, {\n        ...scope,\n        state: options.store.getState(),\n        event: payload,\n      }) ?? {}) as Record<string, unknown>;\n      const source = {\n        ...(elementId !== undefined ? { elementId } : {}),\n        ...(trigger !== undefined ? { trigger } : {}),\n        ...(kind !== undefined ? { kind } : {}),\n        state: options.store,\n      };\n      try {\n        const handler = options.handlers?.[binding.action];\n        if (handler) {\n          results.push(await handler(params, source));\n        } else if (binding.action === \"setState\") {\n          if (typeof params[\"path\"] !== \"string\") {\n            throw new Error(\"setState needs a string `path`\");\n          }\n          options.store.set(params[\"path\"], params[\"value\"]);\n          results.push(undefined);\n        } else if (options.catalog && !options.catalog.action(binding.action)) {\n          throw new Error(`Unknown action \"${binding.action}\"`);\n        } else if (options.onAction) {\n          results.push(await options.onAction(binding.action, params, source));\n        } else {\n          throw new Error(`No handler for action \"${binding.action}\"`);\n        }\n      } catch (error) {\n        report(error, binding);\n        results.push(undefined);\n        break;\n      }\n    }\n    return results;\n  };\n}\n"],"mappings":";;;;;;;;;AAkDA,SAAgB,uBACd,SACkB;CAClB,MAAM,UAAU,OAAgB,YAA2B;EACzD,MAAM,aACJ,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,KAAK,CAAC;EAC1D,IAAI,QAAQ,SAAS,QAAQ,QAAQ,YAAY,OAAO;OAEtD,QAAQ,KACN,8BAA8B,QAAQ,OAAO,YAC7C,UACF;CACJ;CAEA,OAAO,OAAO,UAAU,YAAY;EAClC,MAAM,OACJ,aAAa,KAAA,IACT,CAAC,IACD,MAAM,QAAQ,QAAQ,IACpB,WACA,CAAC,QAAQ;EACjB,MAAM,UAAqB,CAAC;EAC5B,KAAK,MAAM,WAAW,MAAyB;GAC7C,MAAM,EAAE,SAAS,WAAW,SAAS,MAAM,GAAG,UAAU;GACxD,MAAM,SAAU,aAAa,QAAQ,UAAU,CAAC,GAAG;IACjD,GAAG;IACH,OAAO,QAAQ,MAAM,SAAS;IAC9B,OAAO;GACT,CAAC,KAAK,CAAC;GACP,MAAM,SAAS;IACb,GAAI,cAAc,KAAA,IAAY,EAAE,UAAU,IAAI,CAAC;IAC/C,GAAI,YAAY,KAAA,IAAY,EAAE,QAAQ,IAAI,CAAC;IAC3C,GAAI,SAAS,KAAA,IAAY,EAAE,KAAK,IAAI,CAAC;IACrC,OAAO,QAAQ;GACjB;GACA,IAAI;IACF,MAAM,UAAU,QAAQ,WAAW,QAAQ;IAC3C,IAAI,SACF,QAAQ,KAAK,MAAM,QAAQ,QAAQ,MAAM,CAAC;SACrC,IAAI,QAAQ,WAAW,YAAY;KACxC,IAAI,OAAO,OAAO,YAAY,UAC5B,MAAM,IAAI,MAAM,gCAAgC;KAElD,QAAQ,MAAM,IAAI,OAAO,SAAS,OAAO,QAAQ;KACjD,QAAQ,KAAK,KAAA,CAAS;IACxB,OAAO,IAAI,QAAQ,WAAW,CAAC,QAAQ,QAAQ,OAAO,QAAQ,MAAM,GAClE,MAAM,IAAI,MAAM,mBAAmB,QAAQ,OAAO,EAAE;SAC/C,IAAI,QAAQ,UACjB,QAAQ,KAAK,MAAM,QAAQ,SAAS,QAAQ,QAAQ,QAAQ,MAAM,CAAC;SAEnE,MAAM,IAAI,MAAM,0BAA0B,QAAQ,OAAO,EAAE;GAE/D,SAAS,OAAO;IACd,OAAO,OAAO,OAAO;IACrB,QAAQ,KAAK,KAAA,CAAS;IACtB;GACF;EACF;EACA,OAAO;CACT;AACF"}

package/dist/spec/assistant-ui/thread.d.ts

@@ -0,0 +1,66 @@
+import { type MessageLike } from "../../assistant-ui/tool-calls.js";
+import type { ActionHandler } from "../actions.js";
+import type { Catalog } from "../catalog.js";
+import type { SpecPromptOptions } from "../prompt.js";
+import { type RenderSpecInput } from "../render-spec.js";
+import type { SpecStateWrite } from "../state.js";
+import type { Spec } from "../types.js";
+/** The arguments of a `render_spec` call, which stream in. */
+export type SpecArgs = Partial<RenderSpecInput>;
+/** The interactions a host records on a tool call, as its `unstable_interactions` prop holds them. */
+export type InteractionLog = {
+    readonly entries: readonly ({
+        readonly type: "action";
+        readonly payload: Readonly<Record<string, unknown>>;
+    } | {
+        readonly type: "human-response";
+        readonly payload: unknown;
+    })[];
+};
+/**
+ * The state writes saved on a `render_spec` call: the newest `setState` interaction recorded for that call. An entry whose `writes` is not a list marks a save that failed, so the call starts from the model's state rather than from an older snapshot.
+ */
+export declare function savedWrites(log: InteractionLog | undefined, toolCallId: string): SpecStateWrite[];
+/** Results of the tool calls before this one, by tool name and newest first, leaving out the widget toolkit's own tools. Tool names are keys every model can see, unlike call ids, which some formats never show, and counting back from this call keeps an index stable when a host prunes older history. */
+export declare function resolveToolResults(messages: readonly MessageLike[], toolCallId: string): Record<string, unknown[]>;
+/** A `spec` argument as the renderers read it, with `elements` an object even while the argument is still streaming in. */
+export declare const specFromArgs: (spec: object) => Spec;
+/**
+ * The spec a `render_spec` call's patches apply onto: the result of the
+ * earlier `render_spec` calls with the same title in the thread.
+ */
+export declare function resolveSpecBase(messages: readonly MessageLike[], toolCallId: string, title: string): Spec | undefined;
+/** Whether a later `render_spec` call in the same message has this call's title. That call shows the spec this one's patches lead to, so this one shows nothing rather than a second copy. */
+export declare function supersededInMessage(messages: readonly MessageLike[], toolCallId: string, title: string): boolean;
+type SpecHistory = {
+    base(title: string): {
+        spec: Spec | undefined;
+        version: number;
+    };
+    toolResults: Record<string, unknown[]> | undefined;
+};
+/** What a mounted call registers for `execute`: the spec each title held before it in its own thread, how many calls built it, and the earlier results it mounts under `/tools`. */
+export declare const callHistory: (messages: readonly MessageLike[], toolCallId: string, toolResults: Record<string, unknown[]> | undefined) => SpecHistory;
+/**
+ * The `render_spec` tool a toolkit shares across its calls. Each mounted call
+ * registers its {@link callHistory} in `histories` under its tool call id, so
+ * `execute` patches the base that call's own thread held, even after a reload
+ * or in another thread.
+ */
+export declare function createSpecCalls(catalog: Catalog, specPrompt: Omit<SpecPromptOptions, "mode"> | undefined): {
+    tools: import("../render-spec.js").SpecTools;
+    histories: Map<string, SpecHistory>;
+    execute: (input: RenderSpecInput, call: {
+        toolCallId: string;
+    }) => Promise<import("../render-spec.js").RenderSpecResult>;
+};
+/** The `spec` module of `read_me`: the catalog guidance with the built-in actions every assistant-ui toolkit handles, the app's rules, and where earlier tool results are. */
+export declare const specModules: (catalog: Catalog, specPrompt: Omit<SpecPromptOptions, "mode"> | undefined, host: {
+    clipboard: boolean;
+}) => import("../tools.js").GuidanceModule[];
+/** Writes to the browser's clipboard, rejecting where the Clipboard API is missing. */
+export declare const writeClipboard: (text: string) => Promise<void>;
+/** The built-in `copyText` handler. A copy that does not happen fails, so the rest of the list, such as a confirmation, does not run. */
+export declare const copyTextHandler: (write: (text: string) => Promise<void>) => ActionHandler;
+export {};
+//# sourceMappingURL=thread.d.ts.map

package/dist/spec/assistant-ui/thread.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread.d.ts","mappings":"AAAA,OAAO,EAGL,KAAK,WAAW,EACjB,MAAM,kCAA+B;AACtC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAY;AAC/C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAY;AAIzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAW;AAClD,OAAO,EAIL,KAAK,eAAe,EACrB,MAAM,mBAAgB;AACvB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAU;AAG9C,OAAO,KAAK,EAAE,IAAI,EAAe,MAAM,aAAU;AAGjD;AACA,MAAM,MAAM,QAAQ,GAAG,OAAO,CAAC,eAAe,CAAC;AAE/C;AACA,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,OAAO,EAAE,SAAS,CACvB;QACE,QAAQ,CAAC,IAAI,EAAE,QAAQ;QACvB,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpD,GACD;QAAE,QAAQ,CAAC,IAAI,EAAE,gBAAgB;QAAE,QAAQ,CAAC,OAAO,EAAE,OAAO;KAAE,CACjE,EAAE;CACJ;AAED;;;AAGA,wBAAgB,WAAW,CACzB,GAAG,EAAE,cAAc,GAAG,SAAS,EAC/B,UAAU,EAAE,MAAM,GACjB,cAAc,EAAE;AAmCnB;AACA,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,SAAS,WAAW,EAAE,EAChC,UAAU,EAAE,MAAM,GACjB,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;AAqB5B;AACA,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,KAAG,IAK3C;AAED;;;;AAIA,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,SAAS,WAAW,EAAE,EAChC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,GACZ,IAAI,GAAG,SAAS;AAiBnB;AACA,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,SAAS,WAAW,EAAE,EAChC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,GACZ,OAAO;AAsBV,KAAK,WAAW,GAAG;IACjB,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,IAAI,GAAG,SAAS;QAAE,OAAO,EAAE,MAAM;KAAE;IAChE,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,SAAS;CACnD;AAED;AACA,eAAO,MAAM,WAAW,GACtB,UAAU,SAAS,WAAW,EAAE,EAChC,YAAY,MAAM,EAClB,aAAa,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,SAAS,KACjD,WAMD;AA0HF;;;;;;AAMA,wBAAgB,eAAe,CAC7B,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,IAAI,CAAC,iBAAiB,EAAE,MAAM,CAAC,GAAG,SAAS;;;qBAS9C,eAAe,QAChB;QAAE,UAAU,EAAE,MAAM;KAAE;;AAuBhC;AACA,eAAO,MAAM,WAAW,GACtB,SAAS,OAAO,EAChB,YAAY,IAAI,CAAC,iBAAiB,EAAE,MAAM,CAAC,GAAG,SAAS,EACvD,MAAM;IAAE,SAAS,EAAE,OAAO;CAAE,2CAY7B;AAED;AACA,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,KAAG,OAAO,CAAC,IAAI,CAGK;AAE/D;AACA,eAAO,MAAM,eAAe,GACzB,OAAO,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,KAAG,aAYzC","names":[],"ignoreList":[],"sources":["../../../src/spec/assistant-ui/thread.ts"],"sourcesContent":[null]}

package/dist/spec/assistant-ui/thread.js

@@ -0,0 +1,252 @@
+import { hasLaterToolCallInMessage, toolCalls } from "../../assistant-ui/tool-calls.js";
+import { escapePointerToken, getAtPointer } from "../pointer.js";
+import { formulaValueReads } from "../calc.js";
+import { conditionGuards, templateStatePaths } from "../expressions.js";
+import { parseSpecStream } from "../stream.js";
+import { formatSpecIssues } from "../validate.js";
+import { childIdsOf, safePointer } from "../tree.js";
+import { SPEC_TOOL_RESULTS_RULE, createSpecTools, specGuidanceModule } from "../render-spec.js";
+// src/spec/assistant-ui/thread.ts
+/**
+* The state writes saved on a `render_spec` call: the newest `setState` interaction recorded for that call. An entry whose `writes` is not a list marks a save that failed, so the call starts from the model's state rather than from an older snapshot.
+*/
+function savedWrites(log, toolCallId) {
+	const entries = log?.entries ?? [];
+	for (let index = entries.length - 1; index >= 0; index--) {
+		const entry = entries[index];
+		if (entry.type !== "action" || entry.payload["type"] !== "setState" || entry.payload["toolCallId"] !== toolCallId) continue;
+		const writes = entry.payload["writes"];
+		if (!Array.isArray(writes)) return [];
+		return writes.filter((write) => Array.isArray(write) && typeof write[0] === "string" && (write.length === 2 || write.length === 3 && write[2] === "replace" || write.length === 4 && (write[2] === "add" || write[2] === "replace") && Array.isArray(write[3]) && write[3].every((path) => typeof path === "string")));
+	}
+	return [];
+}
+const WIDGET_TOOLS = /* @__PURE__ */ new Set([
+	"read_me",
+	"show_widget",
+	"edit_widget",
+	"preview_widget",
+	"render_spec"
+]);
+/** Results of the tool calls before this one, by tool name and newest first, leaving out the widget toolkit's own tools. Tool names are keys every model can see, unlike call ids, which some formats never show, and counting back from this call keeps an index stable when a host prunes older history. */
+function resolveToolResults(messages, toolCallId) {
+	const results = Object.create(null);
+	for (const call of toolCalls(messages)) {
+		if (call.id === toolCallId) break;
+		if (WIDGET_TOOLS.has(call.name)) continue;
+		(results[call.name] ??= []).unshift(decodeResult(call.result));
+	}
+	return results;
+}
+/** A string result that holds a JSON object or array is decoded, since the model read that string as the structure. */
+function decodeResult(result) {
+	if (typeof result !== "string") return result;
+	try {
+		const value = JSON.parse(result);
+		return typeof value === "object" && value !== null ? value : result;
+	} catch {
+		return result;
+	}
+}
+/** A `spec` argument as the renderers read it, with `elements` an object even while the argument is still streaming in. */
+const specFromArgs = (spec) => {
+	const value = {
+		state: {},
+		...spec
+	};
+	return typeof value.elements === "object" && value.elements !== null ? value : {
+		...value,
+		elements: {}
+	};
+};
+/**
+* The spec a `render_spec` call's patches apply onto: the result of the
+* earlier `render_spec` calls with the same title in the thread.
+*/
+function resolveSpecBase(messages, toolCallId, title) {
+	let spec;
+	for (const call of toolCalls(messages)) {
+		if (call.id === toolCallId) return spec;
+		if (call.name !== "render_spec" || call.args["title"] !== title) continue;
+		if (call.args["spec"] && typeof call.args["spec"] === "object") spec = specFromArgs(call.args["spec"]);
+		else if (typeof call.args["patches"] === "string") spec = parseSpecStream(call.args["patches"], spec ? { initial: spec } : {}).spec;
+	}
+	return spec;
+}
+/** Whether a later `render_spec` call in the same message has this call's title. That call shows the spec this one's patches lead to, so this one shows nothing rather than a second copy. */
+function supersededInMessage(messages, toolCallId, title) {
+	return hasLaterToolCallInMessage(messages, toolCallId, title, (call) => call.name === "render_spec");
+}
+function priorSpecCalls(messages, toolCallId, title) {
+	let count = 0;
+	for (const call of toolCalls(messages)) {
+		if (call.id === toolCallId) break;
+		if (call.name === "render_spec" && call.args["title"] === title) count++;
+	}
+	return count;
+}
+/** What a mounted call registers for `execute`: the spec each title held before it in its own thread, how many calls built it, and the earlier results it mounts under `/tools`. */
+const callHistory = (messages, toolCallId, toolResults) => ({
+	base: (title) => ({
+		spec: resolveSpecBase(messages, toolCallId, title),
+		version: priorSpecCalls(messages, toolCallId, title)
+	}),
+	toolResults
+});
+const readsTools = (pointer) => pointer === "/tools" || pointer.startsWith("/tools/");
+/** Collects the state paths a value shows, leaving out reads in a branch that only renders while that path has a value: the `$then` of a `$cond` that tests it, and the `?` branch of a `$calc` condition on it. */
+function collectShown(value, guarded, shown) {
+	if (Array.isArray(value)) {
+		for (const item of value) collectShown(item, guarded, shown);
+		return;
+	}
+	if (typeof value !== "object" || value === null) return;
+	const record = value;
+	if ("$cond" in record) {
+		const tested = conditionGuards(record["$cond"]).map(safePointer);
+		collectShown(record["$then"], /* @__PURE__ */ new Set([...guarded, ...tested]), shown);
+		collectShown(record["$else"], guarded, shown);
+		return;
+	}
+	for (const [key, child] of Object.entries(record)) {
+		if (typeof child !== "string") {
+			collectShown(child, guarded, shown);
+			continue;
+		}
+		const paths = key === "$state" || key === "$bindState" ? [child] : key === "$template" ? templateStatePaths(child) : key === "$calc" ? formulaValueReads(child) : [];
+		for (const path of paths) {
+			const pointer = safePointer(path);
+			if (!guarded.has(pointer)) shown.push(pointer);
+		}
+	}
+}
+/** Each place a spec can render an element, with the paths a `visible` condition on it or an ancestor guards there: reachable from the root through children and slots, leaving out one hidden with `visible: false` along with what it holds, and the repeated children of a `/tools` path the results hold no array at. An element under parents that guard different paths appears once per set of guards. */
+function renderedElements(spec, state) {
+	const elements = spec.elements ?? {};
+	const rendered = [];
+	const seen = /* @__PURE__ */ new Set();
+	const pending = typeof spec.root === "string" ? [[spec.root, /* @__PURE__ */ new Set()]] : [];
+	while (pending.length > 0) {
+		const [id, inherited] = pending.pop();
+		if (!Object.hasOwn(elements, id)) continue;
+		const element = elements[id];
+		if (typeof element !== "object" || element === null) continue;
+		if (element.visible === false) continue;
+		const guarded = /* @__PURE__ */ new Set([...inherited, ...conditionGuards(element.visible).map(safePointer)]);
+		const visit = JSON.stringify([id, ...[...guarded].sort()]);
+		if (seen.has(visit)) continue;
+		seen.add(visit);
+		rendered.push([
+			id,
+			element,
+			guarded
+		]);
+		const repeat = typeof element.repeat?.path === "string" ? safePointer(element.repeat.path) : void 0;
+		const repeatsNothing = repeat !== void 0 && readsTools(repeat) && !Array.isArray(getAtPointer(state, repeat));
+		for (const slot of ["default", ...Object.keys(element.slots ?? {})]) {
+			if (slot === "default" && repeatsNothing) continue;
+			for (const child of childIdsOf(element, slot)) if (typeof child === "string") pending.push([child, guarded]);
+		}
+	}
+	return rendered;
+}
+/** Each place a spec shows state under `/tools` that the mounted results do not have, as a warning, since the model may have read the value from output the thread does not store or may mean a field that is absent. A read that only renders while its path has a value, under a `visible` condition or `$cond` test on it, is left out. */
+function missingToolResults(spec, toolResults) {
+	const issues = [];
+	const state = { tools: toolResults };
+	const reported = /* @__PURE__ */ new Set();
+	for (const [id, element, guarded] of renderedElements(spec, state)) {
+		const shown = [];
+		collectShown([
+			element.props,
+			element.on,
+			element.watch
+		], guarded, shown);
+		if (typeof element.repeat?.path === "string") {
+			const pointer = safePointer(element.repeat.path);
+			if (!guarded.has(pointer)) shown.push(pointer);
+		}
+		for (const pointer of new Set(shown)) {
+			if (!readsTools(pointer)) continue;
+			if (getAtPointer(state, pointer) !== void 0) continue;
+			const report = JSON.stringify([id, pointer]);
+			if (reported.has(report)) continue;
+			reported.add(report);
+			issues.push({
+				code: "missing-tool-result",
+				severity: "warning",
+				elementId: id,
+				path: `/elements/${escapePointerToken(id)}`,
+				message: `"${id}" shows \`${pointer}\`, which the earlier tool results do not have, so it shows nothing there. If you read that value from the tool's output, write it into the spec instead.`
+			});
+		}
+	}
+	return issues;
+}
+/** The app's rules and where earlier tool results are, which `render_spec`'s description and the `spec` module both carry. */
+const toolkitRules = (specPrompt) => [...specPrompt?.customRules ?? [], SPEC_TOOL_RESULTS_RULE];
+/**
+* The `render_spec` tool a toolkit shares across its calls. Each mounted call
+* registers its {@link callHistory} in `histories` under its tool call id, so
+* `execute` patches the base that call's own thread held, even after a reload
+* or in another thread.
+*/
+function createSpecCalls(catalog, specPrompt) {
+	const specs = /* @__PURE__ */ new Map();
+	const tools = createSpecTools(catalog, {
+		specs,
+		customRules: toolkitRules(specPrompt)
+	});
+	const histories = /* @__PURE__ */ new Map();
+	const execute = async (input, call) => {
+		const history = histories.get(call.toolCallId);
+		if (history) {
+			const { spec, version } = history.base(input.title);
+			if (spec) specs.set(input.title, {
+				spec,
+				version
+			});
+			else specs.delete(input.title);
+		}
+		const running = tools.render_spec.execute(input);
+		const spec = specs.get(input.title)?.spec;
+		const result = await running;
+		if (!history?.toolResults || !spec || spec.state?.["tools"] !== void 0) return result;
+		const missing = missingToolResults(spec, history.toolResults);
+		if (missing.length === 0) return result;
+		const issues = [...result.issues, ...missing];
+		return {
+			...result,
+			issues,
+			feedback: formatSpecIssues(issues)
+		};
+	};
+	return {
+		tools,
+		histories,
+		execute
+	};
+}
+/** The `spec` module of `read_me`: the catalog guidance with the built-in actions every assistant-ui toolkit handles, the app's rules, and where earlier tool results are. */
+const specModules = (catalog, specPrompt, host) => [specGuidanceModule(catalog, {
+	...specPrompt,
+	hostApi: {
+		prompt: true,
+		modelContext: true,
+		clipboard: host.clipboard,
+		...specPrompt?.hostApi
+	},
+	customRules: toolkitRules(specPrompt)
+})];
+/** Writes to the browser's clipboard, rejecting where the Clipboard API is missing. */
+const writeClipboard = (text) => typeof navigator !== "undefined" && navigator.clipboard ? navigator.clipboard.writeText(text) : Promise.reject(/* @__PURE__ */ new Error("Clipboard API is unavailable"));
+/** The built-in `copyText` handler. A copy that does not happen fails, so the rest of the list, such as a confirmation, does not run. */
+const copyTextHandler = (write) => (params, source) => {
+	if (source.kind === "watch") throw new Error("copyText runs only from an event a component emits, never from `watch`");
+	const text = params["text"];
+	if (typeof text !== "string") throw new Error("copyText needs a string `text`");
+	return write(text);
+};
+export { callHistory, copyTextHandler, createSpecCalls, resolveSpecBase, resolveToolResults, savedWrites, specFromArgs, specModules, supersededInMessage, writeClipboard };
+
+//# sourceMappingURL=thread.js.map

package/dist/spec/assistant-ui/thread.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread.js","names":[],"sources":["../../../src/spec/assistant-ui/thread.ts"],"sourcesContent":["import {\n  hasLaterToolCallInMessage,\n  toolCalls,\n  type MessageLike,\n} from \"../../assistant-ui/tool-calls\";\nimport type { ActionHandler } from \"../actions\";\nimport type { Catalog } from \"../catalog\";\nimport { formulaValueReads } from \"../calc\";\nimport { conditionGuards, templateStatePaths } from \"../expressions\";\nimport { escapePointerToken, getAtPointer } from \"../pointer\";\nimport type { SpecPromptOptions } from \"../prompt\";\nimport {\n  createSpecTools,\n  SPEC_TOOL_RESULTS_RULE,\n  specGuidanceModule,\n  type RenderSpecInput,\n} from \"../render-spec\";\nimport type { SpecStateWrite } from \"../state\";\nimport { parseSpecStream } from \"../stream\";\nimport { childIdsOf, safePointer } from \"../tree\";\nimport type { Spec, SpecElement } from \"../types\";\nimport { formatSpecIssues, type SpecIssue } from \"../validate\";\n\n/** The arguments of a `render_spec` call, which stream in. */\nexport type SpecArgs = Partial<RenderSpecInput>;\n\n/** The interactions a host records on a tool call, as its `unstable_interactions` prop holds them. */\nexport type InteractionLog = {\n  readonly entries: readonly (\n    | {\n        readonly type: \"action\";\n        readonly payload: Readonly<Record<string, unknown>>;\n      }\n    | { readonly type: \"human-response\"; readonly payload: unknown }\n  )[];\n};\n\n/**\n * The state writes saved on a `render_spec` call: the newest `setState` interaction recorded for that call. An entry whose `writes` is not a list marks a save that failed, so the call starts from the model's state rather than from an older snapshot.\n */\nexport function savedWrites(\n  log: InteractionLog | undefined,\n  toolCallId: string,\n): SpecStateWrite[] {\n  const entries = log?.entries ?? [];\n  for (let index = entries.length - 1; index >= 0; index--) {\n    const entry = entries[index]!;\n    if (\n      entry.type !== \"action\" ||\n      entry.payload[\"type\"] !== \"setState\" ||\n      entry.payload[\"toolCallId\"] !== toolCallId\n    )\n      continue;\n    const writes = entry.payload[\"writes\"];\n    if (!Array.isArray(writes)) return [];\n    return writes.filter(\n      (write): write is SpecStateWrite =>\n        Array.isArray(write) &&\n        typeof write[0] === \"string\" &&\n        (write.length === 2 ||\n          (write.length === 3 && write[2] === \"replace\") ||\n          (write.length === 4 &&\n            (write[2] === \"add\" || write[2] === \"replace\") &&\n            Array.isArray(write[3]) &&\n            write[3].every((path: unknown) => typeof path === \"string\"))),\n    );\n  }\n  return [];\n}\n\nconst WIDGET_TOOLS = new Set([\n  \"read_me\",\n  \"show_widget\",\n  \"edit_widget\",\n  \"preview_widget\",\n  \"render_spec\",\n]);\n\n/** Results of the tool calls before this one, by tool name and newest first, leaving out the widget toolkit's own tools. Tool names are keys every model can see, unlike call ids, which some formats never show, and counting back from this call keeps an index stable when a host prunes older history. */\nexport function resolveToolResults(\n  messages: readonly MessageLike[],\n  toolCallId: string,\n): Record<string, unknown[]> {\n  const results: Record<string, unknown[]> = Object.create(null);\n  for (const call of toolCalls(messages)) {\n    if (call.id === toolCallId) break;\n    if (WIDGET_TOOLS.has(call.name)) continue;\n    (results[call.name] ??= []).unshift(decodeResult(call.result));\n  }\n  return results;\n}\n\n/** A string result that holds a JSON object or array is decoded, since the model read that string as the structure. */\nfunction decodeResult(result: unknown): unknown {\n  if (typeof result !== \"string\") return result;\n  try {\n    const value: unknown = JSON.parse(result);\n    return typeof value === \"object\" && value !== null ? value : result;\n  } catch {\n    return result;\n  }\n}\n\n/** A `spec` argument as the renderers read it, with `elements` an object even while the argument is still streaming in. */\nexport const specFromArgs = (spec: object): Spec => {\n  const value = { state: {}, ...spec } as Spec;\n  return typeof value.elements === \"object\" && value.elements !== null\n    ? value\n    : { ...value, elements: {} };\n};\n\n/**\n * The spec a `render_spec` call's patches apply onto: the result of the\n * earlier `render_spec` calls with the same title in the thread.\n */\nexport function resolveSpecBase(\n  messages: readonly MessageLike[],\n  toolCallId: string,\n  title: string,\n): Spec | undefined {\n  let spec: Spec | undefined;\n  for (const call of toolCalls(messages)) {\n    if (call.id === toolCallId) return spec;\n    if (call.name !== \"render_spec\" || call.args[\"title\"] !== title) continue;\n    if (call.args[\"spec\"] && typeof call.args[\"spec\"] === \"object\") {\n      spec = specFromArgs(call.args[\"spec\"]);\n    } else if (typeof call.args[\"patches\"] === \"string\") {\n      spec = parseSpecStream(\n        call.args[\"patches\"],\n        spec ? { initial: spec } : {},\n      ).spec;\n    }\n  }\n  return spec;\n}\n\n/** Whether a later `render_spec` call in the same message has this call's title. That call shows the spec this one's patches lead to, so this one shows nothing rather than a second copy. */\nexport function supersededInMessage(\n  messages: readonly MessageLike[],\n  toolCallId: string,\n  title: string,\n): boolean {\n  return hasLaterToolCallInMessage(\n    messages,\n    toolCallId,\n    title,\n    (call) => call.name === \"render_spec\",\n  );\n}\n\nfunction priorSpecCalls(\n  messages: readonly MessageLike[],\n  toolCallId: string,\n  title: string,\n): number {\n  let count = 0;\n  for (const call of toolCalls(messages)) {\n    if (call.id === toolCallId) break;\n    if (call.name === \"render_spec\" && call.args[\"title\"] === title) count++;\n  }\n  return count;\n}\n\ntype SpecHistory = {\n  base(title: string): { spec: Spec | undefined; version: number };\n  toolResults: Record<string, unknown[]> | undefined;\n};\n\n/** What a mounted call registers for `execute`: the spec each title held before it in its own thread, how many calls built it, and the earlier results it mounts under `/tools`. */\nexport const callHistory = (\n  messages: readonly MessageLike[],\n  toolCallId: string,\n  toolResults: Record<string, unknown[]> | undefined,\n): SpecHistory => ({\n  base: (title) => ({\n    spec: resolveSpecBase(messages, toolCallId, title),\n    version: priorSpecCalls(messages, toolCallId, title),\n  }),\n  toolResults,\n});\n\nconst readsTools = (pointer: string) =>\n  pointer === \"/tools\" || pointer.startsWith(\"/tools/\");\n\n/** Collects the state paths a value shows, leaving out reads in a branch that only renders while that path has a value: the `$then` of a `$cond` that tests it, and the `?` branch of a `$calc` condition on it. */\nfunction collectShown(\n  value: unknown,\n  guarded: ReadonlySet<string>,\n  shown: string[],\n): void {\n  if (Array.isArray(value)) {\n    for (const item of value) collectShown(item, guarded, shown);\n    return;\n  }\n  if (typeof value !== \"object\" || value === null) return;\n  const record = value as Record<string, unknown>;\n  if (\"$cond\" in record) {\n    const tested = conditionGuards(record[\"$cond\"]).map(safePointer);\n    collectShown(record[\"$then\"], new Set([...guarded, ...tested]), shown);\n    collectShown(record[\"$else\"], guarded, shown);\n    return;\n  }\n  for (const [key, child] of Object.entries(record)) {\n    if (typeof child !== \"string\") {\n      collectShown(child, guarded, shown);\n      continue;\n    }\n    const paths =\n      key === \"$state\" || key === \"$bindState\"\n        ? [child]\n        : key === \"$template\"\n          ? templateStatePaths(child)\n          : key === \"$calc\"\n            ? formulaValueReads(child)\n            : [];\n    for (const path of paths) {\n      const pointer = safePointer(path);\n      if (!guarded.has(pointer)) shown.push(pointer);\n    }\n  }\n}\n\n/** Each place a spec can render an element, with the paths a `visible` condition on it or an ancestor guards there: reachable from the root through children and slots, leaving out one hidden with `visible: false` along with what it holds, and the repeated children of a `/tools` path the results hold no array at. An element under parents that guard different paths appears once per set of guards. */\nfunction renderedElements(\n  spec: Spec,\n  state: unknown,\n): [string, SpecElement, ReadonlySet<string>][] {\n  const elements = spec.elements ?? {};\n  const rendered: [string, SpecElement, ReadonlySet<string>][] = [];\n  const seen = new Set<string>();\n  const pending: [string, ReadonlySet<string>][] =\n    typeof spec.root === \"string\" ? [[spec.root, new Set()]] : [];\n  while (pending.length > 0) {\n    const [id, inherited] = pending.pop()!;\n    if (!Object.hasOwn(elements, id)) continue;\n    const element = elements[id];\n    if (typeof element !== \"object\" || element === null) continue;\n    if (element.visible === false) continue;\n    const guarded = new Set([\n      ...inherited,\n      ...conditionGuards(element.visible).map(safePointer),\n    ]);\n    const visit = JSON.stringify([id, ...[...guarded].sort()]);\n    if (seen.has(visit)) continue;\n    seen.add(visit);\n    rendered.push([id, element, guarded]);\n    const repeat =\n      typeof element.repeat?.path === \"string\"\n        ? safePointer(element.repeat.path)\n        : undefined;\n    const repeatsNothing =\n      repeat !== undefined &&\n      readsTools(repeat) &&\n      !Array.isArray(getAtPointer(state, repeat));\n    for (const slot of [\"default\", ...Object.keys(element.slots ?? {})]) {\n      if (slot === \"default\" && repeatsNothing) continue;\n      for (const child of childIdsOf(element, slot))\n        if (typeof child === \"string\") pending.push([child, guarded]);\n    }\n  }\n  return rendered;\n}\n\n/** Each place a spec shows state under `/tools` that the mounted results do not have, as a warning, since the model may have read the value from output the thread does not store or may mean a field that is absent. A read that only renders while its path has a value, under a `visible` condition or `$cond` test on it, is left out. */\nfunction missingToolResults(\n  spec: Spec,\n  toolResults: Record<string, unknown[]>,\n): SpecIssue[] {\n  const issues: SpecIssue[] = [];\n  const state = { tools: toolResults };\n  const reported = new Set<string>();\n  for (const [id, element, guarded] of renderedElements(spec, state)) {\n    const shown: string[] = [];\n    collectShown([element.props, element.on, element.watch], guarded, shown);\n    if (typeof element.repeat?.path === \"string\") {\n      const pointer = safePointer(element.repeat.path);\n      if (!guarded.has(pointer)) shown.push(pointer);\n    }\n    for (const pointer of new Set(shown)) {\n      if (!readsTools(pointer)) continue;\n      if (getAtPointer(state, pointer) !== undefined) continue;\n      const report = JSON.stringify([id, pointer]);\n      if (reported.has(report)) continue;\n      reported.add(report);\n      issues.push({\n        code: \"missing-tool-result\",\n        severity: \"warning\",\n        elementId: id,\n        path: `/elements/${escapePointerToken(id)}`,\n        message: `\"${id}\" shows \\`${pointer}\\`, which the earlier tool results do not have, so it shows nothing there. If you read that value from the tool's output, write it into the spec instead.`,\n      });\n    }\n  }\n  return issues;\n}\n\n/** The app's rules and where earlier tool results are, which `render_spec`'s description and the `spec` module both carry. */\nconst toolkitRules = (\n  specPrompt: Omit<SpecPromptOptions, \"mode\"> | undefined,\n) => [...(specPrompt?.customRules ?? []), SPEC_TOOL_RESULTS_RULE];\n\n/**\n * The `render_spec` tool a toolkit shares across its calls. Each mounted call\n * registers its {@link callHistory} in `histories` under its tool call id, so\n * `execute` patches the base that call's own thread held, even after a reload\n * or in another thread.\n */\nexport function createSpecCalls(\n  catalog: Catalog,\n  specPrompt: Omit<SpecPromptOptions, \"mode\"> | undefined,\n) {\n  const specs = new Map<string, { spec: Spec; version: number }>();\n  const tools = createSpecTools(catalog, {\n    specs,\n    customRules: toolkitRules(specPrompt),\n  });\n  const histories = new Map<string, SpecHistory>();\n  const execute = async (\n    input: RenderSpecInput,\n    call: { toolCallId: string },\n  ) => {\n    const history = histories.get(call.toolCallId);\n    if (history) {\n      const { spec, version } = history.base(input.title);\n      if (spec) specs.set(input.title, { spec, version });\n      else specs.delete(input.title);\n    }\n    const running = tools.render_spec.execute(input);\n    // `execute` stores this call's spec before it returns, so the spec is read before an overlapping call with the same title stores its own.\n    const spec = specs.get(input.title)?.spec;\n    const result = await running;\n    // The results are mounted only while the spec writes no `tools` of its own.\n    if (!history?.toolResults || !spec || spec.state?.[\"tools\"] !== undefined)\n      return result;\n    const missing = missingToolResults(spec, history.toolResults);\n    if (missing.length === 0) return result;\n    const issues = [...result.issues, ...missing];\n    return { ...result, issues, feedback: formatSpecIssues(issues) };\n  };\n  return { tools, histories, execute };\n}\n\n/** The `spec` module of `read_me`: the catalog guidance with the built-in actions every assistant-ui toolkit handles, the app's rules, and where earlier tool results are. */\nexport const specModules = (\n  catalog: Catalog,\n  specPrompt: Omit<SpecPromptOptions, \"mode\"> | undefined,\n  host: { clipboard: boolean },\n) => [\n  specGuidanceModule(catalog, {\n    ...specPrompt,\n    hostApi: {\n      prompt: true,\n      modelContext: true,\n      clipboard: host.clipboard,\n      ...specPrompt?.hostApi,\n    },\n    customRules: toolkitRules(specPrompt),\n  }),\n];\n\n/** Writes to the browser's clipboard, rejecting where the Clipboard API is missing. */\nexport const writeClipboard = (text: string): Promise<void> =>\n  typeof navigator !== \"undefined\" && navigator.clipboard\n    ? navigator.clipboard.writeText(text)\n    : Promise.reject(new Error(\"Clipboard API is unavailable\"));\n\n/** The built-in `copyText` handler. A copy that does not happen fails, so the rest of the list, such as a confirmation, does not run. */\nexport const copyTextHandler =\n  (write: (text: string) => Promise<void>): ActionHandler =>\n  (params, source) => {\n    if (source.kind === \"watch\") {\n      throw new Error(\n        \"copyText runs only from an event a component emits, never from `watch`\",\n      );\n    }\n    const text = params[\"text\"];\n    if (typeof text !== \"string\") {\n      throw new Error(\"copyText needs a string `text`\");\n    }\n    return write(text);\n  };\n"],"mappings":"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"}

package/dist/spec/assistant-ui/toolkit.d.ts

@@ -0,0 +1,33 @@
+import { type Component, type MaybeRefOrGetter } from "vue";
+import type { WidgetToolkitExtension } from "../../assistant-ui/extension.js";
+import { type ModelContextSource } from "../../assistant-ui/modelContext.js";
+import type { MessageLike } from "../../assistant-ui/tool-calls.js";
+import type { ActionHandler } from "../actions.js";
+import type { Catalog } from "../catalog.js";
+import type { SpecPromptOptions } from "../prompt.js";
+import type { SpecComponents } from "../vue/SpecRenderer.js";
+import { type SpecStateStore } from "../state.js";
+export type SpecToolkitOptions = {
+    components: SpecComponents;
+    handlers?: Record<string, ActionHandler>;
+    onAction?: (name: string, params: Record<string, unknown>, context: {
+        elementId?: string;
+        trigger?: string;
+        state: SpecStateStore;
+    }) => unknown;
+    placeholder?: Component;
+    specPrompt?: Omit<SpecPromptOptions, "mode">;
+    toolResults?: boolean;
+};
+export type SpecToolkitPlatform = {
+    useMessages(): MaybeRefOrGetter<readonly MessageLike[]>;
+    useArgsComplete(): MaybeRefOrGetter<boolean>;
+    SpecRenderer: Component;
+    /** The frame renders its content through its default Vue slot. */
+    Frame: Component;
+    useSendMessage(): (text: string) => void;
+    useModelContext(source: ModelContextSource): void;
+    copyText?: (text: string) => Promise<void>;
+};
+export declare const specToolkitFor: ({ useMessages, useArgsComplete, SpecRenderer, Frame, useSendMessage, useModelContext, copyText, }: SpecToolkitPlatform) => (catalog: Catalog, options: SpecToolkitOptions) => WidgetToolkitExtension;
+//# sourceMappingURL=toolkit.d.ts.map

package/dist/spec/assistant-ui/toolkit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolkit.d.ts","mappings":"AAAA,OAAO,EAUL,KAAK,SAAS,EACd,KAAK,gBAAgB,EACtB,MAAM,KAAK;AAEZ,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iCAA8B;AAC1E,OAAO,EAGL,KAAK,kBAAkB,EAExB,MAAM,oCAAiC;AAExC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAA+B;AAEhE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAY;AAC/C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAY;AACzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAW;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAqB;AAEzD,OAAO,EAEL,KAAK,cAAc,EAEpB,MAAM,aAAU;AAcjB,MAAM,MAAM,kBAAkB,GAAG;IAC/B,UAAU,EAAE,cAAc;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC;IACxC,QAAQ,CAAC,EAAE,CACT,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM;QAAE,OAAO,CAAC,EAAE,MAAM;QAAE,KAAK,EAAE,cAAc;KAAE,KACrE,OAAO;IACZ,WAAW,CAAC,EAAE,SAAS;IACvB,UAAU,CAAC,EAAE,IAAI,CAAC,iBAAiB,EAAE,MAAM,CAAC;IAC5C,WAAW,CAAC,EAAE,OAAO;CACtB;AACD,MAAM,MAAM,mBAAmB,GAAG;IAChC,WAAW,IAAI,gBAAgB,CAAC,SAAS,WAAW,EAAE,CAAC;IACvD,eAAe,IAAI,gBAAgB,CAAC,OAAO,CAAC;IAC5C,YAAY,EAAE,SAAS;IACvB;IACA,KAAK,EAAE,SAAS;IAChB,cAAc,IAAI,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI;IACxC,eAAe,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI;IACjD,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC;CAC3C;AAWD,eAAO,MAAM,cAAc,GACxB,mGAQE,mBAAmB,MACrB,SAAS,OAAO,EAAE,SAAS,kBAAkB,KAAG,sBA6MhD","names":[],"ignoreList":[],"sources":["../../../src/spec/assistant-ui/toolkit.tsx"],"sourcesContent":[null]}