@antelopejs/dms-ai 0.7.0 → 0.9.0

package/frontend-vue/app/views/composables/useAiData.ts

@@ -40,16 +40,10 @@ interface FetchErrorResponse {
 	status?: number;
 }
 
-interface FetchErrorBody {
-	message?: unknown;
-}
-
 interface FetchErrorLike {
 	status?: number;
 	statusCode?: number;
 	response?: FetchErrorResponse;
-	data?: FetchErrorBody;
-	message?: string;
 }
 
 /** The HTTP status of a `$authFetch` rejection, if it got an answer. */
@@ -60,14 +54,6 @@ function errorStatus(error: unknown): number | undefined {
 	);
 }
 
-/** The server's `{ message }`, else the error's own text. */
-export function errorMessage(error: unknown): string {
-	const candidate = error as FetchErrorLike | null;
-	const serverMessage = candidate?.data?.message;
-	if (typeof serverMessage === "string") return serverMessage;
-	return candidate?.message ?? String(error);
-}
-
 export function classifyFailure(error: unknown): RequestFailure {
 	return errorStatus(error) === HTTP_SERVICE_UNAVAILABLE
 		? "unavailable"
@@ -80,15 +66,21 @@ export function classifyFailure(error: unknown): RequestFailure {
  * whether the assistant isn't running (503) rather than an error.
  */
 function describeFailure(result: FailingRead): FailureDescription {
+	const { resolveError } = useApiErrorPresenter();
+	const notice = computed(() =>
+		result.error.value
+			? resolveError(result.error.value, {
+					fallbackKey: `dms_ai.views.${classifyFailure(result.error.value)}.description`,
+				})
+			: null,
+	);
 	return {
 		failure: computed(() =>
-			result.error.value && result.status.value !== "pending"
+			notice.value && result.status.value !== "pending"
 				? classifyFailure(result.error.value)
 				: null,
 		),
-		message: computed(() =>
-			result.error.value ? errorMessage(result.error.value) : "",
-		),
+		message: computed(() => notice.value?.message ?? ""),
 	};
 }
 

package/frontend-vue/app/views/composables/useChangeSetActions.ts

@@ -1,7 +1,7 @@
 import { ref, type Ref } from "vue";
 import { AI_ROUTES } from "../constants";
 import type { ChangeSetSummary } from "../types";
-import { classifyFailure, errorMessage } from "./useAiData";
+import { classifyFailure } from "./useAiData";
 
 export interface ChangeSetActions {
 	isBusy: Ref<boolean>;
@@ -28,23 +28,11 @@ function changeSetPath(changeSetId: string, action: string): string {
 export function useChangeSetActions(): ChangeSetActions {
 	const { t } = useI18n();
 	const toast = useToast();
+	const { presentError } = useApiErrorPresenter();
 	const { $authFetch } = useAuthFetch();
 	const { confirmFrom } = useConfirmFrom();
 	const isBusy = ref(false);
 
-	function failureToast(error: unknown): void {
-		const failure = classifyFailure(error);
-		toast.add({
-			title: t(`dms_ai.views.${failure}.title`),
-			description:
-				failure === "error"
-					? errorMessage(error)
-					: t("dms_ai.views.unavailable.description"),
-			color: "error",
-			icon: "i-ph-warning-circle",
-		});
-	}
-
 	async function redo(changeSet: ChangeSetSummary): Promise<void> {
 		isBusy.value = true;
 		try {
@@ -59,7 +47,9 @@ export function useChangeSetActions(): ChangeSetActions {
 			});
 			await refreshPageBlocks();
 		} catch (error) {
-			failureToast(error);
+			presentError(error, {
+				fallbackKey: `dms_ai.views.${classifyFailure(error)}.description`,
+			});
 		} finally {
 			isBusy.value = false;
 		}

package/frontend-vue/app/views/constants.ts

@@ -1,5 +1,5 @@
 import type { ActivityResult, AllowedBy } from "./types";
-import type { Tone } from "#dms-ui/app/types/tone";
+import type { Tone } from "#dms-core/app/types/tone";
 
 export const AI_ROUTES = {
 	status: "/ai/status",

package/frontend-vue/app/views/types.ts

@@ -1,4 +1,4 @@
-import type { Tone } from "#dms-ui/app/types/tone";
+import type { Tone } from "#dms-core/app/types/tone";
 
 type AgentId = "claude" | "codex";
 export type ScopeId = "safe" | "vibe";

package/frontend-vue/build/backend-boundary.ts

@@ -1,6 +1,8 @@
 import { existsSync, readFileSync, realpathSync } from "node:fs";
 import { dirname, isAbsolute, join, relative, sep } from "node:path";
-import type { Plugin } from "vite";
+import type { DmsVitePluginEntry } from "#dms/frontend-build";
+
+type VitePlugin = Extract<DmsVitePluginEntry, { name: string }>;
 
 const BACKEND_PACKAGE = "@antelopejs/dms-ai";
 const BACKEND_SOURCE = "src";
@@ -8,20 +10,32 @@ const QUERY_OR_HASH = /[?#].*$/;
 
 const backendRoots = new Map<string, string | null>();
 
+/** Whether a parsed manifest names its package. */
+function isNamedManifest(value: unknown): value is { name: string } {
+	return (
+		typeof value === "object" &&
+		value !== null &&
+		"name" in value &&
+		typeof value.name === "string"
+	);
+}
+
+/** The package name a `package.json` declares, or `undefined`. */
 function packageName(manifest: string): string | undefined {
 	try {
-		const parsed: { name?: string } = JSON.parse(
-			readFileSync(manifest, "utf8"),
-		);
-		return parsed.name;
+		const parsed: unknown = JSON.parse(readFileSync(manifest, "utf8"));
+		return isNamedManifest(parsed) ? parsed.name : undefined;
 	} catch {
 		return undefined;
 	}
 }
 
+/** The directory of the backend package that holds `directory`, or null. */
 function backendRoot(directory: string): string | null {
 	const known = backendRoots.get(directory);
-	if (known !== undefined) return known;
+	if (known !== undefined) {
+		return known;
+	}
 	const manifest = join(directory, "package.json");
 	const parent = dirname(directory);
 	let root: string | null = null;
@@ -38,12 +52,13 @@ function backendRoot(directory: string): string | null {
  * The real path of a resolved module id when it lies under the `src`
  * directory of the backend package, or `undefined`. The package that owns the
  * file decides, not a path, so the answer is the same in the repository and in
- * the workspace the DMS builds the frontend in. Virtual ids and ids that are
- * not files are ignored.
+ * the build workspace. Virtual ids and ids that are not files are ignored.
  */
 function backendSourceFile(id: string): string | undefined {
 	const path = id.replace(QUERY_OR_HASH, "");
-	if (!isAbsolute(path)) return undefined;
+	if (!isAbsolute(path)) {
+		return undefined;
+	}
 	let real: string;
 	try {
 		real = realpathSync(path);
@@ -51,38 +66,56 @@ function backendSourceFile(id: string): string | undefined {
 		return undefined;
 	}
 	const root = backendRoot(dirname(real));
-	if (root === null) return undefined;
+	if (root === null) {
+		return undefined;
+	}
 	return relative(root, real).split(sep)[0] === BACKEND_SOURCE
 		? real
 		: undefined;
 }
 
 /**
- * Fails the build, the dev server and the tests when a module of the frontend
- * resolves to a file under the backend's `src`: the browser reaches the
- * backend only through its HTTP routes. It checks what the whole resolution
- * chain returns, so an alias is seen through and a symlink the resolver
- * returns is followed to its real path, and it runs before the other plugins
- * (`enforce: "pre"`).
+ * Fails the build and the dev server when a module of the frontend resolves to
+ * a file under the `src` of the backend package: the browser reaches the
+ * backend only through its HTTP interface. It checks what the whole resolution
+ * chain returns, an id marked external included, so an alias is seen through
+ * and a symlink the resolver returns is followed to its real path, and it runs
+ * before the other plugins (`enforce: "pre"`). Vite builds workers with their
+ * own plugin list, so the plugin adds itself there too.
+ *
+ * antelopejs-sync writes this file from `@antelopejs/tooling-configs` and
+ * restores it on every run: change the plugin in the pack, not here.
  */
-export function backendBoundary(): Plugin {
+export function backendBoundary(): VitePlugin {
+	return {
+		...boundaryCheck(),
+		config: () => ({ worker: { plugins: () => [boundaryCheck()] } }),
+	};
+}
+
+/** The check alone, as a worker build runs it. */
+function boundaryCheck(): VitePlugin {
 	return {
-		name: "dms-ai:backend-boundary",
+		name: `${BACKEND_PACKAGE}:backend-boundary`,
 		enforce: "pre",
 		async resolveId(source, importer, options) {
 			const resolved = await this.resolve(source, importer, {
 				...options,
 				skipSelf: true,
 			});
-			if (resolved === null || resolved.external) return resolved;
+			if (resolved === null) {
+				return resolved;
+			}
 			const file = backendSourceFile(resolved.id);
-			if (file === undefined) return resolved;
+			if (file === undefined) {
+				return resolved;
+			}
 			const from =
 				importer === undefined
 					? "an entry point"
 					: importer.replace(QUERY_OR_HASH, "");
 			return this.error(
-				`Backend boundary: ${from} imports ${file}, which is under src of ${BACKEND_PACKAGE}. The frontend reaches the backend only through its HTTP routes.`,
+				`Backend boundary: ${from} imports ${file}, which is under the src of ${BACKEND_PACKAGE}. The frontend reaches the backend only through its HTTP interface.`,
 			);
 		},
 	};

package/frontend-vue/i18n/locales/dms-ai-pages-en-GB.json

@@ -314,6 +314,8 @@
 				"BuilderPageStructure": "Read page",
 				"BuilderCreatePage": "Create page",
 				"BuilderConfigurePage": "Configure page",
+				"BuilderComposePage": "Compose page",
+				"BuilderConfigureTableView": "Configure table view",
 				"BuilderDeletePage": "Delete page",
 				"BuilderAddBlock": "Add block",
 				"BuilderConfigureBlock": "Configure block",
@@ -332,6 +334,7 @@
 				"BuilderRemoveField": "Remove field",
 				"BuilderQueryTemplates": "Read query templates",
 				"BuilderAddQuery": "Add query",
+				"BuilderPreviewQuery": "Preview query",
 				"BuilderConfigureQuery": "Configure query",
 				"BuilderRemoveQuery": "Remove query",
 				"UndoChangeSet": "Undo change set",
@@ -462,6 +465,10 @@
 					"high": "High"
 				}
 			},
+			"claude_model": {
+				"label": "Claude model",
+				"description": "The model Claude Code runs on. Thinking sets its reasoning effort."
+			},
 			"mode": {
 				"label": "Approval mode",
 				"description": "What the assistant may do without asking you first.",

package/frontend-vue/i18n/locales/dms-ai-pages-fr-FR.json

@@ -314,6 +314,8 @@
 				"BuilderPageStructure": "Lire une page",
 				"BuilderCreatePage": "Créer une page",
 				"BuilderConfigurePage": "Configurer une page",
+				"BuilderComposePage": "Composer une page",
+				"BuilderConfigureTableView": "Configurer une vue tableau",
 				"BuilderDeletePage": "Supprimer une page",
 				"BuilderAddBlock": "Ajouter un bloc",
 				"BuilderConfigureBlock": "Configurer un bloc",
@@ -332,6 +334,7 @@
 				"BuilderRemoveField": "Retirer un champ",
 				"BuilderQueryTemplates": "Lire les modèles de requêtes",
 				"BuilderAddQuery": "Ajouter une requête",
+				"BuilderPreviewQuery": "Aperçu de la requête",
 				"BuilderConfigureQuery": "Configurer une requête",
 				"BuilderRemoveQuery": "Retirer une requête",
 				"UndoChangeSet": "Annuler un lot de modifications",
@@ -462,6 +465,10 @@
 					"high": "Élevée"
 				}
 			},
+			"claude_model": {
+				"label": "Modèle Claude",
+				"description": "Le modèle sur lequel tourne Claude Code. La réflexion règle son niveau d'effort."
+			},
 			"mode": {
 				"label": "Mode de validation",
 				"description": "Ce que l'assistant peut faire sans vous demander d'abord.",

package/frontend-vue/i18n/locales/dms-ai-panel-en-GB.json

@@ -142,7 +142,9 @@
 				"expired_title": "{tool} request expired.",
 				"expired_text": "“{summary}” was not answered in time, so it was denied at {time} and the assistant was told why.",
 				"question_skipped": "You let the assistant decide “{header}”.",
-				"full_auto_ended": "Full auto ended at {time}. The assistant asks first again."
+				"full_auto_ended": "Full auto ended at {time}. The assistant asks first again.",
+				"model_fallback_title": "Switched to {model}.",
+				"model_fallback_text": "The requested model, {requested}, was refused (unknown, or no access on this plan). This answer comes from {model}, the default model."
 			},
 			"errors": {
 				"turn_title": "The turn stopped.",
@@ -430,6 +432,8 @@
 			"configure_page": "Configure page",
 			"delete_page": "Delete page",
 			"add_block": "Add block",
+			"compose_page": "Compose page",
+			"configure_table_view": "Configure table view",
 			"configure_block": "Configure block",
 			"move_block": "Move block",
 			"remove_block": "Remove block",
@@ -446,6 +450,7 @@
 			"remove_field": "Remove field",
 			"browse_queries": "Browse query templates",
 			"add_query": "Add query",
+			"preview_query": "Preview query",
 			"configure_query": "Configure query",
 			"remove_query": "Remove query",
 			"search_tools": "Load tools",

package/frontend-vue/i18n/locales/dms-ai-panel-fr-FR.json

@@ -142,7 +142,9 @@
 				"expired_title": "Demande « {tool} » expirée.",
 				"expired_text": "« {summary} » est restée sans réponse : elle a été refusée à {time} et l'assistant en a été informé.",
 				"question_skipped": "Vous avez laissé l'assistant décider pour « {header} ».",
-				"full_auto_ended": "Le mode automatique complet a pris fin à {time}. L'assistant redemande avant d'agir."
+				"full_auto_ended": "Le mode automatique complet a pris fin à {time}. L'assistant redemande avant d'agir.",
+				"model_fallback_title": "Passage à {model}.",
+				"model_fallback_text": "Le modèle demandé, {requested}, a été refusé (inconnu, ou sans accès avec cet abonnement). Cette réponse vient de {model}, le modèle par défaut."
 			},
 			"errors": {
 				"turn_title": "Le tour s'est arrêté.",
@@ -430,6 +432,8 @@
 			"configure_page": "Configurer la page",
 			"delete_page": "Supprimer la page",
 			"add_block": "Ajouter un bloc",
+			"compose_page": "Composer une page",
+			"configure_table_view": "Configurer la vue de tableau",
 			"configure_block": "Configurer le bloc",
 			"move_block": "Déplacer le bloc",
 			"remove_block": "Retirer le bloc",
@@ -446,6 +450,7 @@
 			"remove_field": "Retirer le champ",
 			"browse_queries": "Parcourir les modèles de requête",
 			"add_query": "Ajouter une requête",
+			"preview_query": "Aperçu de la requête",
 			"configure_query": "Configurer la requête",
 			"remove_query": "Retirer la requête",
 			"search_tools": "Charger des outils",

package/frontend-vue/tests/assistant-actions.test.ts

@@ -64,6 +64,43 @@ describe("the assistant actions another module's layer injects", () => {
 		]);
 	});
 
+	it("send the prompt as the first message, in plan mode, when asked to", async () => {
+		const harness = createHarness();
+		const panel = await openPanel(harness);
+		publicAssistantActions(shallowRef(harness.session)).startConversation(
+			PROMPT,
+			{ mode: "plan", send: true },
+		);
+		await flushPromises();
+		const started = sentOfType(harness, "hello").at(-1)?.conversationId;
+		expect(sentOfType(harness, "set_conversation_mode")).toEqual([
+			expect.objectContaining({ conversationId: started, mode: "plan" }),
+		]);
+		expect(sentOfType(harness, "user_message")).toEqual([
+			expect.objectContaining({ content: PROMPT }),
+		]);
+		expect((panel.find("textarea").element as HTMLTextAreaElement).value).toBe(
+			"",
+		);
+	});
+
+	it("send the prompt once the stream is up, when the panel opens before it", async () => {
+		const harness = createHarness();
+		await openPanel(harness);
+		harness.setChannelStatus("disconnected");
+		publicAssistantActions(shallowRef(harness.session)).startConversation(
+			PROMPT,
+			{ send: true },
+		);
+		await flushPromises();
+		expect(sentOfType(harness, "user_message")).toEqual([]);
+		harness.setChannelStatus("connected");
+		await flushPromises();
+		expect(sentOfType(harness, "user_message")).toEqual([
+			expect.objectContaining({ content: PROMPT }),
+		]);
+	});
+
 	it("are unavailable without a session, and starting then does nothing", () => {
 		const actions = publicAssistantActions(shallowRef(null));
 		expect(actions.isAvailable).toBe(false);

package/frontend-vue/tests/block-health.test.ts

@@ -0,0 +1,142 @@
+// @vitest-environment jsdom
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import {
+	BLOCK_SETTLE_BUDGET_MS,
+	awaitSettledBlocks,
+	readBlocks,
+} from "../app/runtime/block-health";
+
+function addBlock(
+	state: string,
+	type: string,
+	path?: string,
+	parent: Element = document.body,
+): HTMLElement {
+	const element = document.createElement("div");
+	element.setAttribute("data-dms-block-state", state);
+	element.setAttribute("data-dms-block-type", type);
+	if (path !== undefined) element.setAttribute("data-dms-block", path);
+	parent.append(element);
+	return element;
+}
+
+const never = new AbortController().signal;
+
+describe("readBlocks", () => {
+	beforeEach(() => {
+		document.body.replaceChildren();
+	});
+
+	it("reads the state, kind and layout path each block states on its root", () => {
+		addBlock("empty", "ChartCard", "revenue");
+		addBlock("ok", "KpiCard");
+		document.body.append(document.createElement("section"));
+		expect(readBlocks(document)).toEqual([
+			{ path: "revenue", type: "ChartCard", state: "empty" },
+			{ type: "KpiCard", state: "ok" },
+		]);
+	});
+
+	it("finds none on a host that states nothing", () => {
+		document.body.append(document.createElement("section"));
+		expect(readBlocks(document)).toEqual([]);
+	});
+});
+
+describe("awaitSettledBlocks", () => {
+	beforeEach(() => {
+		document.body.replaceChildren();
+		vi.useFakeTimers();
+	});
+
+	afterEach(() => {
+		vi.useRealTimers();
+	});
+
+	it("reports the blocks showing no data once the page stopped changing", async () => {
+		addBlock("ok", "KpiCard", "orders");
+		addBlock("empty", "ChartCard", "revenue");
+		addBlock("error", "TopListCard", "top");
+		const settled = awaitSettledBlocks({ root: document, signal: never });
+		await vi.advanceTimersByTimeAsync(BLOCK_SETTLE_BUDGET_MS);
+		await expect(settled).resolves.toEqual({
+			status: "settled",
+			checked: 3,
+			blocks: [
+				{ path: "revenue", type: "ChartCard", state: "empty" },
+				{ path: "top", type: "TopListCard", state: "error" },
+			],
+		});
+	});
+
+	it("waits for a loading block and reports what it turned into", async () => {
+		const chart = addBlock("loading", "ChartCard", "revenue");
+		let result: Awaited<ReturnType<typeof awaitSettledBlocks>> | undefined;
+		void awaitSettledBlocks({ root: document, signal: never }).then((value) => {
+			result = value;
+		});
+		await vi.advanceTimersByTimeAsync(4_000);
+		expect(result).toBeUndefined();
+		chart.setAttribute("data-dms-block-state", "empty");
+		await vi.advanceTimersByTimeAsync(4_000);
+		expect(result).toEqual({
+			status: "settled",
+			checked: 1,
+			blocks: [{ path: "revenue", type: "ChartCard", state: "empty" }],
+		});
+	});
+
+	it("waits for a block that mounts after the others settled", async () => {
+		addBlock("ok", "KpiCard", "orders");
+		const settled = awaitSettledBlocks({ root: document, signal: never });
+		await vi.advanceTimersByTimeAsync(300);
+		addBlock("loading", "ChartCard", "late");
+		await vi.advanceTimersByTimeAsync(BLOCK_SETTLE_BUDGET_MS);
+		await expect(settled).resolves.toMatchObject({
+			status: "timeout",
+			checked: 2,
+			blocks: [{ path: "late", type: "ChartCard", state: "loading" }],
+		});
+	});
+
+	it("gives up at the budget and names the blocks still loading", async () => {
+		addBlock("loading", "Chart", "slow");
+		let finishedAt = -1;
+		const started = Date.now();
+		const settled = awaitSettledBlocks({ root: document, signal: never });
+		void settled.then(() => {
+			finishedAt = Date.now() - started;
+		});
+		await vi.advanceTimersByTimeAsync(BLOCK_SETTLE_BUDGET_MS - 1);
+		expect(finishedAt).toBe(-1);
+		await vi.advanceTimersByTimeAsync(1);
+		await expect(settled).resolves.toEqual({
+			status: "timeout",
+			checked: 1,
+			blocks: [{ path: "slow", type: "Chart", state: "loading" }],
+		});
+		expect(finishedAt).toBe(BLOCK_SETTLE_BUDGET_MS);
+	});
+
+	it("reports a page without data blocks as having none", async () => {
+		const settled = awaitSettledBlocks({ root: document, signal: never });
+		await vi.advanceTimersByTimeAsync(BLOCK_SETTLE_BUDGET_MS);
+		await expect(settled).resolves.toEqual({
+			status: "settled",
+			checked: 0,
+			blocks: [],
+		});
+	});
+
+	it("answers at once as superseded when another navigation starts", async () => {
+		addBlock("loading", "Chart", "slow");
+		const controller = new AbortController();
+		const settled = awaitSettledBlocks({
+			root: document,
+			signal: controller.signal,
+		});
+		await vi.advanceTimersByTimeAsync(100);
+		controller.abort();
+		await expect(settled).resolves.toMatchObject({ status: "superseded" });
+	});
+});

package/frontend-vue/tests/chat/conversation-events.test.ts

@@ -220,6 +220,40 @@ describe("the conversation folds the redesign's events", () => {
 		expect(conversation.totalTokens.value).toBe(1_200);
 	});
 
+	it("shows the model that answered, from a usage event or a snapshot", () => {
+		const b = bus();
+		const conversation = useConversation(b.options as never);
+		expect(conversation.model.value).toBeNull();
+		b.receive({ type: "usage", totalTokens: 10, model: "claude-opus-5-5" });
+		expect(conversation.model.value).toBe("claude-opus-5-5");
+		b.receive({
+			type: "conversation_snapshot",
+			messages: [],
+			changeSets: [],
+			totalTokens: 10,
+			model: "claude-sonnet-4-6",
+		});
+		expect(conversation.model.value).toBe("claude-sonnet-4-6");
+	});
+
+	it("keeps the notice that the configured model was refused", () => {
+		const b = bus();
+		const conversation = useConversation(b.options as never);
+		b.receive({
+			type: "notice",
+			notice: {
+				kind: "model_fallback",
+				requestedModel: "claude-opus-5-5",
+				usedModel: "claude-sonnet-4-6",
+				timestampMs: 7,
+			},
+		});
+		expect(conversation.messages.value[0]).toMatchObject({
+			role: "notice",
+			notice: { kind: "model_fallback", usedModel: "claude-sonnet-4-6" },
+		});
+	});
+
 	it("ignores another conversation's events", () => {
 		const b = bus();
 		const conversation = useConversation(b.options as never);

package/frontend-vue/tests/chat/tool-lexicon.test.ts

@@ -68,6 +68,7 @@ describe("the tool lexicon names a call by what it does", () => {
 			"BuilderRemoveField",
 			"BuilderRemoveQuery",
 			"BuilderQueryTemplates",
+			"BuilderPreviewQuery",
 		];
 		for (const name of [...builder, "AskUser", "Typecheck", "NavigateToPage"])
 			expect(describeTool(`mcp__dms-ai__${name}`, {}).verbKey).not.toBeNull();