@happyvertical/smrt-core 0.55.9 → 0.55.11

package/dist/cookbook/engine/engine.js

@@ -0,0 +1,399 @@
+import { validateCookbook } from "../validate.js";
+import "./defaults.js";
+import { buildNav } from "./nav.js";
+import { clone, describeTheme, emptyCookbook, readSettings, same } from "./document.js";
+import { adopt, execute, libraryName } from "./commands.js";
+import { buildBatchTool, buildCommandTools, checkSchema, commandSchemas } from "./schemas.js";
+import "./types.js";
+//#region src/cookbook/engine/engine.ts
+var err = (code, message, extra = {}) => ({
+	code,
+	message,
+	...extra
+});
+/** Key order never changes a payload's identity: `{a, b}` and `{b, a}` match. */
+var canonical = (value) => {
+	if (Array.isArray(value)) return value.map(canonical);
+	if (value && typeof value === "object") return Object.fromEntries(Object.keys(value).sort().map((key) => [key, canonical(value[key])]));
+	return value;
+};
+var fingerprint = (value) => {
+	try {
+		return JSON.stringify(canonical(value)) ?? "undefined";
+	} catch {
+		return "unserializable";
+	}
+};
+function readCommand(value, schemas, extraKeys) {
+	if (!value || typeof value !== "object" || Array.isArray(value)) return {
+		ok: false,
+		error: err("unknown_command", "A command is an object: { name, input }.")
+	};
+	const record = value;
+	const { name, input = {} } = record;
+	if (typeof name !== "string" || !Object.hasOwn(schemas, name)) return {
+		ok: false,
+		error: err("unknown_command", `Unknown command ${JSON.stringify(name)}.`)
+	};
+	for (const key of Object.keys(record)) if (key !== "name" && key !== "input" && !extraKeys.includes(key)) return {
+		ok: false,
+		error: err("invalid_input", `${key} is not part of a command.`, { path: key })
+	};
+	const problem = checkSchema(schemas[name], input);
+	if (problem) return {
+		ok: false,
+		error: err("invalid_input", problem.message, { path: problem.path })
+	};
+	return {
+		ok: true,
+		name,
+		input
+	};
+}
+var checkId = (id) => id === void 0 || typeof id === "string" && id.length > 0 && id.length <= 200 ? null : err("invalid_input", "id must be a non-empty string of at most 200 characters.", { path: "id" });
+var checkRevision = (value) => value === void 0 || Number.isInteger(value) && value >= 0 ? null : err("invalid_input", "expectedRevision must be a whole number.", { path: "expectedRevision" });
+function createCookbookEngine(options) {
+	const { catalog } = options;
+	const schemas = commandSchemas(catalog);
+	const tools = buildCommandTools(catalog);
+	const batchTool = buildBatchTool(catalog);
+	const maxJournal = options.maxJournal ?? 500;
+	const maxUndo = options.maxUndo ?? 20;
+	let current;
+	let revision = 0;
+	const journal = /* @__PURE__ */ new Map();
+	if (options.state) {
+		const saved = options.state;
+		const checked = validateCookbook(saved.cookbook);
+		if (!checked.ok) throw new Error(`Invalid saved cookbook: ${checked.errors.join("; ")}`);
+		if (!Number.isInteger(saved.revision) || saved.revision < 0) throw new Error("Invalid saved revision.");
+		current = {
+			doc: adopt(catalog, checked.cookbook),
+			applied: saved.applied ?? null
+		};
+		revision = saved.revision;
+		for (const entry of saved.journal ?? []) journal.set(entry.id, clone(entry));
+	} else if (options.cookbook !== void 0) {
+		const checked = validateCookbook(options.cookbook);
+		if (!checked.ok) throw new Error(`Invalid cookbook: ${checked.errors.join("; ")}`);
+		current = {
+			doc: adopt(catalog, checked.cookbook),
+			applied: null
+		};
+	} else current = {
+		doc: adopt(catalog, emptyCookbook()),
+		applied: null
+	};
+	const undos = /* @__PURE__ */ new Map();
+	let undoIds = [];
+	let undoCounter = 0;
+	const listeners = /* @__PURE__ */ new Map();
+	function snapshotOf(state, rev) {
+		const { doc } = state;
+		const byId = new Map(catalog.recipes.map((r) => [r.id, r]));
+		const settings = readSettings(catalog, doc);
+		const exposed = new Set(catalog.models.filter((m) => m.exposed !== false).map((m) => m.id));
+		return {
+			version: 1,
+			revision: rev,
+			app: {
+				name: doc.name ?? libraryName(catalog, state.applied) ?? "my-app",
+				description: doc.description ?? null,
+				cookbook: state.applied
+			},
+			recipes: doc.recipes.flatMap((id) => {
+				const recipe = byId.get(id);
+				return recipe ? [{
+					id,
+					label: recipe.label
+				}] : [];
+			}),
+			features: doc.features.filter((id) => exposed.has(id)),
+			unavailable: [...doc.recipes.filter((id) => !byId.has(id)), ...doc.features.filter((id) => !exposed.has(id))],
+			settings: {
+				currency: settings.currency,
+				taxRate: Number((settings.taxRate * 100).toFixed(4)),
+				paymentTerms: settings.paymentTerms
+			},
+			theme: {
+				text: describeTheme(doc.theme),
+				preset: doc.theme?.preset ?? null,
+				primary: doc.theme?.custom?.primary ?? null,
+				colorScheme: doc.theme?.colorScheme ?? "system"
+			},
+			sections: buildNav(catalog, doc).map((s) => ({
+				id: s.id,
+				label: s.label,
+				hidden: s.hidden,
+				items: s.items.map((i) => ({
+					id: i.id,
+					label: i.label,
+					hidden: i.hidden
+				}))
+			})),
+			policies: doc.policies.length,
+			undo: [...undoIds]
+		};
+	}
+	const snapshot = () => snapshotOf(current, revision);
+	function notify() {
+		for (const [listener, last] of listeners) {
+			if (last === revision) continue;
+			listeners.set(listener, revision);
+			listener(snapshot());
+		}
+	}
+	function remember(id, print, result) {
+		if (id === void 0) return;
+		journal.set(id, {
+			id,
+			fingerprint: print,
+			result: clone(result)
+		});
+		while (journal.size > maxJournal) {
+			const oldest = journal.keys().next().value;
+			if (oldest === void 0) break;
+			journal.delete(oldest);
+		}
+	}
+	function replay(id, print) {
+		if (id === void 0) return null;
+		const hit = journal.get(id);
+		if (!hit) return null;
+		if (hit.fingerprint !== print) return {
+			ok: false,
+			id,
+			error: err("id_reuse", `The id "${id}" was already used for a different command.`, { path: "id" })
+		};
+		return {
+			...clone(hit.result),
+			replayed: true
+		};
+	}
+	function recordUndo(before, after) {
+		const undoId = `undo-${++undoCounter}`;
+		undos.set(undoId, {
+			before: clone(before),
+			after: clone(after)
+		});
+		undoIds = [...undoIds, undoId].slice(-maxUndo);
+		for (const key of [...undos.keys()]) if (!undoIds.includes(key)) undos.delete(key);
+		return undoId;
+	}
+	const changedBetween = (a, b) => a.applied !== b.applied || !same(a.doc, b.doc);
+	function toSuccess(id, name, outcome, revisionBefore, revisionAfter, snap, undoId) {
+		return {
+			ok: true,
+			...id !== void 0 ? { id } : {},
+			snapshot: snap,
+			receipt: {
+				name,
+				...id !== void 0 ? { id } : {},
+				summary: revisionAfter !== revisionBefore ? outcome.summary : "",
+				changed: revisionAfter !== revisionBefore,
+				revisionBefore,
+				revisionAfter,
+				...undoId ? { undoId } : {},
+				...outcome.changes ? { changes: outcome.changes } : {},
+				...outcome.warnings ? { warnings: outcome.warnings } : {}
+			},
+			...outcome.data !== void 0 ? { data: outcome.data } : {}
+		};
+	}
+	function runUndo(id, input) {
+		const entry = undos.get(input.undoId);
+		if (!entry) return {
+			ok: false,
+			...id !== void 0 ? { id } : {},
+			error: err("not_found", `Nothing to undo for "${input.undoId}".`, { path: "input.undoId" })
+		};
+		if (!input.force && changedBetween(current, entry.after)) return {
+			ok: false,
+			...id !== void 0 ? { id } : {},
+			error: err("conflict", "The plan changed since; send force: true to undo anyway.", { details: { currentRevision: revision } })
+		};
+		const before = revision;
+		const restored = clone(entry.before);
+		const changed = changedBetween(current, restored);
+		current = restored;
+		if (changed) revision += 1;
+		undos.delete(input.undoId);
+		undoIds = undoIds.filter((u) => u !== input.undoId);
+		const result = toSuccess(id, "undo", {
+			ok: true,
+			state: current,
+			summary: "Undone."
+		}, before, revision, snapshot());
+		notify();
+		return result;
+	}
+	function run(command, runOptions = {}) {
+		try {
+			const raw = command && typeof command === "object" && !Array.isArray(command) ? command : void 0;
+			const id = raw?.id;
+			const idProblem = checkId(id);
+			if (idProblem) return {
+				ok: false,
+				error: idProblem
+			};
+			const expected = raw?.expectedRevision ?? runOptions.expectedRevision;
+			const revProblem = checkRevision(expected);
+			if (revProblem) return {
+				ok: false,
+				...id !== void 0 ? { id } : {},
+				error: revProblem
+			};
+			const print = fingerprint({
+				name: raw?.name,
+				input: raw?.input ?? {},
+				expectedRevision: expected
+			});
+			const replayed = replay(id, print);
+			if (replayed) return replayed;
+			const finish = (result) => {
+				remember(id, print, result);
+				return result;
+			};
+			const withId = (error) => ({
+				ok: false,
+				...id !== void 0 ? { id } : {},
+				error
+			});
+			const parsed = readCommand(command, schemas, ["id", "expectedRevision"]);
+			if (!parsed.ok) return finish(withId(parsed.error));
+			if (expected !== void 0 && expected !== revision) return finish(withId(err("conflict", `The plan is at revision ${revision}, not ${expected}. Read the snapshot and try again.`, { details: {
+				expectedRevision: expected,
+				currentRevision: revision
+			} })));
+			if (parsed.name === "undo") return finish(runUndo(id, parsed.input));
+			const before = current;
+			const outcome = execute(catalog, before, parsed.name, parsed.input);
+			if (!outcome.ok) return finish(withId(outcome.error));
+			const revisionBefore = revision;
+			const changed = changedBetween(before, outcome.state);
+			let undoId;
+			if (changed) {
+				current = outcome.state;
+				revision += 1;
+				undoId = recordUndo(before, outcome.state);
+			}
+			const result = finish(toSuccess(id, parsed.name, outcome, revisionBefore, revision, snapshot(), undoId));
+			notify();
+			return result;
+		} catch (cause) {
+			return {
+				ok: false,
+				error: err("failed", cause instanceof Error ? cause.message : String(cause))
+			};
+		}
+	}
+	function batch(input) {
+		const unchanged = (error, id) => ({
+			ok: false,
+			...id !== void 0 ? { id } : {},
+			error,
+			snapshot: snapshot()
+		});
+		try {
+			if (!input || typeof input !== "object" || Array.isArray(input)) return unchanged(err("invalid_input", "A batch is an object: { commands }."));
+			const raw = input;
+			const id = raw.id;
+			const idProblem = checkId(id);
+			if (idProblem) return unchanged(idProblem);
+			const revProblem = checkRevision(raw.expectedRevision);
+			if (revProblem) return unchanged(revProblem, id);
+			const print = fingerprint({
+				commands: raw.commands,
+				expectedRevision: raw.expectedRevision
+			});
+			const replayed = replay(id, print);
+			if (replayed) return "results" in replayed || "snapshot" in replayed ? replayed : unchanged(replayed.error, id);
+			const finish = (result) => {
+				remember(id, print, result);
+				return result;
+			};
+			const commands = raw.commands;
+			if (!Array.isArray(commands) || commands.length === 0 || commands.length > 50) return finish(unchanged(err("invalid_input", "commands must be a list of 1 to 50 commands.", { path: "commands" }), id));
+			const expected = raw.expectedRevision;
+			if (expected !== void 0 && expected !== revision) return finish(unchanged(err("conflict", `The plan is at revision ${revision}, not ${expected}. Read the snapshot and try again.`, { details: {
+				expectedRevision: expected,
+				currentRevision: revision
+			} }), id));
+			const failAt = (index, name, cause) => finish(unchanged(err("batch_failed", `Command ${index + 1} (${String(name)}) failed: ${cause.message}`, {
+				path: `commands[${index}]`,
+				details: {
+					index,
+					cause
+				}
+			}), id));
+			const base = current;
+			const baseRevision = revision;
+			let working = base;
+			let rev = baseRevision;
+			const results = [];
+			for (const [index, command] of commands.entries()) {
+				const parsed = readCommand(command, schemas, []);
+				if (!parsed.ok) return failAt(index, command?.name, parsed.error);
+				if (parsed.name === "undo") return failAt(index, "undo", err("invalid_input", "undo cannot run inside a batch."));
+				const outcome = execute(catalog, working, parsed.name, parsed.input);
+				if (!outcome.ok) return failAt(index, parsed.name, outcome.error);
+				const before = rev;
+				if (changedBetween(working, outcome.state)) rev += 1;
+				working = outcome.state;
+				results.push(toSuccess(void 0, parsed.name, outcome, before, rev, snapshotOf(working, rev)));
+			}
+			const changed = rev !== baseRevision;
+			let undoId;
+			if (changed) {
+				current = working;
+				revision = rev;
+				undoId = recordUndo(base, working);
+				for (const r of results) if (r.receipt.changed) delete r.receipt.undoId;
+			}
+			const result = finish({
+				ok: true,
+				...id !== void 0 ? { id } : {},
+				snapshot: snapshot(),
+				receipt: {
+					...id !== void 0 ? { id } : {},
+					count: results.length,
+					changed,
+					revisionBefore: baseRevision,
+					revisionAfter: rev,
+					...undoId ? { undoId } : {}
+				},
+				results
+			});
+			notify();
+			return result;
+		} catch (cause) {
+			return unchanged(err("failed", cause instanceof Error ? cause.message : String(cause)));
+		}
+	}
+	return {
+		run,
+		batch,
+		snapshot,
+		cookbook: () => clone(current.doc),
+		state: () => ({
+			version: 1,
+			revision,
+			applied: current.applied,
+			cookbook: clone(current.doc),
+			journal: [...journal.values()].map((entry) => clone(entry))
+		}),
+		subscribe(listener) {
+			listeners.set(listener, revision);
+			listener(snapshot());
+			return () => {
+				listeners.delete(listener);
+			};
+		},
+		tools,
+		batchTool
+	};
+}
+//#endregion
+export { createCookbookEngine };
+
+//# sourceMappingURL=engine.js.map

package/dist/cookbook/engine/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","names":[],"sources":["../../../src/cookbook/engine/engine.ts"],"sourcesContent":["import { validateCookbook } from '../validate.js';\nimport {\n  adopt,\n  execute,\n  libraryName,\n  type Outcome,\n  type PlanState,\n} from './commands.js';\nimport { DEFAULT_APP_NAME, DEFAULT_COLOR_SCHEME } from './defaults.js';\nimport {\n  clone,\n  describeTheme,\n  emptyCookbook,\n  readSettings,\n  same,\n} from './document.js';\nimport { buildNav } from './nav.js';\nimport {\n  buildBatchTool,\n  buildCommandTools,\n  type CommandSchemas,\n  checkSchema,\n  commandSchemas,\n} from './schemas.js';\nimport {\n  type BatchResult,\n  COOKBOOK_COMMANDS_VERSION,\n  type CommandBatch,\n  type CommandError,\n  type CommandName,\n  type CommandResult,\n  type CommandTool,\n  type EngineCatalog,\n  type EngineState,\n  type JournalEntry,\n  type JsonSchema,\n  type PlanSnapshot,\n  type RunOptions,\n} from './types.js';\n\nexport interface CookbookEngineOptions {\n  catalog: EngineCatalog;\n  /** Start from this document (strictly checked; the call throws if invalid). */\n  cookbook?: unknown;\n  /** Resume from a saved {@link EngineState} (wins over `cookbook`). */\n  state?: EngineState;\n  /** How many command ids are remembered for retries; default 500. */\n  maxJournal?: number;\n  /** How many undo entries are kept; default 20. */\n  maxUndo?: number;\n}\n\n/**\n * The cookbook command engine: typed, versioned commands over one cookbook\n * document, held in plain objects. Never throws from `run`/`batch`; every\n * refusal is a typed error and leaves the document untouched.\n */\nexport interface CookbookEngine {\n  /**\n   * Run one command (`{ name, input, id?, expectedRevision? }`). A repeated\n   * `id` returns the first result with `replayed: true` and applies nothing.\n   */\n  run(command: unknown, options?: RunOptions): CommandResult;\n  /**\n   * Run several commands all-or-nothing. On any failure the state is exactly\n   * as before and the error names the failing command.\n   */\n  batch(batch: CommandBatch | unknown): BatchResult;\n  /** The compact plan state, cheap enough for a model prompt. */\n  snapshot(): PlanSnapshot;\n  /** The document (a copy). */\n  cookbook(): ReturnType<typeof clone<PlanState['doc']>>;\n  /** Serializable state to persist and resume from, retries included. */\n  state(): EngineState;\n  /** Call `listener` with the snapshot now and after every change. */\n  subscribe(listener: (snapshot: PlanSnapshot) => void): () => void;\n  /** Command tool definitions (JSON Schema inputs), enums narrowed to the catalog. */\n  readonly tools: readonly CommandTool[];\n  /** The atomic-batch tool definition. */\n  readonly batchTool: {\n    name: 'run_batch';\n    description: string;\n    inputSchema: JsonSchema;\n  };\n}\n\ninterface UndoEntry {\n  before: PlanState;\n  /** What the change left; undo is a conflict while the plan differs from it. */\n  after: PlanState;\n}\n\nconst err = (\n  code: CommandError['code'],\n  message: string,\n  extra: Pick<CommandError, 'path' | 'details'> = {},\n): CommandError => ({ code, message, ...extra });\n\n/** Key order never changes a payload's identity: `{a, b}` and `{b, a}` match. */\nconst canonical = (value: unknown): unknown => {\n  if (Array.isArray(value)) return value.map(canonical);\n  if (value && typeof value === 'object') {\n    return Object.fromEntries(\n      Object.keys(value)\n        .sort()\n        .map((key) => [\n          key,\n          canonical((value as Record<string, unknown>)[key]),\n        ]),\n    );\n  }\n  return value;\n};\n\nconst fingerprint = (value: unknown): string => {\n  try {\n    return JSON.stringify(canonical(value)) ?? 'undefined';\n  } catch {\n    return 'unserializable';\n  }\n};\n\ntype Parsed =\n  | { ok: true; name: CommandName; input: Record<string, unknown> }\n  | { ok: false; error: CommandError };\n\nfunction readCommand(\n  value: unknown,\n  schemas: CommandSchemas,\n  extraKeys: readonly string[],\n): Parsed {\n  if (!value || typeof value !== 'object' || Array.isArray(value)) {\n    return {\n      ok: false,\n      error: err('unknown_command', 'A command is an object: { name, input }.'),\n    };\n  }\n  const record = value as Record<string, unknown>;\n  const { name, input = {} } = record;\n  if (typeof name !== 'string' || !Object.hasOwn(schemas, name)) {\n    return {\n      ok: false,\n      error: err('unknown_command', `Unknown command ${JSON.stringify(name)}.`),\n    };\n  }\n  for (const key of Object.keys(record)) {\n    if (key !== 'name' && key !== 'input' && !extraKeys.includes(key)) {\n      return {\n        ok: false,\n        error: err('invalid_input', `${key} is not part of a command.`, {\n          path: key,\n        }),\n      };\n    }\n  }\n  const problem = checkSchema(schemas[name as CommandName], input);\n  if (problem) {\n    return {\n      ok: false,\n      error: err('invalid_input', problem.message, { path: problem.path }),\n    };\n  }\n  return {\n    ok: true,\n    name: name as CommandName,\n    input: input as Record<string, unknown>,\n  };\n}\n\nconst checkId = (id: unknown): CommandError | null =>\n  id === undefined ||\n  (typeof id === 'string' && id.length > 0 && id.length <= 200)\n    ? null\n    : err(\n        'invalid_input',\n        'id must be a non-empty string of at most 200 characters.',\n        { path: 'id' },\n      );\n\nconst checkRevision = (value: unknown): CommandError | null =>\n  value === undefined || (Number.isInteger(value) && (value as number) >= 0)\n    ? null\n    : err('invalid_input', 'expectedRevision must be a whole number.', {\n        path: 'expectedRevision',\n      });\n\nexport function createCookbookEngine(\n  options: CookbookEngineOptions,\n): CookbookEngine {\n  const { catalog } = options;\n  const schemas = commandSchemas(catalog);\n  const tools = buildCommandTools(catalog);\n  const batchTool = buildBatchTool(catalog);\n  const maxJournal = options.maxJournal ?? 500;\n  const maxUndo = options.maxUndo ?? 20;\n\n  let current: PlanState;\n  let revision = 0;\n  const journal = new Map<string, JournalEntry>();\n\n  if (options.state) {\n    const saved = options.state;\n    const checked = validateCookbook(saved.cookbook);\n    if (!checked.ok)\n      throw new Error(`Invalid saved cookbook: ${checked.errors.join('; ')}`);\n    if (!Number.isInteger(saved.revision) || saved.revision < 0) {\n      throw new Error('Invalid saved revision.');\n    }\n    current = {\n      doc: adopt(catalog, checked.cookbook),\n      applied: saved.applied ?? null,\n    };\n    revision = saved.revision;\n    for (const entry of saved.journal ?? [])\n      journal.set(entry.id, clone(entry));\n  } else if (options.cookbook !== undefined) {\n    const checked = validateCookbook(options.cookbook);\n    if (!checked.ok)\n      throw new Error(`Invalid cookbook: ${checked.errors.join('; ')}`);\n    current = { doc: adopt(catalog, checked.cookbook), applied: null };\n  } else {\n    current = { doc: adopt(catalog, emptyCookbook()), applied: null };\n  }\n\n  const undos = new Map<string, UndoEntry>();\n  let undoIds: string[] = [];\n  let undoCounter = 0;\n  const listeners = new Map<(s: PlanSnapshot) => void, number>();\n\n  function snapshotOf(state: PlanState, rev: number): PlanSnapshot {\n    const { doc } = state;\n    const byId = new Map(catalog.recipes.map((r) => [r.id, r]));\n    const settings = readSettings(catalog, doc);\n    const exposed = new Set(\n      catalog.models.filter((m) => m.exposed !== false).map((m) => m.id),\n    );\n    return {\n      version: COOKBOOK_COMMANDS_VERSION,\n      revision: rev,\n      app: {\n        name:\n          doc.name ?? libraryName(catalog, state.applied) ?? DEFAULT_APP_NAME,\n        description: doc.description ?? null,\n        cookbook: state.applied,\n      },\n      recipes: doc.recipes.flatMap((id) => {\n        const recipe = byId.get(id);\n        return recipe ? [{ id, label: recipe.label }] : [];\n      }),\n      features: doc.features.filter((id) => exposed.has(id)),\n      unavailable: [\n        ...doc.recipes.filter((id) => !byId.has(id)),\n        ...doc.features.filter((id) => !exposed.has(id)),\n      ],\n      settings: {\n        currency: settings.currency,\n        taxRate: Number((settings.taxRate * 100).toFixed(4)),\n        paymentTerms: settings.paymentTerms,\n      },\n      theme: {\n        text: describeTheme(doc.theme),\n        preset: doc.theme?.preset ?? null,\n        primary: doc.theme?.custom?.primary ?? null,\n        colorScheme: doc.theme?.colorScheme ?? DEFAULT_COLOR_SCHEME,\n      },\n      sections: buildNav(catalog, doc).map((s) => ({\n        id: s.id,\n        label: s.label,\n        hidden: s.hidden,\n        items: s.items.map((i) => ({\n          id: i.id,\n          label: i.label,\n          hidden: i.hidden,\n        })),\n      })),\n      policies: doc.policies.length,\n      undo: [...undoIds],\n    };\n  }\n\n  const snapshot = () => snapshotOf(current, revision);\n\n  function notify(): void {\n    for (const [listener, last] of listeners) {\n      if (last === revision) continue;\n      listeners.set(listener, revision);\n      listener(snapshot());\n    }\n  }\n\n  function remember(\n    id: string | undefined,\n    print: string,\n    result: CommandResult | BatchResult,\n  ) {\n    if (id === undefined) return;\n    journal.set(id, { id, fingerprint: print, result: clone(result) });\n    while (journal.size > maxJournal) {\n      const oldest = journal.keys().next().value;\n      if (oldest === undefined) break;\n      journal.delete(oldest);\n    }\n  }\n\n  function replay<R extends CommandResult | BatchResult>(\n    id: string | undefined,\n    print: string,\n  ): R | CommandResult | null {\n    if (id === undefined) return null;\n    const hit = journal.get(id);\n    if (!hit) return null;\n    if (hit.fingerprint !== print) {\n      return {\n        ok: false,\n        id,\n        error: err(\n          'id_reuse',\n          `The id \"${id}\" was already used for a different command.`,\n          {\n            path: 'id',\n          },\n        ),\n      };\n    }\n    return { ...(clone(hit.result) as R), replayed: true };\n  }\n\n  function recordUndo(before: PlanState, after: PlanState): string {\n    const undoId = `undo-${++undoCounter}`;\n    undos.set(undoId, { before: clone(before), after: clone(after) });\n    undoIds = [...undoIds, undoId].slice(-maxUndo);\n    for (const key of [...undos.keys()])\n      if (!undoIds.includes(key)) undos.delete(key);\n    return undoId;\n  }\n\n  const changedBetween = (a: PlanState, b: PlanState) =>\n    a.applied !== b.applied || !same(a.doc, b.doc);\n\n  function toSuccess(\n    id: string | undefined,\n    name: CommandName,\n    outcome: Extract<Outcome, { ok: true }>,\n    revisionBefore: number,\n    revisionAfter: number,\n    snap: PlanSnapshot,\n    undoId?: string,\n  ): Extract<CommandResult, { ok: true }> {\n    return {\n      ok: true,\n      ...(id !== undefined ? { id } : {}),\n      snapshot: snap,\n      receipt: {\n        name,\n        ...(id !== undefined ? { id } : {}),\n        summary: revisionAfter !== revisionBefore ? outcome.summary : '',\n        changed: revisionAfter !== revisionBefore,\n        revisionBefore,\n        revisionAfter,\n        ...(undoId ? { undoId } : {}),\n        ...(outcome.changes ? { changes: outcome.changes } : {}),\n        ...(outcome.warnings ? { warnings: outcome.warnings } : {}),\n      },\n      ...(outcome.data !== undefined ? { data: outcome.data } : {}),\n    };\n  }\n\n  function runUndo(\n    id: string | undefined,\n    input: { undoId: string; force?: boolean },\n  ): CommandResult {\n    const entry = undos.get(input.undoId);\n    if (!entry) {\n      return {\n        ok: false,\n        ...(id !== undefined ? { id } : {}),\n        error: err('not_found', `Nothing to undo for \"${input.undoId}\".`, {\n          path: 'input.undoId',\n        }),\n      };\n    }\n    if (!input.force && changedBetween(current, entry.after)) {\n      return {\n        ok: false,\n        ...(id !== undefined ? { id } : {}),\n        error: err(\n          'conflict',\n          'The plan changed since; send force: true to undo anyway.',\n          {\n            details: { currentRevision: revision },\n          },\n        ),\n      };\n    }\n    const before = revision;\n    const restored = clone(entry.before);\n    const changed = changedBetween(current, restored);\n    current = restored;\n    if (changed) revision += 1;\n    undos.delete(input.undoId);\n    undoIds = undoIds.filter((u) => u !== input.undoId);\n    const result = toSuccess(\n      id,\n      'undo',\n      { ok: true, state: current, summary: 'Undone.' },\n      before,\n      revision,\n      snapshot(),\n    );\n    notify();\n    return result;\n  }\n\n  function run(command: unknown, runOptions: RunOptions = {}): CommandResult {\n    try {\n      const raw =\n        command && typeof command === 'object' && !Array.isArray(command)\n          ? (command as Record<string, unknown>)\n          : undefined;\n      const id = raw?.id as string | undefined;\n      const idProblem = checkId(id);\n      if (idProblem) return { ok: false, error: idProblem };\n      const expected = (raw?.expectedRevision ?? runOptions.expectedRevision) as\n        | number\n        | undefined;\n      const revProblem = checkRevision(expected);\n      if (revProblem)\n        return {\n          ok: false,\n          ...(id !== undefined ? { id } : {}),\n          error: revProblem,\n        };\n\n      const print = fingerprint({\n        name: raw?.name,\n        input: raw?.input ?? {},\n        expectedRevision: expected,\n      });\n      const replayed = replay<CommandResult>(id, print);\n      if (replayed) return replayed as CommandResult;\n\n      const finish = (result: CommandResult) => {\n        remember(id, print, result);\n        return result;\n      };\n      const withId = (error: CommandError): CommandResult => ({\n        ok: false,\n        ...(id !== undefined ? { id } : {}),\n        error,\n      });\n\n      const parsed = readCommand(command, schemas, ['id', 'expectedRevision']);\n      if (!parsed.ok) return finish(withId(parsed.error));\n      if (expected !== undefined && expected !== revision) {\n        return finish(\n          withId(\n            err(\n              'conflict',\n              `The plan is at revision ${revision}, not ${expected}. Read the snapshot and try again.`,\n              {\n                details: {\n                  expectedRevision: expected,\n                  currentRevision: revision,\n                },\n              },\n            ),\n          ),\n        );\n      }\n      if (parsed.name === 'undo') {\n        return finish(\n          runUndo(id, parsed.input as { undoId: string; force?: boolean }),\n        );\n      }\n      const before = current;\n      const outcome = execute(\n        catalog,\n        before,\n        parsed.name,\n        parsed.input as never,\n      );\n      if (!outcome.ok) return finish(withId(outcome.error));\n      const revisionBefore = revision;\n      const changed = changedBetween(before, outcome.state);\n      let undoId: string | undefined;\n      if (changed) {\n        current = outcome.state;\n        revision += 1;\n        undoId = recordUndo(before, outcome.state);\n      }\n      const result = finish(\n        toSuccess(\n          id,\n          parsed.name,\n          outcome,\n          revisionBefore,\n          revision,\n          snapshot(),\n          undoId,\n        ),\n      );\n      notify();\n      return result;\n    } catch (cause) {\n      return {\n        ok: false,\n        error: err(\n          'failed',\n          cause instanceof Error ? cause.message : String(cause),\n        ),\n      };\n    }\n  }\n\n  function batch(input: CommandBatch | unknown): BatchResult {\n    const unchanged = (error: CommandError, id?: string): BatchResult => ({\n      ok: false,\n      ...(id !== undefined ? { id } : {}),\n      error,\n      snapshot: snapshot(),\n    });\n    try {\n      if (!input || typeof input !== 'object' || Array.isArray(input)) {\n        return unchanged(\n          err('invalid_input', 'A batch is an object: { commands }.'),\n        );\n      }\n      const raw = input as Record<string, unknown>;\n      const id = raw.id as string | undefined;\n      const idProblem = checkId(id);\n      if (idProblem) return unchanged(idProblem);\n      const revProblem = checkRevision(raw.expectedRevision);\n      if (revProblem) return unchanged(revProblem, id);\n      const print = fingerprint({\n        commands: raw.commands,\n        expectedRevision: raw.expectedRevision,\n      });\n      const replayed = replay<BatchResult>(id, print);\n      if (replayed) {\n        return 'results' in replayed || 'snapshot' in replayed\n          ? (replayed as BatchResult)\n          : unchanged(\n              (replayed as Extract<CommandResult, { ok: false }>).error,\n              id,\n            );\n      }\n      const finish = (result: BatchResult) => {\n        remember(id, print, result);\n        return result;\n      };\n\n      const commands = raw.commands;\n      if (\n        !Array.isArray(commands) ||\n        commands.length === 0 ||\n        commands.length > 50\n      ) {\n        return finish(\n          unchanged(\n            err(\n              'invalid_input',\n              'commands must be a list of 1 to 50 commands.',\n              { path: 'commands' },\n            ),\n            id,\n          ),\n        );\n      }\n      const expected = raw.expectedRevision as number | undefined;\n      if (expected !== undefined && expected !== revision) {\n        return finish(\n          unchanged(\n            err(\n              'conflict',\n              `The plan is at revision ${revision}, not ${expected}. Read the snapshot and try again.`,\n              {\n                details: {\n                  expectedRevision: expected,\n                  currentRevision: revision,\n                },\n              },\n            ),\n            id,\n          ),\n        );\n      }\n\n      const failAt = (index: number, name: unknown, cause: CommandError) =>\n        finish(\n          unchanged(\n            err(\n              'batch_failed',\n              `Command ${index + 1} (${String(name)}) failed: ${cause.message}`,\n              {\n                path: `commands[${index}]`,\n                details: { index, cause },\n              },\n            ),\n            id,\n          ),\n        );\n\n      // Everything runs on a working copy; the live state is replaced once, at the end.\n      const base = current;\n      const baseRevision = revision;\n      let working = base;\n      let rev = baseRevision;\n      const results: Extract<CommandResult, { ok: true }>[] = [];\n      for (const [index, command] of commands.entries()) {\n        const parsed = readCommand(command, schemas, []);\n        if (!parsed.ok)\n          return failAt(\n            index,\n            (command as { name?: unknown })?.name,\n            parsed.error,\n          );\n        if (parsed.name === 'undo') {\n          return failAt(\n            index,\n            'undo',\n            err('invalid_input', 'undo cannot run inside a batch.'),\n          );\n        }\n        const outcome = execute(\n          catalog,\n          working,\n          parsed.name,\n          parsed.input as never,\n        );\n        if (!outcome.ok) return failAt(index, parsed.name, outcome.error);\n        const before = rev;\n        if (changedBetween(working, outcome.state)) rev += 1;\n        working = outcome.state;\n        results.push(\n          toSuccess(\n            undefined,\n            parsed.name,\n            outcome,\n            before,\n            rev,\n            snapshotOf(working, rev),\n          ),\n        );\n      }\n      const changed = rev !== baseRevision;\n      let undoId: string | undefined;\n      if (changed) {\n        current = working;\n        revision = rev;\n        undoId = recordUndo(base, working);\n        // The batch's one undo restores the state before all of it.\n        for (const r of results) if (r.receipt.changed) delete r.receipt.undoId;\n      }\n      const result = finish({\n        ok: true,\n        ...(id !== undefined ? { id } : {}),\n        snapshot: snapshot(),\n        receipt: {\n          ...(id !== undefined ? { id } : {}),\n          count: results.length,\n          changed,\n          revisionBefore: baseRevision,\n          revisionAfter: rev,\n          ...(undoId ? { undoId } : {}),\n        },\n        results,\n      });\n      notify();\n      return result;\n    } catch (cause) {\n      return unchanged(\n        err('failed', cause instanceof Error ? cause.message : String(cause)),\n      );\n    }\n  }\n\n  return {\n    run: run as CookbookEngine['run'],\n    batch,\n    snapshot,\n    cookbook: () => clone(current.doc),\n    state: () => ({\n      version: COOKBOOK_COMMANDS_VERSION,\n      revision,\n      applied: current.applied,\n      cookbook: clone(current.doc),\n      journal: [...journal.values()].map((entry) => clone(entry)),\n    }),\n    subscribe(listener) {\n      listeners.set(listener, revision);\n      listener(snapshot());\n      return () => {\n        listeners.delete(listener);\n      };\n    },\n    tools,\n    batchTool,\n  };\n}\n"],"mappings":"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"}

package/dist/cookbook/engine/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Cookbook command engine (#3753): versioned typed commands, idempotent
+ * retries, atomic batches, revision conflicts, receipts and JSON-Schema tool
+ * definitions over one cookbook document. Browser- and Node-safe; see
+ * `agents/cookbook-engine.md`.
+ */
+export * from './commands.js';
+export * from './defaults.js';
+export { canonical, diagnose, isEmptyCookbook } from './document.js';
+export * from './engine.js';
+export { buildNav, navItemId } from './nav.js';
+export * from './schemas.js';
+export * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/cookbook/engine/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cookbook/engine/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrE,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAC/C,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC"}

package/dist/cookbook/engine/index.js

@@ -0,0 +1,8 @@
+import { COMMERCE_SETTING_TARGETS, DEFAULT_APP_NAME, DEFAULT_COLOR_SCHEME, DEFAULT_PRESET, DEFAULT_THEME_PRESETS, MAX_TERMS_LENGTH } from "./defaults.js";
+import { buildNav, navItemId } from "./nav.js";
+import { canonical, diagnose, isEmptyCookbook } from "./document.js";
+import { adopt, execute, exportFileName, fail, libraryName, serializeCookbook } from "./commands.js";
+import { buildBatchTool, buildCommandTools, checkSchema, commandSchemas } from "./schemas.js";
+import { COOKBOOK_COMMANDS_VERSION } from "./types.js";
+import { createCookbookEngine } from "./engine.js";
+export { COMMERCE_SETTING_TARGETS, COOKBOOK_COMMANDS_VERSION, DEFAULT_APP_NAME, DEFAULT_COLOR_SCHEME, DEFAULT_PRESET, DEFAULT_THEME_PRESETS, MAX_TERMS_LENGTH, adopt, buildBatchTool, buildCommandTools, buildNav, canonical, checkSchema, commandSchemas, createCookbookEngine, diagnose, execute, exportFileName, fail, isEmptyCookbook, libraryName, navItemId, serializeCookbook };

package/dist/cookbook/engine/nav.d.ts

@@ -0,0 +1,45 @@
+import type { Cookbook, CookbookLayout } from '@happyvertical/smrt-types';
+import type { EngineCatalog, EngineModel } from './types.js';
+/** A menu entry after the layout is applied. */
+export interface NavItem {
+    id: string;
+    label: string;
+    defaultLabel: string;
+    hidden: boolean;
+}
+export interface NavSection {
+    /** `section:<id>`, or the id of a custom section. */
+    id: string;
+    label: string;
+    defaultLabel: string;
+    custom: boolean;
+    hidden: boolean;
+    items: NavItem[];
+}
+/** The section that holds feature models no recipe covers. */
+export declare const FEATURE_SECTION: {
+    readonly id: "more";
+    readonly label: "More";
+};
+/** Class name and package id of a qualified model name, from the catalog or the name itself. */
+export declare function modelParts(catalog: EngineCatalog, qualified: string): {
+    packageId: string;
+    name: string;
+};
+/** The stable layout id of a navigation item (same as smrt-svelte's `navItemId`). */
+export declare const navItemId: (packageId: string, modelName: string, key?: string) => string;
+/** `Purchase Order` from `PurchaseOrder`. */
+export declare const humanize: (name: string) => string;
+export declare const modelLabel: (catalog: EngineCatalog, id: string) => string;
+/** The menu with the document's layout applied: moves, order, hides, renames. */
+export declare function buildNav(catalog: EngineCatalog, doc: Pick<Cookbook, 'recipes' | 'features'> & {
+    layout?: CookbookLayout;
+}): NavSection[];
+/** Is this model known as exposed by the catalog? */
+export declare const findModel: (catalog: EngineCatalog, id: string) => EngineModel | undefined;
+/** A section rename; blank or the default label removes the override. */
+export declare function withSectionRenamed(layout: CookbookLayout | undefined, section: NavSection, label: string): CookbookLayout | undefined;
+/** An item rename; `null`, blank or the default label removes the override. */
+export declare function withItemRenamed(layout: CookbookLayout | undefined, item: NavItem, label: string | null): CookbookLayout | undefined;
+export declare function withHidden(layout: CookbookLayout | undefined, id: string, hide: boolean): CookbookLayout | undefined;
+//# sourceMappingURL=nav.d.ts.map

package/dist/cookbook/engine/nav.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nav.d.ts","sourceRoot":"","sources":["../../../src/cookbook/engine/nav.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC1E,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE7D,gDAAgD;AAChD,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,qDAAqD;IACrD,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,OAAO,EAAE,CAAC;CAClB;AAED,8DAA8D;AAC9D,eAAO,MAAM,eAAe;;;CAAyC,CAAC;AAItE,gGAAgG;AAChG,wBAAgB,UAAU,CACxB,OAAO,EAAE,aAAa,EACtB,SAAS,EAAE,MAAM,GAChB;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAOrC;AAED,qFAAqF;AACrF,eAAO,MAAM,SAAS,GACpB,WAAW,MAAM,EACjB,WAAW,MAAM,EACjB,MAAM,MAAM,KACX,MAAiE,CAAC;AAErE,6CAA6C;AAC7C,eAAO,MAAM,QAAQ,GAAI,MAAM,MAAM,KAAG,MAGE,CAAC;AAE3C,eAAO,MAAM,UAAU,GAAI,SAAS,aAAa,EAAE,IAAI,MAAM,KAAG,MACxB,CAAC;AAmEzC,iFAAiF;AACjF,wBAAgB,QAAQ,CACtB,OAAO,EAAE,aAAa,EACtB,GAAG,EAAE,IAAI,CAAC,QAAQ,EAAE,SAAS,GAAG,UAAU,CAAC,GAAG;IAAE,MAAM,CAAC,EAAE,cAAc,CAAA;CAAE,GACxE,UAAU,EAAE,CAmDd;AAED,qDAAqD;AACrD,eAAO,MAAM,SAAS,GACpB,SAAS,aAAa,EACtB,IAAI,MAAM,KACT,WAAW,GAAG,SAAoD,CAAC;AAqBtE,yEAAyE;AACzE,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,cAAc,GAAG,SAAS,EAClC,OAAO,EAAE,UAAU,EACnB,KAAK,EAAE,MAAM,GACZ,cAAc,GAAG,SAAS,CAoB5B;AAED,+EAA+E;AAC/E,wBAAgB,eAAe,CAC7B,MAAM,EAAE,cAAc,GAAG,SAAS,EAClC,IAAI,EAAE,OAAO,EACb,KAAK,EAAE,MAAM,GAAG,IAAI,GACnB,cAAc,GAAG,SAAS,CAa5B;AAED,wBAAgB,UAAU,CACxB,MAAM,EAAE,cAAc,GAAG,SAAS,EAClC,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,OAAO,GACZ,cAAc,GAAG,SAAS,CAO5B"}