@antelopejs/dms-ai 0.2.1 → 0.4.0

package/frontend-vue/tests/views/api-data-reads.test.ts

@@ -0,0 +1,445 @@
+// @vitest-environment jsdom
+import { flushPromises, shallowMount } from "@vue/test-utils";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import {
+	computed,
+	defineComponent,
+	h,
+	reactive,
+	ref,
+	toValue,
+	watch,
+	type MaybeRefOrGetter,
+} from "vue";
+import ActivityDetail from "../../app/components/ActivityDetail.vue";
+import ChangesView from "../../app/components/ChangesView.vue";
+import ChangeSetPanel from "../../app/views/ChangeSetPanel.vue";
+import UnavailableState from "../../app/views/UnavailableState.vue";
+
+// The views read what they render with the DMS's `useApiData`, which a server
+// render hands to the browser (this repository has no renderer to run it:
+// the playground proves that part), and the Changes list page by page with
+// `useApiPagedData`; `$authFetch` is left to the writes. These fakes read as
+// the browser does.
+
+const route = reactive({ query: {} as Record<string, string> });
+
+vi.mock("#dms/frontend-module", () => ({
+	useDmsRoute: () => route,
+	useDmsRouter: () => ({ push: vi.fn() }),
+}));
+
+interface Read {
+	url: string;
+	query?: Record<string, unknown>;
+}
+
+type Backend = (read: Read) => unknown;
+
+let backend: Backend;
+const reads: Read[] = [];
+const authFetch = vi.fn();
+/** The reads the page's refreshes read again, as the DMS's `refreshPageBlocks()` does. */
+const pageReads = new Set<() => Promise<void>>();
+const refreshPageBlocks = vi.fn(async () => {
+	await Promise.all([...pageReads].map((refresh) => refresh()));
+});
+
+interface FakeApiDataOptions {
+	query?: MaybeRefOrGetter<Record<string, unknown>>;
+	refreshOnPageRefresh?: boolean;
+}
+
+function useApiData<T>(
+	url: MaybeRefOrGetter<string | null | undefined>,
+	options: FakeApiDataOptions = {},
+) {
+	const data = ref<T | null>(null);
+	const error = ref<unknown>(null);
+	const status = ref<"idle" | "pending" | "success" | "error">("idle");
+	const request = () => ({ url: toValue(url), query: toValue(options.query) });
+	async function refresh(): Promise<void> {
+		const { url: target, query } = request();
+		if (target == null) return;
+		const read = query ? { url: target, query } : { url: target };
+		reads.push(read);
+		status.value = "pending";
+		try {
+			// Each answer is a new value, as a parsed response is.
+			data.value = structuredClone(await backend(read)) as T;
+			error.value = null;
+			status.value = "success";
+		} catch (failure) {
+			error.value = failure;
+			status.value = "error";
+		}
+	}
+	watch(request, () => void refresh(), { deep: true, immediate: true });
+	if (options.refreshOnPageRefresh !== false) pageReads.add(refresh);
+	return {
+		data,
+		error,
+		status,
+		pending: computed(() => status.value === "pending"),
+		placeholder: ref(false),
+		refresh,
+		execute: refresh,
+		clear: () => undefined,
+	};
+}
+
+interface FakePagedOptions<TPage> {
+	nextCursor: (page: TPage, pages: TPage[]) => number | null | undefined;
+}
+
+type PagedContext = {
+	$authFetch: typeof authFetch;
+	cursor: number | undefined;
+	signal: AbortSignal;
+};
+
+/** `useApiPagedData` as the renderer runs it: one key, the pages it loaded, all read again on a refresh. */
+function useApiPagedData<TPage>(
+	key: MaybeRefOrGetter<string>,
+	handler: (context: PagedContext) => Promise<TPage>,
+	options: FakePagedOptions<TPage>,
+) {
+	const pages = ref<TPage[]>([]) as { value: TPage[] };
+	const next = ref<number | null>(null);
+	const error = ref<unknown>(null);
+	const status = ref<"idle" | "pending" | "success" | "error">("idle");
+	const loadingMore = ref(false);
+	const read = (cursor: number | undefined) =>
+		handler({
+			$authFetch: authFetch,
+			cursor,
+			signal: new AbortController().signal,
+		});
+	async function readPages(count: number): Promise<void> {
+		status.value = "pending";
+		const loaded: TPage[] = [];
+		let cursor: number | undefined;
+		try {
+			for (let index = 0; index < count; index++) {
+				const page = structuredClone(await read(cursor)) as TPage;
+				loaded.push(page);
+				const after = options.nextCursor(page, loaded) ?? null;
+				next.value = after;
+				if (after === null) break;
+				cursor = after;
+			}
+			pages.value = loaded;
+			error.value = null;
+			status.value = "success";
+		} catch (failure) {
+			error.value = failure;
+			status.value = "error";
+		}
+	}
+	const refresh = () => readPages(Math.max(pages.value.length, 1));
+	watch(
+		() => toValue(key),
+		() => void readPages(1),
+		{ immediate: true },
+	);
+	pageReads.add(refresh);
+	async function loadMore(): Promise<void> {
+		if (next.value === null) return;
+		loadingMore.value = true;
+		try {
+			const page = structuredClone(await read(next.value)) as TPage;
+			pages.value = [...pages.value, page];
+			next.value = options.nextCursor(page, pages.value) ?? null;
+		} catch (failure) {
+			error.value = failure;
+		} finally {
+			loadingMore.value = false;
+		}
+	}
+	return {
+		pages,
+		error,
+		status,
+		pending: computed(() => status.value === "pending"),
+		hasMore: computed(() => next.value !== null),
+		loadingMore,
+		loadMore,
+		refresh,
+	};
+}
+
+const Stub = (name: string) =>
+	defineComponent({
+		name,
+		inheritAttrs: false,
+		setup:
+			(_, { slots }) =>
+			() =>
+				h("div", { "data-stub": name }, slots.default?.()),
+	});
+
+const GLOBAL_STUBS = Object.fromEntries(
+	[
+		"DmsCard",
+		"DmsEmptyState",
+		"DmsMasterDetail",
+		"DmsSegmented",
+		"DmsKeyValueList",
+		"DmsIconWell",
+		"DmsEyebrow",
+		"DmsCodeSnippet",
+		"UButton",
+		"UInput",
+		"USkeleton",
+	].map((name) => [name, Stub(name)]),
+);
+
+const unavailable = () =>
+	Object.assign(new Error("Service Unavailable"), {
+		statusCode: 503,
+		data: { message: "The assistant is not running" },
+	});
+
+const ROW = {
+	id: "act-1",
+	timestampMs: Date.UTC(2026, 9, 15, 10),
+	tool: "Edit",
+	target: "src/pages/home.ts",
+	agent: "claude",
+	allowedBy: "approved",
+	result: "done",
+	conversationId: "conv-1",
+	conversationTitle: "Rename the home page",
+	isReadOnly: false,
+	isAutoFix: false,
+};
+
+const summary = (id: string, number: number) => ({
+	id,
+	number,
+	title: `Change ${number}`,
+	state: "applied",
+	createdAtMs: Date.UTC(2026, 9, 15, 10),
+	added: 1,
+	removed: 0,
+	scope: "safe",
+	agent: "claude",
+	files: [],
+	isAutoFix: false,
+	approvalsNeeded: 0,
+	builderOps: 0,
+	typecheck: "passed",
+});
+
+beforeEach(() => {
+	reads.length = 0;
+	authFetch.mockReset();
+	route.query = {};
+	pageReads.clear();
+	refreshPageBlocks.mockClear();
+	vi.stubGlobal("useApiData", useApiData);
+	vi.stubGlobal("useApiPagedData", useApiPagedData);
+	vi.stubGlobal("refreshPageBlocks", refreshPageBlocks);
+	vi.stubGlobal("useAuthFetch", () => ({ $authFetch: authFetch }));
+	vi.stubGlobal("useI18n", () => ({
+		t: (key: string) => key,
+		te: () => false,
+	}));
+	vi.stubGlobal("useRegionalFormat", () => ({
+		dateTimeFormat: (options: Intl.DateTimeFormatOptions) =>
+			new Intl.DateTimeFormat("en-GB", { ...options, timeZone: "UTC" }),
+	}));
+	vi.stubGlobal("useToast", () => ({ add: vi.fn() }));
+	vi.stubGlobal("useConfirmFrom", () => ({ confirmFrom: vi.fn() }));
+});
+
+afterEach(() => {
+	vi.unstubAllGlobals();
+});
+
+const mount = (component: Parameters<typeof shallowMount>[0], props = {}) =>
+	shallowMount(component, {
+		props,
+		global: { stubs: { ...GLOBAL_STUBS, UnavailableState: false } },
+	});
+
+describe("activity detail", () => {
+	it("reads the entry its row names with the page, not with $authFetch", async () => {
+		backend = () => ({ ...ROW, args: { file_path: "src/pages/home.ts" } });
+		const wrapper = mount(ActivityDetail, { rowData: ROW });
+		await flushPromises();
+		expect(reads).toEqual([{ url: "/ai/activity/act-1" }]);
+		expect(authFetch).not.toHaveBeenCalled();
+		expect(wrapper.findComponent(UnavailableState).exists()).toBe(false);
+		expect(wrapper.find('[data-stub="USkeleton"]').exists()).toBe(false);
+	});
+
+	it("says the assistant is not running on a 503, and reads again on retry", async () => {
+		backend = () => {
+			throw unavailable();
+		};
+		const wrapper = mount(ActivityDetail, { rowData: ROW });
+		await flushPromises();
+		const state = wrapper.findComponent(UnavailableState);
+		expect(state.props("failure")).toBe("unavailable");
+		backend = () => ROW;
+		state.vm.$emit("retry");
+		await flushPromises();
+		expect(reads).toHaveLength(2);
+		expect(wrapper.findComponent(UnavailableState).exists()).toBe(false);
+	});
+});
+
+describe("changes view", () => {
+	const PAGE = { results: [summary("cs-1", 1), summary("cs-2", 2)], total: 3 };
+	const NEXT_PAGE = { results: [summary("cs-3", 3)], total: 3 };
+
+	function changesBackend({ url, query }: Read): unknown {
+		if (url === "/ai/status") return { checkpointsAvailable: true };
+		if (url === "/ai/changes") return query?.offset ? NEXT_PAGE : PAGE;
+		return { changeSet: summary("cs-1", 1), files: [] };
+	}
+
+	/** The paged list's requests, which go through the handler's `$authFetch`. */
+	function listReads(): unknown[] {
+		return authFetch.mock.calls.map(([url, options]) => [
+			url,
+			(options as { query: unknown }).query,
+		]);
+	}
+
+	beforeEach(() => {
+		authFetch.mockImplementation(async (url: string, options: Read) =>
+			changesBackend({ url, query: options.query }),
+		);
+	});
+
+	it("reads the status and the first page with the page, and opens the set the URL names", async () => {
+		backend = changesBackend;
+		route.query = { set: "cs-2" };
+		const wrapper = mount(ChangesView);
+		await flushPromises();
+		expect(reads).toEqual([{ url: "/ai/status" }]);
+		expect(listReads()).toEqual([["/ai/changes", { offset: 0, limit: 30 }]]);
+		expect(wrapper.findComponent(ChangeSetPanel).props("changeSetId")).toBe(
+			"cs-2",
+		);
+	});
+
+	it("selects the first set when the URL names none", async () => {
+		backend = changesBackend;
+		const wrapper = mount(ChangesView);
+		await flushPromises();
+		expect(wrapper.findComponent(ChangeSetPanel).props("changeSetId")).toBe(
+			"cs-1",
+		);
+	});
+
+	it("appends the next page on Load more, and reads every loaded page again on a page refresh", async () => {
+		backend = changesBackend;
+		const wrapper = mount(ChangesView);
+		await flushPromises();
+		const loadMoreButton = () =>
+			wrapper
+				.findAllComponents({ name: "UButton" })
+				.find(
+					(button) =>
+						button.vm.$attrs.label === "dms_ai.views.common.load_more",
+				);
+		loadMoreButton()!.vm.$emit("click");
+		await flushPromises();
+		expect(listReads().at(-1)).toEqual([
+			"/ai/changes",
+			{ offset: 2, limit: 30 },
+		]);
+		const items = () =>
+			(
+				wrapper.findComponent({ name: "DmsMasterDetail" }).vm.$attrs.items as {
+					value: string;
+				}[]
+			).map((item) => item.value);
+		expect(items()).toEqual(["cs-1", "cs-2", "cs-3"]);
+		expect(loadMoreButton()).toBeUndefined();
+
+		// A change set undone in the panel refreshes the page, which reads the
+		// pages loaded again rather than dropping the second one.
+		authFetch.mockClear();
+		await refreshPageBlocks();
+		await flushPromises();
+		expect(listReads()).toEqual([
+			["/ai/changes", { offset: 0, limit: 30 }],
+			["/ai/changes", { offset: 2, limit: 30 }],
+		]);
+		expect(items()).toEqual(["cs-1", "cs-2", "cs-3"]);
+	});
+
+	it("reads the filtered first page when the scope changes", async () => {
+		backend = changesBackend;
+		const wrapper = mount(ChangesView);
+		await flushPromises();
+		wrapper
+			.findComponent({ name: "DmsSegmented" })
+			.vm.$emit("update:modelValue", "vibe");
+		await flushPromises();
+		expect(listReads().at(-1)).toEqual([
+			"/ai/changes",
+			{ offset: 0, limit: 30, scope: "vibe", filter_scope: "is:vibe" },
+		]);
+	});
+});
+
+describe("change set panel", () => {
+	it("refreshes the page once a set is redone, instead of reading on its own", async () => {
+		backend = () => ({
+			changeSet: { ...summary("cs-1", 1), state: "undone" },
+			files: [],
+		});
+		authFetch.mockResolvedValue({});
+		const wrapper = mount(ChangeSetPanel, { changeSetId: "cs-1" });
+		await flushPromises();
+		expect(reads).toEqual([{ url: "/ai/changes/cs-1" }]);
+		const redo = wrapper
+			.findAllComponents({ name: "UButton" })
+			.find((button) => button.vm.$attrs.label === "dms_ai.views.changes.redo");
+		redo!.vm.$emit("click");
+		await flushPromises();
+		expect(authFetch).toHaveBeenCalledWith("/ai/changes/cs-1/redo", {
+			method: "POST",
+			body: {},
+		});
+		expect(refreshPageBlocks).toHaveBeenCalledTimes(1);
+		expect(reads).toEqual([
+			{ url: "/ai/changes/cs-1" },
+			{ url: "/ai/changes/cs-1" },
+		]);
+	});
+});
+
+describe("change set actions", () => {
+	it("stay busy until the page refresh a redo asks for is done", async () => {
+		backend = () => ({
+			changeSet: { ...summary("cs-1", 1), state: "undone" },
+			files: [],
+		});
+		authFetch.mockResolvedValue({});
+		let finishRefresh: () => void = () => undefined;
+		refreshPageBlocks.mockImplementationOnce(
+			() => new Promise<void>((resolve) => (finishRefresh = resolve)),
+		);
+		const wrapper = mount(ChangeSetPanel, { changeSetId: "cs-1" });
+		await flushPromises();
+		const redo = () =>
+			wrapper
+				.findAllComponents({ name: "UButton" })
+				.find(
+					(button) => button.vm.$attrs.label === "dms_ai.views.changes.redo",
+				)!;
+		redo().vm.$emit("click");
+		await flushPromises();
+		expect(refreshPageBlocks).toHaveBeenCalledTimes(1);
+		expect(redo().vm.$attrs.loading).toBe(true);
+		finishRefresh();
+		await flushPromises();
+		expect(redo().vm.$attrs.loading).toBe(false);
+	});
+});

package/frontend-vue/tests/views/use-assistant.test.ts

@@ -0,0 +1,53 @@
+// @vitest-environment jsdom
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { createSSRApp, defineComponent, h, nextTick, shallowRef } from "vue";
+import { renderToString } from "vue/server-renderer";
+import type { AssistantSession } from "../../app/runtime/assistant-session";
+import { ASSISTANT_SESSION_KEY } from "../../app/runtime/assistant-session";
+import { useAssistant } from "../../app/views/composables/useAssistant";
+
+vi.mock("#dms/frontend-module", () => ({
+	useDmsRouter: () => ({ push: vi.fn() }),
+}));
+
+// A view offering an assistant button, as the Changes empty state does.
+const View = defineComponent({
+	setup() {
+		const assistant = useAssistant();
+		return () =>
+			h("div", [assistant.isAvailable ? h("button", "Open assistant") : null]);
+	},
+});
+
+function appWith(session: AssistantSession | null) {
+	const app = createSSRApp(View);
+	app.provide(ASSISTANT_SESSION_KEY, shallowRef(session));
+	return app;
+}
+
+afterEach(() => {
+	document.body.innerHTML = "";
+});
+
+describe("useAssistant", () => {
+	it("hydrates what the server rendered when the session started first, then offers the assistant", async () => {
+		const html = await renderToString(appWith(null));
+		const root = document.createElement("div");
+		root.innerHTML = html;
+		document.body.append(root);
+		const warn = vi.spyOn(console, "warn").mockImplementation(() => {});
+		const error = vi.spyOn(console, "error").mockImplementation(() => {});
+
+		// The tab's probe answered before this block hydrated.
+		appWith({} as AssistantSession).mount(root);
+		const mismatches = [...warn.mock.calls, ...error.mock.calls]
+			.flat()
+			.filter((entry) => String(entry).includes("Hydration"));
+		warn.mockRestore();
+		error.mockRestore();
+		expect(mismatches).toEqual([]);
+
+		await nextTick();
+		expect(root.querySelector("button")?.textContent).toBe("Open assistant");
+	});
+});

package/frontend-vue/vitest.config.ts

@@ -1,8 +1,18 @@
+import { resolve } from "node:path";
 import vue from "@vitejs/plugin-vue";
 import { defineConfig } from "vitest/config";
 
 export default defineConfig({
 	plugins: [vue()],
+	resolve: {
+		alias: {
+			// The renderer's runtime exists in the generated application only.
+			"#dms/frontend-module": resolve(
+				__dirname,
+				"tests/support/dms-frontend-module.ts",
+			),
+		},
+	},
 	test: {
 		// Most suites need no DOM, and setting jsdom up per file is the bulk of
 		// the run; the files that mount components opt in with a

package/package.json

@@ -1,6 +1,20 @@
 {
   "name": "@antelopejs/dms-ai",
-  "version": "0.2.1",
+  "version": "0.4.0",
+  "description": "AI development assistant for the AntelopeJS DMS: a chat panel next to every page and a coding agent that edits the project in reviewable, undoable change sets.",
+  "keywords": [
+    "ai",
+    "antelopejs",
+    "assistant",
+    "claude-code",
+    "codex",
+    "dms",
+    "dms-module"
+  ],
+  "homepage": "https://dms.antelopejs.com/docs/modules/ai",
+  "bugs": {
+    "url": "https://github.com/AntelopeJS/dms-ai/issues"
+  },
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
@@ -52,9 +66,9 @@
     "knip:all": "knip"
   },
   "dependencies": {
-    "@antelopejs/interface-api": ">=0.0.14 <1.0.0",
-    "@antelopejs/interface-core": ">=0.1.1 <1.0.0",
-    "@antelopejs/interface-dms": ">=0.6.0 <1.0.0",
+    "@antelopejs/interface-api": ">=0.0.15 <1.0.0",
+    "@antelopejs/interface-core": ">=0.2.4 <1.0.0",
+    "@antelopejs/interface-dms": ">=0.7.2 <1.0.0",
     "@anthropic-ai/claude-agent-sdk": "^0.2.131",
     "@anthropic-ai/claude-code": "^2.1.131",
     "@modelcontextprotocol/sdk": "1.29.0",
@@ -62,7 +76,7 @@
     "zod": "^4.0.0"
   },
   "devDependencies": {
-    "@antelopejs/tooling-configs": ">=0.0.7 <1.0.0",
+    "@antelopejs/tooling-configs": ">=0.0.9 <1.0.0",
     "@types/node": "^24.0.0",
     "@types/ws": "^8.5.12",
     "knip": "^6.34.0",
@@ -83,7 +97,7 @@
     }
   },
   "optionalDependencies": {
-    "@antelopejs/interface-dms-builder": ">=0.1.3 <1.0.0"
+    "@antelopejs/interface-dms-builder": ">=0.2.1 <1.0.0"
   },
   "packageManager": "pnpm@10.2.0",
   "antelopeJs": {

package/sidecar/dist/constants/mcp.js

@@ -1,6 +1,7 @@
 import { BUILDER_TOOL_NAMES } from "./builder.js";
 import { QUERY_LOGS_TOOL_NAME } from "./logs.js";
 import { FIND_PAGES_TOOL_NAME, LIST_PAGES_TOOL_NAME } from "./pages.js";
+import { PREVIEW_BLOCKS_TOOL_NAME } from "./preview.js";
 import { REQUEST_TIMEOUT_MINUTES } from "../state/settings-types.js";
 import { QUESTION_TIMEOUT_MS } from "./questions.js";
 import { MS_PER_MINUTE } from "./settings.js";
@@ -35,6 +36,7 @@ export const FIRST_PARTY_AUTO_ALLOW_TOOL_NAMES = new Set([
     FIND_PAGES_TOOL_NAME,
     LIST_PAGES_TOOL_NAME,
     ASK_USER_TOOL_NAME,
+    PREVIEW_BLOCKS_TOOL_NAME,
     TYPECHECK_TOOL_NAME,
     QUERY_LOGS_TOOL_NAME,
     ...BUILDER_TOOL_NAMES,

package/sidecar/dist/constants/mcp.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../src/constants/mcp.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../src/constants/mcp.ts"],"names":[],"mappings":"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"}

package/sidecar/dist/constants/preview.d.ts

@@ -0,0 +1,39 @@
+export declare const PREVIEW_BLOCKS_TOOL_NAME = "PreviewBlocks";
+export declare const PREVIEW_BLOCKS_TOOL_DESCRIPTION = "Shows the user a live preview of DMS blocks as an attachment in the chat: a card they open to see the real blocks rendered, next to their own mockup when you pass it as `reference`, with one tab per variant. A view may carry a `sketch` instead of (or beside) its `tree`: static HTML and CSS of a custom component you propose, drawn in a sandbox and labelled as not a DMS block, so the user compares it with the DMS option before any code is written. Use it to settle a visual choice before building (DMS block as is versus custom, or between layouts), then ask the decision with AskUser. It returns at once with the preview id; it does not wait for the user and changes nothing in the project.";
+export declare const PREVIEW_MAX_DEPTH = 8;
+export declare const PREVIEW_MAX_NODES = 200;
+export declare const PREVIEW_MAX_VARIANTS = 4;
+export declare const PREVIEW_MAX_ROOTS = 12;
+export declare const PREVIEW_MAX_TITLE_CHARS = 120;
+export declare const PREVIEW_MAX_LABEL_CHARS = 60;
+export declare const PREVIEW_MAX_DESCRIPTION_CHARS = 2000;
+export declare const PREVIEW_MAX_CAPTION_CHARS = 200;
+export declare const PREVIEW_MAX_URL_CHARS = 2048;
+export declare const PREVIEW_MAX_JSON_BYTES: number;
+export declare const PREVIEW_SKETCH_MIN_HEIGHT_PX = 80;
+export declare const PREVIEW_SKETCH_DEFAULT_HEIGHT_PX = 320;
+export declare const PREVIEW_SKETCH_MAX_HEIGHT_PX = 1200;
+export declare const PREVIEW_LATEST_ATTACHMENT_ID = "latest";
+export declare const PREVIEW_SAME_ORIGIN_PATH: RegExp;
+export declare const PREVIEW_REMOTE_URL: RegExp;
+export declare const PREVIEW_IMAGE_MIME_PREFIX = "image/";
+export declare const PREVIEW_URL_OPTION_KEY: RegExp;
+export declare const PREVIEW_ERROR_CODES: {
+    readonly INVALID_TREE: "invalid_tree";
+    readonly TOO_LARGE: "too_large";
+    readonly UNKNOWN_ATTACHMENT: "unknown_attachment";
+    readonly INVALID_URL: "invalid_url";
+    readonly INVALID_SKETCH: "invalid_sketch";
+};
+export declare const PREVIEW_SKETCH_FORBIDDEN: ReadonlyArray<readonly [RegExp, string]>;
+export declare const PREVIEW_RESULT_SHOWN = "Preview shown to the user as an attachment. If it settles a choice, ask it now with AskUser.";
+export declare const PREVIEW_ERROR_NO_TYPE = "Every node needs a `type` (a block type from BuilderCatalog) or a `componentName`.";
+export declare const PREVIEW_ERROR_DEPTH = "The tree is nested deeper than 8 levels.";
+export declare const PREVIEW_ERROR_NODES = "The preview has more than 200 nodes in all; show a smaller part of the page.";
+export declare const PREVIEW_ERROR_BYTES = "The preview's trees and sketches are larger than 65536 bytes of JSON; show a smaller part of the page.";
+export declare const PREVIEW_ERROR_NO_ATTACHMENTS = "The user attached no image in this conversation; leave `reference.attachmentId` out.";
+export declare const PREVIEW_ERROR_UNKNOWN_ATTACHMENT = "No image of that name was attached in this conversation. Attached images: ";
+export declare const PREVIEW_ERROR_OPTION_URL = "Options ending in `Url` (and `location`) must be same-origin paths such as `/api/orders`, or the preview refuses the block. Offending option: ";
+export declare const PREVIEW_ERROR_EMPTY_VIEW = "Every view (the preview and each variant) needs a `tree`, a `sketch`, or both.";
+export declare const PREVIEW_ERROR_SKETCH = "A sketch is static HTML and CSS: inline images and fonts as data: URLs, and use no script, event handler, external resource or embedded frame. Refused: ";
+export declare const PREVIEW_ERROR_URL = "`reference.url` must be a same-origin path (`/media/...`) or an http(s) URL.";