@agimon-ai/po-help 0.0.0-alpha.41 → 0.0.0-alpha.43

package/dist/extensions/server.cjs

@@ -5,6 +5,7 @@ Object.defineProperties(exports, {
 let _agimon_ai_po_core_help = require("@agimon-ai/po-core/help");
 let _agimon_ai_po_core_serverPlugin = require("@agimon-ai/po-core/serverPlugin");
 let _agimon_ai_po_core_extensionFile = require("@agimon-ai/po-core/extensionFile");
+let _agimon_ai_po_core_codemode = require("@agimon-ai/po-core/codemode");
 let _agimon_ai_po_minor_mode = require("@agimon-ai/po-minor-mode");
 let typebox = require("typebox");
 //#region src/constants/help.ts
@@ -31,12 +32,17 @@ const HELP_NATIVE_SKILL = {
 	name: "help-how-to-native-extension",
 	description: "Add or change a Po package's phone UI (.native files, native templates) so it mirrors the cockpit, passes the native build, and is approved and verified before it ships."
 };
+const HELP_SELF_IMPROVE_SKILL = {
+	name: "codemode-how-to-self-improve",
+	description: "Reload Po's own packages after you edit them, without restarting Po or reopening the session. Use in Help mode after changing a plugin's source or build, or after adding or removing a package."
+};
 //#endregion
 //#region src/schemas/diagnostics.ts
 const helpStatusParameters = typebox.Type.Object({}, { additionalProperties: false });
 //#endregion
 //#region src/services/helpStatus/index.ts
-function serverHelpStatus(snapshot, enabled) {
+/** `packageFailures`: the host's failed global and workspace packages; they never degrade Help itself. */
+function serverHelpStatus(snapshot, enabled, packageFailures = []) {
 	const entries = snapshot.capabilities.filter((entry) => entry.when?.state?.["minor-mode"] === HELP_MODE_ID);
 	const skills = entries.filter((entry) => entry.kind === "skill");
 	const tools = entries.filter((entry) => entry.kind === "tool");
@@ -66,7 +72,8 @@ function serverHelpStatus(snapshot, enabled) {
 			...reason ? { reason } : {}
 		})),
 		diagnostics: diagnostics.slice(0, 128),
-		truncated: skills.length > 128 || tools.length > 128 || diagnostics.length > 128
+		packages: enabled ? packageFailures.slice(-128) : [],
+		truncated: skills.length > 128 || tools.length > 128 || diagnostics.length > 128 || enabled && packageFailures.length > 128
 	};
 }
 function helpStatusDetail(report) {
@@ -95,15 +102,133 @@ function createHelpStatusTool(inspect, authorize) {
 	});
 }
 //#endregion
+//#region src/services/selfImproveNamespace/index.ts
+/** Finished operations kept for `operation(id)`; older ones are forgotten first. */
+const MAX_OPERATIONS = 20;
+const SCOPES = [
+	"session",
+	"workspace",
+	"global"
+];
+const AXES = [
+	"majorMode",
+	"domains",
+	"profile"
+];
+const DECLARATIONS = `type Scope = 'session' | 'workspace' | 'global';
+type Axis = 'majorMode' | 'domains' | 'profile';
+interface PackageFailure { scope: string; packageName: string; stage: string; reason: string; previous?: 'restored' | 'lost' | 'none'; at: string }
+interface Operation {
+  operationId: string; scope: Scope; axes?: Axis[];
+  /** partial: applied, but some packages failed and keep their previous build when they had one. */
+  state: 'queued' | 'applied' | 'partial' | 'failed';
+  result?: { installed: string[]; removed: string[]; failed: { packageName: string; reason: string }[] };
+  error?: string;
+}
+declare const selfImprove: {
+  /** Packages whose current build failed to load or install, by scope. */
+  plugins(): Promise<{ failures: PackageFailure[] }>;
+  /** Queues a reload of one scope's packages from disk; check it with operation() in a later exec. global needs confirm: true, after the person agreed. */
+  reload(input: { scope: Scope; confirm?: boolean }): Promise<Operation>;
+  /** Queues a re-apply of this session's current major mode, domains or profile (default: all three) after editing their config; check it with operation(). */
+  refresh(input?: { axes?: Axis[] }): Promise<Operation>;
+  operation(operationId: string): Promise<Operation>;
+};`;
+function createSelfImproveNamespace(options) {
+	const operations = /* @__PURE__ */ new Map();
+	let next = 0;
+	const remember = (operation) => {
+		operations.set(operation.operationId, operation);
+		for (const id of operations.keys()) {
+			if (operations.size <= MAX_OPERATIONS) break;
+			if (operations.get(id)?.state !== "queued") operations.delete(id);
+		}
+		return operation;
+	};
+	return {
+		name: "selfImprove",
+		summary: "Reload Po's own packages after editing them, or refresh this session's mode, domains and profile config, without restarting. Help mode, main agent only.",
+		declarations: DECLARATIONS,
+		bind(run) {
+			if (run.sessionId !== options.sessionId) throw new Error("The selfImprove namespace belongs to another session.");
+			const check = () => {
+				run.signal.throwIfAborted();
+				options.assertActive();
+				if (run.caller !== "main") throw new Error("Only the main agent may reload or refresh Po.");
+			};
+			return {
+				plugins: async () => {
+					check();
+					return { failures: JSON.parse(JSON.stringify(options.failures())) };
+				},
+				reload: async (input) => {
+					check();
+					const { scope, confirm } = input ?? {};
+					if (!SCOPES.includes(scope)) throw new Error("reload needs scope 'session', 'workspace' or 'global'.");
+					if (scope === "global" && confirm !== true) throw new Error("A global reload changes every session; ask the person, then pass confirm: true.");
+					const operationId = `reload-${String(++next)}`;
+					const queued = remember({
+						operationId,
+						scope,
+						state: "queued"
+					});
+					options.service.reload({
+						scope: queued.scope,
+						sessionId: options.sessionId
+					}).then((result) => remember({
+						...queued,
+						state: result.failed.length === 0 ? "applied" : "partial",
+						result: JSON.parse(JSON.stringify(result))
+					}), (error) => remember({
+						...queued,
+						state: "failed",
+						error: error instanceof Error ? error.message : String(error)
+					}));
+					return { ...queued };
+				},
+				refresh: async (input) => {
+					check();
+					const { axes = AXES } = input ?? {};
+					if (!Array.isArray(axes) || axes.length === 0 || !axes.every((axis) => AXES.includes(axis))) throw new Error("refresh axes are 'majorMode', 'domains' and 'profile'.");
+					const queued = remember({
+						operationId: `refresh-${String(++next)}`,
+						scope: "session",
+						axes: [...new Set(axes)],
+						state: "queued"
+					});
+					options.service.refresh({
+						sessionId: options.sessionId,
+						axes: queued.axes
+					}).then(() => remember({
+						...queued,
+						state: "applied"
+					}), (error) => remember({
+						...queued,
+						state: "failed",
+						error: error instanceof Error ? error.message : String(error)
+					}));
+					return JSON.parse(JSON.stringify(queued));
+				},
+				operation: async (operationId) => {
+					check();
+					const operation = typeof operationId === "string" ? operations.get(operationId) : void 0;
+					if (operation === void 0) throw new Error(`No operation '${String(operationId)}'.`);
+					return JSON.parse(JSON.stringify(operation));
+				}
+			};
+		}
+	};
+}
+//#endregion
 //#region src/services/helpServerSession/index.ts
-function createHelpServerSession(host) {
+function createHelpServerSession(host, packageFailures = () => [], selfImprove) {
 	let modeOwner;
 	let pending;
 	let failure;
 	let generation = 0;
 	let disposed = false;
 	const active = () => (host.context.selection.state?.["minor-mode"] ?? []).includes(HELP_MODE_ID);
-	const inspect = () => serverHelpStatus(host.inspectCapabilities(), active());
+	const inspect = () => serverHelpStatus(host.inspectCapabilities(), active(), packageFailures());
 	const modeState = () => {
 		const report = inspect();
 		return {
@@ -171,7 +296,15 @@ function createHelpServerSession(host) {
 				if (!text.trim()) throw new Error("The installed code-mode plugin skill is missing or unreadable.");
 				return text;
 			}
-		}
+		},
+		...selfImprove === void 0 ? [] : [{
+			when: _agimon_ai_po_core_help.PO_HELP_WHEN,
+			...HELP_SELF_IMPROVE_SKILL,
+			kind: "skill",
+			pinned: true,
+			path: (0, _agimon_ai_po_core_serverPlugin.packageResourcePath)(require("url").pathToFileURL(__filename).href, "src/prompts/codemode-how-to-self-improve/SKILL.md"),
+			read: () => (0, _agimon_ai_po_core_serverPlugin.readPackageResource)(require("url").pathToFileURL(__filename).href, "src/prompts/codemode-how-to-self-improve/SKILL.md")
+		}]
 	];
 	const selectMode = async (enabled, signal) => {
 		if (disposed) throw new Error("Help runtime is disposed.");
@@ -240,8 +373,33 @@ function createHelpServerSession(host) {
 			return { message: active() ? "Help mode activated." : "Help mode deactivated." };
 		}
 	}).createOwner(void 0);
+	const assertHelpActive = () => {
+		host.assertActive(HELP_PACKAGE_SOURCE);
+		if (disposed || !active()) throw new Error("Help mode is not active.");
+	};
+	const selfImproveService = (cordis) => {
+		cordis.inject([_agimon_ai_po_core_codemode.PO_CODEMODE_SERVICE], (scoped) => {
+			const codemode = (0, _agimon_ai_po_core_codemode.readPoCodemode)(scoped);
+			if (!codemode || !selfImprove) return void 0;
+			const namespace = createSelfImproveNamespace({
+				sessionId: host.context.sessionId,
+				service: selfImprove,
+				failures: packageFailures,
+				assertActive: assertHelpActive
+			});
+			const activity = host.registerActivity({
+				when: _agimon_ai_po_core_help.PO_HELP_WHEN,
+				name: "selfImprove",
+				start: () => {
+					const registration = codemode.register(HELP_PACKAGE_SOURCE, namespace);
+					return () => registration.dispose();
+				}
+			});
+			return () => activity.dispose();
+		});
+	};
 	return {
-		services: [(0, _agimon_ai_po_minor_mode.serverMinorModes)([modeOwner])],
+		services: [(0, _agimon_ai_po_minor_mode.serverMinorModes)([modeOwner]), ...selfImprove ? [selfImproveService] : []],
 		resources,
 		commands: [command],
 		tools: [createHelpStatusTool(inspect, (signal) => {
@@ -258,7 +416,7 @@ function createHelpServerSession(host) {
 }
 //#endregion
 //#region src/extensions/workspaces/sessions/(backend)/_lib/runtime.server.ts
-var runtime_server_default = (({ agent }) => agent ? createHelpServerSession(agent) : {});
+var runtime_server_default = (({ agent, context }) => agent ? createHelpServerSession(agent, () => (0, _agimon_ai_po_core_help.readPoPackageHealth)(context)?.failures() ?? [], (0, _agimon_ai_po_core_help.readPoSelfImprove)(context)) : {});
 //#endregion
 //#region src/extensions/workspaces/sessions/(backend)/root.server.ts
 var root_server_default = (0, _agimon_ai_po_core_extensionFile.defineRoot)((context) => {
@@ -276,6 +434,9 @@ var root_server_default = (0, _agimon_ai_po_core_extensionFile.defineRoot)((cont
 //#region src/extensions/workspaces/sessions/(backend)/command/po-help.server.ts
 var po_help_server_default$1 = (0, _agimon_ai_po_core_extensionFile.defineRoutedContribution)((context) => context.root.commands?.[0], { cardinality: "optional" });
 //#endregion
+//#region src/extensions/workspaces/sessions/(backend)/resource/codemode-how-to-self-improve.server.ts
+var codemode_how_to_self_improve_server_default = (0, _agimon_ai_po_core_extensionFile.defineRoutedContribution)((context) => context.root.resources?.[5], { cardinality: "optional" });
+//#endregion
 //#region src/extensions/workspaces/sessions/(backend)/resource/po-develop-codemode-plugin.server.ts
 var po_develop_codemode_plugin_server_default = (0, _agimon_ai_po_core_extensionFile.defineRoutedContribution)((context) => context.root.resources?.[4], { cardinality: "optional" });
 //#endregion
@@ -319,6 +480,7 @@ const serverPlugin = (0, _agimon_ai_po_core_serverPlugin.defineServerPlugin)({
 			},
 			get resources() {
 				return defined([
+					at(codemode_how_to_self_improve_server_default, contextSession),
 					at(po_develop_codemode_plugin_server_default, contextSession),
 					at(po_develop_native_extension_server_default, contextSession),
 					at(po_help_server_default, contextSession),

package/dist/extensions/server.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"server.cjs","names":["Type","defineTool","HELP_WHEN","HELP_WHEN","packageResourcePath","readPackageResource","defineMinorMode","serverMinorModes","defineRoot","runtime","defineRoutedContribution","defineRoutedContribution","defineRoutedContribution","defineRoutedContribution","defineRoutedContribution","defineRoutedContribution","defineRoutedContribution","defineServerPlugin","composeServerProviderOverrides","rootSession","composeRootInjects","composeRootHooks","commandPoHelp","resourcePoDevelopCodemodePlugin","resourcePoDevelopNativeExtension","resourcePoHelp","resourcePoUseChatgptInstructions","resourcePoUseHelp","toolHelpStatus"],"sources":["../../src/constants/help.ts","../../src/schemas/diagnostics.ts","../../src/services/helpStatus/index.ts","../../src/services/helpServerSession/index.ts","../../src/extensions/workspaces/sessions/(backend)/_lib/runtime.server.ts","../../src/extensions/workspaces/sessions/(backend)/root.server.ts","../../src/extensions/workspaces/sessions/(backend)/command/po-help.server.ts","../../src/extensions/workspaces/sessions/(backend)/resource/po-develop-codemode-plugin.server.ts","../../src/extensions/workspaces/sessions/(backend)/resource/po-develop-native-extension.server.ts","../../src/extensions/workspaces/sessions/(backend)/resource/po-help.server.ts","../../src/extensions/workspaces/sessions/(backend)/resource/po-use-chatgpt-instructions.server.ts","../../src/extensions/workspaces/sessions/(backend)/resource/po-use-help.server.ts","../../src/extensions/workspaces/sessions/(backend)/tool/help_status.server.ts","../../generated/server.ts"],"sourcesContent":["export const HELP_COMMAND_NAME = 'po-help';\nexport const HELP_COMMAND_DESCRIPTION = 'Toggle Help guidance and read-only support diagnostics';\nexport const HELP_MODE_ID = 'help';\nexport const HELP_PACKAGE_SOURCE = '@agimon-ai/po-help';\nexport const HELP_SKILL = {\n  name: 'help-how-to-help',\n  description:\n    'Set up and debug Po agents using installed package guidance and scoped, read-only diagnostics. Diagnose missing capabilities before proposing authorized repairs.',\n} as const;\nexport const HELP_GUIDANCE =\n  'Help mode is active. Read help-how-to-help, inspect the available diagnostics, and use the narrowest package guidance for the task. Diagnose before proposing changes. Help does not grant additional permissions.';\nexport const HELP_STATUS_TOOL_NAME = 'help_status';\nexport const HELP_STATUS_TOOL_DESCRIPTION =\n  'Inspect active Help skills, diagnostic tools, contributor ownership, and unavailable contributions in this session. Read-only; does not change selection or permissions.';\nexport const HELP_STATUS_LIMIT = 128;\n\nexport const HELP_CHATGPT_SKILL = {\n  name: 'help-how-to-chatgpt-instructions',\n  description:\n    \"Print a paste-ready ChatGPT project instruction (at most 8,000 characters) that routes code-mode work through this session's MCP tools and condenses every AGENTS.md rule. Writes no files.\",\n} as const;\n\nexport const HELP_CODEMODE_SKILL = {\n  name: 'help-how-to-codemode-plugin',\n  description:\n    'Add code-mode support to a Po package: contribute a namespace to exec and discover, replace the direct tool it supersedes, and ship the skill that teaches agents to use it.',\n} as const;\n\nexport const HELP_NATIVE_SKILL = {\n  name: 'help-how-to-native-extension',\n  description:\n    \"Add or change a Po package's phone UI (.native files, native templates) so it mirrors the cockpit, passes the native build, and is approved and verified before it ships.\",\n} as const;\n","import { Type } from 'typebox';\n\nexport const helpStatusParameters = Type.Object({}, { additionalProperties: false });\n","import type { PoHeadlessCapabilitySnapshot } from '@agimon-ai/po-core/headless';\nimport { PO_HELP_WHEN as HELP_WHEN } from '@agimon-ai/po-core/help';\nimport { defineTool } from '@agimon-ai/po-core/serverPlugin';\n\nimport {\n  HELP_GUIDANCE,\n  HELP_MODE_ID,\n  HELP_STATUS_LIMIT,\n  HELP_STATUS_TOOL_DESCRIPTION,\n  HELP_STATUS_TOOL_NAME,\n} from '../../constants/help';\nimport { helpStatusParameters } from '../../schemas/diagnostics';\nimport type { HelpStatusReport } from './type';\n\nexport function serverHelpStatus(snapshot: PoHeadlessCapabilitySnapshot, enabled: boolean): HelpStatusReport {\n  const entries = snapshot.capabilities.filter((entry) => entry.when?.state?.['minor-mode'] === HELP_MODE_ID);\n  const skills = entries.filter((entry) => entry.kind === 'skill');\n  const tools = entries.filter((entry) => entry.kind === 'tool');\n  const diagnostics = entries\n    .filter((entry) => enabled && entry.reason && entry.reason !== 'inactive')\n    .map((entry) => ({ source: entry.source, code: `HELP_${entry.reason!.replaceAll('-', '_').toUpperCase()}` }));\n  const ready = snapshot.ready;\n  return {\n    activation: !enabled ? 'inactive' : !ready ? 'activating' : diagnostics.length ? 'degraded' : 'active',\n    ready,\n    revision: snapshot.revision,\n    counts: {\n      skills: ready ? skills.filter((entry) => entry.active && entry.discoverable).length : null,\n      tools: tools.filter((entry) => entry.active).length,\n    },\n    skills: skills.slice(0, HELP_STATUS_LIMIT).map(({ name, source, active, discoverable, reason }) => ({\n      name,\n      source,\n      active: active && discoverable,\n      ...(reason ? { reason } : {}),\n    })),\n    tools: tools\n      .slice(0, HELP_STATUS_LIMIT)\n      .map(({ name, source, active, reason }) => ({ name, source, active, ...(reason ? { reason } : {}) })),\n    diagnostics: diagnostics.slice(0, HELP_STATUS_LIMIT),\n    truncated:\n      skills.length > HELP_STATUS_LIMIT || tools.length > HELP_STATUS_LIMIT || diagnostics.length > HELP_STATUS_LIMIT,\n  };\n}\n\nexport function helpStatusDetail(report: HelpStatusReport): string {\n  return `${report.counts.skills ?? 'pending'} Help skills, ${report.counts.tools} diagnostic tools${report.diagnostics.length ? ' (diagnostics available)' : ''}`;\n}\n\nexport function createHelpStatusTool(\n  inspect: () => HelpStatusReport | Promise<HelpStatusReport>,\n  authorize: (signal?: AbortSignal) => AbortSignal,\n) {\n  return defineTool({\n    name: HELP_STATUS_TOOL_NAME,\n    description: HELP_STATUS_TOOL_DESCRIPTION,\n    parameters: helpStatusParameters,\n    when: HELP_WHEN,\n    promptGuidelines: [HELP_GUIDANCE],\n    async execute(_input, execution) {\n      const signal = authorize(execution.signal);\n      const report = await inspect();\n      signal.throwIfAborted();\n      authorize(execution.signal);\n      return { content: [{ type: 'text', text: JSON.stringify(report, null, 2) }], details: report };\n    },\n  });\n}\n","import type { PoHeadlessCommand, PoHeadlessHostService, PoHeadlessResource } from '@agimon-ai/po-core/headless';\nimport { PO_HELP_WHEN as HELP_WHEN } from '@agimon-ai/po-core/help';\nimport { type PoServerSessionPlugin, packageResourcePath, readPackageResource } from '@agimon-ai/po-core/serverPlugin';\nimport { defineMinorMode, serverMinorModes, type MinorModeOwner, type MinorModeState } from '@agimon-ai/po-minor-mode';\n\nimport {\n  HELP_COMMAND_DESCRIPTION,\n  HELP_COMMAND_NAME,\n  HELP_GUIDANCE,\n  HELP_MODE_ID,\n  HELP_PACKAGE_SOURCE,\n  HELP_CHATGPT_SKILL,\n  HELP_CODEMODE_SKILL,\n  HELP_NATIVE_SKILL,\n  HELP_SKILL,\n} from '../../constants/help';\nimport { createHelpStatusTool, helpStatusDetail, serverHelpStatus } from '../helpStatus';\nexport function createHelpServerSession(host: PoHeadlessHostService): PoServerSessionPlugin {\n  let modeOwner: MinorModeOwner | undefined;\n  let pending: boolean | undefined;\n  let failure: string | undefined;\n  let generation = 0;\n  let disposed = false;\n  const active = () => (host.context.selection.state?.['minor-mode'] ?? []).includes(HELP_MODE_ID);\n  const inspect = () => serverHelpStatus(host.inspectCapabilities(), active());\n  const modeState = (): MinorModeState => {\n    const report = inspect();\n    return {\n      activation: pending === true ? 'activating' : active() ? 'active' : 'inactive',\n      condition:\n        pending !== undefined || !report.ready\n          ? 'queued'\n          : failure\n            ? 'failed'\n            : report.activation === 'degraded'\n              ? 'degraded'\n              : 'ready',\n      ...(pending !== undefined\n        ? { detail: 'applying Help capabilities' }\n        : failure\n          ? { detail: failure }\n          : active()\n            ? { detail: helpStatusDetail(report) }\n            : {}),\n      actions: [\n        {\n          id: 'activate',\n          enabled: !active() && pending === undefined,\n          ...(!active() && pending === undefined ? {} : { disabledReason: 'Help is active or changing.' }),\n        },\n        {\n          id: 'deactivate',\n          enabled: active() || pending === true,\n          ...(active() || pending === true ? {} : { disabledReason: 'Help mode is not active.' }),\n        },\n      ],\n    };\n  };\n  const resources: PoHeadlessResource[] = [\n    { when: HELP_WHEN, name: 'po-help', kind: 'context', read: () => HELP_GUIDANCE },\n    {\n      when: HELP_WHEN,\n      ...HELP_SKILL,\n      kind: 'skill',\n      path: packageResourcePath(import.meta.url, 'src/prompts/help-how-to-help/SKILL.md'),\n      read: async () => {\n        const text = await readPackageResource(import.meta.url, 'src/prompts/help-how-to-help/SKILL.md');\n        if (!text.trim()) throw new Error('The installed Help skill is missing or unreadable.');\n        return text;\n      },\n    },\n    {\n      when: HELP_WHEN,\n      ...HELP_CHATGPT_SKILL,\n      kind: 'skill',\n      path: packageResourcePath(import.meta.url, 'src/prompts/help-how-to-chatgpt-instructions/SKILL.md'),\n      read: async () => {\n        const text = await readPackageResource(\n          import.meta.url,\n          'src/prompts/help-how-to-chatgpt-instructions/SKILL.md',\n        );\n        if (!text.trim()) throw new Error('The installed ChatGPT instruction skill is missing or unreadable.');\n        return text;\n      },\n    },\n    {\n      when: HELP_WHEN,\n      ...HELP_NATIVE_SKILL,\n      kind: 'skill',\n      path: packageResourcePath(import.meta.url, 'src/prompts/help-how-to-native-extension/SKILL.md'),\n      read: async () => {\n        const text = await readPackageResource(import.meta.url, 'src/prompts/help-how-to-native-extension/SKILL.md');\n        if (!text.trim()) throw new Error('The installed native extension skill is missing or unreadable.');\n        return text;\n      },\n    },\n    {\n      when: HELP_WHEN,\n      ...HELP_CODEMODE_SKILL,\n      kind: 'skill',\n      path: packageResourcePath(import.meta.url, 'src/prompts/help-how-to-codemode-plugin/SKILL.md'),\n      read: async () => {\n        const text = await readPackageResource(import.meta.url, 'src/prompts/help-how-to-codemode-plugin/SKILL.md');\n        if (!text.trim()) throw new Error('The installed code-mode plugin skill is missing or unreadable.');\n        return text;\n      },\n    },\n  ];\n  const selectMode = async (enabled: boolean, signal?: AbortSignal): Promise<void> => {\n    if (disposed) throw new Error('Help runtime is disposed.');\n    signal?.throwIfAborted();\n    const operation = ++generation;\n    pending = enabled;\n    failure = undefined;\n    modeOwner?.publish();\n    try {\n      if (enabled) await resources[1]!.read(host.context);\n      signal?.throwIfAborted();\n      if (operation !== generation || disposed) throw new Error('Help activation was cancelled.');\n      const modes = (host.context.selection.state?.['minor-mode'] ?? []).filter((mode) => mode !== HELP_MODE_ID);\n      await host.changeSelection({\n        axis: 'state',\n        key: 'minor-mode',\n        values: enabled ? [...modes, HELP_MODE_ID] : modes,\n      });\n    } catch (error) {\n      if (operation === generation) failure = (error instanceof Error ? error.message : String(error)).slice(0, 160);\n      throw error;\n    } finally {\n      if (operation === generation) {\n        pending = undefined;\n        modeOwner?.publish();\n      }\n    }\n  };\n  const command: PoHeadlessCommand = {\n    name: HELP_COMMAND_NAME,\n    description: HELP_COMMAND_DESCRIPTION,\n    async execute(_args, execution) {\n      await selectMode(!(pending ?? active()));\n      await execution.client.notify({\n        title: 'Po Help',\n        body: active() ? 'Help mode activated.' : 'Help mode deactivated.',\n        level: 'info',\n      });\n    },\n  };\n  modeOwner = defineMinorMode({\n    descriptor: {\n      source: HELP_PACKAGE_SOURCE,\n      id: HELP_MODE_ID,\n      label: 'Help',\n      description: 'Package guidance and read-only diagnostics for agent setup and debugging.',\n      order: 50,\n      actions: [\n        {\n          id: 'activate',\n          label: 'Activate',\n          description: 'Expose Help guidance and diagnostic tools.',\n          contexts: ['headless'],\n          parameters: [],\n        },\n        {\n          id: 'deactivate',\n          label: 'Deactivate',\n          description: 'Withdraw Help-only guidance and diagnostic tools.',\n          contexts: ['headless'],\n          parameters: [],\n        },\n      ],\n    },\n    state: modeState,\n    async handleAction(_runtime, actionId, _argumentsValue, { signal }) {\n      if (actionId !== 'activate' && actionId !== 'deactivate')\n        throw new Error(`Unknown Help mode action: ${actionId}`);\n      await selectMode(actionId === 'activate', signal);\n      return { message: active() ? 'Help mode activated.' : 'Help mode deactivated.' };\n    },\n  }).createOwner(undefined);\n  return {\n    services: [serverMinorModes([modeOwner])],\n    resources,\n    commands: [command],\n    tools: [\n      createHelpStatusTool(inspect, (signal) => {\n        signal?.throwIfAborted();\n        host.assertActive(HELP_PACKAGE_SOURCE);\n        if (disposed || !active()) throw new Error('Help mode is not active.');\n        return signal ?? new AbortController().signal;\n      }),\n    ],\n    onDispose() {\n      disposed = true;\n      generation += 1;\n    },\n  };\n}\n","import type { PoServerPluginDefinition, PoServerSessionPlugin } from '@agimon-ai/po-core/serverPlugin';\n\nimport { createHelpServerSession } from '../../../../../services/helpServerSession';\n\nexport default (({ agent }): Partial<PoServerSessionPlugin> =>\n  agent ? createHelpServerSession(agent) : {}) satisfies NonNullable<PoServerPluginDefinition['session']>;\n","import { defineRoot } from '@agimon-ai/po-core/extensionFile';\nimport type { PoServerPluginContext } from '@agimon-ai/po-core/serverPlugin';\n\nimport runtime from './_lib/runtime.server';\n\nexport default defineRoot((context: PoServerPluginContext) => {\n  const value = runtime(context);\n  return {\n    value,\n    services: value.services,\n    activities: value.activities,\n    onStart: value.onStart,\n    onStop: value.onStop,\n    onDispose: value.onDispose,\n  };\n});\n","import { defineRoutedContribution, 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, Partial<PoServerSessionPlugin>>) => context.root.commands?.[0],\n  { cardinality: 'optional' },\n);\n","import { defineRoutedContribution, 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, Partial<PoServerSessionPlugin>>) => context.root.resources?.[4],\n  { cardinality: 'optional' },\n);\n","import { defineRoutedContribution, 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, Partial<PoServerSessionPlugin>>) => context.root.resources?.[3],\n  { cardinality: 'optional' },\n);\n","import { defineRoutedContribution, 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, Partial<PoServerSessionPlugin>>) => context.root.resources?.[0],\n  { cardinality: 'optional' },\n);\n","import { defineRoutedContribution, 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, Partial<PoServerSessionPlugin>>) => context.root.resources?.[2],\n  { cardinality: 'optional' },\n);\n","import { defineRoutedContribution, 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, Partial<PoServerSessionPlugin>>) => context.root.resources?.[1],\n  { cardinality: 'optional' },\n);\n","import { defineRoutedContribution, 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, Partial<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 commandPoHelp from '../src/extensions/workspaces/sessions/(backend)/command/po-help.server';\nimport resourcePoDevelopCodemodePlugin from '../src/extensions/workspaces/sessions/(backend)/resource/po-develop-codemode-plugin.server';\nimport resourcePoDevelopNativeExtension from '../src/extensions/workspaces/sessions/(backend)/resource/po-develop-native-extension.server';\nimport resourcePoHelp from '../src/extensions/workspaces/sessions/(backend)/resource/po-help.server';\nimport resourcePoUseChatgptInstructions from '../src/extensions/workspaces/sessions/(backend)/resource/po-use-chatgpt-instructions.server';\nimport resourcePoUseHelp from '../src/extensions/workspaces/sessions/(backend)/resource/po-use-help.server';\nimport toolHelpStatus from '../src/extensions/workspaces/sessions/(backend)/tool/help_status.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;\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-help',\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 defined([via({ name: 'po-help' }, at(commandPoHelp, contextSession))]); },\n      get resources(): PoServerSessionPlugin['resources'] { return defined([at(resourcePoDevelopCodemodePlugin, contextSession), at(resourcePoDevelopNativeExtension, contextSession), at(resourcePoHelp, contextSession), at(resourcePoUseChatgptInstructions, contextSession), at(resourcePoUseHelp, contextSession)]); },\n      get tools(): PoServerSessionPlugin['tools'] { return defined([via({ name: 'help_status' }, at(toolHelpStatus, 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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"}
+{"version":3,"file":"server.cjs","names":["Type","defineTool","HELP_WHEN","HELP_WHEN","packageResourcePath","readPackageResource","defineMinorMode","PO_CODEMODE_SERVICE","readPoCodemode","serverMinorModes","readPoPackageHealth","readPoSelfImprove","defineRoot","runtime","defineRoutedContribution","defineRoutedContribution","defineRoutedContribution","defineRoutedContribution","defineRoutedContribution","defineRoutedContribution","defineRoutedContribution","defineRoutedContribution","defineServerPlugin","composeServerProviderOverrides","rootSession","composeRootInjects","composeRootHooks","commandPoHelp","resourceCodemodeHowToSelfImprove","resourcePoDevelopCodemodePlugin","resourcePoDevelopNativeExtension","resourcePoHelp","resourcePoUseChatgptInstructions","resourcePoUseHelp","toolHelpStatus"],"sources":["../../src/constants/help.ts","../../src/schemas/diagnostics.ts","../../src/services/helpStatus/index.ts","../../src/services/selfImproveNamespace/index.ts","../../src/services/helpServerSession/index.ts","../../src/extensions/workspaces/sessions/(backend)/_lib/runtime.server.ts","../../src/extensions/workspaces/sessions/(backend)/root.server.ts","../../src/extensions/workspaces/sessions/(backend)/command/po-help.server.ts","../../src/extensions/workspaces/sessions/(backend)/resource/codemode-how-to-self-improve.server.ts","../../src/extensions/workspaces/sessions/(backend)/resource/po-develop-codemode-plugin.server.ts","../../src/extensions/workspaces/sessions/(backend)/resource/po-develop-native-extension.server.ts","../../src/extensions/workspaces/sessions/(backend)/resource/po-help.server.ts","../../src/extensions/workspaces/sessions/(backend)/resource/po-use-chatgpt-instructions.server.ts","../../src/extensions/workspaces/sessions/(backend)/resource/po-use-help.server.ts","../../src/extensions/workspaces/sessions/(backend)/tool/help_status.server.ts","../../generated/server.ts"],"sourcesContent":["export const HELP_COMMAND_NAME = 'po-help';\nexport const HELP_COMMAND_DESCRIPTION = 'Toggle Help guidance and read-only support diagnostics';\nexport const HELP_MODE_ID = 'help';\nexport const HELP_PACKAGE_SOURCE = '@agimon-ai/po-help';\nexport const HELP_SKILL = {\n  name: 'help-how-to-help',\n  description:\n    'Set up and debug Po agents using installed package guidance and scoped, read-only diagnostics. Diagnose missing capabilities before proposing authorized repairs.',\n} as const;\nexport const HELP_GUIDANCE =\n  'Help mode is active. Read help-how-to-help, inspect the available diagnostics, and use the narrowest package guidance for the task. Diagnose before proposing changes. Help does not grant additional permissions.';\nexport const HELP_STATUS_TOOL_NAME = 'help_status';\nexport const HELP_STATUS_TOOL_DESCRIPTION =\n  'Inspect active Help skills, diagnostic tools, contributor ownership, and unavailable contributions in this session. Read-only; does not change selection or permissions.';\nexport const HELP_STATUS_LIMIT = 128;\n\nexport const HELP_CHATGPT_SKILL = {\n  name: 'help-how-to-chatgpt-instructions',\n  description:\n    \"Print a paste-ready ChatGPT project instruction (at most 8,000 characters) that routes code-mode work through this session's MCP tools and condenses every AGENTS.md rule. Writes no files.\",\n} as const;\n\nexport const HELP_CODEMODE_SKILL = {\n  name: 'help-how-to-codemode-plugin',\n  description:\n    'Add code-mode support to a Po package: contribute a namespace to exec and discover, replace the direct tool it supersedes, and ship the skill that teaches agents to use it.',\n} as const;\n\nexport const HELP_NATIVE_SKILL = {\n  name: 'help-how-to-native-extension',\n  description:\n    \"Add or change a Po package's phone UI (.native files, native templates) so it mirrors the cockpit, passes the native build, and is approved and verified before it ships.\",\n} as const;\n\nexport const HELP_SELF_IMPROVE_SKILL = {\n  name: 'codemode-how-to-self-improve',\n  description:\n    \"Reload Po's own packages after you edit them, without restarting Po or reopening the session. Use in Help mode after changing a plugin's source or build, or after adding or removing a package.\",\n} as const;\n","import { Type } from 'typebox';\n\nexport const helpStatusParameters = Type.Object({}, { additionalProperties: false });\n","import type { PoHeadlessCapabilitySnapshot } from '@agimon-ai/po-core/headless';\nimport { PO_HELP_WHEN as HELP_WHEN, type PoPackageFailureRecord } from '@agimon-ai/po-core/help';\nimport { defineTool } from '@agimon-ai/po-core/serverPlugin';\n\nimport {\n  HELP_GUIDANCE,\n  HELP_MODE_ID,\n  HELP_STATUS_LIMIT,\n  HELP_STATUS_TOOL_DESCRIPTION,\n  HELP_STATUS_TOOL_NAME,\n} from '../../constants/help';\nimport { helpStatusParameters } from '../../schemas/diagnostics';\nimport type { HelpStatusReport } from './type';\n\n/** `packageFailures`: the host's failed global and workspace packages; they never degrade Help itself. */\nexport function serverHelpStatus(\n  snapshot: PoHeadlessCapabilitySnapshot,\n  enabled: boolean,\n  packageFailures: readonly PoPackageFailureRecord[] = [],\n): HelpStatusReport {\n  const entries = snapshot.capabilities.filter((entry) => entry.when?.state?.['minor-mode'] === HELP_MODE_ID);\n  const skills = entries.filter((entry) => entry.kind === 'skill');\n  const tools = entries.filter((entry) => entry.kind === 'tool');\n  const diagnostics = entries\n    .filter((entry) => enabled && entry.reason && entry.reason !== 'inactive')\n    .map((entry) => ({ source: entry.source, code: `HELP_${entry.reason!.replaceAll('-', '_').toUpperCase()}` }));\n  const ready = snapshot.ready;\n  return {\n    activation: !enabled ? 'inactive' : !ready ? 'activating' : diagnostics.length ? 'degraded' : 'active',\n    ready,\n    revision: snapshot.revision,\n    counts: {\n      skills: ready ? skills.filter((entry) => entry.active && entry.discoverable).length : null,\n      tools: tools.filter((entry) => entry.active).length,\n    },\n    skills: skills.slice(0, HELP_STATUS_LIMIT).map(({ name, source, active, discoverable, reason }) => ({\n      name,\n      source,\n      active: active && discoverable,\n      ...(reason ? { reason } : {}),\n    })),\n    tools: tools\n      .slice(0, HELP_STATUS_LIMIT)\n      .map(({ name, source, active, reason }) => ({ name, source, active, ...(reason ? { reason } : {}) })),\n    diagnostics: diagnostics.slice(0, HELP_STATUS_LIMIT),\n    packages: enabled ? packageFailures.slice(-HELP_STATUS_LIMIT) : [],\n    truncated:\n      skills.length > HELP_STATUS_LIMIT ||\n      tools.length > HELP_STATUS_LIMIT ||\n      diagnostics.length > HELP_STATUS_LIMIT ||\n      (enabled && packageFailures.length > HELP_STATUS_LIMIT),\n  };\n}\n\nexport function helpStatusDetail(report: HelpStatusReport): string {\n  return `${report.counts.skills ?? 'pending'} Help skills, ${report.counts.tools} diagnostic tools${report.diagnostics.length ? ' (diagnostics available)' : ''}`;\n}\n\nexport function createHelpStatusTool(\n  inspect: () => HelpStatusReport | Promise<HelpStatusReport>,\n  authorize: (signal?: AbortSignal) => AbortSignal,\n) {\n  return defineTool({\n    name: HELP_STATUS_TOOL_NAME,\n    description: HELP_STATUS_TOOL_DESCRIPTION,\n    parameters: helpStatusParameters,\n    when: HELP_WHEN,\n    promptGuidelines: [HELP_GUIDANCE],\n    async execute(_input, execution) {\n      const signal = authorize(execution.signal);\n      const report = await inspect();\n      signal.throwIfAborted();\n      authorize(execution.signal);\n      return { content: [{ type: 'text', text: JSON.stringify(report, null, 2) }], details: report };\n    },\n  });\n}\n","import type { PoCodemodeNamespace } from '@agimon-ai/po-core/codemode';\nimport type { PoHeadlessRefreshAxis } from '@agimon-ai/po-core/headless';\n\nimport type { SelfImproveNamespaceOptions, SelfImproveOperation, SelfImproveScope } from './type';\n\n/** Finished operations kept for `operation(id)`; older ones are forgotten first. */\nconst MAX_OPERATIONS = 20;\nconst SCOPES: readonly SelfImproveScope[] = ['session', 'workspace', 'global'];\nconst AXES: readonly PoHeadlessRefreshAxis[] = ['majorMode', 'domains', 'profile'];\n\nconst DECLARATIONS = `type Scope = 'session' | 'workspace' | 'global';\ntype Axis = 'majorMode' | 'domains' | 'profile';\ninterface PackageFailure { scope: string; packageName: string; stage: string; reason: string; previous?: 'restored' | 'lost' | 'none'; at: string }\ninterface Operation {\n  operationId: string; scope: Scope; axes?: Axis[];\n  /** partial: applied, but some packages failed and keep their previous build when they had one. */\n  state: 'queued' | 'applied' | 'partial' | 'failed';\n  result?: { installed: string[]; removed: string[]; failed: { packageName: string; reason: string }[] };\n  error?: string;\n}\ndeclare const selfImprove: {\n  /** Packages whose current build failed to load or install, by scope. */\n  plugins(): Promise<{ failures: PackageFailure[] }>;\n  /** Queues a reload of one scope's packages from disk; check it with operation() in a later exec. global needs confirm: true, after the person agreed. */\n  reload(input: { scope: Scope; confirm?: boolean }): Promise<Operation>;\n  /** Queues a re-apply of this session's current major mode, domains or profile (default: all three) after editing their config; check it with operation(). */\n  refresh(input?: { axes?: Axis[] }): Promise<Operation>;\n  operation(operationId: string): Promise<Operation>;\n};`;\n\nexport function createSelfImproveNamespace(options: SelfImproveNamespaceOptions): PoCodemodeNamespace {\n  const operations = new Map<string, SelfImproveOperation>();\n  let next = 0;\n  const remember = (operation: SelfImproveOperation): SelfImproveOperation => {\n    operations.set(operation.operationId, operation);\n    for (const id of operations.keys()) {\n      if (operations.size <= MAX_OPERATIONS) break;\n      if (operations.get(id)?.state !== 'queued') operations.delete(id);\n    }\n    return operation;\n  };\n  return {\n    name: 'selfImprove',\n    summary:\n      \"Reload Po's own packages after editing them, or refresh this session's mode, domains and profile config, without restarting. Help mode, main agent only.\",\n    declarations: DECLARATIONS,\n    bind(run) {\n      if (run.sessionId !== options.sessionId) throw new Error('The selfImprove namespace belongs to another session.');\n      const check = () => {\n        run.signal.throwIfAborted();\n        options.assertActive();\n        if (run.caller !== 'main') throw new Error('Only the main agent may reload or refresh Po.');\n      };\n      return {\n        plugins: async () => {\n          check();\n          return { failures: JSON.parse(JSON.stringify(options.failures())) as unknown };\n        },\n        reload: async (input: unknown) => {\n          check();\n          const { scope, confirm } = (input ?? {}) as { scope?: unknown; confirm?: unknown };\n          if (!SCOPES.includes(scope as SelfImproveScope))\n            throw new Error(\"reload needs scope 'session', 'workspace' or 'global'.\");\n          if (scope === 'global' && confirm !== true)\n            throw new Error('A global reload changes every session; ask the person, then pass confirm: true.');\n          const operationId = `reload-${String(++next)}`;\n          const queued = remember({ operationId, scope: scope as SelfImproveScope, state: 'queued' });\n          // Not awaited: a session reload waits for this tool round to end.\n          void options.service.reload({ scope: queued.scope, sessionId: options.sessionId }).then(\n            (result) =>\n              remember({\n                ...queued,\n                state: result.failed.length === 0 ? 'applied' : 'partial',\n                result: JSON.parse(JSON.stringify(result)) as SelfImproveOperation['result'],\n              }),\n            (error: unknown) =>\n              remember({ ...queued, state: 'failed', error: error instanceof Error ? error.message : String(error) }),\n          );\n          return { ...queued };\n        },\n        refresh: async (input: unknown) => {\n          check();\n          const { axes = AXES } = (input ?? {}) as { axes?: unknown };\n          if (\n            !Array.isArray(axes) ||\n            axes.length === 0 ||\n            !axes.every((axis) => AXES.includes(axis as PoHeadlessRefreshAxis))\n          )\n            throw new Error(\"refresh axes are 'majorMode', 'domains' and 'profile'.\");\n          const queued = remember({\n            operationId: `refresh-${String(++next)}`,\n            scope: 'session',\n            axes: [...new Set(axes as PoHeadlessRefreshAxis[])],\n            state: 'queued',\n          });\n          // Not awaited: the refresh waits for this tool round to end.\n          void options.service.refresh({ sessionId: options.sessionId, axes: queued.axes! }).then(\n            () => remember({ ...queued, state: 'applied' }),\n            (error: unknown) =>\n              remember({ ...queued, state: 'failed', error: error instanceof Error ? error.message : String(error) }),\n          );\n          return JSON.parse(JSON.stringify(queued)) as SelfImproveOperation;\n        },\n        operation: async (operationId: unknown) => {\n          check();\n          const operation = typeof operationId === 'string' ? operations.get(operationId) : undefined;\n          if (operation === undefined) throw new Error(`No operation '${String(operationId)}'.`);\n          return JSON.parse(JSON.stringify(operation)) as SelfImproveOperation;\n        },\n      };\n    },\n  };\n}\n","import { PO_CODEMODE_SERVICE, readPoCodemode } from '@agimon-ai/po-core/codemode';\nimport type { PoHeadlessCommand, PoHeadlessHostService, PoHeadlessResource } from '@agimon-ai/po-core/headless';\nimport { PO_HELP_WHEN as HELP_WHEN, type PoPackageFailureRecord, type PoSelfImprove } from '@agimon-ai/po-core/help';\nimport {\n  type PoServerPluginContext,\n  type PoServerSessionPlugin,\n  packageResourcePath,\n  readPackageResource,\n} from '@agimon-ai/po-core/serverPlugin';\nimport { defineMinorMode, serverMinorModes, type MinorModeOwner, type MinorModeState } from '@agimon-ai/po-minor-mode';\n\nimport {\n  HELP_COMMAND_DESCRIPTION,\n  HELP_COMMAND_NAME,\n  HELP_GUIDANCE,\n  HELP_MODE_ID,\n  HELP_PACKAGE_SOURCE,\n  HELP_CHATGPT_SKILL,\n  HELP_CODEMODE_SKILL,\n  HELP_NATIVE_SKILL,\n  HELP_SELF_IMPROVE_SKILL,\n  HELP_SKILL,\n} from '../../constants/help';\nimport { createHelpStatusTool, helpStatusDetail, serverHelpStatus } from '../helpStatus';\nimport { createSelfImproveNamespace } from '../selfImproveNamespace';\nexport function createHelpServerSession(\n  host: PoHeadlessHostService,\n  packageFailures: () => readonly PoPackageFailureRecord[] = () => [],\n  /** The host's package reload; without it (edge, tests) Help offers no selfImprove namespace. */\n  selfImprove?: PoSelfImprove,\n): PoServerSessionPlugin {\n  let modeOwner: MinorModeOwner | undefined;\n  let pending: boolean | undefined;\n  let failure: string | undefined;\n  let generation = 0;\n  let disposed = false;\n  const active = () => (host.context.selection.state?.['minor-mode'] ?? []).includes(HELP_MODE_ID);\n  const inspect = () => serverHelpStatus(host.inspectCapabilities(), active(), packageFailures());\n  const modeState = (): MinorModeState => {\n    const report = inspect();\n    return {\n      activation: pending === true ? 'activating' : active() ? 'active' : 'inactive',\n      condition:\n        pending !== undefined || !report.ready\n          ? 'queued'\n          : failure\n            ? 'failed'\n            : report.activation === 'degraded'\n              ? 'degraded'\n              : 'ready',\n      ...(pending !== undefined\n        ? { detail: 'applying Help capabilities' }\n        : failure\n          ? { detail: failure }\n          : active()\n            ? { detail: helpStatusDetail(report) }\n            : {}),\n      actions: [\n        {\n          id: 'activate',\n          enabled: !active() && pending === undefined,\n          ...(!active() && pending === undefined ? {} : { disabledReason: 'Help is active or changing.' }),\n        },\n        {\n          id: 'deactivate',\n          enabled: active() || pending === true,\n          ...(active() || pending === true ? {} : { disabledReason: 'Help mode is not active.' }),\n        },\n      ],\n    };\n  };\n  const resources: PoHeadlessResource[] = [\n    { when: HELP_WHEN, name: 'po-help', kind: 'context', read: () => HELP_GUIDANCE },\n    {\n      when: HELP_WHEN,\n      ...HELP_SKILL,\n      kind: 'skill',\n      path: packageResourcePath(import.meta.url, 'src/prompts/help-how-to-help/SKILL.md'),\n      read: async () => {\n        const text = await readPackageResource(import.meta.url, 'src/prompts/help-how-to-help/SKILL.md');\n        if (!text.trim()) throw new Error('The installed Help skill is missing or unreadable.');\n        return text;\n      },\n    },\n    {\n      when: HELP_WHEN,\n      ...HELP_CHATGPT_SKILL,\n      kind: 'skill',\n      path: packageResourcePath(import.meta.url, 'src/prompts/help-how-to-chatgpt-instructions/SKILL.md'),\n      read: async () => {\n        const text = await readPackageResource(\n          import.meta.url,\n          'src/prompts/help-how-to-chatgpt-instructions/SKILL.md',\n        );\n        if (!text.trim()) throw new Error('The installed ChatGPT instruction skill is missing or unreadable.');\n        return text;\n      },\n    },\n    {\n      when: HELP_WHEN,\n      ...HELP_NATIVE_SKILL,\n      kind: 'skill',\n      path: packageResourcePath(import.meta.url, 'src/prompts/help-how-to-native-extension/SKILL.md'),\n      read: async () => {\n        const text = await readPackageResource(import.meta.url, 'src/prompts/help-how-to-native-extension/SKILL.md');\n        if (!text.trim()) throw new Error('The installed native extension skill is missing or unreadable.');\n        return text;\n      },\n    },\n    {\n      when: HELP_WHEN,\n      ...HELP_CODEMODE_SKILL,\n      kind: 'skill',\n      path: packageResourcePath(import.meta.url, 'src/prompts/help-how-to-codemode-plugin/SKILL.md'),\n      read: async () => {\n        const text = await readPackageResource(import.meta.url, 'src/prompts/help-how-to-codemode-plugin/SKILL.md');\n        if (!text.trim()) throw new Error('The installed code-mode plugin skill is missing or unreadable.');\n        return text;\n      },\n    },\n    // Pinned like every code-mode guide, but listed only where the host can reload and Help is on.\n    ...(selfImprove === undefined\n      ? []\n      : [\n          {\n            when: HELP_WHEN,\n            ...HELP_SELF_IMPROVE_SKILL,\n            kind: 'skill' as const,\n            pinned: true,\n            path: packageResourcePath(import.meta.url, 'src/prompts/codemode-how-to-self-improve/SKILL.md'),\n            read: () => readPackageResource(import.meta.url, 'src/prompts/codemode-how-to-self-improve/SKILL.md'),\n          },\n        ]),\n  ];\n  const selectMode = async (enabled: boolean, signal?: AbortSignal): Promise<void> => {\n    if (disposed) throw new Error('Help runtime is disposed.');\n    signal?.throwIfAborted();\n    const operation = ++generation;\n    pending = enabled;\n    failure = undefined;\n    modeOwner?.publish();\n    try {\n      if (enabled) await resources[1]!.read(host.context);\n      signal?.throwIfAborted();\n      if (operation !== generation || disposed) throw new Error('Help activation was cancelled.');\n      const modes = (host.context.selection.state?.['minor-mode'] ?? []).filter((mode) => mode !== HELP_MODE_ID);\n      await host.changeSelection({\n        axis: 'state',\n        key: 'minor-mode',\n        values: enabled ? [...modes, HELP_MODE_ID] : modes,\n      });\n    } catch (error) {\n      if (operation === generation) failure = (error instanceof Error ? error.message : String(error)).slice(0, 160);\n      throw error;\n    } finally {\n      if (operation === generation) {\n        pending = undefined;\n        modeOwner?.publish();\n      }\n    }\n  };\n  const command: PoHeadlessCommand = {\n    name: HELP_COMMAND_NAME,\n    description: HELP_COMMAND_DESCRIPTION,\n    async execute(_args, execution) {\n      await selectMode(!(pending ?? active()));\n      await execution.client.notify({\n        title: 'Po Help',\n        body: active() ? 'Help mode activated.' : 'Help mode deactivated.',\n        level: 'info',\n      });\n    },\n  };\n  modeOwner = defineMinorMode({\n    descriptor: {\n      source: HELP_PACKAGE_SOURCE,\n      id: HELP_MODE_ID,\n      label: 'Help',\n      description: 'Package guidance and read-only diagnostics for agent setup and debugging.',\n      order: 50,\n      actions: [\n        {\n          id: 'activate',\n          label: 'Activate',\n          description: 'Expose Help guidance and diagnostic tools.',\n          contexts: ['headless'],\n          parameters: [],\n        },\n        {\n          id: 'deactivate',\n          label: 'Deactivate',\n          description: 'Withdraw Help-only guidance and diagnostic tools.',\n          contexts: ['headless'],\n          parameters: [],\n        },\n      ],\n    },\n    state: modeState,\n    async handleAction(_runtime, actionId, _argumentsValue, { signal }) {\n      if (actionId !== 'activate' && actionId !== 'deactivate')\n        throw new Error(`Unknown Help mode action: ${actionId}`);\n      await selectMode(actionId === 'activate', signal);\n      return { message: active() ? 'Help mode activated.' : 'Help mode deactivated.' };\n    },\n  }).createOwner(undefined);\n  const assertHelpActive = () => {\n    host.assertActive(HELP_PACKAGE_SOURCE);\n    if (disposed || !active()) throw new Error('Help mode is not active.');\n  };\n  // Registered only while Help is on: the activity starts with Help and stops when it is withdrawn.\n  const selfImproveService = (cordis: PoServerPluginContext['context']) => {\n    cordis.inject([PO_CODEMODE_SERVICE], (scoped) => {\n      const codemode = readPoCodemode(scoped);\n      if (!codemode || !selfImprove) return undefined;\n      const namespace = createSelfImproveNamespace({\n        sessionId: host.context.sessionId,\n        service: selfImprove,\n        failures: packageFailures,\n        assertActive: assertHelpActive,\n      });\n      const activity = host.registerActivity({\n        when: HELP_WHEN,\n        name: 'selfImprove',\n        start: () => {\n          const registration = codemode.register(HELP_PACKAGE_SOURCE, namespace);\n          return () => registration.dispose();\n        },\n      });\n      return () => activity.dispose();\n    });\n  };\n  return {\n    services: [serverMinorModes([modeOwner]), ...(selfImprove ? [selfImproveService] : [])],\n    resources,\n    commands: [command],\n    tools: [\n      createHelpStatusTool(inspect, (signal) => {\n        signal?.throwIfAborted();\n        host.assertActive(HELP_PACKAGE_SOURCE);\n        if (disposed || !active()) throw new Error('Help mode is not active.');\n        return signal ?? new AbortController().signal;\n      }),\n    ],\n    onDispose() {\n      disposed = true;\n      generation += 1;\n    },\n  };\n}\n","import { readPoPackageHealth, readPoSelfImprove } from '@agimon-ai/po-core/help';\nimport type { PoServerPluginDefinition, PoServerSessionPlugin } from '@agimon-ai/po-core/serverPlugin';\n\nimport { createHelpServerSession } from '../../../../../services/helpServerSession';\n\nexport default (({ agent, context }): Partial<PoServerSessionPlugin> =>\n  agent\n    ? createHelpServerSession(agent, () => readPoPackageHealth(context)?.failures() ?? [], readPoSelfImprove(context))\n    : {}) satisfies NonNullable<PoServerPluginDefinition['session']>;\n","import { defineRoot } from '@agimon-ai/po-core/extensionFile';\nimport type { PoServerPluginContext } from '@agimon-ai/po-core/serverPlugin';\n\nimport runtime from './_lib/runtime.server';\n\nexport default defineRoot((context: PoServerPluginContext) => {\n  const value = runtime(context);\n  return {\n    value,\n    services: value.services,\n    activities: value.activities,\n    onStart: value.onStart,\n    onStop: value.onStop,\n    onDispose: value.onDispose,\n  };\n});\n","import { defineRoutedContribution, 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, Partial<PoServerSessionPlugin>>) => context.root.commands?.[0],\n  { cardinality: 'optional' },\n);\n","import { defineRoutedContribution, type WithRoot } from '@agimon-ai/po-core/extensionFile';\nimport type { PoServerPluginContext, PoServerSessionPlugin } from '@agimon-ai/po-core/serverPlugin';\n\n// Present only where the host binds package reload; see createHelpServerSession.\nexport default defineRoutedContribution(\n  (context: WithRoot<PoServerPluginContext, Partial<PoServerSessionPlugin>>) => context.root.resources?.[5],\n  { cardinality: 'optional' },\n);\n","import { defineRoutedContribution, 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, Partial<PoServerSessionPlugin>>) => context.root.resources?.[4],\n  { cardinality: 'optional' },\n);\n","import { defineRoutedContribution, 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, Partial<PoServerSessionPlugin>>) => context.root.resources?.[3],\n  { cardinality: 'optional' },\n);\n","import { defineRoutedContribution, 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, Partial<PoServerSessionPlugin>>) => context.root.resources?.[0],\n  { cardinality: 'optional' },\n);\n","import { defineRoutedContribution, 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, Partial<PoServerSessionPlugin>>) => context.root.resources?.[2],\n  { cardinality: 'optional' },\n);\n","import { defineRoutedContribution, 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, Partial<PoServerSessionPlugin>>) => context.root.resources?.[1],\n  { cardinality: 'optional' },\n);\n","import { defineRoutedContribution, 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, Partial<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 commandPoHelp from '../src/extensions/workspaces/sessions/(backend)/command/po-help.server';\nimport resourceCodemodeHowToSelfImprove from '../src/extensions/workspaces/sessions/(backend)/resource/codemode-how-to-self-improve.server';\nimport resourcePoDevelopCodemodePlugin from '../src/extensions/workspaces/sessions/(backend)/resource/po-develop-codemode-plugin.server';\nimport resourcePoDevelopNativeExtension from '../src/extensions/workspaces/sessions/(backend)/resource/po-develop-native-extension.server';\nimport resourcePoHelp from '../src/extensions/workspaces/sessions/(backend)/resource/po-help.server';\nimport resourcePoUseChatgptInstructions from '../src/extensions/workspaces/sessions/(backend)/resource/po-use-chatgpt-instructions.server';\nimport resourcePoUseHelp from '../src/extensions/workspaces/sessions/(backend)/resource/po-use-help.server';\nimport toolHelpStatus from '../src/extensions/workspaces/sessions/(backend)/tool/help_status.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;\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-help',\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 defined([via({ name: 'po-help' }, at(commandPoHelp, contextSession))]); },\n      get resources(): PoServerSessionPlugin['resources'] { return defined([at(resourceCodemodeHowToSelfImprove, contextSession), at(resourcePoDevelopCodemodePlugin, contextSession), at(resourcePoDevelopNativeExtension, contextSession), at(resourcePoHelp, contextSession), at(resourcePoUseChatgptInstructions, contextSession), at(resourcePoUseHelp, contextSession)]); },\n      get tools(): PoServerSessionPlugin['tools'] { return defined([via({ name: 'help_status' }, at(toolHelpStatus, 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/extensions/server.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.mts","names":[],"sources":["../../generated/server.ts"],"mappings":";qBAuBa,wDAAY"}
+{"version":3,"file":"server.d.mts","names":[],"sources":["../../generated/server.ts"],"mappings":";qBAwBa,wDAAY"}

package/dist/extensions/server.mjs

@@ -1,6 +1,7 @@
-import { PO_HELP_WHEN } from "@agimon-ai/po-core/help";
+import { PO_HELP_WHEN, readPoPackageHealth, readPoSelfImprove } from "@agimon-ai/po-core/help";
 import { composeServerProviderOverrides, defineServerPlugin, defineTool, packageResourcePath, readPackageResource } from "@agimon-ai/po-core/serverPlugin";
 import { composeRootHooks, composeRootInjects, defineRoot, defineRoutedContribution } from "@agimon-ai/po-core/extensionFile";
+import { PO_CODEMODE_SERVICE, readPoCodemode } from "@agimon-ai/po-core/codemode";
 import { defineMinorMode, serverMinorModes } from "@agimon-ai/po-minor-mode";
 import { Type } from "typebox";
 //#region src/constants/help.ts
@@ -27,12 +28,17 @@ const HELP_NATIVE_SKILL = {
 	name: "help-how-to-native-extension",
 	description: "Add or change a Po package's phone UI (.native files, native templates) so it mirrors the cockpit, passes the native build, and is approved and verified before it ships."
 };
+const HELP_SELF_IMPROVE_SKILL = {
+	name: "codemode-how-to-self-improve",
+	description: "Reload Po's own packages after you edit them, without restarting Po or reopening the session. Use in Help mode after changing a plugin's source or build, or after adding or removing a package."
+};
 //#endregion
 //#region src/schemas/diagnostics.ts
 const helpStatusParameters = Type.Object({}, { additionalProperties: false });
 //#endregion
 //#region src/services/helpStatus/index.ts
-function serverHelpStatus(snapshot, enabled) {
+/** `packageFailures`: the host's failed global and workspace packages; they never degrade Help itself. */
+function serverHelpStatus(snapshot, enabled, packageFailures = []) {
 	const entries = snapshot.capabilities.filter((entry) => entry.when?.state?.["minor-mode"] === HELP_MODE_ID);
 	const skills = entries.filter((entry) => entry.kind === "skill");
 	const tools = entries.filter((entry) => entry.kind === "tool");
@@ -62,7 +68,8 @@ function serverHelpStatus(snapshot, enabled) {
 			...reason ? { reason } : {}
 		})),
 		diagnostics: diagnostics.slice(0, 128),
-		truncated: skills.length > 128 || tools.length > 128 || diagnostics.length > 128
+		packages: enabled ? packageFailures.slice(-128) : [],
+		truncated: skills.length > 128 || tools.length > 128 || diagnostics.length > 128 || enabled && packageFailures.length > 128
 	};
 }
 function helpStatusDetail(report) {
@@ -91,15 +98,133 @@ function createHelpStatusTool(inspect, authorize) {
 	});
 }
 //#endregion
+//#region src/services/selfImproveNamespace/index.ts
+/** Finished operations kept for `operation(id)`; older ones are forgotten first. */
+const MAX_OPERATIONS = 20;
+const SCOPES = [
+	"session",
+	"workspace",
+	"global"
+];
+const AXES = [
+	"majorMode",
+	"domains",
+	"profile"
+];
+const DECLARATIONS = `type Scope = 'session' | 'workspace' | 'global';
+type Axis = 'majorMode' | 'domains' | 'profile';
+interface PackageFailure { scope: string; packageName: string; stage: string; reason: string; previous?: 'restored' | 'lost' | 'none'; at: string }
+interface Operation {
+  operationId: string; scope: Scope; axes?: Axis[];
+  /** partial: applied, but some packages failed and keep their previous build when they had one. */
+  state: 'queued' | 'applied' | 'partial' | 'failed';
+  result?: { installed: string[]; removed: string[]; failed: { packageName: string; reason: string }[] };
+  error?: string;
+}
+declare const selfImprove: {
+  /** Packages whose current build failed to load or install, by scope. */
+  plugins(): Promise<{ failures: PackageFailure[] }>;
+  /** Queues a reload of one scope's packages from disk; check it with operation() in a later exec. global needs confirm: true, after the person agreed. */
+  reload(input: { scope: Scope; confirm?: boolean }): Promise<Operation>;
+  /** Queues a re-apply of this session's current major mode, domains or profile (default: all three) after editing their config; check it with operation(). */
+  refresh(input?: { axes?: Axis[] }): Promise<Operation>;
+  operation(operationId: string): Promise<Operation>;
+};`;
+function createSelfImproveNamespace(options) {
+	const operations = /* @__PURE__ */ new Map();
+	let next = 0;
+	const remember = (operation) => {
+		operations.set(operation.operationId, operation);
+		for (const id of operations.keys()) {
+			if (operations.size <= MAX_OPERATIONS) break;
+			if (operations.get(id)?.state !== "queued") operations.delete(id);
+		}
+		return operation;
+	};
+	return {
+		name: "selfImprove",
+		summary: "Reload Po's own packages after editing them, or refresh this session's mode, domains and profile config, without restarting. Help mode, main agent only.",
+		declarations: DECLARATIONS,
+		bind(run) {
+			if (run.sessionId !== options.sessionId) throw new Error("The selfImprove namespace belongs to another session.");
+			const check = () => {
+				run.signal.throwIfAborted();
+				options.assertActive();
+				if (run.caller !== "main") throw new Error("Only the main agent may reload or refresh Po.");
+			};
+			return {
+				plugins: async () => {
+					check();
+					return { failures: JSON.parse(JSON.stringify(options.failures())) };
+				},
+				reload: async (input) => {
+					check();
+					const { scope, confirm } = input ?? {};
+					if (!SCOPES.includes(scope)) throw new Error("reload needs scope 'session', 'workspace' or 'global'.");
+					if (scope === "global" && confirm !== true) throw new Error("A global reload changes every session; ask the person, then pass confirm: true.");
+					const operationId = `reload-${String(++next)}`;
+					const queued = remember({
+						operationId,
+						scope,
+						state: "queued"
+					});
+					options.service.reload({
+						scope: queued.scope,
+						sessionId: options.sessionId
+					}).then((result) => remember({
+						...queued,
+						state: result.failed.length === 0 ? "applied" : "partial",
+						result: JSON.parse(JSON.stringify(result))
+					}), (error) => remember({
+						...queued,
+						state: "failed",
+						error: error instanceof Error ? error.message : String(error)
+					}));
+					return { ...queued };
+				},
+				refresh: async (input) => {
+					check();
+					const { axes = AXES } = input ?? {};
+					if (!Array.isArray(axes) || axes.length === 0 || !axes.every((axis) => AXES.includes(axis))) throw new Error("refresh axes are 'majorMode', 'domains' and 'profile'.");
+					const queued = remember({
+						operationId: `refresh-${String(++next)}`,
+						scope: "session",
+						axes: [...new Set(axes)],
+						state: "queued"
+					});
+					options.service.refresh({
+						sessionId: options.sessionId,
+						axes: queued.axes
+					}).then(() => remember({
+						...queued,
+						state: "applied"
+					}), (error) => remember({
+						...queued,
+						state: "failed",
+						error: error instanceof Error ? error.message : String(error)
+					}));
+					return JSON.parse(JSON.stringify(queued));
+				},
+				operation: async (operationId) => {
+					check();
+					const operation = typeof operationId === "string" ? operations.get(operationId) : void 0;
+					if (operation === void 0) throw new Error(`No operation '${String(operationId)}'.`);
+					return JSON.parse(JSON.stringify(operation));
+				}
+			};
+		}
+	};
+}
+//#endregion
 //#region src/services/helpServerSession/index.ts
-function createHelpServerSession(host) {
+function createHelpServerSession(host, packageFailures = () => [], selfImprove) {
 	let modeOwner;
 	let pending;
 	let failure;
 	let generation = 0;
 	let disposed = false;
 	const active = () => (host.context.selection.state?.["minor-mode"] ?? []).includes(HELP_MODE_ID);
-	const inspect = () => serverHelpStatus(host.inspectCapabilities(), active());
+	const inspect = () => serverHelpStatus(host.inspectCapabilities(), active(), packageFailures());
 	const modeState = () => {
 		const report = inspect();
 		return {
@@ -167,7 +292,15 @@ function createHelpServerSession(host) {
 				if (!text.trim()) throw new Error("The installed code-mode plugin skill is missing or unreadable.");
 				return text;
 			}
-		}
+		},
+		...selfImprove === void 0 ? [] : [{
+			when: PO_HELP_WHEN,
+			...HELP_SELF_IMPROVE_SKILL,
+			kind: "skill",
+			pinned: true,
+			path: packageResourcePath(import.meta.url, "src/prompts/codemode-how-to-self-improve/SKILL.md"),
+			read: () => readPackageResource(import.meta.url, "src/prompts/codemode-how-to-self-improve/SKILL.md")
+		}]
 	];
 	const selectMode = async (enabled, signal) => {
 		if (disposed) throw new Error("Help runtime is disposed.");
@@ -236,8 +369,33 @@ function createHelpServerSession(host) {
 			return { message: active() ? "Help mode activated." : "Help mode deactivated." };
 		}
 	}).createOwner(void 0);
+	const assertHelpActive = () => {
+		host.assertActive(HELP_PACKAGE_SOURCE);
+		if (disposed || !active()) throw new Error("Help mode is not active.");
+	};
+	const selfImproveService = (cordis) => {
+		cordis.inject([PO_CODEMODE_SERVICE], (scoped) => {
+			const codemode = readPoCodemode(scoped);
+			if (!codemode || !selfImprove) return void 0;
+			const namespace = createSelfImproveNamespace({
+				sessionId: host.context.sessionId,
+				service: selfImprove,
+				failures: packageFailures,
+				assertActive: assertHelpActive
+			});
+			const activity = host.registerActivity({
+				when: PO_HELP_WHEN,
+				name: "selfImprove",
+				start: () => {
+					const registration = codemode.register(HELP_PACKAGE_SOURCE, namespace);
+					return () => registration.dispose();
+				}
+			});
+			return () => activity.dispose();
+		});
+	};
 	return {
-		services: [serverMinorModes([modeOwner])],
+		services: [serverMinorModes([modeOwner]), ...selfImprove ? [selfImproveService] : []],
 		resources,
 		commands: [command],
 		tools: [createHelpStatusTool(inspect, (signal) => {
@@ -254,7 +412,7 @@ function createHelpServerSession(host) {
 }
 //#endregion
 //#region src/extensions/workspaces/sessions/(backend)/_lib/runtime.server.ts
-var runtime_server_default = (({ agent }) => agent ? createHelpServerSession(agent) : {});
+var runtime_server_default = (({ agent, context }) => agent ? createHelpServerSession(agent, () => readPoPackageHealth(context)?.failures() ?? [], readPoSelfImprove(context)) : {});
 //#endregion
 //#region src/extensions/workspaces/sessions/(backend)/root.server.ts
 var root_server_default = defineRoot((context) => {
@@ -272,6 +430,9 @@ var root_server_default = defineRoot((context) => {
 //#region src/extensions/workspaces/sessions/(backend)/command/po-help.server.ts
 var po_help_server_default$1 = defineRoutedContribution((context) => context.root.commands?.[0], { cardinality: "optional" });
 //#endregion
+//#region src/extensions/workspaces/sessions/(backend)/resource/codemode-how-to-self-improve.server.ts
+var codemode_how_to_self_improve_server_default = defineRoutedContribution((context) => context.root.resources?.[5], { cardinality: "optional" });
+//#endregion
 //#region src/extensions/workspaces/sessions/(backend)/resource/po-develop-codemode-plugin.server.ts
 var po_develop_codemode_plugin_server_default = defineRoutedContribution((context) => context.root.resources?.[4], { cardinality: "optional" });
 //#endregion
@@ -315,6 +476,7 @@ const serverPlugin = defineServerPlugin({
 			},
 			get resources() {
 				return defined([
+					at(codemode_how_to_self_improve_server_default, contextSession),
 					at(po_develop_codemode_plugin_server_default, contextSession),
 					at(po_develop_native_extension_server_default, contextSession),
 					at(po_help_server_default, contextSession),

package/dist/extensions/server.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"server.mjs","names":["HELP_WHEN","HELP_WHEN","runtime","rootSession","commandPoHelp","resourcePoDevelopCodemodePlugin","resourcePoDevelopNativeExtension","resourcePoHelp","resourcePoUseChatgptInstructions","resourcePoUseHelp","toolHelpStatus"],"sources":["../../src/constants/help.ts","../../src/schemas/diagnostics.ts","../../src/services/helpStatus/index.ts","../../src/services/helpServerSession/index.ts","../../src/extensions/workspaces/sessions/(backend)/_lib/runtime.server.ts","../../src/extensions/workspaces/sessions/(backend)/root.server.ts","../../src/extensions/workspaces/sessions/(backend)/command/po-help.server.ts","../../src/extensions/workspaces/sessions/(backend)/resource/po-develop-codemode-plugin.server.ts","../../src/extensions/workspaces/sessions/(backend)/resource/po-develop-native-extension.server.ts","../../src/extensions/workspaces/sessions/(backend)/resource/po-help.server.ts","../../src/extensions/workspaces/sessions/(backend)/resource/po-use-chatgpt-instructions.server.ts","../../src/extensions/workspaces/sessions/(backend)/resource/po-use-help.server.ts","../../src/extensions/workspaces/sessions/(backend)/tool/help_status.server.ts","../../generated/server.ts"],"sourcesContent":["export const HELP_COMMAND_NAME = 'po-help';\nexport const HELP_COMMAND_DESCRIPTION = 'Toggle Help guidance and read-only support diagnostics';\nexport const HELP_MODE_ID = 'help';\nexport const HELP_PACKAGE_SOURCE = '@agimon-ai/po-help';\nexport const HELP_SKILL = {\n  name: 'help-how-to-help',\n  description:\n    'Set up and debug Po agents using installed package guidance and scoped, read-only diagnostics. Diagnose missing capabilities before proposing authorized repairs.',\n} as const;\nexport const HELP_GUIDANCE =\n  'Help mode is active. Read help-how-to-help, inspect the available diagnostics, and use the narrowest package guidance for the task. Diagnose before proposing changes. Help does not grant additional permissions.';\nexport const HELP_STATUS_TOOL_NAME = 'help_status';\nexport const HELP_STATUS_TOOL_DESCRIPTION =\n  'Inspect active Help skills, diagnostic tools, contributor ownership, and unavailable contributions in this session. Read-only; does not change selection or permissions.';\nexport const HELP_STATUS_LIMIT = 128;\n\nexport const HELP_CHATGPT_SKILL = {\n  name: 'help-how-to-chatgpt-instructions',\n  description:\n    \"Print a paste-ready ChatGPT project instruction (at most 8,000 characters) that routes code-mode work through this session's MCP tools and condenses every AGENTS.md rule. Writes no files.\",\n} as const;\n\nexport const HELP_CODEMODE_SKILL = {\n  name: 'help-how-to-codemode-plugin',\n  description:\n    'Add code-mode support to a Po package: contribute a namespace to exec and discover, replace the direct tool it supersedes, and ship the skill that teaches agents to use it.',\n} as const;\n\nexport const HELP_NATIVE_SKILL = {\n  name: 'help-how-to-native-extension',\n  description:\n    \"Add or change a Po package's phone UI (.native files, native templates) so it mirrors the cockpit, passes the native build, and is approved and verified before it ships.\",\n} as const;\n","import { Type } from 'typebox';\n\nexport const helpStatusParameters = Type.Object({}, { additionalProperties: false });\n","import type { PoHeadlessCapabilitySnapshot } from '@agimon-ai/po-core/headless';\nimport { PO_HELP_WHEN as HELP_WHEN } from '@agimon-ai/po-core/help';\nimport { defineTool } from '@agimon-ai/po-core/serverPlugin';\n\nimport {\n  HELP_GUIDANCE,\n  HELP_MODE_ID,\n  HELP_STATUS_LIMIT,\n  HELP_STATUS_TOOL_DESCRIPTION,\n  HELP_STATUS_TOOL_NAME,\n} from '../../constants/help';\nimport { helpStatusParameters } from '../../schemas/diagnostics';\nimport type { HelpStatusReport } from './type';\n\nexport function serverHelpStatus(snapshot: PoHeadlessCapabilitySnapshot, enabled: boolean): HelpStatusReport {\n  const entries = snapshot.capabilities.filter((entry) => entry.when?.state?.['minor-mode'] === HELP_MODE_ID);\n  const skills = entries.filter((entry) => entry.kind === 'skill');\n  const tools = entries.filter((entry) => entry.kind === 'tool');\n  const diagnostics = entries\n    .filter((entry) => enabled && entry.reason && entry.reason !== 'inactive')\n    .map((entry) => ({ source: entry.source, code: `HELP_${entry.reason!.replaceAll('-', '_').toUpperCase()}` }));\n  const ready = snapshot.ready;\n  return {\n    activation: !enabled ? 'inactive' : !ready ? 'activating' : diagnostics.length ? 'degraded' : 'active',\n    ready,\n    revision: snapshot.revision,\n    counts: {\n      skills: ready ? skills.filter((entry) => entry.active && entry.discoverable).length : null,\n      tools: tools.filter((entry) => entry.active).length,\n    },\n    skills: skills.slice(0, HELP_STATUS_LIMIT).map(({ name, source, active, discoverable, reason }) => ({\n      name,\n      source,\n      active: active && discoverable,\n      ...(reason ? { reason } : {}),\n    })),\n    tools: tools\n      .slice(0, HELP_STATUS_LIMIT)\n      .map(({ name, source, active, reason }) => ({ name, source, active, ...(reason ? { reason } : {}) })),\n    diagnostics: diagnostics.slice(0, HELP_STATUS_LIMIT),\n    truncated:\n      skills.length > HELP_STATUS_LIMIT || tools.length > HELP_STATUS_LIMIT || diagnostics.length > HELP_STATUS_LIMIT,\n  };\n}\n\nexport function helpStatusDetail(report: HelpStatusReport): string {\n  return `${report.counts.skills ?? 'pending'} Help skills, ${report.counts.tools} diagnostic tools${report.diagnostics.length ? ' (diagnostics available)' : ''}`;\n}\n\nexport function createHelpStatusTool(\n  inspect: () => HelpStatusReport | Promise<HelpStatusReport>,\n  authorize: (signal?: AbortSignal) => AbortSignal,\n) {\n  return defineTool({\n    name: HELP_STATUS_TOOL_NAME,\n    description: HELP_STATUS_TOOL_DESCRIPTION,\n    parameters: helpStatusParameters,\n    when: HELP_WHEN,\n    promptGuidelines: [HELP_GUIDANCE],\n    async execute(_input, execution) {\n      const signal = authorize(execution.signal);\n      const report = await inspect();\n      signal.throwIfAborted();\n      authorize(execution.signal);\n      return { content: [{ type: 'text', text: JSON.stringify(report, null, 2) }], details: report };\n    },\n  });\n}\n","import type { PoHeadlessCommand, PoHeadlessHostService, PoHeadlessResource } from '@agimon-ai/po-core/headless';\nimport { PO_HELP_WHEN as HELP_WHEN } from '@agimon-ai/po-core/help';\nimport { type PoServerSessionPlugin, packageResourcePath, readPackageResource } from '@agimon-ai/po-core/serverPlugin';\nimport { defineMinorMode, serverMinorModes, type MinorModeOwner, type MinorModeState } from '@agimon-ai/po-minor-mode';\n\nimport {\n  HELP_COMMAND_DESCRIPTION,\n  HELP_COMMAND_NAME,\n  HELP_GUIDANCE,\n  HELP_MODE_ID,\n  HELP_PACKAGE_SOURCE,\n  HELP_CHATGPT_SKILL,\n  HELP_CODEMODE_SKILL,\n  HELP_NATIVE_SKILL,\n  HELP_SKILL,\n} from '../../constants/help';\nimport { createHelpStatusTool, helpStatusDetail, serverHelpStatus } from '../helpStatus';\nexport function createHelpServerSession(host: PoHeadlessHostService): PoServerSessionPlugin {\n  let modeOwner: MinorModeOwner | undefined;\n  let pending: boolean | undefined;\n  let failure: string | undefined;\n  let generation = 0;\n  let disposed = false;\n  const active = () => (host.context.selection.state?.['minor-mode'] ?? []).includes(HELP_MODE_ID);\n  const inspect = () => serverHelpStatus(host.inspectCapabilities(), active());\n  const modeState = (): MinorModeState => {\n    const report = inspect();\n    return {\n      activation: pending === true ? 'activating' : active() ? 'active' : 'inactive',\n      condition:\n        pending !== undefined || !report.ready\n          ? 'queued'\n          : failure\n            ? 'failed'\n            : report.activation === 'degraded'\n              ? 'degraded'\n              : 'ready',\n      ...(pending !== undefined\n        ? { detail: 'applying Help capabilities' }\n        : failure\n          ? { detail: failure }\n          : active()\n            ? { detail: helpStatusDetail(report) }\n            : {}),\n      actions: [\n        {\n          id: 'activate',\n          enabled: !active() && pending === undefined,\n          ...(!active() && pending === undefined ? {} : { disabledReason: 'Help is active or changing.' }),\n        },\n        {\n          id: 'deactivate',\n          enabled: active() || pending === true,\n          ...(active() || pending === true ? {} : { disabledReason: 'Help mode is not active.' }),\n        },\n      ],\n    };\n  };\n  const resources: PoHeadlessResource[] = [\n    { when: HELP_WHEN, name: 'po-help', kind: 'context', read: () => HELP_GUIDANCE },\n    {\n      when: HELP_WHEN,\n      ...HELP_SKILL,\n      kind: 'skill',\n      path: packageResourcePath(import.meta.url, 'src/prompts/help-how-to-help/SKILL.md'),\n      read: async () => {\n        const text = await readPackageResource(import.meta.url, 'src/prompts/help-how-to-help/SKILL.md');\n        if (!text.trim()) throw new Error('The installed Help skill is missing or unreadable.');\n        return text;\n      },\n    },\n    {\n      when: HELP_WHEN,\n      ...HELP_CHATGPT_SKILL,\n      kind: 'skill',\n      path: packageResourcePath(import.meta.url, 'src/prompts/help-how-to-chatgpt-instructions/SKILL.md'),\n      read: async () => {\n        const text = await readPackageResource(\n          import.meta.url,\n          'src/prompts/help-how-to-chatgpt-instructions/SKILL.md',\n        );\n        if (!text.trim()) throw new Error('The installed ChatGPT instruction skill is missing or unreadable.');\n        return text;\n      },\n    },\n    {\n      when: HELP_WHEN,\n      ...HELP_NATIVE_SKILL,\n      kind: 'skill',\n      path: packageResourcePath(import.meta.url, 'src/prompts/help-how-to-native-extension/SKILL.md'),\n      read: async () => {\n        const text = await readPackageResource(import.meta.url, 'src/prompts/help-how-to-native-extension/SKILL.md');\n        if (!text.trim()) throw new Error('The installed native extension skill is missing or unreadable.');\n        return text;\n      },\n    },\n    {\n      when: HELP_WHEN,\n      ...HELP_CODEMODE_SKILL,\n      kind: 'skill',\n      path: packageResourcePath(import.meta.url, 'src/prompts/help-how-to-codemode-plugin/SKILL.md'),\n      read: async () => {\n        const text = await readPackageResource(import.meta.url, 'src/prompts/help-how-to-codemode-plugin/SKILL.md');\n        if (!text.trim()) throw new Error('The installed code-mode plugin skill is missing or unreadable.');\n        return text;\n      },\n    },\n  ];\n  const selectMode = async (enabled: boolean, signal?: AbortSignal): Promise<void> => {\n    if (disposed) throw new Error('Help runtime is disposed.');\n    signal?.throwIfAborted();\n    const operation = ++generation;\n    pending = enabled;\n    failure = undefined;\n    modeOwner?.publish();\n    try {\n      if (enabled) await resources[1]!.read(host.context);\n      signal?.throwIfAborted();\n      if (operation !== generation || disposed) throw new Error('Help activation was cancelled.');\n      const modes = (host.context.selection.state?.['minor-mode'] ?? []).filter((mode) => mode !== HELP_MODE_ID);\n      await host.changeSelection({\n        axis: 'state',\n        key: 'minor-mode',\n        values: enabled ? [...modes, HELP_MODE_ID] : modes,\n      });\n    } catch (error) {\n      if (operation === generation) failure = (error instanceof Error ? error.message : String(error)).slice(0, 160);\n      throw error;\n    } finally {\n      if (operation === generation) {\n        pending = undefined;\n        modeOwner?.publish();\n      }\n    }\n  };\n  const command: PoHeadlessCommand = {\n    name: HELP_COMMAND_NAME,\n    description: HELP_COMMAND_DESCRIPTION,\n    async execute(_args, execution) {\n      await selectMode(!(pending ?? active()));\n      await execution.client.notify({\n        title: 'Po Help',\n        body: active() ? 'Help mode activated.' : 'Help mode deactivated.',\n        level: 'info',\n      });\n    },\n  };\n  modeOwner = defineMinorMode({\n    descriptor: {\n      source: HELP_PACKAGE_SOURCE,\n      id: HELP_MODE_ID,\n      label: 'Help',\n      description: 'Package guidance and read-only diagnostics for agent setup and debugging.',\n      order: 50,\n      actions: [\n        {\n          id: 'activate',\n          label: 'Activate',\n          description: 'Expose Help guidance and diagnostic tools.',\n          contexts: ['headless'],\n          parameters: [],\n        },\n        {\n          id: 'deactivate',\n          label: 'Deactivate',\n          description: 'Withdraw Help-only guidance and diagnostic tools.',\n          contexts: ['headless'],\n          parameters: [],\n        },\n      ],\n    },\n    state: modeState,\n    async handleAction(_runtime, actionId, _argumentsValue, { signal }) {\n      if (actionId !== 'activate' && actionId !== 'deactivate')\n        throw new Error(`Unknown Help mode action: ${actionId}`);\n      await selectMode(actionId === 'activate', signal);\n      return { message: active() ? 'Help mode activated.' : 'Help mode deactivated.' };\n    },\n  }).createOwner(undefined);\n  return {\n    services: [serverMinorModes([modeOwner])],\n    resources,\n    commands: [command],\n    tools: [\n      createHelpStatusTool(inspect, (signal) => {\n        signal?.throwIfAborted();\n        host.assertActive(HELP_PACKAGE_SOURCE);\n        if (disposed || !active()) throw new Error('Help mode is not active.');\n        return signal ?? new AbortController().signal;\n      }),\n    ],\n    onDispose() {\n      disposed = true;\n      generation += 1;\n    },\n  };\n}\n","import type { PoServerPluginDefinition, PoServerSessionPlugin } from '@agimon-ai/po-core/serverPlugin';\n\nimport { createHelpServerSession } from '../../../../../services/helpServerSession';\n\nexport default (({ agent }): Partial<PoServerSessionPlugin> =>\n  agent ? createHelpServerSession(agent) : {}) satisfies NonNullable<PoServerPluginDefinition['session']>;\n","import { defineRoot } from '@agimon-ai/po-core/extensionFile';\nimport type { PoServerPluginContext } from '@agimon-ai/po-core/serverPlugin';\n\nimport runtime from './_lib/runtime.server';\n\nexport default defineRoot((context: PoServerPluginContext) => {\n  const value = runtime(context);\n  return {\n    value,\n    services: value.services,\n    activities: value.activities,\n    onStart: value.onStart,\n    onStop: value.onStop,\n    onDispose: value.onDispose,\n  };\n});\n","import { defineRoutedContribution, 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, Partial<PoServerSessionPlugin>>) => context.root.commands?.[0],\n  { cardinality: 'optional' },\n);\n","import { defineRoutedContribution, 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, Partial<PoServerSessionPlugin>>) => context.root.resources?.[4],\n  { cardinality: 'optional' },\n);\n","import { defineRoutedContribution, 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, Partial<PoServerSessionPlugin>>) => context.root.resources?.[3],\n  { cardinality: 'optional' },\n);\n","import { defineRoutedContribution, 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, Partial<PoServerSessionPlugin>>) => context.root.resources?.[0],\n  { cardinality: 'optional' },\n);\n","import { defineRoutedContribution, 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, Partial<PoServerSessionPlugin>>) => context.root.resources?.[2],\n  { cardinality: 'optional' },\n);\n","import { defineRoutedContribution, 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, Partial<PoServerSessionPlugin>>) => context.root.resources?.[1],\n  { cardinality: 'optional' },\n);\n","import { defineRoutedContribution, 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, Partial<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 commandPoHelp from '../src/extensions/workspaces/sessions/(backend)/command/po-help.server';\nimport resourcePoDevelopCodemodePlugin from '../src/extensions/workspaces/sessions/(backend)/resource/po-develop-codemode-plugin.server';\nimport resourcePoDevelopNativeExtension from '../src/extensions/workspaces/sessions/(backend)/resource/po-develop-native-extension.server';\nimport resourcePoHelp from '../src/extensions/workspaces/sessions/(backend)/resource/po-help.server';\nimport resourcePoUseChatgptInstructions from '../src/extensions/workspaces/sessions/(backend)/resource/po-use-chatgpt-instructions.server';\nimport resourcePoUseHelp from '../src/extensions/workspaces/sessions/(backend)/resource/po-use-help.server';\nimport toolHelpStatus from '../src/extensions/workspaces/sessions/(backend)/tool/help_status.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;\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-help',\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 defined([via({ name: 'po-help' }, at(commandPoHelp, contextSession))]); },\n      get resources(): PoServerSessionPlugin['resources'] { return defined([at(resourcePoDevelopCodemodePlugin, contextSession), at(resourcePoDevelopNativeExtension, contextSession), at(resourcePoHelp, contextSession), at(resourcePoUseChatgptInstructions, contextSession), at(resourcePoUseHelp, contextSession)]); },\n      get tools(): PoServerSessionPlugin['tools'] { return defined([via({ name: 'help_status' }, at(toolHelpStatus, 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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"}
+{"version":3,"file":"server.mjs","names":["HELP_WHEN","HELP_WHEN","runtime","rootSession","commandPoHelp","resourceCodemodeHowToSelfImprove","resourcePoDevelopCodemodePlugin","resourcePoDevelopNativeExtension","resourcePoHelp","resourcePoUseChatgptInstructions","resourcePoUseHelp","toolHelpStatus"],"sources":["../../src/constants/help.ts","../../src/schemas/diagnostics.ts","../../src/services/helpStatus/index.ts","../../src/services/selfImproveNamespace/index.ts","../../src/services/helpServerSession/index.ts","../../src/extensions/workspaces/sessions/(backend)/_lib/runtime.server.ts","../../src/extensions/workspaces/sessions/(backend)/root.server.ts","../../src/extensions/workspaces/sessions/(backend)/command/po-help.server.ts","../../src/extensions/workspaces/sessions/(backend)/resource/codemode-how-to-self-improve.server.ts","../../src/extensions/workspaces/sessions/(backend)/resource/po-develop-codemode-plugin.server.ts","../../src/extensions/workspaces/sessions/(backend)/resource/po-develop-native-extension.server.ts","../../src/extensions/workspaces/sessions/(backend)/resource/po-help.server.ts","../../src/extensions/workspaces/sessions/(backend)/resource/po-use-chatgpt-instructions.server.ts","../../src/extensions/workspaces/sessions/(backend)/resource/po-use-help.server.ts","../../src/extensions/workspaces/sessions/(backend)/tool/help_status.server.ts","../../generated/server.ts"],"sourcesContent":["export const HELP_COMMAND_NAME = 'po-help';\nexport const HELP_COMMAND_DESCRIPTION = 'Toggle Help guidance and read-only support diagnostics';\nexport const HELP_MODE_ID = 'help';\nexport const HELP_PACKAGE_SOURCE = '@agimon-ai/po-help';\nexport const HELP_SKILL = {\n  name: 'help-how-to-help',\n  description:\n    'Set up and debug Po agents using installed package guidance and scoped, read-only diagnostics. Diagnose missing capabilities before proposing authorized repairs.',\n} as const;\nexport const HELP_GUIDANCE =\n  'Help mode is active. Read help-how-to-help, inspect the available diagnostics, and use the narrowest package guidance for the task. Diagnose before proposing changes. Help does not grant additional permissions.';\nexport const HELP_STATUS_TOOL_NAME = 'help_status';\nexport const HELP_STATUS_TOOL_DESCRIPTION =\n  'Inspect active Help skills, diagnostic tools, contributor ownership, and unavailable contributions in this session. Read-only; does not change selection or permissions.';\nexport const HELP_STATUS_LIMIT = 128;\n\nexport const HELP_CHATGPT_SKILL = {\n  name: 'help-how-to-chatgpt-instructions',\n  description:\n    \"Print a paste-ready ChatGPT project instruction (at most 8,000 characters) that routes code-mode work through this session's MCP tools and condenses every AGENTS.md rule. Writes no files.\",\n} as const;\n\nexport const HELP_CODEMODE_SKILL = {\n  name: 'help-how-to-codemode-plugin',\n  description:\n    'Add code-mode support to a Po package: contribute a namespace to exec and discover, replace the direct tool it supersedes, and ship the skill that teaches agents to use it.',\n} as const;\n\nexport const HELP_NATIVE_SKILL = {\n  name: 'help-how-to-native-extension',\n  description:\n    \"Add or change a Po package's phone UI (.native files, native templates) so it mirrors the cockpit, passes the native build, and is approved and verified before it ships.\",\n} as const;\n\nexport const HELP_SELF_IMPROVE_SKILL = {\n  name: 'codemode-how-to-self-improve',\n  description:\n    \"Reload Po's own packages after you edit them, without restarting Po or reopening the session. Use in Help mode after changing a plugin's source or build, or after adding or removing a package.\",\n} as const;\n","import { Type } from 'typebox';\n\nexport const helpStatusParameters = Type.Object({}, { additionalProperties: false });\n","import type { PoHeadlessCapabilitySnapshot } from '@agimon-ai/po-core/headless';\nimport { PO_HELP_WHEN as HELP_WHEN, type PoPackageFailureRecord } from '@agimon-ai/po-core/help';\nimport { defineTool } from '@agimon-ai/po-core/serverPlugin';\n\nimport {\n  HELP_GUIDANCE,\n  HELP_MODE_ID,\n  HELP_STATUS_LIMIT,\n  HELP_STATUS_TOOL_DESCRIPTION,\n  HELP_STATUS_TOOL_NAME,\n} from '../../constants/help';\nimport { helpStatusParameters } from '../../schemas/diagnostics';\nimport type { HelpStatusReport } from './type';\n\n/** `packageFailures`: the host's failed global and workspace packages; they never degrade Help itself. */\nexport function serverHelpStatus(\n  snapshot: PoHeadlessCapabilitySnapshot,\n  enabled: boolean,\n  packageFailures: readonly PoPackageFailureRecord[] = [],\n): HelpStatusReport {\n  const entries = snapshot.capabilities.filter((entry) => entry.when?.state?.['minor-mode'] === HELP_MODE_ID);\n  const skills = entries.filter((entry) => entry.kind === 'skill');\n  const tools = entries.filter((entry) => entry.kind === 'tool');\n  const diagnostics = entries\n    .filter((entry) => enabled && entry.reason && entry.reason !== 'inactive')\n    .map((entry) => ({ source: entry.source, code: `HELP_${entry.reason!.replaceAll('-', '_').toUpperCase()}` }));\n  const ready = snapshot.ready;\n  return {\n    activation: !enabled ? 'inactive' : !ready ? 'activating' : diagnostics.length ? 'degraded' : 'active',\n    ready,\n    revision: snapshot.revision,\n    counts: {\n      skills: ready ? skills.filter((entry) => entry.active && entry.discoverable).length : null,\n      tools: tools.filter((entry) => entry.active).length,\n    },\n    skills: skills.slice(0, HELP_STATUS_LIMIT).map(({ name, source, active, discoverable, reason }) => ({\n      name,\n      source,\n      active: active && discoverable,\n      ...(reason ? { reason } : {}),\n    })),\n    tools: tools\n      .slice(0, HELP_STATUS_LIMIT)\n      .map(({ name, source, active, reason }) => ({ name, source, active, ...(reason ? { reason } : {}) })),\n    diagnostics: diagnostics.slice(0, HELP_STATUS_LIMIT),\n    packages: enabled ? packageFailures.slice(-HELP_STATUS_LIMIT) : [],\n    truncated:\n      skills.length > HELP_STATUS_LIMIT ||\n      tools.length > HELP_STATUS_LIMIT ||\n      diagnostics.length > HELP_STATUS_LIMIT ||\n      (enabled && packageFailures.length > HELP_STATUS_LIMIT),\n  };\n}\n\nexport function helpStatusDetail(report: HelpStatusReport): string {\n  return `${report.counts.skills ?? 'pending'} Help skills, ${report.counts.tools} diagnostic tools${report.diagnostics.length ? ' (diagnostics available)' : ''}`;\n}\n\nexport function createHelpStatusTool(\n  inspect: () => HelpStatusReport | Promise<HelpStatusReport>,\n  authorize: (signal?: AbortSignal) => AbortSignal,\n) {\n  return defineTool({\n    name: HELP_STATUS_TOOL_NAME,\n    description: HELP_STATUS_TOOL_DESCRIPTION,\n    parameters: helpStatusParameters,\n    when: HELP_WHEN,\n    promptGuidelines: [HELP_GUIDANCE],\n    async execute(_input, execution) {\n      const signal = authorize(execution.signal);\n      const report = await inspect();\n      signal.throwIfAborted();\n      authorize(execution.signal);\n      return { content: [{ type: 'text', text: JSON.stringify(report, null, 2) }], details: report };\n    },\n  });\n}\n","import type { PoCodemodeNamespace } from '@agimon-ai/po-core/codemode';\nimport type { PoHeadlessRefreshAxis } from '@agimon-ai/po-core/headless';\n\nimport type { SelfImproveNamespaceOptions, SelfImproveOperation, SelfImproveScope } from './type';\n\n/** Finished operations kept for `operation(id)`; older ones are forgotten first. */\nconst MAX_OPERATIONS = 20;\nconst SCOPES: readonly SelfImproveScope[] = ['session', 'workspace', 'global'];\nconst AXES: readonly PoHeadlessRefreshAxis[] = ['majorMode', 'domains', 'profile'];\n\nconst DECLARATIONS = `type Scope = 'session' | 'workspace' | 'global';\ntype Axis = 'majorMode' | 'domains' | 'profile';\ninterface PackageFailure { scope: string; packageName: string; stage: string; reason: string; previous?: 'restored' | 'lost' | 'none'; at: string }\ninterface Operation {\n  operationId: string; scope: Scope; axes?: Axis[];\n  /** partial: applied, but some packages failed and keep their previous build when they had one. */\n  state: 'queued' | 'applied' | 'partial' | 'failed';\n  result?: { installed: string[]; removed: string[]; failed: { packageName: string; reason: string }[] };\n  error?: string;\n}\ndeclare const selfImprove: {\n  /** Packages whose current build failed to load or install, by scope. */\n  plugins(): Promise<{ failures: PackageFailure[] }>;\n  /** Queues a reload of one scope's packages from disk; check it with operation() in a later exec. global needs confirm: true, after the person agreed. */\n  reload(input: { scope: Scope; confirm?: boolean }): Promise<Operation>;\n  /** Queues a re-apply of this session's current major mode, domains or profile (default: all three) after editing their config; check it with operation(). */\n  refresh(input?: { axes?: Axis[] }): Promise<Operation>;\n  operation(operationId: string): Promise<Operation>;\n};`;\n\nexport function createSelfImproveNamespace(options: SelfImproveNamespaceOptions): PoCodemodeNamespace {\n  const operations = new Map<string, SelfImproveOperation>();\n  let next = 0;\n  const remember = (operation: SelfImproveOperation): SelfImproveOperation => {\n    operations.set(operation.operationId, operation);\n    for (const id of operations.keys()) {\n      if (operations.size <= MAX_OPERATIONS) break;\n      if (operations.get(id)?.state !== 'queued') operations.delete(id);\n    }\n    return operation;\n  };\n  return {\n    name: 'selfImprove',\n    summary:\n      \"Reload Po's own packages after editing them, or refresh this session's mode, domains and profile config, without restarting. Help mode, main agent only.\",\n    declarations: DECLARATIONS,\n    bind(run) {\n      if (run.sessionId !== options.sessionId) throw new Error('The selfImprove namespace belongs to another session.');\n      const check = () => {\n        run.signal.throwIfAborted();\n        options.assertActive();\n        if (run.caller !== 'main') throw new Error('Only the main agent may reload or refresh Po.');\n      };\n      return {\n        plugins: async () => {\n          check();\n          return { failures: JSON.parse(JSON.stringify(options.failures())) as unknown };\n        },\n        reload: async (input: unknown) => {\n          check();\n          const { scope, confirm } = (input ?? {}) as { scope?: unknown; confirm?: unknown };\n          if (!SCOPES.includes(scope as SelfImproveScope))\n            throw new Error(\"reload needs scope 'session', 'workspace' or 'global'.\");\n          if (scope === 'global' && confirm !== true)\n            throw new Error('A global reload changes every session; ask the person, then pass confirm: true.');\n          const operationId = `reload-${String(++next)}`;\n          const queued = remember({ operationId, scope: scope as SelfImproveScope, state: 'queued' });\n          // Not awaited: a session reload waits for this tool round to end.\n          void options.service.reload({ scope: queued.scope, sessionId: options.sessionId }).then(\n            (result) =>\n              remember({\n                ...queued,\n                state: result.failed.length === 0 ? 'applied' : 'partial',\n                result: JSON.parse(JSON.stringify(result)) as SelfImproveOperation['result'],\n              }),\n            (error: unknown) =>\n              remember({ ...queued, state: 'failed', error: error instanceof Error ? error.message : String(error) }),\n          );\n          return { ...queued };\n        },\n        refresh: async (input: unknown) => {\n          check();\n          const { axes = AXES } = (input ?? {}) as { axes?: unknown };\n          if (\n            !Array.isArray(axes) ||\n            axes.length === 0 ||\n            !axes.every((axis) => AXES.includes(axis as PoHeadlessRefreshAxis))\n          )\n            throw new Error(\"refresh axes are 'majorMode', 'domains' and 'profile'.\");\n          const queued = remember({\n            operationId: `refresh-${String(++next)}`,\n            scope: 'session',\n            axes: [...new Set(axes as PoHeadlessRefreshAxis[])],\n            state: 'queued',\n          });\n          // Not awaited: the refresh waits for this tool round to end.\n          void options.service.refresh({ sessionId: options.sessionId, axes: queued.axes! }).then(\n            () => remember({ ...queued, state: 'applied' }),\n            (error: unknown) =>\n              remember({ ...queued, state: 'failed', error: error instanceof Error ? error.message : String(error) }),\n          );\n          return JSON.parse(JSON.stringify(queued)) as SelfImproveOperation;\n        },\n        operation: async (operationId: unknown) => {\n          check();\n          const operation = typeof operationId === 'string' ? operations.get(operationId) : undefined;\n          if (operation === undefined) throw new Error(`No operation '${String(operationId)}'.`);\n          return JSON.parse(JSON.stringify(operation)) as SelfImproveOperation;\n        },\n      };\n    },\n  };\n}\n","import { PO_CODEMODE_SERVICE, readPoCodemode } from '@agimon-ai/po-core/codemode';\nimport type { PoHeadlessCommand, PoHeadlessHostService, PoHeadlessResource } from '@agimon-ai/po-core/headless';\nimport { PO_HELP_WHEN as HELP_WHEN, type PoPackageFailureRecord, type PoSelfImprove } from '@agimon-ai/po-core/help';\nimport {\n  type PoServerPluginContext,\n  type PoServerSessionPlugin,\n  packageResourcePath,\n  readPackageResource,\n} from '@agimon-ai/po-core/serverPlugin';\nimport { defineMinorMode, serverMinorModes, type MinorModeOwner, type MinorModeState } from '@agimon-ai/po-minor-mode';\n\nimport {\n  HELP_COMMAND_DESCRIPTION,\n  HELP_COMMAND_NAME,\n  HELP_GUIDANCE,\n  HELP_MODE_ID,\n  HELP_PACKAGE_SOURCE,\n  HELP_CHATGPT_SKILL,\n  HELP_CODEMODE_SKILL,\n  HELP_NATIVE_SKILL,\n  HELP_SELF_IMPROVE_SKILL,\n  HELP_SKILL,\n} from '../../constants/help';\nimport { createHelpStatusTool, helpStatusDetail, serverHelpStatus } from '../helpStatus';\nimport { createSelfImproveNamespace } from '../selfImproveNamespace';\nexport function createHelpServerSession(\n  host: PoHeadlessHostService,\n  packageFailures: () => readonly PoPackageFailureRecord[] = () => [],\n  /** The host's package reload; without it (edge, tests) Help offers no selfImprove namespace. */\n  selfImprove?: PoSelfImprove,\n): PoServerSessionPlugin {\n  let modeOwner: MinorModeOwner | undefined;\n  let pending: boolean | undefined;\n  let failure: string | undefined;\n  let generation = 0;\n  let disposed = false;\n  const active = () => (host.context.selection.state?.['minor-mode'] ?? []).includes(HELP_MODE_ID);\n  const inspect = () => serverHelpStatus(host.inspectCapabilities(), active(), packageFailures());\n  const modeState = (): MinorModeState => {\n    const report = inspect();\n    return {\n      activation: pending === true ? 'activating' : active() ? 'active' : 'inactive',\n      condition:\n        pending !== undefined || !report.ready\n          ? 'queued'\n          : failure\n            ? 'failed'\n            : report.activation === 'degraded'\n              ? 'degraded'\n              : 'ready',\n      ...(pending !== undefined\n        ? { detail: 'applying Help capabilities' }\n        : failure\n          ? { detail: failure }\n          : active()\n            ? { detail: helpStatusDetail(report) }\n            : {}),\n      actions: [\n        {\n          id: 'activate',\n          enabled: !active() && pending === undefined,\n          ...(!active() && pending === undefined ? {} : { disabledReason: 'Help is active or changing.' }),\n        },\n        {\n          id: 'deactivate',\n          enabled: active() || pending === true,\n          ...(active() || pending === true ? {} : { disabledReason: 'Help mode is not active.' }),\n        },\n      ],\n    };\n  };\n  const resources: PoHeadlessResource[] = [\n    { when: HELP_WHEN, name: 'po-help', kind: 'context', read: () => HELP_GUIDANCE },\n    {\n      when: HELP_WHEN,\n      ...HELP_SKILL,\n      kind: 'skill',\n      path: packageResourcePath(import.meta.url, 'src/prompts/help-how-to-help/SKILL.md'),\n      read: async () => {\n        const text = await readPackageResource(import.meta.url, 'src/prompts/help-how-to-help/SKILL.md');\n        if (!text.trim()) throw new Error('The installed Help skill is missing or unreadable.');\n        return text;\n      },\n    },\n    {\n      when: HELP_WHEN,\n      ...HELP_CHATGPT_SKILL,\n      kind: 'skill',\n      path: packageResourcePath(import.meta.url, 'src/prompts/help-how-to-chatgpt-instructions/SKILL.md'),\n      read: async () => {\n        const text = await readPackageResource(\n          import.meta.url,\n          'src/prompts/help-how-to-chatgpt-instructions/SKILL.md',\n        );\n        if (!text.trim()) throw new Error('The installed ChatGPT instruction skill is missing or unreadable.');\n        return text;\n      },\n    },\n    {\n      when: HELP_WHEN,\n      ...HELP_NATIVE_SKILL,\n      kind: 'skill',\n      path: packageResourcePath(import.meta.url, 'src/prompts/help-how-to-native-extension/SKILL.md'),\n      read: async () => {\n        const text = await readPackageResource(import.meta.url, 'src/prompts/help-how-to-native-extension/SKILL.md');\n        if (!text.trim()) throw new Error('The installed native extension skill is missing or unreadable.');\n        return text;\n      },\n    },\n    {\n      when: HELP_WHEN,\n      ...HELP_CODEMODE_SKILL,\n      kind: 'skill',\n      path: packageResourcePath(import.meta.url, 'src/prompts/help-how-to-codemode-plugin/SKILL.md'),\n      read: async () => {\n        const text = await readPackageResource(import.meta.url, 'src/prompts/help-how-to-codemode-plugin/SKILL.md');\n        if (!text.trim()) throw new Error('The installed code-mode plugin skill is missing or unreadable.');\n        return text;\n      },\n    },\n    // Pinned like every code-mode guide, but listed only where the host can reload and Help is on.\n    ...(selfImprove === undefined\n      ? []\n      : [\n          {\n            when: HELP_WHEN,\n            ...HELP_SELF_IMPROVE_SKILL,\n            kind: 'skill' as const,\n            pinned: true,\n            path: packageResourcePath(import.meta.url, 'src/prompts/codemode-how-to-self-improve/SKILL.md'),\n            read: () => readPackageResource(import.meta.url, 'src/prompts/codemode-how-to-self-improve/SKILL.md'),\n          },\n        ]),\n  ];\n  const selectMode = async (enabled: boolean, signal?: AbortSignal): Promise<void> => {\n    if (disposed) throw new Error('Help runtime is disposed.');\n    signal?.throwIfAborted();\n    const operation = ++generation;\n    pending = enabled;\n    failure = undefined;\n    modeOwner?.publish();\n    try {\n      if (enabled) await resources[1]!.read(host.context);\n      signal?.throwIfAborted();\n      if (operation !== generation || disposed) throw new Error('Help activation was cancelled.');\n      const modes = (host.context.selection.state?.['minor-mode'] ?? []).filter((mode) => mode !== HELP_MODE_ID);\n      await host.changeSelection({\n        axis: 'state',\n        key: 'minor-mode',\n        values: enabled ? [...modes, HELP_MODE_ID] : modes,\n      });\n    } catch (error) {\n      if (operation === generation) failure = (error instanceof Error ? error.message : String(error)).slice(0, 160);\n      throw error;\n    } finally {\n      if (operation === generation) {\n        pending = undefined;\n        modeOwner?.publish();\n      }\n    }\n  };\n  const command: PoHeadlessCommand = {\n    name: HELP_COMMAND_NAME,\n    description: HELP_COMMAND_DESCRIPTION,\n    async execute(_args, execution) {\n      await selectMode(!(pending ?? active()));\n      await execution.client.notify({\n        title: 'Po Help',\n        body: active() ? 'Help mode activated.' : 'Help mode deactivated.',\n        level: 'info',\n      });\n    },\n  };\n  modeOwner = defineMinorMode({\n    descriptor: {\n      source: HELP_PACKAGE_SOURCE,\n      id: HELP_MODE_ID,\n      label: 'Help',\n      description: 'Package guidance and read-only diagnostics for agent setup and debugging.',\n      order: 50,\n      actions: [\n        {\n          id: 'activate',\n          label: 'Activate',\n          description: 'Expose Help guidance and diagnostic tools.',\n          contexts: ['headless'],\n          parameters: [],\n        },\n        {\n          id: 'deactivate',\n          label: 'Deactivate',\n          description: 'Withdraw Help-only guidance and diagnostic tools.',\n          contexts: ['headless'],\n          parameters: [],\n        },\n      ],\n    },\n    state: modeState,\n    async handleAction(_runtime, actionId, _argumentsValue, { signal }) {\n      if (actionId !== 'activate' && actionId !== 'deactivate')\n        throw new Error(`Unknown Help mode action: ${actionId}`);\n      await selectMode(actionId === 'activate', signal);\n      return { message: active() ? 'Help mode activated.' : 'Help mode deactivated.' };\n    },\n  }).createOwner(undefined);\n  const assertHelpActive = () => {\n    host.assertActive(HELP_PACKAGE_SOURCE);\n    if (disposed || !active()) throw new Error('Help mode is not active.');\n  };\n  // Registered only while Help is on: the activity starts with Help and stops when it is withdrawn.\n  const selfImproveService = (cordis: PoServerPluginContext['context']) => {\n    cordis.inject([PO_CODEMODE_SERVICE], (scoped) => {\n      const codemode = readPoCodemode(scoped);\n      if (!codemode || !selfImprove) return undefined;\n      const namespace = createSelfImproveNamespace({\n        sessionId: host.context.sessionId,\n        service: selfImprove,\n        failures: packageFailures,\n        assertActive: assertHelpActive,\n      });\n      const activity = host.registerActivity({\n        when: HELP_WHEN,\n        name: 'selfImprove',\n        start: () => {\n          const registration = codemode.register(HELP_PACKAGE_SOURCE, namespace);\n          return () => registration.dispose();\n        },\n      });\n      return () => activity.dispose();\n    });\n  };\n  return {\n    services: [serverMinorModes([modeOwner]), ...(selfImprove ? [selfImproveService] : [])],\n    resources,\n    commands: [command],\n    tools: [\n      createHelpStatusTool(inspect, (signal) => {\n        signal?.throwIfAborted();\n        host.assertActive(HELP_PACKAGE_SOURCE);\n        if (disposed || !active()) throw new Error('Help mode is not active.');\n        return signal ?? new AbortController().signal;\n      }),\n    ],\n    onDispose() {\n      disposed = true;\n      generation += 1;\n    },\n  };\n}\n","import { readPoPackageHealth, readPoSelfImprove } from '@agimon-ai/po-core/help';\nimport type { PoServerPluginDefinition, PoServerSessionPlugin } from '@agimon-ai/po-core/serverPlugin';\n\nimport { createHelpServerSession } from '../../../../../services/helpServerSession';\n\nexport default (({ agent, context }): Partial<PoServerSessionPlugin> =>\n  agent\n    ? createHelpServerSession(agent, () => readPoPackageHealth(context)?.failures() ?? [], readPoSelfImprove(context))\n    : {}) satisfies NonNullable<PoServerPluginDefinition['session']>;\n","import { defineRoot } from '@agimon-ai/po-core/extensionFile';\nimport type { PoServerPluginContext } from '@agimon-ai/po-core/serverPlugin';\n\nimport runtime from './_lib/runtime.server';\n\nexport default defineRoot((context: PoServerPluginContext) => {\n  const value = runtime(context);\n  return {\n    value,\n    services: value.services,\n    activities: value.activities,\n    onStart: value.onStart,\n    onStop: value.onStop,\n    onDispose: value.onDispose,\n  };\n});\n","import { defineRoutedContribution, 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, Partial<PoServerSessionPlugin>>) => context.root.commands?.[0],\n  { cardinality: 'optional' },\n);\n","import { defineRoutedContribution, type WithRoot } from '@agimon-ai/po-core/extensionFile';\nimport type { PoServerPluginContext, PoServerSessionPlugin } from '@agimon-ai/po-core/serverPlugin';\n\n// Present only where the host binds package reload; see createHelpServerSession.\nexport default defineRoutedContribution(\n  (context: WithRoot<PoServerPluginContext, Partial<PoServerSessionPlugin>>) => context.root.resources?.[5],\n  { cardinality: 'optional' },\n);\n","import { defineRoutedContribution, 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, Partial<PoServerSessionPlugin>>) => context.root.resources?.[4],\n  { cardinality: 'optional' },\n);\n","import { defineRoutedContribution, 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, Partial<PoServerSessionPlugin>>) => context.root.resources?.[3],\n  { cardinality: 'optional' },\n);\n","import { defineRoutedContribution, 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, Partial<PoServerSessionPlugin>>) => context.root.resources?.[0],\n  { cardinality: 'optional' },\n);\n","import { defineRoutedContribution, 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, Partial<PoServerSessionPlugin>>) => context.root.resources?.[2],\n  { cardinality: 'optional' },\n);\n","import { defineRoutedContribution, 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, Partial<PoServerSessionPlugin>>) => context.root.resources?.[1],\n  { cardinality: 'optional' },\n);\n","import { defineRoutedContribution, 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, Partial<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 commandPoHelp from '../src/extensions/workspaces/sessions/(backend)/command/po-help.server';\nimport resourceCodemodeHowToSelfImprove from '../src/extensions/workspaces/sessions/(backend)/resource/codemode-how-to-self-improve.server';\nimport resourcePoDevelopCodemodePlugin from '../src/extensions/workspaces/sessions/(backend)/resource/po-develop-codemode-plugin.server';\nimport resourcePoDevelopNativeExtension from '../src/extensions/workspaces/sessions/(backend)/resource/po-develop-native-extension.server';\nimport resourcePoHelp from '../src/extensions/workspaces/sessions/(backend)/resource/po-help.server';\nimport resourcePoUseChatgptInstructions from '../src/extensions/workspaces/sessions/(backend)/resource/po-use-chatgpt-instructions.server';\nimport resourcePoUseHelp from '../src/extensions/workspaces/sessions/(backend)/resource/po-use-help.server';\nimport toolHelpStatus from '../src/extensions/workspaces/sessions/(backend)/tool/help_status.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;\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-help',\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 defined([via({ name: 'po-help' }, at(commandPoHelp, contextSession))]); },\n      get resources(): PoServerSessionPlugin['resources'] { return defined([at(resourceCodemodeHowToSelfImprove, contextSession), at(resourcePoDevelopCodemodePlugin, contextSession), at(resourcePoDevelopNativeExtension, contextSession), at(resourcePoHelp, contextSession), at(resourcePoUseChatgptInstructions, contextSession), at(resourcePoUseHelp, contextSession)]); },\n      get tools(): PoServerSessionPlugin['tools'] { return defined([via({ name: 'help_status' }, at(toolHelpStatus, 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/llms.txt

@@ -14,3 +14,4 @@ Activation-gated, package-owned guidance for Po Pi parent sessions.
 
 - [help-how-to-native-extension](./src/prompts/help-how-to-native-extension/SKILL.md): Add phone UI to a Po package that mirrors the cockpit, then approve and verify it.
 - [help-how-to-codemode-plugin](./src/prompts/help-how-to-codemode-plugin/SKILL.md): Add code-mode support to a Po package: a namespace, the tool it replaces, and the skill that teaches agents to use it.
+- [codemode-how-to-self-improve](./src/prompts/codemode-how-to-self-improve/SKILL.md): In Help mode, reload Po's own packages after editing them, without restarting Po or reopening the session.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agimon-ai/po-help",
-  "version": "0.0.0-alpha.41",
+  "version": "0.0.0-alpha.43",
   "description": "Activation-gated package guidance and help skills for Po and Pi extensions.",
   "keywords": [
     "agent-documentation",
@@ -58,16 +58,16 @@
     "access": "public"
   },
   "dependencies": {
-    "@agimon-ai/po-core": "0.0.0-alpha.41",
-    "@agimon-ai/po-minor-mode": "0.0.0-alpha.41",
-    "@agimon-ai/po-web-components": "0.0.0-alpha.41",
+    "@agimon-ai/po-core": "0.0.0-alpha.43",
+    "@agimon-ai/po-minor-mode": "0.0.0-alpha.43",
+    "@agimon-ai/po-web-components": "0.0.0-alpha.43",
     "@deepseek-ai/cordis": "4.0.5",
     "typebox": "1.4.2"
   },
   "devDependencies": {
-    "@agimon-ai/po-build": "0.0.0-alpha.41",
-    "@agimon-ai/vibe-lint-plugin-po-extension": "0.0.0-alpha.41",
-    "@earendil-works/pi-coding-agent": "1.3.0",
+    "@agimon-ai/po-build": "0.0.0-alpha.43",
+    "@agimon-ai/vibe-lint-plugin-po-extension": "0.0.0-alpha.43",
+    "@earendil-works/pi-coding-agent": "1.4.0",
     "@types/node": "26.6.5",
     "@types/react": "19.3.0",
     "@vitest/coverage-v8": "5.0.4",
@@ -78,7 +78,7 @@
     "vitest": "5.0.4"
   },
   "peerDependencies": {
-    "@earendil-works/pi-coding-agent": "1.3.0"
+    "@earendil-works/pi-coding-agent": "1.4.0"
   },
   "peerDependenciesMeta": {
     "@earendil-works/pi-coding-agent": {

package/src/prompts/codemode-how-to-self-improve/SKILL.md

@@ -0,0 +1,41 @@
+---
+name: codemode-how-to-self-improve
+description: "Reload Po's own packages, or refresh this session's mode, domain and profile config, after you edit them, without restarting Po or reopening the session. Use in Help mode after changing a plugin, adding or removing a package, or editing modes.yaml, a domain or a profile."
+---
+
+# Reload Po packages with `selfImprove`
+
+`selfImprove` exists only in Help mode, only for the main agent, and only on hosts that can reload (not the edge). Run `discover({ namespace: 'selfImprove' })` for signatures.
+
+## Where to work
+
+- Develop and test plugins in **workspace** scope. A workspace reload touches only this workspace's sessions.
+- Leave global plugin files alone unless the person asked. Po already picks up saved changes to them, so an edit there reaches every session at once.
+- A reload loads what is on disk. Build the package first; `selfImprove` never runs `npm install` or a build.
+
+## Reloading
+
+1. `selfImprove.reload({ scope })` returns `{ operationId, state: 'queued' }` at once. A session reload applies after the current tool round ends, so do not wait for it in the same `exec`.
+2. In a later `exec`, read `selfImprove.operation(operationId)`:
+   - `applied`: every package installed. Installed packages no longer declared were removed (`result.removed`).
+   - `partial`: some packages failed (`result.failed`) and keep their previous build when they had one.
+   - `failed`: nothing changed; `error` says why.
+3. The model sees new tools on its next request. Old tool handles from before the reload are refused.
+
+`scope: 'global'` changes every session. Ask the person first (for example with `ask_user_question`), and pass `confirm: true` only after they agree. Without it the call is refused and nothing is queued.
+
+## Refreshing config
+
+After editing `modes.yaml`, a domain, or a profile's env or binding, call `selfImprove.refresh({ axes })` with any of `'majorMode'`, `'domains'`, `'profile'` (default: all three). It re-applies the session's current names from disk, so no rename or reopen is needed. It is queued like a reload and applies after the current tool round; read `operation(operationId)` in a later `exec`. A `profile` refresh reconnects its secret provider.
+
+Domain code-mode scripts load once when the session opens; a new or changed domain script needs the session reopened.
+
+## Checking health
+
+`selfImprove.plugins()` lists packages whose current build failed to load or install, by scope, with the reason and whether the previous build still runs. Read it before and after a reload instead of guessing from missing tools.
+
+## Mistakes to avoid
+
+- Calling it from a subagent: refused. Do the reload in the main agent.
+- Retrying in a loop: one failure means fix the code or build, then reload once.
+- Presenting a restart as a reload: if a change needs a restart (provider overrides, MCP plugins), tell the person and let them reopen the session.

package/src/prompts/help-how-to-codemode-plugin/SKILL.md

@@ -11,7 +11,7 @@ Use this when a Po package should be driven from code mode: a `name` global in e
 
 Every package that contributes a namespace ships a skill that teaches an agent to use it. The namespace carries types and one-line reference. The skill carries judgement: when to use it, ordering, what it refuses and why, and the mistakes to avoid. A namespace without a skill is half shipped.
 
-Package how-to guides have two roles, gated differently. A code-mode guide teaches agents to use a plugin through `exec`. Code mode is always available, so its `codemode-how-to-<plugin>` guide carries `pinned: true`, no `when` gate, and is always active. Its summary stays in the system prompt, outside the `load_skill` catalog and `search_skills`; the full body still loads by exact name. Read the base `how-to-codemode` guide first. A `help-how-to-<plugin>` guide, such as this one, teaches how to maintain or modify a plugin, and is gated on Help mode (`when: PO_HELP_WHEN`). Help guides and all other skills remain searchable. Never gate a code-mode guide behind Help.
+Package how-to guides have two roles, gated differently. A code-mode guide teaches agents to use a plugin through `exec`. Code mode is always available, so its `codemode-how-to-<plugin>` guide carries `pinned: true`, no `when` gate, and is always active. A namespace offered only in one mode gates its guide on that mode instead: `selfImprove` on `PO_HELP_WHEN`, and the `computer` namespace on the `computer-use` minor-mode condition. Its summary stays in the system prompt, outside the `load_skill` catalog and `search_skills`; the full body still loads by exact name. Read the base `how-to-codemode` guide first. A `help-how-to-<plugin>` guide, such as this one, teaches how to maintain or modify a plugin, and is gated on Help mode (`when: PO_HELP_WHEN`). Help guides and all other skills remain searchable. Never gate a code-mode guide behind Help.
 
 ## Contribute the namespace