@happyvertical/smrt-playbooks 0.44.0

package/dist/index.js

@@ -0,0 +1,734 @@
+import { PLAYBOOK_PLANES } from "./types.js";
+import { ObjectRegistry, SmrtCollection, SmrtObject, field, smrt } from "@happyvertical/smrt-core";
+import { getPackageConfig } from "@happyvertical/smrt-config";
+import { getTenantId } from "@happyvertical/smrt-tenancy";
+//#region \0rolldown/runtime.js
+var __defProp$1 = Object.defineProperty;
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) __defProp$1(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+	if (!no_symbols) __defProp$1(target, Symbol.toStringTag, { value: "Module" });
+	return target;
+};
+//#endregion
+//#region src/__smrt-register__.ts
+ObjectRegistry.registerPackageManifest(JSON.parse("{\"version\":\"1.0.0\",\"timestamp\":0,\"packageName\":\"@happyvertical/smrt-playbooks\",\"packageVersion\":\"0.44.0\",\"objects\":{\"@happyvertical/smrt-playbooks:PlaybookOverrideCollection\":{\"name\":\"playbookoverridecollection\",\"className\":\"PlaybookOverrideCollection\",\"qualifiedName\":\"@happyvertical/smrt-playbooks:PlaybookOverrideCollection\",\"collection\":\"playbookoverrides\",\"filePath\":\"/home/runner/work/smrt/smrt/packages/playbooks/src/collections/PlaybookOverrideCollection.ts\",\"packageName\":\"@happyvertical/smrt-playbooks\",\"fields\":{},\"methods\":{\"getAppOverride\":{\"name\":\"getAppOverride\",\"async\":true,\"parameters\":[{\"name\":\"key\",\"type\":\"string\",\"optional\":false},{\"name\":\"options\",\"type\":\"object\",\"optional\":true}],\"returnType\":\"Promise<PlaybookOverride | null>\",\"isStatic\":false,\"isPublic\":true},\"getTenantOverride\":{\"name\":\"getTenantOverride\",\"async\":true,\"parameters\":[{\"name\":\"key\",\"type\":\"string\",\"optional\":false},{\"name\":\"tenantId\",\"type\":\"string\",\"optional\":false},{\"name\":\"options\",\"type\":\"object\",\"optional\":true}],\"returnType\":\"Promise<PlaybookOverride | null>\",\"isStatic\":false,\"isPublic\":true},\"getResolutionLayers\":{\"name\":\"getResolutionLayers\",\"async\":true,\"parameters\":[{\"name\":\"key\",\"type\":\"string\",\"optional\":false},{\"name\":\"tenantId\",\"type\":\"string | null\",\"optional\":true},{\"name\":\"options\",\"type\":\"object\",\"optional\":true}],\"returnType\":\"Promise<object>\",\"isStatic\":false,\"isPublic\":true}},\"decoratorConfig\":{\"tableName\":\"_smrt_playbook_overrides\"},\"extends\":\"SmrtCollection\",\"extendsTypeArg\":\"PlaybookOverride\",\"exportName\":\"PlaybookOverrideCollection\",\"collectionExportName\":\"PlaybookOverrideCollectionCollection\",\"schema\":{\"tableName\":\"_smrt_playbook_overrides\",\"ddl\":\"CREATE TABLE IF NOT EXISTS \\\"_smrt_playbook_overrides\\\" (\\n  \\\"id\\\" UUID PRIMARY KEY NOT NULL,\\n  \\\"slug\\\" TEXT NOT NULL,\\n  \\\"context\\\" TEXT NOT NULL DEFAULT '',\\n  \\\"created_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"updated_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp\\n);\",\"columns\":{\"id\":{\"type\":\"UUID\",\"primaryKey\":true,\"referenceKind\":\"id\",\"notNull\":true},\"slug\":{\"type\":\"TEXT\",\"notNull\":true},\"context\":{\"type\":\"TEXT\",\"notNull\":true,\"default\":\"\"},\"created_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"updated_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"}},\"indexes\":[{\"name\":\"_smrt_playbook_overrides_slug_context_idx\",\"columns\":[\"slug\",\"context\"],\"unique\":true},{\"name\":\"_smrt_playbook_overrides_created_at_idx\",\"columns\":[\"created_at\"]}],\"version\":\"410e08c4\"}},\"@happyvertical/smrt-playbooks:PlaybookOverride\":{\"name\":\"playbookoverride\",\"className\":\"PlaybookOverride\",\"qualifiedName\":\"@happyvertical/smrt-playbooks:PlaybookOverride\",\"collection\":\"playbookoverrides\",\"filePath\":\"/home/runner/work/smrt/smrt/packages/playbooks/src/models/PlaybookOverride.ts\",\"packageName\":\"@happyvertical/smrt-playbooks\",\"fields\":{\"key\":{\"type\":\"text\",\"required\":true,\"default\":\"\",\"_meta\":{\"required\":true}},\"tenantId\":{\"type\":\"text\",\"required\":false,\"_meta\":{\"nullable\":true}},\"title\":{\"type\":\"text\",\"required\":false,\"_meta\":{\"nullable\":true}},\"description\":{\"type\":\"text\",\"required\":false,\"_meta\":{\"nullable\":true}},\"planes\":{\"type\":\"text\",\"required\":false,\"_meta\":{\"nullable\":true}},\"onStepFailure\":{\"type\":\"text\",\"required\":false,\"_meta\":{\"nullable\":true}},\"enabled\":{\"type\":\"boolean\",\"required\":false,\"_meta\":{\"nullable\":true}},\"metadata\":{\"type\":\"text\",\"required\":false,\"_meta\":{\"nullable\":true}}},\"methods\":{\"getMetadata\":{\"name\":\"getMetadata\",\"async\":false,\"parameters\":[],\"returnType\":\"PlaybookMetadata\",\"isStatic\":false,\"isPublic\":true},\"setMetadata\":{\"name\":\"setMetadata\",\"async\":false,\"parameters\":[{\"name\":\"metadata\",\"type\":\"PlaybookMetadata | null\",\"optional\":false}],\"returnType\":\"void\",\"isStatic\":false,\"isPublic\":true},\"getPlanes\":{\"name\":\"getPlanes\",\"async\":false,\"parameters\":[],\"returnType\":\"null\",\"isStatic\":false,\"isPublic\":true},\"setPlanes\":{\"name\":\"setPlanes\",\"async\":false,\"parameters\":[{\"name\":\"planes\",\"type\":\"null\",\"optional\":false}],\"returnType\":\"void\",\"isStatic\":false,\"isPublic\":true},\"toPlaybookLayer\":{\"name\":\"toPlaybookLayer\",\"async\":false,\"parameters\":[],\"returnType\":\"PlaybookLayer\",\"isStatic\":false,\"isPublic\":true},\"save\":{\"name\":\"save\",\"async\":true,\"parameters\":[],\"returnType\":\"Promise\",\"isStatic\":false,\"isPublic\":true},\"delete\":{\"name\":\"delete\",\"async\":true,\"parameters\":[],\"returnType\":\"Promise<void>\",\"isStatic\":false,\"isPublic\":true}},\"decoratorConfig\":{\"tableName\":\"_smrt_playbook_overrides\",\"conflictColumns\":[\"key\",\"context\"],\"api\":{\"include\":[\"list\",\"get\",\"create\",\"update\",\"delete\"]},\"cli\":{\"include\":[\"list\",\"get\",\"create\",\"update\",\"delete\"],\"exclude\":[\"getMetadata\",\"setMetadata\",\"getPlanes\",\"setPlanes\",\"toPlaybookLayer\"]},\"mcp\":{\"include\":[]}},\"extends\":\"SmrtObject\",\"exportName\":\"PlaybookOverride\",\"collectionExportName\":\"PlaybookOverrideCollection\",\"validationRules\":[{\"field\":\"key\",\"rule\":\"required\",\"fieldType\":\"text\"}],\"schema\":{\"tableName\":\"_smrt_playbook_overrides\",\"ddl\":\"CREATE TABLE IF NOT EXISTS \\\"_smrt_playbook_overrides\\\" (\\n  \\\"id\\\" UUID PRIMARY KEY NOT NULL,\\n  \\\"slug\\\" TEXT NOT NULL,\\n  \\\"context\\\" TEXT NOT NULL DEFAULT '',\\n  \\\"created_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"updated_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"key\\\" TEXT NOT NULL DEFAULT '',\\n  \\\"tenant_id\\\" TEXT,\\n  \\\"title\\\" TEXT,\\n  \\\"description\\\" TEXT,\\n  \\\"planes\\\" TEXT,\\n  \\\"on_step_failure\\\" TEXT,\\n  \\\"enabled\\\" BOOLEAN,\\n  \\\"metadata\\\" TEXT\\n);\",\"columns\":{\"id\":{\"type\":\"UUID\",\"primaryKey\":true,\"referenceKind\":\"id\",\"notNull\":true},\"slug\":{\"type\":\"TEXT\",\"notNull\":true},\"context\":{\"type\":\"TEXT\",\"notNull\":true,\"default\":\"\"},\"created_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"updated_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"key\":{\"type\":\"TEXT\",\"notNull\":true,\"unique\":false,\"default\":\"\"},\"tenant_id\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"title\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"description\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"planes\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"on_step_failure\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"enabled\":{\"type\":\"BOOLEAN\",\"notNull\":false,\"unique\":false},\"metadata\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false}},\"indexes\":[{\"name\":\"_smrt_playbook_overrides_key_context_idx\",\"columns\":[\"key\",\"context\"],\"unique\":true},{\"name\":\"_smrt_playbook_overrides_slug_context_idx\",\"columns\":[\"slug\",\"context\"]},{\"name\":\"_smrt_playbook_overrides_created_at_idx\",\"columns\":[\"created_at\"]}],\"version\":\"8aec8e13\"}}},\"moduleType\":\"smrt\",\"smrtDependencies\":[\"@happyvertical/smrt-core\",\"@happyvertical/smrt-tenancy\"]}"));
+//#endregion
+//#region src/cache.ts
+var PLAYBOOK_CACHE_TTL_MS = 3e4;
+var playbookCache = /* @__PURE__ */ new Map();
+var cacheGenerations = /* @__PURE__ */ new Map();
+var dbInstanceIds = /* @__PURE__ */ new WeakMap();
+var nextDbId = 1;
+function getDbNamespace(db) {
+	if (!db) return "no-db";
+	if (typeof db === "string") return `db:${db}`;
+	if (typeof db === "object") {
+		const dbObject = db;
+		if (typeof dbObject.query === "function") {
+			if (!dbInstanceIds.has(dbObject)) dbInstanceIds.set(dbObject, `db-instance:${nextDbId++}`);
+			const namespace = dbInstanceIds.get(dbObject);
+			if (namespace) return namespace;
+			return "db-instance:unknown";
+		}
+		try {
+			return `db-config:${JSON.stringify(dbObject)}`;
+		} catch {
+			return "db-config:opaque";
+		}
+	}
+	return "db:unknown";
+}
+function buildCacheKey(key, tenantId, db) {
+	return `${getDbNamespace(db)}::${key}::${tenantId ?? "app"}`;
+}
+function buildGenerationKey(key, db) {
+	return `${getDbNamespace(db)}::${key}`;
+}
+function bumpGeneration(key, db) {
+	const generationKey = buildGenerationKey(key, db);
+	cacheGenerations.set(generationKey, (cacheGenerations.get(generationKey) ?? 0) + 1);
+}
+function getPlaybookCacheTtlMs() {
+	return PLAYBOOK_CACHE_TTL_MS;
+}
+function getCachedPlaybookBase(key, tenantId, db) {
+	const cacheKey = buildCacheKey(key, tenantId, db);
+	const cached = playbookCache.get(cacheKey);
+	if (!cached) return null;
+	if (cached.expiresAt <= Date.now()) {
+		playbookCache.delete(cacheKey);
+		return null;
+	}
+	return cached.value;
+}
+function getPlaybookCacheGeneration(key, db) {
+	return cacheGenerations.get(buildGenerationKey(key, db)) ?? 0;
+}
+function setCachedPlaybookBase(key, tenantId, db, value, loadedAtGeneration) {
+	if (getPlaybookCacheGeneration(key, db) !== loadedAtGeneration) return;
+	playbookCache.set(buildCacheKey(key, tenantId, db), {
+		expiresAt: Date.now() + PLAYBOOK_CACHE_TTL_MS,
+		value
+	});
+}
+function invalidatePlaybookCache(key, tenantId, db) {
+	const dbNamespace = getDbNamespace(db);
+	bumpGeneration(key, db);
+	if (tenantId !== null && tenantId !== void 0) {
+		playbookCache.delete(buildCacheKey(key, tenantId, db));
+		return;
+	}
+	const keyPrefix = `${dbNamespace}::${key}::`;
+	for (const cacheKey of playbookCache.keys()) if (cacheKey.startsWith(keyPrefix)) playbookCache.delete(cacheKey);
+}
+function clearPlaybookCache() {
+	playbookCache.clear();
+	for (const generationKey of cacheGenerations.keys()) cacheGenerations.set(generationKey, (cacheGenerations.get(generationKey) ?? 0) + 1);
+}
+//#endregion
+//#region src/utils.ts
+var DEFAULT_EDITABLE = {
+	title: false,
+	description: false,
+	planes: false,
+	onStepFailure: false,
+	enabled: false,
+	metadata: false
+};
+var FAIL_CLOSED_CLASSIFICATION = {
+	effect: "destructive",
+	idempotent: false,
+	openWorld: true
+};
+var FAILURE_POLICIES = /* @__PURE__ */ new Set(["abort", "continue"]);
+var QUALIFIED_MODEL_PATTERN = /^\S+:\S+$/;
+var BROWSER_ONLY_PLANES = Object.freeze(["browser"]);
+function isPlainObject(value) {
+	return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function normalizeEditableConfig(editable) {
+	const flag = (name) => {
+		const supplied = editable?.[name];
+		if (supplied === void 0) return DEFAULT_EDITABLE[name];
+		if (typeof supplied !== "boolean") throw new Error(`Playbook editable.${name} must be a boolean, received ${typeof supplied} "${String(supplied)}"`);
+		return supplied;
+	};
+	return {
+		title: flag("title"),
+		description: flag("description"),
+		planes: flag("planes"),
+		onStepFailure: flag("onStepFailure"),
+		enabled: flag("enabled"),
+		metadata: flag("metadata")
+	};
+}
+function applyCapabilityDeclaration(declaration) {
+	if (!isPlainObject(declaration)) return { ...FAIL_CLOSED_CLASSIFICATION };
+	return {
+		effect: declaration.effect ?? FAIL_CLOSED_CLASSIFICATION.effect,
+		idempotent: declaration.idempotent ?? FAIL_CLOSED_CLASSIFICATION.idempotent,
+		openWorld: declaration.openWorld ?? FAIL_CLOSED_CLASSIFICATION.openWorld
+	};
+}
+function isCapabilityDeclarationComplete(declaration) {
+	return isPlainObject(declaration) && declaration.effect !== void 0 && declaration.idempotent !== void 0 && declaration.openWorld !== void 0;
+}
+function normalizePlanes(planes, context) {
+	if (planes === void 0) return;
+	if (planes === null) return;
+	if (!Array.isArray(planes)) throw new Error(`${context} planes must be an array`);
+	const normalized = [];
+	for (const plane of planes) {
+		if (!PLAYBOOK_PLANES.includes(plane)) throw new Error(`${context} declares unknown plane "${String(plane)}"; expected one of ${PLAYBOOK_PLANES.join(", ")}`);
+		if (!normalized.includes(plane)) normalized.push(plane);
+	}
+	if (normalized.length === 0) throw new Error(`${context} must declare at least one plane`);
+	return PLAYBOOK_PLANES.filter((plane) => normalized.includes(plane));
+}
+function normalizeFailurePolicy(value, context) {
+	if (!FAILURE_POLICIES.has(value)) throw new Error(`${context} onStepFailure must be "abort" or "continue", received "${String(value)}"`);
+	return value;
+}
+function normalizeEnabled(value, context) {
+	if (typeof value !== "boolean") throw new Error(`${context} enabled must be a boolean, received ${typeof value} "${String(value)}"`);
+	return value;
+}
+function normalizeStepOptional(value, context) {
+	if (typeof value !== "boolean") throw new Error(`${context} optional must be a boolean, received ${typeof value} "${String(value)}"`);
+	return value;
+}
+function normalizeOptionalText(value, context, field) {
+	if (value === void 0) return;
+	if (typeof value !== "string") throw new Error(`${context} ${field} must be a string`);
+	return value;
+}
+function normalizeSteps(steps, context) {
+	if (!Array.isArray(steps) || steps.length === 0) throw new Error(`${context} requires at least one step`);
+	return Object.freeze(steps.map((rawStep, index) => {
+		const stepContext = `${context} step ${index}`;
+		if (!isPlainObject(rawStep)) throw new Error(`${stepContext} must be an object`);
+		const kind = rawStep.kind;
+		if (kind === "playbook" || "playbook" in rawStep) throw new Error(`${stepContext} references another playbook; nested playbooks are not supported`);
+		if (kind === "operation") {
+			const model = rawStep.model;
+			const action = rawStep.action;
+			if (typeof model !== "string" || model.trim() === "") throw new Error(`${stepContext} requires a qualified model name`);
+			if (!QUALIFIED_MODEL_PATTERN.test(model)) throw new Error(`${stepContext} model "${model}" must be a qualified pair such as "@happyvertical/smrt-commerce:Order"`);
+			if (typeof action !== "string" || action.trim() === "") throw new Error(`${stepContext} requires an action name`);
+			return Object.freeze({
+				kind: "operation",
+				model,
+				action,
+				...normalizeOptionalText(rawStep.label, stepContext, "label") !== void 0 ? { label: rawStep.label } : {},
+				...normalizeOptionalText(rawStep.description, stepContext, "description") !== void 0 ? { description: rawStep.description } : {},
+				...rawStep.optional === void 0 ? {} : { optional: normalizeStepOptional(rawStep.optional, stepContext) }
+			});
+		}
+		if (kind === "intent") {
+			const id = rawStep.id;
+			if (typeof id !== "string" || id.trim() === "") throw new Error(`${stepContext} requires an intent id`);
+			return Object.freeze({
+				kind: "intent",
+				id,
+				...normalizeOptionalText(rawStep.label, stepContext, "label") !== void 0 ? { label: rawStep.label } : {},
+				...normalizeOptionalText(rawStep.description, stepContext, "description") !== void 0 ? { description: rawStep.description } : {},
+				...rawStep.optional === void 0 ? {} : { optional: normalizeStepOptional(rawStep.optional, stepContext) }
+			});
+		}
+		throw new Error(`${stepContext} has unknown kind "${String(kind)}"; expected "operation" or "intent"`);
+	}));
+}
+function hasIntentStep(steps) {
+	return steps.some((step) => step.kind === "intent");
+}
+function defaultPlanesForSteps(steps) {
+	return hasIntentStep(steps) ? BROWSER_ONLY_PLANES : PLAYBOOK_PLANES;
+}
+function normalizePlaybookDefinitionInput(input) {
+	if (!input || typeof input.key !== "string" || input.key.trim() === "") throw new Error("Playbook definitions require a non-empty key");
+	const context = `Playbook "${input.key}"`;
+	if (typeof input.title !== "string" || input.title.trim() === "") throw new Error(`${context} requires a title`);
+	if (typeof input.description !== "string" || input.description.trim() === "") throw new Error(`${context} requires a description`);
+	if ("steps" in (input.editable ?? {})) throw new Error(`${context} cannot mark steps editable; playbook step lists are never editable`);
+	const steps = normalizeSteps(input.steps, context);
+	const declaredPlanes = normalizePlanes(input.planes, context);
+	return Object.freeze({
+		key: input.key,
+		title: input.title,
+		description: input.description,
+		steps,
+		planes: Object.freeze(declaredPlanes ?? defaultPlanesForSteps(steps)),
+		onStepFailure: input.onStepFailure === void 0 ? "abort" : normalizeFailurePolicy(input.onStepFailure, context),
+		enabled: input.enabled === void 0 ? true : normalizeEnabled(input.enabled, context),
+		metadata: Object.freeze(input.metadata ? sanitizeMetadata(input.metadata) : {}),
+		editable: Object.freeze(normalizeEditableConfig(input.editable))
+	});
+}
+function sanitizeMetadata(metadata) {
+	if (!isPlainObject(metadata)) return {};
+	return deepFreezeJsonObject(metadata);
+}
+function deepFreezeJsonValue(value) {
+	if (Array.isArray(value)) return Object.freeze(value.map(deepFreezeJsonValue));
+	if (isPlainObject(value)) return deepFreezeJsonObject(value);
+	return value;
+}
+function deepFreezeJsonObject(source) {
+	const copied = {};
+	for (const [key, value] of Object.entries(source)) {
+		if (value === void 0) continue;
+		copied[key] = deepFreezeJsonValue(value);
+	}
+	return Object.freeze(copied);
+}
+function parseMetadata(raw) {
+	if (!raw) return {};
+	try {
+		const parsed = JSON.parse(raw);
+		return isPlainObject(parsed) ? sanitizeMetadata(parsed) : {};
+	} catch {
+		return {};
+	}
+}
+function serializeMetadata(metadata) {
+	if (metadata === null || metadata === void 0) return null;
+	return JSON.stringify(sanitizeMetadata(metadata));
+}
+function parsePlanes(raw) {
+	if (!raw) return null;
+	try {
+		const parsed = JSON.parse(raw);
+		if (!Array.isArray(parsed)) return null;
+		return normalizePlanes(parsed, "Stored override") ?? null;
+	} catch {
+		return null;
+	}
+}
+function serializePlanes(planes) {
+	if (planes === null || planes === void 0) return null;
+	return JSON.stringify(normalizePlanes(planes, "Stored override") ?? []);
+}
+function normalizePlaybookLayer(input, context = "Playbook override") {
+	if (!isPlainObject(input)) return {};
+	if ("steps" in input) throw new Error(`${context} cannot set steps; playbook step lists are never editable`);
+	const layer = {};
+	if (input.title !== void 0) layer.title = input.title === null ? null : normalizeOptionalText(input.title, context, "title") ?? null;
+	if (input.description !== void 0) layer.description = input.description === null ? null : normalizeOptionalText(input.description, context, "description") ?? null;
+	if (input.planes !== void 0) layer.planes = input.planes === null ? null : normalizePlanes(input.planes, context) ?? null;
+	if (input.onStepFailure !== void 0) layer.onStepFailure = input.onStepFailure === null ? null : normalizeFailurePolicy(input.onStepFailure, context);
+	if (input.enabled !== void 0) layer.enabled = input.enabled === null ? null : normalizeEnabled(input.enabled, context);
+	if (input.metadata !== void 0) layer.metadata = input.metadata === null ? null : sanitizeMetadata(input.metadata);
+	return layer;
+}
+function mergePlaybookLayers(base, ...layers) {
+	let title = base.title;
+	let description = base.description;
+	let planes = base.planes;
+	let onStepFailure = base.onStepFailure;
+	let enabled = base.enabled;
+	let metadata = { ...base.metadata };
+	for (const layer of layers) {
+		if (!layer) continue;
+		if (layer.title !== void 0 && layer.title !== null) title = layer.title;
+		if (layer.description !== void 0 && layer.description !== null) description = layer.description;
+		if (layer.planes !== void 0 && layer.planes !== null) planes = layer.planes.filter((plane) => planes.includes(plane));
+		if (layer.onStepFailure !== void 0 && layer.onStepFailure !== null) onStepFailure = layer.onStepFailure;
+		if (layer.enabled !== void 0 && layer.enabled !== null) enabled = enabled && layer.enabled;
+		if (layer.metadata !== void 0 && layer.metadata !== null) metadata = {
+			...metadata,
+			...layer.metadata
+		};
+	}
+	return Object.freeze({
+		title,
+		description,
+		planes: Object.freeze(planes),
+		onStepFailure,
+		enabled,
+		metadata: Object.freeze(metadata)
+	});
+}
+//#endregion
+//#region src/playbook-registry.ts
+function getRegistry() {
+	if (!globalThis.__smrtPlaybookRegistry) globalThis.__smrtPlaybookRegistry = /* @__PURE__ */ new Map();
+	return globalThis.__smrtPlaybookRegistry;
+}
+function stableStringify(value) {
+	if (Array.isArray(value)) return `[${value.map((item) => stableStringify(item)).join(",")}]`;
+	if (value && typeof value === "object") return `{${Object.entries(value).sort(([left], [right]) => left.localeCompare(right)).map(([key, item]) => `${JSON.stringify(key)}:${stableStringify(item)}`).join(",")}}`;
+	return JSON.stringify(value);
+}
+var PlaybookRegistry = {
+	register(input) {
+		const definition = normalizePlaybookDefinitionInput(input);
+		const registry = getRegistry();
+		const existing = registry.get(definition.key);
+		if (existing) {
+			if (stableStringify(existing) !== stableStringify(definition)) throw new Error(`Playbook "${definition.key}" is already registered with a different definition`);
+			return existing;
+		}
+		registry.set(definition.key, definition);
+		return definition;
+	},
+	get(key) {
+		return getRegistry().get(key);
+	},
+	has(key) {
+		return getRegistry().has(key);
+	},
+	getAll() {
+		return Array.from(getRegistry().values());
+	},
+	clear() {
+		getRegistry().clear();
+	}
+};
+function definePlaybook(input) {
+	return PlaybookRegistry.register(input);
+}
+//#endregion
+//#region src/models/PlaybookOverride.ts
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __decorateClass = (decorators, target, key, kind) => {
+	var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+	for (var i = decorators.length - 1, decorator; i >= 0; i--) if (decorator = decorators[i]) result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+	if (kind && result) __defProp(target, key, result);
+	return result;
+};
+function getPlaybookConfig$1() {
+	return getPackageConfig("playbooks", { playbooks: {} });
+}
+var PlaybookOverride = class extends SmrtObject {
+	key = "";
+	tenantId = null;
+	title = null;
+	description = null;
+	planes = null;
+	onStepFailure = null;
+	enabled = null;
+	metadata = null;
+	constructor(options = {}) {
+		super(options);
+		if (options.steps !== void 0) throw new Error("Playbook step lists are never editable; PlaybookOverride cannot carry steps");
+		if (options.key !== void 0) this.key = options.key;
+		if (options.tenantId !== void 0) this.tenantId = options.tenantId;
+		if (options.title !== void 0) this.title = options.title;
+		if (options.description !== void 0) this.description = options.description;
+		if (options.onStepFailure !== void 0) this.onStepFailure = options.onStepFailure;
+		if (options.enabled !== void 0) this.enabled = options.enabled;
+		if (options.planes !== void 0) this.planes = typeof options.planes === "string" || options.planes === null ? options.planes : serializePlanes(options.planes);
+		if (options.metadata !== void 0) this.metadata = typeof options.metadata === "string" || options.metadata === null ? options.metadata : serializeMetadata(options.metadata);
+	}
+	getMetadata() {
+		return parseMetadata(this.metadata);
+	}
+	setMetadata(metadata) {
+		this.metadata = serializeMetadata(metadata);
+	}
+	getPlanes() {
+		return parsePlanes(this.planes);
+	}
+	setPlanes(planes) {
+		this.planes = serializePlanes(planes);
+	}
+	toPlaybookLayer() {
+		return {
+			title: this.title,
+			description: this.description,
+			planes: this.getPlanes(),
+			onStepFailure: this.onStepFailure ?? null,
+			enabled: this.enabled === null || this.enabled === void 0 ? null : Boolean(this.enabled),
+			metadata: this.metadata === null ? null : this.getMetadata()
+		};
+	}
+	async save() {
+		const previousIdentity = await this.getPersistedIdentity();
+		this.normalizeForPersistence();
+		await this.validatePlaybookOverride();
+		this.context = this.tenantId ?? "__app__";
+		const identityChanged = !!previousIdentity && (previousIdentity.key !== this.key || previousIdentity.tenantId !== this.tenantId);
+		const result = identityChanged && previousIdentity ? await this.saveAfterIdentityChange() : await super.save();
+		if (identityChanged && previousIdentity) invalidatePlaybookCache(previousIdentity.key, previousIdentity.tenantId, this.db);
+		invalidatePlaybookCache(this.key, this.tenantId, this.db);
+		return result;
+	}
+	async saveAfterIdentityChange() {
+		if (typeof this.db.beginTransaction === "function") return this.saveAfterIdentityChangeInTransaction();
+		return this.saveAfterIdentityChangeWithDeferredDelete();
+	}
+	async saveAfterIdentityChangeInTransaction() {
+		const originalDb = this._db;
+		const originalOptionsDb = this.options.db;
+		const tx = await this.db.beginTransaction?.();
+		if (!tx) return this.saveAfterIdentityChangeWithDeferredDelete();
+		try {
+			this._db = tx;
+			this.options.db = tx;
+			await super.delete();
+			const result = await super.save();
+			await tx.commit();
+			return result;
+		} catch (error) {
+			try {
+				await tx.rollback();
+			} catch {}
+			throw error;
+		} finally {
+			this._db = originalDb;
+			this.options.db = originalOptionsDb;
+		}
+	}
+	async saveAfterIdentityChangeWithDeferredDelete() {
+		const previousId = this.id;
+		if (!previousId) return super.save();
+		const replacementId = crypto.randomUUID();
+		let replacementSaved = false;
+		this.id = replacementId;
+		try {
+			const result = await super.save();
+			replacementSaved = true;
+			await this.db.delete(this.tableName, { id: previousId });
+			return result;
+		} catch (error) {
+			if (replacementSaved) try {
+				await this.db.delete(this.tableName, { id: replacementId });
+			} catch {}
+			this.id = previousId;
+			throw error;
+		}
+	}
+	async delete() {
+		const key = this.key;
+		const tenantId = this.tenantId;
+		await super.delete();
+		invalidatePlaybookCache(key, tenantId, this.db);
+	}
+	async validatePlaybookOverride() {
+		if (!this.key || this.key.trim() === "") throw new Error("PlaybookOverride.key is required");
+		if (this.steps !== void 0) throw new Error(`Playbook "${this.key}" step lists are never editable; PlaybookOverride cannot carry steps`);
+		const definition = PlaybookRegistry.get(this.key);
+		if (!definition) throw new Error(`Unknown playbook key "${this.key}"`);
+		const editable = definition.editable;
+		if (this.title !== null && !editable.title) throw new Error(`Playbook "${this.key}" does not allow title overrides`);
+		if (this.description !== null && !editable.description) throw new Error(`Playbook "${this.key}" does not allow description overrides`);
+		if (this.planes !== null && !editable.planes) throw new Error(`Playbook "${this.key}" does not allow planes overrides`);
+		if (this.onStepFailure !== null && !editable.onStepFailure) throw new Error(`Playbook "${this.key}" does not allow onStepFailure overrides`);
+		if (this.enabled !== null && !editable.enabled) throw new Error(`Playbook "${this.key}" does not allow enablement overrides`);
+		if (this.metadata !== null && !editable.metadata) throw new Error(`Playbook "${this.key}" does not allow metadata overrides`);
+		if (this.metadata !== null) {
+			let parsed;
+			try {
+				parsed = JSON.parse(this.metadata);
+			} catch (error) {
+				throw new Error(`Playbook "${this.key}" has invalid metadata JSON: ${error instanceof Error ? error.message : String(error)}`);
+			}
+			if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) throw new Error(`Playbook "${this.key}" metadata must be a JSON object`);
+		}
+		if (this.planes !== null) {
+			const parsedPlanes = parsePlanes(this.planes);
+			if (!parsedPlanes || parsedPlanes.length === 0) throw new Error(`Playbook "${this.key}" planes must be a non-empty JSON array of plane names`);
+		}
+		if (this.onStepFailure !== null && this.onStepFailure !== "abort" && this.onStepFailure !== "continue") throw new Error(`Playbook "${this.key}" onStepFailure must be "abort" or "continue"`);
+		const lowerLayers = await this.getLowerPrecedenceLayers();
+		const currentLayer = this.toPlaybookLayer();
+		const lowerMerged = mergePlaybookLayers(definition, ...lowerLayers);
+		if (this.enabled === true && !lowerMerged.enabled) throw new Error(`Playbook "${this.key}" is disabled by a lower layer and cannot be re-enabled by an override`);
+		if (currentLayer.planes) {
+			const widened = currentLayer.planes.filter((plane) => !lowerMerged.planes.includes(plane));
+			if (widened.length > 0) throw new Error(`Playbook "${this.key}" cannot add plane(s) ${widened.join(", ")} that no lower layer declares`);
+		}
+	}
+	async getLowerPrecedenceLayers() {
+		const layers = [normalizePlaybookLayer(getPlaybookConfig$1().playbooks?.[this.key], `Playbook "${this.key}" config override`)];
+		const { PlaybookOverrideCollection } = await Promise.resolve().then(() => PlaybookOverrideCollection_exports);
+		const collection = await PlaybookOverrideCollection.create({ db: this.options.db ?? this.options.persistence });
+		if (this.tenantId) {
+			const appOverride = await collection.getAppOverride(this.key, { excludeId: this.id ?? void 0 });
+			if (appOverride) layers.push(appOverride.toPlaybookLayer());
+		}
+		return layers;
+	}
+	normalizeForPersistence() {
+		const rawMetadata = this.metadata;
+		if (rawMetadata === void 0) this.metadata = null;
+		else if (rawMetadata !== null && typeof rawMetadata === "object" && !Array.isArray(rawMetadata)) this.metadata = serializeMetadata(rawMetadata);
+		else if (rawMetadata !== null && typeof rawMetadata !== "string") throw new Error(`Playbook "${this.key}" metadata must be a JSON object or JSON string`);
+		const rawPlanes = this.planes;
+		if (rawPlanes === void 0) this.planes = null;
+		else if (Array.isArray(rawPlanes)) this.planes = serializePlanes(rawPlanes);
+		else if (rawPlanes !== null && typeof rawPlanes !== "string") throw new Error(`Playbook "${this.key}" planes must be an array or JSON string`);
+		if (this.enabled === void 0) this.enabled = null;
+		else if (this.enabled !== null && typeof this.enabled !== "boolean") throw new Error(`Playbook "${this.key}" enabled must be a boolean or null, received ${typeof this.enabled} "${String(this.enabled)}"`);
+	}
+	async getPersistedIdentity() {
+		if (!this.id) return null;
+		const existing = await this.db.get(this.tableName, { id: this.id });
+		if (!existing) return null;
+		const row = existing;
+		return {
+			key: String(row.key ?? this.key),
+			tenantId: row.tenantId !== void 0 ? row.tenantId : row.tenant_id ?? null
+		};
+	}
+};
+__decorateClass([field({ required: true })], PlaybookOverride.prototype, "key", 2);
+__decorateClass([field({
+	type: "text",
+	nullable: true
+})], PlaybookOverride.prototype, "tenantId", 2);
+__decorateClass([field({
+	type: "text",
+	nullable: true
+})], PlaybookOverride.prototype, "title", 2);
+__decorateClass([field({
+	type: "text",
+	nullable: true
+})], PlaybookOverride.prototype, "description", 2);
+__decorateClass([field({
+	type: "text",
+	nullable: true
+})], PlaybookOverride.prototype, "planes", 2);
+__decorateClass([field({
+	type: "text",
+	nullable: true
+})], PlaybookOverride.prototype, "onStepFailure", 2);
+__decorateClass([field({
+	type: "boolean",
+	nullable: true
+})], PlaybookOverride.prototype, "enabled", 2);
+__decorateClass([field({
+	type: "text",
+	nullable: true
+})], PlaybookOverride.prototype, "metadata", 2);
+PlaybookOverride = __decorateClass([smrt({
+	tableName: "_smrt_playbook_overrides",
+	conflictColumns: ["key", "context"],
+	api: { include: [
+		"list",
+		"get",
+		"create",
+		"update",
+		"delete"
+	] },
+	cli: {
+		include: [
+			"list",
+			"get",
+			"create",
+			"update",
+			"delete"
+		],
+		exclude: [
+			"getMetadata",
+			"setMetadata",
+			"getPlanes",
+			"setPlanes",
+			"toPlaybookLayer"
+		]
+	},
+	mcp: { include: [] }
+})], PlaybookOverride);
+//#endregion
+//#region src/collections/PlaybookOverrideCollection.ts
+var PlaybookOverrideCollection_exports = /* @__PURE__ */ __exportAll({ PlaybookOverrideCollection: () => PlaybookOverrideCollection });
+var PlaybookOverrideCollection = class extends SmrtCollection {
+	static _itemClass = PlaybookOverride;
+	excludeOverrideId(items, excludeId) {
+		return items.filter((item) => excludeId ? item.id !== excludeId : true);
+	}
+	async getAppOverride(key, options = {}) {
+		const items = await this.list({ where: {
+			key,
+			tenantId: null
+		} });
+		return this.excludeOverrideId(items, options.excludeId)[0] ?? null;
+	}
+	async getTenantOverride(key, tenantId, options = {}) {
+		const items = await this.list({ where: {
+			key,
+			tenantId
+		} });
+		return this.excludeOverrideId(items, options.excludeId)[0] ?? null;
+	}
+	async getResolutionLayers(key, tenantId, options = {}) {
+		const [app, tenant] = await Promise.all([this.getAppOverride(key, options), tenantId != null ? this.getTenantOverride(key, tenantId, options) : Promise.resolve(null)]);
+		return {
+			app,
+			tenant
+		};
+	}
+};
+//#endregion
+//#region src/playbook-resolver.ts
+var DEFAULT_INTENT_PLANES = Object.freeze(["browser"]);
+function getPlaybookConfig() {
+	return getPackageConfig("playbooks", { playbooks: {} });
+}
+function reject(key, reason, message, stepIndex) {
+	return {
+		ok: false,
+		reason,
+		message,
+		key,
+		...stepIndex === void 0 ? {} : { stepIndex }
+	};
+}
+async function loadPlaybookBase(definition, options) {
+	const key = definition.key;
+	const tenantId = options.tenantId !== void 0 ? options.tenantId : getTenantId() ?? null;
+	let collection = null;
+	let cacheDb = options.db;
+	if (options.db) {
+		const initializedCollection = await PlaybookOverrideCollection.create({ db: options.db });
+		collection = initializedCollection;
+		cacheDb = initializedCollection.db;
+	}
+	const cached = getCachedPlaybookBase(key, tenantId, cacheDb);
+	if (cached) return cached;
+	const loadedAtGeneration = getPlaybookCacheGeneration(key, cacheDb);
+	const layers = [normalizePlaybookLayer(getPlaybookConfig().playbooks?.[key], `Playbook "${key}" config override`)];
+	if (collection) {
+		const stored = await collection.getResolutionLayers(key, tenantId);
+		if (stored.app) layers.push(stored.app.toPlaybookLayer());
+		if (stored.tenant) layers.push(stored.tenant.toPlaybookLayer());
+	}
+	const merged = mergePlaybookLayers(definition, ...layers);
+	const value = Object.freeze({
+		key,
+		title: merged.title,
+		description: merged.description,
+		planes: merged.planes,
+		onStepFailure: merged.onStepFailure,
+		enabled: merged.enabled,
+		metadata: merged.metadata
+	});
+	setCachedPlaybookBase(key, tenantId, cacheDb, value, loadedAtGeneration);
+	return value;
+}
+async function resolvePlaybook(key, options = {}) {
+	const definition = PlaybookRegistry.get(key);
+	if (!definition) return reject(key, "unknown-playbook", `Unknown playbook key "${key}"`);
+	const base = await loadPlaybookBase(definition, options);
+	const runtimeOverride = normalizePlaybookLayer(options.override, `Playbook "${key}" runtime override`);
+	const merged = mergePlaybookLayers({
+		...definition,
+		title: base.title,
+		description: base.description,
+		planes: base.planes,
+		onStepFailure: base.onStepFailure,
+		enabled: base.enabled,
+		metadata: base.metadata
+	}, runtimeOverride);
+	if (!merged.enabled) return reject(key, "disabled", `Playbook "${key}" is disabled for this scope`);
+	const plane = options.plane ?? "server";
+	if (!merged.planes.includes(plane)) return reject(key, "plane-not-declared", `Playbook "${key}" is not valid on the "${plane}" plane; it declares ${merged.planes.join(", ")}`);
+	const steps = [];
+	for (const [index, step] of definition.steps.entries()) {
+		if (step.kind === "operation") {
+			const declaration = options.classifier?.(step) ?? null;
+			steps.push({
+				index,
+				step,
+				classification: applyCapabilityDeclaration(declaration),
+				classificationDeclared: isCapabilityDeclarationComplete(declaration)
+			});
+			continue;
+		}
+		if (!options.intents) return reject(key, "intent-registry-unavailable", `Playbook "${key}" step ${index} references view intent "${step.id}", but no intent registry was supplied (see #2588)`, index);
+		const record = options.intents(step.id);
+		if (!record) return reject(key, "unknown-intent", `Playbook "${key}" step ${index} references unknown view intent "${step.id}"`, index);
+		if (!(record.planes ?? DEFAULT_INTENT_PLANES).includes(plane)) return reject(key, "intent-plane-not-declared", `Playbook "${key}" step ${index} references view intent "${step.id}", which is not valid on the "${plane}" plane`, index);
+		steps.push({
+			index,
+			step,
+			classification: applyCapabilityDeclaration(record.classification),
+			classificationDeclared: isCapabilityDeclarationComplete(record.classification)
+		});
+	}
+	return {
+		ok: true,
+		plan: Object.freeze({
+			key,
+			title: merged.title,
+			description: merged.description,
+			plane,
+			planes: merged.planes,
+			onStepFailure: merged.onStepFailure,
+			metadata: merged.metadata,
+			steps: Object.freeze(steps)
+		})
+	};
+}
+//#endregion
+//#region src/index.ts
+var PACKAGE_VERSION_INITIALIZED = true;
+//#endregion
+export { FAIL_CLOSED_CLASSIFICATION, PACKAGE_VERSION_INITIALIZED, PLAYBOOK_PLANES, PlaybookOverride, PlaybookOverrideCollection, PlaybookRegistry, clearPlaybookCache, definePlaybook, getPlaybookCacheTtlMs, normalizeEditableConfig, resolvePlaybook };
+
+//# sourceMappingURL=index.js.map