@agimon-ai/po-help 0.0.0-alpha.83 → 0.0.0-alpha.85

package/dist/extensions/server.cjs

@@ -32,6 +32,10 @@ const HELP_NATIVE_SKILL = {
 	name: "help-how-to-native-extension",
 	description: "Add or change a Po package's phone UI (.native files, native templates) so it mirrors the cockpit, passes the native build, and is approved and verified before it ships."
 };
+const HELP_DASHBOARD_SKILL = {
+	name: "help-how-to-dashboard-extension",
+	description: "Add plugin sections to Home and Workspace pages with dashboard-tiles on web and native. Choose global or workspace scope, supply tile presentation and navigation, and migrate legacy home-apps cards."
+};
 const HELP_SELF_IMPROVE_SKILL = {
 	name: "codemode-how-to-self-improve",
 	description: "Reload Po's own packages after you edit them, without restarting Po or reopening the session. Use in Help mode after changing a plugin's source or build, or after adding or removing a package."
@@ -333,7 +337,18 @@ function createHelpServerSession(host, packageFailures = () => [], selfImprove)
 			pinned: true,
 			path: (0, _agimon_ai_po_core_serverPlugin.packageResourcePath)(require("url").pathToFileURL(__filename).href, "src/prompts/codemode-how-to-self-improve/SKILL.md"),
 			read: () => (0, _agimon_ai_po_core_serverPlugin.readPackageResource)(require("url").pathToFileURL(__filename).href, "src/prompts/codemode-how-to-self-improve/SKILL.md")
-		}]
+		}],
+		{
+			when: _agimon_ai_po_core_help.PO_HELP_WHEN,
+			...HELP_DASHBOARD_SKILL,
+			kind: "skill",
+			path: (0, _agimon_ai_po_core_serverPlugin.packageResourcePath)(require("url").pathToFileURL(__filename).href, "src/prompts/help-how-to-dashboard-extension/SKILL.md"),
+			read: async () => {
+				const text = await (0, _agimon_ai_po_core_serverPlugin.readPackageResource)(require("url").pathToFileURL(__filename).href, "src/prompts/help-how-to-dashboard-extension/SKILL.md");
+				if (!text.trim()) throw new Error("The installed dashboard extension skill is missing or unreadable.");
+				return text;
+			}
+		}
 	];
 	const selectMode = async (enabled, signal) => {
 		if (disposed) throw new Error("Help runtime is disposed.");
@@ -465,11 +480,14 @@ var root_server_default = (0, _agimon_ai_po_core_extensionFile.defineRoot)((cont
 var po_help_server_default$1 = (0, _agimon_ai_po_core_extensionFile.defineRoutedContribution)((context) => context.root.commands?.[0], { cardinality: "optional" });
 //#endregion
 //#region src/extensions/workspaces/sessions/(backend)/resource/codemode-how-to-self-improve.server.ts
-var codemode_how_to_self_improve_server_default = (0, _agimon_ai_po_core_extensionFile.defineRoutedContribution)((context) => context.root.resources?.[5], { cardinality: "optional" });
+var codemode_how_to_self_improve_server_default = (0, _agimon_ai_po_core_extensionFile.defineRoutedContribution)((context) => context.root.resources?.find((resource) => resource.name === "codemode-how-to-self-improve"), { cardinality: "optional" });
 //#endregion
 //#region src/extensions/workspaces/sessions/(backend)/resource/po-develop-codemode-plugin.server.ts
 var po_develop_codemode_plugin_server_default = (0, _agimon_ai_po_core_extensionFile.defineRoutedContribution)((context) => context.root.resources?.[4], { cardinality: "optional" });
 //#endregion
+//#region src/extensions/workspaces/sessions/(backend)/resource/po-develop-dashboard-extension.server.ts
+var po_develop_dashboard_extension_server_default = (0, _agimon_ai_po_core_extensionFile.defineRoutedContribution)((context) => context.root.resources?.find((resource) => resource.name === "help-how-to-dashboard-extension"), { cardinality: "optional" });
+//#endregion
 //#region src/extensions/workspaces/sessions/(backend)/resource/po-develop-native-extension.server.ts
 var po_develop_native_extension_server_default = (0, _agimon_ai_po_core_extensionFile.defineRoutedContribution)((context) => context.root.resources?.[3], { cardinality: "optional" });
 //#endregion
@@ -512,6 +530,7 @@ const serverPlugin = (0, _agimon_ai_po_core_serverPlugin.defineServerPlugin)({
 				return defined([
 					at(codemode_how_to_self_improve_server_default, contextSession),
 					at(po_develop_codemode_plugin_server_default, contextSession),
+					at(po_develop_dashboard_extension_server_default, contextSession),
 					at(po_develop_native_extension_server_default, contextSession),
 					at(po_help_server_default, contextSession),
 					at(po_use_chatgpt_instructions_server_default, contextSession),

package/dist/extensions/server.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"server.cjs","names":["Type","defineTool","HELP_WHEN","HELP_WHEN","packageResourcePath","readPackageResource","defineMinorMode","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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"}
+{"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","defineRoutedContribution","defineServerPlugin","composeServerProviderOverrides","rootSession","composeRootInjects","composeRootHooks","commandPoHelp","resourceCodemodeHowToSelfImprove","resourcePoDevelopCodemodePlugin","resourcePoDevelopDashboardExtension","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-dashboard-extension.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_DASHBOARD_SKILL = {\n  name: 'help-how-to-dashboard-extension',\n  description:\n    'Add plugin sections to Home and Workspace pages with dashboard-tiles on web and native. Choose global or workspace scope, supply tile presentation and navigation, and migrate legacy home-apps cards.',\n} as const;\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_DASHBOARD_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      when: HELP_WHEN,\n      ...HELP_DASHBOARD_SKILL,\n      kind: 'skill',\n      path: packageResourcePath(import.meta.url, 'src/prompts/help-how-to-dashboard-extension/SKILL.md'),\n      read: async () => {\n        const text = await readPackageResource(import.meta.url, 'src/prompts/help-how-to-dashboard-extension/SKILL.md');\n        if (!text.trim()) throw new Error('The installed dashboard extension skill is missing or unreadable.');\n        return text;\n      },\n    },\n  ];\n  const selectMode = async (enabled: boolean, signal?: AbortSignal): Promise<void> => {\n    if (disposed) throw new Error('Help runtime is disposed.');\n    signal?.throwIfAborted();\n    const operation = ++generation;\n    pending = enabled;\n    failure = undefined;\n    modeOwner?.publish();\n    try {\n      if (enabled) await resources[1]!.read(host.context);\n      signal?.throwIfAborted();\n      if (operation !== generation || disposed) throw new Error('Help activation was cancelled.');\n      const modes = (host.context.selection.state?.['minor-mode'] ?? []).filter((mode) => mode !== HELP_MODE_ID);\n      await host.changeSelection({\n        axis: 'state',\n        key: 'minor-mode',\n        values: enabled ? [...modes, HELP_MODE_ID] : modes,\n      });\n    } catch (error) {\n      if (operation === generation) failure = (error instanceof Error ? error.message : String(error)).slice(0, 160);\n      throw error;\n    } finally {\n      if (operation === generation) {\n        pending = undefined;\n        modeOwner?.publish();\n      }\n    }\n  };\n  const command: PoHeadlessCommand = {\n    name: HELP_COMMAND_NAME,\n    description: HELP_COMMAND_DESCRIPTION,\n    async execute(_args, execution) {\n      await selectMode(!(pending ?? active()));\n      await execution.client.notify({\n        title: 'Po Help',\n        body: active() ? 'Help mode activated.' : 'Help mode deactivated.',\n        level: 'info',\n      });\n    },\n  };\n  modeOwner = defineMinorMode({\n    descriptor: {\n      source: HELP_PACKAGE_SOURCE,\n      id: HELP_MODE_ID,\n      label: 'Help',\n      description: 'Package guidance and read-only diagnostics for agent setup and debugging.',\n      order: 50,\n      actions: [\n        {\n          id: 'activate',\n          label: 'Activate',\n          description: 'Expose Help guidance and diagnostic tools.',\n          contexts: ['headless'],\n          parameters: [],\n        },\n        {\n          id: 'deactivate',\n          label: 'Deactivate',\n          description: 'Withdraw Help-only guidance and diagnostic tools.',\n          contexts: ['headless'],\n          parameters: [],\n        },\n      ],\n    },\n    state: modeState,\n    async handleAction(_runtime, actionId, _argumentsValue, { signal }) {\n      if (actionId !== 'activate' && actionId !== 'deactivate')\n        throw new Error(`Unknown Help mode action: ${actionId}`);\n      await selectMode(actionId === 'activate', signal);\n      return { message: active() ? 'Help mode activated.' : 'Help mode deactivated.' };\n    },\n  }).createOwner(undefined);\n  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>>) =>\n    context.root.resources?.find((resource) => resource.name === 'codemode-how-to-self-improve'),\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>>) =>\n    context.root.resources?.find((resource) => resource.name === 'help-how-to-dashboard-extension'),\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 resourcePoDevelopDashboardExtension from '../src/extensions/workspaces/sessions/(backend)/resource/po-develop-dashboard-extension.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(resourcePoDevelopDashboardExtension, contextSession), at(resourcePoDevelopNativeExtension, contextSession), at(resourcePoHelp, contextSession), at(resourcePoUseChatgptInstructions, contextSession), at(resourcePoUseHelp, contextSession)]); },\n      get tools(): PoServerSessionPlugin['tools'] { return defined([via({ name: 'help_status' }, at(toolHelpStatus, contextSession))]); },\n      services: [...(scopeSession.services ?? [])],\n      get activities(): PoServerSessionPlugin['activities'] { return [...(scopeSession.activities ?? [])]; },\n    };\n  },\n});\n\nexport default serverPlugin;\n"],"mappings":"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"}

package/dist/extensions/server.d.mts.map

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

package/dist/extensions/server.mjs

@@ -28,6 +28,10 @@ const HELP_NATIVE_SKILL = {
 	name: "help-how-to-native-extension",
 	description: "Add or change a Po package's phone UI (.native files, native templates) so it mirrors the cockpit, passes the native build, and is approved and verified before it ships."
 };
+const HELP_DASHBOARD_SKILL = {
+	name: "help-how-to-dashboard-extension",
+	description: "Add plugin sections to Home and Workspace pages with dashboard-tiles on web and native. Choose global or workspace scope, supply tile presentation and navigation, and migrate legacy home-apps cards."
+};
 const HELP_SELF_IMPROVE_SKILL = {
 	name: "codemode-how-to-self-improve",
 	description: "Reload Po's own packages after you edit them, without restarting Po or reopening the session. Use in Help mode after changing a plugin's source or build, or after adding or removing a package."
@@ -329,7 +333,18 @@ function createHelpServerSession(host, packageFailures = () => [], selfImprove)
 			pinned: true,
 			path: packageResourcePath(import.meta.url, "src/prompts/codemode-how-to-self-improve/SKILL.md"),
 			read: () => readPackageResource(import.meta.url, "src/prompts/codemode-how-to-self-improve/SKILL.md")
-		}]
+		}],
+		{
+			when: PO_HELP_WHEN,
+			...HELP_DASHBOARD_SKILL,
+			kind: "skill",
+			path: packageResourcePath(import.meta.url, "src/prompts/help-how-to-dashboard-extension/SKILL.md"),
+			read: async () => {
+				const text = await readPackageResource(import.meta.url, "src/prompts/help-how-to-dashboard-extension/SKILL.md");
+				if (!text.trim()) throw new Error("The installed dashboard extension skill is missing or unreadable.");
+				return text;
+			}
+		}
 	];
 	const selectMode = async (enabled, signal) => {
 		if (disposed) throw new Error("Help runtime is disposed.");
@@ -461,11 +476,14 @@ var root_server_default = defineRoot((context) => {
 var po_help_server_default$1 = defineRoutedContribution((context) => context.root.commands?.[0], { cardinality: "optional" });
 //#endregion
 //#region src/extensions/workspaces/sessions/(backend)/resource/codemode-how-to-self-improve.server.ts
-var codemode_how_to_self_improve_server_default = defineRoutedContribution((context) => context.root.resources?.[5], { cardinality: "optional" });
+var codemode_how_to_self_improve_server_default = defineRoutedContribution((context) => context.root.resources?.find((resource) => resource.name === "codemode-how-to-self-improve"), { cardinality: "optional" });
 //#endregion
 //#region src/extensions/workspaces/sessions/(backend)/resource/po-develop-codemode-plugin.server.ts
 var po_develop_codemode_plugin_server_default = defineRoutedContribution((context) => context.root.resources?.[4], { cardinality: "optional" });
 //#endregion
+//#region src/extensions/workspaces/sessions/(backend)/resource/po-develop-dashboard-extension.server.ts
+var po_develop_dashboard_extension_server_default = defineRoutedContribution((context) => context.root.resources?.find((resource) => resource.name === "help-how-to-dashboard-extension"), { cardinality: "optional" });
+//#endregion
 //#region src/extensions/workspaces/sessions/(backend)/resource/po-develop-native-extension.server.ts
 var po_develop_native_extension_server_default = defineRoutedContribution((context) => context.root.resources?.[3], { cardinality: "optional" });
 //#endregion
@@ -508,6 +526,7 @@ const serverPlugin = defineServerPlugin({
 				return defined([
 					at(codemode_how_to_self_improve_server_default, contextSession),
 					at(po_develop_codemode_plugin_server_default, contextSession),
+					at(po_develop_dashboard_extension_server_default, contextSession),
 					at(po_develop_native_extension_server_default, contextSession),
 					at(po_help_server_default, contextSession),
 					at(po_use_chatgpt_instructions_server_default, contextSession),

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'];\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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"}
+{"version":3,"file":"server.mjs","names":["HELP_WHEN","HELP_WHEN","runtime","rootSession","commandPoHelp","resourceCodemodeHowToSelfImprove","resourcePoDevelopCodemodePlugin","resourcePoDevelopDashboardExtension","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-dashboard-extension.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_DASHBOARD_SKILL = {\n  name: 'help-how-to-dashboard-extension',\n  description:\n    'Add plugin sections to Home and Workspace pages with dashboard-tiles on web and native. Choose global or workspace scope, supply tile presentation and navigation, and migrate legacy home-apps cards.',\n} as const;\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_DASHBOARD_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      when: HELP_WHEN,\n      ...HELP_DASHBOARD_SKILL,\n      kind: 'skill',\n      path: packageResourcePath(import.meta.url, 'src/prompts/help-how-to-dashboard-extension/SKILL.md'),\n      read: async () => {\n        const text = await readPackageResource(import.meta.url, 'src/prompts/help-how-to-dashboard-extension/SKILL.md');\n        if (!text.trim()) throw new Error('The installed dashboard extension skill is missing or unreadable.');\n        return text;\n      },\n    },\n  ];\n  const selectMode = async (enabled: boolean, signal?: AbortSignal): Promise<void> => {\n    if (disposed) throw new Error('Help runtime is disposed.');\n    signal?.throwIfAborted();\n    const operation = ++generation;\n    pending = enabled;\n    failure = undefined;\n    modeOwner?.publish();\n    try {\n      if (enabled) await resources[1]!.read(host.context);\n      signal?.throwIfAborted();\n      if (operation !== generation || disposed) throw new Error('Help activation was cancelled.');\n      const modes = (host.context.selection.state?.['minor-mode'] ?? []).filter((mode) => mode !== HELP_MODE_ID);\n      await host.changeSelection({\n        axis: 'state',\n        key: 'minor-mode',\n        values: enabled ? [...modes, HELP_MODE_ID] : modes,\n      });\n    } catch (error) {\n      if (operation === generation) failure = (error instanceof Error ? error.message : String(error)).slice(0, 160);\n      throw error;\n    } finally {\n      if (operation === generation) {\n        pending = undefined;\n        modeOwner?.publish();\n      }\n    }\n  };\n  const command: PoHeadlessCommand = {\n    name: HELP_COMMAND_NAME,\n    description: HELP_COMMAND_DESCRIPTION,\n    async execute(_args, execution) {\n      await selectMode(!(pending ?? active()));\n      await execution.client.notify({\n        title: 'Po Help',\n        body: active() ? 'Help mode activated.' : 'Help mode deactivated.',\n        level: 'info',\n      });\n    },\n  };\n  modeOwner = defineMinorMode({\n    descriptor: {\n      source: HELP_PACKAGE_SOURCE,\n      id: HELP_MODE_ID,\n      label: 'Help',\n      description: 'Package guidance and read-only diagnostics for agent setup and debugging.',\n      order: 50,\n      actions: [\n        {\n          id: 'activate',\n          label: 'Activate',\n          description: 'Expose Help guidance and diagnostic tools.',\n          contexts: ['headless'],\n          parameters: [],\n        },\n        {\n          id: 'deactivate',\n          label: 'Deactivate',\n          description: 'Withdraw Help-only guidance and diagnostic tools.',\n          contexts: ['headless'],\n          parameters: [],\n        },\n      ],\n    },\n    state: modeState,\n    async handleAction(_runtime, actionId, _argumentsValue, { signal }) {\n      if (actionId !== 'activate' && actionId !== 'deactivate')\n        throw new Error(`Unknown Help mode action: ${actionId}`);\n      await selectMode(actionId === 'activate', signal);\n      return { message: active() ? 'Help mode activated.' : 'Help mode deactivated.' };\n    },\n  }).createOwner(undefined);\n  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>>) =>\n    context.root.resources?.find((resource) => resource.name === 'codemode-how-to-self-improve'),\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>>) =>\n    context.root.resources?.find((resource) => resource.name === 'help-how-to-dashboard-extension'),\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 resourcePoDevelopDashboardExtension from '../src/extensions/workspaces/sessions/(backend)/resource/po-develop-dashboard-extension.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(resourcePoDevelopDashboardExtension, contextSession), at(resourcePoDevelopNativeExtension, contextSession), at(resourcePoHelp, contextSession), at(resourcePoUseChatgptInstructions, contextSession), at(resourcePoUseHelp, contextSession)]); },\n      get tools(): PoServerSessionPlugin['tools'] { return defined([via({ name: 'help_status' }, at(toolHelpStatus, contextSession))]); },\n      services: [...(scopeSession.services ?? [])],\n      get activities(): PoServerSessionPlugin['activities'] { return [...(scopeSession.activities ?? [])]; },\n    };\n  },\n});\n\nexport default serverPlugin;\n"],"mappings":"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"}

package/llms.txt

@@ -12,6 +12,7 @@ Activation-gated, package-owned guidance for Po Pi parent sessions.
 
 - [help-how-to-chatgpt-instructions](./src/prompts/help-how-to-chatgpt-instructions/SKILL.md): Print paste-ready code-mode instructions with all repository rules.
 
+- [help-how-to-dashboard-extension](./src/prompts/help-how-to-dashboard-extension/SKILL.md): Add Home and Workspace page tiles on web and native, choose scope and navigation, and migrate legacy home-apps cards.
 - [help-how-to-native-extension](./src/prompts/help-how-to-native-extension/SKILL.md): Add phone UI to a Po package that mirrors the cockpit, then approve and verify it.
 - [help-how-to-codemode-plugin](./src/prompts/help-how-to-codemode-plugin/SKILL.md): Add code-mode support to a Po package: a namespace, the tool it replaces, and the skill that teaches agents to use it.
 - [codemode-how-to-self-improve](./src/prompts/codemode-how-to-self-improve/SKILL.md): In Help mode, reload Po's own packages after editing them, without restarting Po or reopening the session.

package/package.json

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

package/src/prompts/help-how-to-dashboard-extension/SKILL.md

@@ -0,0 +1,86 @@
+---
+name: help-how-to-dashboard-extension
+description: Add plugin sections to Home and Workspace pages with dashboard-tiles on web and native. Choose global or workspace scope, supply tile presentation and navigation, and migrate legacy home-apps cards.
+---
+
+# Extend Home and Workspace pages
+
+Use `dashboard-tiles` fills for plugin sections on Home (`/`) and Workspace
+(`/workspace/<workspaceId>`). This is a shared web and native contract, not a session activity
+slot. For phone build setup and platform restrictions, load
+[help-how-to-native-extension](../help-how-to-native-extension/SKILL.md).
+
+## Choose the owning scope
+
+- **Home:** put the fill under `src/extensions/(frontend)/fill/`. Home reads global fills only,
+  regardless of the focused session or workspace. Global tiles default to `surfaces: ['home']`.
+- **One workspace:** put it under `src/extensions/workspaces/(frontend)/fill/`. It belongs to
+  that workspace's composition, not `workspaces/sessions/`. The Workspace page passes its
+  explicit `workspaceId`; do not infer it from the focused session.
+- **A global tile on Workspace pages too:** set `data.surfaces: ['home', 'workspace']`.
+  For Workspace pages only, use `['workspace']`. This filters global tiles; workspace-owned
+  tiles stay with their workspace and never become global Home tiles through `surfaces`.
+
+A Workspace page merges eligible global tiles with that workspace's own tiles. The same
+`(pluginId, id)` at workspace scope replaces its global tile there. Other workspaces' and
+session-scoped fills are not included. Tiles sort by `order`, then plugin id, then fill id.
+
+## Contribute a body, not a card shell
+
+For example, `src/extensions/(frontend)/fill/Overview.dashboard-tiles.web.tsx`:
+
+```tsx
+import { defineFill } from '@agimon-ai/po-core/web';
+
+import { OverviewBody } from './_components/OverviewBody';
+
+export default defineFill({
+  slot: 'dashboard-tiles',
+  id: 'overview',
+  order: 10,
+  data: { version: 1, title: 'Overview', size: 'wide', surfaces: ['home', 'workspace'] },
+  component: OverviewBody,
+});
+```
+
+Ship the matching `.native.tsx` fill with `defineFill` from `@agimon-ai/po-core/native`,
+the same identity and presentation, and a native body. Use existing components and design
+tokens; write deterministic stories and obtain approval before implementing visual changes.
+The host draws the frame, title, optional icon and navigation affordance. The body supplies
+content only, including its own loading, empty and failure states.
+
+Presentation requires `data.version: 1` and a non-empty `title`. Optional `size` is `small`
+(the default), `wide`, `tall` or `large`; these are host layout hints, not pixel dimensions.
+Optional `column: 'main' | 'side'` places web tiles in independent 2:1 desktop columns;
+phone layouts use a natural-height stack, and native preserves fill order rather than columns.
+`icon` uses the component/object contract, not an icon-name string. A malformed presentation
+or missing body is rejected with an install diagnostic.
+
+For a host-rendered navigation action, set `data.open: { kind: 'page', id: '<page-fill-id>' }`
+or `{ kind: 'settings', id: '<section-id>' }` and provide the matching destination. Use slot
+props such as `openPage`, `openSettings` and `openWorkspace` for body actions rather than
+hardcoding host routes. When the body has a labeled navigation action, omit `data.open` to
+avoid duplicating that action in the host header. A `page` fill is the full destination,
+not a dashboard section. Native `EmptyState` fills its parent by default; use
+`style={{ flex: 0, flexBasis: 'auto' }}` when embedding it in a content-sized tile.
+
+## Keep data ownership explicit
+
+These surfaces have no active session. Use global or workspace backend capabilities matching
+the fill's owner, not a session channel borrowed from whichever conversation is focused.
+For workspace metadata, load `help-how-to-config`: resolve the explicit workspace id through
+the backend's injected `po/workspace-registry`, validate the fields your plugin consumes,
+and use that workspace's injected services. The browser does not parse `.po/workspaces.yaml`,
+and the registry is not a cross-workspace service locator.
+
+## Legacy cards and verification
+
+`home-apps` remains compatibility for full Home cards; use `dashboard-tiles` for new sections.
+Publishing any new global Home tile suppresses all legacy Home cards from that plugin, so
+migrate its cards together. `data.column` controls web placement, not tile size.
+The `home` data slot is separate: it feeds native Needs your eye entries, not tile bodies.
+
+Run the package's lint, typecheck, build and tests. Verify Home and two distinct Workspace
+pages, including a switch of focused session, to catch scope leakage. Render web and native
+stories, and report source checks, rendered appearance and runtime verification separately.
+Do not claim rendered or device behavior from source checks alone.

package/src/prompts/help-how-to-native-extension/SKILL.md

@@ -54,7 +54,17 @@ export default defineNativeTemplate({
 
 `sessions` receives `{ workspaces, openSession }` with the cockpit rail's data. The app keeps pairing, navigation, tabs, headers and Home. `native.template` in `.po/config.yaml` selects a layout; otherwise the app's bundled Advanced is used. A screen that throws falls back to the built-in one.
 
-A Home card is a `fill/<Name>.home-apps.native.tsx` with an `openPage` button. Ship the matching `<Name>.home-apps.web.tsx` too: the web cockpit shows the same cards on its Home screen at `/`, where `data: { column: 'side' }` picks the narrow column. The phone ignores `column`.
+## Home and Workspace tiles
+
+For plugin sections on Home or `/workspace/<workspaceId>`, load
+[help-how-to-dashboard-extension](../help-how-to-dashboard-extension/SKILL.md).
+Use a body-only `fill/<Name>.dashboard-tiles.native.tsx` with a matching `.web.tsx` contribution.
+The host owns the tile frame, heading, size and navigation affordance. Put presentation in
+`data: { version: 1, title, size, open }`; do not draw another card shell inside the body.
+
+`home-apps` is legacy compatibility for full Home cards, not the API for new tiles or workspace
+sections. Its web `data.column` hint is ignored on native. A plugin publishing new Home tiles
+suppresses that plugin's legacy Home cards; migrate all of its cards together.
 
 ## Design, approve, verify