@agimon-ai/po-skill 0.0.0-alpha.2 → 0.0.0-alpha.21

package/dist/extensions/server.mjs

@@ -1,22 +1,29 @@
 import { n as SKILL_COMMAND_PREFIX, r as SKILL_INVOCATION_PREFIX, t as SKILLS_COMMAND } from "../skills-Ccvg1Hcz.mjs";
-import fs from "node:fs";
 import path from "node:path";
-import { listDomainNames, resolvePluginEntries, resolveSharedSkills } from "@agimon-ai/po-config/domains";
+import { listDomainNamesAsync, resolvePluginEntriesAsync, resolveSharedSkillsAsync } from "@agimon-ai/po-config/domains";
+import { BACKGROUND_CONTEXT, getOrThrow, nodeHost, requirePoFs, withAbortSignal } from "@agimon-ai/po-core/platform";
 import { materializePluginEntries } from "@agimon-ai/po-domain/plugins";
 import { formatSkillsForPrompt, getAgentDir, loadSkills, stripFrontmatter } from "@earendil-works/pi-coding-agent";
-import { composeServerProviderOverrides, defineServerPlugin, packageResourcePath, readPackageResource } from "@agimon-ai/po-core/serverFacet";
-import { composeRootHooks, defineRoot, defineRoutedContribution } from "@agimon-ai/po-core/extensionFile";
-import { readFile } from "node:fs/promises";
-import { Type } from "typebox";
-import os from "node:os";
+import { composeServerProviderOverrides, defineServerPlugin, packageResourcePath, readPackageResource } from "@agimon-ai/po-core/serverPlugin";
+import { composeRootHooks, composeRootInjects, defineRoot, defineRoutedContribution } from "@agimon-ai/po-core/extensionFile";
 import { readHarnessState } from "@agimon-ai/po-config/harnessState";
+import { Type } from "typebox";
 import { collectResources, discoverSkillsAsync } from "@agimon-ai/po-domain/resources";
+import fs from "node:fs";
 import { fileURLToPath, pathToFileURL } from "node:url";
 import { Worker } from "node:worker_threads";
+//#region src/constants/skillInventory.ts
+/**
+* How long sessions with the same inputs share one skill inventory instead of each reading the disk.
+* ponytail: a skill added on disk reaches new sessions within this window, not at once; watch the
+* skill roots if that lag matters.
+*/
+const SKILL_INVENTORY_FRESH_MS = 6e4;
+//#endregion
 //#region src/services/mcpSkills/index.ts
-const MCP_SKILLS_SERVICE = "doom/discovered-mcp-skills";
+const MCP_SKILLS_SERVICE = "po/discovered-mcp-skills";
 /** Explicit remote provider, never a projection of the local resource registry. */
-function mountMcpSkills(groups, signal) {
+function mountMcpSkills(groups, fs, signal) {
 	return (context) => {
 		context.provide(MCP_SKILLS_SERVICE, { list(remote) {
 			signal.throwIfAborted();
@@ -33,10 +40,7 @@ function mountMcpSkills(groups, signal) {
 						async read() {
 							const readSignal = AbortSignal.any([signal, remote.signal]);
 							readSignal.throwIfAborted();
-							const text = await readFile(skill.filePath, {
-								encoding: "utf8",
-								signal: readSignal
-							});
+							const text = getOrThrow(await fs.readTextFile(skill.filePath, withAbortSignal(readSignal, BACKGROUND_CONTEXT)));
 							readSignal.throwIfAborted();
 							return text;
 						}
@@ -82,6 +86,7 @@ function createSessionLoadSkillTool(host) {
 //#region src/services/deferredSkills/index.ts
 const PI_PACKAGE = "@earendil-works/pi-coding-agent";
 const PACKAGE_MANIFEST = "package.json";
+const PI_SKILLS_MODULE = path.join("dist", "core", "skills.js");
 const SKILL_WORKER_SOURCE = `
 const { parentPort, workerData } = require('node:worker_threads');
 void (async () => {
@@ -109,6 +114,8 @@ function installedPiModuleUrl() {
 				const manifest = JSON.parse(fs.readFileSync(manifestPath, "utf8"));
 				if (typeof manifest.main === "string") {
 					const entry = path.resolve(packageRoot, manifest.main);
+					const skills = path.join(packageRoot, PI_SKILLS_MODULE);
+					if (fs.existsSync(skills)) return pathToFileURL(skills).href;
 					if (fs.existsSync(entry)) return pathToFileURL(entry).href;
 				}
 			} catch {}
@@ -120,7 +127,7 @@ function installedPiModuleUrl() {
 	throw new Error(`Cannot resolve ${PI_PACKAGE} from the Po or host module trees`);
 }
 /**
-* One session's Doom-selected skill inventory.
+* One session's Po-selected skill inventory.
 *
 * Construction is deliberately cheap. `start()` schedules the synchronous Pi
 * walker after session_start returns, while `ready()` is the single promise the
@@ -247,15 +254,17 @@ const LOCAL_ONLY_MCP_PACKAGES = /* @__PURE__ */ new Set([
 	"@agimon-ai/po-voice",
 	"@agimon-ai/po-workflow"
 ]);
-async function isMcpSkillPlugin(entry) {
+async function isMcpSkillPlugin(fs, entry, context) {
 	if (entry.source?.type === "npm") return !LOCAL_ONLY_MCP_PACKAGES.has(entry.source.package);
+	const source = await fs.readTextFile(path.join(entry.directory, "package.json"), context);
+	if (!source.ok) return source.error.code === "not_found";
 	try {
-		const manifest = JSON.parse(await readFile(path.join(entry.directory, "package.json"), "utf8"));
+		const manifest = JSON.parse(source.value);
 		if (typeof manifest !== "object" || manifest === null || Array.isArray(manifest)) return false;
 		const name = manifest.name;
 		return typeof name === "string" && name.length > 0 && name.trim() === name && !LOCAL_ONLY_MCP_PACKAGES.has(name);
-	} catch (error) {
-		return error.code === "ENOENT";
+	} catch {
+		return false;
 	}
 }
 /**
@@ -276,30 +285,31 @@ function within(filePath, roots) {
 * Every skill the session could reach, grouped by what activates it.
 *
 * A cockpit `/domains` switch reconciles contributions rather than rebuilding
-* the facet: the session declaration is mounted once. So enumerating only the
+* the server plugin: the session declaration is mounted once. So enumerating only the
 * launch selection would freeze the command list at whatever was selected when
 * the session host was built. Enumerating every domain up front and tagging
 * each group with its `when` lets the existing kernel refresh do the work, the
 * same way domainServerResources registers per-domain skill resources.
 */
-async function discoverServerSkills(execution, signal) {
+async function discoverServerSkills(execution, fs, signal) {
 	signal.throwIfAborted();
+	const context = withAbortSignal(signal, BACKGROUND_CONTEXT);
 	const state = readHarnessState(execution.environment);
-	const home = execution.environment.HOME ?? os.homedir();
+	const home = execution.environment.HOME ?? nodeHost.homeDirectory();
 	const repoSkills = path.join(execution.repoRoot, ".po", "skills");
 	const sources = [];
 	const diagnostics = [];
 	const domains = [];
 	try {
-		domains.push(...listDomainNames(execution.repoRoot, home));
+		domains.push(...await listDomainNamesAsync(fs, execution.repoRoot, context, home));
 	} catch (error) {
 		diagnostics.push(`Domain skills are unavailable: ${error instanceof Error ? error.message : String(error)}`);
 	}
 	for (const domain of domains) {
 		signal.throwIfAborted();
 		try {
-			const plugins = await materializePluginEntries(resolvePluginEntries(execution.repoRoot, [domain], [], home));
-			const mcpPluginRoots = (await Promise.all(plugins.map(async (plugin) => await isMcpSkillPlugin(plugin) ? path.join(plugin.directory, "skills") : void 0))).filter((root) => root !== void 0);
+			const plugins = await materializePluginEntries(await resolvePluginEntriesAsync(fs, execution.repoRoot, [domain], [], context, home));
+			const mcpPluginRoots = (await Promise.all(plugins.map(async (plugin) => await isMcpSkillPlugin(fs, plugin, context) ? path.join(plugin.directory, "skills") : void 0))).filter((root) => root !== void 0);
 			const collected = await collectResources(execution.repoRoot, plugins, {
 				agents: false,
 				mcp: false,
@@ -325,7 +335,7 @@ async function discoverServerSkills(execution, signal) {
 	const shared = await discoverSkillsAsync(execution.repoRoot, path.join(execution.repoRoot, ".claude", "skills"));
 	if (shared.length > 0) {
 		const sharedPaths = shared.map((skill) => skill.path);
-		for (const domain of domains) if (resolveSharedSkills(execution.repoRoot, [domain], home)) sources.push({
+		for (const domain of domains) if (await resolveSharedSkillsAsync(fs, execution.repoRoot, [domain], context, home)) sources.push({
 			domain,
 			paths: sharedPaths,
 			mcpPaths: sharedPaths,
@@ -411,12 +421,21 @@ function createSkillCommands(inventory, catalog, groups) {
 }
 //#endregion
 //#region src/extensions/workspaces/sessions/(backend)/_lib/skillServer.ts
-async function createSkillServer(agent, signal) {
-	const { inventory, catalog, groups, mcpGroups, listed } = await discoverServerSkills(agent.context, signal);
+async function createSkillServer(agent, fs, signal, resources) {
+	const execution = agent.context;
+	const key = [
+		"inventory",
+		execution.repoRoot,
+		execution.cwd,
+		execution.environment.HOME ?? nodeHost.homeDirectory(),
+		...readHarnessState(execution.environment).skillDirectories ?? [],
+		Math.floor(Date.now() / SKILL_INVENTORY_FRESH_MS)
+	];
+	const { inventory, catalog, groups, mcpGroups, listed } = await resources.acquire(key, () => discoverServerSkills(execution, fs, new AbortController().signal));
 	return {
 		commands: createSkillCommands(inventory, catalog, groups),
 		tools: [createSessionLoadSkillTool(agent)],
-		services: [mountMcpSkills(mcpGroups, signal)],
+		services: [mountMcpSkills(mcpGroups, fs, signal)],
 		resources: [...listed.flatMap((group) => group.skills.map((skill) => ({
 			name: skill.name,
 			description: skill.description,
@@ -429,7 +448,7 @@ async function createSkillServer(agent, signal) {
 					mode: group.domain
 				}
 			} },
-			read: () => readFile(skill.filePath, "utf8")
+			read: async () => getOrThrow(await fs.readTextFile(skill.filePath, BACKGROUND_CONTEXT))
 		}))), ...[{
 			name: "po-author-skill",
 			description: "Author and distribute Po agent skills. Use when creating a SKILL.md, contributing a runtime skill directory, or publishing activation-gated Help prompts and diagnostic tools."
@@ -453,8 +472,8 @@ async function createSkillServer(agent, signal) {
 }
 //#endregion
 //#region src/extensions/workspaces/sessions/(backend)/root.server.ts
-var root_server_default = defineRoot(async ({ agent, signal }) => {
-	const runtime = agent ? await createSkillServer(agent, signal) : {
+var root_server_default = defineRoot(async ({ agent, context: root, signal, resources }) => {
+	const runtime = agent ? await createSkillServer(agent, requirePoFs(root), signal, resources) : {
 		commands: [],
 		resources: []
 	};
@@ -486,11 +505,12 @@ const via = (identity, value) => value === void 0 ? void 0 : {
 	...identity,
 	...value
 };
-const facet = defineServerPlugin({
+const serverPlugin = defineServerPlugin({
 	name: "@agimon-ai/po-skill",
 	providerOverrides: composeServerProviderOverrides(root_server_default),
+	injects: composeRootInjects({ session: [root_server_default] }),
 	session: async (context) => {
-		const scopeSession = await root_server_default(context);
+		const scopeSession = await context.scopeRoot("session", root_server_default, context);
 		const contextSession = {
 			...context,
 			root: scopeSession.value
@@ -514,6 +534,6 @@ const facet = defineServerPlugin({
 	}
 });
 //#endregion
-export { facet as default, facet };
+export { serverPlugin as default, serverPlugin };
 
 //# sourceMappingURL=server.mjs.map

package/dist/extensions/server.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"server.mjs","names":["rootSession","commandSkills","resourceSkills","toolLoadSkill"],"sources":["../../src/services/mcpSkills/index.ts","../../src/schemas/mcpSkillTools.ts","../../src/services/mcpSkillTools/index.ts","../../src/services/deferredSkills/index.ts","../../src/services/serverInventory/index.ts","../../src/extensions/workspaces/sessions/(backend)/_lib/skillCommands.ts","../../src/extensions/workspaces/sessions/(backend)/_lib/skillServer.ts","../../src/extensions/workspaces/sessions/(backend)/root.server.ts","../../src/extensions/workspaces/sessions/(backend)/command/skills.server.ts","../../src/extensions/workspaces/sessions/(backend)/resource/skills.server.ts","../../src/extensions/workspaces/sessions/(backend)/tool/load_skill.server.ts","../../generated/server.ts"],"sourcesContent":["import { readFile } from 'node:fs/promises';\n\nimport type { DoomMcpPluginContext, DoomMcpSkill } from '@agimon-ai/po-core/mcpFacet';\nimport type { Context } from '@deepseek-ai/cordis';\n\nimport type { ServerSkillGroup } from '../serverInventory';\n\nexport const MCP_SKILLS_SERVICE = 'doom/discovered-mcp-skills';\n\nexport interface McpSkillProvider {\n  list(context: DoomMcpPluginContext): readonly DoomMcpSkill[];\n}\n\n/** Explicit remote provider, never a projection of the local resource registry. */\nexport function mountMcpSkills(groups: readonly ServerSkillGroup[], signal: AbortSignal) {\n  return (context: Context): void => {\n    context.provide(MCP_SKILLS_SERVICE, {\n      list(remote) {\n        signal.throwIfAborted();\n        remote.signal.throwIfAborted();\n        const domains = remote.selection.read().domains;\n        const skills = new Map<string, DoomMcpSkill>();\n        for (const group of groups) {\n          if (group.domain !== undefined && !domains.includes(group.domain)) continue;\n          for (const skill of group.skills) {\n            // Match command precedence, including shared copies across domains.\n            if (skills.has(skill.name)) continue;\n            skills.set(skill.name, {\n              name: skill.name,\n              description: skill.description,\n              async read() {\n                const readSignal = AbortSignal.any([signal, remote.signal]);\n                readSignal.throwIfAborted();\n                const text = await readFile(skill.filePath, { encoding: 'utf8', signal: readSignal });\n                readSignal.throwIfAborted();\n                return text;\n              },\n            });\n          }\n        }\n        return [...skills.values()];\n      },\n    } satisfies McpSkillProvider);\n  };\n}\n\nexport function bindMcpSkills(context: DoomMcpPluginContext): readonly DoomMcpSkill[] {\n  const provider = context.services.get<McpSkillProvider>(MCP_SKILLS_SERVICE);\n  if (!provider) throw new Error('Discovered MCP skills are unavailable.');\n  return provider.list(context);\n}\n","import { Type } from 'typebox';\n\nexport const searchSkillsParameters = Type.Object({ query: Type.Optional(Type.String()) });\nexport const loadSkillParameters = Type.Object({ name: Type.String() });\n","import type { DoomHeadlessHostService, DoomHeadlessTool } from '@agimon-ai/po-core/headless';\n\nimport { loadSkillParameters, searchSkillsParameters } from '../../schemas/mcpSkillTools';\n\nfunction text(text: string) {\n  return { content: [{ type: 'text' as const, text }] };\n}\n\nfunction skills(context: Parameters<DoomHeadlessTool['execute']>[4]) {\n  if (context.mcpSkills === undefined) throw new Error('Remote skill access is unavailable.');\n  return context.mcpSkills;\n}\n\nexport function createSearchSkillsTool(): DoomHeadlessTool<typeof searchSkillsParameters> {\n  return {\n    // web-plugin-tool-renderers: ignore search_skills (remote MCP only)\n    name: 'search_skills',\n    label: 'Search skills',\n    description: 'Discover repository and active-domain skills available to this remote connection.',\n    parameters: searchSkillsParameters,\n    annotations: { readOnlyHint: true, destructiveHint: false, openWorldHint: false },\n    async execute(_toolCallId, { query }, _signal, _onUpdate, context) {\n      const needle = query?.trim().toLocaleLowerCase();\n      const available = await skills(context).list();\n      const matches =\n        needle === undefined || needle === ''\n          ? available\n          : available.filter(({ name, description }) => `${name}\\n${description}`.toLocaleLowerCase().includes(needle));\n      return { ...text(JSON.stringify(matches)), structuredContent: { skills: matches } };\n    },\n  };\n}\n\n/**\n * The session agent's way into a skill. Its skills are listed in the prompt, which Po\n * controls, so it needs no search; a remote agent's prompt is not ours, hence the pair above.\n */\nexport function createSessionLoadSkillTool(\n  host: Pick<DoomHeadlessHostService, 'readSkill'>,\n): DoomHeadlessTool<typeof loadSkillParameters> {\n  return {\n    // web-plugin-tool-renderers: ignore load_skill (server session only, shown as a generic call)\n    // DOOM_LOAD_SKILL_TOOL, spelled out so the renderer rule can read it.\n    name: 'load_skill',\n    label: 'Load skill',\n    description: 'Load the full instructions of a skill from the available skills list by exact name.',\n    parameters: loadSkillParameters,\n    executionMode: 'parallel',\n    async execute(_toolCallId, { name }) {\n      const body = host.readSkill(name);\n      if (body === undefined) return { ...text(`No skill named ${name} is available in this session.`), isError: true };\n      return text(body);\n    },\n  };\n}\n\nexport function createLoadSkillTool(): DoomHeadlessTool<typeof loadSkillParameters> {\n  return {\n    // web-plugin-tool-renderers: ignore load_skill (remote MCP only)\n    name: 'load_skill',\n    label: 'Load skill',\n    description: 'Load the full Markdown instructions for an available remote skill by exact name.',\n    parameters: loadSkillParameters,\n    annotations: { readOnlyHint: true, destructiveHint: false, openWorldHint: false },\n    async execute(_toolCallId, { name }, _signal, _onUpdate, context) {\n      return text(await skills(context).read(name));\n    },\n  };\n}\n","import fs from 'node:fs';\nimport path from 'node:path';\nimport { fileURLToPath, pathToFileURL } from 'node:url';\nimport { Worker } from 'node:worker_threads';\n\nimport {\n  type BuildSystemPromptOptions,\n  formatSkillsForPrompt,\n  getAgentDir,\n  loadSkills,\n  type Skill,\n  stripFrontmatter,\n} from '@earendil-works/pi-coding-agent';\n\nexport interface DeferredSkillSnapshot {\n  skills: Skill[];\n  diagnostics: string[];\n}\n\nconst PI_PACKAGE = '@earendil-works/pi-coding-agent';\nconst PACKAGE_MANIFEST = 'package.json';\nconst SKILL_WORKER_SOURCE = `\nconst { parentPort, workerData } = require('node:worker_threads');\nvoid (async () => {\n  try {\n    const { loadSkills } = await import(workerData.piModuleUrl);\n    parentPort.postMessage({ ok: true, result: loadSkills(workerData.loadOptions) });\n  } catch (error) {\n    parentPort.postMessage({ ok: false, error: error instanceof Error ? error.message : String(error) });\n  }\n})();\n`;\n\nfunction installedPiModuleUrl(): string {\n  const anchors = [process.argv[1], fileURLToPath(import.meta.url), path.join(process.cwd(), PACKAGE_MANIFEST)];\n  for (const anchor of anchors) {\n    if (!anchor) continue;\n    let directory = path.dirname(path.resolve(anchor));\n    while (true) {\n      const packageRoot = path.join(directory, 'node_modules', PI_PACKAGE);\n      const manifestPath = path.join(packageRoot, PACKAGE_MANIFEST);\n      try {\n        const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8')) as { main?: unknown };\n        if (typeof manifest.main === 'string') {\n          const entry = path.resolve(packageRoot, manifest.main);\n          if (fs.existsSync(entry)) return pathToFileURL(entry).href;\n        }\n      } catch {\n        // This anchor does not expose Pi at this level; continue up its module chain.\n      }\n      const parent = path.dirname(directory);\n      if (parent === directory) break;\n      directory = parent;\n    }\n  }\n  throw new Error(`Cannot resolve ${PI_PACKAGE} from the Po or host module trees`);\n}\n\ninterface SkillWorkerResult {\n  ok: boolean;\n  result?: { skills: Skill[]; diagnostics: Array<{ path?: string; message: string }> };\n  error?: string;\n}\n\nexport interface DeferredSkillLoaderOptions {\n  cwd: string;\n  skillPaths: readonly string[];\n  agentDir?: string;\n  piModuleUrl?: string;\n  schedule?: (load: () => void) => void;\n  load?: (options: { cwd: string; agentDir: string; skillPaths: string[]; includeDefaults: boolean }) => {\n    skills: Skill[];\n    diagnostics: Array<{ path?: string; message: string }>;\n  };\n}\n\n/**\n * One session's Doom-selected skill inventory.\n *\n * Construction is deliberately cheap. `start()` schedules the synchronous Pi\n * walker after session_start returns, while `ready()` is the single promise the\n * first input awaits before Pi expands `/skill:name`.\n */\nexport class DeferredSkillLoader {\n  readonly #options: DeferredSkillLoaderOptions;\n  #promise: Promise<DeferredSkillSnapshot> | undefined;\n\n  constructor(options: DeferredSkillLoaderOptions) {\n    this.#options = options;\n  }\n\n  start(): Promise<DeferredSkillSnapshot> {\n    if (this.#promise) return this.#promise;\n\n    if (!this.#options.schedule && !this.#options.load) {\n      this.#promise = this.#loadInWorker();\n      return this.#promise;\n    }\n\n    const schedule = this.#options.schedule ?? ((load: () => void) => setImmediate(load));\n    this.#promise = new Promise((resolve) => {\n      const fail = (error: unknown): void => {\n        resolve(this.#failure(error));\n      };\n      try {\n        schedule(() => {\n          try {\n            resolve(this.#load());\n          } catch (error) {\n            fail(error);\n          }\n        });\n      } catch (error) {\n        fail(error);\n      }\n    });\n    return this.#promise;\n  }\n\n  ready(): Promise<DeferredSkillSnapshot> {\n    return this.start();\n  }\n\n  #loadOptions(): { cwd: string; agentDir: string; skillPaths: string[]; includeDefaults: boolean } {\n    return {\n      cwd: this.#options.cwd,\n      agentDir: this.#options.agentDir ?? getAgentDir(),\n      skillPaths: [...this.#options.skillPaths],\n      includeDefaults: false,\n    };\n  }\n\n  #snapshot(result: {\n    skills: Skill[];\n    diagnostics: Array<{ path?: string; message: string }>;\n  }): DeferredSkillSnapshot {\n    return {\n      skills: result.skills,\n      diagnostics: result.diagnostics.map(\n        (diagnostic) => `${diagnostic.path ?? this.#options.cwd}: ${diagnostic.message}`,\n      ),\n    };\n  }\n\n  #failure(error: unknown): DeferredSkillSnapshot {\n    return {\n      skills: [],\n      diagnostics: [`${this.#options.cwd}: ${error instanceof Error ? error.message : String(error)}`],\n    };\n  }\n\n  #load(): DeferredSkillSnapshot {\n    return this.#snapshot((this.#options.load ?? loadSkills)(this.#loadOptions()));\n  }\n\n  #loadInWorker(): Promise<DeferredSkillSnapshot> {\n    return new Promise((resolve) => {\n      let settled = false;\n      const settle = (snapshot: DeferredSkillSnapshot): void => {\n        if (settled) return;\n        settled = true;\n        resolve(snapshot);\n      };\n      let worker: Worker;\n      try {\n        worker = new Worker(SKILL_WORKER_SOURCE, {\n          eval: true,\n          workerData: {\n            piModuleUrl: this.#options.piModuleUrl ?? installedPiModuleUrl(),\n            loadOptions: this.#loadOptions(),\n          },\n        });\n      } catch (error) {\n        settle(this.#failure(error));\n        return;\n      }\n      worker.unref();\n      worker.once('message', (message: SkillWorkerResult) => {\n        if (!message.ok || !message.result) {\n          settle(this.#failure(message.error ?? 'Skill worker failed'));\n          return;\n        }\n        settle(this.#snapshot(message.result));\n      });\n      worker.once('error', (error) => settle(this.#failure(error)));\n      worker.once('exit', (code) => {\n        if (code !== 0) settle(this.#failure(`Skill worker exited with code ${code}`));\n      });\n    });\n  }\n}\n\n/** Appends only the inventory Pi would append for these deferred skills. */\nexport function buildPromptWithDeferredSkills(\n  systemPrompt: string,\n  options: BuildSystemPromptOptions,\n  skills: Skill[],\n): string {\n  if (options.selectedTools && !options.selectedTools.includes('read')) return systemPrompt;\n  return `${systemPrompt}${formatSkillsForPrompt(skills)}`;\n}\n\n/** Expands a deferred `/skill:name` before Pi consults its synchronous inventory. */\nexport function expandDeferredSkillCommand(text: string, skills: readonly Skill[]): string {\n  if (!text.startsWith('/skill:')) return text;\n  const spaceIndex = text.indexOf(' ');\n  const skillName = spaceIndex === -1 ? text.slice(7) : text.slice(7, spaceIndex);\n  const skill = skills.find((candidate) => candidate.name === skillName);\n  if (!skill) return text;\n\n  try {\n    const args = spaceIndex === -1 ? '' : text.slice(spaceIndex + 1).trim();\n    const body = stripFrontmatter(fs.readFileSync(skill.filePath, 'utf8')).trim();\n    const skillBlock = `<skill name=\"${skill.name}\" location=\"${skill.filePath}\">\\nReferences are relative to ${skill.baseDir}.\\n\\n${body}\\n</skill>`;\n    return args ? `${skillBlock}\\n\\n${args}` : skillBlock;\n  } catch {\n    // Pi uses the same literal-text fallback if a skill disappears between\n    // discovery and submission; the agent can still respond to the command.\n    return text;\n  }\n}\n","import { readFile } from 'node:fs/promises';\nimport os from 'node:os';\nimport path from 'node:path';\n\nimport {\n  listDomainNames,\n  resolvePluginEntries,\n  resolveSharedSkills,\n  type PluginEntry,\n} from '@agimon-ai/po-config/domains';\nimport { readHarnessState } from '@agimon-ai/po-config/harnessState';\nimport type { DoomHeadlessExecutionContext } from '@agimon-ai/po-core/headless';\nimport { materializePluginEntries } from '@agimon-ai/po-domain/plugins';\nimport { collectResources, discoverSkillsAsync } from '@agimon-ai/po-domain/resources';\nimport { formatSkillsForPrompt, type Skill } from '@earendil-works/pi-coding-agent';\n\nimport { DeferredSkillLoader, type DeferredSkillSnapshot } from '../deferredSkills';\n\n/** Skills and the domain whose selection activates them, or always-on when absent. */\nexport interface ServerSkillGroup {\n  readonly domain?: string;\n  readonly skills: readonly Skill[];\n}\n\nexport interface ServerSkillInventory {\n  /** Every skill any selection can reach, so an activated command can still expand. */\n  readonly inventory: DeferredSkillSnapshot;\n  readonly groups: readonly ServerSkillGroup[];\n  readonly mcpGroups: readonly ServerSkillGroup[];\n  /**\n   * The shared and repository skills this package advertises itself. Domain plugin skills are\n   * left out: po-domain already contributes each one, and listing them twice was noise.\n   */\n  readonly listed: readonly ServerSkillGroup[];\n  readonly catalog: string;\n}\n\ninterface SkillSource {\n  readonly domain?: string;\n  readonly paths: readonly string[];\n  readonly mcpPaths: readonly string[];\n  /** Advertised by this package rather than by po-domain. */\n  readonly listed?: boolean;\n}\n\nconst LOCAL_ONLY_MCP_PACKAGES = new Set([\n  '@agimon-ai/po-author',\n  '@agimon-ai/po-git',\n  '@agimon-ai/po-goal',\n  '@agimon-ai/po-help',\n  '@agimon-ai/po-loop',\n  '@agimon-ai/po-user-feedback',\n  '@agimon-ai/po-voice',\n  '@agimon-ai/po-workflow',\n]);\n\nasync function isMcpSkillPlugin(entry: PluginEntry): Promise<boolean> {\n  if (entry.source?.type === 'npm') return !LOCAL_ONLY_MCP_PACKAGES.has(entry.source.package);\n  try {\n    const manifest = JSON.parse(await readFile(path.join(entry.directory, 'package.json'), 'utf8')) as unknown;\n    if (typeof manifest !== 'object' || manifest === null || Array.isArray(manifest)) return false;\n    const name = (manifest as { name?: unknown }).name;\n    return typeof name === 'string' && name.length > 0 && name.trim() === name && !LOCAL_ONLY_MCP_PACKAGES.has(name);\n  } catch (error) {\n    // A package manifest is optional for catalog plugins, but a present identity\n    // that cannot be read or parsed must never make the plugin remotely eligible.\n    return (error as NodeJS.ErrnoException).code === 'ENOENT';\n  }\n}\n\n/**\n * Whether a discovered skill came from one of these paths.\n *\n * A source holds exact SKILL.md files for plugin and shared skills, but a bare\n * directory for `.po/skills`, so membership is containment rather than\n * equality.\n */\nfunction within(filePath: string, roots: readonly string[]): boolean {\n  const resolved = path.resolve(filePath);\n  return roots.some((root) => {\n    const base = path.resolve(root);\n    return resolved === base || resolved.startsWith(`${base}${path.sep}`);\n  });\n}\n/**\n * Every skill the session could reach, grouped by what activates it.\n *\n * A cockpit `/domains` switch reconciles contributions rather than rebuilding\n * the facet: the session declaration is mounted once. So enumerating only the\n * launch selection would freeze the command list at whatever was selected when\n * the session host was built. Enumerating every domain up front and tagging\n * each group with its `when` lets the existing kernel refresh do the work, the\n * same way domainServerResources registers per-domain skill resources.\n */\nexport async function discoverServerSkills(\n  execution: DoomHeadlessExecutionContext,\n  signal: AbortSignal,\n): Promise<ServerSkillInventory> {\n  signal.throwIfAborted();\n  const state = readHarnessState(execution.environment);\n  const home = execution.environment.HOME ?? os.homedir();\n  const repoSkills = path.join(execution.repoRoot, '.po', 'skills');\n  const sources: SkillSource[] = [];\n  const diagnostics: string[] = [];\n  // A malformed domain is a configuration error in one domain, so it must not\n  // remove every other domain's skills. Enumerating the whole manifest is new\n  // exposure here: reading the launch selection could not fail this way.\n  const domains: string[] = [];\n  try {\n    domains.push(...listDomainNames(execution.repoRoot, home));\n  } catch (error) {\n    diagnostics.push(`Domain skills are unavailable: ${error instanceof Error ? error.message : String(error)}`);\n  }\n\n  // Domain-scoped plugin skills come first. The host keeps the first command\n  // registered for a name, so this ordering reproduces the collector's rule\n  // that a selected plugin outranks a shared fallback of the same name.\n  for (const domain of domains) {\n    signal.throwIfAborted();\n    try {\n      const plugins = await materializePluginEntries(resolvePluginEntries(execution.repoRoot, [domain], [], home));\n      const mcpPluginRoots = (\n        await Promise.all(\n          plugins.map(async (plugin) =>\n            (await isMcpSkillPlugin(plugin)) ? path.join(plugin.directory, 'skills') : undefined,\n          ),\n        )\n      ).filter((root): root is string => root !== undefined);\n      const collected = await collectResources(execution.repoRoot, plugins, {\n        agents: false,\n        mcp: false,\n        sharedSkills: false,\n      });\n      try {\n        if (collected.skillDirectories.length > 0) {\n          const paths = [...collected.skillDirectories];\n          sources.push({\n            domain,\n            paths,\n            // Exact collected paths retain this domain's per-plugin skill subset.\n            // A plugin root would also admit skills loaded for another domain.\n            mcpPaths: paths.filter((skillPath) => within(skillPath, mcpPluginRoots)),\n          });\n        }\n      } finally {\n        await collected.cleanup();\n      }\n    } catch (error) {\n      diagnostics.push(`Domain '${domain}': ${error instanceof Error ? error.message : String(error)}`);\n    }\n  }\n\n  // Shared .claude/skills are not owned by any one domain, and a domain can opt\n  // out of them. `when` cannot express \"unless every selected domain opts out\",\n  // but registering a copy per domain that keeps them says the same thing: the\n  // group is active if any such domain is selected, which is exactly what\n  // resolveSharedSkills computes.\n  signal.throwIfAborted();\n  const shared = await discoverSkillsAsync(execution.repoRoot, path.join(execution.repoRoot, '.claude', 'skills'));\n  if (shared.length > 0) {\n    const sharedPaths = shared.map((skill) => skill.path);\n    for (const domain of domains) {\n      if (resolveSharedSkills(execution.repoRoot, [domain], home)) {\n        sources.push({ domain, paths: sharedPaths, mcpPaths: sharedPaths, listed: true });\n      }\n    }\n  }\n\n  // Repository-local skills belong to the repository, not to a selection.\n  sources.push({ paths: [repoSkills], mcpPaths: [repoSkills], listed: true });\n\n  signal.throwIfAborted();\n  // One walk for every group. Pi drops a path it has already loaded, so the\n  // loader gets the unique set and each group selects its own skills back out.\n  const unique = [...new Set([...sources.flatMap((source) => source.paths), ...(state.skillDirectories ?? [])])];\n  const inventory = await new DeferredSkillLoader({ cwd: execution.cwd, skillPaths: unique }).ready();\n  signal.throwIfAborted();\n\n  const groups = sources\n    .map((source) => ({\n      ...(source.domain === undefined ? {} : { domain: source.domain }),\n      skills: inventory.skills.filter((skill) => within(skill.filePath, source.paths)),\n    }))\n    .filter((group) => group.skills.length > 0);\n  const listed = sources\n    .filter((source) => source.listed === true)\n    .map((source) => ({\n      ...(source.domain === undefined ? {} : { domain: source.domain }),\n      skills: inventory.skills.filter((skill) => within(skill.filePath, source.paths)),\n    }))\n    .filter((group) => group.skills.length > 0);\n  const mcpGroups = sources\n    .map((source) => ({\n      ...(source.domain === undefined ? {} : { domain: source.domain }),\n      skills: inventory.skills.filter((skill) => within(skill.filePath, source.mcpPaths)),\n    }))\n    .filter((group) => group.skills.length > 0);\n\n  // The catalog still describes the active selection rather than everything on\n  // disk, because it is prompt text rather than a menu.\n  const activeSkills = inventory.skills.filter((skill) =>\n    within(skill.filePath, [...(state.skillDirectories ?? []), repoSkills]),\n  );\n  return {\n    inventory: { skills: inventory.skills, diagnostics: [...inventory.diagnostics, ...diagnostics] },\n    groups,\n    mcpGroups,\n    listed,\n    catalog: formatSkillsForPrompt(activeSkills) || '(no discovered skills)',\n  };\n}\n","import type { DoomHeadlessCommand } from '@agimon-ai/po-core/headless';\nimport type { Skill } from '@earendil-works/pi-coding-agent';\n\nimport { expandDeferredSkillCommand, type DeferredSkillSnapshot } from '../../../../../services/deferredSkills';\nimport type { ServerSkillGroup } from '../../../../../services/serverInventory';\nimport { SKILL_COMMAND_PREFIX, SKILL_INVOCATION_PREFIX, SKILLS_COMMAND } from '../../../../../types/skills';\n\n/**\n * One command per skill, gated by whatever activates that skill.\n *\n * Expansion always reads the full inventory, not the group: a command is only\n * dispatchable while its condition holds, so by the time one runs its skill is\n * active, and looking it up in the union keeps one lookup table instead of one\n * per domain.\n */\nfunction skillCommand(skill: Skill, domain: string | undefined, inventory: DeferredSkillSnapshot): DoomHeadlessCommand {\n  return {\n    ...(domain === undefined ? {} : { when: { domain } }),\n    name: `${SKILL_COMMAND_PREFIX}${skill.name}`,\n    description: skill.description,\n    execute: async (args, execution) => {\n      const text = `${SKILL_INVOCATION_PREFIX}${skill.name}${args ? ` ${args}` : ''}`;\n      const expanded = expandDeferredSkillCommand(text, inventory.skills);\n      if (expanded === text) throw new Error(`Skill '${skill.name}' is no longer readable.`);\n      await execution.session.prompt(expanded);\n    },\n  };\n}\n\nexport function createSkillCommands(\n  inventory: DeferredSkillSnapshot,\n  catalog: string,\n  groups: readonly ServerSkillGroup[],\n): readonly DoomHeadlessCommand[] {\n  return [\n    {\n      name: SKILLS_COMMAND,\n      description: 'List discovered skills or invoke one by name.',\n      async execute(args, execution) {\n        const requested = args.trim();\n        if (requested) {\n          await execution.session.prompt(\n            expandDeferredSkillCommand(`${SKILL_INVOCATION_PREFIX}${requested}`, inventory.skills),\n          );\n          return;\n        }\n        await execution.client.notify({\n          title: 'Po skills',\n          body: catalog,\n          level: 'info',\n        });\n      },\n    },\n    ...groups.flatMap((group) => group.skills.map((skill) => skillCommand(skill, group.domain, inventory))),\n  ];\n}\n","import { readFile } from 'node:fs/promises';\n\nimport type { DoomHeadlessHostService } from '@agimon-ai/po-core/headless';\nimport { type DoomServerSessionPlugin, packageResourcePath, readPackageResource } from '@agimon-ai/po-core/serverFacet';\n\nimport { mountMcpSkills } from '../../../../../services/mcpSkills';\nimport { createSessionLoadSkillTool } from '../../../../../services/mcpSkillTools';\nimport { discoverServerSkills } from '../../../../../services/serverInventory';\nimport { createSkillCommands } from './skillCommands';\n\nexport async function createSkillServer(\n  agent: DoomHeadlessHostService,\n  signal: AbortSignal,\n): Promise<DoomServerSessionPlugin> {\n  const { inventory, catalog, groups, mcpGroups, listed } = await discoverServerSkills(agent.context, signal);\n  return {\n    commands: createSkillCommands(inventory, catalog, groups),\n    tools: [createSessionLoadSkillTool(agent)],\n    services: [mountMcpSkills(mcpGroups, signal)],\n    resources: [\n      // Each skill joins the prompt's one <available_skills> list, gated like the rest.\n      ...listed.flatMap((group) =>\n        group.skills.map((skill) => ({\n          name: skill.name,\n          description: skill.description,\n          path: skill.filePath,\n          kind: 'skill' as const,\n          ...(group.domain === undefined\n            ? {}\n            : { when: { domain: group.domain, attribution: { kind: 'domain' as const, mode: group.domain } } }),\n          read: () => readFile(skill.filePath, 'utf8'),\n        })),\n      ),\n      ...[\n        {\n          name: 'po-author-skill',\n          description:\n            'Author and distribute Po agent skills. Use when creating a SKILL.md, contributing a runtime skill directory, or publishing activation-gated Help prompts and diagnostic tools.',\n        },\n        {\n          name: 'po-use-skill',\n          description:\n            \"Use Po's skill catalog and deferred discovery. Diagnose missing or shadowed skills and invoke the narrowest available guidance.\",\n        },\n      ].map((skill) => ({\n        ...skill,\n        when: { state: { 'minor-mode': 'help' }, attribution: { kind: 'minor' as const, mode: 'help' } },\n        kind: 'skill' as const,\n        path: packageResourcePath(import.meta.url, `src/prompts/${skill.name}/SKILL.md`),\n        read: () => readPackageResource(import.meta.url, `src/prompts/${skill.name}/SKILL.md`),\n      })),\n    ],\n  };\n}\n","import { defineRoot } from '@agimon-ai/po-core/extensionFile';\nimport type { DoomServerPluginContext, DoomServerSessionPlugin } from '@agimon-ai/po-core/serverFacet';\n\nimport { createSkillServer } from './_lib/skillServer';\n\nexport default defineRoot(async ({ agent, signal }: DoomServerPluginContext) => {\n  const runtime: DoomServerSessionPlugin = agent\n    ? await createSkillServer(agent, signal)\n    : { commands: [], resources: [] };\n  return { value: runtime, services: runtime.services };\n});\n","import { defineRoutedContribution } from '@agimon-ai/po-core/extensionFile';\nimport type { WithRoot } from '@agimon-ai/po-core/extensionFile';\nimport type { DoomServerPluginContext, DoomServerSessionPlugin } from '@agimon-ai/po-core/serverFacet';\n\nexport default defineRoutedContribution(\n  (context: WithRoot<DoomServerPluginContext, DoomServerSessionPlugin>) => context.root.commands!,\n  { cardinality: 'many' },\n);\n","import { defineRoutedContribution } from '@agimon-ai/po-core/extensionFile';\nimport type { WithRoot } from '@agimon-ai/po-core/extensionFile';\nimport type { DoomServerPluginContext, DoomServerSessionPlugin } from '@agimon-ai/po-core/serverFacet';\n\nexport default defineRoutedContribution(\n  (context: WithRoot<DoomServerPluginContext, DoomServerSessionPlugin>) => context.root.resources!,\n  { cardinality: 'many' },\n);\n","import { defineRoutedContribution, type WithRoot } from '@agimon-ai/po-core/extensionFile';\nimport type { DoomServerPluginContext, DoomServerSessionPlugin } from '@agimon-ai/po-core/serverFacet';\n\n/** The session agent's skill loader; the Pi CLI keeps Pi's own skill handling. */\nexport default defineRoutedContribution(\n  (context: WithRoot<DoomServerPluginContext, DoomServerSessionPlugin>) => context.root.tools?.[0],\n  { cardinality: 'optional' },\n);\n","// Generated by @agimon-ai/po-build. Do not edit by hand.\nimport { defineServerPlugin, type DoomServerSessionPlugin } from '@agimon-ai/po-core/serverFacet';\nimport { composeServerProviderOverrides } from '@agimon-ai/po-core/serverFacet';\nimport { composeRootHooks } from '@agimon-ai/po-core/extensionFile';\n\nimport rootSession from '../src/extensions/workspaces/sessions/(backend)/root.server';\nimport commandSkills from '../src/extensions/workspaces/sessions/(backend)/command/skills.server';\nimport resourceSkills from '../src/extensions/workspaces/sessions/(backend)/resource/skills.server';\nimport toolLoadSkill from '../src/extensions/workspaces/sessions/(backend)/tool/load_skill.server';\n\ntype Factory<T, C> = (context: C) => T;\nconst at = <T, C>(value: T | Factory<T, C>, context: C): T =>\n  typeof value === 'function' ? (value as Factory<T, C>)(context) : value;\ntype ManyFactory<T, C> = (context: C) => T | readonly T[];\nconst many = <T, C>(value: T | readonly T[] | ManyFactory<T, C>, context: C): readonly T[] => {\n  const resolved = typeof value === 'function' ? (value as ManyFactory<T, C>)(context) : value;\n  return Array.isArray(resolved) ? resolved : [resolved as T];\n};\n/* v8 ignore next -- generated normalization branch */\nconst defined = <T>(values: readonly (T | undefined)[]): T[] =>\n  values.filter((value): value is T => value !== undefined);\nconst via = <T>(identity: Record<string, unknown>, value: unknown): T =>\n  (value === undefined ? undefined : { ...identity, ...(value as object) }) as T;\n\nexport const facet = defineServerPlugin({\n  name: '@agimon-ai/po-skill',\n  providerOverrides: composeServerProviderOverrides(rootSession),\n  session: async (context) => {\n    const scopeSession = await rootSession(context);\n    const contextSession = { ...context, root: scopeSession.value };\n    return {\n      ...composeRootHooks(scopeSession),\n      get commands(): DoomServerSessionPlugin['commands'] { return [...many(commandSkills, contextSession)]; },\n      get resources(): DoomServerSessionPlugin['resources'] { return [...many(resourceSkills, contextSession)]; },\n      get tools(): DoomServerSessionPlugin['tools'] { return defined([via({ name: 'load_skill' }, at(toolLoadSkill, contextSession))]); },\n      services: [...(scopeSession.services ?? [])],\n      get activities(): DoomServerSessionPlugin['activities'] { return [...(scopeSession.activities ?? [])]; },\n    };\n  },\n});\n\nexport default facet;\n"],"mappings":"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"}
+{"version":3,"file":"server.mjs","names":["rootSession","commandSkills","resourceSkills","toolLoadSkill"],"sources":["../../src/constants/skillInventory.ts","../../src/services/mcpSkills/index.ts","../../src/schemas/mcpSkillTools.ts","../../src/services/mcpSkillTools/index.ts","../../src/services/deferredSkills/index.ts","../../src/services/serverInventory/index.ts","../../src/extensions/workspaces/sessions/(backend)/_lib/skillCommands.ts","../../src/extensions/workspaces/sessions/(backend)/_lib/skillServer.ts","../../src/extensions/workspaces/sessions/(backend)/root.server.ts","../../src/extensions/workspaces/sessions/(backend)/command/skills.server.ts","../../src/extensions/workspaces/sessions/(backend)/resource/skills.server.ts","../../src/extensions/workspaces/sessions/(backend)/tool/load_skill.server.ts","../../generated/server.ts"],"sourcesContent":["/**\n * How long sessions with the same inputs share one skill inventory instead of each reading the disk.\n * ponytail: a skill added on disk reaches new sessions within this window, not at once; watch the\n * skill roots if that lag matters.\n */\nexport const SKILL_INVENTORY_FRESH_MS = 60_000;\n","import type { PoMcpPluginContext, PoMcpSkill } from '@agimon-ai/po-core/mcpFacet';\nimport { BACKGROUND_CONTEXT, getOrThrow, withAbortSignal, type FileSystem } from '@agimon-ai/po-core/platform';\nimport type { Context } from '@deepseek-ai/cordis';\n\nimport type { ServerSkillGroup } from '../serverInventory';\n\nexport const MCP_SKILLS_SERVICE = 'po/discovered-mcp-skills';\n\nexport interface McpSkillProvider {\n  list(context: PoMcpPluginContext): readonly PoMcpSkill[];\n}\n\n/** Explicit remote provider, never a projection of the local resource registry. */\nexport function mountMcpSkills(groups: readonly ServerSkillGroup[], fs: FileSystem, signal: AbortSignal) {\n  return (context: Context): void => {\n    context.provide(MCP_SKILLS_SERVICE, {\n      list(remote) {\n        signal.throwIfAborted();\n        remote.signal.throwIfAborted();\n        const domains = remote.selection.read().domains;\n        const skills = new Map<string, PoMcpSkill>();\n        for (const group of groups) {\n          if (group.domain !== undefined && !domains.includes(group.domain)) continue;\n          for (const skill of group.skills) {\n            // Match command precedence, including shared copies across domains.\n            if (skills.has(skill.name)) continue;\n            skills.set(skill.name, {\n              name: skill.name,\n              description: skill.description,\n              async read() {\n                const readSignal = AbortSignal.any([signal, remote.signal]);\n                readSignal.throwIfAborted();\n                const text = getOrThrow(\n                  await fs.readTextFile(skill.filePath, withAbortSignal(readSignal, BACKGROUND_CONTEXT)),\n                );\n                readSignal.throwIfAborted();\n                return text;\n              },\n            });\n          }\n        }\n        return [...skills.values()];\n      },\n    } satisfies McpSkillProvider);\n  };\n}\n\nexport function bindMcpSkills(context: PoMcpPluginContext): readonly PoMcpSkill[] {\n  const provider = context.services.get<McpSkillProvider>(MCP_SKILLS_SERVICE);\n  if (!provider) throw new Error('Discovered MCP skills are unavailable.');\n  return provider.list(context);\n}\n","import { Type } from 'typebox';\n\nexport const searchSkillsParameters = Type.Object({ query: Type.Optional(Type.String()) });\nexport const loadSkillParameters = Type.Object({ name: Type.String() });\n","import type { PoHeadlessHostService, PoHeadlessTool } from '@agimon-ai/po-core/headless';\n\nimport { loadSkillParameters, searchSkillsParameters } from '../../schemas/mcpSkillTools';\n\nfunction text(text: string) {\n  return { content: [{ type: 'text' as const, text }] };\n}\n\nfunction skills(context: Parameters<PoHeadlessTool['execute']>[4]) {\n  if (context.mcpSkills === undefined) throw new Error('Remote skill access is unavailable.');\n  return context.mcpSkills;\n}\n\nexport function createSearchSkillsTool(): PoHeadlessTool<typeof searchSkillsParameters> {\n  return {\n    // web-plugin-tool-renderers: ignore search_skills (remote MCP only)\n    name: 'search_skills',\n    label: 'Search skills',\n    description: 'Discover repository and active-domain skills available to this remote connection.',\n    parameters: searchSkillsParameters,\n    annotations: { readOnlyHint: true, destructiveHint: false, openWorldHint: false },\n    async execute(_toolCallId, { query }, _signal, _onUpdate, context) {\n      const needle = query?.trim().toLocaleLowerCase();\n      const available = await skills(context).list();\n      const matches =\n        needle === undefined || needle === ''\n          ? available\n          : available.filter(({ name, description }) => `${name}\\n${description}`.toLocaleLowerCase().includes(needle));\n      return { ...text(JSON.stringify(matches)), structuredContent: { skills: matches } };\n    },\n  };\n}\n\n/**\n * The session agent's way into a skill. Its skills are listed in the prompt, which Po\n * controls, so it needs no search; a remote agent's prompt is not ours, hence the pair above.\n */\nexport function createSessionLoadSkillTool(\n  host: Pick<PoHeadlessHostService, 'readSkill'>,\n): PoHeadlessTool<typeof loadSkillParameters> {\n  return {\n    // web-plugin-tool-renderers: ignore load_skill (server session only, shown as a generic call)\n    // PO_LOAD_SKILL_TOOL, spelled out so the renderer rule can read it.\n    name: 'load_skill',\n    label: 'Load skill',\n    description: 'Load the full instructions of a skill from the available skills list by exact name.',\n    parameters: loadSkillParameters,\n    executionMode: 'parallel',\n    async execute(_toolCallId, { name }) {\n      const body = host.readSkill(name);\n      if (body === undefined) return { ...text(`No skill named ${name} is available in this session.`), isError: true };\n      return text(body);\n    },\n  };\n}\n\nexport function createLoadSkillTool(): PoHeadlessTool<typeof loadSkillParameters> {\n  return {\n    // web-plugin-tool-renderers: ignore load_skill (remote MCP only)\n    name: 'load_skill',\n    label: 'Load skill',\n    description: 'Load the full Markdown instructions for an available remote skill by exact name.',\n    parameters: loadSkillParameters,\n    annotations: { readOnlyHint: true, destructiveHint: false, openWorldHint: false },\n    async execute(_toolCallId, { name }, _signal, _onUpdate, context) {\n      return text(await skills(context).read(name));\n    },\n  };\n}\n","import fs from 'node:fs';\nimport path from 'node:path';\nimport { fileURLToPath, pathToFileURL } from 'node:url';\nimport { Worker } from 'node:worker_threads';\n\nimport {\n  type BuildSystemPromptOptions,\n  formatSkillsForPrompt,\n  getAgentDir,\n  loadSkills,\n  type Skill,\n  stripFrontmatter,\n} from '@earendil-works/pi-coding-agent';\n\nimport type { DeferredSkillLoaderOptions, DeferredSkillSnapshot } from '../../types/skills';\n\nexport type { DeferredSkillLoaderOptions, DeferredSkillSnapshot } from '../../types/skills';\n\nconst PI_PACKAGE = '@earendil-works/pi-coding-agent';\nconst PACKAGE_MANIFEST = 'package.json';\n// A fresh worker takes ~240 ms to import Pi's main entry but ~20 ms for this module alone, and\n// every session spawns one. ponytail: not in Pi's exports map, so a Pi release that moves it\n// falls back to the main entry (slow, still correct); deferredSkills.test.ts pins the path.\nconst PI_SKILLS_MODULE = path.join('dist', 'core', 'skills.js');\nconst SKILL_WORKER_SOURCE = `\nconst { parentPort, workerData } = require('node:worker_threads');\nvoid (async () => {\n  try {\n    const { loadSkills } = await import(workerData.piModuleUrl);\n    parentPort.postMessage({ ok: true, result: loadSkills(workerData.loadOptions) });\n  } catch (error) {\n    parentPort.postMessage({ ok: false, error: error instanceof Error ? error.message : String(error) });\n  }\n})();\n`;\n\nfunction installedPiModuleUrl(): string {\n  const anchors = [process.argv[1], fileURLToPath(import.meta.url), path.join(process.cwd(), PACKAGE_MANIFEST)];\n  for (const anchor of anchors) {\n    if (!anchor) continue;\n    let directory = path.dirname(path.resolve(anchor));\n    while (true) {\n      const packageRoot = path.join(directory, 'node_modules', PI_PACKAGE);\n      const manifestPath = path.join(packageRoot, PACKAGE_MANIFEST);\n      try {\n        const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8')) as { main?: unknown };\n        if (typeof manifest.main === 'string') {\n          const entry = path.resolve(packageRoot, manifest.main);\n          const skills = path.join(packageRoot, PI_SKILLS_MODULE);\n          if (fs.existsSync(skills)) return pathToFileURL(skills).href;\n          if (fs.existsSync(entry)) return pathToFileURL(entry).href;\n        }\n      } catch {\n        // This anchor does not expose Pi at this level; continue up its module chain.\n      }\n      const parent = path.dirname(directory);\n      if (parent === directory) break;\n      directory = parent;\n    }\n  }\n  throw new Error(`Cannot resolve ${PI_PACKAGE} from the Po or host module trees`);\n}\n\ninterface SkillWorkerResult {\n  ok: boolean;\n  result?: { skills: Skill[]; diagnostics: Array<{ path?: string; message: string }> };\n  error?: string;\n}\n\n/**\n * One session's Po-selected skill inventory.\n *\n * Construction is deliberately cheap. `start()` schedules the synchronous Pi\n * walker after session_start returns, while `ready()` is the single promise the\n * first input awaits before Pi expands `/skill:name`.\n */\nexport class DeferredSkillLoader {\n  readonly #options: DeferredSkillLoaderOptions;\n  #promise: Promise<DeferredSkillSnapshot> | undefined;\n\n  constructor(options: DeferredSkillLoaderOptions) {\n    this.#options = options;\n  }\n\n  start(): Promise<DeferredSkillSnapshot> {\n    if (this.#promise) return this.#promise;\n\n    if (!this.#options.schedule && !this.#options.load) {\n      this.#promise = this.#loadInWorker();\n      return this.#promise;\n    }\n\n    const schedule = this.#options.schedule ?? ((load: () => void) => setImmediate(load));\n    this.#promise = new Promise((resolve) => {\n      const fail = (error: unknown): void => {\n        resolve(this.#failure(error));\n      };\n      try {\n        schedule(() => {\n          try {\n            resolve(this.#load());\n          } catch (error) {\n            fail(error);\n          }\n        });\n      } catch (error) {\n        fail(error);\n      }\n    });\n    return this.#promise;\n  }\n\n  ready(): Promise<DeferredSkillSnapshot> {\n    return this.start();\n  }\n\n  #loadOptions(): { cwd: string; agentDir: string; skillPaths: string[]; includeDefaults: boolean } {\n    return {\n      cwd: this.#options.cwd,\n      agentDir: this.#options.agentDir ?? getAgentDir(),\n      skillPaths: [...this.#options.skillPaths],\n      includeDefaults: false,\n    };\n  }\n\n  #snapshot(result: {\n    skills: Skill[];\n    diagnostics: Array<{ path?: string; message: string }>;\n  }): DeferredSkillSnapshot {\n    return {\n      skills: result.skills,\n      diagnostics: result.diagnostics.map(\n        (diagnostic) => `${diagnostic.path ?? this.#options.cwd}: ${diagnostic.message}`,\n      ),\n    };\n  }\n\n  #failure(error: unknown): DeferredSkillSnapshot {\n    return {\n      skills: [],\n      diagnostics: [`${this.#options.cwd}: ${error instanceof Error ? error.message : String(error)}`],\n    };\n  }\n\n  #load(): DeferredSkillSnapshot {\n    return this.#snapshot((this.#options.load ?? loadSkills)(this.#loadOptions()));\n  }\n\n  #loadInWorker(): Promise<DeferredSkillSnapshot> {\n    return new Promise((resolve) => {\n      let settled = false;\n      const settle = (snapshot: DeferredSkillSnapshot): void => {\n        if (settled) return;\n        settled = true;\n        resolve(snapshot);\n      };\n      let worker: Worker;\n      try {\n        worker = new Worker(SKILL_WORKER_SOURCE, {\n          eval: true,\n          workerData: {\n            piModuleUrl: this.#options.piModuleUrl ?? installedPiModuleUrl(),\n            loadOptions: this.#loadOptions(),\n          },\n        });\n      } catch (error) {\n        settle(this.#failure(error));\n        return;\n      }\n      worker.unref();\n      worker.once('message', (message: SkillWorkerResult) => {\n        if (!message.ok || !message.result) {\n          settle(this.#failure(message.error ?? 'Skill worker failed'));\n          return;\n        }\n        settle(this.#snapshot(message.result));\n      });\n      worker.once('error', (error) => settle(this.#failure(error)));\n      worker.once('exit', (code) => {\n        if (code !== 0) settle(this.#failure(`Skill worker exited with code ${code}`));\n      });\n    });\n  }\n}\n\n/** Appends only the inventory Pi would append for these deferred skills. */\nexport function buildPromptWithDeferredSkills(\n  systemPrompt: string,\n  options: BuildSystemPromptOptions,\n  skills: Skill[],\n): string {\n  if (options.selectedTools && !options.selectedTools.includes('read')) return systemPrompt;\n  return `${systemPrompt}${formatSkillsForPrompt(skills)}`;\n}\n\n/** Expands a deferred `/skill:name` before Pi consults its synchronous inventory. */\nexport function expandDeferredSkillCommand(text: string, skills: readonly Skill[]): string {\n  if (!text.startsWith('/skill:')) return text;\n  const spaceIndex = text.indexOf(' ');\n  const skillName = spaceIndex === -1 ? text.slice(7) : text.slice(7, spaceIndex);\n  const skill = skills.find((candidate) => candidate.name === skillName);\n  if (!skill) return text;\n\n  try {\n    const args = spaceIndex === -1 ? '' : text.slice(spaceIndex + 1).trim();\n    const body = stripFrontmatter(fs.readFileSync(skill.filePath, 'utf8')).trim();\n    const skillBlock = `<skill name=\"${skill.name}\" location=\"${skill.filePath}\">\\nReferences are relative to ${skill.baseDir}.\\n\\n${body}\\n</skill>`;\n    return args ? `${skillBlock}\\n\\n${args}` : skillBlock;\n  } catch {\n    // Pi uses the same literal-text fallback if a skill disappears between\n    // discovery and submission; the agent can still respond to the command.\n    return text;\n  }\n}\n","import path from 'node:path';\n\nimport {\n  listDomainNamesAsync,\n  resolvePluginEntriesAsync,\n  resolveSharedSkillsAsync,\n  type PluginEntry,\n} from '@agimon-ai/po-config/domains';\nimport { readHarnessState } from '@agimon-ai/po-config/harnessState';\nimport type { PoHeadlessExecutionContext } from '@agimon-ai/po-core/headless';\nimport { BACKGROUND_CONTEXT, nodeHost, withAbortSignal, type FileSystem } from '@agimon-ai/po-core/platform';\nimport { materializePluginEntries } from '@agimon-ai/po-domain/plugins';\nimport { collectResources, discoverSkillsAsync } from '@agimon-ai/po-domain/resources';\nimport { formatSkillsForPrompt } from '@earendil-works/pi-coding-agent';\n\nimport type { ServerSkillInventory } from '../../types/skills';\nimport { DeferredSkillLoader } from '../deferredSkills';\n\nexport type { ServerSkillGroup, ServerSkillInventory } from '../../types/skills';\n\ninterface SkillSource {\n  readonly domain?: string;\n  readonly paths: readonly string[];\n  readonly mcpPaths: readonly string[];\n  /** Advertised by this package rather than by po-domain. */\n  readonly listed?: boolean;\n}\n\nconst LOCAL_ONLY_MCP_PACKAGES = new Set([\n  '@agimon-ai/po-author',\n  '@agimon-ai/po-git',\n  '@agimon-ai/po-goal',\n  '@agimon-ai/po-help',\n  '@agimon-ai/po-loop',\n  '@agimon-ai/po-user-feedback',\n  '@agimon-ai/po-voice',\n  '@agimon-ai/po-workflow',\n]);\n\ntype IoContext = Parameters<FileSystem['readTextFile']>[1];\n\nasync function isMcpSkillPlugin(fs: FileSystem, entry: PluginEntry, context: IoContext): Promise<boolean> {\n  if (entry.source?.type === 'npm') return !LOCAL_ONLY_MCP_PACKAGES.has(entry.source.package);\n  // A package manifest is optional for catalog plugins, but a present identity\n  // that cannot be read or parsed must never make the plugin remotely eligible.\n  const source = await fs.readTextFile(path.join(entry.directory, 'package.json'), context);\n  if (!source.ok) return source.error.code === 'not_found';\n  try {\n    const manifest = JSON.parse(source.value) as unknown;\n    if (typeof manifest !== 'object' || manifest === null || Array.isArray(manifest)) return false;\n    const name = (manifest as { name?: unknown }).name;\n    return typeof name === 'string' && name.length > 0 && name.trim() === name && !LOCAL_ONLY_MCP_PACKAGES.has(name);\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Whether a discovered skill came from one of these paths.\n *\n * A source holds exact SKILL.md files for plugin and shared skills, but a bare\n * directory for `.po/skills`, so membership is containment rather than\n * equality.\n */\nfunction within(filePath: string, roots: readonly string[]): boolean {\n  const resolved = path.resolve(filePath);\n  return roots.some((root) => {\n    const base = path.resolve(root);\n    return resolved === base || resolved.startsWith(`${base}${path.sep}`);\n  });\n}\n/**\n * Every skill the session could reach, grouped by what activates it.\n *\n * A cockpit `/domains` switch reconciles contributions rather than rebuilding\n * the server plugin: the session declaration is mounted once. So enumerating only the\n * launch selection would freeze the command list at whatever was selected when\n * the session host was built. Enumerating every domain up front and tagging\n * each group with its `when` lets the existing kernel refresh do the work, the\n * same way domainServerResources registers per-domain skill resources.\n */\nexport async function discoverServerSkills(\n  execution: PoHeadlessExecutionContext,\n  fs: FileSystem,\n  signal: AbortSignal,\n): Promise<ServerSkillInventory> {\n  signal.throwIfAborted();\n  const context = withAbortSignal(signal, BACKGROUND_CONTEXT);\n  const state = readHarnessState(execution.environment);\n  const home = execution.environment.HOME ?? nodeHost.homeDirectory();\n  const repoSkills = path.join(execution.repoRoot, '.po', 'skills');\n  const sources: SkillSource[] = [];\n  const diagnostics: string[] = [];\n  // A malformed domain is a configuration error in one domain, so it must not\n  // remove every other domain's skills. Enumerating the whole manifest is new\n  // exposure here: reading the launch selection could not fail this way.\n  const domains: string[] = [];\n  try {\n    domains.push(...(await listDomainNamesAsync(fs, execution.repoRoot, context, home)));\n  } catch (error) {\n    diagnostics.push(`Domain skills are unavailable: ${error instanceof Error ? error.message : String(error)}`);\n  }\n\n  // Domain-scoped plugin skills come first. The host keeps the first command\n  // registered for a name, so this ordering reproduces the collector's rule\n  // that a selected plugin outranks a shared fallback of the same name.\n  for (const domain of domains) {\n    signal.throwIfAborted();\n    try {\n      const plugins = await materializePluginEntries(\n        await resolvePluginEntriesAsync(fs, execution.repoRoot, [domain], [], context, home),\n      );\n      const mcpPluginRoots = (\n        await Promise.all(\n          plugins.map(async (plugin) =>\n            (await isMcpSkillPlugin(fs, plugin, context)) ? path.join(plugin.directory, 'skills') : undefined,\n          ),\n        )\n      ).filter((root): root is string => root !== undefined);\n      const collected = await collectResources(execution.repoRoot, plugins, {\n        agents: false,\n        mcp: false,\n        sharedSkills: false,\n      });\n      try {\n        if (collected.skillDirectories.length > 0) {\n          const paths = [...collected.skillDirectories];\n          sources.push({\n            domain,\n            paths,\n            // Exact collected paths retain this domain's per-plugin skill subset.\n            // A plugin root would also admit skills loaded for another domain.\n            mcpPaths: paths.filter((skillPath) => within(skillPath, mcpPluginRoots)),\n          });\n        }\n      } finally {\n        await collected.cleanup();\n      }\n    } catch (error) {\n      diagnostics.push(`Domain '${domain}': ${error instanceof Error ? error.message : String(error)}`);\n    }\n  }\n\n  // Shared .claude/skills are not owned by any one domain, and a domain can opt\n  // out of them. `when` cannot express \"unless every selected domain opts out\",\n  // but registering a copy per domain that keeps them says the same thing: the\n  // group is active if any such domain is selected, which is exactly what\n  // resolveSharedSkills computes.\n  signal.throwIfAborted();\n  const shared = await discoverSkillsAsync(execution.repoRoot, path.join(execution.repoRoot, '.claude', 'skills'));\n  if (shared.length > 0) {\n    const sharedPaths = shared.map((skill) => skill.path);\n    for (const domain of domains) {\n      if (await resolveSharedSkillsAsync(fs, execution.repoRoot, [domain], context, home)) {\n        sources.push({ domain, paths: sharedPaths, mcpPaths: sharedPaths, listed: true });\n      }\n    }\n  }\n\n  // Repository-local skills belong to the repository, not to a selection.\n  sources.push({ paths: [repoSkills], mcpPaths: [repoSkills], listed: true });\n\n  signal.throwIfAborted();\n  // One walk for every group. Pi drops a path it has already loaded, so the\n  // loader gets the unique set and each group selects its own skills back out.\n  const unique = [...new Set([...sources.flatMap((source) => source.paths), ...(state.skillDirectories ?? [])])];\n  const inventory = await new DeferredSkillLoader({ cwd: execution.cwd, skillPaths: unique }).ready();\n  signal.throwIfAborted();\n\n  const groups = sources\n    .map((source) => ({\n      ...(source.domain === undefined ? {} : { domain: source.domain }),\n      skills: inventory.skills.filter((skill) => within(skill.filePath, source.paths)),\n    }))\n    .filter((group) => group.skills.length > 0);\n  const listed = sources\n    .filter((source) => source.listed === true)\n    .map((source) => ({\n      ...(source.domain === undefined ? {} : { domain: source.domain }),\n      skills: inventory.skills.filter((skill) => within(skill.filePath, source.paths)),\n    }))\n    .filter((group) => group.skills.length > 0);\n  const mcpGroups = sources\n    .map((source) => ({\n      ...(source.domain === undefined ? {} : { domain: source.domain }),\n      skills: inventory.skills.filter((skill) => within(skill.filePath, source.mcpPaths)),\n    }))\n    .filter((group) => group.skills.length > 0);\n\n  // The catalog still describes the active selection rather than everything on\n  // disk, because it is prompt text rather than a menu.\n  const activeSkills = inventory.skills.filter((skill) =>\n    within(skill.filePath, [...(state.skillDirectories ?? []), repoSkills]),\n  );\n  return {\n    inventory: { skills: inventory.skills, diagnostics: [...inventory.diagnostics, ...diagnostics] },\n    groups,\n    mcpGroups,\n    listed,\n    catalog: formatSkillsForPrompt(activeSkills) || '(no discovered skills)',\n  };\n}\n","import type { PoHeadlessCommand } from '@agimon-ai/po-core/headless';\nimport type { Skill } from '@earendil-works/pi-coding-agent';\n\nimport { expandDeferredSkillCommand, type DeferredSkillSnapshot } from '../../../../../services/deferredSkills';\nimport type { ServerSkillGroup } from '../../../../../services/serverInventory';\nimport { SKILL_COMMAND_PREFIX, SKILL_INVOCATION_PREFIX, SKILLS_COMMAND } from '../../../../../types/skills';\n\n/**\n * One command per skill, gated by whatever activates that skill.\n *\n * Expansion always reads the full inventory, not the group: a command is only\n * dispatchable while its condition holds, so by the time one runs its skill is\n * active, and looking it up in the union keeps one lookup table instead of one\n * per domain.\n */\nfunction skillCommand(skill: Skill, domain: string | undefined, inventory: DeferredSkillSnapshot): PoHeadlessCommand {\n  return {\n    ...(domain === undefined ? {} : { when: { domain } }),\n    name: `${SKILL_COMMAND_PREFIX}${skill.name}`,\n    description: skill.description,\n    execute: async (args, execution) => {\n      const text = `${SKILL_INVOCATION_PREFIX}${skill.name}${args ? ` ${args}` : ''}`;\n      const expanded = expandDeferredSkillCommand(text, inventory.skills);\n      if (expanded === text) throw new Error(`Skill '${skill.name}' is no longer readable.`);\n      await execution.session.prompt(expanded);\n    },\n  };\n}\n\nexport function createSkillCommands(\n  inventory: DeferredSkillSnapshot,\n  catalog: string,\n  groups: readonly ServerSkillGroup[],\n): readonly PoHeadlessCommand[] {\n  return [\n    {\n      name: SKILLS_COMMAND,\n      description: 'List discovered skills or invoke one by name.',\n      async execute(args, execution) {\n        const requested = args.trim();\n        if (requested) {\n          await execution.session.prompt(\n            expandDeferredSkillCommand(`${SKILL_INVOCATION_PREFIX}${requested}`, inventory.skills),\n          );\n          return;\n        }\n        await execution.client.notify({\n          title: 'Po skills',\n          body: catalog,\n          level: 'info',\n        });\n      },\n    },\n    ...groups.flatMap((group) => group.skills.map((skill) => skillCommand(skill, group.domain, inventory))),\n  ];\n}\n","import { readHarnessState } from '@agimon-ai/po-config/harnessState';\nimport type { PoHeadlessHostService } from '@agimon-ai/po-core/headless';\nimport { BACKGROUND_CONTEXT, getOrThrow, nodeHost, type FileSystem } from '@agimon-ai/po-core/platform';\nimport {\n  type PoServerResources,\n  type PoServerSessionPlugin,\n  packageResourcePath,\n  readPackageResource,\n} from '@agimon-ai/po-core/serverPlugin';\n\nimport { SKILL_INVENTORY_FRESH_MS } from '../../../../../constants/skillInventory';\nimport { mountMcpSkills } from '../../../../../services/mcpSkills';\nimport { createSessionLoadSkillTool } from '../../../../../services/mcpSkillTools';\nimport { discoverServerSkills } from '../../../../../services/serverInventory';\nimport { createSkillCommands } from './skillCommands';\n\nexport async function createSkillServer(\n  agent: PoHeadlessHostService,\n  fs: FileSystem,\n  signal: AbortSignal,\n  resources: PoServerResources,\n): Promise<PoServerSessionPlugin> {\n  const execution = agent.context;\n  // Sessions with the same inputs share one discovery. The key holds every input discoverServerSkills\n  // reads besides the disk, so equal keys give equal inventories, and the window bounds how old that\n  // read of the disk can be.\n  const key = [\n    'inventory',\n    execution.repoRoot,\n    execution.cwd,\n    execution.environment.HOME ?? nodeHost.homeDirectory(),\n    ...(readHarnessState(execution.environment).skillDirectories ?? []),\n    Math.floor(Date.now() / SKILL_INVENTORY_FRESH_MS),\n  ];\n  const { inventory, catalog, groups, mcpGroups, listed } = await resources.acquire(key, () =>\n    // Every session sharing the discovery waits on it, so none of their signals may abort it.\n    discoverServerSkills(execution, fs, new AbortController().signal),\n  );\n  return {\n    commands: createSkillCommands(inventory, catalog, groups),\n    tools: [createSessionLoadSkillTool(agent)],\n    services: [mountMcpSkills(mcpGroups, fs, signal)],\n    resources: [\n      // Each skill joins the prompt's one <available_skills> list, gated like the rest.\n      ...listed.flatMap((group) =>\n        group.skills.map((skill) => ({\n          name: skill.name,\n          description: skill.description,\n          path: skill.filePath,\n          kind: 'skill' as const,\n          ...(group.domain === undefined\n            ? {}\n            : { when: { domain: group.domain, attribution: { kind: 'domain' as const, mode: group.domain } } }),\n          read: async () => getOrThrow(await fs.readTextFile(skill.filePath, BACKGROUND_CONTEXT)),\n        })),\n      ),\n      ...[\n        {\n          name: 'po-author-skill',\n          description:\n            'Author and distribute Po agent skills. Use when creating a SKILL.md, contributing a runtime skill directory, or publishing activation-gated Help prompts and diagnostic tools.',\n        },\n        {\n          name: 'po-use-skill',\n          description:\n            \"Use Po's skill catalog and deferred discovery. Diagnose missing or shadowed skills and invoke the narrowest available guidance.\",\n        },\n      ].map((skill) => ({\n        ...skill,\n        when: { state: { 'minor-mode': 'help' }, attribution: { kind: 'minor' as const, mode: 'help' } },\n        kind: 'skill' as const,\n        path: packageResourcePath(import.meta.url, `src/prompts/${skill.name}/SKILL.md`),\n        read: () => readPackageResource(import.meta.url, `src/prompts/${skill.name}/SKILL.md`),\n      })),\n    ],\n  };\n}\n","import { defineRoot } from '@agimon-ai/po-core/extensionFile';\nimport { requirePoFs } from '@agimon-ai/po-core/platform';\nimport type { PoServerPluginContext, PoServerSessionPlugin } from '@agimon-ai/po-core/serverPlugin';\n\nimport { createSkillServer } from './_lib/skillServer';\n\nexport default defineRoot(async ({ agent, context: root, signal, resources }: PoServerPluginContext) => {\n  const runtime: PoServerSessionPlugin = agent\n    ? await createSkillServer(agent, requirePoFs(root), signal, resources)\n    : { commands: [], resources: [] };\n  return { value: runtime, services: runtime.services };\n});\n","import { defineRoutedContribution } from '@agimon-ai/po-core/extensionFile';\nimport type { WithRoot } from '@agimon-ai/po-core/extensionFile';\nimport type { PoServerPluginContext, PoServerSessionPlugin } from '@agimon-ai/po-core/serverPlugin';\n\nexport default defineRoutedContribution(\n  (context: WithRoot<PoServerPluginContext, PoServerSessionPlugin>) => context.root.commands!,\n  { cardinality: 'many' },\n);\n","import { defineRoutedContribution } from '@agimon-ai/po-core/extensionFile';\nimport type { WithRoot } from '@agimon-ai/po-core/extensionFile';\nimport type { PoServerPluginContext, PoServerSessionPlugin } from '@agimon-ai/po-core/serverPlugin';\n\nexport default defineRoutedContribution(\n  (context: WithRoot<PoServerPluginContext, PoServerSessionPlugin>) => context.root.resources!,\n  { cardinality: 'many' },\n);\n","import { defineRoutedContribution, type WithRoot } from '@agimon-ai/po-core/extensionFile';\nimport type { PoServerPluginContext, PoServerSessionPlugin } from '@agimon-ai/po-core/serverPlugin';\n\n/** The session agent's skill loader; the Pi CLI keeps Pi's own skill handling. */\nexport default defineRoutedContribution(\n  (context: WithRoot<PoServerPluginContext, PoServerSessionPlugin>) => context.root.tools?.[0],\n  { cardinality: 'optional' },\n);\n","// Generated by @agimon-ai/po-build. Do not edit by hand.\nimport { defineServerPlugin, type PoServerSessionPlugin } from '@agimon-ai/po-core/serverPlugin';\nimport { composeServerProviderOverrides } from '@agimon-ai/po-core/serverPlugin';\nimport { composeRootHooks, composeRootInjects } from '@agimon-ai/po-core/extensionFile';\n\nimport rootSession from '../src/extensions/workspaces/sessions/(backend)/root.server';\nimport commandSkills from '../src/extensions/workspaces/sessions/(backend)/command/skills.server';\nimport resourceSkills from '../src/extensions/workspaces/sessions/(backend)/resource/skills.server';\nimport toolLoadSkill from '../src/extensions/workspaces/sessions/(backend)/tool/load_skill.server';\n\ntype Factory<T, C> = (context: C) => T;\nconst at = <T, C>(value: T | Factory<T, C>, context: C): T =>\n  typeof value === 'function' ? (value as Factory<T, C>)(context) : value;\ntype ManyFactory<T, C> = (context: C) => T | readonly T[];\nconst many = <T, C>(value: T | readonly T[] | ManyFactory<T, C>, context: C): readonly T[] => {\n  const resolved = typeof value === 'function' ? (value as ManyFactory<T, C>)(context) : value;\n  return Array.isArray(resolved) ? resolved : [resolved as T];\n};\n/* v8 ignore next -- generated normalization branch */\nconst defined = <T>(values: readonly (T | undefined)[]): T[] =>\n  values.filter((value): value is T => value !== undefined);\nconst via = <T>(identity: Record<string, unknown>, value: unknown): T =>\n  (value === undefined ? undefined : { ...identity, ...(value as object) }) as T;\n\nexport const serverPlugin = defineServerPlugin({\n  name: '@agimon-ai/po-skill',\n  providerOverrides: composeServerProviderOverrides(rootSession),\n  injects: composeRootInjects({ session: [rootSession] }),\n  session: async (context) => {\n    const scopeSession = await context.scopeRoot('session', rootSession, context);\n    const contextSession = { ...context, root: scopeSession.value };\n    return {\n      ...composeRootHooks(scopeSession),\n      get commands(): PoServerSessionPlugin['commands'] { return [...many(commandSkills, contextSession)]; },\n      get resources(): PoServerSessionPlugin['resources'] { return [...many(resourceSkills, contextSession)]; },\n      get tools(): PoServerSessionPlugin['tools'] { return defined([via({ name: 'load_skill' }, at(toolLoadSkill, contextSession))]); },\n      services: [...(scopeSession.services ?? [])],\n      get activities(): PoServerSessionPlugin['activities'] { return [...(scopeSession.activities ?? [])]; },\n    };\n  },\n});\n\nexport default serverPlugin;\n"],"mappings":"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"}

package/dist/index.d.mts

@@ -1,3 +1,4 @@
+import { Skill } from "@earendil-works/pi-coding-agent";
 //#region src/types/skills.d.ts
 export declare const SKILLS_COMMAND = "skills";
 export declare const SKILL_INVOCATION_PREFIX = "/skill:";

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types/skills.ts"],"mappings":";qBAAa;qBACA;qBACA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types/skills.ts"],"mappings":";;qBAEa;qBACA;qBACA"}

package/dist/index.mjs

@@ -1,2 +1 @@
-import { n as SKILL_COMMAND_PREFIX, r as SKILL_INVOCATION_PREFIX, t as SKILLS_COMMAND } from "./skills-Ccvg1Hcz.mjs";
-export { SKILLS_COMMAND, SKILL_COMMAND_PREFIX, SKILL_INVOCATION_PREFIX };
+export { t as SKILLS_COMMAND, n as SKILL_COMMAND_PREFIX, r as SKILL_INVOCATION_PREFIX } from "./skills-Ccvg1Hcz.mjs";

package/dist/skills-Ccvg1Hcz.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"skills-Ccvg1Hcz.mjs","names":[],"sources":["../src/types/skills.ts"],"sourcesContent":["export const SKILLS_COMMAND = 'skills';\nexport const SKILL_INVOCATION_PREFIX = '/skill:';\nexport const SKILL_COMMAND_PREFIX = 'skill:';\n"],"mappings":";AAAA,MAAa,iBAAiB;AAC9B,MAAa,0BAA0B;AACvC,MAAa,uBAAuB"}
+{"version":3,"file":"skills-Ccvg1Hcz.mjs","names":[],"sources":["../src/types/skills.ts"],"sourcesContent":["import type { Skill } from '@earendil-works/pi-coding-agent';\n\nexport const SKILLS_COMMAND = 'skills';\nexport const SKILL_INVOCATION_PREFIX = '/skill:';\nexport const SKILL_COMMAND_PREFIX = 'skill:';\n\nexport interface DeferredSkillSnapshot {\n  skills: Skill[];\n  diagnostics: string[];\n}\n\nexport interface DeferredSkillLoaderOptions {\n  cwd: string;\n  skillPaths: readonly string[];\n  agentDir?: string;\n  piModuleUrl?: string;\n  schedule?: (load: () => void) => void;\n  load?: (options: { cwd: string; agentDir: string; skillPaths: string[]; includeDefaults: boolean }) => {\n    skills: Skill[];\n    diagnostics: Array<{ path?: string; message: string }>;\n  };\n}\n\n/** Skills and the domain whose selection activates them, or always-on when absent. */\nexport interface ServerSkillGroup {\n  readonly domain?: string;\n  readonly skills: readonly Skill[];\n}\n\nexport interface ServerSkillInventory {\n  /** Every skill any selection can reach, so an activated command can still expand. */\n  readonly inventory: DeferredSkillSnapshot;\n  readonly groups: readonly ServerSkillGroup[];\n  readonly mcpGroups: readonly ServerSkillGroup[];\n  /**\n   * The shared and repository skills this package advertises itself. Domain plugin skills are\n   * left out: po-domain already contributes each one, and listing them twice was noise.\n   */\n  readonly listed: readonly ServerSkillGroup[];\n  readonly catalog: string;\n}\n"],"mappings":";AAEA,MAAa,iBAAiB;AAC9B,MAAa,0BAA0B;AACvC,MAAa,uBAAuB"}

package/dist/skills-ComtgYb1.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"skills-ComtgYb1.cjs","names":[],"sources":["../src/types/skills.ts"],"sourcesContent":["export const SKILLS_COMMAND = 'skills';\nexport const SKILL_INVOCATION_PREFIX = '/skill:';\nexport const SKILL_COMMAND_PREFIX = 'skill:';\n"],"mappings":";AAAA,MAAa,iBAAiB;AAC9B,MAAa,0BAA0B;AACvC,MAAa,uBAAuB"}
+{"version":3,"file":"skills-ComtgYb1.cjs","names":[],"sources":["../src/types/skills.ts"],"sourcesContent":["import type { Skill } from '@earendil-works/pi-coding-agent';\n\nexport const SKILLS_COMMAND = 'skills';\nexport const SKILL_INVOCATION_PREFIX = '/skill:';\nexport const SKILL_COMMAND_PREFIX = 'skill:';\n\nexport interface DeferredSkillSnapshot {\n  skills: Skill[];\n  diagnostics: string[];\n}\n\nexport interface DeferredSkillLoaderOptions {\n  cwd: string;\n  skillPaths: readonly string[];\n  agentDir?: string;\n  piModuleUrl?: string;\n  schedule?: (load: () => void) => void;\n  load?: (options: { cwd: string; agentDir: string; skillPaths: string[]; includeDefaults: boolean }) => {\n    skills: Skill[];\n    diagnostics: Array<{ path?: string; message: string }>;\n  };\n}\n\n/** Skills and the domain whose selection activates them, or always-on when absent. */\nexport interface ServerSkillGroup {\n  readonly domain?: string;\n  readonly skills: readonly Skill[];\n}\n\nexport interface ServerSkillInventory {\n  /** Every skill any selection can reach, so an activated command can still expand. */\n  readonly inventory: DeferredSkillSnapshot;\n  readonly groups: readonly ServerSkillGroup[];\n  readonly mcpGroups: readonly ServerSkillGroup[];\n  /**\n   * The shared and repository skills this package advertises itself. Domain plugin skills are\n   * left out: po-domain already contributes each one, and listing them twice was noise.\n   */\n  readonly listed: readonly ServerSkillGroup[];\n  readonly catalog: string;\n}\n"],"mappings":";AAEA,MAAa,iBAAiB;AAC9B,MAAa,0BAA0B;AACvC,MAAa,uBAAuB"}

package/llms.txt

@@ -1,4 +1,4 @@
-# Doom Pi Skill
+# Po Pi Skill
 
 The session skill catalogue, deferred skill discovery, and the `SPC e s` browser.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agimon-ai/po-skill",
-  "version": "0.0.0-alpha.2",
+  "version": "0.0.0-alpha.21",
   "description": "Session skill catalogue, deferred skill discovery, and the skill browser for Po.",
   "keywords": [
     "agent-skills",
@@ -18,7 +18,7 @@
   "bugs": {
     "url": "https://github.com/AgiFlow/po/issues"
   },
-  "license": "MIT",
+  "license": "BUSL-1.1",
   "author": "Vuong Ngo",
   "repository": {
     "type": "git",
@@ -65,30 +65,30 @@
     "access": "public"
   },
   "dependencies": {
-    "@agimon-ai/po-config": "0.0.0-alpha.2",
-    "@agimon-ai/po-core": "0.0.0-alpha.2",
-    "@agimon-ai/po-domain": "0.0.0-alpha.2",
-    "@agimon-ai/po-telemetry": "0.0.0-alpha.2",
-    "@agimon-ai/po-web-components": "0.0.0-alpha.2",
-    "@deepseek-ai/cordis": "4.0.4",
+    "@agimon-ai/po-config": "0.0.0-alpha.21",
+    "@agimon-ai/po-core": "0.0.0-alpha.21",
+    "@agimon-ai/po-domain": "0.0.0-alpha.21",
+    "@agimon-ai/po-telemetry": "0.0.0-alpha.21",
+    "@agimon-ai/po-web-components": "0.0.0-alpha.21",
+    "@deepseek-ai/cordis": "4.0.5",
     "gpt-tokenizer": "4.0.0",
-    "typebox": "1.3.34"
+    "typebox": "1.3.37"
   },
   "devDependencies": {
-    "@agimon-ai/po-build": "0.0.0-alpha.2",
-    "@agimon-ai/vibe-lint-plugin-doom-extension": "0.0.0-alpha.2",
-    "@deepseek-ai/cordis": "4.0.4",
-    "@earendil-works/pi-coding-agent": "1.2.0",
-    "@types/node": "26.6.4",
+    "@agimon-ai/po-build": "0.0.0-alpha.21",
+    "@agimon-ai/vibe-lint-plugin-po-extension": "0.0.0-alpha.21",
+    "@deepseek-ai/cordis": "4.0.5",
+    "@earendil-works/pi-coding-agent": "1.3.0",
+    "@types/node": "26.6.5",
     "@types/react": "19.3.0",
-    "@vitest/coverage-v8": "5.0.3",
+    "@vitest/coverage-v8": "5.0.4",
     "react": "19.3.0",
-    "tsdown": "0.23.0",
+    "tsdown": "0.23.1",
     "typescript": "7.0.2",
-    "vitest": "5.0.3"
+    "vitest": "5.0.4"
   },
   "peerDependencies": {
-    "@earendil-works/pi-coding-agent": "1.2.0"
+    "@earendil-works/pi-coding-agent": "1.3.0"
   },
   "peerDependenciesMeta": {
     "@earendil-works/pi-coding-agent": {

package/src/prompts/po-author-skill/SKILL.md

@@ -22,13 +22,13 @@ The frontmatter `name` must match the directory. Make the description specific e
 
 ## Choose the distribution path
 
-- For a normal Pi skill that should be discoverable whenever its owning extension is active, ship the skill under a package-owned runtime directory such as `skills/<name>/SKILL.md`. Register that directory through `DOOM_SKILL_SOURCES_SERVICE` inside an owning `cordis.inject(...)`, and return the contribution disposer.
-- For guidance that should appear only while Po Help is active, put it at `src/prompts/<name>/SKILL.md`, publish `src/prompts`, link it from the package's H1-led `llms.txt`, and register a Help descriptor through `DOOM_HELP_SERVICE`.
+- For a normal Pi skill that should be discoverable whenever its owning extension is active, ship the skill under a package-owned runtime directory such as `skills/<name>/SKILL.md`. Register that directory through `PO_SKILL_SOURCES_SERVICE` inside an owning `cordis.inject(...)`, and return the contribution disposer.
+- For guidance that should appear only while Po Help is active, put it at `src/prompts/<name>/SKILL.md`, publish `src/prompts`, link it from the package's H1-led `llms.txt`, and register a Help descriptor through `PO_HELP_SERVICE`.
 - For repository content selected by domains, place the skill in the plugin or shared skill source configured by `domains.yaml`; do not hard-code that directory into the Skill package.
 
 Pi Help descriptors carry only `name` and `description`. The Help service resolves the owning package from the contribution's exact package `source` and `moduleUrl`, then wraps its `llms.txt`. Keep every index link inside the published package.
 
-On the server host, contribute the same Help skill through a named `resource/*.server.ts` route with `when: DOOM_HELP_WHEN` from `@agimon-ai/po-core/help`. Include its useful description and an absolute `path` resolved with `packageResourcePath(import.meta.url, ...)`; a reader alone does not make the skill discoverable in the agent prompt. Keep ordinary runtime skills under their existing conditions.
+On the server host, contribute the same Help skill through a named `resource/*.server.ts` route with `when: PO_HELP_WHEN` from `@agimon-ai/po-core/help`. Include its useful description and an absolute `path` resolved with `packageResourcePath(import.meta.url, ...)`; a reader alone does not make the skill discoverable in the agent prompt. Keep ordinary runtime skills under their existing conditions.
 
 Package-owned Help tools use ordinary named tool routes, not documentation descriptors. Server tools use the existing Help condition and execution guards. Pi tools also need `createPiHelpToolGate(packageName, toolNames)`: install its services and onStart in the owning root, then authorize each invocation with `gate.assertActive`. Portable `when` metadata alone does not enforce the Pi gate. The Help README and Log package's `diagnose_agent` contribution show the complete pattern. Bound diagnostics to the current session, omit secrets, and use existing approval mechanisms for repairs.