@agimon-ai/po-domain 0.0.0-alpha.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Vuong Ngo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,71 @@
+# @agimon-ai/po-domain
+
+Domain selection for [Po](https://www.npmjs.com/package/@agimon-ai/po) sessions.
+
+**Domains** are one of the four axes of a Po selection, alongside the major mode, the profile,
+and the minor modes. Unlike a major mode, domains compose: a session selects a set of them, and
+the union of what they contribute is what the model sees.
+
+```yaml
+# .po/domains.yaml
+plugins:
+  entries:
+    frontend: plugins/frontend
+    infra: plugins/infra
+domains:
+  development:
+    description: Application code, tests, and review tooling.
+    plugins: [frontend]
+    mcp:
+      servers: [code-intel]
+  platform:
+    description: Deployment, infrastructure, and incident tooling.
+    plugins: [infra]
+aliases:
+  everything: [development, platform]
+```
+
+## What it registers
+
+| Surface    | Behavior                                              |
+| ---------- | ----------------------------------------------------- |
+| `/domains` | prints the selection, or switches to `name[,name...]` |
+
+When the `@agimon-ai/po-help` minor mode is active, this package contributes the
+`po-author-domain` skill. It provides package-owned guidance for plugin catalogs, domain
+filters, aliases, defaults, shared skills, and MCP scopes in `domains.yaml`. The contribution is
+registered through the session's `doom/help` Cordis service and is withdrawn with this package's
+plugin fiber.
+
+## What a switch stages
+
+A domain switch is not just a config write, which is why it does not live in
+`@agimon-ai/po-config/selectionSwitch` with the major-mode and profile switches. Applying a
+selection:
+
+- materializes any remote (Git or npm) plugins the selected domains name into a content-addressed
+  cache guarded by an install marker;
+- discovers the exact `SKILL.md` files behind the selection, through a manifest cache keyed by
+  worktree so a second session does not rescan the tree;
+- adapts each plugin's Claude-authored agent definitions into the form Pi loads, and stages them
+  privately (`0600`) beside a dispatcher agent;
+- merges the repository and legacy plugin `.mcp.json` layers, and validates root `mcp.json` for
+  schema-gated Agent Plugins v1 (including plugin-relative commands, data directories, and transport
+  normalization);
+- applies the selected domains' MCP allowlists and rewrites the proxy's upstream list into a
+  private per-run config; and
+- atomically stores an immutable MCP projection in harness state. Config publishes that snapshot through the session Cordis registry for Po MCP to
+  consume; Domain never reaches into the live MCP runtime.
+
+An allowlist only takes effect once **every** selected domain declares one. Mixing a scoped domain
+with a domain that has not opted in leaves the session unfiltered, so an unmigrated domain cannot
+silently lose its tools.
+
+## Installation
+
+Po depends on this package and activates it as fixed host core, so a Po install already has
+it. It is not selectable from `.po/modes.yaml`; it reads `.po/domains.yaml`.
+
+## License
+
+MIT

package/dist/apiContracts.cjs

@@ -0,0 +1,17 @@
+Object.defineProperties(exports, {
+	__esModule: { value: true },
+	[Symbol.toStringTag]: { value: "Module" }
+});
+//#region src/schemas/apiContracts.ts
+/** This facet contributes agent tools, commands or lifecycle only, with no separate HTTP or socket surface. */
+const apiContracts = (0, require("@agimon-ai/po-core/apiContracts").defineApiContract)({
+	version: 1,
+	http: [],
+	sockets: [],
+	dynamic: []
+});
+//#endregion
+exports.apiContracts = apiContracts;
+exports.default = apiContracts;
+
+//# sourceMappingURL=apiContracts.cjs.map

package/dist/apiContracts.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiContracts.cjs","names":["defineApiContract"],"sources":["../src/schemas/apiContracts.ts"],"sourcesContent":["import { defineApiContract } from '@agimon-ai/po-core/apiContracts';\n\n/** This facet contributes agent tools, commands or lifecycle only, with no separate HTTP or socket surface. */\nexport const apiContracts = defineApiContract({ version: 1, http: [], sockets: [], dynamic: [] });\nexport default apiContracts;\n"],"mappings":";;;;;;AAGA,MAAa,gBAAA,4CAAeA,CAAAA,CAAAA,kBAAAA,CAAkB;CAAE,SAAS;CAAG,MAAM,CAAC;CAAG,SAAS,CAAC;CAAG,SAAS,CAAC;AAAE,CAAC"}

package/dist/apiContracts.d.mts

@@ -0,0 +1,53 @@
+//#region src/schemas/apiContracts.d.ts
+/** This facet contributes agent tools, commands or lifecycle only, with no separate HTTP or socket surface. */
+export declare const apiContracts: {
+  version: 1;
+  protocols?: Record<string, string> | undefined;
+  schemas?: Record<string, boolean | object> | undefined;
+  http: {
+    id: string;
+    scope: "global" | "session" | "workspace";
+    basePath?: string | undefined;
+    path: string;
+    method: "DELETE" | "GET" | "HEAD" | "OPTIONS" | "PATCH" | "POST" | "PUT";
+    description: string;
+    availability?: string | undefined;
+    authentication: "device" | "none" | "owner";
+    parameters?: {
+      name: string;
+      in: "header" | "path" | "query";
+      required: boolean;
+      schema: boolean | object;
+    }[] | undefined;
+    body?: {
+      contentType: string;
+      contentTypes?: string[] | undefined;
+      required: boolean;
+      schema: boolean | object;
+    } | undefined;
+    responses: Record<string, {
+      description: string;
+      contentType?: string | undefined;
+      schema?: boolean | object | undefined;
+      events?: Record<string, boolean | object> | undefined;
+    }>;
+  }[];
+  sockets: {
+    id: string;
+    scope: "global" | "session" | "workspace";
+    description: string;
+    availability?: string | undefined;
+    service: string;
+    member: string;
+    direction: "client-to-server" | "server-to-client";
+    kind: "channel" | "method" | "state";
+    input: boolean | object;
+    output?: boolean | object | undefined;
+    errors?: boolean | object | undefined;
+  }[];
+  dynamic: string[];
+  gaps?: string[] | undefined;
+};
+//#endregion
+export { apiContracts as default };
+//# sourceMappingURL=apiContracts.d.mts.map

package/dist/apiContracts.d.mts.map

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

package/dist/apiContracts.mjs

@@ -0,0 +1,13 @@
+import { defineApiContract } from "@agimon-ai/po-core/apiContracts";
+//#region src/schemas/apiContracts.ts
+/** This facet contributes agent tools, commands or lifecycle only, with no separate HTTP or socket surface. */
+const apiContracts = defineApiContract({
+	version: 1,
+	http: [],
+	sockets: [],
+	dynamic: []
+});
+//#endregion
+export { apiContracts, apiContracts as default };
+
+//# sourceMappingURL=apiContracts.mjs.map

package/dist/apiContracts.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiContracts.mjs","names":[],"sources":["../src/schemas/apiContracts.ts"],"sourcesContent":["import { defineApiContract } from '@agimon-ai/po-core/apiContracts';\n\n/** This facet contributes agent tools, commands or lifecycle only, with no separate HTTP or socket surface. */\nexport const apiContracts = defineApiContract({ version: 1, http: [], sockets: [], dynamic: [] });\nexport default apiContracts;\n"],"mappings":";;;AAGA,MAAa,eAAe,kBAAkB;CAAE,SAAS;CAAG,MAAM,CAAC;CAAG,SAAS,CAAC;CAAG,SAAS,CAAC;AAAE,CAAC"}

package/dist/apply.cjs

@@ -0,0 +1,76 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_rolldown_runtime = require("./rolldown-runtime-VH7oDXx4.cjs");
+const require_mcpFilter = require("./mcpFilter-CZNmU_VF.cjs");
+const require_pluginMaterializer = require("./pluginMaterializer-C8IZ1PSY.cjs");
+const require_resourceCollector = require("./resourceCollector-Cu-lp5hJ.cjs");
+let node_fs = require("node:fs");
+node_fs = require_rolldown_runtime.__toESM(node_fs, 1);
+let node_path = require("node:path");
+node_path = require_rolldown_runtime.__toESM(node_path, 1);
+let _agimon_ai_po_config_domains = require("@agimon-ai/po-config/domains");
+let _agimon_ai_po_config_harnessStore = require("@agimon-ai/po-config/harnessStore");
+//#region src/services/applyDomains/index.ts
+/**
+* Live domain switching: skills, plugin hooks, MCP config and subagent directories.
+*
+* Writes through the harness state module and relies on Pi's reload
+* re-executing extension modules. The replacement Config factory publishes the
+* persisted MCP projection on the new session's Cordis root.
+*
+* What reload cannot do is change the SET of loaded extensions: Pi freezes the
+* CLI --extension list at construction and re-resolves that same array on every
+* reload. Callers report those parts as needing a relaunch instead of pretending
+* they applied.
+*
+* The major-mode and profile switches live in
+* @agimon-ai/po-config/selectionSwitch: they are config writes with no
+* resource staging, and the synced startup path applies them before any command
+* exists to run. Domains stays here because it stages plugins, skills and MCP
+* config.
+*/
+async function applyDomains(domainNames, state) {
+	const { root, temporaryDirectory } = (0, _agimon_ai_po_config_harnessStore.requireHarnessPaths)(state);
+	const pluginEntries = await require_pluginMaterializer.materializePluginEntries((0, _agimon_ai_po_config_domains.resolvePluginEntries)(root, domainNames, [...state.pluginDirectories]));
+	const mcpAllowlist = require_mcpFilter.resolveMcpAllowlist(root, domainNames);
+	const candidateDirectory = await node_fs.default.promises.mkdtemp(node_path.default.join(temporaryDirectory, "domains-"));
+	let resources;
+	try {
+		resources = await require_resourceCollector.collectResources(root, pluginEntries, {
+			agents: state.agents,
+			mcp: state.mcp,
+			temporaryDirectory: candidateDirectory,
+			sharedSkills: (0, _agimon_ai_po_config_domains.resolveSharedSkills)(root, domainNames),
+			mcpAllowlist
+		});
+	} catch (error) {
+		await node_fs.default.promises.rm(candidateDirectory, {
+			recursive: true,
+			force: true
+		});
+		throw error;
+	}
+	let updated;
+	try {
+		updated = (0, _agimon_ai_po_config_harnessStore.updateHarnessState)({
+			domains: domainNames,
+			skillDirectories: resources.skillDirectories,
+			agentDirectories: resources.agentDirectories,
+			pluginHooks: resources.pluginHooks,
+			mcpConfigPath: resources.mcpConfigPath,
+			mcpProjection: resources.mcpProjection
+		});
+	} catch (error) {
+		await node_fs.default.promises.rm(candidateDirectory, {
+			recursive: true,
+			force: true
+		});
+		throw error;
+	}
+	process.env.PI_SUBAGENT_EXTRA_AGENT_DIRS = resources.agentDirectories.join(node_path.default.delimiter);
+	process.env.PI_SUBAGENT_EXTRA_SKILL_DIRS = resources.skillDirectories.join(node_path.default.delimiter);
+	return updated;
+}
+//#endregion
+exports.applyDomains = applyDomains;
+
+//# sourceMappingURL=apply.cjs.map

package/dist/apply.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply.cjs","names":["requireHarnessPaths","materializePluginEntries","resolvePluginEntries","resolveMcpAllowlist","fs","path","collectResources","resolveSharedSkills","updateHarnessState"],"sources":["../src/services/applyDomains/index.ts"],"sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\n\nimport { resolvePluginEntries, resolveSharedSkills } from '@agimon-ai/po-config/domains';\nimport { requireHarnessPaths, updateHarnessState } from '@agimon-ai/po-config/harnessStore';\nimport type { DoomHarnessContext, HarnessState } from '@agimon-ai/po-config/types';\n\nimport { resolveMcpAllowlist } from '../mcpFilter';\nimport { materializePluginEntries } from '../pluginMaterializer';\nimport { collectResources } from '../resourceCollector';\n\n/**\n * Live domain switching: skills, plugin hooks, MCP config and subagent directories.\n *\n * Writes through the harness state module and relies on Pi's reload\n * re-executing extension modules. The replacement Config factory publishes the\n * persisted MCP projection on the new session's Cordis root.\n *\n * What reload cannot do is change the SET of loaded extensions: Pi freezes the\n * CLI --extension list at construction and re-resolves that same array on every\n * reload. Callers report those parts as needing a relaunch instead of pretending\n * they applied.\n *\n * The major-mode and profile switches live in\n * @agimon-ai/po-config/selectionSwitch: they are config writes with no\n * resource staging, and the synced startup path applies them before any command\n * exists to run. Domains stays here because it stages plugins, skills and MCP\n * config.\n */\nexport async function applyDomains(domainNames: string[], state: DoomHarnessContext): Promise<HarnessState> {\n  const { root, temporaryDirectory } = requireHarnessPaths(state);\n\n  const pluginEntries = await materializePluginEntries(\n    resolvePluginEntries(root, domainNames, [...state.pluginDirectories]),\n  );\n  const mcpAllowlist = resolveMcpAllowlist(root, domainNames);\n  // Keep the active generation untouched while the candidate is parsed and\n  // normalized. Pi's reload later removes the whole process-owned run root, so\n  // retired generations need no eager destructive cleanup here.\n  const candidateDirectory = await fs.promises.mkdtemp(path.join(temporaryDirectory, 'domains-'));\n  let resources: Awaited<ReturnType<typeof collectResources>>;\n  try {\n    resources = await collectResources(root, pluginEntries, {\n      agents: state.agents,\n      mcp: state.mcp,\n      temporaryDirectory: candidateDirectory,\n      sharedSkills: resolveSharedSkills(root, domainNames),\n      mcpAllowlist,\n    });\n  } catch (error) {\n    await fs.promises.rm(candidateDirectory, { recursive: true, force: true });\n    throw error;\n  }\n\n  let updated: HarnessState;\n  try {\n    updated = updateHarnessState({\n      domains: domainNames,\n      skillDirectories: resources.skillDirectories,\n      agentDirectories: resources.agentDirectories,\n      pluginHooks: resources.pluginHooks,\n      mcpConfigPath: resources.mcpConfigPath,\n      mcpProjection: resources.mcpProjection,\n    });\n  } catch (error) {\n    await fs.promises.rm(candidateDirectory, { recursive: true, force: true });\n    throw error;\n  }\n  process.env.PI_SUBAGENT_EXTRA_AGENT_DIRS = resources.agentDirectories.join(path.delimiter);\n  process.env.PI_SUBAGENT_EXTRA_SKILL_DIRS = resources.skillDirectories.join(path.delimiter);\n  return updated;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BA,eAAsB,aAAa,aAAuB,OAAkD;CAC1G,MAAM,EAAE,MAAM,wBAAA,GAAuBA,kCAAAA,oBAAAA,CAAoB,KAAK;CAE9D,MAAM,gBAAgB,MAAMC,2BAAAA,0BAAAA,GAC1BC,6BAAAA,qBAAAA,CAAqB,MAAM,aAAa,CAAC,GAAG,MAAM,iBAAiB,CAAC,CACtE;CACA,MAAM,eAAeC,kBAAAA,oBAAoB,MAAM,WAAW;CAI1D,MAAM,qBAAqB,MAAMC,QAAAA,QAAG,SAAS,QAAQC,UAAAA,QAAK,KAAK,oBAAoB,UAAU,CAAC;CAC9F,IAAI;CACJ,IAAI;EACF,YAAY,MAAMC,0BAAAA,iBAAiB,MAAM,eAAe;GACtD,QAAQ,MAAM;GACd,KAAK,MAAM;GACX,oBAAoB;GACpB,eAAA,GAAcC,6BAAAA,oBAAAA,CAAoB,MAAM,WAAW;GACnD;EACF,CAAC;CACH,SAAS,OAAO;EACd,MAAMH,QAAAA,QAAG,SAAS,GAAG,oBAAoB;GAAE,WAAW;GAAM,OAAO;EAAK,CAAC;EACzE,MAAM;CACR;CAEA,IAAI;CACJ,IAAI;EACF,WAAA,GAAUI,kCAAAA,mBAAAA,CAAmB;GAC3B,SAAS;GACT,kBAAkB,UAAU;GAC5B,kBAAkB,UAAU;GAC5B,aAAa,UAAU;GACvB,eAAe,UAAU;GACzB,eAAe,UAAU;EAC3B,CAAC;CACH,SAAS,OAAO;EACd,MAAMJ,QAAAA,QAAG,SAAS,GAAG,oBAAoB;GAAE,WAAW;GAAM,OAAO;EAAK,CAAC;EACzE,MAAM;CACR;CACA,QAAQ,IAAI,+BAA+B,UAAU,iBAAiB,KAAKC,UAAAA,QAAK,SAAS;CACzF,QAAQ,IAAI,+BAA+B,UAAU,iBAAiB,KAAKA,UAAAA,QAAK,SAAS;CACzF,OAAO;AACT"}

package/dist/apply.d.mts

@@ -0,0 +1,23 @@
+import { DoomHarnessContext, HarnessState } from "@agimon-ai/po-config/types";
+//#region src/services/applyDomains/index.d.ts
+/**
+ * Live domain switching: skills, plugin hooks, MCP config and subagent directories.
+ *
+ * Writes through the harness state module and relies on Pi's reload
+ * re-executing extension modules. The replacement Config factory publishes the
+ * persisted MCP projection on the new session's Cordis root.
+ *
+ * What reload cannot do is change the SET of loaded extensions: Pi freezes the
+ * CLI --extension list at construction and re-resolves that same array on every
+ * reload. Callers report those parts as needing a relaunch instead of pretending
+ * they applied.
+ *
+ * The major-mode and profile switches live in
+ * @agimon-ai/po-config/selectionSwitch: they are config writes with no
+ * resource staging, and the synced startup path applies them before any command
+ * exists to run. Domains stays here because it stages plugins, skills and MCP
+ * config.
+ */
+export declare function applyDomains(domainNames: string[], state: DoomHarnessContext): Promise<HarnessState>;
+//#endregion
+//# sourceMappingURL=apply.d.mts.map

package/dist/apply.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply.d.mts","names":[],"sources":["../src/services/applyDomains/index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;wBA6BsB,aAAa,uBAAuB,OAAO,qBAAqB,QAAQ"}

package/dist/apply.mjs

@@ -0,0 +1,72 @@
+import { o as resolveMcpAllowlist } from "./mcpFilter-Cf-czy8O.mjs";
+import { t as materializePluginEntries } from "./pluginMaterializer-D9-oDF-b.mjs";
+import { r as collectResources } from "./resourceCollector-CRY5cmeY.mjs";
+import fs from "node:fs";
+import path from "node:path";
+import { resolvePluginEntries, resolveSharedSkills } from "@agimon-ai/po-config/domains";
+import { requireHarnessPaths, updateHarnessState } from "@agimon-ai/po-config/harnessStore";
+//#region src/services/applyDomains/index.ts
+/**
+* Live domain switching: skills, plugin hooks, MCP config and subagent directories.
+*
+* Writes through the harness state module and relies on Pi's reload
+* re-executing extension modules. The replacement Config factory publishes the
+* persisted MCP projection on the new session's Cordis root.
+*
+* What reload cannot do is change the SET of loaded extensions: Pi freezes the
+* CLI --extension list at construction and re-resolves that same array on every
+* reload. Callers report those parts as needing a relaunch instead of pretending
+* they applied.
+*
+* The major-mode and profile switches live in
+* @agimon-ai/po-config/selectionSwitch: they are config writes with no
+* resource staging, and the synced startup path applies them before any command
+* exists to run. Domains stays here because it stages plugins, skills and MCP
+* config.
+*/
+async function applyDomains(domainNames, state) {
+	const { root, temporaryDirectory } = requireHarnessPaths(state);
+	const pluginEntries = await materializePluginEntries(resolvePluginEntries(root, domainNames, [...state.pluginDirectories]));
+	const mcpAllowlist = resolveMcpAllowlist(root, domainNames);
+	const candidateDirectory = await fs.promises.mkdtemp(path.join(temporaryDirectory, "domains-"));
+	let resources;
+	try {
+		resources = await collectResources(root, pluginEntries, {
+			agents: state.agents,
+			mcp: state.mcp,
+			temporaryDirectory: candidateDirectory,
+			sharedSkills: resolveSharedSkills(root, domainNames),
+			mcpAllowlist
+		});
+	} catch (error) {
+		await fs.promises.rm(candidateDirectory, {
+			recursive: true,
+			force: true
+		});
+		throw error;
+	}
+	let updated;
+	try {
+		updated = updateHarnessState({
+			domains: domainNames,
+			skillDirectories: resources.skillDirectories,
+			agentDirectories: resources.agentDirectories,
+			pluginHooks: resources.pluginHooks,
+			mcpConfigPath: resources.mcpConfigPath,
+			mcpProjection: resources.mcpProjection
+		});
+	} catch (error) {
+		await fs.promises.rm(candidateDirectory, {
+			recursive: true,
+			force: true
+		});
+		throw error;
+	}
+	process.env.PI_SUBAGENT_EXTRA_AGENT_DIRS = resources.agentDirectories.join(path.delimiter);
+	process.env.PI_SUBAGENT_EXTRA_SKILL_DIRS = resources.skillDirectories.join(path.delimiter);
+	return updated;
+}
+//#endregion
+export { applyDomains };
+
+//# sourceMappingURL=apply.mjs.map

package/dist/apply.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply.mjs","names":[],"sources":["../src/services/applyDomains/index.ts"],"sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\n\nimport { resolvePluginEntries, resolveSharedSkills } from '@agimon-ai/po-config/domains';\nimport { requireHarnessPaths, updateHarnessState } from '@agimon-ai/po-config/harnessStore';\nimport type { DoomHarnessContext, HarnessState } from '@agimon-ai/po-config/types';\n\nimport { resolveMcpAllowlist } from '../mcpFilter';\nimport { materializePluginEntries } from '../pluginMaterializer';\nimport { collectResources } from '../resourceCollector';\n\n/**\n * Live domain switching: skills, plugin hooks, MCP config and subagent directories.\n *\n * Writes through the harness state module and relies on Pi's reload\n * re-executing extension modules. The replacement Config factory publishes the\n * persisted MCP projection on the new session's Cordis root.\n *\n * What reload cannot do is change the SET of loaded extensions: Pi freezes the\n * CLI --extension list at construction and re-resolves that same array on every\n * reload. Callers report those parts as needing a relaunch instead of pretending\n * they applied.\n *\n * The major-mode and profile switches live in\n * @agimon-ai/po-config/selectionSwitch: they are config writes with no\n * resource staging, and the synced startup path applies them before any command\n * exists to run. Domains stays here because it stages plugins, skills and MCP\n * config.\n */\nexport async function applyDomains(domainNames: string[], state: DoomHarnessContext): Promise<HarnessState> {\n  const { root, temporaryDirectory } = requireHarnessPaths(state);\n\n  const pluginEntries = await materializePluginEntries(\n    resolvePluginEntries(root, domainNames, [...state.pluginDirectories]),\n  );\n  const mcpAllowlist = resolveMcpAllowlist(root, domainNames);\n  // Keep the active generation untouched while the candidate is parsed and\n  // normalized. Pi's reload later removes the whole process-owned run root, so\n  // retired generations need no eager destructive cleanup here.\n  const candidateDirectory = await fs.promises.mkdtemp(path.join(temporaryDirectory, 'domains-'));\n  let resources: Awaited<ReturnType<typeof collectResources>>;\n  try {\n    resources = await collectResources(root, pluginEntries, {\n      agents: state.agents,\n      mcp: state.mcp,\n      temporaryDirectory: candidateDirectory,\n      sharedSkills: resolveSharedSkills(root, domainNames),\n      mcpAllowlist,\n    });\n  } catch (error) {\n    await fs.promises.rm(candidateDirectory, { recursive: true, force: true });\n    throw error;\n  }\n\n  let updated: HarnessState;\n  try {\n    updated = updateHarnessState({\n      domains: domainNames,\n      skillDirectories: resources.skillDirectories,\n      agentDirectories: resources.agentDirectories,\n      pluginHooks: resources.pluginHooks,\n      mcpConfigPath: resources.mcpConfigPath,\n      mcpProjection: resources.mcpProjection,\n    });\n  } catch (error) {\n    await fs.promises.rm(candidateDirectory, { recursive: true, force: true });\n    throw error;\n  }\n  process.env.PI_SUBAGENT_EXTRA_AGENT_DIRS = resources.agentDirectories.join(path.delimiter);\n  process.env.PI_SUBAGENT_EXTRA_SKILL_DIRS = resources.skillDirectories.join(path.delimiter);\n  return updated;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AA6BA,eAAsB,aAAa,aAAuB,OAAkD;CAC1G,MAAM,EAAE,MAAM,uBAAuB,oBAAoB,KAAK;CAE9D,MAAM,gBAAgB,MAAM,yBAC1B,qBAAqB,MAAM,aAAa,CAAC,GAAG,MAAM,iBAAiB,CAAC,CACtE;CACA,MAAM,eAAe,oBAAoB,MAAM,WAAW;CAI1D,MAAM,qBAAqB,MAAM,GAAG,SAAS,QAAQ,KAAK,KAAK,oBAAoB,UAAU,CAAC;CAC9F,IAAI;CACJ,IAAI;EACF,YAAY,MAAM,iBAAiB,MAAM,eAAe;GACtD,QAAQ,MAAM;GACd,KAAK,MAAM;GACX,oBAAoB;GACpB,cAAc,oBAAoB,MAAM,WAAW;GACnD;EACF,CAAC;CACH,SAAS,OAAO;EACd,MAAM,GAAG,SAAS,GAAG,oBAAoB;GAAE,WAAW;GAAM,OAAO;EAAK,CAAC;EACzE,MAAM;CACR;CAEA,IAAI;CACJ,IAAI;EACF,UAAU,mBAAmB;GAC3B,SAAS;GACT,kBAAkB,UAAU;GAC5B,kBAAkB,UAAU;GAC5B,aAAa,UAAU;GACvB,eAAe,UAAU;GACzB,eAAe,UAAU;EAC3B,CAAC;CACH,SAAS,OAAO;EACd,MAAM,GAAG,SAAS,GAAG,oBAAoB;GAAE,WAAW;GAAM,OAAO;EAAK,CAAC;EACzE,MAAM;CACR;CACA,QAAQ,IAAI,+BAA+B,UAAU,iBAAiB,KAAK,KAAK,SAAS;CACzF,QAAQ,IAAI,+BAA+B,UAAU,iBAAiB,KAAK,KAAK,SAAS;CACzF,OAAO;AACT"}

package/dist/domainText-Dm8k7p4z.mjs

@@ -0,0 +1,97 @@
+import { VOICE_TOOL_MAX_DOMAIN_COUNT, VOICE_TOOL_MAX_IDENTIFIER_LENGTH } from "@agimon-ai/po-core/voiceTools";
+//#region src/types/domains.ts
+/** The npm name this package registers its voice tools and contributions under. */
+const DOMAIN_SOURCE = "@agimon-ai/po-domain";
+/**
+* The only names a domain, an operation or a handoff token may carry.
+*
+* Selections arrive from the model and from the command line, and every one of
+* them ends up in a filesystem path or a process environment variable, so the
+* shape is constrained once here and reused by the schema and the validator.
+*/
+const SAFE_DOMAIN_NAME = /^[A-Za-z0-9@][A-Za-z0-9@/._:-]*$/u;
+//#endregion
+//#region src/services/domainText/index.ts
+const DOMAIN_SEPARATOR = ",";
+const DOMAIN_COMMAND = "domains";
+/** Footer status key the cockpit's domains axis reads. */
+const DOMAIN_STATUS_KEY = "doom-domain";
+/** What an empty selection reads as, which is a real state rather than an error. */
+const NONE = "(none)";
+/** Splits the comma-separated argument the command and the autocomplete share. */
+function splitDomains(value) {
+	return value.split(DOMAIN_SEPARATOR).map((item) => item.trim()).filter(Boolean);
+}
+/** The published axis content: the active domains in the same comma-separated shape splitDomains reads. */
+function domainStatus(domains) {
+	return domains.join(DOMAIN_SEPARATOR);
+}
+/** Picker rows for the domain multi-select. */
+function domainItems(names, descriptions = {}) {
+	return names.map((name) => ({
+		value: name,
+		label: name,
+		...descriptions[name] ? { description: descriptions[name] } : {}
+	}));
+}
+function domainSummary(listing) {
+	return `Active domains: ${listing.effective.join(", ") || "(none)"}\nAvailable domains: ${listing.available.join(", ")}\nUse /${DOMAIN_COMMAND} <name[,name...]> to switch.`;
+}
+function switchedSummary(domains) {
+	return `Switched domains to: ${domains.join(", ") || "(none)"}`;
+}
+function unchangedSummary(domains) {
+	return `Domains already active: ${domains.join(", ") || "(none)"}`;
+}
+function pickerTitle(listing) {
+	return `Domains (active: ${listing.effective.join(", ") || "(none)"})`;
+}
+const MARK_ON = "[x]";
+const MARK_OFF = "[ ]";
+const OPTION_PREFIX = /^\[[ x]\] /;
+/**
+* Rows for a single-pick select where domains compose: each row shows the
+* membership it would flip, so a client without a multi-select still reaches
+* every set one toggle at a time.
+*/
+function domainToggleOptions(listing) {
+	const active = new Set(listing.effective);
+	return listing.available.map((name) => `${active.has(name) ? MARK_ON : MARK_OFF} ${name}`);
+}
+/** The domain a toggle row names. */
+function toggleOptionDomain(option) {
+	return option.replace(OPTION_PREFIX, "").trim();
+}
+/** The effective set with one domain flipped, order preserved for the rest. */
+function toggledDomains(effective, name) {
+	return effective.includes(name) ? effective.filter((domain) => domain !== name) : [...effective, name];
+}
+/**
+* Deduplicates a requested selection and rejects anything unsafe.
+*
+* Bounded before the manifest is read, because a selection large enough to
+* matter comes from the model rather than from a person typing the command.
+*/
+function normalizeDomainNames(values) {
+	if (values.length > VOICE_TOOL_MAX_DOMAIN_COUNT) throw new Error(`A maximum of ${VOICE_TOOL_MAX_DOMAIN_COUNT} domains may be selected.`);
+	const result = [];
+	const seen = /* @__PURE__ */ new Set();
+	for (const value of values) {
+		const name = value.trim();
+		if (!name || name.length > VOICE_TOOL_MAX_IDENTIFIER_LENGTH || !SAFE_DOMAIN_NAME.test(name)) throw new Error(`Invalid domain name: ${value}`);
+		if (seen.has(name)) continue;
+		seen.add(name);
+		result.push(name);
+	}
+	return result;
+}
+function errorMessage(error) {
+	return error instanceof Error ? error.message : String(error);
+}
+function transitionError(result) {
+	return /* @__PURE__ */ new Error(`Domain transition was ${result.outcome}: ${result.diagnostics.join(", ")}`);
+}
+//#endregion
+export { DOMAIN_SOURCE as _, domainStatus as a, errorMessage as c, splitDomains as d, switchedSummary as f, unchangedSummary as g, transitionError as h, domainItems as i, normalizeDomainNames as l, toggledDomains as m, DOMAIN_STATUS_KEY as n, domainSummary as o, toggleOptionDomain as p, NONE as r, domainToggleOptions as s, DOMAIN_COMMAND as t, pickerTitle as u, SAFE_DOMAIN_NAME as v };
+
+//# sourceMappingURL=domainText-Dm8k7p4z.mjs.map

package/dist/domainText-Dm8k7p4z.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"domainText-Dm8k7p4z.mjs","names":[],"sources":["../src/types/domains.ts","../src/services/domainText/index.ts"],"sourcesContent":["/** The npm name this package registers its voice tools and contributions under. */\nexport const DOMAIN_SOURCE = '@agimon-ai/po-domain';\n\n/**\n * The only names a domain, an operation or a handoff token may carry.\n *\n * Selections arrive from the model and from the command line, and every one of\n * them ends up in a filesystem path or a process environment variable, so the\n * shape is constrained once here and reused by the schema and the validator.\n */\nexport const SAFE_DOMAIN_NAME = /^[A-Za-z0-9@][A-Za-z0-9@/._:-]*$/u;\n\n/**\n * The selection as the command, the picker and the voice tool all need to see it.\n *\n * `active` is what the session persisted and `effective` is what it is running\n * with, which differ while a major mode contributes its default domains.\n */\nexport interface DomainListing {\n  readonly active: string[];\n  readonly effective: string[];\n  readonly available: string[];\n}\n\n/** One comma-triggered autocomplete response for the `/domains` argument. */\nexport interface DomainCompletion {\n  readonly prefix: string;\n  readonly items: Array<{ value: string; label: string }>;\n}\n","import type { DoomTransitionResult } from '@agimon-ai/po-core/transition';\nimport { VOICE_TOOL_MAX_DOMAIN_COUNT, VOICE_TOOL_MAX_IDENTIFIER_LENGTH } from '@agimon-ai/po-core/voiceTools';\n\nimport { type DomainListing, SAFE_DOMAIN_NAME } from '../../types/domains';\n\ninterface SelectItem {\n  value: string;\n  label: string;\n  description?: string;\n}\n\nconst DOMAIN_SEPARATOR = ',';\nexport const DOMAIN_COMMAND = 'domains';\n/** Footer status key the cockpit's domains axis reads. */\nexport const DOMAIN_STATUS_KEY = 'doom-domain';\n/** What an empty selection reads as, which is a real state rather than an error. */\nexport const NONE = '(none)';\n\n/** Splits the comma-separated argument the command and the autocomplete share. */\nexport function splitDomains(value: string): string[] {\n  return value\n    .split(DOMAIN_SEPARATOR)\n    .map((item) => item.trim())\n    .filter(Boolean);\n}\n\n/** The published axis content: the active domains in the same comma-separated shape splitDomains reads. */\nexport function domainStatus(domains: readonly string[]): string {\n  return domains.join(DOMAIN_SEPARATOR);\n}\n\n/** Picker rows for the domain multi-select. */\nexport function domainItems(\n  names: string[],\n  descriptions: Readonly<Record<string, string | undefined>> = {},\n): SelectItem[] {\n  return names.map((name) => ({\n    value: name,\n    label: name,\n    ...(descriptions[name] ? { description: descriptions[name] } : {}),\n  }));\n}\n\nexport function domainSummary(listing: DomainListing): string {\n  const active = listing.effective.join(', ') || NONE;\n  return `Active domains: ${active}\\nAvailable domains: ${listing.available.join(', ')}\\nUse /${DOMAIN_COMMAND} <name[,name...]> to switch.`;\n}\n\nexport function switchedSummary(domains: readonly string[]): string {\n  return `Switched domains to: ${domains.join(', ') || NONE}`;\n}\n\nexport function unchangedSummary(domains: readonly string[]): string {\n  return `Domains already active: ${domains.join(', ') || NONE}`;\n}\n\nexport function pickerTitle(listing: DomainListing): string {\n  return `Domains (active: ${listing.effective.join(', ') || NONE})`;\n}\n\nconst MARK_ON = '[x]';\nconst MARK_OFF = '[ ]';\nconst OPTION_PREFIX = /^\\[[ x]\\] /;\n\n/**\n * Rows for a single-pick select where domains compose: each row shows the\n * membership it would flip, so a client without a multi-select still reaches\n * every set one toggle at a time.\n */\nexport function domainToggleOptions(listing: DomainListing): string[] {\n  const active = new Set(listing.effective);\n  return listing.available.map((name) => `${active.has(name) ? MARK_ON : MARK_OFF} ${name}`);\n}\n\n/** The domain a toggle row names. */\nexport function toggleOptionDomain(option: string): string {\n  return option.replace(OPTION_PREFIX, '').trim();\n}\n\n/** The effective set with one domain flipped, order preserved for the rest. */\nexport function toggledDomains(effective: readonly string[], name: string): string[] {\n  return effective.includes(name) ? effective.filter((domain) => domain !== name) : [...effective, name];\n}\n\n/**\n * Deduplicates a requested selection and rejects anything unsafe.\n *\n * Bounded before the manifest is read, because a selection large enough to\n * matter comes from the model rather than from a person typing the command.\n */\nexport function normalizeDomainNames(values: readonly string[]): string[] {\n  if (values.length > VOICE_TOOL_MAX_DOMAIN_COUNT) {\n    throw new Error(`A maximum of ${VOICE_TOOL_MAX_DOMAIN_COUNT} domains may be selected.`);\n  }\n  const result: string[] = [];\n  const seen = new Set<string>();\n  for (const value of values) {\n    const name = value.trim();\n    if (!name || name.length > VOICE_TOOL_MAX_IDENTIFIER_LENGTH || !SAFE_DOMAIN_NAME.test(name)) {\n      throw new Error(`Invalid domain name: ${value}`);\n    }\n    if (seen.has(name)) continue;\n    seen.add(name);\n    result.push(name);\n  }\n  return result;\n}\n\nexport function errorMessage(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n\nexport function transitionError(result: DoomTransitionResult): Error {\n  return new Error(`Domain transition was ${result.outcome}: ${result.diagnostics.join(', ')}`);\n}\n"],"mappings":";;;AACA,MAAa,gBAAgB;;;;;;;;AAS7B,MAAa,mBAAmB;;;ACChC,MAAM,mBAAmB;AACzB,MAAa,iBAAiB;;AAE9B,MAAa,oBAAoB;;AAEjC,MAAa,OAAO;;AAGpB,SAAgB,aAAa,OAAyB;CACpD,OAAO,MACJ,MAAM,gBAAgB,CAAC,CACvB,KAAK,SAAS,KAAK,KAAK,CAAC,CAAC,CAC1B,OAAO,OAAO;AACnB;;AAGA,SAAgB,aAAa,SAAoC;CAC/D,OAAO,QAAQ,KAAK,gBAAgB;AACtC;;AAGA,SAAgB,YACd,OACA,eAA6D,CAAC,GAChD;CACd,OAAO,MAAM,KAAK,UAAU;EAC1B,OAAO;EACP,OAAO;EACP,GAAI,aAAa,QAAQ,EAAE,aAAa,aAAa,MAAM,IAAI,CAAC;CAClE,EAAE;AACJ;AAEA,SAAgB,cAAc,SAAgC;CAE5D,OAAO,mBADQ,QAAQ,UAAU,KAAK,IAAI,KAAA,SACT,uBAAuB,QAAQ,UAAU,KAAK,IAAI,EAAE,SAAS,eAAe;AAC/G;AAEA,SAAgB,gBAAgB,SAAoC;CAClE,OAAO,wBAAwB,QAAQ,KAAK,IAAI,KAAA;AAClD;AAEA,SAAgB,iBAAiB,SAAoC;CACnE,OAAO,2BAA2B,QAAQ,KAAK,IAAI,KAAA;AACrD;AAEA,SAAgB,YAAY,SAAgC;CAC1D,OAAO,oBAAoB,QAAQ,UAAU,KAAK,IAAI,KAAA,SAAU;AAClE;AAEA,MAAM,UAAU;AAChB,MAAM,WAAW;AACjB,MAAM,gBAAgB;;;;;;AAOtB,SAAgB,oBAAoB,SAAkC;CACpE,MAAM,SAAS,IAAI,IAAI,QAAQ,SAAS;CACxC,OAAO,QAAQ,UAAU,KAAK,SAAS,GAAG,OAAO,IAAI,IAAI,IAAI,UAAU,SAAS,GAAG,MAAM;AAC3F;;AAGA,SAAgB,mBAAmB,QAAwB;CACzD,OAAO,OAAO,QAAQ,eAAe,EAAE,CAAC,CAAC,KAAK;AAChD;;AAGA,SAAgB,eAAe,WAA8B,MAAwB;CACnF,OAAO,UAAU,SAAS,IAAI,IAAI,UAAU,QAAQ,WAAW,WAAW,IAAI,IAAI,CAAC,GAAG,WAAW,IAAI;AACvG;;;;;;;AAQA,SAAgB,qBAAqB,QAAqC;CACxE,IAAI,OAAO,SAAS,6BAClB,MAAM,IAAI,MAAM,gBAAgB,4BAA4B,0BAA0B;CAExF,MAAM,SAAmB,CAAC;CAC1B,MAAM,uBAAO,IAAI,IAAY;CAC7B,KAAK,MAAM,SAAS,QAAQ;EAC1B,MAAM,OAAO,MAAM,KAAK;EACxB,IAAI,CAAC,QAAQ,KAAK,SAAS,oCAAoC,CAAC,iBAAiB,KAAK,IAAI,GACxF,MAAM,IAAI,MAAM,wBAAwB,OAAO;EAEjD,IAAI,KAAK,IAAI,IAAI,GAAG;EACpB,KAAK,IAAI,IAAI;EACb,OAAO,KAAK,IAAI;CAClB;CACA,OAAO;AACT;AAEA,SAAgB,aAAa,OAAwB;CACnD,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAC9D;AAEA,SAAgB,gBAAgB,QAAqC;CACnE,uBAAO,IAAI,MAAM,yBAAyB,OAAO,QAAQ,IAAI,OAAO,YAAY,KAAK,IAAI,GAAG;AAC9F"}