@agimon-ai/po-web-dashboard 0.0.0-alpha.0

package/dist/web/lib/stepUp.mjs

@@ -0,0 +1,41 @@
+import { STEP_UP_HEADER } from "../../types/remoteAccess.mjs";
+import { sealedHttpSession } from "./sealedSession.mjs";
+import { assertionFor } from "./webauthnClient.mjs";
+//#region src/web/lib/stepUp.ts
+const UNAUTHORIZED = 401;
+/**
+* Fetch that answers a step-up challenge once and retries.
+*
+* The server decides which actions need a gesture, not the client: it answers
+* 401 naming the action, and this replays the identical request with an
+* assertion attached. Keeping the decision server-side means a client that
+* forgets to ask still cannot skip the gate, and it means adding a gated action
+* needs no client change at all.
+*
+* Exactly one retry. A second 401 after a fresh gesture is a real refusal, and
+* looping would turn a denied action into a biometric prompt that will not stop.
+*/
+async function fetchWithStepUp(input, init, requestAssertion = assertionFor) {
+	const first = await sealedHttpSession.fetch(input, init);
+	if (first.status !== UNAUTHORIZED) return first;
+	let action;
+	try {
+		action = (await first.clone().json()).action;
+	} catch {
+		return first;
+	}
+	if (typeof action !== "string") return first;
+	const assertion = await requestAssertion(action);
+	if (assertion === void 0) return first;
+	return await sealedHttpSession.fetch(input, {
+		...init,
+		headers: {
+			...init?.headers,
+			[STEP_UP_HEADER]: assertion
+		}
+	});
+}
+//#endregion
+export { fetchWithStepUp };
+
+//# sourceMappingURL=stepUp.mjs.map

package/dist/web/lib/stepUp.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"stepUp.mjs","names":[],"sources":["../../../src/web/lib/stepUp.ts"],"sourcesContent":["import { STEP_UP_HEADER } from '../../types/remoteAccess';\nimport { sealedHttpSession } from './sealedSession';\nimport { assertionFor } from './webauthnClient';\n\nconst UNAUTHORIZED = 401;\n\n/**\n * Fetch that answers a step-up challenge once and retries.\n *\n * The server decides which actions need a gesture, not the client: it answers\n * 401 naming the action, and this replays the identical request with an\n * assertion attached. Keeping the decision server-side means a client that\n * forgets to ask still cannot skip the gate, and it means adding a gated action\n * needs no client change at all.\n *\n * Exactly one retry. A second 401 after a fresh gesture is a real refusal, and\n * looping would turn a denied action into a biometric prompt that will not stop.\n */\nexport async function fetchWithStepUp(\n  input: string,\n  init?: RequestInit,\n  /** Test seam, in the house style: the real one runs a WebAuthn ceremony. */\n  requestAssertion: (action: string) => Promise<string | undefined> = assertionFor,\n): Promise<Response> {\n  const first = await sealedHttpSession.fetch(input, init);\n  if (first.status !== UNAUTHORIZED) return first;\n\n  let action: unknown;\n  try {\n    action = ((await first.clone().json()) as { action?: unknown }).action;\n  } catch {\n    return first; // A 401 with no action is an ordinary refusal.\n  }\n  if (typeof action !== 'string') return first;\n\n  const assertion = await requestAssertion(action);\n  if (assertion === undefined) return first;\n\n  return await sealedHttpSession.fetch(input, {\n    ...init,\n    headers: { ...(init?.headers as Record<string, string> | undefined), [STEP_UP_HEADER]: assertion },\n  });\n}\n"],"mappings":";;;;AAIA,MAAM,eAAe;;;;;;;;;;;;;AAcrB,eAAsB,gBACpB,OACA,MAEA,mBAAoE,cACjD;CACnB,MAAM,QAAQ,MAAM,kBAAkB,MAAM,OAAO,IAAI;CACvD,IAAI,MAAM,WAAW,cAAc,OAAO;CAE1C,IAAI;CACJ,IAAI;EACF,UAAW,MAAM,MAAM,MAAM,CAAC,CAAC,KAAK,EAAA,CAA4B;CAClE,QAAQ;EACN,OAAO;CACT;CACA,IAAI,OAAO,WAAW,UAAU,OAAO;CAEvC,MAAM,YAAY,MAAM,iBAAiB,MAAM;CAC/C,IAAI,cAAc,KAAA,GAAW,OAAO;CAEpC,OAAO,MAAM,kBAAkB,MAAM,OAAO;EAC1C,GAAG;EACH,SAAS;GAAE,GAAI,MAAM;IAAiD,iBAAiB;EAAU;CACnG,CAAC;AACH"}

package/dist/web/lib/templateCatalog.cjs

@@ -0,0 +1,123 @@
+const require_pluginScopes = require("./pluginScopes.cjs");
+let _agimon_ai_po_core_web = require("@agimon-ai/po-core/web");
+//#region src/web/lib/templateCatalog.ts
+let bundledTemplates = [];
+/** The host supplies its bundled recovery application, avoiding a library-to-template dependency. */
+function bindBundledWebTemplates(plugins) {
+	bundledTemplates = plugins;
+}
+/** One plugin field of template contributions, parsed entry by entry; the first owner of an id wins. */
+function collectTemplates(plugins, field, parse, extra = () => []) {
+	const templates = /* @__PURE__ */ new Map();
+	const diagnostics = [];
+	const collect = (plugin) => {
+		let entries;
+		try {
+			entries = plugin[field];
+		} catch {
+			diagnostics.push({
+				kind: "invalid-template",
+				pluginId: plugin.id,
+				message: `Template metadata from '${plugin.id}' could not be read.`
+			});
+			return;
+		}
+		if (entries === void 0) return;
+		if (!Array.isArray(entries)) {
+			diagnostics.push({
+				kind: "invalid-template",
+				pluginId: plugin.id,
+				message: `Plugin '${plugin.id}' must declare ${field} as an array.`
+			});
+			return;
+		}
+		for (const entry of entries) {
+			let template;
+			try {
+				template = parse(entry);
+			} catch {
+				template = void 0;
+			}
+			if (template === void 0) {
+				diagnostics.push({
+					kind: "invalid-template",
+					pluginId: plugin.id,
+					message: `Plugin '${plugin.id}' declares an invalid template or an unsupported template contract.`
+				});
+				continue;
+			}
+			const owner = templates.get(template.id);
+			if (owner !== void 0) {
+				diagnostics.push({
+					kind: "duplicate-template",
+					pluginId: plugin.id,
+					message: `Template '${template.id}' is already provided by '${owner.pluginId}'; keeping the first.`
+				});
+				continue;
+			}
+			templates.set(template.id, {
+				...template,
+				pluginId: plugin.id
+			});
+		}
+	};
+	for (const plugin of plugins) collect(plugin);
+	for (const plugin of extra()) collect(plugin);
+	return {
+		templates: [...templates.values()],
+		diagnostics
+	};
+}
+/** Read scoped templates, then add the host's bundled recovery app when absent. */
+function collectWebTemplates(plugins, scope) {
+	const first = collectTemplates(plugins, "templates", _agimon_ai_po_core_web.parseWebTemplate);
+	if (scope === void 0 || first.templates.some((template) => template.id === "po-template-advanced")) return first;
+	return collectTemplates(plugins, "templates", _agimon_ai_po_core_web.parseWebTemplate, () => require_pluginScopes.pluginsAtScope(bundledTemplates, scope));
+}
+let bundledNativeTemplates = [];
+/** The phone app's bundled default layout, bound by the host exactly as the cockpit binds its own. */
+function bindBundledNativeTemplates(plugins) {
+	bundledNativeTemplates = plugins;
+}
+/** Phone layouts from `nativeTemplates`, then the app's bundled Advanced when absent. */
+function collectNativeTemplates(plugins, scope) {
+	const first = collectTemplates(plugins, "nativeTemplates", _agimon_ai_po_core_web.parseNativeTemplate);
+	if (scope === void 0 || first.templates.some((template) => template.id === "po-template-advanced")) return first;
+	return collectTemplates(plugins, "nativeTemplates", _agimon_ai_po_core_web.parseNativeTemplate, () => require_pluginScopes.pluginsAtScope(bundledNativeTemplates, scope));
+}
+/** The cockpit's choice rule for the phone: configured, then Advanced, then the first by id. */
+function resolveNativeTemplate(templates, configured, failed = []) {
+	const available = templates.filter((template) => !failed.includes(template.id));
+	return available.find((template) => template.id === configured) ?? available.find((template) => template.id === "po-template-advanced") ?? [...available].sort((left, right) => left.id.localeCompare(right.id))[0];
+}
+/** A missing default stays in config, since another workspace may still provide it. */
+function resolveWebTemplate(templates, configured, failed = []) {
+	const available = templates.filter((template) => !failed.includes(template.id));
+	const preferred = available.find((template) => template.id === configured);
+	const template = preferred ?? available.find((candidate) => candidate.id === "po-template-advanced") ?? [...available].sort((left, right) => left.id.localeCompare(right.id))[0];
+	if (!template) return {
+		template: void 0,
+		warning: "No compatible web template is available. Add a template package to modes.yaml and run po sync."
+	};
+	if (configured && !preferred) return {
+		template,
+		warning: `Configured template '${configured}' is unavailable; showing '${template.label}'.`
+	};
+	if (failed.length > 0) return {
+		template,
+		warning: "A template could not render. A different available template is being shown."
+	};
+	return {
+		template,
+		warning: void 0
+	};
+}
+//#endregion
+exports.bindBundledNativeTemplates = bindBundledNativeTemplates;
+exports.bindBundledWebTemplates = bindBundledWebTemplates;
+exports.collectNativeTemplates = collectNativeTemplates;
+exports.collectWebTemplates = collectWebTemplates;
+exports.resolveNativeTemplate = resolveNativeTemplate;
+exports.resolveWebTemplate = resolveWebTemplate;
+
+//# sourceMappingURL=templateCatalog.cjs.map

package/dist/web/lib/templateCatalog.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"templateCatalog.cjs","names":["parseWebTemplate","pluginsAtScope","parseNativeTemplate"],"sources":["../../../src/web/lib/templateCatalog.ts"],"sourcesContent":["import {\n  parseNativeTemplate,\n  parseWebTemplate,\n  type NativeTemplateContribution,\n  type WebPluginDefinition,\n  type WebPluginScope,\n  type WebTemplateContribution,\n} from '@agimon-ai/po-core/web';\n\nimport { pluginsAtScope } from './pluginScopes';\nexport interface InstalledWebTemplate extends WebTemplateContribution {\n  pluginId: string;\n}\n\nexport interface WebTemplateDiagnostic {\n  kind: 'invalid-template' | 'duplicate-template';\n  pluginId: string;\n  message: string;\n}\n\nexport interface WebTemplateCatalog {\n  templates: InstalledWebTemplate[];\n  diagnostics: WebTemplateDiagnostic[];\n}\n\nlet bundledTemplates: readonly WebPluginDefinition[] = [];\n\n/** The host supplies its bundled recovery application, avoiding a library-to-template dependency. */\nexport function bindBundledWebTemplates(plugins: readonly WebPluginDefinition[]): void {\n  bundledTemplates = plugins;\n}\n\n/** One plugin field of template contributions, parsed entry by entry; the first owner of an id wins. */\nfunction collectTemplates<T extends { id: string }>(\n  plugins: readonly WebPluginDefinition[],\n  field: 'templates' | 'nativeTemplates',\n  parse: (value: unknown) => T | undefined,\n  extra: () => readonly WebPluginDefinition[] = () => [],\n): { templates: (T & { pluginId: string })[]; diagnostics: WebTemplateDiagnostic[] } {\n  const templates = new Map<string, T & { pluginId: string }>();\n  const diagnostics: WebTemplateDiagnostic[] = [];\n  const collect = (plugin: WebPluginDefinition): void => {\n    let entries: unknown;\n    try {\n      entries = plugin[field];\n    } catch {\n      diagnostics.push({\n        kind: 'invalid-template',\n        pluginId: plugin.id,\n        message: `Template metadata from '${plugin.id}' could not be read.`,\n      });\n      return;\n    }\n    if (entries === undefined) return;\n    if (!Array.isArray(entries)) {\n      diagnostics.push({\n        kind: 'invalid-template',\n        pluginId: plugin.id,\n        message: `Plugin '${plugin.id}' must declare ${field} as an array.`,\n      });\n      return;\n    }\n    for (const entry of entries) {\n      let template: T | undefined;\n      try {\n        template = parse(entry);\n      } catch {\n        template = undefined;\n      }\n      if (template === undefined) {\n        diagnostics.push({\n          kind: 'invalid-template',\n          pluginId: plugin.id,\n          message: `Plugin '${plugin.id}' declares an invalid template or an unsupported template contract.`,\n        });\n        continue;\n      }\n      const owner = templates.get(template.id);\n      if (owner !== undefined) {\n        diagnostics.push({\n          kind: 'duplicate-template',\n          pluginId: plugin.id,\n          message: `Template '${template.id}' is already provided by '${owner.pluginId}'; keeping the first.`,\n        });\n        continue;\n      }\n      templates.set(template.id, { ...template, pluginId: plugin.id });\n    }\n  };\n\n  for (const plugin of plugins) collect(plugin);\n  for (const plugin of extra()) collect(plugin);\n  return { templates: [...templates.values()], diagnostics };\n}\n\n/** Read scoped templates, then add the host's bundled recovery app when absent. */\nexport function collectWebTemplates(\n  plugins: readonly WebPluginDefinition[],\n  scope?: WebPluginScope,\n): WebTemplateCatalog {\n  const first = collectTemplates(plugins, 'templates', parseWebTemplate);\n  if (scope === undefined || first.templates.some((template) => template.id === 'po-template-advanced')) return first;\n  return collectTemplates(plugins, 'templates', parseWebTemplate, () => pluginsAtScope(bundledTemplates, scope));\n}\n\nexport interface InstalledNativeTemplate extends NativeTemplateContribution {\n  pluginId: string;\n}\n\nexport interface NativeTemplateCatalog {\n  templates: InstalledNativeTemplate[];\n  diagnostics: WebTemplateDiagnostic[];\n}\n\nlet bundledNativeTemplates: readonly WebPluginDefinition[] = [];\n\n/** The phone app's bundled default layout, bound by the host exactly as the cockpit binds its own. */\nexport function bindBundledNativeTemplates(plugins: readonly WebPluginDefinition[]): void {\n  bundledNativeTemplates = plugins;\n}\n\n/** Phone layouts from `nativeTemplates`, then the app's bundled Advanced when absent. */\nexport function collectNativeTemplates(\n  plugins: readonly WebPluginDefinition[],\n  scope?: WebPluginScope,\n): NativeTemplateCatalog {\n  const first = collectTemplates(plugins, 'nativeTemplates', parseNativeTemplate);\n  if (scope === undefined || first.templates.some((template) => template.id === 'po-template-advanced')) return first;\n  return collectTemplates(plugins, 'nativeTemplates', parseNativeTemplate, () =>\n    pluginsAtScope(bundledNativeTemplates, scope),\n  );\n}\n\n/** The cockpit's choice rule for the phone: configured, then Advanced, then the first by id. */\nexport function resolveNativeTemplate(\n  templates: readonly InstalledNativeTemplate[],\n  configured: string | undefined,\n  failed: readonly string[] = [],\n): InstalledNativeTemplate | undefined {\n  const available = templates.filter((template) => !failed.includes(template.id));\n  return (\n    available.find((template) => template.id === configured) ??\n    available.find((template) => template.id === 'po-template-advanced') ??\n    [...available].sort((left, right) => left.id.localeCompare(right.id))[0]\n  );\n}\n\n/** A missing default stays in config, since another workspace may still provide it. */\nexport function resolveWebTemplate(\n  templates: readonly InstalledWebTemplate[],\n  configured: string | undefined,\n  failed: readonly string[] = [],\n): { template: InstalledWebTemplate | undefined; warning: string | undefined } {\n  const available = templates.filter((template) => !failed.includes(template.id));\n  const preferred = available.find((template) => template.id === configured);\n  const template =\n    preferred ??\n    available.find((candidate) => candidate.id === 'po-template-advanced') ??\n    [...available].sort((left, right) => left.id.localeCompare(right.id))[0];\n  if (!template)\n    return {\n      template: undefined,\n      warning: 'No compatible web template is available. Add a template package to modes.yaml and run po sync.',\n    };\n  if (configured && !preferred)\n    return { template, warning: `Configured template '${configured}' is unavailable; showing '${template.label}'.` };\n  if (failed.length > 0)\n    return { template, warning: 'A template could not render. A different available template is being shown.' };\n  return { template, warning: undefined };\n}\n"],"mappings":"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"}

package/dist/web/lib/templateCatalog.d.mts

@@ -0,0 +1,38 @@
+import { NativeTemplateContribution, WebPluginDefinition, WebPluginScope, WebTemplateContribution } from "@agimon-ai/po-core/web";
+//#region src/web/lib/templateCatalog.d.ts
+export interface InstalledWebTemplate extends WebTemplateContribution {
+  pluginId: string;
+}
+export interface WebTemplateDiagnostic {
+  kind: 'invalid-template' | 'duplicate-template';
+  pluginId: string;
+  message: string;
+}
+export interface WebTemplateCatalog {
+  templates: InstalledWebTemplate[];
+  diagnostics: WebTemplateDiagnostic[];
+}
+/** The host supplies its bundled recovery application, avoiding a library-to-template dependency. */
+export declare function bindBundledWebTemplates(plugins: readonly WebPluginDefinition[]): void;
+/** Read scoped templates, then add the host's bundled recovery app when absent. */
+export declare function collectWebTemplates(plugins: readonly WebPluginDefinition[], scope?: WebPluginScope): WebTemplateCatalog;
+export interface InstalledNativeTemplate extends NativeTemplateContribution {
+  pluginId: string;
+}
+export interface NativeTemplateCatalog {
+  templates: InstalledNativeTemplate[];
+  diagnostics: WebTemplateDiagnostic[];
+}
+/** The phone app's bundled default layout, bound by the host exactly as the cockpit binds its own. */
+export declare function bindBundledNativeTemplates(plugins: readonly WebPluginDefinition[]): void;
+/** Phone layouts from `nativeTemplates`, then the app's bundled Advanced when absent. */
+export declare function collectNativeTemplates(plugins: readonly WebPluginDefinition[], scope?: WebPluginScope): NativeTemplateCatalog;
+/** The cockpit's choice rule for the phone: configured, then Advanced, then the first by id. */
+export declare function resolveNativeTemplate(templates: readonly InstalledNativeTemplate[], configured: string | undefined, failed?: readonly string[]): InstalledNativeTemplate | undefined;
+/** A missing default stays in config, since another workspace may still provide it. */
+export declare function resolveWebTemplate(templates: readonly InstalledWebTemplate[], configured: string | undefined, failed?: readonly string[]): {
+  template: InstalledWebTemplate | undefined;
+  warning: string | undefined;
+};
+//#endregion
+//# sourceMappingURL=templateCatalog.d.mts.map

package/dist/web/lib/templateCatalog.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templateCatalog.d.mts","names":[],"sources":["../../../src/web/lib/templateCatalog.ts"],"mappings":";;iBAUiB,6BAA6B;EAC5C;;iBAGe;EACf;EACA;EACA;;iBAGe;EACf,WAAW;EACX,aAAa;;;wBAMC,wBAAwB,kBAAkB;;wBAoE1C,oBACd,kBAAkB,uBAClB,QAAQ,iBACP;iBAMc,gCAAgC;EAC/C;;iBAGe;EACf,WAAW;EACX,aAAa;;;wBAMC,2BAA2B,kBAAkB;;wBAK7C,uBACd,kBAAkB,uBAClB,QAAQ,iBACP;;wBASa,sBACd,oBAAoB,2BACpB,gCACA,6BACC;;wBAUa,mBACd,oBAAoB,wBACpB,gCACA;EACG,UAAU;EAAkC"}

package/dist/web/lib/templateCatalog.mjs

@@ -0,0 +1,118 @@
+import { pluginsAtScope } from "./pluginScopes.mjs";
+import { parseNativeTemplate, parseWebTemplate } from "@agimon-ai/po-core/web";
+//#region src/web/lib/templateCatalog.ts
+let bundledTemplates = [];
+/** The host supplies its bundled recovery application, avoiding a library-to-template dependency. */
+function bindBundledWebTemplates(plugins) {
+	bundledTemplates = plugins;
+}
+/** One plugin field of template contributions, parsed entry by entry; the first owner of an id wins. */
+function collectTemplates(plugins, field, parse, extra = () => []) {
+	const templates = /* @__PURE__ */ new Map();
+	const diagnostics = [];
+	const collect = (plugin) => {
+		let entries;
+		try {
+			entries = plugin[field];
+		} catch {
+			diagnostics.push({
+				kind: "invalid-template",
+				pluginId: plugin.id,
+				message: `Template metadata from '${plugin.id}' could not be read.`
+			});
+			return;
+		}
+		if (entries === void 0) return;
+		if (!Array.isArray(entries)) {
+			diagnostics.push({
+				kind: "invalid-template",
+				pluginId: plugin.id,
+				message: `Plugin '${plugin.id}' must declare ${field} as an array.`
+			});
+			return;
+		}
+		for (const entry of entries) {
+			let template;
+			try {
+				template = parse(entry);
+			} catch {
+				template = void 0;
+			}
+			if (template === void 0) {
+				diagnostics.push({
+					kind: "invalid-template",
+					pluginId: plugin.id,
+					message: `Plugin '${plugin.id}' declares an invalid template or an unsupported template contract.`
+				});
+				continue;
+			}
+			const owner = templates.get(template.id);
+			if (owner !== void 0) {
+				diagnostics.push({
+					kind: "duplicate-template",
+					pluginId: plugin.id,
+					message: `Template '${template.id}' is already provided by '${owner.pluginId}'; keeping the first.`
+				});
+				continue;
+			}
+			templates.set(template.id, {
+				...template,
+				pluginId: plugin.id
+			});
+		}
+	};
+	for (const plugin of plugins) collect(plugin);
+	for (const plugin of extra()) collect(plugin);
+	return {
+		templates: [...templates.values()],
+		diagnostics
+	};
+}
+/** Read scoped templates, then add the host's bundled recovery app when absent. */
+function collectWebTemplates(plugins, scope) {
+	const first = collectTemplates(plugins, "templates", parseWebTemplate);
+	if (scope === void 0 || first.templates.some((template) => template.id === "po-template-advanced")) return first;
+	return collectTemplates(plugins, "templates", parseWebTemplate, () => pluginsAtScope(bundledTemplates, scope));
+}
+let bundledNativeTemplates = [];
+/** The phone app's bundled default layout, bound by the host exactly as the cockpit binds its own. */
+function bindBundledNativeTemplates(plugins) {
+	bundledNativeTemplates = plugins;
+}
+/** Phone layouts from `nativeTemplates`, then the app's bundled Advanced when absent. */
+function collectNativeTemplates(plugins, scope) {
+	const first = collectTemplates(plugins, "nativeTemplates", parseNativeTemplate);
+	if (scope === void 0 || first.templates.some((template) => template.id === "po-template-advanced")) return first;
+	return collectTemplates(plugins, "nativeTemplates", parseNativeTemplate, () => pluginsAtScope(bundledNativeTemplates, scope));
+}
+/** The cockpit's choice rule for the phone: configured, then Advanced, then the first by id. */
+function resolveNativeTemplate(templates, configured, failed = []) {
+	const available = templates.filter((template) => !failed.includes(template.id));
+	return available.find((template) => template.id === configured) ?? available.find((template) => template.id === "po-template-advanced") ?? [...available].sort((left, right) => left.id.localeCompare(right.id))[0];
+}
+/** A missing default stays in config, since another workspace may still provide it. */
+function resolveWebTemplate(templates, configured, failed = []) {
+	const available = templates.filter((template) => !failed.includes(template.id));
+	const preferred = available.find((template) => template.id === configured);
+	const template = preferred ?? available.find((candidate) => candidate.id === "po-template-advanced") ?? [...available].sort((left, right) => left.id.localeCompare(right.id))[0];
+	if (!template) return {
+		template: void 0,
+		warning: "No compatible web template is available. Add a template package to modes.yaml and run po sync."
+	};
+	if (configured && !preferred) return {
+		template,
+		warning: `Configured template '${configured}' is unavailable; showing '${template.label}'.`
+	};
+	if (failed.length > 0) return {
+		template,
+		warning: "A template could not render. A different available template is being shown."
+	};
+	return {
+		template,
+		warning: void 0
+	};
+}
+//#endregion
+export { bindBundledNativeTemplates, bindBundledWebTemplates, collectNativeTemplates, collectWebTemplates, resolveNativeTemplate, resolveWebTemplate };
+
+//# sourceMappingURL=templateCatalog.mjs.map

package/dist/web/lib/templateCatalog.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"templateCatalog.mjs","names":[],"sources":["../../../src/web/lib/templateCatalog.ts"],"sourcesContent":["import {\n  parseNativeTemplate,\n  parseWebTemplate,\n  type NativeTemplateContribution,\n  type WebPluginDefinition,\n  type WebPluginScope,\n  type WebTemplateContribution,\n} from '@agimon-ai/po-core/web';\n\nimport { pluginsAtScope } from './pluginScopes';\nexport interface InstalledWebTemplate extends WebTemplateContribution {\n  pluginId: string;\n}\n\nexport interface WebTemplateDiagnostic {\n  kind: 'invalid-template' | 'duplicate-template';\n  pluginId: string;\n  message: string;\n}\n\nexport interface WebTemplateCatalog {\n  templates: InstalledWebTemplate[];\n  diagnostics: WebTemplateDiagnostic[];\n}\n\nlet bundledTemplates: readonly WebPluginDefinition[] = [];\n\n/** The host supplies its bundled recovery application, avoiding a library-to-template dependency. */\nexport function bindBundledWebTemplates(plugins: readonly WebPluginDefinition[]): void {\n  bundledTemplates = plugins;\n}\n\n/** One plugin field of template contributions, parsed entry by entry; the first owner of an id wins. */\nfunction collectTemplates<T extends { id: string }>(\n  plugins: readonly WebPluginDefinition[],\n  field: 'templates' | 'nativeTemplates',\n  parse: (value: unknown) => T | undefined,\n  extra: () => readonly WebPluginDefinition[] = () => [],\n): { templates: (T & { pluginId: string })[]; diagnostics: WebTemplateDiagnostic[] } {\n  const templates = new Map<string, T & { pluginId: string }>();\n  const diagnostics: WebTemplateDiagnostic[] = [];\n  const collect = (plugin: WebPluginDefinition): void => {\n    let entries: unknown;\n    try {\n      entries = plugin[field];\n    } catch {\n      diagnostics.push({\n        kind: 'invalid-template',\n        pluginId: plugin.id,\n        message: `Template metadata from '${plugin.id}' could not be read.`,\n      });\n      return;\n    }\n    if (entries === undefined) return;\n    if (!Array.isArray(entries)) {\n      diagnostics.push({\n        kind: 'invalid-template',\n        pluginId: plugin.id,\n        message: `Plugin '${plugin.id}' must declare ${field} as an array.`,\n      });\n      return;\n    }\n    for (const entry of entries) {\n      let template: T | undefined;\n      try {\n        template = parse(entry);\n      } catch {\n        template = undefined;\n      }\n      if (template === undefined) {\n        diagnostics.push({\n          kind: 'invalid-template',\n          pluginId: plugin.id,\n          message: `Plugin '${plugin.id}' declares an invalid template or an unsupported template contract.`,\n        });\n        continue;\n      }\n      const owner = templates.get(template.id);\n      if (owner !== undefined) {\n        diagnostics.push({\n          kind: 'duplicate-template',\n          pluginId: plugin.id,\n          message: `Template '${template.id}' is already provided by '${owner.pluginId}'; keeping the first.`,\n        });\n        continue;\n      }\n      templates.set(template.id, { ...template, pluginId: plugin.id });\n    }\n  };\n\n  for (const plugin of plugins) collect(plugin);\n  for (const plugin of extra()) collect(plugin);\n  return { templates: [...templates.values()], diagnostics };\n}\n\n/** Read scoped templates, then add the host's bundled recovery app when absent. */\nexport function collectWebTemplates(\n  plugins: readonly WebPluginDefinition[],\n  scope?: WebPluginScope,\n): WebTemplateCatalog {\n  const first = collectTemplates(plugins, 'templates', parseWebTemplate);\n  if (scope === undefined || first.templates.some((template) => template.id === 'po-template-advanced')) return first;\n  return collectTemplates(plugins, 'templates', parseWebTemplate, () => pluginsAtScope(bundledTemplates, scope));\n}\n\nexport interface InstalledNativeTemplate extends NativeTemplateContribution {\n  pluginId: string;\n}\n\nexport interface NativeTemplateCatalog {\n  templates: InstalledNativeTemplate[];\n  diagnostics: WebTemplateDiagnostic[];\n}\n\nlet bundledNativeTemplates: readonly WebPluginDefinition[] = [];\n\n/** The phone app's bundled default layout, bound by the host exactly as the cockpit binds its own. */\nexport function bindBundledNativeTemplates(plugins: readonly WebPluginDefinition[]): void {\n  bundledNativeTemplates = plugins;\n}\n\n/** Phone layouts from `nativeTemplates`, then the app's bundled Advanced when absent. */\nexport function collectNativeTemplates(\n  plugins: readonly WebPluginDefinition[],\n  scope?: WebPluginScope,\n): NativeTemplateCatalog {\n  const first = collectTemplates(plugins, 'nativeTemplates', parseNativeTemplate);\n  if (scope === undefined || first.templates.some((template) => template.id === 'po-template-advanced')) return first;\n  return collectTemplates(plugins, 'nativeTemplates', parseNativeTemplate, () =>\n    pluginsAtScope(bundledNativeTemplates, scope),\n  );\n}\n\n/** The cockpit's choice rule for the phone: configured, then Advanced, then the first by id. */\nexport function resolveNativeTemplate(\n  templates: readonly InstalledNativeTemplate[],\n  configured: string | undefined,\n  failed: readonly string[] = [],\n): InstalledNativeTemplate | undefined {\n  const available = templates.filter((template) => !failed.includes(template.id));\n  return (\n    available.find((template) => template.id === configured) ??\n    available.find((template) => template.id === 'po-template-advanced') ??\n    [...available].sort((left, right) => left.id.localeCompare(right.id))[0]\n  );\n}\n\n/** A missing default stays in config, since another workspace may still provide it. */\nexport function resolveWebTemplate(\n  templates: readonly InstalledWebTemplate[],\n  configured: string | undefined,\n  failed: readonly string[] = [],\n): { template: InstalledWebTemplate | undefined; warning: string | undefined } {\n  const available = templates.filter((template) => !failed.includes(template.id));\n  const preferred = available.find((template) => template.id === configured);\n  const template =\n    preferred ??\n    available.find((candidate) => candidate.id === 'po-template-advanced') ??\n    [...available].sort((left, right) => left.id.localeCompare(right.id))[0];\n  if (!template)\n    return {\n      template: undefined,\n      warning: 'No compatible web template is available. Add a template package to modes.yaml and run po sync.',\n    };\n  if (configured && !preferred)\n    return { template, warning: `Configured template '${configured}' is unavailable; showing '${template.label}'.` };\n  if (failed.length > 0)\n    return { template, warning: 'A template could not render. A different available template is being shown.' };\n  return { template, warning: undefined };\n}\n"],"mappings":"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"}

package/dist/web/lib/threadRenderer.cjs

@@ -0,0 +1,25 @@
+//#region src/web/lib/threadRenderer.ts
+let render;
+/**
+* Holds the host's thread view for the plugin props to render.
+*
+* The view is a feature built on the timeline, while the props are assembled
+* below it; the composition root binds the one to the other, the same
+* indirection the transport uses for the socket.
+*/
+function bindThreadRenderer(renderer) {
+	render = renderer;
+}
+function releaseThreadRenderer() {
+	render = void 0;
+}
+/** The bound view, or nothing while none is bound (before the app mounts, and in unit tests). */
+function renderThread(sessionId, threadId, options) {
+	return render?.(sessionId, threadId, options) ?? null;
+}
+//#endregion
+exports.bindThreadRenderer = bindThreadRenderer;
+exports.releaseThreadRenderer = releaseThreadRenderer;
+exports.renderThread = renderThread;
+
+//# sourceMappingURL=threadRenderer.cjs.map

package/dist/web/lib/threadRenderer.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"threadRenderer.cjs","names":[],"sources":["../../../src/web/lib/threadRenderer.ts"],"sourcesContent":["import type { ThreadViewOptions } from '@agimon-ai/po-core/web';\nimport type { ReactNode } from 'react';\n\ntype ThreadRenderer = (sessionId: string, threadId: string, options?: ThreadViewOptions) => ReactNode;\n\nlet render: ThreadRenderer | undefined;\n\n/**\n * Holds the host's thread view for the plugin props to render.\n *\n * The view is a feature built on the timeline, while the props are assembled\n * below it; the composition root binds the one to the other, the same\n * indirection the transport uses for the socket.\n */\nexport function bindThreadRenderer(renderer: ThreadRenderer): void {\n  render = renderer;\n}\n\nexport function releaseThreadRenderer(): void {\n  render = undefined;\n}\n\n/** The bound view, or nothing while none is bound (before the app mounts, and in unit tests). */\nexport function renderThread(sessionId: string, threadId: string, options?: ThreadViewOptions): ReactNode {\n  return render?.(sessionId, threadId, options) ?? null;\n}\n"],"mappings":";AAKA,IAAI;;;;;;;;AASJ,SAAgB,mBAAmB,UAAgC;CACjE,SAAS;AACX;AAEA,SAAgB,wBAA8B;CAC5C,SAAS,KAAA;AACX;;AAGA,SAAgB,aAAa,WAAmB,UAAkB,SAAwC;CACxG,OAAO,SAAS,WAAW,UAAU,OAAO,KAAK;AACnD"}

package/dist/web/lib/threadRenderer.d.mts

@@ -0,0 +1,17 @@
+import { ReactNode } from "react";
+import { ThreadViewOptions } from "@agimon-ai/po-core/web";
+//#region src/web/lib/threadRenderer.d.ts
+type ThreadRenderer = (sessionId: string, threadId: string, options?: ThreadViewOptions) => ReactNode;
+/**
+ * Holds the host's thread view for the plugin props to render.
+ *
+ * The view is a feature built on the timeline, while the props are assembled
+ * below it; the composition root binds the one to the other, the same
+ * indirection the transport uses for the socket.
+ */
+export declare function bindThreadRenderer(renderer: ThreadRenderer): void;
+export declare function releaseThreadRenderer(): void;
+/** The bound view, or nothing while none is bound (before the app mounts, and in unit tests). */
+export declare function renderThread(sessionId: string, threadId: string, options?: ThreadViewOptions): ReactNode;
+//#endregion
+//# sourceMappingURL=threadRenderer.d.mts.map

package/dist/web/lib/threadRenderer.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"threadRenderer.d.mts","names":[],"sources":["../../../src/web/lib/threadRenderer.ts"],"mappings":";;;KAGK,kBAAkB,mBAAmB,kBAAkB,UAAU,sBAAsB;;;;;;;;wBAW5E,mBAAmB,UAAU;wBAI7B;;wBAKA,aAAa,mBAAmB,kBAAkB,UAAU,oBAAoB"}

package/dist/web/lib/threadRenderer.mjs

@@ -0,0 +1,23 @@
+//#region src/web/lib/threadRenderer.ts
+let render;
+/**
+* Holds the host's thread view for the plugin props to render.
+*
+* The view is a feature built on the timeline, while the props are assembled
+* below it; the composition root binds the one to the other, the same
+* indirection the transport uses for the socket.
+*/
+function bindThreadRenderer(renderer) {
+	render = renderer;
+}
+function releaseThreadRenderer() {
+	render = void 0;
+}
+/** The bound view, or nothing while none is bound (before the app mounts, and in unit tests). */
+function renderThread(sessionId, threadId, options) {
+	return render?.(sessionId, threadId, options) ?? null;
+}
+//#endregion
+export { bindThreadRenderer, releaseThreadRenderer, renderThread };
+
+//# sourceMappingURL=threadRenderer.mjs.map

package/dist/web/lib/threadRenderer.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"threadRenderer.mjs","names":[],"sources":["../../../src/web/lib/threadRenderer.ts"],"sourcesContent":["import type { ThreadViewOptions } from '@agimon-ai/po-core/web';\nimport type { ReactNode } from 'react';\n\ntype ThreadRenderer = (sessionId: string, threadId: string, options?: ThreadViewOptions) => ReactNode;\n\nlet render: ThreadRenderer | undefined;\n\n/**\n * Holds the host's thread view for the plugin props to render.\n *\n * The view is a feature built on the timeline, while the props are assembled\n * below it; the composition root binds the one to the other, the same\n * indirection the transport uses for the socket.\n */\nexport function bindThreadRenderer(renderer: ThreadRenderer): void {\n  render = renderer;\n}\n\nexport function releaseThreadRenderer(): void {\n  render = undefined;\n}\n\n/** The bound view, or nothing while none is bound (before the app mounts, and in unit tests). */\nexport function renderThread(sessionId: string, threadId: string, options?: ThreadViewOptions): ReactNode {\n  return render?.(sessionId, threadId, options) ?? null;\n}\n"],"mappings":";AAKA,IAAI;;;;;;;;AASJ,SAAgB,mBAAmB,UAAgC;CACjE,SAAS;AACX;AAEA,SAAgB,wBAA8B;CAC5C,SAAS,KAAA;AACX;;AAGA,SAAgB,aAAa,WAAmB,UAAkB,SAAwC;CACxG,OAAO,SAAS,WAAW,UAAU,OAAO,KAAK;AACnD"}

package/dist/web/lib/timelineGroups.cjs

@@ -0,0 +1,83 @@
+//#region src/web/lib/timelineGroups.ts
+/**
+* Runs of the same tool, gathered so the transcript draws one frame instead of
+* five.
+*
+* An agent rarely calls a tool once: it reads four files, or runs five
+* commands, and each call arrives as its own entry. Rendered one card apiece
+* that reads as repetition rather than as progress, so adjacent calls of the
+* same tool are handed to the timeline as a single unit. Grouping is decided
+* here, on the entry list alone, so it can be tested without a browser and the
+* component stays a renderer.
+*/
+/** Two calls are the fewest that can read as a repetition, so a lone call keeps its card. */
+const MIN_GROUP = 2;
+function isTool(entry) {
+	return entry?.kind === "tool";
+}
+/**
+* The entries as units to render.
+*
+* `groupable` decides which tool names may be gathered: a tool whose renderer
+* presents itself as a message, not a card, has no frame to share and stays on
+* its own. Only adjacent entries group, so anything between two calls, an
+* assistant reply or a notice, ends the run and keeps the transcript in order.
+*/
+function timelineUnits(entries, groupable) {
+	const units = [];
+	let index = 0;
+	while (index < entries.length) {
+		const entry = entries[index];
+		if (entry === void 0) break;
+		if (!isTool(entry) || !groupable(entry.name)) {
+			units.push({
+				kind: "single",
+				entry,
+				index
+			});
+			index += 1;
+			continue;
+		}
+		const run = [entry];
+		let next = index + 1;
+		while (next < entries.length) {
+			const candidate = entries[next];
+			if (!isTool(candidate) || candidate.name !== entry.name) break;
+			run.push(candidate);
+			next += 1;
+		}
+		if (run.length < MIN_GROUP) units.push({
+			kind: "single",
+			entry,
+			index
+		});
+		else units.push({
+			kind: "group",
+			name: entry.name,
+			entries: run,
+			index: next - 1
+		});
+		index = next;
+	}
+	return units;
+}
+/**
+* The group's own outcome: the worst thing in it. A run that is still going
+* reads as running, a run with a failure in it reads as failed, and only a run
+* where everything landed reads as ok.
+*/
+function groupTone(entries) {
+	if (entries.some((entry) => entry.running)) return "running";
+	if (entries.some((entry) => entry.isError)) return "error";
+	return "ok";
+}
+/** `5 calls`, the line beside the tool's name in the group header. */
+function groupSummary(entries) {
+	return `${String(entries.length)} call${entries.length === 1 ? "" : "s"}`;
+}
+//#endregion
+exports.groupSummary = groupSummary;
+exports.groupTone = groupTone;
+exports.timelineUnits = timelineUnits;
+
+//# sourceMappingURL=timelineGroups.cjs.map

package/dist/web/lib/timelineGroups.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"timelineGroups.cjs","names":[],"sources":["../../../src/web/lib/timelineGroups.ts"],"sourcesContent":["import type { StatusTone } from '@agimon-ai/po-web-components';\n\nimport type { TimelineEntry, ToolEntry } from './sessionModel';\n\n/**\n * Runs of the same tool, gathered so the transcript draws one frame instead of\n * five.\n *\n * An agent rarely calls a tool once: it reads four files, or runs five\n * commands, and each call arrives as its own entry. Rendered one card apiece\n * that reads as repetition rather than as progress, so adjacent calls of the\n * same tool are handed to the timeline as a single unit. Grouping is decided\n * here, on the entry list alone, so it can be tested without a browser and the\n * component stays a renderer.\n */\n\n/** Two calls are the fewest that can read as a repetition, so a lone call keeps its card. */\nconst MIN_GROUP = 2;\n\nexport interface SingleUnit {\n  readonly kind: 'single';\n  readonly entry: TimelineEntry;\n  /** The entry's index in the source list, for the timeline's live-tail window. */\n  readonly index: number;\n}\n\nexport interface GroupUnit {\n  readonly kind: 'group';\n  readonly name: string;\n  readonly entries: readonly ToolEntry[];\n  /** The index of the last entry in the run, so a group is skipped only once it is fully above the tail. */\n  readonly index: number;\n}\n\nexport type TimelineUnit = SingleUnit | GroupUnit;\n\nfunction isTool(entry: TimelineEntry | undefined): entry is ToolEntry {\n  return entry?.kind === 'tool';\n}\n\n/**\n * The entries as units to render.\n *\n * `groupable` decides which tool names may be gathered: a tool whose renderer\n * presents itself as a message, not a card, has no frame to share and stays on\n * its own. Only adjacent entries group, so anything between two calls, an\n * assistant reply or a notice, ends the run and keeps the transcript in order.\n */\nexport function timelineUnits(\n  entries: readonly TimelineEntry[],\n  groupable: (name: string) => boolean,\n): readonly TimelineUnit[] {\n  const units: TimelineUnit[] = [];\n  let index = 0;\n  while (index < entries.length) {\n    const entry = entries[index];\n    if (entry === undefined) break;\n    if (!isTool(entry) || !groupable(entry.name)) {\n      units.push({ kind: 'single', entry, index });\n      index += 1;\n      continue;\n    }\n    const run: ToolEntry[] = [entry];\n    let next = index + 1;\n    while (next < entries.length) {\n      const candidate = entries[next];\n      if (!isTool(candidate) || candidate.name !== entry.name) break;\n      run.push(candidate);\n      next += 1;\n    }\n    if (run.length < MIN_GROUP) units.push({ kind: 'single', entry, index });\n    else units.push({ kind: 'group', name: entry.name, entries: run, index: next - 1 });\n    index = next;\n  }\n  return units;\n}\n\n/**\n * The group's own outcome: the worst thing in it. A run that is still going\n * reads as running, a run with a failure in it reads as failed, and only a run\n * where everything landed reads as ok.\n */\nexport function groupTone(entries: readonly ToolEntry[]): StatusTone {\n  if (entries.some((entry) => entry.running)) return 'running';\n  if (entries.some((entry) => entry.isError)) return 'error';\n  return 'ok';\n}\n\n/** `5 calls`, the line beside the tool's name in the group header. */\nexport function groupSummary(entries: readonly ToolEntry[]): string {\n  return `${String(entries.length)} call${entries.length === 1 ? '' : 's'}`;\n}\n"],"mappings":";;;;;;;;;;;;;AAiBA,MAAM,YAAY;AAmBlB,SAAS,OAAO,OAAsD;CACpE,OAAO,OAAO,SAAS;AACzB;;;;;;;;;AAUA,SAAgB,cACd,SACA,WACyB;CACzB,MAAM,QAAwB,CAAC;CAC/B,IAAI,QAAQ;CACZ,OAAO,QAAQ,QAAQ,QAAQ;EAC7B,MAAM,QAAQ,QAAQ;EACtB,IAAI,UAAU,KAAA,GAAW;EACzB,IAAI,CAAC,OAAO,KAAK,KAAK,CAAC,UAAU,MAAM,IAAI,GAAG;GAC5C,MAAM,KAAK;IAAE,MAAM;IAAU;IAAO;GAAM,CAAC;GAC3C,SAAS;GACT;EACF;EACA,MAAM,MAAmB,CAAC,KAAK;EAC/B,IAAI,OAAO,QAAQ;EACnB,OAAO,OAAO,QAAQ,QAAQ;GAC5B,MAAM,YAAY,QAAQ;GAC1B,IAAI,CAAC,OAAO,SAAS,KAAK,UAAU,SAAS,MAAM,MAAM;GACzD,IAAI,KAAK,SAAS;GAClB,QAAQ;EACV;EACA,IAAI,IAAI,SAAS,WAAW,MAAM,KAAK;GAAE,MAAM;GAAU;GAAO;EAAM,CAAC;OAClE,MAAM,KAAK;GAAE,MAAM;GAAS,MAAM,MAAM;GAAM,SAAS;GAAK,OAAO,OAAO;EAAE,CAAC;EAClF,QAAQ;CACV;CACA,OAAO;AACT;;;;;;AAOA,SAAgB,UAAU,SAA2C;CACnE,IAAI,QAAQ,MAAM,UAAU,MAAM,OAAO,GAAG,OAAO;CACnD,IAAI,QAAQ,MAAM,UAAU,MAAM,OAAO,GAAG,OAAO;CACnD,OAAO;AACT;;AAGA,SAAgB,aAAa,SAAuC;CAClE,OAAO,GAAG,OAAO,QAAQ,MAAM,EAAE,OAAO,QAAQ,WAAW,IAAI,KAAK;AACtE"}

package/dist/web/lib/timelineGroups.d.mts

@@ -0,0 +1,36 @@
+import { TimelineEntry, ToolEntry } from "./sessionModel.mjs";
+import { StatusTone } from "@agimon-ai/po-web-components";
+//#region src/web/lib/timelineGroups.d.ts
+export interface SingleUnit {
+  readonly kind: 'single';
+  readonly entry: TimelineEntry;
+  /** The entry's index in the source list, for the timeline's live-tail window. */
+  readonly index: number;
+}
+export interface GroupUnit {
+  readonly kind: 'group';
+  readonly name: string;
+  readonly entries: readonly ToolEntry[];
+  /** The index of the last entry in the run, so a group is skipped only once it is fully above the tail. */
+  readonly index: number;
+}
+export type TimelineUnit = SingleUnit | GroupUnit;
+/**
+ * The entries as units to render.
+ *
+ * `groupable` decides which tool names may be gathered: a tool whose renderer
+ * presents itself as a message, not a card, has no frame to share and stays on
+ * its own. Only adjacent entries group, so anything between two calls, an
+ * assistant reply or a notice, ends the run and keeps the transcript in order.
+ */
+export declare function timelineUnits(entries: readonly TimelineEntry[], groupable: (name: string) => boolean): readonly TimelineUnit[];
+/**
+ * The group's own outcome: the worst thing in it. A run that is still going
+ * reads as running, a run with a failure in it reads as failed, and only a run
+ * where everything landed reads as ok.
+ */
+export declare function groupTone(entries: readonly ToolEntry[]): StatusTone;
+/** `5 calls`, the line beside the tool's name in the group header. */
+export declare function groupSummary(entries: readonly ToolEntry[]): string;
+//#endregion
+//# sourceMappingURL=timelineGroups.d.mts.map

package/dist/web/lib/timelineGroups.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timelineGroups.d.mts","names":[],"sources":["../../../src/web/lib/timelineGroups.ts"],"mappings":";;;iBAmBiB;WACN;WACA,OAAO;;WAEP;;iBAGM;WACN;WACA;WACA,kBAAkB;;WAElB;;YAGC,eAAe,aAAa;;;;;;;;;wBAcxB,cACd,kBAAkB,iBAClB,YAAY,oCACF;;;;;;wBA+BI,UAAU,kBAAkB,cAAc;;wBAO1C,aAAa,kBAAkB"}