@happyvertical/smrt-chat 0.55.9 → 0.55.11

package/dist/index.js

@@ -1,12 +1,14 @@
-import { c as ChatThread, d as ChatParticipant, f as ChatMessage, i as clientRequestMessageId, l as ChatRoom, n as ChatService, o as VoiceSessionCollection, p as AgentSession, s as VoiceSession, t as ChatClientRequestConflictError, u as ChatReaction } from "./chunks/ChatService-C9UxuJaw.js";
-import { A as MAX_CLIENT_TOOLS, B as RUNTIME_REPORT_DEFINE_FUNCTION_NAME, C as SESSION_CONTINUATIONS_FIELD, D as runAssistantTurn, E as createSessionContinuationStore, F as classifyToolError, G as RUNTIME_REPORT_RUN_TOOL_SLUG, H as RUNTIME_REPORT_LIST_FUNCTION_NAME, I as invokeManifestTool, J as createRuntimeReportTools, K as RUNTIME_REPORT_SOURCES_FUNCTION_NAME, L as manifestToolToAITool, M as MAX_CLIENT_TOOL_SCHEMA_BYTES, N as appendClientToolResults, O as CLIENT_TOOL_RESULT_GUIDANCE, P as buildManifestToolCatalog, R as runToolLoop, S as DEFAULT_CONTINUATION_TTL_MS, T as createMemoryContinuationStore, U as RUNTIME_REPORT_LIST_TOOL_SLUG, V as RUNTIME_REPORT_DEFINE_TOOL_SLUG, W as RUNTIME_REPORT_RUN_FUNCTION_NAME, _ as runPersonaConversationTurn, a as MAX_CHAT_STREAM_CONTENT_LENGTH, b as CONTINUATION_CLAIM_TTL_MS, c as encodeChatStreamEvent, d as conversationPersonaFromAgentPersona, f as conversationPersonaFromResolved, g as resolveConversationInstructions, h as recallPersonaMemory, i as DEFAULT_CHAT_STREAM_HEARTBEAT_MS, j as MAX_CLIENT_TOOL_RESULT_CHARS, k as DEFAULT_MAX_STEPS, l as runChatConversationStream, m as principalBindingFor, n as ChatStreamError, o as MAX_CHAT_STREAM_MESSAGES, p as formatRecalledMemory, q as RUNTIME_REPORT_SOURCES_TOOL_SLUG, r as ChatStreamUnauthorizedError, s as createChatStreamHandler, t as ChatStreamBadRequestError, u as bindPersonaToSession, v as ASSISTANT_TURN_GENERIC_ERROR, w as createAssistantTurnResponse, x as DEFAULT_ASSISTANT_TURN_HEARTBEAT_MS, y as AssistantTurnUserError, z as sanitizeClientToolDeclarations } from "./chunks/chat-stream-BBk_5_Ph.js";
+import { c as ChatThread, d as ChatParticipant, f as ChatMessage, i as clientRequestMessageId, l as ChatRoom, n as ChatService, o as VoiceSessionCollection, p as AgentSession, s as VoiceSession, t as ChatClientRequestConflictError, u as ChatReaction } from "./chunks/ChatService-CFaaDHyU.js";
+import { A as MAX_CLIENT_TOOLS, B as RUNTIME_REPORT_DEFINE_FUNCTION_NAME, C as SESSION_CONTINUATIONS_FIELD, D as runAssistantTurn, E as createSessionContinuationStore, F as classifyToolError, G as RUNTIME_REPORT_RUN_TOOL_SLUG, H as RUNTIME_REPORT_LIST_FUNCTION_NAME, I as invokeManifestTool, J as createRuntimeReportTools, K as RUNTIME_REPORT_SOURCES_FUNCTION_NAME, L as manifestToolToAITool, M as MAX_CLIENT_TOOL_SCHEMA_BYTES, N as appendClientToolResults, O as CLIENT_TOOL_RESULT_GUIDANCE, P as buildManifestToolCatalog, R as runToolLoop, S as DEFAULT_CONTINUATION_TTL_MS, T as createMemoryContinuationStore, U as RUNTIME_REPORT_LIST_TOOL_SLUG, V as RUNTIME_REPORT_DEFINE_TOOL_SLUG, W as RUNTIME_REPORT_RUN_FUNCTION_NAME, _ as runPersonaConversationTurn, a as MAX_CHAT_STREAM_CONTENT_LENGTH, b as CONTINUATION_CLAIM_TTL_MS, c as encodeChatStreamEvent, d as conversationPersonaFromAgentPersona, f as conversationPersonaFromResolved, g as resolveConversationInstructions, h as recallPersonaMemory, i as DEFAULT_CHAT_STREAM_HEARTBEAT_MS, j as MAX_CLIENT_TOOL_RESULT_CHARS, k as DEFAULT_MAX_STEPS, l as runChatConversationStream, m as principalBindingFor, n as ChatStreamError, o as MAX_CHAT_STREAM_MESSAGES, p as formatRecalledMemory, q as RUNTIME_REPORT_SOURCES_TOOL_SLUG, r as ChatStreamUnauthorizedError, s as createChatStreamHandler, t as ChatStreamBadRequestError, u as bindPersonaToSession, v as ASSISTANT_TURN_GENERIC_ERROR, w as createAssistantTurnResponse, x as DEFAULT_ASSISTANT_TURN_HEARTBEAT_MS, y as AssistantTurnUserError, z as sanitizeClientToolDeclarations } from "./chunks/chat-stream-n-7AqsgF.js";
 import { i as matchesToolAllowList, n as encodeAssistantTurnEvent, r as readAssistantTurnStream, t as AssistantTurnStreamError } from "./chunks/assistant-turn-events-BbZUf-Ju.js";
 import { a as createServerDataSurfaceBridge, i as createDataSurfaceCommandBridge, n as DEFAULT_DATA_SURFACE_BRIDGE_TTL_MS, r as createDataSurfaceBridge, t as DATA_SURFACE_BRIDGE_VERSION } from "./chunks/data-surface-bridge-BJomMxjS.js";
+import { HELPER_CLEARED_PREFERENCES, HELPER_PREFERENCES_VERSION, helperPreferenceFields, isHelperClearedPreferences, parseHelperPreferences } from "./helper-preferences.js";
 import { CHAT_MODULE_META, CHAT_UI_SLOTS } from "./ui.js";
 import { SmrtCollection, SmrtObject, SmrtRecipe, ValidationError, field, foreignKey, resolveDatabase, smrt } from "@happyvertical/smrt-core";
-import { DATA_DISCOVER_FUNCTION_NAME, DATA_DISCOVER_TOOL_SLUG, DATA_INSPECT_FUNCTION_NAME, DATA_INSPECT_TOOL_SLUG, DATA_QUERY_FUNCTION_NAME, DATA_QUERY_TOOL_SLUG, DEFAULT_DATA_SURFACE_DEADLINE_MS, DataSurfaceDeadlineError, DataSurfaceDeniedError, DataSurfaceQueryError, DataSurfaceRequestError, DataSurfaceResultOrderError, MAX_DATA_SURFACE_DEADLINE_MS, createDataSurfaceQueryFingerprint, createDataSurfaceTools } from "@happyvertical/smrt-agents";
-import { TenantScoped, tenantId } from "@happyvertical/smrt-tenancy";
+import { DATA_DISCOVER_FUNCTION_NAME, DATA_DISCOVER_TOOL_SLUG, DATA_INSPECT_FUNCTION_NAME, DATA_INSPECT_TOOL_SLUG, DATA_QUERY_FUNCTION_NAME, DATA_QUERY_TOOL_SLUG, DEFAULT_DATA_SURFACE_DEADLINE_MS, DataSurfaceDeadlineError, DataSurfaceDeniedError, DataSurfaceDeniedError as DataSurfaceDeniedError$1, DataSurfaceQueryError, DataSurfaceRequestError, DataSurfaceResultOrderError, MAX_DATA_SURFACE_DEADLINE_MS, createDataSurfaceQueryFingerprint, createDataSurfaceTools } from "@happyvertical/smrt-agents";
+import { TenantScoped, getCurrentTenant, isSuperAdminBypass, isSystemContext, isTenancyEnabled, tenantId, withTenant } from "@happyvertical/smrt-tenancy";
 import { FeedbackCollection, feedbackSourceFor, personaLearningMemory, personaMemoryScope, reinforceFromFeedback } from "@happyvertical/smrt-personas";
+import { ProfileCollection, ProfileMetadataCollection, ProfileMetafieldCollection } from "@happyvertical/smrt-profiles";
 //#region src/chat-feedback.ts
 async function captureChatFeedback(options) {
 	if (!options.persona.id) throw new Error("captureChatFeedback requires a persisted persona (missing id)");
@@ -85,6 +87,286 @@ function thumbsDown(options) {
 	});
 }
 //#endregion
+//#region src/helper-preferences-service.ts
+var HelperPreferencesAuthorizationError = class extends Error {
+	constructor() {
+		super("Helper preference access is not authorized.");
+		this.name = "HelperPreferencesAuthorizationError";
+	}
+};
+var HelperPreferencesValidationError = class extends Error {
+	constructor(message) {
+		super(message);
+		this.name = "HelperPreferencesValidationError";
+	}
+};
+var HelperPreferencesService = class {
+	#o;
+	constructor(options) {
+		this.#o = options;
+	}
+	async load(c) {
+		await this.#auth(c, "load");
+		return this.#resolve(c, await this.#o.store.load(c));
+	}
+	async save(c, value) {
+		await this.#auth(c, "save");
+		const p = await this.#visiblePolicy(c, await this.#policy(c));
+		if (p.selection === "owner-assigned") throw new HelperPreferencesAuthorizationError();
+		const next = parseHelperPreferences(value);
+		if (!next) throw new HelperPreferencesValidationError("Helper preferences are invalid.");
+		for (const f of this.#fields()) if (!p.customizable.includes(f) && next[f] !== p.defaultPreferences[f]) throw new HelperPreferencesValidationError(`The ${f} preference is not customizable.`);
+		await this.#validate(c, p, next);
+		await this.#o.store.save(c, next);
+		return this.#resolve(c, await this.#o.store.load(c));
+	}
+	async reset(c) {
+		await this.#auth(c, "reset");
+		if ((await this.#policy(c)).selection === "owner-assigned") throw new HelperPreferencesAuthorizationError();
+		await this.#o.store.clear(c);
+		return this.#resolve(c, await this.#o.store.load(c));
+	}
+	async #auth(c, op) {
+		if (!await this.#o.authorize(c, op)) throw new HelperPreferencesAuthorizationError();
+	}
+	async #policy(c) {
+		const p = await this.#o.resolvePolicy(c);
+		if (!parseHelperPreferences(p.defaultPreferences) || p.assignedPreferences !== void 0 && !parseHelperPreferences(p.assignedPreferences)) throw new HelperPreferencesValidationError("Helper policy preferences are invalid.");
+		return p;
+	}
+	async #resolve(c, raw) {
+		const p = await this.#visiblePolicy(c, await this.#policy(c));
+		const permissions = p.selection === "owner-assigned" ? {
+			editableFields: [],
+			canReset: false,
+			customStyleIds: []
+		} : {
+			editableFields: p.customizable,
+			canReset: raw !== null && !this.#cleared(raw),
+			customStyleIds: p.customStyleIds
+		};
+		const assigned = p.selection === "owner-assigned";
+		if (assigned && !p.assignedPreferences) return this.#snapshot(p, permissions, null, "unavailable", false, {
+			code: "invalid-preferences",
+			message: "The assigned helper preferences are unavailable."
+		});
+		const baseline = assigned ? p.assignedPreferences : p.defaultPreferences;
+		const persisted = !assigned && raw !== null && !this.#cleared(raw);
+		const parsed = assigned ? baseline : !persisted ? baseline : parseHelperPreferences(this.#decode(raw));
+		if (!parsed) try {
+			await this.#validate(c, p, baseline);
+			return this.#snapshot(p, permissions, baseline, "default", true, {
+				code: "invalid-preferences",
+				message: "Saved helper preferences are invalid. Reset to use current defaults."
+			});
+		} catch (error) {
+			if (error instanceof HelperPreferencesAuthorizationError) throw error;
+			return this.#snapshot(p, permissions, null, "unavailable", true, {
+				code: "invalid-preferences",
+				message: "The application default helper is unavailable."
+			});
+		}
+		try {
+			if (persisted) {
+				for (const f of this.#fields()) if (!p.customizable.includes(f) && parsed[f] !== baseline[f]) throw new HelperPreferencesValidationError("invalid-preferences");
+			}
+			await this.#validate(c, p, parsed);
+			return this.#snapshot(p, permissions, parsed, assigned ? "assigned" : persisted ? "personal" : "default", persisted, null);
+		} catch (error) {
+			if (error instanceof HelperPreferencesAuthorizationError) throw error;
+			if (assigned) return this.#snapshot(p, permissions, null, "unavailable", false, {
+				code: "invalid-preferences",
+				message: "The assigned helper preferences are unavailable."
+			});
+			try {
+				await this.#validate(c, p, baseline);
+				return this.#snapshot(p, permissions, baseline, "default", persisted, this.#recovery(error));
+			} catch (fallbackError) {
+				if (fallbackError instanceof HelperPreferencesAuthorizationError) throw fallbackError;
+				return this.#snapshot(p, permissions, null, "unavailable", persisted, {
+					code: "invalid-preferences",
+					message: "The application default helper is unavailable."
+				});
+			}
+		}
+	}
+	async #visiblePolicy(c, p) {
+		const offerings = [];
+		for (const offering of p.offerings) {
+			if (!this.#o.styleIds.includes(offering.styleId)) continue;
+			try {
+				await this.#o.validateOffering(c, offering);
+				offerings.push(offering);
+			} catch (error) {
+				if (error instanceof HelperPreferencesAuthorizationError) throw error;
+			}
+		}
+		return {
+			...p,
+			offerings
+		};
+	}
+	#decode(raw) {
+		if (typeof raw !== "string") return raw;
+		try {
+			return JSON.parse(raw);
+		} catch {
+			return;
+		}
+	}
+	#cleared(raw) {
+		return isHelperClearedPreferences(typeof raw === "string" ? this.#decode(raw) : raw);
+	}
+	async #validate(c, p, next) {
+		const offering = p.offerings.find((x) => x.id === next.offeringId);
+		if (!offering) throw new HelperPreferencesValidationError("unavailable-offering");
+		if (!this.#o.styleIds.includes(offering.styleId)) throw new HelperPreferencesValidationError("unavailable-style");
+		if (!p.voices.some((x) => x.id === next.voiceId)) throw new HelperPreferencesValidationError("unavailable-voice");
+		await this.#o.validateOffering(c, offering);
+	}
+	#recovery(error) {
+		return {
+			code: error instanceof HelperPreferencesValidationError && [
+				"unavailable-offering",
+				"unavailable-style",
+				"unavailable-voice"
+			].includes(error.message) ? error.message : "invalid-preferences",
+			message: "Saved helper preferences are no longer available. Reset to use current defaults."
+		};
+	}
+	#snapshot(p, permissions, prefs, source, hasOverride, recovery) {
+		return {
+			preferences: prefs,
+			recoveryDraft: prefs === null && p.selection !== "owner-assigned" ? this.#recoveryDraft(p, permissions) : null,
+			offering: prefs ? p.offerings.find((x) => x.id === prefs.offeringId) ?? null : null,
+			selection: p.selection,
+			source,
+			offerings: p.offerings,
+			voices: p.voices,
+			permissions,
+			hasOverride,
+			recovery
+		};
+	}
+	#recoveryDraft(p, permissions) {
+		const candidate = { ...p.defaultPreferences };
+		if (!p.offerings.find((item) => item.id === candidate.offeringId)) {
+			if (!permissions.editableFields.includes("offeringId") || !p.offerings[0]) return null;
+			candidate.offeringId = p.offerings[0].id;
+		}
+		if (!p.voices.some((voice) => voice.id === candidate.voiceId)) {
+			if (!permissions.editableFields.includes("voiceId") || !p.voices[0]) return null;
+			candidate.voiceId = p.voices[0].id;
+		}
+		return parseHelperPreferences(candidate);
+	}
+	#fields() {
+		return [
+			"offeringId",
+			"name",
+			"voiceId",
+			"placement",
+			"heardSubtitles",
+			"spokenSubtitles"
+		];
+	}
+};
+//#endregion
+//#region src/helper-profile-store.ts
+var HelperProfileStoreError = class extends Error {
+	constructor(message) {
+		super(message);
+		this.name = "HelperProfileStoreError";
+	}
+};
+var ProfileHelperPreferenceStore = class {
+	#db;
+	#metafieldSlug;
+	#applicationId;
+	constructor(options) {
+		this.#db = options.db;
+		this.#metafieldSlug = options.metafieldSlug;
+		this.#applicationId = options.applicationId;
+	}
+	async load(context) {
+		const { profile, metafield, metadata } = await this.#boundRecords(context);
+		const rows = await metadata.list({ where: {
+			profileId: profile.id,
+			metafieldId: metafield.id
+		} });
+		if (rows.length > 1) throw new HelperProfileStoreError("Duplicate helper preference metadata rows.");
+		const row = rows[0];
+		if (!row) return null;
+		if ((row.tenantId ?? null) !== (profile.tenantId ?? null)) throw new HelperProfileStoreError("Helper preference metadata tenant mismatch.");
+		return row.value;
+	}
+	async save(context, value) {
+		const { profile, metafield, metadata } = await this.#boundRecords(context);
+		const rows = await metadata.list({ where: {
+			profileId: profile.id,
+			metafieldId: metafield.id
+		} });
+		if (rows.length > 1) throw new HelperProfileStoreError("Duplicate helper preference metadata rows.");
+		const serialized = JSON.stringify(value);
+		const row = rows[0];
+		if (row) {
+			if ((row.tenantId ?? null) !== (profile.tenantId ?? null)) throw new HelperProfileStoreError("Helper preference metadata tenant mismatch.");
+			row.value = serialized;
+			await row.save();
+			return;
+		}
+		await (await metadata.create({
+			profileId: profile.id,
+			metafieldId: metafield.id,
+			value: serialized,
+			tenantId: profile.tenantId ?? null
+		})).save();
+	}
+	async clear(context) {
+		const { profile, metafield, metadata } = await this.#boundRecords(context);
+		const rows = await metadata.list({ where: {
+			profileId: profile.id,
+			metafieldId: metafield.id
+		} });
+		if (rows.length > 1) throw new HelperProfileStoreError("Duplicate helper preference metadata rows.");
+		const serialized = JSON.stringify({
+			version: 1,
+			cleared: true
+		});
+		const row = rows[0];
+		if (row) {
+			if ((row.tenantId ?? null) !== (profile.tenantId ?? null)) throw new HelperProfileStoreError("Helper preference metadata tenant mismatch.");
+			row.value = serialized;
+			await row.save();
+			return;
+		}
+		await (await metadata.create({
+			profileId: profile.id,
+			metafieldId: metafield.id,
+			value: serialized,
+			tenantId: profile.tenantId ?? null
+		})).save();
+	}
+	async #boundRecords(context) {
+		if (context.applicationId !== this.#applicationId) throw new HelperProfileStoreError("Helper preference application mismatch.");
+		const profile = await (await ProfileCollection.create({ db: this.#db })).get({ id: context.profileId });
+		if (!profile || (profile.tenantId ?? null) !== context.tenantId) throw new HelperProfileStoreError("Helper preference profile is unavailable.");
+		const candidates = await (await ProfileMetafieldCollection.create({ db: this.#db })).list({ where: { slug: this.#metafieldSlug } });
+		const matching = candidates.filter((field) => (field.tenantId ?? null) === (profile.tenantId ?? null));
+		const global = candidates.filter((field) => field.tenantId === null);
+		const chosen = matching[0] ?? global[0];
+		if (!chosen || matching.length > 1 || matching.length === 0 && global.length > 1) throw new HelperProfileStoreError("The pre-provisioned helper preference metafield is unavailable or ambiguous.");
+		return {
+			profile,
+			metafield: chosen,
+			metadata: await ProfileMetadataCollection.create({ db: this.#db })
+		};
+	}
+};
+function createHelperProfilePreferenceStore(options) {
+	return new ProfileHelperPreferenceStore(options);
+}
+//#endregion
 //#region src/models/VoiceGatewayTurn.ts
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -150,6 +432,334 @@ VoiceGatewayTurn = __decorateClass([TenantScoped({ mode: "required" }), smrt({
 	cli: false
 })], VoiceGatewayTurn);
 //#endregion
+//#region src/overview-tools.ts
+var OVERVIEW_DESCRIBE_TOOL_SLUG = "overviews.describe";
+var OVERVIEW_APPLY_TOOL_SLUG = "overviews.apply";
+var OVERVIEW_UNDO_TOOL_SLUG = "overviews.undo";
+var OVERVIEW_DESCRIBE_FUNCTION_NAME = "overviews-describe";
+var OVERVIEW_APPLY_FUNCTION_NAME = "overviews-apply";
+var OVERVIEW_UNDO_FUNCTION_NAME = "overviews-undo";
+var OVERVIEW_TOOL_MAX_OPERATIONS = 20;
+var PAGE_ID_PATTERN = /^[A-Za-z0-9][A-Za-z0-9_.:-]{0,95}$/;
+var OverviewToolError = class extends Error {
+	status;
+	code;
+	publicMessage;
+	issues;
+	constructor(status, code, message, issues = []) {
+		super(message);
+		this.name = "OverviewToolError";
+		this.status = status;
+		this.code = code;
+		this.publicMessage = message;
+		this.issues = issues;
+	}
+};
+function createMemoryOverviewUndoStore(options = {}) {
+	const ttl = options.ttlMs ?? 30 * 6e4;
+	const max = options.maxEntries ?? 1e3;
+	const now = options.now ?? Date.now;
+	const entries = /* @__PURE__ */ new Map();
+	return {
+		get(key) {
+			const entry = entries.get(key);
+			if (entry && now() - entry.createdAt > ttl) {
+				entries.delete(key);
+				return;
+			}
+			return entry;
+		},
+		set(key, entry) {
+			const existing = entries.get(key);
+			if (existing && existing.createdAt > entry.createdAt) return;
+			entries.delete(key);
+			entries.set(key, entry);
+			while (entries.size > max) {
+				const oldest = entries.keys().next().value;
+				if (oldest === void 0) break;
+				entries.delete(oldest);
+			}
+		},
+		delete(key, token) {
+			if (entries.get(key)?.token === token) entries.delete(key);
+		}
+	};
+}
+var processUndoStore;
+var lastUndoStamp = 0;
+function nextUndoStamp() {
+	lastUndoStamp = Math.max(Date.now(), lastUndoStamp + 1);
+	return lastUndoStamp;
+}
+function defaultOverviewUndoStore() {
+	processUndoStore ??= createMemoryOverviewUndoStore();
+	return processUndoStore;
+}
+function principalFromRun(run) {
+	const userId = run.context.userId;
+	if (!userId) throw new DataSurfaceDeniedError$1();
+	return {
+		userId,
+		tenantId: run.context.tenantId
+	};
+}
+async function withPrincipalTenant(run, fn) {
+	if (!isTenancyEnabled()) return fn();
+	const tenantId = run.context.tenantId;
+	if (!tenantId) throw new OverviewToolError(403, "tenant_required", "A tenant is required to use overview tools.");
+	const active = getCurrentTenant();
+	if (active === void 0) return withTenant({ tenantId }, fn);
+	if (active.tenantId !== tenantId && !isSystemContext() && !isSuperAdminBypass()) throw new DataSurfaceDeniedError$1();
+	return fn();
+}
+function guarded(slug, body) {
+	return async (context) => {
+		context.run.assertToolAllowed(slug);
+		principalFromRun(context.run);
+		return withPrincipalTenant(context.run, () => body(context));
+	};
+}
+function aiTool(slug, name, description, parameters, execute) {
+	return {
+		slug,
+		aiTool: {
+			type: "function",
+			function: {
+				name,
+				description,
+				parameters
+			}
+		},
+		execute
+	};
+}
+function persistFailure(result, conflict) {
+	if (result.reason === "conflict") return new OverviewToolError(409, conflict.code, conflict.message);
+	if (result.reason === "not_allowed") return new OverviewToolError(403, "not_allowed", "You may not change this overview.");
+	const issues = result.issues ?? [];
+	return new OverviewToolError(422, "invalid_operations", `The overview rejected the change and nothing changed. ${formatOverviewIssues(issues)}`, issues);
+}
+function sameJson(a, b) {
+	return JSON.stringify(a ?? null) === JSON.stringify(b ?? null);
+}
+function formatOverviewIssues(issues) {
+	return issues.slice(0, 10).map((issue) => {
+		const record = issue && typeof issue === "object" ? issue : {};
+		return `${typeof record.index === "number" ? `#${record.index + 1}` : "batch"}${typeof record.op === "string" ? ` ${record.op}` : ""}: ${typeof record.message === "string" ? record.message : typeof record.code === "string" ? record.code : "invalid"}`;
+	}).join("; ");
+}
+var OPERATION_PARAMETERS = {
+	type: "object",
+	required: ["op"],
+	additionalProperties: false,
+	properties: {
+		op: {
+			type: "string",
+			enum: [
+				"add",
+				"configure",
+				"move",
+				"resize",
+				"remove"
+			]
+		},
+		type: {
+			type: "string",
+			description: "add: a widget type overviews-describe lists."
+		},
+		id: {
+			type: "string",
+			description: "configure/move/resize/remove: an existing widget id."
+		},
+		span: {
+			type: "integer",
+			minimum: 1,
+			maximum: 4,
+			description: "add/resize: columns, within the type's span range."
+		},
+		index: {
+			type: "integer",
+			minimum: 0,
+			description: "add/move: zero-based position."
+		},
+		options: {
+			type: "object",
+			description: "add: the options; configure: keys to change (null resets a key). Only the option fields overviews-describe lists, with their allowed values.",
+			additionalProperties: { type: [
+				"string",
+				"number",
+				"boolean",
+				"null"
+			] }
+		}
+	}
+};
+function createOverviewTools(options) {
+	const { host } = options;
+	const undoStore = options.undoStore ?? defaultOverviewUndoStore();
+	const maxOperations = options.maxOperations ?? 20;
+	const createToken = options.createToken ?? (() => crypto.randomUUID());
+	const onError = options.onError ?? ((error, context) => {
+		console.warn(`[smrt-chat] ${context}`, error);
+	});
+	const undoKey = (run, pageId) => {
+		const { userId, tenantId } = principalFromRun(run);
+		return JSON.stringify([
+			tenantId,
+			userId,
+			pageId
+		]);
+	};
+	const pageArg = (value) => {
+		if (typeof value !== "string" || !PAGE_ID_PATTERN.test(value)) throw new OverviewToolError(422, "invalid_page", "page must be an overview page id from overviews-describe");
+		return value;
+	};
+	const open = async (run, pageId) => {
+		const surface = await host.open(run, pageId);
+		if (!surface || surface.pageId !== pageId) throw new OverviewToolError(404, "unknown_page", `no overview page "${pageId}" is available`);
+		return surface;
+	};
+	const requireCustomize = (surface) => {
+		if (!surface.canCustomize) throw new OverviewToolError(403, "not_allowed", "You may not change this overview.");
+	};
+	const audit = async (run, entry) => {
+		try {
+			await options.audit?.({
+				...entry,
+				...principalFromRun(run)
+			});
+		} catch (error) {
+			onError(error, `overview tool audit failed (${entry.action})`);
+		}
+	};
+	return [
+		aiTool(OVERVIEW_DESCRIBE_TOOL_SLUG, OVERVIEW_DESCRIBE_FUNCTION_NAME, "Describe an overview page: the widget types it allows (with their option fields, allowed values and span range) and the widgets it shows now, in order, plus whether you may change it. Without a page, lists the overview pages available. Call before changing an overview; never invent types, option keys or models.", {
+			type: "object",
+			additionalProperties: false,
+			properties: { page: {
+				type: "string",
+				description: "Overview page id."
+			} }
+		}, guarded(OVERVIEW_DESCRIBE_TOOL_SLUG, async ({ run, args }) => {
+			if (args.page === void 0) return { pages: host.pages ? await host.pages(run) : [] };
+			const surface = await open(run, pageArg(args.page));
+			return {
+				page: surface.pageId,
+				overview: surface.describe()
+			};
+		})),
+		aiTool(OVERVIEW_APPLY_TOOL_SLUG, OVERVIEW_APPLY_FUNCTION_NAME, "Change an overview page with a batch of structured operations: add {type, span?, options, index?}, configure {id, options}, move {id, index}, resize {id, span}, remove {id}. The batch is all-or-nothing: if any operation is invalid nothing changes and the issues are returned to fix. Returns an undoToken; the person can undo the batch.", {
+			type: "object",
+			required: ["page", "operations"],
+			additionalProperties: false,
+			properties: {
+				page: {
+					type: "string",
+					description: "Overview page id."
+				},
+				operations: {
+					type: "array",
+					minItems: 1,
+					maxItems: maxOperations,
+					items: OPERATION_PARAMETERS
+				}
+			}
+		}, guarded(OVERVIEW_APPLY_TOOL_SLUG, async ({ run, args }) => {
+			const pageId = pageArg(args.page);
+			const operations = args.operations;
+			if (!Array.isArray(operations) || operations.length === 0 || operations.length > maxOperations) throw new OverviewToolError(422, "invalid_operations", `operations must be an array of 1 to ${maxOperations} operations`);
+			const surface = await open(run, pageId);
+			requireCustomize(surface);
+			const before = surface.current();
+			const plan = surface.plan(operations);
+			if (!plan.ok) throw new OverviewToolError(422, "invalid_operations", `The batch was rejected and nothing changed. ${formatOverviewIssues(plan.issues)}`, plan.issues);
+			if (!!(plan.unchanged ?? sameJson(plan.override, before))) return {
+				page: pageId,
+				changed: false,
+				applied: plan.results,
+				undoToken: null
+			};
+			const written = await surface.persist(plan.override);
+			if (!written.ok) throw persistFailure(written, {
+				code: "conflict",
+				message: "The overview changed while the batch was being applied, so nothing changed. Call overviews-describe again and rebuild the batch."
+			});
+			let token = createToken();
+			try {
+				await undoStore.set(undoKey(run, pageId), {
+					token,
+					before,
+					after: plan.override,
+					createdAt: nextUndoStamp()
+				});
+			} catch (error) {
+				onError(error, "overview undo entry was not stored");
+				token = null;
+			}
+			await audit(run, {
+				action: "apply",
+				pageId,
+				operations: operations.length
+			});
+			return {
+				page: pageId,
+				changed: true,
+				applied: plan.results,
+				undoToken: token,
+				...token === null ? { note: "The change was applied but cannot be undone with overviews-undo. Do not apply it again." } : {},
+				overview: surface.describe()
+			};
+		})),
+		aiTool(OVERVIEW_UNDO_TOOL_SLUG, OVERVIEW_UNDO_FUNCTION_NAME, "Undo the last batch applied to an overview page (pass the undoToken overviews-apply returned). Single step: only the latest batch can be undone, and not once the page changed since.", {
+			type: "object",
+			required: ["page", "undoToken"],
+			additionalProperties: false,
+			properties: {
+				page: {
+					type: "string",
+					description: "Overview page id."
+				},
+				undoToken: { type: "string" }
+			}
+		}, guarded(OVERVIEW_UNDO_TOOL_SLUG, async ({ run, args }) => {
+			const pageId = pageArg(args.page);
+			const key = undoKey(run, pageId);
+			const entry = await undoStore.get(key);
+			if (!entry || typeof args.undoToken !== "string" || entry.token !== args.undoToken) throw new OverviewToolError(409, "nothing_to_undo", "There is no assistant change with that undoToken to undo on this page; only the latest batch can be undone.");
+			const surface = await open(run, pageId);
+			requireCustomize(surface);
+			if (!sameJson(surface.current(), entry.after)) {
+				await undoStore.delete(key, entry.token);
+				throw new OverviewToolError(409, "changed_since", "The overview changed after that batch, so it was not undone.");
+			}
+			const checked = surface.check(entry.before);
+			if (!checked.ok) {
+				await undoStore.delete(key, entry.token);
+				throw new OverviewToolError(409, "cannot_restore", `The earlier arrangement is no longer valid on this page. ${formatOverviewIssues(checked.issues)}`, checked.issues);
+			}
+			const written = await surface.persist(checked.override);
+			if (!written.ok) throw persistFailure(written, {
+				code: "changed_since",
+				message: "The overview changed after that batch, so it was not undone."
+			});
+			try {
+				await undoStore.delete(key, entry.token);
+			} catch (error) {
+				onError(error, "overview undo entry was not removed");
+			}
+			await audit(run, {
+				action: "undo",
+				pageId
+			});
+			return {
+				page: pageId,
+				undone: true,
+				overview: surface.describe()
+			};
+		}))
+	];
+}
+//#endregion
 //#region src/recipes.ts
 var AssistantRecipe = class extends SmrtRecipe {
 	static id = "chat.assistant";
@@ -198,6 +808,74 @@ var AssistantRecipe = class extends SmrtRecipe {
 		browserOptions: ["webllm", "bitgpu"]
 	}];
 };
+var ChatRoomsRecipe = class extends SmrtRecipe {
+	static id = "chat.rooms";
+	static help = "./chat-rooms.recipe.md";
+	static label = "Team Chat";
+	static summary = "Organize team conversations in rooms with threads and reactions.";
+	static synonyms = [
+		"team chat",
+		"channels",
+		"group chat",
+		"conversations"
+	];
+	static models = [
+		ChatRoom,
+		ChatMessage,
+		ChatParticipant,
+		ChatThread,
+		ChatReaction
+	];
+	static group = {
+		id: "team-collaboration",
+		label: "Team collaboration",
+		summary: "Keep conversations and shared work in one place."
+	};
+	static section = {
+		id: "team",
+		label: "Team",
+		icon: "users",
+		description: "People and the conversations that keep them aligned."
+	};
+	static nav = [{
+		label: "Chat Rooms",
+		model: ChatRoom,
+		icon: "users",
+		description: "Team conversations organized by topic or audience.",
+		noun: "chat room"
+	}];
+	static runtime = "both";
+	static surfaces = [{
+		kind: "route",
+		path: "/chat/rooms",
+		export: "@happyvertical/smrt-chat/svelte#ChatLayout",
+		label: "Team chat"
+	}, {
+		kind: "playground",
+		export: "@happyvertical/smrt-chat/playground#default",
+		label: "Static chat fixtures"
+	}];
+	static demoSeed = { export: "@happyvertical/smrt-chat/playground#chatRoomsFixture" };
+	static options = {
+		ChatRoom: { fields: {
+			metadata: { visibility: "hidden" },
+			createdByProfileId: { visibility: "hidden" },
+			lastMessageAt: {
+				label: "Last message",
+				order: 1
+			}
+		} },
+		ChatMessage: { fields: {
+			metadata: { visibility: "hidden" },
+			toolCallData: { visibility: "hidden" },
+			attachments: { visibility: "advanced" }
+		} },
+		ChatParticipant: { fields: {
+			lastReadMessageId: { visibility: "hidden" },
+			lastSeenAt: { visibility: "advanced" }
+		} }
+	};
+};
 //#endregion
 //#region src/collections/VoiceGatewayTurnCollection.ts
 var VoiceGatewayTurnCollection = class extends SmrtCollection {
@@ -617,6 +1295,6 @@ function jsonResponse(body, status) {
 	});
 }
 //#endregion
-export { ASSISTANT_TURN_GENERIC_ERROR, AgentSession, AssistantRecipe, AssistantTurnStreamError, AssistantTurnUserError, CHAT_MODULE_META, CHAT_UI_SLOTS, CLIENT_TOOL_RESULT_GUIDANCE, CONTINUATION_CLAIM_TTL_MS, ChatClientRequestConflictError, ChatMessage, ChatParticipant, ChatReaction, ChatRoom, ChatService, ChatStreamBadRequestError, ChatStreamError, ChatStreamUnauthorizedError, ChatThread, DATA_DISCOVER_FUNCTION_NAME, DATA_DISCOVER_TOOL_SLUG, DATA_INSPECT_FUNCTION_NAME, DATA_INSPECT_TOOL_SLUG, DATA_QUERY_FUNCTION_NAME, DATA_QUERY_TOOL_SLUG, DATA_SURFACE_BRIDGE_VERSION, DEFAULT_ASSISTANT_TURN_HEARTBEAT_MS, DEFAULT_CHAT_STREAM_HEARTBEAT_MS, DEFAULT_CONTINUATION_TTL_MS, DEFAULT_DATA_SURFACE_BRIDGE_TTL_MS, DEFAULT_DATA_SURFACE_DEADLINE_MS, DEFAULT_MAX_STEPS, DataSurfaceDeadlineError, DataSurfaceDeniedError, DataSurfaceQueryError, DataSurfaceRequestError, DataSurfaceResultOrderError, MAX_CHAT_STREAM_CONTENT_LENGTH, MAX_CHAT_STREAM_MESSAGES, MAX_CLIENT_TOOLS, MAX_CLIENT_TOOL_RESULT_CHARS, MAX_CLIENT_TOOL_SCHEMA_BYTES, MAX_DATA_SURFACE_DEADLINE_MS, MAX_VOICE_GATEWAY_TEXT_LENGTH, RUNTIME_REPORT_DEFINE_FUNCTION_NAME, RUNTIME_REPORT_DEFINE_TOOL_SLUG, RUNTIME_REPORT_LIST_FUNCTION_NAME, RUNTIME_REPORT_LIST_TOOL_SLUG, RUNTIME_REPORT_RUN_FUNCTION_NAME, RUNTIME_REPORT_RUN_TOOL_SLUG, RUNTIME_REPORT_SOURCES_FUNCTION_NAME, RUNTIME_REPORT_SOURCES_TOOL_SLUG, SESSION_CONTINUATIONS_FIELD, SMRT_CHAT_VOICE_TARGET, VoiceGatewayBadRequestError, VoiceGatewayError, VoiceGatewayReplayError, VoiceGatewayTurn, VoiceGatewayUnauthorizedError, VoiceSession, VoiceSessionExpiredError, VoiceSessionRejectedError, acceptAppliedChange, appendClientToolResults, assertVoiceGatewayBearer, bindPersonaToSession, buildManifestToolCatalog, captureChatFeedback, classifyToolError, clientRequestMessageId, conversationPersonaFromAgentPersona, conversationPersonaFromResolved, correctResponse, createAssistantTurnResponse, createChatStreamHandler, createDataSurfaceBridge, createDataSurfaceCommandBridge, createDataSurfaceQueryFingerprint, createDataSurfaceTools, createMemoryContinuationStore, createRuntimeReportTools, createServerDataSurfaceBridge, createSessionContinuationStore, createVoiceChatSession, createVoiceGatewayTurnHandler, encodeAssistantTurnEvent, encodeChatStreamEvent, formatRecalledMemory, handleVoiceGatewayTurn, invokeManifestTool, manifestToolToAITool, matchesToolAllowList, principalBindingFor, rateResponse, readAssistantTurnStream, recallPersonaMemory, rejectAppliedChange, resolveConversationInstructions, runAssistantTurn, runChatConversationStream, runPersonaConversationTurn, runToolLoop, sanitizeClientToolDeclarations, thumbsDown, thumbsUp };
+export { ASSISTANT_TURN_GENERIC_ERROR, AgentSession, AssistantRecipe, AssistantTurnStreamError, AssistantTurnUserError, CHAT_MODULE_META, CHAT_UI_SLOTS, CLIENT_TOOL_RESULT_GUIDANCE, CONTINUATION_CLAIM_TTL_MS, ChatClientRequestConflictError, ChatMessage, ChatParticipant, ChatReaction, ChatRoom, ChatRoomsRecipe, ChatService, ChatStreamBadRequestError, ChatStreamError, ChatStreamUnauthorizedError, ChatThread, DATA_DISCOVER_FUNCTION_NAME, DATA_DISCOVER_TOOL_SLUG, DATA_INSPECT_FUNCTION_NAME, DATA_INSPECT_TOOL_SLUG, DATA_QUERY_FUNCTION_NAME, DATA_QUERY_TOOL_SLUG, DATA_SURFACE_BRIDGE_VERSION, DEFAULT_ASSISTANT_TURN_HEARTBEAT_MS, DEFAULT_CHAT_STREAM_HEARTBEAT_MS, DEFAULT_CONTINUATION_TTL_MS, DEFAULT_DATA_SURFACE_BRIDGE_TTL_MS, DEFAULT_DATA_SURFACE_DEADLINE_MS, DEFAULT_MAX_STEPS, DataSurfaceDeadlineError, DataSurfaceDeniedError, DataSurfaceQueryError, DataSurfaceRequestError, DataSurfaceResultOrderError, HELPER_CLEARED_PREFERENCES, HELPER_PREFERENCES_VERSION, HelperPreferencesAuthorizationError, HelperPreferencesService, HelperPreferencesValidationError, HelperProfileStoreError, MAX_CHAT_STREAM_CONTENT_LENGTH, MAX_CHAT_STREAM_MESSAGES, MAX_CLIENT_TOOLS, MAX_CLIENT_TOOL_RESULT_CHARS, MAX_CLIENT_TOOL_SCHEMA_BYTES, MAX_DATA_SURFACE_DEADLINE_MS, MAX_VOICE_GATEWAY_TEXT_LENGTH, OVERVIEW_APPLY_FUNCTION_NAME, OVERVIEW_APPLY_TOOL_SLUG, OVERVIEW_DESCRIBE_FUNCTION_NAME, OVERVIEW_DESCRIBE_TOOL_SLUG, OVERVIEW_TOOL_MAX_OPERATIONS, OVERVIEW_UNDO_FUNCTION_NAME, OVERVIEW_UNDO_TOOL_SLUG, OverviewToolError, ProfileHelperPreferenceStore, RUNTIME_REPORT_DEFINE_FUNCTION_NAME, RUNTIME_REPORT_DEFINE_TOOL_SLUG, RUNTIME_REPORT_LIST_FUNCTION_NAME, RUNTIME_REPORT_LIST_TOOL_SLUG, RUNTIME_REPORT_RUN_FUNCTION_NAME, RUNTIME_REPORT_RUN_TOOL_SLUG, RUNTIME_REPORT_SOURCES_FUNCTION_NAME, RUNTIME_REPORT_SOURCES_TOOL_SLUG, SESSION_CONTINUATIONS_FIELD, SMRT_CHAT_VOICE_TARGET, VoiceGatewayBadRequestError, VoiceGatewayError, VoiceGatewayReplayError, VoiceGatewayTurn, VoiceGatewayUnauthorizedError, VoiceSession, VoiceSessionExpiredError, VoiceSessionRejectedError, acceptAppliedChange, appendClientToolResults, assertVoiceGatewayBearer, bindPersonaToSession, buildManifestToolCatalog, captureChatFeedback, classifyToolError, clientRequestMessageId, conversationPersonaFromAgentPersona, conversationPersonaFromResolved, correctResponse, createAssistantTurnResponse, createChatStreamHandler, createDataSurfaceBridge, createDataSurfaceCommandBridge, createDataSurfaceQueryFingerprint, createDataSurfaceTools, createHelperProfilePreferenceStore, createMemoryContinuationStore, createMemoryOverviewUndoStore, createOverviewTools, createRuntimeReportTools, createServerDataSurfaceBridge, createSessionContinuationStore, createVoiceChatSession, createVoiceGatewayTurnHandler, defaultOverviewUndoStore, encodeAssistantTurnEvent, encodeChatStreamEvent, formatOverviewIssues, formatRecalledMemory, handleVoiceGatewayTurn, helperPreferenceFields, invokeManifestTool, isHelperClearedPreferences, manifestToolToAITool, matchesToolAllowList, parseHelperPreferences, principalBindingFor, rateResponse, readAssistantTurnStream, recallPersonaMemory, rejectAppliedChange, resolveConversationInstructions, runAssistantTurn, runChatConversationStream, runPersonaConversationTurn, runToolLoop, sanitizeClientToolDeclarations, thumbsDown, thumbsUp };
 
 //# sourceMappingURL=index.js.map