@agimon-ai/doompi-minor-mode 0.0.1-alpha.70

package/dist/command.cjs

@@ -0,0 +1,134 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_command = require("./constants/command.cjs");
+//#region src/services/command/index.ts
+const MINOR_MODE_COMMAND = "minor";
+const REQUESTER_SOURCE = "@agimon-ai/doompi/mode-catalog/ui-command";
+function isOn(record) {
+	return record.state.activation === "active" || record.state.activation === "deactivating";
+}
+/** A catalog mode addressed the way a person types it: id, label, or id stem. */
+function matchMinorMode(records, query) {
+	const needle = query.toLowerCase();
+	return records.find((record) => record.descriptor.id.toLowerCase() === needle || record.descriptor.label.toLowerCase() === needle || record.descriptor.id.toLowerCase().split(".")[0] === needle);
+}
+/** The actions a session of this kind can currently take on a mode. */
+function actionsFor(record, kind) {
+	return record.descriptor.actions.filter((action) => {
+		if (!action.contexts.includes(kind)) return false;
+		return record.state.actions.find((entry) => entry.id === action.id)?.enabled !== false;
+	});
+}
+async function promptArguments(ui, action) {
+	const collected = {};
+	for (const parameter of action.parameters) {
+		if (!parameter.required) continue;
+		const title = `${action.label}: ${parameter.label}`;
+		if (parameter.kind === "boolean") {
+			const value = await ui.confirm(title, parameter.description ?? "");
+			if (value === void 0) return void 0;
+			collected[parameter.name] = value;
+			continue;
+		}
+		if (parameter.kind === "enum") {
+			const options = parameter.choices.map((choice) => choice.label);
+			const picked = await ui.select(title, options);
+			const choice = picked === void 0 ? void 0 : parameter.choices[options.indexOf(picked)];
+			if (!choice) return void 0;
+			collected[parameter.name] = choice.value;
+			continue;
+		}
+		const raw = await ui.input(title, parameter.description ?? "");
+		if (raw === void 0 || raw === "") return void 0;
+		if (parameter.kind === "number") {
+			const value = Number(raw);
+			if (!Number.isFinite(value)) {
+				await ui.notify(`${parameter.label} must be a number.`, "warning");
+				return;
+			}
+			collected[parameter.name] = value;
+		} else collected[parameter.name] = raw;
+	}
+	return collected;
+}
+/** Runs the catalog command against an explicit interaction surface. */
+async function executeMinorModeCommand(args, options) {
+	const { catalog, kind, ui } = options;
+	if (!catalog) {
+		await ui.notify("Minor modes are unavailable in this session.", "warning");
+		return;
+	}
+	const records = catalog.list();
+	const [modeQuery, actionQuery] = args.trim().split(/\s+/).filter(Boolean);
+	let record;
+	if (modeQuery) {
+		record = matchMinorMode(records, modeQuery);
+		if (!record) {
+			const known = records.map((entry) => entry.descriptor.label.toLowerCase()).join(", ") || "none";
+			await ui.notify(`No minor mode matches "${modeQuery}". Available: ${known}.`, "warning");
+			return;
+		}
+	} else {
+		const listed = records.filter((entry) => actionsFor(entry, kind).length > 0);
+		if (listed.length === 0) {
+			await ui.notify("No minor modes are available in this session.", "info");
+			return;
+		}
+		const labels = listed.map((entry) => `${isOn(entry) ? "[x]" : "[ ]"} ${entry.descriptor.label}: ${entry.descriptor.description}`);
+		const on = listed.filter(isOn).length;
+		const picked = await ui.select(`Minor modes (${String(on)} on)`, labels);
+		if (picked === void 0) return;
+		record = listed[labels.indexOf(picked)];
+		if (!record) return;
+	}
+	const actions = actionsFor(record, kind);
+	if (actions.length === 0) {
+		const reasons = [...new Set(record.state.actions.map((entry) => entry.disabledReason).filter((reason) => reason !== void 0 && reason.length > 0))];
+		const because = reasons.length > 0 ? ` ${reasons.join(" ")}` : "";
+		await ui.notify(`${record.descriptor.label} has no actions available in this session.${because}`, "warning");
+		return;
+	}
+	let action;
+	if (actionQuery) {
+		action = actions.find((entry) => entry.id.toLowerCase() === actionQuery.toLowerCase());
+		if (!action) {
+			const known = actions.map((entry) => entry.id).join(", ");
+			await ui.notify(`No "${actionQuery}" action on ${record.descriptor.label}. Available: ${known}.`, "warning");
+			return;
+		}
+	} else if (actions.length === 1) action = actions[0];
+	else {
+		const labels = actions.map((entry) => `${entry.label}: ${entry.description}`);
+		const picked = await ui.select(`${record.descriptor.label} (${record.state.activation})`, labels);
+		if (picked === void 0) return;
+		action = actions[labels.indexOf(picked)];
+	}
+	if (!action) return;
+	const argumentsValue = await promptArguments(ui, action);
+	if (argumentsValue === void 0) return;
+	try {
+		const response = await catalog.invoke({
+			operationId: globalThis.crypto.randomUUID(),
+			mode: {
+				source: record.descriptor.source,
+				id: record.descriptor.id,
+				ownerGeneration: record.ownerGeneration,
+				registrationId: record.registrationId
+			},
+			actionId: action.id,
+			arguments: argumentsValue
+		}, REQUESTER_SOURCE);
+		const state = response.mode.state;
+		const detail = state.detail ? `: ${state.detail}` : "";
+		await ui.notify(response.message ?? `${record.descriptor.label} is ${state.activation}${detail}.`, "info");
+	} catch (error) {
+		await ui.notify(`${record.descriptor.label} ${action.label} failed: ${error instanceof Error ? error.message : String(error)}`, "error");
+	}
+}
+//#endregion
+exports.MINOR_MODE_COMMAND = MINOR_MODE_COMMAND;
+exports.MINOR_MODE_COMMAND_DESCRIPTION = require_command.MINOR_MODE_COMMAND_DESCRIPTION;
+exports.actionsFor = actionsFor;
+exports.executeMinorModeCommand = executeMinorModeCommand;
+exports.matchMinorMode = matchMinorMode;
+
+//# sourceMappingURL=command.cjs.map

package/dist/command.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.cjs","names":[],"sources":["../src/services/command/index.ts"],"sourcesContent":["import type {\n  MinorModeActionDescriptor,\n  MinorModeArguments,\n  MinorModeCatalogService,\n  MinorModeRecord,\n  MinorModeSessionKind,\n} from '../../schemas/mode';\n\nexport const MINOR_MODE_COMMAND = 'minor';\nexport { MINOR_MODE_COMMAND_DESCRIPTION } from '../../constants/command';\nconst REQUESTER_SOURCE = '@agimon-ai/doompi/mode-catalog/ui-command';\n\ntype NotificationLevel = 'info' | 'warning' | 'error';\n\nexport interface MinorModeCommandPrompter {\n  select(title: string, options: readonly string[]): Promise<string | undefined>;\n  input(title: string, message: string): Promise<string | undefined>;\n  confirm(title: string, message: string): Promise<boolean | undefined>;\n  notify(message: string, level: NotificationLevel): void | Promise<void>;\n}\n\nfunction isOn(record: MinorModeRecord): boolean {\n  return record.state.activation === 'active' || record.state.activation === 'deactivating';\n}\n\n/** A catalog mode addressed the way a person types it: id, label, or id stem. */\nexport function matchMinorMode(records: readonly MinorModeRecord[], query: string): MinorModeRecord | undefined {\n  const needle = query.toLowerCase();\n  return records.find(\n    (record) =>\n      record.descriptor.id.toLowerCase() === needle ||\n      record.descriptor.label.toLowerCase() === needle ||\n      record.descriptor.id.toLowerCase().split('.')[0] === needle,\n  );\n}\n\n/** The actions a session of this kind can currently take on a mode. */\nexport function actionsFor(record: MinorModeRecord, kind: MinorModeSessionKind): MinorModeActionDescriptor[] {\n  return record.descriptor.actions.filter((action) => {\n    if (!action.contexts.includes(kind)) return false;\n    const availability = record.state.actions.find((entry) => entry.id === action.id);\n    return availability?.enabled !== false;\n  });\n}\n\nasync function promptArguments(\n  ui: MinorModeCommandPrompter,\n  action: MinorModeActionDescriptor,\n): Promise<MinorModeArguments | undefined> {\n  const collected: MinorModeArguments = {};\n  for (const parameter of action.parameters) {\n    if (!parameter.required) continue;\n    const title = `${action.label}: ${parameter.label}`;\n    if (parameter.kind === 'boolean') {\n      const value = await ui.confirm(title, parameter.description ?? '');\n      if (value === undefined) return undefined;\n      collected[parameter.name] = value;\n      continue;\n    }\n    if (parameter.kind === 'enum') {\n      const options = parameter.choices.map((choice) => choice.label);\n      const picked = await ui.select(title, options);\n      const choice = picked === undefined ? undefined : parameter.choices[options.indexOf(picked)];\n      if (!choice) return undefined;\n      collected[parameter.name] = choice.value;\n      continue;\n    }\n    const raw = await ui.input(title, parameter.description ?? '');\n    if (raw === undefined || raw === '') return undefined;\n    if (parameter.kind === 'number') {\n      const value = Number(raw);\n      if (!Number.isFinite(value)) {\n        await ui.notify(`${parameter.label} must be a number.`, 'warning');\n        return undefined;\n      }\n      collected[parameter.name] = value;\n    } else {\n      collected[parameter.name] = raw;\n    }\n  }\n  return collected;\n}\n\nexport interface ExecuteMinorModeCommandOptions {\n  catalog: MinorModeCatalogService | undefined;\n  kind: MinorModeSessionKind;\n  ui: MinorModeCommandPrompter;\n}\n\n/** Runs the catalog command against an explicit interaction surface. */\nexport async function executeMinorModeCommand(args: string, options: ExecuteMinorModeCommandOptions): Promise<void> {\n  const { catalog, kind, ui } = options;\n  if (!catalog) {\n    await ui.notify('Minor modes are unavailable in this session.', 'warning');\n    return;\n  }\n\n  const records = catalog.list();\n  const [modeQuery, actionQuery] = args.trim().split(/\\s+/).filter(Boolean);\n\n  let record: MinorModeRecord | undefined;\n  if (modeQuery) {\n    record = matchMinorMode(records, modeQuery);\n    if (!record) {\n      const known = records.map((entry) => entry.descriptor.label.toLowerCase()).join(', ') || 'none';\n      await ui.notify(`No minor mode matches \"${modeQuery}\". Available: ${known}.`, 'warning');\n      return;\n    }\n  } else {\n    const listed = records.filter((entry) => actionsFor(entry, kind).length > 0);\n    if (listed.length === 0) {\n      await ui.notify('No minor modes are available in this session.', 'info');\n      return;\n    }\n    const labels = listed.map(\n      (entry) => `${isOn(entry) ? '[x]' : '[ ]'} ${entry.descriptor.label}: ${entry.descriptor.description}`,\n    );\n    const on = listed.filter(isOn).length;\n    const picked = await ui.select(`Minor modes (${String(on)} on)`, labels);\n    if (picked === undefined) return;\n    record = listed[labels.indexOf(picked)];\n    if (!record) return;\n  }\n\n  const actions = actionsFor(record, kind);\n  if (actions.length === 0) {\n    // The mode already said why each action is unavailable. Repeating that\n    // is the difference between a dead end and an explanation: \"requires\n    // an interactive session\" tells a cockpit user to reach for the TUI,\n    // where the bare sentence leaves them guessing.\n    const reasons = [\n      ...new Set(\n        record.state.actions\n          .map((entry) => entry.disabledReason)\n          .filter((reason): reason is string => reason !== undefined && reason.length > 0),\n      ),\n    ];\n    const because = reasons.length > 0 ? ` ${reasons.join(' ')}` : '';\n    await ui.notify(`${record.descriptor.label} has no actions available in this session.${because}`, 'warning');\n    return;\n  }\n\n  let action: MinorModeActionDescriptor | undefined;\n  if (actionQuery) {\n    action = actions.find((entry) => entry.id.toLowerCase() === actionQuery.toLowerCase());\n    if (!action) {\n      const known = actions.map((entry) => entry.id).join(', ');\n      await ui.notify(`No \"${actionQuery}\" action on ${record.descriptor.label}. Available: ${known}.`, 'warning');\n      return;\n    }\n  } else if (actions.length === 1) {\n    action = actions[0];\n  } else {\n    const labels = actions.map((entry) => `${entry.label}: ${entry.description}`);\n    const picked = await ui.select(`${record.descriptor.label} (${record.state.activation})`, labels);\n    if (picked === undefined) return;\n    action = actions[labels.indexOf(picked)];\n  }\n  if (!action) return;\n\n  const argumentsValue = await promptArguments(ui, action);\n  if (argumentsValue === undefined) return;\n\n  try {\n    const response = await catalog.invoke(\n      {\n        operationId: globalThis.crypto.randomUUID(),\n        mode: {\n          source: record.descriptor.source,\n          id: record.descriptor.id,\n          ownerGeneration: record.ownerGeneration,\n          registrationId: record.registrationId,\n        },\n        actionId: action.id,\n        arguments: argumentsValue,\n      },\n      REQUESTER_SOURCE,\n    );\n    const state = response.mode.state;\n    const detail = state.detail ? `: ${state.detail}` : '';\n    await ui.notify(response.message ?? `${record.descriptor.label} is ${state.activation}${detail}.`, 'info');\n  } catch (error) {\n    await ui.notify(\n      `${record.descriptor.label} ${action.label} failed: ${error instanceof Error ? error.message : String(error)}`,\n      'error',\n    );\n  }\n}\n"],"mappings":"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"}

package/dist/command.d.cts

@@ -0,0 +1,25 @@
+import { MinorModeActionDescriptor, MinorModeCatalogService, MinorModeRecord, MinorModeSessionKind } from "./mode.cjs";
+import { MINOR_MODE_COMMAND_DESCRIPTION } from "./constants/command.cjs";
+//#region src/services/command/index.d.ts
+export declare const MINOR_MODE_COMMAND = "minor";
+type NotificationLevel = 'info' | 'warning' | 'error';
+export interface MinorModeCommandPrompter {
+  select(title: string, options: readonly string[]): Promise<string | undefined>;
+  input(title: string, message: string): Promise<string | undefined>;
+  confirm(title: string, message: string): Promise<boolean | undefined>;
+  notify(message: string, level: NotificationLevel): void | Promise<void>;
+}
+/** A catalog mode addressed the way a person types it: id, label, or id stem. */
+export declare function matchMinorMode(records: readonly MinorModeRecord[], query: string): MinorModeRecord | undefined;
+/** The actions a session of this kind can currently take on a mode. */
+export declare function actionsFor(record: MinorModeRecord, kind: MinorModeSessionKind): MinorModeActionDescriptor[];
+export interface ExecuteMinorModeCommandOptions {
+  catalog: MinorModeCatalogService | undefined;
+  kind: MinorModeSessionKind;
+  ui: MinorModeCommandPrompter;
+}
+/** Runs the catalog command against an explicit interaction surface. */
+export declare function executeMinorModeCommand(args: string, options: ExecuteMinorModeCommandOptions): Promise<void>;
+//#endregion
+export { MINOR_MODE_COMMAND_DESCRIPTION };
+//# sourceMappingURL=command.d.cts.map

package/dist/command.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.cts","names":[],"sources":["../src/services/command/index.ts"],"mappings":";;;qBAQa;KAIR;iBAEY;EACf,OAAO,eAAe,6BAA6B;EACnD,MAAM,eAAe,kBAAkB;EACvC,QAAQ,eAAe,kBAAkB;EACzC,OAAO,iBAAiB,OAAO,2BAA2B;;;wBAQ5C,eAAe,kBAAkB,mBAAmB,gBAAgB;;wBAWpE,WAAW,QAAQ,iBAAiB,MAAM,uBAAuB;iBA8ChE;EACf,SAAS;EACT,MAAM;EACN,IAAI;;;wBAIgB,wBAAwB,cAAc,SAAS,iCAAiC"}

package/dist/command.d.mts

@@ -0,0 +1,25 @@
+import { MinorModeActionDescriptor, MinorModeCatalogService, MinorModeRecord, MinorModeSessionKind } from "./mode.mjs";
+import { MINOR_MODE_COMMAND_DESCRIPTION } from "./constants/command.mjs";
+//#region src/services/command/index.d.ts
+export declare const MINOR_MODE_COMMAND = "minor";
+type NotificationLevel = 'info' | 'warning' | 'error';
+export interface MinorModeCommandPrompter {
+  select(title: string, options: readonly string[]): Promise<string | undefined>;
+  input(title: string, message: string): Promise<string | undefined>;
+  confirm(title: string, message: string): Promise<boolean | undefined>;
+  notify(message: string, level: NotificationLevel): void | Promise<void>;
+}
+/** A catalog mode addressed the way a person types it: id, label, or id stem. */
+export declare function matchMinorMode(records: readonly MinorModeRecord[], query: string): MinorModeRecord | undefined;
+/** The actions a session of this kind can currently take on a mode. */
+export declare function actionsFor(record: MinorModeRecord, kind: MinorModeSessionKind): MinorModeActionDescriptor[];
+export interface ExecuteMinorModeCommandOptions {
+  catalog: MinorModeCatalogService | undefined;
+  kind: MinorModeSessionKind;
+  ui: MinorModeCommandPrompter;
+}
+/** Runs the catalog command against an explicit interaction surface. */
+export declare function executeMinorModeCommand(args: string, options: ExecuteMinorModeCommandOptions): Promise<void>;
+//#endregion
+export { MINOR_MODE_COMMAND_DESCRIPTION };
+//# sourceMappingURL=command.d.mts.map

package/dist/command.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.mts","names":[],"sources":["../src/services/command/index.ts"],"mappings":";;;qBAQa;KAIR;iBAEY;EACf,OAAO,eAAe,6BAA6B;EACnD,MAAM,eAAe,kBAAkB;EACvC,QAAQ,eAAe,kBAAkB;EACzC,OAAO,iBAAiB,OAAO,2BAA2B;;;wBAQ5C,eAAe,kBAAkB,mBAAmB,gBAAgB;;wBAWpE,WAAW,QAAQ,iBAAiB,MAAM,uBAAuB;iBA8ChE;EACf,SAAS;EACT,MAAM;EACN,IAAI;;;wBAIgB,wBAAwB,cAAc,SAAS,iCAAiC"}

package/dist/command.mjs

@@ -0,0 +1,129 @@
+import { MINOR_MODE_COMMAND_DESCRIPTION } from "./constants/command.mjs";
+//#region src/services/command/index.ts
+const MINOR_MODE_COMMAND = "minor";
+const REQUESTER_SOURCE = "@agimon-ai/doompi/mode-catalog/ui-command";
+function isOn(record) {
+	return record.state.activation === "active" || record.state.activation === "deactivating";
+}
+/** A catalog mode addressed the way a person types it: id, label, or id stem. */
+function matchMinorMode(records, query) {
+	const needle = query.toLowerCase();
+	return records.find((record) => record.descriptor.id.toLowerCase() === needle || record.descriptor.label.toLowerCase() === needle || record.descriptor.id.toLowerCase().split(".")[0] === needle);
+}
+/** The actions a session of this kind can currently take on a mode. */
+function actionsFor(record, kind) {
+	return record.descriptor.actions.filter((action) => {
+		if (!action.contexts.includes(kind)) return false;
+		return record.state.actions.find((entry) => entry.id === action.id)?.enabled !== false;
+	});
+}
+async function promptArguments(ui, action) {
+	const collected = {};
+	for (const parameter of action.parameters) {
+		if (!parameter.required) continue;
+		const title = `${action.label}: ${parameter.label}`;
+		if (parameter.kind === "boolean") {
+			const value = await ui.confirm(title, parameter.description ?? "");
+			if (value === void 0) return void 0;
+			collected[parameter.name] = value;
+			continue;
+		}
+		if (parameter.kind === "enum") {
+			const options = parameter.choices.map((choice) => choice.label);
+			const picked = await ui.select(title, options);
+			const choice = picked === void 0 ? void 0 : parameter.choices[options.indexOf(picked)];
+			if (!choice) return void 0;
+			collected[parameter.name] = choice.value;
+			continue;
+		}
+		const raw = await ui.input(title, parameter.description ?? "");
+		if (raw === void 0 || raw === "") return void 0;
+		if (parameter.kind === "number") {
+			const value = Number(raw);
+			if (!Number.isFinite(value)) {
+				await ui.notify(`${parameter.label} must be a number.`, "warning");
+				return;
+			}
+			collected[parameter.name] = value;
+		} else collected[parameter.name] = raw;
+	}
+	return collected;
+}
+/** Runs the catalog command against an explicit interaction surface. */
+async function executeMinorModeCommand(args, options) {
+	const { catalog, kind, ui } = options;
+	if (!catalog) {
+		await ui.notify("Minor modes are unavailable in this session.", "warning");
+		return;
+	}
+	const records = catalog.list();
+	const [modeQuery, actionQuery] = args.trim().split(/\s+/).filter(Boolean);
+	let record;
+	if (modeQuery) {
+		record = matchMinorMode(records, modeQuery);
+		if (!record) {
+			const known = records.map((entry) => entry.descriptor.label.toLowerCase()).join(", ") || "none";
+			await ui.notify(`No minor mode matches "${modeQuery}". Available: ${known}.`, "warning");
+			return;
+		}
+	} else {
+		const listed = records.filter((entry) => actionsFor(entry, kind).length > 0);
+		if (listed.length === 0) {
+			await ui.notify("No minor modes are available in this session.", "info");
+			return;
+		}
+		const labels = listed.map((entry) => `${isOn(entry) ? "[x]" : "[ ]"} ${entry.descriptor.label}: ${entry.descriptor.description}`);
+		const on = listed.filter(isOn).length;
+		const picked = await ui.select(`Minor modes (${String(on)} on)`, labels);
+		if (picked === void 0) return;
+		record = listed[labels.indexOf(picked)];
+		if (!record) return;
+	}
+	const actions = actionsFor(record, kind);
+	if (actions.length === 0) {
+		const reasons = [...new Set(record.state.actions.map((entry) => entry.disabledReason).filter((reason) => reason !== void 0 && reason.length > 0))];
+		const because = reasons.length > 0 ? ` ${reasons.join(" ")}` : "";
+		await ui.notify(`${record.descriptor.label} has no actions available in this session.${because}`, "warning");
+		return;
+	}
+	let action;
+	if (actionQuery) {
+		action = actions.find((entry) => entry.id.toLowerCase() === actionQuery.toLowerCase());
+		if (!action) {
+			const known = actions.map((entry) => entry.id).join(", ");
+			await ui.notify(`No "${actionQuery}" action on ${record.descriptor.label}. Available: ${known}.`, "warning");
+			return;
+		}
+	} else if (actions.length === 1) action = actions[0];
+	else {
+		const labels = actions.map((entry) => `${entry.label}: ${entry.description}`);
+		const picked = await ui.select(`${record.descriptor.label} (${record.state.activation})`, labels);
+		if (picked === void 0) return;
+		action = actions[labels.indexOf(picked)];
+	}
+	if (!action) return;
+	const argumentsValue = await promptArguments(ui, action);
+	if (argumentsValue === void 0) return;
+	try {
+		const response = await catalog.invoke({
+			operationId: globalThis.crypto.randomUUID(),
+			mode: {
+				source: record.descriptor.source,
+				id: record.descriptor.id,
+				ownerGeneration: record.ownerGeneration,
+				registrationId: record.registrationId
+			},
+			actionId: action.id,
+			arguments: argumentsValue
+		}, REQUESTER_SOURCE);
+		const state = response.mode.state;
+		const detail = state.detail ? `: ${state.detail}` : "";
+		await ui.notify(response.message ?? `${record.descriptor.label} is ${state.activation}${detail}.`, "info");
+	} catch (error) {
+		await ui.notify(`${record.descriptor.label} ${action.label} failed: ${error instanceof Error ? error.message : String(error)}`, "error");
+	}
+}
+//#endregion
+export { MINOR_MODE_COMMAND, MINOR_MODE_COMMAND_DESCRIPTION, actionsFor, executeMinorModeCommand, matchMinorMode };
+
+//# sourceMappingURL=command.mjs.map

package/dist/command.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.mjs","names":[],"sources":["../src/services/command/index.ts"],"sourcesContent":["import type {\n  MinorModeActionDescriptor,\n  MinorModeArguments,\n  MinorModeCatalogService,\n  MinorModeRecord,\n  MinorModeSessionKind,\n} from '../../schemas/mode';\n\nexport const MINOR_MODE_COMMAND = 'minor';\nexport { MINOR_MODE_COMMAND_DESCRIPTION } from '../../constants/command';\nconst REQUESTER_SOURCE = '@agimon-ai/doompi/mode-catalog/ui-command';\n\ntype NotificationLevel = 'info' | 'warning' | 'error';\n\nexport interface MinorModeCommandPrompter {\n  select(title: string, options: readonly string[]): Promise<string | undefined>;\n  input(title: string, message: string): Promise<string | undefined>;\n  confirm(title: string, message: string): Promise<boolean | undefined>;\n  notify(message: string, level: NotificationLevel): void | Promise<void>;\n}\n\nfunction isOn(record: MinorModeRecord): boolean {\n  return record.state.activation === 'active' || record.state.activation === 'deactivating';\n}\n\n/** A catalog mode addressed the way a person types it: id, label, or id stem. */\nexport function matchMinorMode(records: readonly MinorModeRecord[], query: string): MinorModeRecord | undefined {\n  const needle = query.toLowerCase();\n  return records.find(\n    (record) =>\n      record.descriptor.id.toLowerCase() === needle ||\n      record.descriptor.label.toLowerCase() === needle ||\n      record.descriptor.id.toLowerCase().split('.')[0] === needle,\n  );\n}\n\n/** The actions a session of this kind can currently take on a mode. */\nexport function actionsFor(record: MinorModeRecord, kind: MinorModeSessionKind): MinorModeActionDescriptor[] {\n  return record.descriptor.actions.filter((action) => {\n    if (!action.contexts.includes(kind)) return false;\n    const availability = record.state.actions.find((entry) => entry.id === action.id);\n    return availability?.enabled !== false;\n  });\n}\n\nasync function promptArguments(\n  ui: MinorModeCommandPrompter,\n  action: MinorModeActionDescriptor,\n): Promise<MinorModeArguments | undefined> {\n  const collected: MinorModeArguments = {};\n  for (const parameter of action.parameters) {\n    if (!parameter.required) continue;\n    const title = `${action.label}: ${parameter.label}`;\n    if (parameter.kind === 'boolean') {\n      const value = await ui.confirm(title, parameter.description ?? '');\n      if (value === undefined) return undefined;\n      collected[parameter.name] = value;\n      continue;\n    }\n    if (parameter.kind === 'enum') {\n      const options = parameter.choices.map((choice) => choice.label);\n      const picked = await ui.select(title, options);\n      const choice = picked === undefined ? undefined : parameter.choices[options.indexOf(picked)];\n      if (!choice) return undefined;\n      collected[parameter.name] = choice.value;\n      continue;\n    }\n    const raw = await ui.input(title, parameter.description ?? '');\n    if (raw === undefined || raw === '') return undefined;\n    if (parameter.kind === 'number') {\n      const value = Number(raw);\n      if (!Number.isFinite(value)) {\n        await ui.notify(`${parameter.label} must be a number.`, 'warning');\n        return undefined;\n      }\n      collected[parameter.name] = value;\n    } else {\n      collected[parameter.name] = raw;\n    }\n  }\n  return collected;\n}\n\nexport interface ExecuteMinorModeCommandOptions {\n  catalog: MinorModeCatalogService | undefined;\n  kind: MinorModeSessionKind;\n  ui: MinorModeCommandPrompter;\n}\n\n/** Runs the catalog command against an explicit interaction surface. */\nexport async function executeMinorModeCommand(args: string, options: ExecuteMinorModeCommandOptions): Promise<void> {\n  const { catalog, kind, ui } = options;\n  if (!catalog) {\n    await ui.notify('Minor modes are unavailable in this session.', 'warning');\n    return;\n  }\n\n  const records = catalog.list();\n  const [modeQuery, actionQuery] = args.trim().split(/\\s+/).filter(Boolean);\n\n  let record: MinorModeRecord | undefined;\n  if (modeQuery) {\n    record = matchMinorMode(records, modeQuery);\n    if (!record) {\n      const known = records.map((entry) => entry.descriptor.label.toLowerCase()).join(', ') || 'none';\n      await ui.notify(`No minor mode matches \"${modeQuery}\". Available: ${known}.`, 'warning');\n      return;\n    }\n  } else {\n    const listed = records.filter((entry) => actionsFor(entry, kind).length > 0);\n    if (listed.length === 0) {\n      await ui.notify('No minor modes are available in this session.', 'info');\n      return;\n    }\n    const labels = listed.map(\n      (entry) => `${isOn(entry) ? '[x]' : '[ ]'} ${entry.descriptor.label}: ${entry.descriptor.description}`,\n    );\n    const on = listed.filter(isOn).length;\n    const picked = await ui.select(`Minor modes (${String(on)} on)`, labels);\n    if (picked === undefined) return;\n    record = listed[labels.indexOf(picked)];\n    if (!record) return;\n  }\n\n  const actions = actionsFor(record, kind);\n  if (actions.length === 0) {\n    // The mode already said why each action is unavailable. Repeating that\n    // is the difference between a dead end and an explanation: \"requires\n    // an interactive session\" tells a cockpit user to reach for the TUI,\n    // where the bare sentence leaves them guessing.\n    const reasons = [\n      ...new Set(\n        record.state.actions\n          .map((entry) => entry.disabledReason)\n          .filter((reason): reason is string => reason !== undefined && reason.length > 0),\n      ),\n    ];\n    const because = reasons.length > 0 ? ` ${reasons.join(' ')}` : '';\n    await ui.notify(`${record.descriptor.label} has no actions available in this session.${because}`, 'warning');\n    return;\n  }\n\n  let action: MinorModeActionDescriptor | undefined;\n  if (actionQuery) {\n    action = actions.find((entry) => entry.id.toLowerCase() === actionQuery.toLowerCase());\n    if (!action) {\n      const known = actions.map((entry) => entry.id).join(', ');\n      await ui.notify(`No \"${actionQuery}\" action on ${record.descriptor.label}. Available: ${known}.`, 'warning');\n      return;\n    }\n  } else if (actions.length === 1) {\n    action = actions[0];\n  } else {\n    const labels = actions.map((entry) => `${entry.label}: ${entry.description}`);\n    const picked = await ui.select(`${record.descriptor.label} (${record.state.activation})`, labels);\n    if (picked === undefined) return;\n    action = actions[labels.indexOf(picked)];\n  }\n  if (!action) return;\n\n  const argumentsValue = await promptArguments(ui, action);\n  if (argumentsValue === undefined) return;\n\n  try {\n    const response = await catalog.invoke(\n      {\n        operationId: globalThis.crypto.randomUUID(),\n        mode: {\n          source: record.descriptor.source,\n          id: record.descriptor.id,\n          ownerGeneration: record.ownerGeneration,\n          registrationId: record.registrationId,\n        },\n        actionId: action.id,\n        arguments: argumentsValue,\n      },\n      REQUESTER_SOURCE,\n    );\n    const state = response.mode.state;\n    const detail = state.detail ? `: ${state.detail}` : '';\n    await ui.notify(response.message ?? `${record.descriptor.label} is ${state.activation}${detail}.`, 'info');\n  } catch (error) {\n    await ui.notify(\n      `${record.descriptor.label} ${action.label} failed: ${error instanceof Error ? error.message : String(error)}`,\n      'error',\n    );\n  }\n}\n"],"mappings":"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"}

package/dist/constants/command.cjs

@@ -0,0 +1,6 @@
+//#region src/constants/command.ts
+const MINOR_MODE_COMMAND_DESCRIPTION = "Toggle or drive minor modes";
+//#endregion
+exports.MINOR_MODE_COMMAND_DESCRIPTION = MINOR_MODE_COMMAND_DESCRIPTION;
+
+//# sourceMappingURL=command.cjs.map

package/dist/constants/command.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.cjs","names":[],"sources":["../../src/constants/command.ts"],"sourcesContent":["export const MINOR_MODE_COMMAND_DESCRIPTION = 'Toggle or drive minor modes';\n"],"mappings":";AAAA,MAAa,iCAAiC"}

package/dist/constants/command.d.cts

@@ -0,0 +1,4 @@
+//#region src/constants/command.d.ts
+export declare const MINOR_MODE_COMMAND_DESCRIPTION = "Toggle or drive minor modes";
+//#endregion
+//# sourceMappingURL=command.d.cts.map

package/dist/constants/command.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.cts","names":[],"sources":["../../src/constants/command.ts"],"mappings":";qBAAa"}

package/dist/constants/command.d.mts

@@ -0,0 +1,4 @@
+//#region src/constants/command.d.ts
+export declare const MINOR_MODE_COMMAND_DESCRIPTION = "Toggle or drive minor modes";
+//#endregion
+//# sourceMappingURL=command.d.mts.map

package/dist/constants/command.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.mts","names":[],"sources":["../../src/constants/command.ts"],"mappings":";qBAAa"}

package/dist/constants/command.mjs

@@ -0,0 +1,6 @@
+//#region src/constants/command.ts
+const MINOR_MODE_COMMAND_DESCRIPTION = "Toggle or drive minor modes";
+//#endregion
+export { MINOR_MODE_COMMAND_DESCRIPTION };
+
+//# sourceMappingURL=command.mjs.map

package/dist/constants/command.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.mjs","names":[],"sources":["../../src/constants/command.ts"],"sourcesContent":["export const MINOR_MODE_COMMAND_DESCRIPTION = 'Toggle or drive minor modes';\n"],"mappings":";AAAA,MAAa,iCAAiC"}

package/dist/controllers/catalogRuntime.cjs

@@ -0,0 +1,123 @@
+const require_mode = require("../mode.cjs");
+const require_catalog = require("../catalog.cjs");
+const require_projection = require("../projection.cjs");
+const require_reload_handoff = require("../reload-handoff.cjs");
+const require_minor_mode_command = require("../minor-mode-command.cjs");
+let _agimon_ai_doompi_core_cordis_host = require("@agimon-ai/doompi-core/cordis-host");
+let _agimon_ai_doompi_core_notification = require("@agimon-ai/doompi-core/notification");
+let _agimon_ai_doompi_core_transition = require("@agimon-ai/doompi-core/transition");
+//#region src/controllers/catalogRuntime.ts
+/** Registrations and state flips arrive in bursts; one entry covers a burst. */
+const PROJECTION_SETTLE_MS = 50;
+/**
+* Pi's rpc mode subscribes to session events only after bindExtensions()
+* returns, which is after session_start has run, so an entry journaled during
+* startup never reaches a client. A publish deferred past that point does.
+*/
+const BOOT_PUBLISH_DELAY_MS = 500;
+function notify(cordis, context, body, level) {
+	const service = (0, _agimon_ai_doompi_core_notification.readDoomNotificationService)(cordis);
+	if (service) {
+		try {
+			Promise.resolve(service.request({
+				body,
+				level
+			})).catch(() => void 0);
+		} catch {}
+		return;
+	}
+	context.ui.notify(body, level);
+}
+function transitionSource(requesterSource) {
+	if (requesterSource.includes("voice")) return "voice";
+	if (requesterSource.includes("leader")) return "leader";
+	if (requesterSource.includes("ui")) return "ui";
+	return "system";
+}
+/**
+* The minor modes that are actually on, for the composition panel.
+*
+* Read from the bound catalog at publish time rather than passed in, because a
+* mode switching on is one of the reasons a publish happens at all, and a
+* remembered list would describe the composition before the switch.
+*/
+function createMinorModePiRuntime(pi) {
+	const activeCatalog = { current: void 0 };
+	require_minor_mode_command.registerMinorModeCommand(pi, () => activeCatalog.current);
+	pi.on("session_start", () => {
+		setTimeout(() => {
+			activeCatalog.republish?.();
+		}, BOOT_PUBLISH_DELAY_MS);
+	});
+	return { services: [(cordis) => modeCatalogPlugin(cordis, pi, activeCatalog)] };
+}
+function modeCatalogPlugin(cordis, pi, activeCatalog) {
+	cordis.inject([_agimon_ai_doompi_core_cordis_host.DOOM_CORDIS_SESSION_SERVICE, _agimon_ai_doompi_core_transition.DOOM_TRANSITION_SERVICE], (sessionContext) => {
+		const session = sessionContext.get(_agimon_ai_doompi_core_cordis_host.DOOM_CORDIS_SESSION_SERVICE);
+		const context = session.context;
+		const coordinator = (0, _agimon_ai_doompi_core_transition.requireDoomTransitionCoordinator)(sessionContext);
+		const reloadSession = session.reason === "reload";
+		const sessionId = session.sessionId;
+		const restoreSnapshot = reloadSession ? require_reload_handoff.consumeMinorModeReloadHandoff(sessionId) : void 0;
+		if (!reloadSession) require_reload_handoff.discardMinorModeReloadHandoff(sessionId);
+		const sessionKind = context.hasUI && context.mode === "tui" ? "tui" : "headless";
+		const catalog = require_catalog.createMinorModeCatalogHost({
+			sessionKind,
+			context,
+			restoreSnapshot,
+			onRestorationError(error) {
+				notify(sessionContext, context, `Could not restore a minor mode after reload: ${error instanceof Error ? error.message : String(error)}`, "warning");
+			},
+			async routeInvocation(request, requesterSource, invoke) {
+				let response;
+				const result = await coordinator.execute({
+					sessionId: context.sessionManager.getSessionId(),
+					hostGeneration: coordinator.hostGeneration,
+					operationId: request.operationId,
+					source: transitionSource(requesterSource),
+					target: {
+						axis: "live",
+						capability: "minor-mode"
+					}
+				}, async () => {
+					response = await invoke();
+					return "applied";
+				});
+				if (result.outcome !== "applied" || !response) throw new Error(`Minor-mode transition was ${result.outcome}: ${result.diagnostics.join(", ")}`);
+				return response;
+			}
+		});
+		sessionContext.provide(require_mode.DOOM_MINOR_MODE_CATALOG_SERVICE, catalog);
+		activeCatalog.current = catalog;
+		activeCatalog.sessionId = sessionId;
+		let published;
+		let settle;
+		const publish = () => {
+			settle = void 0;
+			const projection = require_projection.projectMinorModes(catalog.getSnapshot(), sessionKind);
+			const serialized = JSON.stringify(projection);
+			if (serialized === published) return;
+			published = serialized;
+			pi.appendEntry(require_mode.DOOM_MINOR_MODE_ENTRY_TYPE, projection);
+		};
+		const unsubscribe = catalog.subscribe(() => {
+			settle ??= setTimeout(publish, PROJECTION_SETTLE_MS);
+		});
+		activeCatalog.republish = () => {
+			published = void 0;
+			publish();
+		};
+		return () => {
+			if (settle) clearTimeout(settle);
+			unsubscribe();
+			activeCatalog.republish = void 0;
+			activeCatalog.current = void 0;
+			activeCatalog.sessionId = void 0;
+			catalog.dispose();
+		};
+	});
+}
+//#endregion
+exports.createMinorModePiRuntime = createMinorModePiRuntime;
+
+//# sourceMappingURL=catalogRuntime.cjs.map

package/dist/controllers/catalogRuntime.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalogRuntime.cjs","names":["readDoomNotificationService","DOOM_CORDIS_SESSION_SERVICE","DOOM_TRANSITION_SERVICE","requireDoomTransitionCoordinator","consumeMinorModeReloadHandoff","createMinorModeCatalogHost","DOOM_MINOR_MODE_CATALOG_SERVICE","projectMinorModes","DOOM_MINOR_MODE_ENTRY_TYPE"],"sources":["../../src/controllers/catalogRuntime.ts"],"sourcesContent":["import { DOOM_CORDIS_SESSION_SERVICE, type DoomCordisSessionService } from '@agimon-ai/doompi-core/cordis-host';\nimport { type DoomNotificationLevel, readDoomNotificationService } from '@agimon-ai/doompi-core/notification';\nimport type { PiPluginContributions } from '@agimon-ai/doompi-core/pi-extension';\nimport {\n  DOOM_TRANSITION_SERVICE,\n  requireDoomTransitionCoordinator,\n  type TransitionSource,\n} from '@agimon-ai/doompi-core/transition';\nimport type { Context } from '@deepseek-ai/cordis';\nimport type { ExtensionAPI, ExtensionContext } from '@earendil-works/pi-coding-agent';\n\nimport {\n  DOOM_MINOR_MODE_CATALOG_SERVICE,\n  DOOM_MINOR_MODE_ENTRY_TYPE,\n  type MinorModeActionResponse,\n  type MinorModeCatalogService,\n} from '../schemas/mode';\nimport { createMinorModeCatalogHost } from '../services/catalog';\nimport { projectMinorModes } from '../services/projection';\nimport { consumeMinorModeReloadHandoff, discardMinorModeReloadHandoff } from '../services/reloadHandoff';\nimport { registerMinorModeCommand } from './minorModeCommand';\n\n/** Registrations and state flips arrive in bursts; one entry covers a burst. */\nconst PROJECTION_SETTLE_MS = 50;\n/**\n * Pi's rpc mode subscribes to session events only after bindExtensions()\n * returns, which is after session_start has run, so an entry journaled during\n * startup never reaches a client. A publish deferred past that point does.\n */\nconst BOOT_PUBLISH_DELAY_MS = 500;\n\ninterface CatalogBinding {\n  current: MinorModeCatalogService | undefined;\n  /** Journals the projection even if unchanged; set while a session is bound. */\n  republish?: () => void;\n  /**\n   * The bound session, which the detail store is keyed by.\n   *\n   * The server launches the agent with `--session-id`, so this is the same id\n   * the cockpit and the session API know the session by, and a browser asking\n   * for a row's detail looks under the file this session wrote.\n   */\n  sessionId?: string;\n}\n\nfunction notify(cordis: Context, context: ExtensionContext, body: string, level: DoomNotificationLevel): void {\n  const service = readDoomNotificationService(cordis);\n  if (service) {\n    try {\n      void Promise.resolve(service.request({ body, level })).catch(() => undefined);\n    } catch {\n      // Notification delivery is best effort and does not fall back after routing.\n    }\n    return;\n  }\n  context.ui.notify(body, level);\n}\n\nfunction transitionSource(requesterSource: string): TransitionSource {\n  if (requesterSource.includes('voice')) return 'voice';\n  if (requesterSource.includes('leader')) return 'leader';\n  if (requesterSource.includes('ui')) return 'ui';\n  return 'system';\n}\n\n/**\n * The minor modes that are actually on, for the composition panel.\n *\n * Read from the bound catalog at publish time rather than passed in, because a\n * mode switching on is one of the reasons a publish happens at all, and a\n * remembered list would describe the composition before the switch.\n */\nexport function createMinorModePiRuntime(pi: ExtensionAPI): PiPluginContributions {\n  // The command outlives any one session: it is registered once and reads the\n  // catalog binding the session-scoped inject below sets and clears.\n  const activeCatalog: CatalogBinding = { current: undefined };\n  registerMinorModeCommand(pi, () => activeCatalog.current);\n  // The composition is only complete once every extension has registered, so\n  // the inventory is read on the same deferred tick the catalog republishes on.\n  pi.on('session_start', () => {\n    setTimeout(() => {\n      activeCatalog.republish?.();\n    }, BOOT_PUBLISH_DELAY_MS);\n  });\n  return { services: [(cordis: Context) => modeCatalogPlugin(cordis, pi, activeCatalog)] };\n}\n\nfunction modeCatalogPlugin(\n  cordis: Context,\n  pi: Pick<ExtensionAPI, 'appendEntry'>,\n  activeCatalog: CatalogBinding,\n): void {\n  cordis.inject([DOOM_CORDIS_SESSION_SERVICE, DOOM_TRANSITION_SERVICE], (sessionContext) => {\n    const session = sessionContext.get(DOOM_CORDIS_SESSION_SERVICE) as DoomCordisSessionService;\n    const context = session.context;\n    const coordinator = requireDoomTransitionCoordinator(sessionContext);\n    const reloadSession = session.reason === 'reload';\n    const sessionId = session.sessionId;\n    const restoreSnapshot = reloadSession ? consumeMinorModeReloadHandoff(sessionId) : undefined;\n    if (!reloadSession) discardMinorModeReloadHandoff(sessionId);\n    const sessionKind = context.hasUI && context.mode === 'tui' ? 'tui' : 'headless';\n    const catalog: MinorModeCatalogService = createMinorModeCatalogHost({\n      sessionKind,\n      context,\n      restoreSnapshot,\n      onRestorationError(error) {\n        notify(\n          sessionContext,\n          context,\n          `Could not restore a minor mode after reload: ${error instanceof Error ? error.message : String(error)}`,\n          'warning',\n        );\n      },\n      async routeInvocation(request, requesterSource, invoke) {\n        let response: MinorModeActionResponse | undefined;\n        const result = await coordinator.execute(\n          {\n            sessionId: context.sessionManager.getSessionId(),\n            hostGeneration: coordinator.hostGeneration,\n            operationId: request.operationId,\n            source: transitionSource(requesterSource),\n            target: { axis: 'live', capability: 'minor-mode' },\n          },\n          async () => {\n            response = await invoke();\n            return 'applied';\n          },\n        );\n        if (result.outcome !== 'applied' || !response) {\n          throw new Error(`Minor-mode transition was ${result.outcome}: ${result.diagnostics.join(', ')}`);\n        }\n        return response;\n      },\n    });\n    sessionContext.provide(DOOM_MINOR_MODE_CATALOG_SERVICE, catalog);\n    activeCatalog.current = catalog;\n    activeCatalog.sessionId = sessionId;\n\n    // Journal the projection so RPC clients see catalog state live and on\n    // replay; identical projections are skipped so detail churn stays cheap.\n    let published: string | undefined;\n    let settle: NodeJS.Timeout | undefined;\n    const publish = (): void => {\n      settle = undefined;\n      const projection = projectMinorModes(catalog.getSnapshot(), sessionKind);\n      const serialized = JSON.stringify(projection);\n      if (serialized === published) return;\n      published = serialized;\n      pi.appendEntry(DOOM_MINOR_MODE_ENTRY_TYPE, projection);\n      // A mode changing is the usual reason the toolbox changed too.\n    };\n    const unsubscribe = catalog.subscribe(() => {\n      settle ??= setTimeout(publish, PROJECTION_SETTLE_MS);\n    });\n    activeCatalog.republish = () => {\n      published = undefined;\n      publish();\n    };\n\n    return () => {\n      if (settle) clearTimeout(settle);\n      unsubscribe();\n      activeCatalog.republish = undefined;\n      activeCatalog.current = undefined;\n      activeCatalog.sessionId = undefined;\n      catalog.dispose();\n    };\n  });\n}\n"],"mappings":"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"}