@happyvertical/smrt-chat 0.55.9 → 0.55.10

package/dist/overview-tools.d.ts

@@ -0,0 +1,221 @@
+/**
+ * Assistant tools for customizable overview pages (#3727 phase 4): the
+ * assistant adds and configures widgets ("add a chart of overdue invoices")
+ * with structured operations, and the person can undo the change.
+ *
+ * The model only ever supplies data: a page id and a list of operations
+ * (`add`, `configure`, `move`, `resize`, `remove`) over the page's closed
+ * option vocabulary. It never names a query, a table or a tenant. Every
+ * authority decision is the host's, made from the live {@link PrincipalRun}:
+ *
+ * - `open(run, pageId)` returns the overview for THIS principal (its
+ *   definition, the principal's stored override, whether the principal may
+ *   customize, and how to persist), or `null` when the page is not offered.
+ * - The surface validates every batch with the overview model and
+ *   `checkOverviewOverride` (smrt-svelte's `createOverviewAssistantSurface`
+ *   is the implementation), so the assistant can only store an override the
+ *   page's own save endpoint would accept. A batch is atomic.
+ * - Undo is single-step and keyed by tenant, user and page: an undo token is
+ *   only ever looked up under the principal that is calling, so one
+ *   principal can never restore another's state.
+ *
+ * This package depends on no UI package, so the surface is typed
+ * structurally.
+ *
+ * @module
+ */
+import { type PrincipalRun, type PrincipalTool } from '@happyvertical/smrt-agents';
+/** Tool slug (permission/allow-list name) for describing an overview. */
+export declare const OVERVIEW_DESCRIBE_TOOL_SLUG = "overviews.describe";
+/** Tool slug for applying a batch of operations. */
+export declare const OVERVIEW_APPLY_TOOL_SLUG = "overviews.apply";
+/** Tool slug for undoing the last applied batch. */
+export declare const OVERVIEW_UNDO_TOOL_SLUG = "overviews.undo";
+/** Provider function name for {@link OVERVIEW_DESCRIBE_TOOL_SLUG}. */
+export declare const OVERVIEW_DESCRIBE_FUNCTION_NAME = "overviews-describe";
+/** Provider function name for {@link OVERVIEW_APPLY_TOOL_SLUG}. */
+export declare const OVERVIEW_APPLY_FUNCTION_NAME = "overviews-apply";
+/** Provider function name for {@link OVERVIEW_UNDO_TOOL_SLUG}. */
+export declare const OVERVIEW_UNDO_FUNCTION_NAME = "overviews-undo";
+/** Default cap on operations in one batch (matches smrt-svelte's). */
+export declare const OVERVIEW_TOOL_MAX_OPERATIONS = 20;
+/** A plan result, as the surface returns it. */
+export type OverviewToolPlan = {
+    ok: true;
+    override: unknown;
+    document: unknown;
+    results: readonly unknown[];
+    unchanged?: boolean;
+} | {
+    ok: false;
+    issues: readonly unknown[];
+};
+/** A save-style check of an override, as the surface returns it. */
+export type OverviewToolCheck = {
+    ok: true;
+    override: unknown;
+} | {
+    ok: false;
+    issues: readonly unknown[];
+};
+/**
+ * One overview for one principal. smrt-svelte's
+ * `createOverviewAssistantSurface` (on `./overview/server`) implements it.
+ */
+export interface OverviewToolSurface {
+    readonly pageId: string;
+    /** Whether this principal may customize the page (the role gate). */
+    readonly canCustomize: boolean;
+    /** Allowed widget types with their option fields, and the arrangement. */
+    describe(): unknown;
+    /** The canonical override in effect (`null` = defaults). */
+    current(): unknown;
+    /** Validate and plan a batch against {@link current}. Applies nothing. */
+    plan(operations: unknown): OverviewToolPlan;
+    /** Validate an override the way a save is validated. */
+    check(override: unknown): OverviewToolCheck;
+    /**
+     * Persist a canonical override in the principal's tier, CONDITIONALLY: only
+     * if the stored value is still the one this surface loaded (its revision).
+     * A save that landed since the surface was opened must answer
+     * `{ ok: false, reason: 'conflict' }`, never be overwritten. On success the
+     * surface's `current()` and revision follow the written value.
+     */
+    persist(override: unknown): Promise<OverviewToolPersistResult>;
+}
+/**
+ * Outcome of {@link OverviewToolSurface.persist}. Structurally the phase-3
+ * store's save result (`OverviewSaveResult` of `@happyvertical/smrt-preferences`'
+ * `createOverviewStore`).
+ */
+export type OverviewToolPersistResult = {
+    ok: true;
+} | {
+    ok: false;
+    reason: 'conflict' | 'not_allowed' | 'invalid';
+    issues?: readonly unknown[];
+};
+/** The application side: which overviews a principal may reach. */
+export interface OverviewToolsHost {
+    /**
+     * The page for this principal, or `null` when it is unknown or not offered
+     * to them. Build the surface from the principal's own stored override and
+     * role; never from model input other than the page id. Scope every read
+     * and the surface's `persist` by `run.context.tenantId` (with tenancy on,
+     * the tools call `open` and every surface method inside that tenant's
+     * context and refuse a run without one).
+     */
+    open(run: PrincipalRun, pageId: string): OverviewToolSurface | null | Promise<OverviewToolSurface | null>;
+    /** Overview pages offered to this principal (for `describe` without a page). */
+    pages?(run: PrincipalRun): ReadonlyArray<{
+        id: string;
+        title?: string;
+    }> | Promise<ReadonlyArray<{
+        id: string;
+        title?: string;
+    }>>;
+}
+/** What Undo restores: the override before the last applied batch. */
+export interface OverviewUndoEntry {
+    token: string;
+    before: unknown;
+    after: unknown;
+    /**
+     * When the batch's conditional write succeeded (epoch ms, strictly
+     * increasing within a process). Orders entries for
+     * {@link OverviewUndoStore.set} and drives expiry.
+     */
+    createdAt: number;
+}
+/**
+ * Where undo entries live, keyed by an opaque principal-and-page key the
+ * tools compute. The default is in-process memory; a multi-replica host
+ * passes a shared store (for example the assistant session context).
+ */
+export interface OverviewUndoStore {
+    get(key: string): OverviewUndoEntry | undefined | Promise<OverviewUndoEntry | undefined>;
+    /**
+     * Conditional set: store `entry` under `key` unless the stored entry is
+     * NEWER (a larger `createdAt`); then it is a no-op. Overlapping applies for
+     * one principal and page can finish their entry writes out of order, and an
+     * older apply's late write must not replace the newer batch's entry. A
+     * shared store implements this atomically (for example a conditional
+     * upsert on `createdAt`).
+     */
+    set(key: string, entry: OverviewUndoEntry): void | Promise<void>;
+    /**
+     * Compare-and-delete: remove the entry under `key` ONLY if its `token` is
+     * `token`; a no-op otherwise. An undo that finishes after a newer batch
+     * stored its own entry under the same key must not remove that entry. A
+     * shared store implements this atomically (for example a conditional
+     * delete on the token).
+     */
+    delete(key: string, token: string): void | Promise<void>;
+}
+/** Agent-level audit record of an overview change. */
+export interface OverviewToolAuditEntry {
+    action: 'apply' | 'undo';
+    userId: string;
+    tenantId: string | null;
+    pageId: string;
+    operations?: number;
+}
+export interface OverviewToolsOptions {
+    host: OverviewToolsHost;
+    /**
+     * Where undo entries live. It must outlive a request and a turn. Defaults
+     * to {@link defaultOverviewUndoStore} (process-wide memory); pass a shared
+     * store when several replicas serve one assistant.
+     */
+    undoStore?: OverviewUndoStore;
+    audit?: (entry: OverviewToolAuditEntry) => void | Promise<void>;
+    /** Batch cap (default 20); keep it equal to the surface's. */
+    maxOperations?: number;
+    /** Token source (tests). Defaults to `crypto.randomUUID`. */
+    createToken?: () => string;
+    /**
+     * Receives best-effort failures after a change was stored (undo entry,
+     * audit). Defaults to `console.warn`; route it to the host's logger.
+     */
+    onError?: (error: unknown, context: string) => void;
+}
+/**
+ * A tool refusal the loop classifies by `status`: 422/404/409 are repairable
+ * (`invalid_request`, the model sees `publicMessage`), 403 is `not_permitted`.
+ */
+export declare class OverviewToolError extends Error {
+    readonly status: number;
+    readonly code: string;
+    readonly publicMessage: string;
+    readonly issues: readonly unknown[];
+    constructor(status: number, code: string, message: string, issues?: readonly unknown[]);
+}
+/**
+ * In-process undo store: single entry per key, expiring after `ttlMs`
+ * (default 30 minutes), at most `maxEntries` keys (oldest dropped).
+ */
+export declare function createMemoryOverviewUndoStore(options?: {
+    ttlMs?: number;
+    maxEntries?: number;
+    now?: () => number;
+}): OverviewUndoStore;
+/**
+ * The process-wide in-memory undo store `createOverviewTools` uses when no
+ * `undoStore` is passed. It outlives every tool set, so tools built per turn
+ * (`extraTools: (context) => createOverviewTools(...)`) can undo a batch an
+ * earlier turn applied. Keys carry tenant, user and page, so sharing it is
+ * safe; it is per process, so a multi-replica host passes a shared store.
+ */
+export declare function defaultOverviewUndoStore(): OverviewUndoStore;
+/** "#2 add: widget type "map" is not registered; ..." for the model. */
+export declare function formatOverviewIssues(issues: readonly unknown[]): string;
+/**
+ * Build the overview assistant tools. Offer them through `extraTools`; each
+ * is gated by the same fail-closed `allowedTools` offer and execution gates
+ * as every other principal tool.
+ *
+ * @param options - The host adapter, undo store, audit sink and batch cap.
+ * @returns The `describe`, `apply` and `undo` principal tools.
+ */
+export declare function createOverviewTools(options: OverviewToolsOptions): PrincipalTool[];
+//# sourceMappingURL=overview-tools.d.ts.map

package/dist/overview-tools.d.ts.map

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

package/dist/playground.d.ts

@@ -1,2 +1,2 @@
-export { default } from './svelte/playground.js';
+export { chatRoomsFixture, default } from './svelte/playground.js';
 //# sourceMappingURL=playground.d.ts.map

package/dist/playground.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"playground.d.ts","sourceRoot":"","sources":["../src/playground.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"playground.d.ts","sourceRoot":"","sources":["../src/playground.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/playground.js

@@ -1,91 +1,93 @@
 import { CHAT_MODULE_META } from "./ui.js";
 //#region src/svelte/playground.ts
 var noop = () => {};
-var sampleRooms = [
-	{
-		id: "room-editorial",
-		name: "Editorial Ops",
-		description: "Daily coordination room",
-		roomType: "public",
-		topic: "Launch readiness and governance",
-		participantCount: 8,
-		unreadCount: 4,
-		lastMessageAt: "2026-03-21T16:08:00.000Z",
-		lastMessage: {
-			id: "room-editorial-last",
-			roomId: "room-editorial",
-			senderProfileId: "profile-taylor",
-			senderName: "Taylor Rowan",
-			content: "Content QA is clear for tonight’s publication window.",
-			messageType: "text",
-			role: "user",
-			isEdited: false,
-			isDeleted: false,
-			reactions: [],
-			attachments: [],
-			createdAt: "2026-03-21T16:08:00.000Z"
+var chatRoomsFixture = {
+	rooms: [
+		{
+			id: "room-editorial",
+			name: "Editorial Ops",
+			description: "Daily coordination room",
+			roomType: "public",
+			topic: "Launch readiness and governance",
+			participantCount: 8,
+			unreadCount: 4,
+			lastMessageAt: "2026-03-21T16:08:00.000Z",
+			lastMessage: {
+				id: "room-editorial-last",
+				roomId: "room-editorial",
+				senderProfileId: "profile-taylor",
+				senderName: "Taylor Rowan",
+				content: "Content QA is clear for tonight’s publication window.",
+				messageType: "text",
+				role: "user",
+				isEdited: false,
+				isDeleted: false,
+				reactions: [],
+				attachments: [],
+				createdAt: "2026-03-21T16:08:00.000Z"
+			}
+		},
+		{
+			id: "room-governance",
+			name: "Governance",
+			description: "Policy review",
+			roomType: "agent",
+			topic: "Publication profile monitoring",
+			participantCount: 3,
+			unreadCount: 1,
+			isPinned: true,
+			lastMessageAt: "2026-03-21T15:55:00.000Z"
+		},
+		{
+			id: "room-jordan",
+			name: "Jordan Lee",
+			description: "Direct message",
+			roomType: "dm",
+			topic: "",
+			participantCount: 2,
+			unreadCount: 0,
+			lastMessageAt: "2026-03-21T14:12:00.000Z"
 		}
-	},
-	{
-		id: "room-governance",
-		name: "Governance",
-		description: "Policy review",
-		roomType: "agent",
-		topic: "Publication profile monitoring",
-		participantCount: 3,
-		unreadCount: 1,
-		isPinned: true,
-		lastMessageAt: "2026-03-21T15:55:00.000Z"
-	},
-	{
-		id: "room-jordan",
-		name: "Jordan Lee",
-		description: "Direct message",
-		roomType: "dm",
-		topic: "",
-		participantCount: 2,
-		unreadCount: 0,
-		lastMessageAt: "2026-03-21T14:12:00.000Z"
-	}
-];
-var sampleMessages = [{
-	id: "chat-message-1",
-	roomId: "room-editorial",
-	senderProfileId: "profile-taylor",
-	senderName: "Taylor Rowan",
-	content: "The editorial checklist is ready for review.",
-	messageType: "text",
-	role: "user",
-	isEdited: false,
-	isDeleted: false,
-	replyTo: null,
-	reactions: [{
-		emoji: "✅",
-		count: 2,
-		reacted: true,
-		profileIds: ["profile-taylor", "profile-jordan"]
-	}],
-	attachments: [],
-	createdAt: "2026-03-21T15:52:00.000Z"
-}, {
-	id: "chat-message-2",
-	roomId: "room-editorial",
-	senderProfileId: "profile-jordan",
-	senderName: "Jordan Lee",
-	content: "I’ll verify the governance states and flag anything that needs attention.",
-	messageType: "text",
-	role: "user",
-	isEdited: false,
-	isDeleted: false,
-	replyTo: {
+	],
+	messages: [{
 		id: "chat-message-1",
+		roomId: "room-editorial",
+		senderProfileId: "profile-taylor",
 		senderName: "Taylor Rowan",
-		content: "The editorial checklist is ready for review."
-	},
-	reactions: [],
-	attachments: [],
-	createdAt: "2026-03-21T15:58:00.000Z"
-}];
+		content: "The editorial checklist is ready for review.",
+		messageType: "text",
+		role: "user",
+		isEdited: false,
+		isDeleted: false,
+		replyTo: null,
+		reactions: [{
+			emoji: "✅",
+			count: 2,
+			reacted: true,
+			profileIds: ["profile-taylor", "profile-jordan"]
+		}],
+		attachments: [],
+		createdAt: "2026-03-21T15:52:00.000Z"
+	}, {
+		id: "chat-message-2",
+		roomId: "room-editorial",
+		senderProfileId: "profile-jordan",
+		senderName: "Jordan Lee",
+		content: "I’ll verify the governance states and flag anything that needs attention.",
+		messageType: "text",
+		role: "user",
+		isEdited: false,
+		isDeleted: false,
+		replyTo: {
+			id: "chat-message-1",
+			senderName: "Taylor Rowan",
+			content: "The editorial checklist is ready for review."
+		},
+		reactions: [],
+		attachments: [],
+		createdAt: "2026-03-21T15:58:00.000Z"
+	}]
+};
 var loadMessageInput = () => import("./svelte/components/messages/MessageInput.svelte");
 var loadMessageList = () => import("./svelte/components/messages/MessageList.svelte");
 var loadRoomList = () => import("./svelte/components/layout/RoomList.svelte");
@@ -102,12 +104,15 @@ var playground_default = {
 			loadComponent: loadRoomList,
 			order: 1,
 			props: {
-				rooms: sampleRooms,
+				rooms: chatRoomsFixture.rooms,
 				currentRoomId: "room-editorial",
 				onselectroom: noop,
 				oncreateroom: noop
 			},
-			modes: { mock: { label: "Mock" } }
+			modes: { mock: {
+				label: "Static mock fixture",
+				description: "Static room data only; no live chat service is connected."
+			} }
 		},
 		{
 			id: "message-list",
@@ -116,12 +121,15 @@ var playground_default = {
 			loadComponent: loadMessageList,
 			order: 2,
 			props: {
-				messages: sampleMessages,
+				messages: chatRoomsFixture.messages,
 				currentProfileId: "profile-taylor",
 				onreply: noop,
 				onreact: noop
 			},
-			modes: { mock: { label: "Mock" } }
+			modes: { mock: {
+				label: "Static mock fixture",
+				description: "Static transcript data only; no live chat service is connected."
+			} }
 		},
 		{
 			id: "message-input",
@@ -139,11 +147,14 @@ var playground_default = {
 				},
 				oncancelreply: noop
 			},
-			modes: { mock: { label: "Mock" } }
+			modes: { mock: {
+				label: "Static mock fixture",
+				description: "Static composer state only; no live chat service is connected."
+			} }
 		}
 	]
 };
 //#endregion
-export { playground_default as default };
+export { chatRoomsFixture, playground_default as default };
 
 //# sourceMappingURL=playground.js.map

package/dist/playground.js.map

@@ -1 +1 @@
-{"version":3,"file":"playground.js","names":[],"sources":["../src/svelte/playground.ts"],"sourcesContent":["import { CHAT_MODULE_META } from '../ui.js';\n\nconst noop = () => {};\n\nconst sampleRooms = [\n  {\n    id: 'room-editorial',\n    name: 'Editorial Ops',\n    description: 'Daily coordination room',\n    roomType: 'public',\n    topic: 'Launch readiness and governance',\n    participantCount: 8,\n    unreadCount: 4,\n    lastMessageAt: '2026-03-21T16:08:00.000Z',\n    lastMessage: {\n      id: 'room-editorial-last',\n      roomId: 'room-editorial',\n      senderProfileId: 'profile-taylor',\n      senderName: 'Taylor Rowan',\n      content: 'Content QA is clear for tonight’s publication window.',\n      messageType: 'text',\n      role: 'user',\n      isEdited: false,\n      isDeleted: false,\n      reactions: [],\n      attachments: [],\n      createdAt: '2026-03-21T16:08:00.000Z',\n    },\n  },\n  {\n    id: 'room-governance',\n    name: 'Governance',\n    description: 'Policy review',\n    roomType: 'agent',\n    topic: 'Publication profile monitoring',\n    participantCount: 3,\n    unreadCount: 1,\n    isPinned: true,\n    lastMessageAt: '2026-03-21T15:55:00.000Z',\n  },\n  {\n    id: 'room-jordan',\n    name: 'Jordan Lee',\n    description: 'Direct message',\n    roomType: 'dm',\n    topic: '',\n    participantCount: 2,\n    unreadCount: 0,\n    lastMessageAt: '2026-03-21T14:12:00.000Z',\n  },\n];\n\nconst sampleMessages = [\n  {\n    id: 'chat-message-1',\n    roomId: 'room-editorial',\n    senderProfileId: 'profile-taylor',\n    senderName: 'Taylor Rowan',\n    content: 'The editorial checklist is ready for review.',\n    messageType: 'text',\n    role: 'user',\n    isEdited: false,\n    isDeleted: false,\n    replyTo: null,\n    reactions: [\n      {\n        emoji: '✅',\n        count: 2,\n        reacted: true,\n        profileIds: ['profile-taylor', 'profile-jordan'],\n      },\n    ],\n    attachments: [],\n    createdAt: '2026-03-21T15:52:00.000Z',\n  },\n  {\n    id: 'chat-message-2',\n    roomId: 'room-editorial',\n    senderProfileId: 'profile-jordan',\n    senderName: 'Jordan Lee',\n    content:\n      'I’ll verify the governance states and flag anything that needs attention.',\n    messageType: 'text',\n    role: 'user',\n    isEdited: false,\n    isDeleted: false,\n    replyTo: {\n      id: 'chat-message-1',\n      senderName: 'Taylor Rowan',\n      content: 'The editorial checklist is ready for review.',\n    },\n    reactions: [],\n    attachments: [],\n    createdAt: '2026-03-21T15:58:00.000Z',\n  },\n];\n\nconst loadMessageInput = () =>\n  import('./components/messages/MessageInput.svelte');\nconst loadMessageList = () =>\n  import('./components/messages/MessageList.svelte');\nconst loadRoomList = () => import('./components/layout/RoomList.svelte');\n\nexport default {\n  packageName: '@happyvertical/smrt-chat',\n  displayName: CHAT_MODULE_META.displayName,\n  description: CHAT_MODULE_META.description,\n  moduleMeta: CHAT_MODULE_META,\n  entries: [\n    {\n      id: 'room-list',\n      title: 'Room List',\n      description:\n        'Sidebar navigation for rooms, DMs, and agent conversations with unread state.',\n      loadComponent: loadRoomList,\n      order: 1,\n      props: {\n        rooms: sampleRooms,\n        currentRoomId: 'room-editorial',\n        onselectroom: noop,\n        oncreateroom: noop,\n      },\n      modes: {\n        mock: {\n          label: 'Mock',\n        },\n      },\n    },\n    {\n      id: 'message-list',\n      title: 'Message List',\n      description:\n        'Grouped chat transcript with replies and reactions for a conversation thread.',\n      loadComponent: loadMessageList,\n      order: 2,\n      props: {\n        messages: sampleMessages,\n        currentProfileId: 'profile-taylor',\n        onreply: noop,\n        onreact: noop,\n      },\n      modes: {\n        mock: {\n          label: 'Mock',\n        },\n      },\n    },\n    {\n      id: 'message-input',\n      title: 'Message Input',\n      description:\n        'Chat composer with reply context and keyboard send affordance.',\n      loadComponent: loadMessageInput,\n      order: 3,\n      props: {\n        onsend: noop,\n        placeholder: 'Reply to Editorial Ops…',\n        replyTo: {\n          id: 'chat-message-1',\n          senderName: 'Taylor Rowan',\n          content: 'The editorial checklist is ready for review.',\n        },\n        oncancelreply: noop,\n      },\n      modes: {\n        mock: {\n          label: 'Mock',\n        },\n      },\n    },\n  ],\n};\n"],"mappings":";;AAEA,IAAM,aAAa,CAAC;AAEpB,IAAM,cAAc;CAClB;EACE,IAAI;EACJ,MAAM;EACN,aAAa;EACb,UAAU;EACV,OAAO;EACP,kBAAkB;EAClB,aAAa;EACb,eAAe;EACf,aAAa;GACX,IAAI;GACJ,QAAQ;GACR,iBAAiB;GACjB,YAAY;GACZ,SAAS;GACT,aAAa;GACb,MAAM;GACN,UAAU;GACV,WAAW;GACX,WAAW,CAAC;GACZ,aAAa,CAAC;GACd,WAAW;EACb;CACF;CACA;EACE,IAAI;EACJ,MAAM;EACN,aAAa;EACb,UAAU;EACV,OAAO;EACP,kBAAkB;EAClB,aAAa;EACb,UAAU;EACV,eAAe;CACjB;CACA;EACE,IAAI;EACJ,MAAM;EACN,aAAa;EACb,UAAU;EACV,OAAO;EACP,kBAAkB;EAClB,aAAa;EACb,eAAe;CACjB;AACF;AAEA,IAAM,iBAAiB,CACrB;CACE,IAAI;CACJ,QAAQ;CACR,iBAAiB;CACjB,YAAY;CACZ,SAAS;CACT,aAAa;CACb,MAAM;CACN,UAAU;CACV,WAAW;CACX,SAAS;CACT,WAAW,CACT;EACE,OAAO;EACP,OAAO;EACP,SAAS;EACT,YAAY,CAAC,kBAAkB,gBAAgB;CACjD,CACF;CACA,aAAa,CAAC;CACd,WAAW;AACb,GACA;CACE,IAAI;CACJ,QAAQ;CACR,iBAAiB;CACjB,YAAY;CACZ,SACE;CACF,aAAa;CACb,MAAM;CACN,UAAU;CACV,WAAW;CACX,SAAS;EACP,IAAI;EACJ,YAAY;EACZ,SAAS;CACX;CACA,WAAW,CAAC;CACZ,aAAa,CAAC;CACd,WAAW;AACb,CACF;AAEA,IAAM,yBACJ,OAAO;AACT,IAAM,wBACJ,OAAO;AACT,IAAM,qBAAqB,OAAO;AAElC,IAAA,qBAAe;CACb,aAAa;CACb,aAAa,iBAAiB;CAC9B,aAAa,iBAAiB;CAC9B,YAAY;CACZ,SAAS;EACP;GACE,IAAI;GACJ,OAAO;GACP,aACE;GACF,eAAe;GACf,OAAO;GACP,OAAO;IACL,OAAO;IACP,eAAe;IACf,cAAc;IACd,cAAc;GAChB;GACA,OAAO,EACL,MAAM,EACJ,OAAO,OACT,EACF;EACF;EACA;GACE,IAAI;GACJ,OAAO;GACP,aACE;GACF,eAAe;GACf,OAAO;GACP,OAAO;IACL,UAAU;IACV,kBAAkB;IAClB,SAAS;IACT,SAAS;GACX;GACA,OAAO,EACL,MAAM,EACJ,OAAO,OACT,EACF;EACF;EACA;GACE,IAAI;GACJ,OAAO;GACP,aACE;GACF,eAAe;GACf,OAAO;GACP,OAAO;IACL,QAAQ;IACR,aAAa;IACb,SAAS;KACP,IAAI;KACJ,YAAY;KACZ,SAAS;IACX;IACA,eAAe;GACjB;GACA,OAAO,EACL,MAAM,EACJ,OAAO,OACT,EACF;EACF;CACF;AACF"}
+{"version":3,"file":"playground.js","names":[],"sources":["../src/svelte/playground.ts"],"sourcesContent":["import { CHAT_MODULE_META } from '../ui.js';\n\nconst noop = () => {};\n\nconst sampleRooms = [\n  {\n    id: 'room-editorial',\n    name: 'Editorial Ops',\n    description: 'Daily coordination room',\n    roomType: 'public',\n    topic: 'Launch readiness and governance',\n    participantCount: 8,\n    unreadCount: 4,\n    lastMessageAt: '2026-03-21T16:08:00.000Z',\n    lastMessage: {\n      id: 'room-editorial-last',\n      roomId: 'room-editorial',\n      senderProfileId: 'profile-taylor',\n      senderName: 'Taylor Rowan',\n      content: 'Content QA is clear for tonight’s publication window.',\n      messageType: 'text',\n      role: 'user',\n      isEdited: false,\n      isDeleted: false,\n      reactions: [],\n      attachments: [],\n      createdAt: '2026-03-21T16:08:00.000Z',\n    },\n  },\n  {\n    id: 'room-governance',\n    name: 'Governance',\n    description: 'Policy review',\n    roomType: 'agent',\n    topic: 'Publication profile monitoring',\n    participantCount: 3,\n    unreadCount: 1,\n    isPinned: true,\n    lastMessageAt: '2026-03-21T15:55:00.000Z',\n  },\n  {\n    id: 'room-jordan',\n    name: 'Jordan Lee',\n    description: 'Direct message',\n    roomType: 'dm',\n    topic: '',\n    participantCount: 2,\n    unreadCount: 0,\n    lastMessageAt: '2026-03-21T14:12:00.000Z',\n  },\n];\n\nconst sampleMessages = [\n  {\n    id: 'chat-message-1',\n    roomId: 'room-editorial',\n    senderProfileId: 'profile-taylor',\n    senderName: 'Taylor Rowan',\n    content: 'The editorial checklist is ready for review.',\n    messageType: 'text',\n    role: 'user',\n    isEdited: false,\n    isDeleted: false,\n    replyTo: null,\n    reactions: [\n      {\n        emoji: '✅',\n        count: 2,\n        reacted: true,\n        profileIds: ['profile-taylor', 'profile-jordan'],\n      },\n    ],\n    attachments: [],\n    createdAt: '2026-03-21T15:52:00.000Z',\n  },\n  {\n    id: 'chat-message-2',\n    roomId: 'room-editorial',\n    senderProfileId: 'profile-jordan',\n    senderName: 'Jordan Lee',\n    content:\n      'I’ll verify the governance states and flag anything that needs attention.',\n    messageType: 'text',\n    role: 'user',\n    isEdited: false,\n    isDeleted: false,\n    replyTo: {\n      id: 'chat-message-1',\n      senderName: 'Taylor Rowan',\n      content: 'The editorial checklist is ready for review.',\n    },\n    reactions: [],\n    attachments: [],\n    createdAt: '2026-03-21T15:58:00.000Z',\n  },\n];\n\n/**\n * Browser-safe static fixture for hosts demonstrating the chat.rooms recipe.\n * It is intentionally mock data and does not connect to ChatService.\n */\nexport const chatRoomsFixture = {\n  rooms: sampleRooms,\n  messages: sampleMessages,\n};\n\nconst loadMessageInput = () =>\n  import('./components/messages/MessageInput.svelte');\nconst loadMessageList = () =>\n  import('./components/messages/MessageList.svelte');\nconst loadRoomList = () => import('./components/layout/RoomList.svelte');\n\nexport default {\n  packageName: '@happyvertical/smrt-chat',\n  displayName: CHAT_MODULE_META.displayName,\n  description: CHAT_MODULE_META.description,\n  moduleMeta: CHAT_MODULE_META,\n  entries: [\n    {\n      id: 'room-list',\n      title: 'Room List',\n      description:\n        'Sidebar navigation for rooms, DMs, and agent conversations with unread state.',\n      loadComponent: loadRoomList,\n      order: 1,\n      props: {\n        rooms: chatRoomsFixture.rooms,\n        currentRoomId: 'room-editorial',\n        onselectroom: noop,\n        oncreateroom: noop,\n      },\n      modes: {\n        mock: {\n          label: 'Static mock fixture',\n          description:\n            'Static room data only; no live chat service is connected.',\n        },\n      },\n    },\n    {\n      id: 'message-list',\n      title: 'Message List',\n      description:\n        'Grouped chat transcript with replies and reactions for a conversation thread.',\n      loadComponent: loadMessageList,\n      order: 2,\n      props: {\n        messages: chatRoomsFixture.messages,\n        currentProfileId: 'profile-taylor',\n        onreply: noop,\n        onreact: noop,\n      },\n      modes: {\n        mock: {\n          label: 'Static mock fixture',\n          description:\n            'Static transcript data only; no live chat service is connected.',\n        },\n      },\n    },\n    {\n      id: 'message-input',\n      title: 'Message Input',\n      description:\n        'Chat composer with reply context and keyboard send affordance.',\n      loadComponent: loadMessageInput,\n      order: 3,\n      props: {\n        onsend: noop,\n        placeholder: 'Reply to Editorial Ops…',\n        replyTo: {\n          id: 'chat-message-1',\n          senderName: 'Taylor Rowan',\n          content: 'The editorial checklist is ready for review.',\n        },\n        oncancelreply: noop,\n      },\n      modes: {\n        mock: {\n          label: 'Static mock fixture',\n          description:\n            'Static composer state only; no live chat service is connected.',\n        },\n      },\n    },\n  ],\n};\n"],"mappings":";;AAEA,IAAM,aAAa,CAAC;AAmGb,IAAM,mBAAmB;CAC9B,OAAO;EAjGP;GACE,IAAI;GACJ,MAAM;GACN,aAAa;GACb,UAAU;GACV,OAAO;GACP,kBAAkB;GAClB,aAAa;GACb,eAAe;GACf,aAAa;IACX,IAAI;IACJ,QAAQ;IACR,iBAAiB;IACjB,YAAY;IACZ,SAAS;IACT,aAAa;IACb,MAAM;IACN,UAAU;IACV,WAAW;IACX,WAAW,CAAC;IACZ,aAAa,CAAC;IACd,WAAW;GACb;EACF;EACA;GACE,IAAI;GACJ,MAAM;GACN,aAAa;GACb,UAAU;GACV,OAAO;GACP,kBAAkB;GAClB,aAAa;GACb,UAAU;GACV,eAAe;EACjB;EACA;GACE,IAAI;GACJ,MAAM;GACN,aAAa;GACb,UAAU;GACV,OAAO;GACP,kBAAkB;GAClB,aAAa;GACb,eAAe;EACjB;CAqDO;CACP,UAAU,CAlDV;EACE,IAAI;EACJ,QAAQ;EACR,iBAAiB;EACjB,YAAY;EACZ,SAAS;EACT,aAAa;EACb,MAAM;EACN,UAAU;EACV,WAAW;EACX,SAAS;EACT,WAAW,CACT;GACE,OAAO;GACP,OAAO;GACP,SAAS;GACT,YAAY,CAAC,kBAAkB,gBAAgB;EACjD,CACF;EACA,aAAa,CAAC;EACd,WAAW;CACb,GACA;EACE,IAAI;EACJ,QAAQ;EACR,iBAAiB;EACjB,YAAY;EACZ,SACE;EACF,aAAa;EACb,MAAM;EACN,UAAU;EACV,WAAW;EACX,SAAS;GACP,IAAI;GACJ,YAAY;GACZ,SAAS;EACX;EACA,WAAW,CAAC;EACZ,aAAa,CAAC;EACd,WAAW;CACb,CASU;AACZ;AAEA,IAAM,yBACJ,OAAO;AACT,IAAM,wBACJ,OAAO;AACT,IAAM,qBAAqB,OAAO;AAElC,IAAA,qBAAe;CACb,aAAa;CACb,aAAa,iBAAiB;CAC9B,aAAa,iBAAiB;CAC9B,YAAY;CACZ,SAAS;EACP;GACE,IAAI;GACJ,OAAO;GACP,aACE;GACF,eAAe;GACf,OAAO;GACP,OAAO;IACL,OAAO,iBAAiB;IACxB,eAAe;IACf,cAAc;IACd,cAAc;GAChB;GACA,OAAO,EACL,MAAM;IACJ,OAAO;IACP,aACE;GACJ,EACF;EACF;EACA;GACE,IAAI;GACJ,OAAO;GACP,aACE;GACF,eAAe;GACf,OAAO;GACP,OAAO;IACL,UAAU,iBAAiB;IAC3B,kBAAkB;IAClB,SAAS;IACT,SAAS;GACX;GACA,OAAO,EACL,MAAM;IACJ,OAAO;IACP,aACE;GACJ,EACF;EACF;EACA;GACE,IAAI;GACJ,OAAO;GACP,aACE;GACF,eAAe;GACf,OAAO;GACP,OAAO;IACL,QAAQ;IACR,aAAa;IACb,SAAS;KACP,IAAI;KACJ,YAAY;KACZ,SAAS;IACX;IACA,eAAe;GACjB;GACA,OAAO,EACL,MAAM;IACJ,OAAO;IACP,aACE;GACJ,EACF;EACF;CACF;AACF"}

package/dist/recipes.d.ts

@@ -10,6 +10,7 @@ import { SmrtRecipe } from '@happyvertical/smrt-core';
 import { AgentSession } from './models/AgentSession.js';
 import { ChatMessage } from './models/ChatMessage.js';
 import { ChatParticipant } from './models/ChatParticipant.js';
+import { ChatReaction } from './models/ChatReaction.js';
 import { ChatRoom } from './models/ChatRoom.js';
 import { ChatThread } from './models/ChatThread.js';
 /**
@@ -45,4 +46,84 @@ export declare class AssistantRecipe extends SmrtRecipe {
         readonly browserOptions: readonly ["webllm", "bitgpu"];
     }];
 }
+/** Team rooms and their conversations. */
+export declare class ChatRoomsRecipe extends SmrtRecipe {
+    static id: string;
+    static help: string;
+    static label: string;
+    static summary: string;
+    static synonyms: string[];
+    static models: (typeof ChatMessage | typeof ChatParticipant | typeof ChatReaction | typeof ChatRoom | typeof ChatThread)[];
+    static group: {
+        id: string;
+        label: string;
+        summary: string;
+    };
+    static section: {
+        id: string;
+        label: string;
+        icon: string;
+        description: string;
+    };
+    static nav: {
+        label: string;
+        model: typeof ChatRoom;
+        icon: string;
+        description: string;
+        noun: string;
+    }[];
+    static runtime: "both";
+    static surfaces: readonly [{
+        readonly kind: "route";
+        readonly path: "/chat/rooms";
+        readonly export: "@happyvertical/smrt-chat/svelte#ChatLayout";
+        readonly label: "Team chat";
+    }, {
+        readonly kind: "playground";
+        readonly export: "@happyvertical/smrt-chat/playground#default";
+        readonly label: "Static chat fixtures";
+    }];
+    static demoSeed: {
+        readonly export: "@happyvertical/smrt-chat/playground#chatRoomsFixture";
+    };
+    static options: {
+        readonly ChatRoom: {
+            readonly fields: {
+                readonly metadata: {
+                    readonly visibility: "hidden";
+                };
+                readonly createdByProfileId: {
+                    readonly visibility: "hidden";
+                };
+                readonly lastMessageAt: {
+                    readonly label: "Last message";
+                    readonly order: 1;
+                };
+            };
+        };
+        readonly ChatMessage: {
+            readonly fields: {
+                readonly metadata: {
+                    readonly visibility: "hidden";
+                };
+                readonly toolCallData: {
+                    readonly visibility: "hidden";
+                };
+                readonly attachments: {
+                    readonly visibility: "advanced";
+                };
+            };
+        };
+        readonly ChatParticipant: {
+            readonly fields: {
+                readonly lastReadMessageId: {
+                    readonly visibility: "hidden";
+                };
+                readonly lastSeenAt: {
+                    readonly visibility: "advanced";
+                };
+            };
+        };
+    };
+}
 //# sourceMappingURL=recipes.d.ts.map

package/dist/recipes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"recipes.d.ts","sourceRoot":"","sources":["../src/recipes.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD;;;;;;;;GAQG;AACH,qBAAa,eAAgB,SAAQ,UAAU;IAC7C,MAAM,CAAC,EAAE,SAAoB;IAC7B,MAAM,CAAC,IAAI,SAA2B;IACtC,MAAM,CAAC,KAAK,SAAe;IAC3B,MAAM,CAAC,OAAO,SACmE;IACjF,MAAM,CAAC,QAAQ,WAOb;IACF,MAAM,CAAC,MAAM,8GAMX;IAGF,MAAM,CAAC,OAAO,EAAG,MAAM,CAAU;IACjC,MAAM,CAAC,QAAQ;;;;;;OAQJ;IAGX,MAAM,CAAC,SAAS;;;;;;;OASL;CACZ"}
+{"version":3,"file":"recipes.d.ts","sourceRoot":"","sources":["../src/recipes.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD;;;;;;;;GAQG;AACH,qBAAa,eAAgB,SAAQ,UAAU;IAC7C,MAAM,CAAC,EAAE,SAAoB;IAC7B,MAAM,CAAC,IAAI,SAA2B;IACtC,MAAM,CAAC,KAAK,SAAe;IAC3B,MAAM,CAAC,OAAO,SACmE;IACjF,MAAM,CAAC,QAAQ,WAOb;IACF,MAAM,CAAC,MAAM,8GAMX;IAGF,MAAM,CAAC,OAAO,EAAG,MAAM,CAAU;IACjC,MAAM,CAAC,QAAQ;;;;;;OAQJ;IAGX,MAAM,CAAC,SAAS;;;;;;;OASL;CACZ;AACD,0CAA0C;AAC1C,qBAAa,eAAgB,SAAQ,UAAU;IAC7C,MAAM,CAAC,EAAE,SAAgB;IACzB,MAAM,CAAC,IAAI,SAA4B;IACvC,MAAM,CAAC,KAAK,SAAe;IAC3B,MAAM,CAAC,OAAO,SACuD;IACrE,MAAM,CAAC,QAAQ,WAA4D;IAC3E,MAAM,CAAC,MAAM,8GAMX;IACF,MAAM,CAAC,KAAK;;;;MAIV;IACF,MAAM,CAAC,OAAO;;;;;MAKZ;IACF,MAAM,CAAC,GAAG;;;;;;QAQR;IACF,MAAM,CAAC,OAAO,EAAG,MAAM,CAAU;IACjC,MAAM,CAAC,QAAQ;;;;;;;;;OAYJ;IACX,MAAM,CAAC,QAAQ;;MAEJ;IACX,MAAM,CAAC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAqBH;CACZ"}

package/dist/routes/api/dev-character-conversation/protocol.d.ts

@@ -0,0 +1,33 @@
+export declare const DEV_CHARACTER_MAX_DRAFT_LENGTH = 200;
+export declare const DEV_CHARACTER_MAX_REQUEST_BYTES: number;
+export declare const DEV_CHARACTER_MAX_MESSAGES = 24;
+/**
+ * Browser-safe protocol for the local character conversation workbench.
+ *
+ * The proposal is deliberately descriptive: a host renders its canonical
+ * preview and performs any browser-side effect only after a trusted user
+ * confirmation. This module contains no capability to apply a proposal.
+ */
+export declare const DEV_CHARACTER_CONVERSATION_SECTIONS: readonly ["character", "conversation", "chat"];
+export type DevCharacterConversationSection = (typeof DEV_CHARACTER_CONVERSATION_SECTIONS)[number];
+export type DevCharacterConversationProposal = {
+    kind: 'navigate';
+    section: DevCharacterConversationSection;
+    preview: {
+        title: string;
+        description: string;
+    };
+} | {
+    kind: 'stageDraft';
+    value: string;
+    preview: {
+        title: string;
+        description: string;
+    };
+};
+export interface DevCharacterConversationResponse {
+    content: string;
+    model?: string;
+    proposal?: DevCharacterConversationProposal;
+}
+//# sourceMappingURL=protocol.d.ts.map

package/dist/routes/api/dev-character-conversation/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../../../src/routes/api/dev-character-conversation/protocol.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,8BAA8B,MAAM,CAAC;AAClD,eAAO,MAAM,+BAA+B,QAAY,CAAC;AACzD,eAAO,MAAM,0BAA0B,KAAK,CAAC;AAE7C;;;;;;GAMG;AACH,eAAO,MAAM,mCAAmC,gDAItC,CAAC;AAEX,MAAM,MAAM,+BAA+B,GACzC,CAAC,OAAO,mCAAmC,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvD,MAAM,MAAM,gCAAgC,GACxC;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,EAAE,+BAA+B,CAAC;IACzC,OAAO,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH,GACD;IACE,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH,CAAC;AAEN,MAAM,WAAW,gCAAgC;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,gCAAgC,CAAC;CAC7C"}