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

package/LICENSE

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

package/README.md

@@ -0,0 +1,65 @@
+# @agimon-ai/po-prompt
+
+Staged recent prompts and saved prompt templates for Po.
+
+This package is a composable [Po](https://www.npmjs.com/package/@agimon-ai/po) subsystem.
+
+## Requirements
+
+- Node.js 24 or newer
+- `@earendil-works/pi-coding-agent` 0.85.0
+
+## Install
+
+Po users can
+add `@agimon-ai/po-prompt` to `default.packages` or a selected layer's `packages` list in
+`.po/modes.yaml`.
+
+## Cockpit
+
+The package contributes a `Prompt template` entry to the composer's `+` menu, beside `File Upload`,
+backed by a hub-scoped API at `/api/plugin/prompts`. The entry opens a list-first dialog over the
+conversation, and picking one sends it immediately to the focused session. The same dialog creates
+and edits entries, confirms replacements and removals, and refreshes the list after writes. Every
+text-bearing user message also offers `save as prompt`, opening the editor with that message text
+ready to name or edit. The dialog itself is a cockpit overlay rather than part of the menu, so the
+message action reaches it without the menu being open.
+
+| Route                   | Purpose                                                             |
+| ----------------------- | ------------------------------------------------------------------- |
+| `GET /prompts`          | Every saved prompt, sorted by name                                  |
+| `PUT /prompts/:name`    | Create or replace one, deriving its description from the first line |
+| `DELETE /prompts/:name` | Remove one                                                          |
+
+The API is hub-scoped because saved prompts belong to the agent directory rather than to a session.
+Staged prompts are not exposed there: they live in the memory of the session that received them.
+
+The cockpit hub mounts package APIs from the route table `po sync` generates. After installing
+or changing this package, run a build and `po sync`, then restart the hub, or its routes answer 404.
+
+## Help
+
+The published package includes `llms.txt` and the package-owned `src/prompts/po-use-prompt/SKILL.md`. When the Po Help minor mode is active, the extension contributes `po-use-prompt` to its live Help catalog. The contribution follows Help provider replacement and is withdrawn when the extension shuts down.
+
+## Public API
+
+```ts
+import { createNodeSavedPromptStore, createRecentPrompts } from '@agimon-ai/po-prompt';
+```
+
+## Development
+
+```bash
+pnpm build
+pnpm typecheck
+pnpm test
+pnpm lint
+pnpm exec vibe-lint check .
+npm pack --dry-run
+```
+
+Maintained by [Agimon](https://agimon.ai/about).
+
+## License
+
+MIT

package/dist/apiContracts.cjs

@@ -0,0 +1,74 @@
+Object.defineProperties(exports, {
+	__esModule: { value: true },
+	[Symbol.toStringTag]: { value: "Module" }
+});
+let _agimon_ai_po_core_apiContracts = require("@agimon-ai/po-core/apiContracts");
+let typebox = require("typebox");
+//#region src/schemas/apiContracts.ts
+const S = typebox.Type.String();
+const B = typebox.Type.Boolean();
+const Prompt = typebox.Type.Object({
+	name: S,
+	description: S,
+	text: S
+});
+const apiContracts = (0, _agimon_ai_po_core_apiContracts.defineApiContract)({
+	version: 1,
+	sockets: [],
+	dynamic: [],
+	http: [
+		"global",
+		"workspace",
+		"session"
+	].flatMap((scope) => [
+		{
+			id: "prompts.list",
+			scope,
+			basePath: "prompts",
+			path: "/prompts",
+			method: "GET",
+			authentication: "owner",
+			description: "List prompts in this scope.",
+			responses: (0, _agimon_ai_po_core_apiContracts.jsonApiResponses)(typebox.Type.Object({ prompts: typebox.Type.Array(Prompt) }))
+		},
+		{
+			id: "prompts.save",
+			scope,
+			basePath: "prompts",
+			path: "/prompts/{name}",
+			method: "PUT",
+			authentication: "owner",
+			description: "Save a prompt. Text is limited to 65536 UTF-8 bytes.",
+			body: {
+				required: true,
+				contentType: "application/json",
+				schema: typebox.Type.Object({ text: typebox.Type.String({ minLength: 1 }) })
+			},
+			responses: {
+				...(0, _agimon_ai_po_core_apiContracts.jsonApiResponses)(typebox.Type.Object({
+					prompt: Prompt,
+					replaced: B
+				})),
+				"413": {
+					description: "Prompt text exceeds the byte limit.",
+					schema: typebox.Type.Object({ error: S })
+				}
+			}
+		},
+		{
+			id: "prompts.delete",
+			scope,
+			basePath: "prompts",
+			path: "/prompts/{name}",
+			method: "DELETE",
+			authentication: "owner",
+			description: "Delete a prompt.",
+			responses: (0, _agimon_ai_po_core_apiContracts.jsonApiResponses)(typebox.Type.Object({ name: S }))
+		}
+	])
+});
+//#endregion
+exports.apiContracts = apiContracts;
+exports.default = apiContracts;
+
+//# sourceMappingURL=apiContracts.cjs.map

package/dist/apiContracts.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiContracts.cjs","names":["Type","defineApiContract","jsonApiResponses"],"sources":["../src/schemas/apiContracts.ts"],"sourcesContent":["import { defineApiContract, jsonApiResponses } from '@agimon-ai/po-core/apiContracts';\nimport { Type } from 'typebox';\n\nconst S = Type.String();\nconst B = Type.Boolean();\nconst Prompt = Type.Object({ name: S, description: S, text: S });\nexport const apiContracts = defineApiContract({\n  version: 1,\n  sockets: [],\n  dynamic: [],\n  http: (['global', 'workspace', 'session'] as const).flatMap((scope) => [\n    {\n      id: 'prompts.list',\n      scope,\n      basePath: 'prompts',\n      path: '/prompts',\n      method: 'GET',\n      authentication: 'owner',\n      description: 'List prompts in this scope.',\n      responses: jsonApiResponses(Type.Object({ prompts: Type.Array(Prompt) })),\n    },\n    {\n      id: 'prompts.save',\n      scope,\n      basePath: 'prompts',\n      path: '/prompts/{name}',\n      method: 'PUT',\n      authentication: 'owner',\n      description: 'Save a prompt. Text is limited to 65536 UTF-8 bytes.',\n      body: {\n        required: true,\n        contentType: 'application/json',\n        schema: Type.Object({ text: Type.String({ minLength: 1 }) }),\n      },\n      responses: {\n        ...jsonApiResponses(Type.Object({ prompt: Prompt, replaced: B })),\n        '413': { description: 'Prompt text exceeds the byte limit.', schema: Type.Object({ error: S }) },\n      },\n    },\n    {\n      id: 'prompts.delete',\n      scope,\n      basePath: 'prompts',\n      path: '/prompts/{name}',\n      method: 'DELETE',\n      authentication: 'owner',\n      description: 'Delete a prompt.',\n      responses: jsonApiResponses(Type.Object({ name: S })),\n    },\n  ]),\n});\nexport default apiContracts;\n"],"mappings":";;;;;;;AAGA,MAAM,IAAIA,QAAAA,KAAK,OAAO;AACtB,MAAM,IAAIA,QAAAA,KAAK,QAAQ;AACvB,MAAM,SAASA,QAAAA,KAAK,OAAO;CAAE,MAAM;CAAG,aAAa;CAAG,MAAM;AAAE,CAAC;AAC/D,MAAa,gBAAA,GAAeC,gCAAAA,kBAAAA,CAAkB;CAC5C,SAAS;CACT,SAAS,CAAC;CACV,SAAS,CAAC;CACV,MAAO;EAAC;EAAU;EAAa;CAAS,CAAC,CAAW,SAAS,UAAU;EACrE;GACE,IAAI;GACJ;GACA,UAAU;GACV,MAAM;GACN,QAAQ;GACR,gBAAgB;GAChB,aAAa;GACb,YAAA,GAAWC,gCAAAA,iBAAAA,CAAiBF,QAAAA,KAAK,OAAO,EAAE,SAASA,QAAAA,KAAK,MAAM,MAAM,EAAE,CAAC,CAAC;EAC1E;EACA;GACE,IAAI;GACJ;GACA,UAAU;GACV,MAAM;GACN,QAAQ;GACR,gBAAgB;GAChB,aAAa;GACb,MAAM;IACJ,UAAU;IACV,aAAa;IACb,QAAQA,QAAAA,KAAK,OAAO,EAAE,MAAMA,QAAAA,KAAK,OAAO,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC;GAC7D;GACA,WAAW;IACT,IAAA,GAAGE,gCAAAA,iBAAAA,CAAiBF,QAAAA,KAAK,OAAO;KAAE,QAAQ;KAAQ,UAAU;IAAE,CAAC,CAAC;IAChE,OAAO;KAAE,aAAa;KAAuC,QAAQA,QAAAA,KAAK,OAAO,EAAE,OAAO,EAAE,CAAC;IAAE;GACjG;EACF;EACA;GACE,IAAI;GACJ;GACA,UAAU;GACV,MAAM;GACN,QAAQ;GACR,gBAAgB;GAChB,aAAa;GACb,YAAA,GAAWE,gCAAAA,iBAAAA,CAAiBF,QAAAA,KAAK,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;EACtD;CACF,CAAC;AACH,CAAC"}

package/dist/apiContracts.d.mts

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

package/dist/apiContracts.d.mts.map

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

package/dist/apiContracts.mjs

@@ -0,0 +1,69 @@
+import { defineApiContract, jsonApiResponses } from "@agimon-ai/po-core/apiContracts";
+import { Type } from "typebox";
+//#region src/schemas/apiContracts.ts
+const S = Type.String();
+const B = Type.Boolean();
+const Prompt = Type.Object({
+	name: S,
+	description: S,
+	text: S
+});
+const apiContracts = defineApiContract({
+	version: 1,
+	sockets: [],
+	dynamic: [],
+	http: [
+		"global",
+		"workspace",
+		"session"
+	].flatMap((scope) => [
+		{
+			id: "prompts.list",
+			scope,
+			basePath: "prompts",
+			path: "/prompts",
+			method: "GET",
+			authentication: "owner",
+			description: "List prompts in this scope.",
+			responses: jsonApiResponses(Type.Object({ prompts: Type.Array(Prompt) }))
+		},
+		{
+			id: "prompts.save",
+			scope,
+			basePath: "prompts",
+			path: "/prompts/{name}",
+			method: "PUT",
+			authentication: "owner",
+			description: "Save a prompt. Text is limited to 65536 UTF-8 bytes.",
+			body: {
+				required: true,
+				contentType: "application/json",
+				schema: Type.Object({ text: Type.String({ minLength: 1 }) })
+			},
+			responses: {
+				...jsonApiResponses(Type.Object({
+					prompt: Prompt,
+					replaced: B
+				})),
+				"413": {
+					description: "Prompt text exceeds the byte limit.",
+					schema: Type.Object({ error: S })
+				}
+			}
+		},
+		{
+			id: "prompts.delete",
+			scope,
+			basePath: "prompts",
+			path: "/prompts/{name}",
+			method: "DELETE",
+			authentication: "owner",
+			description: "Delete a prompt.",
+			responses: jsonApiResponses(Type.Object({ name: S }))
+		}
+	])
+});
+//#endregion
+export { apiContracts, apiContracts as default };
+
+//# sourceMappingURL=apiContracts.mjs.map

package/dist/apiContracts.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiContracts.mjs","names":[],"sources":["../src/schemas/apiContracts.ts"],"sourcesContent":["import { defineApiContract, jsonApiResponses } from '@agimon-ai/po-core/apiContracts';\nimport { Type } from 'typebox';\n\nconst S = Type.String();\nconst B = Type.Boolean();\nconst Prompt = Type.Object({ name: S, description: S, text: S });\nexport const apiContracts = defineApiContract({\n  version: 1,\n  sockets: [],\n  dynamic: [],\n  http: (['global', 'workspace', 'session'] as const).flatMap((scope) => [\n    {\n      id: 'prompts.list',\n      scope,\n      basePath: 'prompts',\n      path: '/prompts',\n      method: 'GET',\n      authentication: 'owner',\n      description: 'List prompts in this scope.',\n      responses: jsonApiResponses(Type.Object({ prompts: Type.Array(Prompt) })),\n    },\n    {\n      id: 'prompts.save',\n      scope,\n      basePath: 'prompts',\n      path: '/prompts/{name}',\n      method: 'PUT',\n      authentication: 'owner',\n      description: 'Save a prompt. Text is limited to 65536 UTF-8 bytes.',\n      body: {\n        required: true,\n        contentType: 'application/json',\n        schema: Type.Object({ text: Type.String({ minLength: 1 }) }),\n      },\n      responses: {\n        ...jsonApiResponses(Type.Object({ prompt: Prompt, replaced: B })),\n        '413': { description: 'Prompt text exceeds the byte limit.', schema: Type.Object({ error: S }) },\n      },\n    },\n    {\n      id: 'prompts.delete',\n      scope,\n      basePath: 'prompts',\n      path: '/prompts/{name}',\n      method: 'DELETE',\n      authentication: 'owner',\n      description: 'Delete a prompt.',\n      responses: jsonApiResponses(Type.Object({ name: S })),\n    },\n  ]),\n});\nexport default apiContracts;\n"],"mappings":";;;AAGA,MAAM,IAAI,KAAK,OAAO;AACtB,MAAM,IAAI,KAAK,QAAQ;AACvB,MAAM,SAAS,KAAK,OAAO;CAAE,MAAM;CAAG,aAAa;CAAG,MAAM;AAAE,CAAC;AAC/D,MAAa,eAAe,kBAAkB;CAC5C,SAAS;CACT,SAAS,CAAC;CACV,SAAS,CAAC;CACV,MAAO;EAAC;EAAU;EAAa;CAAS,CAAC,CAAW,SAAS,UAAU;EACrE;GACE,IAAI;GACJ;GACA,UAAU;GACV,MAAM;GACN,QAAQ;GACR,gBAAgB;GAChB,aAAa;GACb,WAAW,iBAAiB,KAAK,OAAO,EAAE,SAAS,KAAK,MAAM,MAAM,EAAE,CAAC,CAAC;EAC1E;EACA;GACE,IAAI;GACJ;GACA,UAAU;GACV,MAAM;GACN,QAAQ;GACR,gBAAgB;GAChB,aAAa;GACb,MAAM;IACJ,UAAU;IACV,aAAa;IACb,QAAQ,KAAK,OAAO,EAAE,MAAM,KAAK,OAAO,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC;GAC7D;GACA,WAAW;IACT,GAAG,iBAAiB,KAAK,OAAO;KAAE,QAAQ;KAAQ,UAAU;IAAE,CAAC,CAAC;IAChE,OAAO;KAAE,aAAa;KAAuC,QAAQ,KAAK,OAAO,EAAE,OAAO,EAAE,CAAC;IAAE;GACjG;EACF;EACA;GACE,IAAI;GACJ;GACA,UAAU;GACV,MAAM;GACN,QAAQ;GACR,gBAAgB;GAChB,aAAa;GACb,WAAW,iBAAiB,KAAK,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;EACtD;CACF,CAAC;AACH,CAAC"}

package/dist/extensions/mcp.cjs

@@ -0,0 +1,26 @@
+Object.defineProperties(exports, {
+	__esModule: { value: true },
+	[Symbol.toStringTag]: { value: "Module" }
+});
+let _agimon_ai_po_core_mcpFacet = require("@agimon-ai/po-core/mcpFacet");
+let _agimon_ai_po_core_serverFacet = require("@agimon-ai/po-core/serverFacet");
+//#region src/extensions/workspaces/sessions/(backend)/skill/po-use-prompt.mcp.ts
+var po_use_prompt_mcp_default = (0, _agimon_ai_po_core_mcpFacet.defineMcpSkill)({
+	name: "po-use-prompt",
+	description: "Use @agimon-ai/po-prompt: Staged recent prompts and saved prompt templates for Po",
+	read: () => (0, _agimon_ai_po_core_serverFacet.readPackageResource)(require("url").pathToFileURL(__filename).href, "src/prompts/po-use-prompt/SKILL.md")
+});
+//#endregion
+//#region generated/mcp.ts
+const at = (value, context) => typeof value === "function" ? value(context) : value;
+const mcp = (0, _agimon_ai_po_core_mcpFacet.defineMcpPlugin)({
+	name: "@agimon-ai/po-prompt",
+	session: (context) => ({ get skills() {
+		return [at(po_use_prompt_mcp_default, context)];
+	} })
+});
+//#endregion
+exports.default = mcp;
+exports.mcp = mcp;
+
+//# sourceMappingURL=mcp.cjs.map

package/dist/extensions/mcp.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.cjs","names":["defineMcpSkill","readPackageResource","defineMcpPlugin","skillPoUsePrompt"],"sources":["../../src/extensions/workspaces/sessions/(backend)/skill/po-use-prompt.mcp.ts","../../generated/mcp.ts"],"sourcesContent":["import { defineMcpSkill } from '@agimon-ai/po-core/mcpFacet';\nimport { readPackageResource } from '@agimon-ai/po-core/serverFacet';\n\nexport default defineMcpSkill({\n  name: 'po-use-prompt',\n  description: 'Use @agimon-ai/po-prompt: Staged recent prompts and saved prompt templates for Po',\n  read: () => readPackageResource(import.meta.url, 'src/prompts/po-use-prompt/SKILL.md'),\n});\n","// Generated by @agimon-ai/po-build. Do not edit by hand.\nimport { defineMcpPlugin, type DoomMcpSessionPlugin } from '@agimon-ai/po-core/mcpFacet';\n\nimport skillPoUsePrompt from '../src/extensions/workspaces/sessions/(backend)/skill/po-use-prompt.mcp';\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\nexport const mcp = defineMcpPlugin({\n  name: '@agimon-ai/po-prompt',\n  session: (context) => ({\n    get skills(): DoomMcpSessionPlugin['skills'] { return [at(skillPoUsePrompt, context)]; },\n  }) satisfies DoomMcpSessionPlugin,\n});\n\nexport default mcp;\n"],"mappings":";;;;;;;AAGA,IAAA,6BAAA,GAAeA,4BAAAA,eAAAA,CAAe;CAC5B,MAAM;CACN,aAAa;CACb,aAAA,GAAYC,+BAAAA,oBAAAA,CAAAA,QAAAA,KAAAA,CAAAA,CAAAA,cAAAA,UAAAA,CAAAA,CAAAA,MAAqC,oCAAoC;AACvF,CAAC;;;ACDD,MAAM,MAAY,OAA0B,YAC1C,OAAO,UAAU,aAAc,MAAwB,OAAO,IAAI;AAEpE,MAAa,OAAA,GAAMC,4BAAAA,gBAAAA,CAAgB;CACjC,MAAM;CACN,UAAU,aAAa,EACrB,IAAI,SAAyC;EAAE,OAAO,CAAC,GAAGC,2BAAkB,OAAO,CAAC;CAAG,EACzF;AACF,CAAC"}

package/dist/extensions/mcp.d.mts

@@ -0,0 +1,5 @@
+//#region generated/mcp.d.ts
+export declare const mcp: import("@agimon-ai/po-core/mcpFacet").DoomMcpPluginDefinition;
+//#endregion
+export { mcp as default };
+//# sourceMappingURL=mcp.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.mts","names":[],"sources":["../../generated/mcp.ts"],"mappings":";qBASa,2CAAG"}

package/dist/extensions/mcp.mjs

@@ -0,0 +1,21 @@
+import { defineMcpPlugin, defineMcpSkill } from "@agimon-ai/po-core/mcpFacet";
+import { readPackageResource } from "@agimon-ai/po-core/serverFacet";
+//#region src/extensions/workspaces/sessions/(backend)/skill/po-use-prompt.mcp.ts
+var po_use_prompt_mcp_default = defineMcpSkill({
+	name: "po-use-prompt",
+	description: "Use @agimon-ai/po-prompt: Staged recent prompts and saved prompt templates for Po",
+	read: () => readPackageResource(import.meta.url, "src/prompts/po-use-prompt/SKILL.md")
+});
+//#endregion
+//#region generated/mcp.ts
+const at = (value, context) => typeof value === "function" ? value(context) : value;
+const mcp = defineMcpPlugin({
+	name: "@agimon-ai/po-prompt",
+	session: (context) => ({ get skills() {
+		return [at(po_use_prompt_mcp_default, context)];
+	} })
+});
+//#endregion
+export { mcp as default, mcp };
+
+//# sourceMappingURL=mcp.mjs.map

package/dist/extensions/mcp.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.mjs","names":["skillPoUsePrompt"],"sources":["../../src/extensions/workspaces/sessions/(backend)/skill/po-use-prompt.mcp.ts","../../generated/mcp.ts"],"sourcesContent":["import { defineMcpSkill } from '@agimon-ai/po-core/mcpFacet';\nimport { readPackageResource } from '@agimon-ai/po-core/serverFacet';\n\nexport default defineMcpSkill({\n  name: 'po-use-prompt',\n  description: 'Use @agimon-ai/po-prompt: Staged recent prompts and saved prompt templates for Po',\n  read: () => readPackageResource(import.meta.url, 'src/prompts/po-use-prompt/SKILL.md'),\n});\n","// Generated by @agimon-ai/po-build. Do not edit by hand.\nimport { defineMcpPlugin, type DoomMcpSessionPlugin } from '@agimon-ai/po-core/mcpFacet';\n\nimport skillPoUsePrompt from '../src/extensions/workspaces/sessions/(backend)/skill/po-use-prompt.mcp';\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\nexport const mcp = defineMcpPlugin({\n  name: '@agimon-ai/po-prompt',\n  session: (context) => ({\n    get skills(): DoomMcpSessionPlugin['skills'] { return [at(skillPoUsePrompt, context)]; },\n  }) satisfies DoomMcpSessionPlugin,\n});\n\nexport default mcp;\n"],"mappings":";;;AAGA,IAAA,4BAAe,eAAe;CAC5B,MAAM;CACN,aAAa;CACb,YAAY,oBAAoB,YAAY,KAAK,oCAAoC;AACvF,CAAC;;;ACDD,MAAM,MAAY,OAA0B,YAC1C,OAAO,UAAU,aAAc,MAAwB,OAAO,IAAI;AAEpE,MAAa,MAAM,gBAAgB;CACjC,MAAM;CACN,UAAU,aAAa,EACrB,IAAI,SAAyC;EAAE,OAAO,CAAC,GAAGA,2BAAkB,OAAO,CAAC;CAAG,EACzF;AACF,CAAC"}

package/dist/extensions/server.cjs

@@ -0,0 +1,249 @@
+Object.defineProperties(exports, {
+	__esModule: { value: true },
+	[Symbol.toStringTag]: { value: "Module" }
+});
+const require_promptStore = require("../promptStore-Cu4KqaXU.cjs");
+let node_fs_promises = require("node:fs/promises");
+let _agimon_ai_po_core_serverFacet = require("@agimon-ai/po-core/serverFacet");
+let _agimon_ai_po_core_extensionFile = require("@agimon-ai/po-core/extensionFile");
+let hono = require("hono");
+let _agimon_ai_po_core_web = require("@agimon-ai/po-core/web");
+let _agimon_ai_po_core_help = require("@agimon-ai/po-core/help");
+//#region src/constants/promptsApi.ts
+const NAME_PARAM = "name";
+const STATUS = {
+	badRequest: 400,
+	notFound: 404,
+	tooLarge: 413,
+	failed: 500
+};
+//#endregion
+//#region src/constants/webPrompts.ts
+const API_BASE_PATH = "prompts";
+const PROMPTS_PATH = "/prompts";
+//#endregion
+//#region src/types/apiRoutes.ts
+/**
+* This package's routes, as data.
+*
+* No scope and no base path. The build reads both off
+* `src/extensions/(backend)/api/prompts/`, so the mount is stated once, by the
+* folder that creates it. This package stated it three times before: a
+* constant, and the literal `prompts` twice more inside a URL builder that also
+* decided, on its own, whether a call was global or session scoped.
+*
+* The Hono app registers these paths and the browser addresses them, so a path
+* cannot move on one side alone.
+*
+* `:name` is Hono's own parameter syntax, because the app registers `path`
+* verbatim, and the client fills it from `params` on the call.
+*/
+var apiRoutes_default = (0, _agimon_ai_po_core_web.defineApiRoutes)({
+	list: {
+		method: "GET",
+		path: PROMPTS_PATH,
+		response: (0, _agimon_ai_po_core_web.apiResponse)()
+	},
+	save: {
+		method: "PUT",
+		path: `${PROMPTS_PATH}/:${NAME_PARAM}`,
+		response: (0, _agimon_ai_po_core_web.apiResponse)()
+	},
+	/** The same path as `save`; the method is the whole of the difference. */
+	remove: {
+		method: "DELETE",
+		path: `${PROMPTS_PATH}/:${NAME_PARAM}`
+	}
+});
+//#endregion
+//#region src/services/promptsApi/index.ts
+function toView(prompt) {
+	return {
+		name: prompt.name,
+		description: prompt.description,
+		text: prompt.text
+	};
+}
+function failureMessage(error) {
+	return error instanceof Error ? error.message : "The prompt library could not complete that request.";
+}
+/** Reads `{ text }` out of a request body, or the reason it is unusable. */
+async function readText(request) {
+	let payload;
+	try {
+		payload = await request.json();
+	} catch {
+		return { error: "The request body must be JSON." };
+	}
+	const text = payload?.text;
+	if (typeof text !== "string" || text.trim().length === 0) return { error: "A non-empty text is required." };
+	if (Buffer.byteLength(text, "utf8") > 65536) return { error: "That prompt is too large to save." };
+	return { text };
+}
+function createPromptHubApi(options = {}) {
+	const store = options.store ?? require_promptStore.createNodeSavedPromptStore();
+	const app = new hono.Hono();
+	app.get(apiRoutes_default.list.path, async (context) => {
+		try {
+			const prompts = await store.list();
+			return context.json({ prompts: prompts.map(toView) });
+		} catch (error) {
+			return context.json({ error: failureMessage(error) }, STATUS.failed);
+		}
+	});
+	app.put(apiRoutes_default.save.path, async (context) => {
+		const name = context.req.param(NAME_PARAM);
+		if (!require_promptStore.isValidPromptName(name)) return context.json({ error: `"${name}" is not a usable prompt name. Use ${require_promptStore.PROMPT_NAME_RULE}.` }, STATUS.badRequest);
+		const body = await readText(context.req.raw);
+		if ("error" in body) {
+			const status = body.error.includes("too large") ? STATUS.tooLarge : STATUS.badRequest;
+			return context.json({ error: body.error }, status);
+		}
+		try {
+			const replaced = await store.has(name);
+			const prompt = {
+				name,
+				description: require_promptStore.describePrompt(body.text),
+				text: body.text
+			};
+			await store.save(prompt);
+			return context.json({
+				prompt: toView(prompt),
+				replaced
+			});
+		} catch (error) {
+			return context.json({ error: failureMessage(error) }, STATUS.failed);
+		}
+	});
+	app.delete(apiRoutes_default.remove.path, async (context) => {
+		const name = context.req.param(NAME_PARAM);
+		if (!require_promptStore.isValidPromptName(name)) return context.json({ error: `"${name}" is not a usable prompt name.` }, STATUS.badRequest);
+		try {
+			if (!await store.remove(name)) return context.json({ error: `No saved prompt is named "${name}".` }, STATUS.notFound);
+			return context.json({ name });
+		} catch (error) {
+			return context.json({ error: failureMessage(error) }, STATUS.failed);
+		}
+	});
+	return app;
+}
+/** The named export a host imports from this package's built entry. */
+const api = {
+	basePath: API_BASE_PATH,
+	start(_context) {
+		const app = createPromptHubApi();
+		return {
+			fetch: (request) => app.fetch(request),
+			close: () => void 0
+		};
+	}
+};
+//#endregion
+//#region src/extensions/(backend)/api/prompts/route.server.ts
+/**
+* Mounts this package's HTTP API at `prompts`, which the folder names.
+*
+* The folder is the declaration: the build reads the base path off it and hands
+* the browser a client bound to the same segment, so the mount is stated once
+* rather than in a constant, a URL builder and a story stub that were each free
+* to drift.
+*/
+var route_server_default = (0, _agimon_ai_po_core_extensionFile.defineRoute)(api);
+//#endregion
+//#region src/constants/prompts.ts
+const COMMAND_NAME = "prompts";
+const SERVER_COMMAND_DESCRIPTION = "List saved prompts or run one by name.";
+//#endregion
+//#region src/services/savedPrompts/index.ts
+async function savedPrompts() {
+	const directory = require_promptStore.resolvePromptsDirectory();
+	try {
+		const { readdir } = await import("node:fs/promises");
+		const entries = await readdir(directory, { withFileTypes: true });
+		const prompts = [];
+		for (const entry of entries.filter((candidate) => candidate.isFile() && candidate.name.endsWith(".md")).sort((a, b) => a.name.localeCompare(b.name))) {
+			const name = entry.name.slice(0, -3);
+			prompts.push(require_promptStore.parsePromptDocument(name, await (0, node_fs_promises.readFile)(`${directory}/${entry.name}`, "utf8")));
+		}
+		return prompts;
+	} catch {
+		return [];
+	}
+}
+//#endregion
+//#region src/services/serverPrompts/index.ts
+const serverPromptCommand = {
+	name: COMMAND_NAME,
+	description: SERVER_COMMAND_DESCRIPTION,
+	async execute(args, execution) {
+		const prompts = await savedPrompts();
+		const requested = args.trim();
+		if (!requested) {
+			await execution.client.notify({
+				title: "Po prompts",
+				body: prompts.map((prompt) => `/${prompt.name}: ${prompt.description}`).join("\n") || "(no saved prompts)",
+				level: "info"
+			});
+			return;
+		}
+		const prompt = prompts.find((candidate) => candidate.name === requested);
+		if (!prompt) {
+			await execution.client.notify({
+				body: `Saved prompt not found: ${requested}`,
+				level: "warning"
+			});
+			return;
+		}
+		await execution.session.prompt(prompt.text);
+	}
+};
+//#endregion
+//#region src/extensions/workspaces/sessions/(backend)/command/prompts.server.ts
+var prompts_server_default$1 = (0, _agimon_ai_po_core_extensionFile.defineServerCommand)(serverPromptCommand);
+//#endregion
+//#region src/extensions/workspaces/sessions/(backend)/resource/po-use-prompt.server.ts
+var po_use_prompt_server_default = (0, _agimon_ai_po_core_extensionFile.defineResource)({
+	name: "po-use-prompt",
+	when: _agimon_ai_po_core_help.DOOM_HELP_WHEN,
+	kind: "skill",
+	read: () => (0, _agimon_ai_po_core_serverFacet.readPackageResource)(require("url").pathToFileURL(__filename).href, "src/prompts/po-use-prompt/SKILL.md")
+});
+//#endregion
+//#region src/extensions/workspaces/sessions/(backend)/resource/prompts.server.ts
+var prompts_server_default = (0, _agimon_ai_po_core_extensionFile.defineResource)({
+	name: "po/prompts",
+	kind: "prompt",
+	read: async () => JSON.stringify(await savedPrompts(), null, 2)
+});
+//#endregion
+//#region generated/server.ts
+const at = (value, context) => typeof value === "function" ? value(context) : value;
+const via = (identity, value) => value === void 0 ? void 0 : {
+	...identity,
+	...value
+};
+const facet = (0, _agimon_ai_po_core_serverFacet.defineServerPlugin)({
+	name: "@agimon-ai/po-prompt",
+	global: (context) => ({ get api() {
+		return [at(route_server_default, context)];
+	} }),
+	workspace: (context) => ({ get api() {
+		return [at(route_server_default, context)];
+	} }),
+	session: (context) => ({
+		get api() {
+			return [at(route_server_default, context)];
+		},
+		get commands() {
+			return [via({ name: "prompts" }, at(prompts_server_default$1, context))];
+		},
+		get resources() {
+			return [at(po_use_prompt_server_default, context), at(prompts_server_default, context)];
+		}
+	})
+});
+//#endregion
+exports.default = facet;
+exports.facet = facet;
+
+//# sourceMappingURL=server.cjs.map