@agimon-ai/po-help 0.0.0-alpha.62 → 0.0.0-alpha.63

package/dist/extensions/server.cjs

@@ -115,6 +115,20 @@ const AXES = [
 	"domains",
 	"profile"
 ];
+const OUTCOME_MESSAGE_TYPE = "po-help/self-improve";
+/** One line the agent can pass on to the person without calling operation(). */
+function describeOutcome(operation) {
+	const what = operation.axes ? `Refresh ${operation.operationId} (${operation.axes.join(", ")})` : `Reload ${operation.operationId} (${operation.scope} scope)`;
+	const tell = "Tell the person the outcome.";
+	if (operation.state === "failed") return `${what} failed, nothing changed: ${(operation.error ?? "unknown error").replace(/\.$/u, "")}. ${tell}`;
+	const result = operation.result;
+	const parts = [
+		result?.installed.length ? `installed ${result.installed.join(", ")}` : "",
+		result?.removed.length ? `removed ${result.removed.join(", ")}` : "",
+		result?.failed.length ? `failed ${result.failed.map((item) => `${item.packageName} (${item.reason})`).join(", ")}, which keep their previous build` : ""
+	].filter(Boolean);
+	return `${what} ${operation.state}${parts.length ? `: ${parts.join("; ")}` : ""}. ${tell}`;
+}
 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 }
@@ -124,13 +138,15 @@ interface Operation {
   state: 'queued' | 'applied' | 'partial' | 'failed';
   result?: { installed: string[]; removed: string[]; failed: { packageName: string; reason: string }[] };
   error?: string;
+  /** Why the outcome follow-up could not reach you, when it did not. */
+  undelivered?: 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. */
+  /** Queues a reload of one scope's packages from disk. When it finishes you get a follow-up message with the outcome; operation() returns it too. 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(). */
+  /** Queues a re-apply of this session's current major mode, domains or profile (default: all three) after editing their config; reports its outcome like reload. */
   refresh(input?: { axes?: Axis[] }): Promise<Operation>;
   operation(operationId: string): Promise<Operation>;
 };`;
@@ -145,6 +161,19 @@ function createSelfImproveNamespace(options) {
 		}
 		return operation;
 	};
+	const finish = (operation) => {
+		remember(operation);
+		Promise.resolve(options.admitMessage?.({
+			type: OUTCOME_MESSAGE_TYPE,
+			text: describeOutcome(operation),
+			display: true
+		}, "followUp")).catch((error) => {
+			remember({
+				...operation,
+				undelivered: error instanceof Error ? error.message : String(error)
+			});
+		});
+	};
 	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.",
@@ -175,11 +204,11 @@ function createSelfImproveNamespace(options) {
 					options.service.reload({
 						scope: queued.scope,
 						sessionId: options.sessionId
-					}).then((result) => remember({
+					}).then((result) => finish({
 						...queued,
 						state: result.failed.length === 0 ? "applied" : "partial",
 						result: JSON.parse(JSON.stringify(result))
-					}), (error) => remember({
+					}), (error) => finish({
 						...queued,
 						state: "failed",
 						error: error instanceof Error ? error.message : String(error)
@@ -199,10 +228,10 @@ function createSelfImproveNamespace(options) {
 					options.service.refresh({
 						sessionId: options.sessionId,
 						axes: queued.axes
-					}).then(() => remember({
+					}).then(() => finish({
 						...queued,
 						state: "applied"
-					}), (error) => remember({
+					}), (error) => finish({
 						...queued,
 						state: "failed",
 						error: error instanceof Error ? error.message : String(error)
@@ -385,7 +414,8 @@ function createHelpServerSession(host, packageFailures = () => [], selfImprove)
 				sessionId: host.context.sessionId,
 				service: selfImprove,
 				failures: packageFailures,
-				assertActive: assertHelpActive
+				assertActive: assertHelpActive,
+				admitMessage: host.context.session.admitMessage?.bind(host.context.session)
 			});
 			const activity = host.registerActivity({
 				when: _agimon_ai_po_core_help.PO_HELP_WHEN,

package/dist/extensions/server.cjs.map

@@ -1 +1 @@
-{"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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"}
+{"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'];\nconst OUTCOME_MESSAGE_TYPE = 'po-help/self-improve';\n\n/** One line the agent can pass on to the person without calling operation(). */\nfunction describeOutcome(operation: SelfImproveOperation): string {\n  const what = operation.axes\n    ? `Refresh ${operation.operationId} (${operation.axes.join(', ')})`\n    : `Reload ${operation.operationId} (${operation.scope} scope)`;\n  const tell = 'Tell the person the outcome.';\n  if (operation.state === 'failed')\n    return `${what} failed, nothing changed: ${(operation.error ?? 'unknown error').replace(/\\.$/u, '')}. ${tell}`;\n  const result = operation.result;\n  const parts = [\n    result?.installed.length ? `installed ${result.installed.join(', ')}` : '',\n    result?.removed.length ? `removed ${result.removed.join(', ')}` : '',\n    result?.failed.length\n      ? `failed ${result.failed.map((item) => `${item.packageName} (${item.reason})`).join(', ')}, which keep their previous build`\n      : '',\n  ].filter(Boolean);\n  return `${what} ${operation.state}${parts.length ? `: ${parts.join('; ')}` : ''}. ${tell}`;\n}\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  /** Why the outcome follow-up could not reach you, when it did not. */\n  undelivered?: 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. When it finishes you get a follow-up message with the outcome; operation() returns it too. 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; reports its outcome like reload. */\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  // The agent hears the outcome on its own instead of being asked whether a queued reload worked.\n  const finish = (operation: SelfImproveOperation) => {\n    remember(operation);\n    void Promise.resolve(\n      options.admitMessage?.(\n        { type: OUTCOME_MESSAGE_TYPE, text: describeOutcome(operation), display: true },\n        'followUp',\n      ),\n    ).catch((error: unknown) => {\n      // A session closed mid-reload cannot take the message; operation(id) reports the outcome and why it was not sent.\n      remember({ ...operation, undelivered: error instanceof Error ? error.message : String(error) });\n    });\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              finish({\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              finish({ ...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            () => finish({ ...queued, state: 'applied' }),\n            (error: unknown) =>\n              finish({ ...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        admitMessage: host.context.session.admitMessage?.bind(host.context.session),\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.mjs

@@ -111,6 +111,20 @@ const AXES = [
 	"domains",
 	"profile"
 ];
+const OUTCOME_MESSAGE_TYPE = "po-help/self-improve";
+/** One line the agent can pass on to the person without calling operation(). */
+function describeOutcome(operation) {
+	const what = operation.axes ? `Refresh ${operation.operationId} (${operation.axes.join(", ")})` : `Reload ${operation.operationId} (${operation.scope} scope)`;
+	const tell = "Tell the person the outcome.";
+	if (operation.state === "failed") return `${what} failed, nothing changed: ${(operation.error ?? "unknown error").replace(/\.$/u, "")}. ${tell}`;
+	const result = operation.result;
+	const parts = [
+		result?.installed.length ? `installed ${result.installed.join(", ")}` : "",
+		result?.removed.length ? `removed ${result.removed.join(", ")}` : "",
+		result?.failed.length ? `failed ${result.failed.map((item) => `${item.packageName} (${item.reason})`).join(", ")}, which keep their previous build` : ""
+	].filter(Boolean);
+	return `${what} ${operation.state}${parts.length ? `: ${parts.join("; ")}` : ""}. ${tell}`;
+}
 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 }
@@ -120,13 +134,15 @@ interface Operation {
   state: 'queued' | 'applied' | 'partial' | 'failed';
   result?: { installed: string[]; removed: string[]; failed: { packageName: string; reason: string }[] };
   error?: string;
+  /** Why the outcome follow-up could not reach you, when it did not. */
+  undelivered?: 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. */
+  /** Queues a reload of one scope's packages from disk. When it finishes you get a follow-up message with the outcome; operation() returns it too. 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(). */
+  /** Queues a re-apply of this session's current major mode, domains or profile (default: all three) after editing their config; reports its outcome like reload. */
   refresh(input?: { axes?: Axis[] }): Promise<Operation>;
   operation(operationId: string): Promise<Operation>;
 };`;
@@ -141,6 +157,19 @@ function createSelfImproveNamespace(options) {
 		}
 		return operation;
 	};
+	const finish = (operation) => {
+		remember(operation);
+		Promise.resolve(options.admitMessage?.({
+			type: OUTCOME_MESSAGE_TYPE,
+			text: describeOutcome(operation),
+			display: true
+		}, "followUp")).catch((error) => {
+			remember({
+				...operation,
+				undelivered: error instanceof Error ? error.message : String(error)
+			});
+		});
+	};
 	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.",
@@ -171,11 +200,11 @@ function createSelfImproveNamespace(options) {
 					options.service.reload({
 						scope: queued.scope,
 						sessionId: options.sessionId
-					}).then((result) => remember({
+					}).then((result) => finish({
 						...queued,
 						state: result.failed.length === 0 ? "applied" : "partial",
 						result: JSON.parse(JSON.stringify(result))
-					}), (error) => remember({
+					}), (error) => finish({
 						...queued,
 						state: "failed",
 						error: error instanceof Error ? error.message : String(error)
@@ -195,10 +224,10 @@ function createSelfImproveNamespace(options) {
 					options.service.refresh({
 						sessionId: options.sessionId,
 						axes: queued.axes
-					}).then(() => remember({
+					}).then(() => finish({
 						...queued,
 						state: "applied"
-					}), (error) => remember({
+					}), (error) => finish({
 						...queued,
 						state: "failed",
 						error: error instanceof Error ? error.message : String(error)
@@ -381,7 +410,8 @@ function createHelpServerSession(host, packageFailures = () => [], selfImprove)
 				sessionId: host.context.sessionId,
 				service: selfImprove,
 				failures: packageFailures,
-				assertActive: assertHelpActive
+				assertActive: assertHelpActive,
+				admitMessage: host.context.session.admitMessage?.bind(host.context.session)
 			});
 			const activity = host.registerActivity({
 				when: PO_HELP_WHEN,

package/dist/extensions/server.mjs.map

@@ -1 +1 @@
-{"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":";;;;;;;AAAA,MAAa,oBAAoB;AACjC,MAAa,2BAA2B;AACxC,MAAa,eAAe;AAC5B,MAAa,sBAAsB;AACnC,MAAa,aAAa;CACxB,MAAM;CACN,aACE;AACJ;AACA,MAAa,gBACX;AACF,MAAa,wBAAwB;AACrC,MAAa,+BACX;AAGF,MAAa,qBAAqB;CAChC,MAAM;CACN,aACE;AACJ;AAEA,MAAa,sBAAsB;CACjC,MAAM;CACN,aACE;AACJ;AAEA,MAAa,oBAAoB;CAC/B,MAAM;CACN,aACE;AACJ;AAEA,MAAa,0BAA0B;CACrC,MAAM;CACN,aACE;AACJ;;;ACpCA,MAAa,uBAAuB,KAAK,OAAO,CAAC,GAAG,EAAE,sBAAsB,MAAM,CAAC;;;;ACanF,SAAgB,iBACd,UACA,SACA,kBAAqD,CAAC,GACpC;CAClB,MAAM,UAAU,SAAS,aAAa,QAAQ,UAAU,MAAM,MAAM,QAAQ,kBAAkB,YAAY;CAC1G,MAAM,SAAS,QAAQ,QAAQ,UAAU,MAAM,SAAS,OAAO;CAC/D,MAAM,QAAQ,QAAQ,QAAQ,UAAU,MAAM,SAAS,MAAM;CAC7D,MAAM,cAAc,QACjB,QAAQ,UAAU,WAAW,MAAM,UAAU,MAAM,WAAW,UAAU,CAAC,CACzE,KAAK,WAAW;EAAE,QAAQ,MAAM;EAAQ,MAAM,QAAQ,MAAM,OAAQ,WAAW,KAAK,GAAG,CAAC,CAAC,YAAY;CAAI,EAAE;CAC9G,MAAM,QAAQ,SAAS;CACvB,OAAO;EACL,YAAY,CAAC,UAAU,aAAa,CAAC,QAAQ,eAAe,YAAY,SAAS,aAAa;EAC9F;EACA,UAAU,SAAS;EACnB,QAAQ;GACN,QAAQ,QAAQ,OAAO,QAAQ,UAAU,MAAM,UAAU,MAAM,YAAY,CAAC,CAAC,SAAS;GACtF,OAAO,MAAM,QAAQ,UAAU,MAAM,MAAM,CAAC,CAAC;EAC/C;EACA,QAAQ,OAAO,MAAM,GAAA,GAAoB,CAAC,CAAC,KAAK,EAAE,MAAM,QAAQ,QAAQ,cAAc,cAAc;GAClG;GACA;GACA,QAAQ,UAAU;GAClB,GAAI,SAAS,EAAE,OAAO,IAAI,CAAC;EAC7B,EAAE;EACF,OAAO,MACJ,MAAM,GAAA,GAAoB,CAAC,CAC3B,KAAK,EAAE,MAAM,QAAQ,QAAQ,cAAc;GAAE;GAAM;GAAQ;GAAQ,GAAI,SAAS,EAAE,OAAO,IAAI,CAAC;EAAG,EAAE;EACtG,aAAa,YAAY,MAAM,GAAA,GAAoB;EACnD,UAAU,UAAU,gBAAgB,MAAM,IAAkB,IAAI,CAAC;EACjE,WACE,OAAO,SAAA,OACP,MAAM,SAAA,OACN,YAAY,SAAA,OACX,WAAW,gBAAgB,SAAA;CAChC;AACF;AAEA,SAAgB,iBAAiB,QAAkC;CACjE,OAAO,GAAG,OAAO,OAAO,UAAU,UAAU,gBAAgB,OAAO,OAAO,MAAM,mBAAmB,OAAO,YAAY,SAAS,6BAA6B;AAC9J;AAEA,SAAgB,qBACd,SACA,WACA;CACA,OAAO,WAAW;EAChB,MAAM;EACN,aAAa;EACb,YAAY;EACZ,MAAMA;EACN,kBAAkB,CAAC,aAAa;EAChC,MAAM,QAAQ,QAAQ,WAAW;GAC/B,MAAM,SAAS,UAAU,UAAU,MAAM;GACzC,MAAM,SAAS,MAAM,QAAQ;GAC7B,OAAO,eAAe;GACtB,UAAU,UAAU,MAAM;GAC1B,OAAO;IAAE,SAAS,CAAC;KAAE,MAAM;KAAQ,MAAM,KAAK,UAAU,QAAQ,MAAM,CAAC;IAAE,CAAC;IAAG,SAAS;GAAO;EAC/F;CACF,CAAC;AACH;;;;ACtEA,MAAM,iBAAiB;AACvB,MAAM,SAAsC;CAAC;CAAW;CAAa;AAAQ;AAC7E,MAAM,OAAyC;CAAC;CAAa;CAAW;AAAS;AAEjF,MAAM,eAAe;;;;;;;;;;;;;;;;;;;AAoBrB,SAAgB,2BAA2B,SAA2D;CACpG,MAAM,6BAAa,IAAI,IAAkC;CACzD,IAAI,OAAO;CACX,MAAM,YAAY,cAA0D;EAC1E,WAAW,IAAI,UAAU,aAAa,SAAS;EAC/C,KAAK,MAAM,MAAM,WAAW,KAAK,GAAG;GAClC,IAAI,WAAW,QAAQ,gBAAgB;GACvC,IAAI,WAAW,IAAI,EAAE,CAAC,EAAE,UAAU,UAAU,WAAW,OAAO,EAAE;EAClE;EACA,OAAO;CACT;CACA,OAAO;EACL,MAAM;EACN,SACE;EACF,cAAc;EACd,KAAK,KAAK;GACR,IAAI,IAAI,cAAc,QAAQ,WAAW,MAAM,IAAI,MAAM,uDAAuD;GAChH,MAAM,cAAc;IAClB,IAAI,OAAO,eAAe;IAC1B,QAAQ,aAAa;IACrB,IAAI,IAAI,WAAW,QAAQ,MAAM,IAAI,MAAM,+CAA+C;GAC5F;GACA,OAAO;IACL,SAAS,YAAY;KACnB,MAAM;KACN,OAAO,EAAE,UAAU,KAAK,MAAM,KAAK,UAAU,QAAQ,SAAS,CAAC,CAAC,EAAa;IAC/E;IACA,QAAQ,OAAO,UAAmB;KAChC,MAAM;KACN,MAAM,EAAE,OAAO,YAAa,SAAS,CAAC;KACtC,IAAI,CAAC,OAAO,SAAS,KAAyB,GAC5C,MAAM,IAAI,MAAM,wDAAwD;KAC1E,IAAI,UAAU,YAAY,YAAY,MACpC,MAAM,IAAI,MAAM,iFAAiF;KACnG,MAAM,cAAc,UAAU,OAAO,EAAE,IAAI;KAC3C,MAAM,SAAS,SAAS;MAAE;MAAoB;MAA2B,OAAO;KAAS,CAAC;KAE1F,QAAa,QAAQ,OAAO;MAAE,OAAO,OAAO;MAAO,WAAW,QAAQ;KAAU,CAAC,CAAC,CAAC,MAChF,WACC,SAAS;MACP,GAAG;MACH,OAAO,OAAO,OAAO,WAAW,IAAI,YAAY;MAChD,QAAQ,KAAK,MAAM,KAAK,UAAU,MAAM,CAAC;KAC3C,CAAC,IACF,UACC,SAAS;MAAE,GAAG;MAAQ,OAAO;MAAU,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;KAAE,CAAC,CAC1G;KACA,OAAO,EAAE,GAAG,OAAO;IACrB;IACA,SAAS,OAAO,UAAmB;KACjC,MAAM;KACN,MAAM,EAAE,OAAO,SAAU,SAAS,CAAC;KACnC,IACE,CAAC,MAAM,QAAQ,IAAI,KACnB,KAAK,WAAW,KAChB,CAAC,KAAK,OAAO,SAAS,KAAK,SAAS,IAA6B,CAAC,GAElE,MAAM,IAAI,MAAM,wDAAwD;KAC1E,MAAM,SAAS,SAAS;MACtB,aAAa,WAAW,OAAO,EAAE,IAAI;MACrC,OAAO;MACP,MAAM,CAAC,GAAG,IAAI,IAAI,IAA+B,CAAC;MAClD,OAAO;KACT,CAAC;KAED,QAAa,QAAQ,QAAQ;MAAE,WAAW,QAAQ;MAAW,MAAM,OAAO;KAAM,CAAC,CAAC,CAAC,WAC3E,SAAS;MAAE,GAAG;MAAQ,OAAO;KAAU,CAAC,IAC7C,UACC,SAAS;MAAE,GAAG;MAAQ,OAAO;MAAU,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;KAAE,CAAC,CAC1G;KACA,OAAO,KAAK,MAAM,KAAK,UAAU,MAAM,CAAC;IAC1C;IACA,WAAW,OAAO,gBAAyB;KACzC,MAAM;KACN,MAAM,YAAY,OAAO,gBAAgB,WAAW,WAAW,IAAI,WAAW,IAAI,KAAA;KAClF,IAAI,cAAc,KAAA,GAAW,MAAM,IAAI,MAAM,iBAAiB,OAAO,WAAW,EAAE,GAAG;KACrF,OAAO,KAAK,MAAM,KAAK,UAAU,SAAS,CAAC;IAC7C;GACF;EACF;CACF;AACF;;;ACvFA,SAAgB,wBACd,MACA,wBAAiE,CAAC,GAElE,aACuB;CACvB,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI,aAAa;CACjB,IAAI,WAAW;CACf,MAAM,gBAAgB,KAAK,QAAQ,UAAU,QAAQ,iBAAiB,CAAC,EAAA,CAAG,SAAS,YAAY;CAC/F,MAAM,gBAAgB,iBAAiB,KAAK,oBAAoB,GAAG,OAAO,GAAG,gBAAgB,CAAC;CAC9F,MAAM,kBAAkC;EACtC,MAAM,SAAS,QAAQ;EACvB,OAAO;GACL,YAAY,YAAY,OAAO,eAAe,OAAO,IAAI,WAAW;GACpE,WACE,YAAY,KAAA,KAAa,CAAC,OAAO,QAC7B,WACA,UACE,WACA,OAAO,eAAe,aACpB,aACA;GACV,GAAI,YAAY,KAAA,IACZ,EAAE,QAAQ,6BAA6B,IACvC,UACE,EAAE,QAAQ,QAAQ,IAClB,OAAO,IACL,EAAE,QAAQ,iBAAiB,MAAM,EAAE,IACnC,CAAC;GACT,SAAS,CACP;IACE,IAAI;IACJ,SAAS,CAAC,OAAO,KAAK,YAAY,KAAA;IAClC,GAAI,CAAC,OAAO,KAAK,YAAY,KAAA,IAAY,CAAC,IAAI,EAAE,gBAAgB,8BAA8B;GAChG,GACA;IACE,IAAI;IACJ,SAAS,OAAO,KAAK,YAAY;IACjC,GAAI,OAAO,KAAK,YAAY,OAAO,CAAC,IAAI,EAAE,gBAAgB,2BAA2B;GACvF,CACF;EACF;CACF;CACA,MAAM,YAAkC;EACtC;GAAE,MAAMC;GAAW,MAAM;GAAW,MAAM;GAAW,YAAY;EAAc;EAC/E;GACE,MAAMA;GACN,GAAG;GACH,MAAM;GACN,MAAM,oBAAoB,YAAY,KAAK,uCAAuC;GAClF,MAAM,YAAY;IAChB,MAAM,OAAO,MAAM,oBAAoB,YAAY,KAAK,uCAAuC;IAC/F,IAAI,CAAC,KAAK,KAAK,GAAG,MAAM,IAAI,MAAM,oDAAoD;IACtF,OAAO;GACT;EACF;EACA;GACE,MAAMA;GACN,GAAG;GACH,MAAM;GACN,MAAM,oBAAoB,YAAY,KAAK,uDAAuD;GAClG,MAAM,YAAY;IAChB,MAAM,OAAO,MAAM,oBACjB,YAAY,KACZ,uDACF;IACA,IAAI,CAAC,KAAK,KAAK,GAAG,MAAM,IAAI,MAAM,mEAAmE;IACrG,OAAO;GACT;EACF;EACA;GACE,MAAMA;GACN,GAAG;GACH,MAAM;GACN,MAAM,oBAAoB,YAAY,KAAK,mDAAmD;GAC9F,MAAM,YAAY;IAChB,MAAM,OAAO,MAAM,oBAAoB,YAAY,KAAK,mDAAmD;IAC3G,IAAI,CAAC,KAAK,KAAK,GAAG,MAAM,IAAI,MAAM,gEAAgE;IAClG,OAAO;GACT;EACF;EACA;GACE,MAAMA;GACN,GAAG;GACH,MAAM;GACN,MAAM,oBAAoB,YAAY,KAAK,kDAAkD;GAC7F,MAAM,YAAY;IAChB,MAAM,OAAO,MAAM,oBAAoB,YAAY,KAAK,kDAAkD;IAC1G,IAAI,CAAC,KAAK,KAAK,GAAG,MAAM,IAAI,MAAM,gEAAgE;IAClG,OAAO;GACT;EACF;EAEA,GAAI,gBAAgB,KAAA,IAChB,CAAC,IACD,CACE;GACE,MAAMA;GACN,GAAG;GACH,MAAM;GACN,QAAQ;GACR,MAAM,oBAAoB,YAAY,KAAK,mDAAmD;GAC9F,YAAY,oBAAoB,YAAY,KAAK,mDAAmD;EACtG,CACF;CACN;CACA,MAAM,aAAa,OAAO,SAAkB,WAAwC;EAClF,IAAI,UAAU,MAAM,IAAI,MAAM,2BAA2B;EACzD,QAAQ,eAAe;EACvB,MAAM,YAAY,EAAE;EACpB,UAAU;EACV,UAAU,KAAA;EACV,WAAW,QAAQ;EACnB,IAAI;GACF,IAAI,SAAS,MAAM,UAAU,EAAE,CAAE,KAAK,KAAK,OAAO;GAClD,QAAQ,eAAe;GACvB,IAAI,cAAc,cAAc,UAAU,MAAM,IAAI,MAAM,gCAAgC;GAC1F,MAAM,SAAS,KAAK,QAAQ,UAAU,QAAQ,iBAAiB,CAAC,EAAA,CAAG,QAAQ,SAAS,SAAS,YAAY;GACzG,MAAM,KAAK,gBAAgB;IACzB,MAAM;IACN,KAAK;IACL,QAAQ,UAAU,CAAC,GAAG,OAAO,YAAY,IAAI;GAC/C,CAAC;EACH,SAAS,OAAO;GACd,IAAI,cAAc,YAAY,WAAW,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,EAAA,CAAG,MAAM,GAAG,GAAG;GAC7G,MAAM;EACR,UAAU;GACR,IAAI,cAAc,YAAY;IAC5B,UAAU,KAAA;IACV,WAAW,QAAQ;GACrB;EACF;CACF;CACA,MAAM,UAA6B;EACjC,MAAM;EACN,aAAa;EACb,MAAM,QAAQ,OAAO,WAAW;GAC9B,MAAM,WAAW,EAAE,WAAW,OAAO,EAAE;GACvC,MAAM,UAAU,OAAO,OAAO;IAC5B,OAAO;IACP,MAAM,OAAO,IAAI,yBAAyB;IAC1C,OAAO;GACT,CAAC;EACH;CACF;CACA,YAAY,gBAAgB;EAC1B,YAAY;GACV,QAAQ;GACR,IAAI;GACJ,OAAO;GACP,aAAa;GACb,OAAO;GACP,SAAS,CACP;IACE,IAAI;IACJ,OAAO;IACP,aAAa;IACb,UAAU,CAAC,UAAU;IACrB,YAAY,CAAC;GACf,GACA;IACE,IAAI;IACJ,OAAO;IACP,aAAa;IACb,UAAU,CAAC,UAAU;IACrB,YAAY,CAAC;GACf,CACF;EACF;EACA,OAAO;EACP,MAAM,aAAa,UAAU,UAAU,iBAAiB,EAAE,UAAU;GAClE,IAAI,aAAa,cAAc,aAAa,cAC1C,MAAM,IAAI,MAAM,6BAA6B,UAAU;GACzD,MAAM,WAAW,aAAa,YAAY,MAAM;GAChD,OAAO,EAAE,SAAS,OAAO,IAAI,yBAAyB,yBAAyB;EACjF;CACF,CAAC,CAAC,CAAC,YAAY,KAAA,CAAS;CACxB,MAAM,yBAAyB;EAC7B,KAAK,aAAa,mBAAmB;EACrC,IAAI,YAAY,CAAC,OAAO,GAAG,MAAM,IAAI,MAAM,0BAA0B;CACvE;CAEA,MAAM,sBAAsB,WAA6C;EACvE,OAAO,OAAO,CAAC,mBAAmB,IAAI,WAAW;GAC/C,MAAM,WAAW,eAAe,MAAM;GACtC,IAAI,CAAC,YAAY,CAAC,aAAa,OAAO,KAAA;GACtC,MAAM,YAAY,2BAA2B;IAC3C,WAAW,KAAK,QAAQ;IACxB,SAAS;IACT,UAAU;IACV,cAAc;GAChB,CAAC;GACD,MAAM,WAAW,KAAK,iBAAiB;IACrC,MAAMA;IACN,MAAM;IACN,aAAa;KACX,MAAM,eAAe,SAAS,SAAS,qBAAqB,SAAS;KACrE,aAAa,aAAa,QAAQ;IACpC;GACF,CAAC;GACD,aAAa,SAAS,QAAQ;EAChC,CAAC;CACH;CACA,OAAO;EACL,UAAU,CAAC,iBAAiB,CAAC,SAAS,CAAC,GAAG,GAAI,cAAc,CAAC,kBAAkB,IAAI,CAAC,CAAE;EACtF;EACA,UAAU,CAAC,OAAO;EAClB,OAAO,CACL,qBAAqB,UAAU,WAAW;GACxC,QAAQ,eAAe;GACvB,KAAK,aAAa,mBAAmB;GACrC,IAAI,YAAY,CAAC,OAAO,GAAG,MAAM,IAAI,MAAM,0BAA0B;GACrE,OAAO,UAAU,IAAI,gBAAgB,CAAC,CAAC;EACzC,CAAC,CACH;EACA,YAAY;GACV,WAAW;GACX,cAAc;EAChB;CACF;AACF;;;ACnPA,IAAA,2BAAiB,EAAE,OAAO,cACxB,QACI,wBAAwB,aAAa,oBAAoB,OAAO,CAAC,EAAE,SAAS,KAAK,CAAC,GAAG,kBAAkB,OAAO,CAAC,IAC/G,CAAC;;;ACHP,IAAA,sBAAe,YAAY,YAAmC;CAC5D,MAAM,QAAQC,uBAAQ,OAAO;CAC7B,OAAO;EACL;EACA,UAAU,MAAM;EAChB,YAAY,MAAM;EAClB,SAAS,MAAM;EACf,QAAQ,MAAM;EACd,WAAW,MAAM;CACnB;AACF,CAAC;;;ACZD,IAAA,2BAAe,0BACZ,YAA6E,QAAQ,KAAK,WAAW,IACtG,EAAE,aAAa,WAAW,CAC5B;;;ACFA,IAAA,8CAAe,0BACZ,YAA6E,QAAQ,KAAK,YAAY,IACvG,EAAE,aAAa,WAAW,CAC5B;;;ACJA,IAAA,4CAAe,0BACZ,YAA6E,QAAQ,KAAK,YAAY,IACvG,EAAE,aAAa,WAAW,CAC5B;;;ACHA,IAAA,6CAAe,0BACZ,YAA6E,QAAQ,KAAK,YAAY,IACvG,EAAE,aAAa,WAAW,CAC5B;;;ACHA,IAAA,yBAAe,0BACZ,YAA6E,QAAQ,KAAK,YAAY,IACvG,EAAE,aAAa,WAAW,CAC5B;;;ACHA,IAAA,6CAAe,0BACZ,YAA6E,QAAQ,KAAK,YAAY,IACvG,EAAE,aAAa,WAAW,CAC5B;;;ACHA,IAAA,6BAAe,0BACZ,YAA6E,QAAQ,KAAK,YAAY,IACvG,EAAE,aAAa,WAAW,CAC5B;;;ACHA,IAAA,6BAAe,0BACZ,YAA6E,QAAQ,KAAK,QAAQ,IACnG,EAAE,aAAa,WAAW,CAC5B;;;ACUA,MAAM,MAAY,OAA0B,YAC1C,OAAO,UAAU,aAAc,MAAwB,OAAO,IAAI;;AAEpE,MAAM,WAAc,WAClB,OAAO,QAAQ,UAAsB,UAAU,KAAA,CAAS;AAC1D,MAAM,OAAU,UAAmC,UAChD,UAAU,KAAA,IAAY,KAAA,IAAY;CAAE,GAAG;CAAU,GAAI;AAAiB;AAEzE,MAAa,eAAe,mBAAmB;CAC7C,MAAM;CACN,mBAAmB,+BAA+BC,mBAAW;CAC7D,SAAS,mBAAmB,EAAE,SAAS,CAACA,mBAAW,EAAE,CAAC;CACtD,SAAS,OAAO,YAAY;EAC1B,MAAM,eAAe,MAAM,QAAQ,UAAU,WAAWA,qBAAa,OAAO;EAC5E,MAAM,iBAAiB;GAAE,GAAG;GAAS,MAAM,aAAa;EAAM;EAC9D,OAAO;GACL,GAAG,iBAAiB,YAAY;GAChC,IAAI,WAA8C;IAAE,OAAO,QAAQ,CAAC,IAAI,EAAE,MAAM,UAAU,GAAG,GAAGC,0BAAe,cAAc,CAAC,CAAC,CAAC;GAAG;GACnI,IAAI,YAAgD;IAAE,OAAO,QAAQ;KAAC,GAAGC,6CAAkC,cAAc;KAAG,GAAGC,2CAAiC,cAAc;KAAG,GAAGC,4CAAkC,cAAc;KAAG,GAAGC,wBAAgB,cAAc;KAAG,GAAGC,4CAAkC,cAAc;KAAG,GAAGC,4BAAmB,cAAc;IAAC,CAAC;GAAG;GAC1W,IAAI,QAAwC;IAAE,OAAO,QAAQ,CAAC,IAAI,EAAE,MAAM,cAAc,GAAG,GAAGC,4BAAgB,cAAc,CAAC,CAAC,CAAC;GAAG;GAClI,UAAU,CAAC,GAAI,aAAa,YAAY,CAAC,CAAE;GAC3C,IAAI,aAAkD;IAAE,OAAO,CAAC,GAAI,aAAa,cAAc,CAAC,CAAE;GAAG;EACvG;CACF;AACF,CAAC"}
+{"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'];\nconst OUTCOME_MESSAGE_TYPE = 'po-help/self-improve';\n\n/** One line the agent can pass on to the person without calling operation(). */\nfunction describeOutcome(operation: SelfImproveOperation): string {\n  const what = operation.axes\n    ? `Refresh ${operation.operationId} (${operation.axes.join(', ')})`\n    : `Reload ${operation.operationId} (${operation.scope} scope)`;\n  const tell = 'Tell the person the outcome.';\n  if (operation.state === 'failed')\n    return `${what} failed, nothing changed: ${(operation.error ?? 'unknown error').replace(/\\.$/u, '')}. ${tell}`;\n  const result = operation.result;\n  const parts = [\n    result?.installed.length ? `installed ${result.installed.join(', ')}` : '',\n    result?.removed.length ? `removed ${result.removed.join(', ')}` : '',\n    result?.failed.length\n      ? `failed ${result.failed.map((item) => `${item.packageName} (${item.reason})`).join(', ')}, which keep their previous build`\n      : '',\n  ].filter(Boolean);\n  return `${what} ${operation.state}${parts.length ? `: ${parts.join('; ')}` : ''}. ${tell}`;\n}\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  /** Why the outcome follow-up could not reach you, when it did not. */\n  undelivered?: 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. When it finishes you get a follow-up message with the outcome; operation() returns it too. 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; reports its outcome like reload. */\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  // The agent hears the outcome on its own instead of being asked whether a queued reload worked.\n  const finish = (operation: SelfImproveOperation) => {\n    remember(operation);\n    void Promise.resolve(\n      options.admitMessage?.(\n        { type: OUTCOME_MESSAGE_TYPE, text: describeOutcome(operation), display: true },\n        'followUp',\n      ),\n    ).catch((error: unknown) => {\n      // A session closed mid-reload cannot take the message; operation(id) reports the outcome and why it was not sent.\n      remember({ ...operation, undelivered: error instanceof Error ? error.message : String(error) });\n    });\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              finish({\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              finish({ ...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            () => finish({ ...queued, state: 'applied' }),\n            (error: unknown) =>\n              finish({ ...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        admitMessage: host.context.session.admitMessage?.bind(host.context.session),\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/package.json

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

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

@@ -15,8 +15,8 @@ description: "Reload Po's own packages, or refresh this session's mode, domain a
 
 ## 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)`:
+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`. End the round; do not tell the person it is merely queued.
+2. When it finishes, Po sends you a follow-up message with the outcome. Pass it on to the person without being asked. `selfImprove.operation(operationId)` returns the same outcome in a later `exec`:
    - `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.
@@ -26,7 +26,7 @@ description: "Reload Po's own packages, or refresh this session's mode, domain a
 
 ## 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.
+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, applies after the current tool round, and reports its outcome the same way. 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.