@antelopejs/dms-ai 0.1.6 → 0.2.0

package/frontend-vue/app/chat/utils/render-items.ts

@@ -0,0 +1,164 @@
+import {
+	EXIT_PLAN_MODE_TOOL_NAME,
+	MESSAGE_ROLES,
+} from "../constants/conversation";
+import type {
+	AssistantMessage,
+	ChangeSetMessage,
+	ConversationMessage,
+	ErrorMessage,
+	NoticeMessage,
+	QuestionAnswerMessage,
+	ToolCallMessage,
+	UserMessage,
+} from "../types/conversation";
+import { bareToolName } from "./tool-lexicon";
+import { isTodoWrite } from "./todos";
+
+/** A day boundary in the stream. */
+interface SeparatorItem {
+	kind: "separator";
+	key: string;
+	dayMs: number;
+}
+
+/** The "✦ Assistant" line that opens the agent's side of a turn. */
+interface WhoItem {
+	kind: "who";
+	key: string;
+}
+
+interface MessageItem {
+	kind: "user" | "assistant" | "error" | "notice" | "change" | "answers";
+	key: string;
+	message:
+		| UserMessage
+		| AssistantMessage
+		| ErrorMessage
+		| NoticeMessage
+		| ChangeSetMessage
+		| QuestionAnswerMessage;
+}
+
+interface ToolsItem {
+	kind: "tools";
+	key: string;
+	tools: ToolCallMessage[];
+}
+
+interface PlanItem {
+	kind: "plan";
+	key: string;
+	tool: ToolCallMessage;
+}
+
+export type RenderItem =
+	| SeparatorItem
+	| WhoItem
+	| MessageItem
+	| ToolsItem
+	| PlanItem;
+
+const KIND_BY_ROLE: Record<string, MessageItem["kind"]> = {
+	[MESSAGE_ROLES.USER]: "user",
+	[MESSAGE_ROLES.ASSISTANT]: "assistant",
+	[MESSAGE_ROLES.ERROR]: "error",
+	[MESSAGE_ROLES.NOTICE]: "notice",
+	[MESSAGE_ROLES.CHANGE_SET]: "change",
+	[MESSAGE_ROLES.QUESTION_ANSWER]: "answers",
+};
+
+/** Roles drawn on the agent's side, under one "✦ Assistant" line per turn. */
+const AGENT_ROLES: ReadonlySet<string> = new Set([
+	MESSAGE_ROLES.ASSISTANT,
+	MESSAGE_ROLES.TOOL,
+	MESSAGE_ROLES.CHANGE_SET,
+]);
+
+function startOfDay(ms: number): number {
+	const date = new Date(ms);
+	date.setHours(0, 0, 0, 0);
+	return date.getTime();
+}
+
+function isPlan(message: ConversationMessage): message is ToolCallMessage {
+	return (
+		message.role === MESSAGE_ROLES.TOOL &&
+		bareToolName(message.toolName) === EXIT_PLAN_MODE_TOOL_NAME
+	);
+}
+
+interface Builder {
+	out: RenderItem[];
+	tools: ToolCallMessage[];
+	dayMs: number | null;
+	isAgentTurnOpen: boolean;
+}
+
+function flushTools(builder: Builder): void {
+	if (builder.tools.length === 0) return;
+	const tools = builder.tools;
+	builder.out.push({ kind: "tools", key: `tools-${tools[0].id}`, tools });
+	builder.tools = [];
+}
+
+function markDay(builder: Builder, message: ConversationMessage): void {
+	const day = startOfDay(message.timestampMs);
+	if (builder.dayMs === day) return;
+	builder.dayMs = day;
+	builder.out.push({ kind: "separator", key: `day-${day}`, dayMs: day });
+}
+
+function openAgentTurn(builder: Builder, message: ConversationMessage): void {
+	if (message.role === MESSAGE_ROLES.USER) {
+		builder.isAgentTurnOpen = false;
+		return;
+	}
+	if (builder.isAgentTurnOpen || !AGENT_ROLES.has(message.role)) return;
+	builder.isAgentTurnOpen = true;
+	builder.out.push({ kind: "who", key: `who-${message.id}` });
+}
+
+function place(builder: Builder, message: ConversationMessage): void {
+	if (isTodoWrite(message)) return;
+	if (message.role === MESSAGE_ROLES.TOOL && !isPlan(message)) {
+		builder.tools.push(message);
+		return;
+	}
+	flushTools(builder);
+	if (isPlan(message)) {
+		builder.out.push({ kind: "plan", key: message.id, tool: message });
+		return;
+	}
+	builder.out.push({
+		kind: KIND_BY_ROLE[message.role],
+		key: message.id,
+		message,
+	} as MessageItem);
+}
+
+/**
+ * The stream as drawn: day separators, one "✦ Assistant" line per agent turn,
+ * consecutive tool calls in one cluster, plans as cards, steps left to the
+ * dock.
+ */
+export function buildRenderItems(
+	messages: readonly ConversationMessage[],
+): RenderItem[] {
+	const builder: Builder = {
+		out: [],
+		tools: [],
+		dayMs: null,
+		isAgentTurnOpen: false,
+	};
+	for (const message of messages) {
+		if (message.role === MESSAGE_ROLES.USER) {
+			flushTools(builder);
+			markDay(builder, message);
+		}
+		openAgentTurn(builder, message);
+		place(builder, message);
+	}
+	flushTools(builder);
+	return builder.out;
+}

package/frontend-vue/app/chat/utils/run-status.ts

@@ -1,52 +1,48 @@
 import {
 	ACTIVITY_ELLIPSIS,
 	ACTIVITY_KINDS,
-	ACTIVITY_LABELS,
-	DEFAULT_ACTIVITY_LABEL,
+	ACTIVITY_LABEL_KEYS,
 	QUIET_NOTICE_AFTER_MS,
 	SILENT_ACTIVITIES,
 	STALL_AFTER_MS,
 	TOOL_DETAIL_ACTIVITIES,
 } from "../constants/run-status";
 import type { ActivityKind, RunProgress } from "../types/conversation";
-import { toolLabel } from "./tool-summary";
+import { describeTool, toolVerb } from "./tool-lexicon";
 
-const MS_PER_SECOND = 1_000;
-const SECONDS_PER_MINUTE = 60;
-const SECONDS_WIDTH = 2;
 const DETAIL_SEPARATOR = " · ";
 
 const KNOWN_ACTIVITIES: readonly string[] = Object.values(ACTIVITY_KINDS);
 
+export { formatClock } from "./format";
+
 /** A reported activity, read as thinking when this chat does not know it. */
 export function toActivityKind(reported: string): ActivityKind {
 	if (!KNOWN_ACTIVITIES.includes(reported)) return ACTIVITY_KINDS.THINKING;
 	return reported as ActivityKind;
 }
 
-/** A duration as m:ss. */
-export function formatClock(ms: number): string {
-	const totalSeconds = Math.max(0, Math.floor(ms / MS_PER_SECOND));
-	const minutes = Math.floor(totalSeconds / SECONDS_PER_MINUTE);
-	const seconds = String(totalSeconds % SECONDS_PER_MINUTE).padStart(
-		SECONDS_WIDTH,
-		"0",
-	);
-	return `${minutes}:${seconds}`;
-}
-
-function describeDetail(progress: RunProgress): string {
+function describeDetail(
+	progress: RunProgress,
+	translate: (key: string) => string,
+): string {
 	if (progress.detail === undefined || progress.detail === "") return "";
 	const namesTool = TOOL_DETAIL_ACTIVITIES.includes(progress.activity);
-	const detail = namesTool ? toolLabel(progress.detail) : progress.detail;
+	const detail = namesTool
+		? toolVerb(describeTool(progress.detail, null), translate)
+		: progress.detail;
 	return `${DETAIL_SEPARATOR}${detail}`;
 }
 
 /** The line a running turn shows: what the agent is doing, and on what. */
-export function describeActivity(progress: RunProgress | null): string {
-	if (progress === null) return `${DEFAULT_ACTIVITY_LABEL}${ACTIVITY_ELLIPSIS}`;
-	const label = ACTIVITY_LABELS[progress.activity];
-	return `${label}${describeDetail(progress)}${ACTIVITY_ELLIPSIS}`;
+export function describeActivity(
+	progress: RunProgress | null,
+	translate: (key: string) => string,
+): string {
+	const kind = progress?.activity ?? ACTIVITY_KINDS.THINKING;
+	const label = translate(ACTIVITY_LABEL_KEYS[kind]);
+	const detail = progress === null ? "" : describeDetail(progress, translate);
+	return `${label}${detail}${ACTIVITY_ELLIPSIS}`;
 }
 
 function sinceReport(progress: RunProgress, nowMs: number): number {

package/frontend-vue/app/chat/utils/suggestions.ts

@@ -0,0 +1,101 @@
+import type { CurrentPage } from "../types/conversation";
+
+/** A first request the empty chat offers, about the page on screen. */
+export interface PageSuggestion {
+	icon: string;
+	/** Translation key; takes the page name as `page`. */
+	textKey: string;
+	isReadOnly: boolean;
+}
+
+const TITLE_SEPARATORS = /\s+[·|–—-]\s+/;
+const PATH_SEPARATOR = "/";
+const WORD_SEPARATORS = /[-_]+/g;
+const HOME_PATHS: ReadonlySet<string> = new Set(["", "/", "/home"]);
+const MODULE_PAGE = /^\/modules\/[^/]+/;
+
+const PAGE_SUGGESTIONS: readonly PageSuggestion[] = [
+	{
+		icon: "i-ph-squares-four",
+		textKey: "dms_ai.panel.empty.suggest.add_chart",
+		isReadOnly: false,
+	},
+	{
+		icon: "i-ph-funnel",
+		textKey: "dms_ai.panel.empty.suggest.add_filter",
+		isReadOnly: false,
+	},
+	{
+		icon: "i-ph-question",
+		textKey: "dms_ai.panel.empty.suggest.explain",
+		isReadOnly: true,
+	},
+];
+
+const HOME_SUGGESTIONS: readonly PageSuggestion[] = [
+	{
+		icon: "i-ph-folder-simple-plus",
+		textKey: "dms_ai.panel.empty.suggest.create_page",
+		isReadOnly: false,
+	},
+	{
+		icon: "i-ph-table",
+		textKey: "dms_ai.panel.empty.suggest.create_table",
+		isReadOnly: false,
+	},
+	{
+		icon: "i-ph-question",
+		textKey: "dms_ai.panel.empty.suggest.explain_project",
+		isReadOnly: true,
+	},
+];
+
+const MODULE_SUGGESTIONS: readonly PageSuggestion[] = [
+	{
+		icon: "i-ph-squares-four",
+		textKey: "dms_ai.panel.empty.suggest.add_block",
+		isReadOnly: false,
+	},
+	{
+		icon: "i-ph-pencil-simple-line",
+		textKey: "dms_ai.panel.empty.suggest.rename",
+		isReadOnly: false,
+	},
+	{
+		icon: "i-ph-question",
+		textKey: "dms_ai.panel.empty.suggest.explain",
+		isReadOnly: true,
+	},
+];
+
+function humanize(segment: string): string {
+	const words = decodeURIComponent(segment)
+		.replace(WORD_SEPARATORS, " ")
+		.trim();
+	return words === ""
+		? ""
+		: `${words.charAt(0).toUpperCase()}${words.slice(1)}`;
+}
+
+/** The page's name: its title without the site suffix, else its last path segment. */
+export function pageName(page: CurrentPage | null): string {
+	const title = page?.title?.split(TITLE_SEPARATORS)[0]?.trim() ?? "";
+	if (title !== "") return title;
+	const segments = (page?.path ?? "").split(PATH_SEPARATOR).filter(Boolean);
+	return humanize(segments.at(-1) ?? "");
+}
+
+/** The page's path as the chip shows it, without the leading slash. */
+export function pageChipLabel(page: CurrentPage | null): string {
+	return (page?.path ?? "").replace(/^\/+/, "");
+}
+
+/** Three first requests that fit the page: home, a module page, or any other. */
+export function pageSuggestions(
+	page: CurrentPage | null,
+): readonly PageSuggestion[] {
+	const path = page?.path ?? "";
+	if (HOME_PATHS.has(path)) return HOME_SUGGESTIONS;
+	if (MODULE_PAGE.test(path)) return MODULE_SUGGESTIONS;
+	return PAGE_SUGGESTIONS;
+}

package/frontend-vue/app/chat/utils/todos.ts

@@ -8,7 +8,7 @@ import type {
 	ToolCallMessage,
 } from "../types/conversation";
 
-export type TodoItemStatus = "pending" | "in_progress" | "completed";
+type TodoItemStatus = "pending" | "in_progress" | "completed";
 
 export interface TodoItem {
 	content: string;
@@ -40,7 +40,7 @@ function toTodo(value: unknown): TodoItem | null {
 	return { content, status: toStatus(record.status), activeForm };
 }
 
-export function extractTodos(args: unknown): TodoItem[] {
+function extractTodos(args: unknown): TodoItem[] {
 	if (args === null || typeof args !== "object") return [];
 	const todos = (args as Record<string, unknown>).todos;
 	if (!Array.isArray(todos)) return [];