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

package/dist/web/lib/composition.cjs

@@ -0,0 +1,403 @@
+const require_pluginRegistry = require("./pluginRegistry.cjs");
+const require_statusLine = require("./statusLine.cjs");
+let react = require("react");
+//#region src/web/lib/composition.ts
+const AXIS_LIST_SEPARATOR = ",";
+/**
+* The fallback axis table for the packaged bundle; a synced bundle carries
+* each axis as its owning package's plugin declaration, and the registry
+* list wins whenever any plugin declares one. Exported only so the workspace
+* composition test can hold it equal to what the packages declare.
+*/
+const PACKAGED_SELECTION_AXES = [{
+	name: "profile",
+	command: "profile",
+	statusKey: "doom-profile",
+	emptyLabel: "no profile",
+	order: 10
+}, {
+	name: "domains",
+	command: "domains",
+	statusKey: "doom-domain",
+	emptyLabel: "no domains",
+	multi: true,
+	order: 20
+}];
+/**
+* The declared axes the session actually offers: an axis whose status key
+* the session never published stays off the bar entirely, which is how a
+* package withholds its axis when there is nothing to select.
+*/
+function selectionAxes(statuses) {
+	const declared = require_pluginRegistry.pluginSelectionAxes();
+	return (declared.length > 0 ? declared : PACKAGED_SELECTION_AXES).flatMap((source) => {
+		const raw = statuses[source.statusKey];
+		if (raw === void 0) return [];
+		const multi = source.multi === true;
+		const values = (multi ? require_statusLine.stripAnsi(raw).split(AXIS_LIST_SEPARATOR) : [require_statusLine.stripAnsi(raw)]).map((value) => value.trim()).filter(Boolean);
+		return [{
+			name: source.name,
+			command: source.command,
+			values,
+			emptyLabel: source.emptyLabel,
+			multi
+		}];
+	});
+}
+/**
+* The fallback minor-mode table for the packaged bundle.
+*
+* A synced bundle carries each mode as its package's own web plugin
+* contribution, and the registry list wins whenever any plugin declares one.
+* This literal survives only so the built-in-only bundle keeps rendering the
+* modes Po ships; help is listed without a signal on purpose: it
+* registers no footer entry, so the cockpit reports it as unavailable rather
+* than guessing it is off. Exported only for the workspace composition test.
+*/
+const PACKAGED_MINOR_MODES = [
+	{
+		name: "help",
+		keys: "h e"
+	},
+	{
+		name: "plan",
+		keys: "p e",
+		statusKey: "plan-mode"
+	},
+	{
+		name: "loop",
+		keys: "l l",
+		statusKey: "doom-loop"
+	},
+	{
+		name: "goal",
+		keys: "g e",
+		statusKey: "goal"
+	},
+	{
+		name: "author",
+		keys: "o a"
+	},
+	{
+		name: "workflow",
+		keys: "w e",
+		widgetKey: "workflow-mcp-progress"
+	},
+	{
+		name: "voice",
+		modeId: "voice-auto",
+		keys: "v e",
+		statusKey: "doom-voice"
+	},
+	{
+		name: "computer use",
+		modeId: "computer-use",
+		keys: "c e",
+		statusKey: "doom-computer-use-mode",
+		hideWhenMissing: true,
+		desktopOnly: true
+	}
+];
+/** The declared source a catalog mode corresponds to, by id, id stem, or label. */
+function sourceFor(sources, mode) {
+	const candidates = /* @__PURE__ */ new Set([
+		mode.id.toLowerCase(),
+		mode.id.toLowerCase().split(".")[0],
+		mode.label.toLowerCase()
+	]);
+	return sources.find((source) => [source.name, source.modeId].some((identity) => identity !== void 0 && candidates.has(identity.toLowerCase())));
+}
+/**
+* Catalog-backed rows: the runtime's own activation state per mode, with the
+* declared leader keys attached where a plugin documents them. Declared modes
+* the catalog does not know are still listed, as unavailable, so a mode that
+* is missing from a composition stays visible rather than silently gone.
+*/
+function catalogMinorModes(sources, projection) {
+	const rows = projection.modes.filter((mode) => !sourceFor(sources, mode)?.desktopOnly || require_pluginRegistry.isDesktopClient()).map((mode) => {
+		const source = sourceFor(sources, mode);
+		const on = mode.activation === "active" || mode.activation === "deactivating";
+		const blocked = mode.actions.length > 0 && mode.actions.every((action) => !action.enabled);
+		const reason = blocked ? mode.actions.find((action) => action.disabledReason)?.disabledReason ?? "" : "";
+		return {
+			name: source?.name ?? mode.label.toLowerCase(),
+			id: mode.id,
+			keys: source?.keys ?? "",
+			availability: blocked && !on ? "unavailable" : on ? "on" : "off",
+			...source?.activityGroup === void 0 ? {} : { activityGroup: source.activityGroup },
+			detail: mode.detail ?? (mode.activation === "activating" ? "activating" : ""),
+			unavailableReason: reason
+		};
+	});
+	const seen = new Set(rows.map((row) => row.name));
+	for (const source of sources) {
+		if (source.hideWhenMissing === true || source.desktopOnly && !require_pluginRegistry.isDesktopClient()) continue;
+		if (!seen.has(source.name)) rows.push({
+			name: source.name,
+			id: source.modeId ?? source.name,
+			keys: source.keys,
+			availability: "unavailable",
+			...source.activityGroup === void 0 ? {} : { activityGroup: source.activityGroup },
+			detail: "",
+			unavailableReason: "No package in this session registers this mode."
+		});
+	}
+	return rows;
+}
+function minorModes(statuses, widgets, projection = null) {
+	const declared = require_pluginRegistry.pluginMinorModes();
+	const sources = declared.length > 0 ? declared : PACKAGED_MINOR_MODES;
+	if (projection) return catalogMinorModes(sources, projection);
+	return sources.flatMap((source) => {
+		if (source.desktopOnly && !require_pluginRegistry.isDesktopClient()) return [];
+		if (source.statusKey !== void 0) {
+			const raw = statuses[source.statusKey];
+			if (raw === void 0) {
+				if (source.hideWhenMissing === true) return [];
+				return [{
+					name: source.name,
+					id: source.modeId ?? source.name,
+					keys: source.keys,
+					availability: "unavailable",
+					...source.activityGroup === void 0 ? {} : { activityGroup: source.activityGroup },
+					detail: "",
+					unavailableReason: "This session has not reported the mode."
+				}];
+			}
+			const detail = require_statusLine.stripAnsi(raw).trim();
+			return {
+				name: source.name,
+				id: source.modeId ?? source.name,
+				keys: source.keys,
+				availability: detail ? "on" : "off",
+				...source.activityGroup === void 0 ? {} : { activityGroup: source.activityGroup },
+				detail,
+				unavailableReason: ""
+			};
+		}
+		if (source.widgetKey !== void 0 && widgets.includes(source.widgetKey)) return {
+			name: source.name,
+			id: source.modeId ?? source.name,
+			keys: source.keys,
+			availability: "off",
+			...source.activityGroup === void 0 ? {} : { activityGroup: source.activityGroup },
+			detail: "",
+			unavailableReason: ""
+		};
+		return {
+			name: source.name,
+			id: source.name,
+			keys: source.keys,
+			availability: "unavailable",
+			...source.activityGroup === void 0 ? {} : { activityGroup: source.activityGroup },
+			detail: "",
+			unavailableReason: "This session has not reported the mode."
+		};
+	});
+}
+/** Subscribe to package-owned activity sources, rewiring when the focused composition changes. */
+function subscribeActivitySources(listener) {
+	let subscriptions = [];
+	const unsubscribeSources = () => {
+		subscriptions.forEach((unsubscribe) => unsubscribe());
+		subscriptions = [];
+	};
+	const subscribeSources = () => {
+		subscriptions = require_pluginRegistry.pluginActivityGroups().flatMap((source) => source.activeSource === void 0 ? [] : [source.activeSource.subscribe(listener)]);
+	};
+	subscribeSources();
+	const unsubscribeRegistry = require_pluginRegistry.subscribeWebPluginRegistry(() => {
+		unsubscribeSources();
+		subscribeSources();
+		listener();
+	});
+	return () => {
+		unsubscribeRegistry();
+		unsubscribeSources();
+	};
+}
+function activitySourceFingerprint(sessionId) {
+	const activeSources = require_pluginRegistry.pluginActivityGroups().map((source) => source.activeSource?.isActive(sessionId) === true ? "1" : "0").join("");
+	return `${require_pluginRegistry.webPluginRegistryRevision()}:${activeSources}`;
+}
+/**
+* The groups available in this plugin composition. Status and widget signals
+* reveal legacy groups. A package-owned active source also reveals its group,
+* including while idle, so the section can remain a stable launcher unless it
+* opts into `hideWhenEmpty`.
+*
+* A group that declared `hideWhenEmpty` goes away once its session stops
+* reporting. Clearing a status reaches the page as an empty string rather than
+* an absent key, because the same map tells the selection bar which minor modes
+* exist and an absent key means "not reported" there. Emptiness is read here,
+* where only the dock is looking.
+*/
+function activityGroups(statuses, widgets, sessionId = null) {
+	const groups = [];
+	for (const source of require_pluginRegistry.pluginActivityGroups()) {
+		const tab = source.transientTab === void 0 ? {} : { transientTab: source.transientTab };
+		const placement = {
+			...source.placement === void 0 ? {} : { placement: source.placement },
+			...source.marksBackgroundWork === false ? { marksBackgroundWork: false } : {},
+			...source.icon === void 0 ? {} : { icon: source.icon }
+		};
+		if (source.statusKey !== void 0 && statuses[source.statusKey] !== void 0) {
+			const summary = require_statusLine.stripAnsi(statuses[source.statusKey] ?? "").trim();
+			const active = source.activeSource?.isActive(sessionId) ?? (source.marksBackgroundWork !== false && summary.length > 0);
+			if (summary.length === 0 && source.hideWhenEmpty === true && !active) continue;
+			groups.push({
+				name: source.name,
+				keys: source.keys,
+				summary,
+				active,
+				...tab,
+				...placement
+			});
+			continue;
+		}
+		if (source.widgetKeys !== void 0 && source.widgetKeys.some((key) => widgets.includes(key))) {
+			const activeKeys = source.activeWidgetKeys ?? source.widgetKeys;
+			const active = source.activeSource?.isActive(sessionId) ?? (source.marksBackgroundWork !== false && activeKeys.some((key) => widgets.includes(key)));
+			groups.push({
+				name: source.name,
+				keys: source.keys,
+				summary: "",
+				active,
+				...tab,
+				...placement
+			});
+			continue;
+		}
+		if (source.activeSource !== void 0) {
+			const active = source.activeSource.isActive(sessionId);
+			if (source.hideWhenEmpty === true && !active) continue;
+			groups.push({
+				name: source.name,
+				keys: source.keys,
+				summary: "",
+				active,
+				...tab,
+				...placement
+			});
+		}
+	}
+	return groups;
+}
+/** Dock faces update when the active session composition changes. */
+function useDockFaces(sessionId) {
+	(0, react.useSyncExternalStore)(require_pluginRegistry.subscribeWebPluginRegistry, require_pluginRegistry.webPluginRegistryRevision, require_pluginRegistry.webPluginRegistryRevision);
+	const subscribe = (listener) => {
+		const releases = require_pluginRegistry.pluginDockFaces().flatMap((face) => face.visibility ? [face.visibility.subscribe(listener)] : []);
+		return () => releases.forEach((release) => release());
+	};
+	const snapshot = () => require_pluginRegistry.pluginDockFaces().map((face) => face.visibility?.isVisible(sessionId) !== false ? "1" : "0").join("");
+	(0, react.useSyncExternalStore)(subscribe, snapshot, snapshot);
+	return require_pluginRegistry.pluginDockFaces().filter((face) => face.visibility?.isVisible(sessionId) !== false);
+}
+/** Activity groups that update when either host signals or a plugin's session store changes. */
+function useActivityGroups(statuses, widgets, sessionId) {
+	(0, react.useSyncExternalStore)(subscribeActivitySources, () => activitySourceFingerprint(sessionId), () => activitySourceFingerprint(sessionId));
+	return activityGroups(statuses, widgets, sessionId);
+}
+let fileLinkModes;
+const modeBindings = /* @__PURE__ */ new Set();
+/** Binds host session facts without making the composition library own session state. */
+function bindFileLinkModes(source) {
+	fileLinkModes = source;
+	modeBindings.forEach((listener) => listener());
+	return () => {
+		if (fileLinkModes !== source) return;
+		fileLinkModes = void 0;
+		modeBindings.forEach((listener) => listener());
+	};
+}
+function subscribeFileLinks(sessionId, listener) {
+	let unsubscribeModes = fileLinkModes?.subscribe(sessionId, listener);
+	const rebindModes = () => {
+		unsubscribeModes?.();
+		unsubscribeModes = fileLinkModes?.subscribe(sessionId, listener);
+		listener();
+	};
+	modeBindings.add(rebindModes);
+	let subscriptions = [];
+	const unsubscribeSources = () => {
+		subscriptions.forEach((unsubscribe) => unsubscribe());
+		subscriptions = [];
+	};
+	const subscribeSources = () => {
+		subscriptions = require_pluginRegistry.pluginFileLinks().map((source) => source.subscribe(listener));
+	};
+	subscribeSources();
+	const unsubscribeRegistry = require_pluginRegistry.subscribeWebPluginRegistry(() => {
+		unsubscribeSources();
+		subscribeSources();
+		listener();
+	});
+	return () => {
+		modeBindings.delete(rebindModes);
+		unsubscribeModes?.();
+		unsubscribeRegistry();
+		unsubscribeSources();
+	};
+}
+function activeFileLinkSources(sessionId) {
+	const enabled = new Set(fileLinkModes?.active(sessionId) ?? []);
+	return require_pluginRegistry.pluginFileLinks().filter((source) => source.requiredMinorMode === void 0 || enabled.has(source.requiredMinorMode));
+}
+function fileLinkFingerprint(sessionId) {
+	const sourceFingerprints = activeFileLinkSources(sessionId).map((source) => `${source.requiredMinorMode ?? ""}:${source.fingerprint(sessionId)}`).join("\n");
+	return `${require_pluginRegistry.webPluginRegistryRevision()}:${sourceFingerprints}`;
+}
+/**
+* The tab a path opens, from the first source that claims it.
+*
+* A path no source claims is not a link. The host cannot tell a file name from
+* a class name, and the plugin that tracks the session's files can, so the
+* decision belongs there rather than in a heuristic here.
+*/
+function fileLinkFor(sessionId, path) {
+	for (const source of activeFileLinkSources(sessionId)) {
+		const tab = source.resolve(sessionId, path);
+		if (tab !== void 0) return tab;
+	}
+}
+/**
+* The tab a path the caller is sure about opens: a tool call's path argument,
+* not a token spotted in prose.
+*
+* A source that offers `openPath` answers here, and it may claim a file the
+* session never changed, which `resolve` deliberately will not. Sources
+* without it fall back to the same guess prose gets.
+*/
+function fileTabForPath(sessionId, path) {
+	for (const source of activeFileLinkSources(sessionId)) {
+		const tab = source.openPath?.(sessionId, path) ?? source.resolve(sessionId, path);
+		if (tab !== void 0) return tab;
+	}
+}
+/**
+* Resolves the paths a message names against the plugins that track them.
+*
+* The resolver's identity is stable while the linkable set is, so a component
+* that hands it to a renderer does not rebuild that renderer on every frame of
+* a streaming reply.
+*/
+function useFileLinks(sessionId) {
+	const fingerprint = (0, react.useSyncExternalStore)((0, react.useCallback)((listener) => subscribeFileLinks(sessionId, listener), [sessionId]), () => fileLinkFingerprint(sessionId), () => fileLinkFingerprint(sessionId));
+	return (0, react.useCallback)((path) => fileLinkFor(sessionId, path), [sessionId, fingerprint]);
+}
+//#endregion
+exports.PACKAGED_MINOR_MODES = PACKAGED_MINOR_MODES;
+exports.PACKAGED_SELECTION_AXES = PACKAGED_SELECTION_AXES;
+exports.activityGroups = activityGroups;
+exports.bindFileLinkModes = bindFileLinkModes;
+exports.fileLinkFor = fileLinkFor;
+exports.fileTabForPath = fileTabForPath;
+exports.minorModes = minorModes;
+exports.selectionAxes = selectionAxes;
+exports.subscribeActivitySources = subscribeActivitySources;
+exports.useActivityGroups = useActivityGroups;
+exports.useDockFaces = useDockFaces;
+exports.useFileLinks = useFileLinks;
+
+//# sourceMappingURL=composition.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"composition.cjs","names":["pluginSelectionAxes","stripAnsi","isDesktopClient","pluginMinorModes","pluginActivityGroups","subscribeWebPluginRegistry","webPluginRegistryRevision","pluginDockFaces","pluginFileLinks","useSyncExternalStore","useCallback"],"sources":["../../../src/web/lib/composition.ts"],"sourcesContent":["import type {\n  ActivityGroupContribution,\n  DockFaceContribution,\n  SelectionAxisContribution,\n  TransientTab,\n} from '@agimon-ai/po-core/web';\nimport { useCallback, useSyncExternalStore } from 'react';\n\nimport type { MinorModeProjection, MinorModeRecordProjection } from '../../types/hub';\nimport {\n  isDesktopClient,\n  pluginActivityGroups,\n  pluginDockFaces,\n  pluginFileLinks,\n  pluginMinorModes,\n  pluginSelectionAxes,\n  subscribeWebPluginRegistry,\n  webPluginRegistryRevision,\n} from './pluginRegistry';\nimport { stripAnsi } from './statusLine';\n\nexport interface SelectionAxis {\n  name: string;\n  command: string;\n  /** The current selections, empty while the session reports none; one at most unless multi. */\n  values: string[];\n  emptyLabel: string;\n  multi: boolean;\n}\n\nconst AXIS_LIST_SEPARATOR = ',';\n\n/**\n * The fallback axis table for the packaged bundle; a synced bundle carries\n * each axis as its owning package's plugin declaration, and the registry\n * list wins whenever any plugin declares one. Exported only so the workspace\n * composition test can hold it equal to what the packages declare.\n */\nexport const PACKAGED_SELECTION_AXES: readonly SelectionAxisContribution[] = [\n  { name: 'profile', command: 'profile', statusKey: 'doom-profile', emptyLabel: 'no profile', order: 10 },\n  { name: 'domains', command: 'domains', statusKey: 'doom-domain', emptyLabel: 'no domains', multi: true, order: 20 },\n];\n\n/**\n * The declared axes the session actually offers: an axis whose status key\n * the session never published stays off the bar entirely, which is how a\n * package withholds its axis when there is nothing to select.\n */\nexport function selectionAxes(statuses: Record<string, string>): SelectionAxis[] {\n  const declared = pluginSelectionAxes();\n  const sources: readonly SelectionAxisContribution[] = declared.length > 0 ? declared : PACKAGED_SELECTION_AXES;\n  return sources.flatMap((source) => {\n    const raw = statuses[source.statusKey];\n    if (raw === undefined) return [];\n    const multi = source.multi === true;\n    const values = (multi ? stripAnsi(raw).split(AXIS_LIST_SEPARATOR) : [stripAnsi(raw)])\n      .map((value) => value.trim())\n      .filter(Boolean);\n    return [{ name: source.name, command: source.command, values, emptyLabel: source.emptyLabel, multi }];\n  });\n}\n\nexport type MinorModeAvailability = 'unavailable' | 'off' | 'on';\n\nexport interface MinorMode {\n  name: string;\n  /** The catalog id /minor accepts; the display name until the catalog reports. */\n  id: string;\n  /** Leader Space key path, as the TUI documents it. */\n  keys: string;\n  availability: MinorModeAvailability;\n  /** What the mode itself is reporting while on. */\n  detail: string;\n  /** Activity group to focus instead of invoking the mode command from the cockpit. */\n  activityGroup?: string;\n  /**\n   * Why the mode cannot be driven from here, in the words of the mode itself.\n   * Empty when it can. A mode may be installed and still refuse a cockpit:\n   * autonomous voice captures from the terminal's own microphone, which a\n   * browser talking to a headless agent does not have.\n   */\n  unavailableReason: string;\n}\n\nexport interface MinorModeSource {\n  name: string;\n  /** The catalog mode this row drives, when the runtime registers it under another id. */\n  modeId?: string;\n  /** Leader Space key path, as the TUI documents it. */\n  keys: string;\n  /** Activity group to focus instead of invoking the mode command from the cockpit. */\n  activityGroup?: string;\n  statusKey?: string;\n  widgetKey?: string;\n  hideWhenMissing?: boolean;\n  desktopOnly?: boolean;\n}\n\n/**\n * The fallback minor-mode table for the packaged bundle.\n *\n * A synced bundle carries each mode as its package's own web plugin\n * contribution, and the registry list wins whenever any plugin declares one.\n * This literal survives only so the built-in-only bundle keeps rendering the\n * modes Po ships; help is listed without a signal on purpose: it\n * registers no footer entry, so the cockpit reports it as unavailable rather\n * than guessing it is off. Exported only for the workspace composition test.\n */\nexport const PACKAGED_MINOR_MODES: readonly MinorModeSource[] = [\n  { name: 'help', keys: 'h e' },\n  { name: 'plan', keys: 'p e', statusKey: 'plan-mode' },\n  { name: 'loop', keys: 'l l', statusKey: 'doom-loop' },\n  { name: 'goal', keys: 'g e', statusKey: 'goal' },\n  { name: 'author', keys: 'o a' },\n  { name: 'workflow', keys: 'w e', widgetKey: 'workflow-mcp-progress' },\n  // `v e` drives autonomous capture, which the runtime registers as 'voice-auto'.\n  { name: 'voice', modeId: 'voice-auto', keys: 'v e', statusKey: 'doom-voice' },\n  {\n    name: 'computer use',\n    modeId: 'computer-use',\n    keys: 'c e',\n    statusKey: 'doom-computer-use-mode',\n    hideWhenMissing: true,\n    desktopOnly: true,\n  },\n];\n\n/** The declared source a catalog mode corresponds to, by id, id stem, or label. */\nfunction sourceFor(sources: readonly MinorModeSource[], mode: MinorModeRecordProjection): MinorModeSource | undefined {\n  const candidates = new Set([mode.id.toLowerCase(), mode.id.toLowerCase().split('.')[0], mode.label.toLowerCase()]);\n  return sources.find((source) =>\n    [source.name, source.modeId].some((identity) => identity !== undefined && candidates.has(identity.toLowerCase())),\n  );\n}\n\n/**\n * Catalog-backed rows: the runtime's own activation state per mode, with the\n * declared leader keys attached where a plugin documents them. Declared modes\n * the catalog does not know are still listed, as unavailable, so a mode that\n * is missing from a composition stays visible rather than silently gone.\n */\nfunction catalogMinorModes(sources: readonly MinorModeSource[], projection: MinorModeProjection): MinorMode[] {\n  const rows: MinorMode[] = projection.modes\n    .filter((mode) => !sourceFor(sources, mode)?.desktopOnly || isDesktopClient())\n    .map((mode) => {\n      const source = sourceFor(sources, mode);\n      const on = mode.activation === 'active' || mode.activation === 'deactivating';\n      // The catalog says per action whether it can run here and why not. A mode\n      // with nothing runnable is offered as a row that cannot be clicked rather\n      // than one that answers \"no actions available\" after the fact.\n      const blocked = mode.actions.length > 0 && mode.actions.every((action) => !action.enabled);\n      const reason = blocked ? (mode.actions.find((action) => action.disabledReason)?.disabledReason ?? '') : '';\n      return {\n        name: source?.name ?? mode.label.toLowerCase(),\n        id: mode.id,\n        keys: source?.keys ?? '',\n        availability: blocked && !on ? 'unavailable' : on ? 'on' : 'off',\n        ...(source?.activityGroup === undefined ? {} : { activityGroup: source.activityGroup }),\n        detail: mode.detail ?? (mode.activation === 'activating' ? 'activating' : ''),\n        unavailableReason: reason,\n      };\n    });\n  const seen = new Set(rows.map((row) => row.name));\n  for (const source of sources) {\n    if (source.hideWhenMissing === true || (source.desktopOnly && !isDesktopClient())) continue;\n    if (!seen.has(source.name)) {\n      rows.push({\n        name: source.name,\n        id: source.modeId ?? source.name,\n        keys: source.keys,\n        availability: 'unavailable',\n        ...(source.activityGroup === undefined ? {} : { activityGroup: source.activityGroup }),\n        detail: '',\n        unavailableReason: 'No package in this session registers this mode.',\n      });\n    }\n  }\n  return rows;\n}\n\nexport function minorModes(\n  statuses: Record<string, string>,\n  widgets: readonly string[],\n  projection: MinorModeProjection | null = null,\n): MinorMode[] {\n  const declared = pluginMinorModes();\n  const sources: readonly MinorModeSource[] = declared.length > 0 ? declared : PACKAGED_MINOR_MODES;\n  if (projection) return catalogMinorModes(sources, projection);\n  return sources.flatMap((source) => {\n    if (source.desktopOnly && !isDesktopClient()) return [];\n    if (source.statusKey !== undefined) {\n      const raw = statuses[source.statusKey];\n      if (raw === undefined) {\n        if (source.hideWhenMissing === true) return [];\n        return [\n          {\n            name: source.name,\n            id: source.modeId ?? source.name,\n            keys: source.keys,\n            availability: 'unavailable' as const,\n            ...(source.activityGroup === undefined ? {} : { activityGroup: source.activityGroup }),\n            detail: '',\n            unavailableReason: 'This session has not reported the mode.',\n          },\n        ];\n      }\n      const detail = stripAnsi(raw).trim();\n      return {\n        name: source.name,\n        id: source.modeId ?? source.name,\n        keys: source.keys,\n        availability: detail ? ('on' as const) : ('off' as const),\n        ...(source.activityGroup === undefined ? {} : { activityGroup: source.activityGroup }),\n        detail,\n        unavailableReason: '',\n      };\n    }\n    if (source.widgetKey !== undefined && widgets.includes(source.widgetKey)) {\n      return {\n        name: source.name,\n        id: source.modeId ?? source.name,\n        keys: source.keys,\n        availability: 'off' as const,\n        ...(source.activityGroup === undefined ? {} : { activityGroup: source.activityGroup }),\n        detail: '',\n        unavailableReason: '',\n      };\n    }\n    return {\n      name: source.name,\n      id: source.name,\n      keys: source.keys,\n      availability: 'unavailable' as const,\n      ...(source.activityGroup === undefined ? {} : { activityGroup: source.activityGroup }),\n      detail: '',\n      unavailableReason: 'This session has not reported the mode.',\n    };\n  });\n}\n\nexport interface ActivityGroup {\n  name: string;\n  keys: string;\n  /** The heading visual its package declares; the dock draws a generic one without it. */\n  icon?: ActivityGroupContribution['icon'];\n  /** What the publishing extension is reporting, empty when it reports nothing. */\n  summary: string;\n  active: boolean;\n  marksBackgroundWork?: boolean;\n  /** The temporary tab the group's name opens, when its package declares one. */\n  transientTab?: () => TransientTab;\n  /** Keeps the group visible below the dock's scrolling ordinary groups. */\n  placement?: 'bottom';\n}\n\n/** Subscribe to package-owned activity sources, rewiring when the focused composition changes. */\nexport function subscribeActivitySources(listener: () => void): () => void {\n  let subscriptions: (() => void)[] = [];\n  const unsubscribeSources = (): void => {\n    subscriptions.forEach((unsubscribe) => unsubscribe());\n    subscriptions = [];\n  };\n  const subscribeSources = (): void => {\n    subscriptions = pluginActivityGroups().flatMap((source) =>\n      source.activeSource === undefined ? [] : [source.activeSource.subscribe(listener)],\n    );\n  };\n  subscribeSources();\n  const unsubscribeRegistry = subscribeWebPluginRegistry(() => {\n    unsubscribeSources();\n    subscribeSources();\n    listener();\n  });\n  return () => {\n    unsubscribeRegistry();\n    unsubscribeSources();\n  };\n}\n\nfunction activitySourceFingerprint(sessionId: string | null): string {\n  const activeSources = pluginActivityGroups()\n    .map((source) => (source.activeSource?.isActive(sessionId) === true ? '1' : '0'))\n    .join('');\n  return `${webPluginRegistryRevision()}:${activeSources}`;\n}\n\n/**\n * The groups available in this plugin composition. Status and widget signals\n * reveal legacy groups. A package-owned active source also reveals its group,\n * including while idle, so the section can remain a stable launcher unless it\n * opts into `hideWhenEmpty`.\n *\n * A group that declared `hideWhenEmpty` goes away once its session stops\n * reporting. Clearing a status reaches the page as an empty string rather than\n * an absent key, because the same map tells the selection bar which minor modes\n * exist and an absent key means \"not reported\" there. Emptiness is read here,\n * where only the dock is looking.\n */\nexport function activityGroups(\n  statuses: Record<string, string>,\n  widgets: readonly string[],\n  sessionId: string | null = null,\n): ActivityGroup[] {\n  const groups: ActivityGroup[] = [];\n  for (const source of pluginActivityGroups()) {\n    const tab = source.transientTab === undefined ? {} : { transientTab: source.transientTab };\n    const placement = {\n      ...(source.placement === undefined ? {} : { placement: source.placement }),\n      ...(source.marksBackgroundWork === false ? { marksBackgroundWork: false } : {}),\n      ...(source.icon === undefined ? {} : { icon: source.icon }),\n    };\n    if (source.statusKey !== undefined && statuses[source.statusKey] !== undefined) {\n      const summary = stripAnsi(statuses[source.statusKey] ?? '').trim();\n      const active =\n        source.activeSource?.isActive(sessionId) ?? (source.marksBackgroundWork !== false && summary.length > 0);\n      if (summary.length === 0 && source.hideWhenEmpty === true && !active) continue;\n      groups.push({ name: source.name, keys: source.keys, summary, active, ...tab, ...placement });\n      continue;\n    }\n    if (source.widgetKeys !== undefined && source.widgetKeys.some((key) => widgets.includes(key))) {\n      const activeKeys = source.activeWidgetKeys ?? source.widgetKeys;\n      const active =\n        source.activeSource?.isActive(sessionId) ??\n        (source.marksBackgroundWork !== false && activeKeys.some((key) => widgets.includes(key)));\n      groups.push({ name: source.name, keys: source.keys, summary: '', active, ...tab, ...placement });\n      continue;\n    }\n    if (source.activeSource !== undefined) {\n      const active = source.activeSource.isActive(sessionId);\n      if (source.hideWhenEmpty === true && !active) continue;\n      groups.push({\n        name: source.name,\n        keys: source.keys,\n        summary: '',\n        active,\n        ...tab,\n        ...placement,\n      });\n    }\n  }\n  return groups;\n}\n\n/** Dock faces update when the active session composition changes. */\nexport function useDockFaces(sessionId: string | null): readonly DockFaceContribution[] {\n  useSyncExternalStore(subscribeWebPluginRegistry, webPluginRegistryRevision, webPluginRegistryRevision);\n  const subscribe = (listener: () => void) => {\n    const releases = pluginDockFaces().flatMap((face) =>\n      face.visibility ? [face.visibility.subscribe(listener)] : [],\n    );\n    return () => releases.forEach((release) => release());\n  };\n  const snapshot = () =>\n    pluginDockFaces()\n      .map((face) => (face.visibility?.isVisible(sessionId) !== false ? '1' : '0'))\n      .join('');\n  useSyncExternalStore(subscribe, snapshot, snapshot);\n  return pluginDockFaces().filter((face) => face.visibility?.isVisible(sessionId) !== false);\n}\n\n/** Activity groups that update when either host signals or a plugin's session store changes. */\nexport function useActivityGroups(\n  statuses: Record<string, string>,\n  widgets: readonly string[],\n  sessionId: string | null,\n): ActivityGroup[] {\n  useSyncExternalStore(\n    subscribeActivitySources,\n    () => activitySourceFingerprint(sessionId),\n    () => activitySourceFingerprint(sessionId),\n  );\n  return activityGroups(statuses, widgets, sessionId);\n}\n\n/** The tab one path opens, or undefined when no installed plugin recognises it. */\nexport type FileLinkResolver = (path: string) => TransientTab | undefined;\n\ninterface FileLinkModes {\n  active(sessionId: string | null): readonly string[];\n  subscribe(sessionId: string | null, listener: () => void): () => void;\n}\nlet fileLinkModes: FileLinkModes | undefined;\nconst modeBindings = new Set<() => void>();\n\n/** Binds host session facts without making the composition library own session state. */\nexport function bindFileLinkModes(source: FileLinkModes): () => void {\n  fileLinkModes = source;\n  modeBindings.forEach((listener) => listener());\n  return () => {\n    if (fileLinkModes !== source) return;\n    fileLinkModes = undefined;\n    modeBindings.forEach((listener) => listener());\n  };\n}\nfunction subscribeFileLinks(sessionId: string | null, listener: () => void): () => void {\n  let unsubscribeModes = fileLinkModes?.subscribe(sessionId, listener);\n  const rebindModes = () => {\n    unsubscribeModes?.();\n    unsubscribeModes = fileLinkModes?.subscribe(sessionId, listener);\n    listener();\n  };\n  modeBindings.add(rebindModes);\n  let subscriptions: (() => void)[] = [];\n  const unsubscribeSources = (): void => {\n    subscriptions.forEach((unsubscribe) => unsubscribe());\n    subscriptions = [];\n  };\n  const subscribeSources = (): void => {\n    subscriptions = pluginFileLinks().map((source) => source.subscribe(listener));\n  };\n  subscribeSources();\n  const unsubscribeRegistry = subscribeWebPluginRegistry(() => {\n    unsubscribeSources();\n    subscribeSources();\n    listener();\n  });\n  return () => {\n    modeBindings.delete(rebindModes);\n    unsubscribeModes?.();\n    unsubscribeRegistry();\n    unsubscribeSources();\n  };\n}\n\nfunction activeFileLinkSources(sessionId: string | null) {\n  const enabled = new Set(fileLinkModes?.active(sessionId) ?? []);\n  return pluginFileLinks().filter(\n    (source) => source.requiredMinorMode === undefined || enabled.has(source.requiredMinorMode),\n  );\n}\n\nfunction fileLinkFingerprint(sessionId: string | null): string {\n  const sourceFingerprints = activeFileLinkSources(sessionId)\n    .map((source) => `${source.requiredMinorMode ?? ''}:${source.fingerprint(sessionId)}`)\n    .join('\\n');\n  return `${webPluginRegistryRevision()}:${sourceFingerprints}`;\n}\n\n/**\n * The tab a path opens, from the first source that claims it.\n *\n * A path no source claims is not a link. The host cannot tell a file name from\n * a class name, and the plugin that tracks the session's files can, so the\n * decision belongs there rather than in a heuristic here.\n */\nexport function fileLinkFor(sessionId: string | null, path: string): TransientTab | undefined {\n  for (const source of activeFileLinkSources(sessionId)) {\n    const tab = source.resolve(sessionId, path);\n    if (tab !== undefined) return tab;\n  }\n  return undefined;\n}\n\n/**\n * The tab a path the caller is sure about opens: a tool call's path argument,\n * not a token spotted in prose.\n *\n * A source that offers `openPath` answers here, and it may claim a file the\n * session never changed, which `resolve` deliberately will not. Sources\n * without it fall back to the same guess prose gets.\n */\nexport function fileTabForPath(sessionId: string | null, path: string): TransientTab | undefined {\n  for (const source of activeFileLinkSources(sessionId)) {\n    const tab = source.openPath?.(sessionId, path) ?? source.resolve(sessionId, path);\n    if (tab !== undefined) return tab;\n  }\n  return undefined;\n}\n/**\n * Resolves the paths a message names against the plugins that track them.\n *\n * The resolver's identity is stable while the linkable set is, so a component\n * that hands it to a renderer does not rebuild that renderer on every frame of\n * a streaming reply.\n */\nexport function useFileLinks(sessionId: string | null): FileLinkResolver {\n  const fingerprint = useSyncExternalStore(\n    useCallback((listener: () => void) => subscribeFileLinks(sessionId, listener), [sessionId]),\n    () => fileLinkFingerprint(sessionId),\n    () => fileLinkFingerprint(sessionId),\n  );\n  return useCallback(\n    (path: string) => fileLinkFor(sessionId, path),\n    // The fingerprint is the dependency: the same path resolves differently\n    // once the session's set of tracked files changes.\n    // eslint-disable-next-line react-hooks/exhaustive-deps -- fingerprint is a deliberate identity buster, not a value the callback reads.\n    [sessionId, fingerprint],\n  );\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,137 @@
+import { MinorModeProjection } from "../../types/hub.mjs";
+import { ActivityGroupContribution, DockFaceContribution, SelectionAxisContribution, TransientTab } from "@agimon-ai/po-core/web";
+//#region src/web/lib/composition.d.ts
+export interface SelectionAxis {
+  name: string;
+  command: string;
+  /** The current selections, empty while the session reports none; one at most unless multi. */
+  values: string[];
+  emptyLabel: string;
+  multi: boolean;
+}
+/**
+ * The fallback axis table for the packaged bundle; a synced bundle carries
+ * each axis as its owning package's plugin declaration, and the registry
+ * list wins whenever any plugin declares one. Exported only so the workspace
+ * composition test can hold it equal to what the packages declare.
+ */
+export declare const PACKAGED_SELECTION_AXES: readonly SelectionAxisContribution[];
+/**
+ * The declared axes the session actually offers: an axis whose status key
+ * the session never published stays off the bar entirely, which is how a
+ * package withholds its axis when there is nothing to select.
+ */
+export declare function selectionAxes(statuses: Record<string, string>): SelectionAxis[];
+export type MinorModeAvailability = 'unavailable' | 'off' | 'on';
+export interface MinorMode {
+  name: string;
+  /** The catalog id /minor accepts; the display name until the catalog reports. */
+  id: string;
+  /** Leader Space key path, as the TUI documents it. */
+  keys: string;
+  availability: MinorModeAvailability;
+  /** What the mode itself is reporting while on. */
+  detail: string;
+  /** Activity group to focus instead of invoking the mode command from the cockpit. */
+  activityGroup?: string;
+  /**
+   * Why the mode cannot be driven from here, in the words of the mode itself.
+   * Empty when it can. A mode may be installed and still refuse a cockpit:
+   * autonomous voice captures from the terminal's own microphone, which a
+   * browser talking to a headless agent does not have.
+   */
+  unavailableReason: string;
+}
+export interface MinorModeSource {
+  name: string;
+  /** The catalog mode this row drives, when the runtime registers it under another id. */
+  modeId?: string;
+  /** Leader Space key path, as the TUI documents it. */
+  keys: string;
+  /** Activity group to focus instead of invoking the mode command from the cockpit. */
+  activityGroup?: string;
+  statusKey?: string;
+  widgetKey?: string;
+  hideWhenMissing?: boolean;
+  desktopOnly?: boolean;
+}
+/**
+ * The fallback minor-mode table for the packaged bundle.
+ *
+ * A synced bundle carries each mode as its package's own web plugin
+ * contribution, and the registry list wins whenever any plugin declares one.
+ * This literal survives only so the built-in-only bundle keeps rendering the
+ * modes Po ships; help is listed without a signal on purpose: it
+ * registers no footer entry, so the cockpit reports it as unavailable rather
+ * than guessing it is off. Exported only for the workspace composition test.
+ */
+export declare const PACKAGED_MINOR_MODES: readonly MinorModeSource[];
+export declare function minorModes(statuses: Record<string, string>, widgets: readonly string[], projection?: MinorModeProjection | null): MinorMode[];
+export interface ActivityGroup {
+  name: string;
+  keys: string;
+  /** The heading visual its package declares; the dock draws a generic one without it. */
+  icon?: ActivityGroupContribution['icon'];
+  /** What the publishing extension is reporting, empty when it reports nothing. */
+  summary: string;
+  active: boolean;
+  marksBackgroundWork?: boolean;
+  /** The temporary tab the group's name opens, when its package declares one. */
+  transientTab?: () => TransientTab;
+  /** Keeps the group visible below the dock's scrolling ordinary groups. */
+  placement?: 'bottom';
+}
+/** Subscribe to package-owned activity sources, rewiring when the focused composition changes. */
+export declare function subscribeActivitySources(listener: () => void): () => void;
+/**
+ * The groups available in this plugin composition. Status and widget signals
+ * reveal legacy groups. A package-owned active source also reveals its group,
+ * including while idle, so the section can remain a stable launcher unless it
+ * opts into `hideWhenEmpty`.
+ *
+ * A group that declared `hideWhenEmpty` goes away once its session stops
+ * reporting. Clearing a status reaches the page as an empty string rather than
+ * an absent key, because the same map tells the selection bar which minor modes
+ * exist and an absent key means "not reported" there. Emptiness is read here,
+ * where only the dock is looking.
+ */
+export declare function activityGroups(statuses: Record<string, string>, widgets: readonly string[], sessionId?: string | null): ActivityGroup[];
+/** Dock faces update when the active session composition changes. */
+export declare function useDockFaces(sessionId: string | null): readonly DockFaceContribution[];
+/** Activity groups that update when either host signals or a plugin's session store changes. */
+export declare function useActivityGroups(statuses: Record<string, string>, widgets: readonly string[], sessionId: string | null): ActivityGroup[];
+/** The tab one path opens, or undefined when no installed plugin recognises it. */
+export type FileLinkResolver = (path: string) => TransientTab | undefined;
+interface FileLinkModes {
+  active(sessionId: string | null): readonly string[];
+  subscribe(sessionId: string | null, listener: () => void): () => void;
+}
+/** Binds host session facts without making the composition library own session state. */
+export declare function bindFileLinkModes(source: FileLinkModes): () => void;
+/**
+ * The tab a path opens, from the first source that claims it.
+ *
+ * A path no source claims is not a link. The host cannot tell a file name from
+ * a class name, and the plugin that tracks the session's files can, so the
+ * decision belongs there rather than in a heuristic here.
+ */
+export declare function fileLinkFor(sessionId: string | null, path: string): TransientTab | undefined;
+/**
+ * The tab a path the caller is sure about opens: a tool call's path argument,
+ * not a token spotted in prose.
+ *
+ * A source that offers `openPath` answers here, and it may claim a file the
+ * session never changed, which `resolve` deliberately will not. Sources
+ * without it fall back to the same guess prose gets.
+ */
+export declare function fileTabForPath(sessionId: string | null, path: string): TransientTab | undefined;
+/**
+ * Resolves the paths a message names against the plugins that track them.
+ *
+ * The resolver's identity is stable while the linkable set is, so a component
+ * that hands it to a renderer does not rebuild that renderer on every frame of
+ * a streaming reply.
+ */
+export declare function useFileLinks(sessionId: string | null): FileLinkResolver;
+//#endregion
+//# sourceMappingURL=composition.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"composition.d.mts","names":[],"sources":["../../../src/web/lib/composition.ts"],"mappings":";;;iBAqBiB;EACf;EACA;;EAEA;EACA;EACA;;;;;;;;qBAWW,kCAAkC;;;;;;wBAU/B,cAAc,UAAU,yBAAyB;YAcrD;iBAEK;EACf;;EAEA;;EAEA;EACA,cAAc;;EAEd;;EAEA;;;;;;;EAOA;;iBAGe;EACf;;EAEA;;EAEA;;EAEA;EACA;EACA;EACA;EACA;;;;;;;;;;;;qBAaW,+BAA+B;wBAwE5B,WACd,UAAU,wBACV,4BACA,aAAY,6BACX;iBAwDc;EACf;EACA;;EAEA,OAAO;;EAEP;EACA;EACA;;EAEA,qBAAqB;;EAErB;;;wBAIc,yBAAyB;;;;;;;;;;;;;wBA0CzB,eACd,UAAU,wBACV,4BACA,4BACC;;wBA0Ca,aAAa,oCAAoC;;wBAiBjD,kBACd,UAAU,wBACV,4BACA,2BACC;;YAUS,oBAAoB,iBAAiB;UAEvC;EACR,OAAO;EACP,UAAU,0BAA0B;;;wBAMtB,kBAAkB,QAAQ;;;;;;;;wBA4D1B,YAAY,0BAA0B,eAAe;;;;;;;;;wBAgBrD,eAAe,0BAA0B,eAAe;;;;;;;;wBAcxD,aAAa,2BAA2B"}