@agimon-ai/doompi-prompt 0.0.1-alpha.0

package/dist/container/index.mjs

@@ -0,0 +1,2 @@
+import{createNodeSavedPromptStore as e}from"../adapters/node/promptStore.mjs";import{createRecentPrompts as t}from"../services/recentPrompts.mjs";function n(n={}){return{store:n.store??e(),recent:n.recent??t()}}export{n as createPromptContainer};
+//# sourceMappingURL=index.mjs.map

package/dist/container/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/container/index.ts"],"sourcesContent":["import { createNodeSavedPromptStore } from '../adapters/node/promptStore.ts';\nimport { createRecentPrompts } from '../services/recentPrompts.ts';\nimport type { PromptExtensionDependencies } from '../types/prompt.ts';\n\n/** Plain factory construction, with per-dependency overrides for tests. */\nexport function createPromptContainer(\n  overrides: Partial<PromptExtensionDependencies> = {},\n): PromptExtensionDependencies {\n  return {\n    store: overrides.store ?? createNodeSavedPromptStore(),\n    recent: overrides.recent ?? createRecentPrompts(),\n  };\n}\n"],"mappings":"kJAKA,SAAgB,EACd,EAAkD,CAAC,EACtB,CAC7B,MAAO,CACL,MAAO,EAAU,OAAS,EAA2B,EACrD,OAAQ,EAAU,QAAU,EAAoB,CAClD,CACF"}

package/dist/extensions/pi.cjs

@@ -0,0 +1 @@
+Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:`Module`}});const e=require("../adapters/pi/extension.cjs");exports.activatePromptExtension=e.activatePromptExtension,exports.default=e.activatePromptExtension;

package/dist/extensions/pi.d.cts

@@ -0,0 +1,2 @@
+import { activatePromptExtension } from "../adapters/pi/extension.cjs";
+export { activatePromptExtension, activatePromptExtension as default };

package/dist/extensions/pi.d.mts

@@ -0,0 +1,2 @@
+import { activatePromptExtension } from "../adapters/pi/extension.mjs";
+export { activatePromptExtension, activatePromptExtension as default };

package/dist/extensions/pi.mjs

@@ -0,0 +1 @@
+import{activatePromptExtension as e}from"../adapters/pi/extension.mjs";export{e as activatePromptExtension,e as default};

package/dist/hubApi.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./adapters/hubApi.cjs");exports.api=e.api,exports.createPromptHubApi=e.createPromptHubApi;

package/dist/hubApi.d.cts

@@ -0,0 +1,2 @@
+import { HubApiOptions, api, createPromptHubApi } from "./adapters/hubApi.cjs";
+export { type HubApiOptions, api, createPromptHubApi };

package/dist/hubApi.d.mts

@@ -0,0 +1,2 @@
+import { HubApiOptions, api, createPromptHubApi } from "./adapters/hubApi.mjs";
+export { type HubApiOptions, api, createPromptHubApi };

package/dist/hubApi.mjs

@@ -0,0 +1 @@
+import{api as e,createPromptHubApi as t}from"./adapters/hubApi.mjs";export{e as api,t as createPromptHubApi};

package/dist/index.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./services/savedPromptDocument.cjs"),t=require("./adapters/node/promptStore.cjs"),n=require("./services/recentPrompts.cjs"),r=require("./container/index.cjs"),i=require("./adapters/pi/extension.cjs");exports.PROMPT_NAME_RULE=e.PROMPT_NAME_RULE,exports.RECENT_PROMPT_LIMIT=n.RECENT_PROMPT_LIMIT,exports.activatePromptExtension=i.activatePromptExtension,exports.buildPromptDocument=e.buildPromptDocument,exports.createNodeSavedPromptStore=t.createNodeSavedPromptStore,exports.createPromptContainer=r.createPromptContainer,exports.createRecentPrompts=n.createRecentPrompts,exports.describePrompt=e.describePrompt,exports.hasArgumentTokens=e.hasArgumentTokens,exports.installPromptRuntime=i.installPromptRuntime,exports.isValidPromptName=e.isValidPromptName,exports.parsePromptDocument=e.parsePromptDocument,exports.resolvePromptsDirectory=t.resolvePromptsDirectory;

package/dist/index.d.cts

@@ -0,0 +1,7 @@
+import { PromptExtensionDependencies, RecentPrompts, SavedPrompt, SavedPromptStore, SavedPromptWrite } from "./types/prompt.cjs";
+import { activatePromptExtension, installPromptRuntime } from "./adapters/pi/extension.cjs";
+import { createNodeSavedPromptStore, resolvePromptsDirectory } from "./adapters/node/promptStore.cjs";
+import { createPromptContainer } from "./container/index.cjs";
+import { RECENT_PROMPT_LIMIT, createRecentPrompts } from "./services/recentPrompts.cjs";
+import { PROMPT_NAME_RULE, buildPromptDocument, describePrompt, hasArgumentTokens, isValidPromptName, parsePromptDocument } from "./services/savedPromptDocument.cjs";
+export { PROMPT_NAME_RULE, type PromptExtensionDependencies, RECENT_PROMPT_LIMIT, type RecentPrompts, type SavedPrompt, type SavedPromptStore, type SavedPromptWrite, activatePromptExtension, buildPromptDocument, createNodeSavedPromptStore, createPromptContainer, createRecentPrompts, describePrompt, hasArgumentTokens, installPromptRuntime, isValidPromptName, parsePromptDocument, resolvePromptsDirectory };

package/dist/index.d.mts

@@ -0,0 +1,7 @@
+import { PromptExtensionDependencies, RecentPrompts, SavedPrompt, SavedPromptStore, SavedPromptWrite } from "./types/prompt.mjs";
+import { activatePromptExtension, installPromptRuntime } from "./adapters/pi/extension.mjs";
+import { createNodeSavedPromptStore, resolvePromptsDirectory } from "./adapters/node/promptStore.mjs";
+import { createPromptContainer } from "./container/index.mjs";
+import { RECENT_PROMPT_LIMIT, createRecentPrompts } from "./services/recentPrompts.mjs";
+import { PROMPT_NAME_RULE, buildPromptDocument, describePrompt, hasArgumentTokens, isValidPromptName, parsePromptDocument } from "./services/savedPromptDocument.mjs";
+export { PROMPT_NAME_RULE, type PromptExtensionDependencies, RECENT_PROMPT_LIMIT, type RecentPrompts, type SavedPrompt, type SavedPromptStore, type SavedPromptWrite, activatePromptExtension, buildPromptDocument, createNodeSavedPromptStore, createPromptContainer, createRecentPrompts, describePrompt, hasArgumentTokens, installPromptRuntime, isValidPromptName, parsePromptDocument, resolvePromptsDirectory };

package/dist/index.mjs

@@ -0,0 +1 @@
+import{PROMPT_NAME_RULE as e,buildPromptDocument as t,describePrompt as n,hasArgumentTokens as r,isValidPromptName as i,parsePromptDocument as a}from"./services/savedPromptDocument.mjs";import{createNodeSavedPromptStore as o,resolvePromptsDirectory as s}from"./adapters/node/promptStore.mjs";import{RECENT_PROMPT_LIMIT as c,createRecentPrompts as l}from"./services/recentPrompts.mjs";import{createPromptContainer as u}from"./container/index.mjs";import{activatePromptExtension as d,installPromptRuntime as f}from"./adapters/pi/extension.mjs";export{e as PROMPT_NAME_RULE,c as RECENT_PROMPT_LIMIT,d as activatePromptExtension,t as buildPromptDocument,o as createNodeSavedPromptStore,u as createPromptContainer,l as createRecentPrompts,n as describePrompt,r as hasArgumentTokens,f as installPromptRuntime,i as isValidPromptName,a as parsePromptDocument,s as resolvePromptsDirectory};

package/dist/services/promptItems.cjs

@@ -0,0 +1,2 @@
+const e=require("./savedPromptDocument.cjs"),t=`recent:`,n=`saved:`;function r(r,i){let a=[];for(let[n,i]of r.entries())a.push({value:`${t}${String(n)}`,label:e.describePrompt(i)||i,description:`staged this session`});for(let t of i)a.push({value:`${n}${t.name}`,label:`/${t.name}`,description:t.description||e.describePrompt(t.text)});return a}function i(e){if(e.startsWith(t))return{kind:`recent`,key:e.slice(7)};if(e.startsWith(n))return{kind:`saved`,key:e.slice(6)}}function a(e,t,n){let r=i(e);if(r){if(r.kind===`recent`){let e=Number.parseInt(r.key,10);return Number.isInteger(e)?t[e]:void 0}return n.find(e=>e.name===r.key)?.text}}function o(e,t){return e.trim()?`${e.replace(/\s+$/u,``)}\n${t}`:t}exports.parsePromptSelection=i,exports.promptItems=r,exports.resolvePromptSelection=a,exports.stagedEditorText=o;
+//# sourceMappingURL=promptItems.cjs.map

package/dist/services/promptItems.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"promptItems.cjs","names":["describePrompt"],"sources":["../../src/services/promptItems.ts"],"sourcesContent":["import type { SelectItem } from '@earendil-works/pi-tui';\nimport type { SavedPrompt } from '../types/prompt.ts';\nimport { describePrompt } from './savedPromptDocument.ts';\n\n/**\n * Picker rows for staged and saved prompts.\n *\n * DESIGN PATTERNS:\n * - Values are opaque routing keys, never the prompt text: a value carries the\n *   section and the index or name, and the caller resolves it back to text.\n *   Prompt bodies are multi-line, and a list value has to stay one token.\n * - Section headings are plain disabled-looking rows rather than a new picker\n *   feature, so the shared MatrixPicker stays untouched.\n *\n * AVOID:\n * - Putting the prompt body in the label: the list renders one line per row.\n */\n\nconst RECENT_VALUE_PREFIX = 'recent:';\nconst SAVED_VALUE_PREFIX = 'saved:';\n\nexport interface PromptSelection {\n  kind: 'recent' | 'saved';\n  key: string;\n}\n\nexport function promptItems(recent: readonly string[], saved: readonly SavedPrompt[]): SelectItem[] {\n  const items: SelectItem[] = [];\n  for (const [index, text] of recent.entries()) {\n    items.push({\n      value: `${RECENT_VALUE_PREFIX}${String(index)}`,\n      label: describePrompt(text) || text,\n      description: 'staged this session',\n    });\n  }\n  for (const prompt of saved) {\n    items.push({\n      value: `${SAVED_VALUE_PREFIX}${prompt.name}`,\n      label: `/${prompt.name}`,\n      description: prompt.description || describePrompt(prompt.text),\n    });\n  }\n  return items;\n}\n\n/** Reads a picker value back into the entry it points at. */\nexport function parsePromptSelection(value: string): PromptSelection | undefined {\n  if (value.startsWith(RECENT_VALUE_PREFIX)) {\n    return { kind: 'recent', key: value.slice(RECENT_VALUE_PREFIX.length) };\n  }\n  if (value.startsWith(SAVED_VALUE_PREFIX)) {\n    return { kind: 'saved', key: value.slice(SAVED_VALUE_PREFIX.length) };\n  }\n  return undefined;\n}\n\n/** The text a selected row stages, or undefined when the row went stale. */\nexport function resolvePromptSelection(\n  value: string,\n  recent: readonly string[],\n  saved: readonly SavedPrompt[],\n): string | undefined {\n  const selection = parsePromptSelection(value);\n  if (!selection) return undefined;\n  if (selection.kind === 'recent') {\n    const index = Number.parseInt(selection.key, 10);\n    return Number.isInteger(index) ? recent[index] : undefined;\n  }\n  return saved.find((prompt) => prompt.name === selection.key)?.text;\n}\n\n/** Appends to a draft instead of discarding it, since staging is additive. */\nexport function stagedEditorText(draft: string, chosen: string): string {\n  return draft.trim() ? `${draft.replace(/\\s+$/u, '')}\\n${chosen}` : chosen;\n}\n"],"mappings":"6CAkBM,EAAsB,UACtB,EAAqB,SAO3B,SAAgB,EAAY,EAA2B,EAA6C,CAClG,IAAM,EAAsB,CAAC,EAC7B,IAAK,GAAM,CAAC,EAAO,KAAS,EAAO,QAAQ,EACzC,EAAM,KAAK,CACT,MAAO,GAAG,IAAsB,OAAO,CAAK,IAC5C,MAAOA,EAAAA,eAAe,CAAI,GAAK,EAC/B,YAAa,qBACf,CAAC,EAEH,IAAK,IAAM,KAAU,EACnB,EAAM,KAAK,CACT,MAAO,GAAG,IAAqB,EAAO,OACtC,MAAO,IAAI,EAAO,OAClB,YAAa,EAAO,aAAeA,EAAAA,eAAe,EAAO,IAAI,CAC/D,CAAC,EAEH,OAAO,CACT,CAGA,SAAgB,EAAqB,EAA4C,CAC/E,GAAI,EAAM,WAAW,CAAmB,EACtC,MAAO,CAAE,KAAM,SAAU,IAAK,EAAM,MAAM,CAA0B,CAAE,EAExE,GAAI,EAAM,WAAW,CAAkB,EACrC,MAAO,CAAE,KAAM,QAAS,IAAK,EAAM,MAAM,CAAyB,CAAE,CAGxE,CAGA,SAAgB,EACd,EACA,EACA,EACoB,CACpB,IAAM,EAAY,EAAqB,CAAK,EACvC,KACL,IAAI,EAAU,OAAS,SAAU,CAC/B,IAAM,EAAQ,OAAO,SAAS,EAAU,IAAK,EAAE,EAC/C,OAAO,OAAO,UAAU,CAAK,EAAI,EAAO,GAAS,IAAA,EACnD,CACA,OAAO,EAAM,KAAM,GAAW,EAAO,OAAS,EAAU,GAAG,CAAC,EAAE,IAD9D,CAEF,CAGA,SAAgB,EAAiB,EAAe,EAAwB,CACtE,OAAO,EAAM,KAAK,EAAI,GAAG,EAAM,QAAQ,QAAS,EAAE,EAAE,IAAI,IAAW,CACrE"}

package/dist/services/promptItems.mjs

@@ -0,0 +1,2 @@
+import{describePrompt as e}from"./savedPromptDocument.mjs";const t=`recent:`,n=`saved:`;function r(r,i){let a=[];for(let[n,i]of r.entries())a.push({value:`${t}${String(n)}`,label:e(i)||i,description:`staged this session`});for(let t of i)a.push({value:`${n}${t.name}`,label:`/${t.name}`,description:t.description||e(t.text)});return a}function i(e){if(e.startsWith(t))return{kind:`recent`,key:e.slice(7)};if(e.startsWith(n))return{kind:`saved`,key:e.slice(6)}}function a(e,t,n){let r=i(e);if(r){if(r.kind===`recent`){let e=Number.parseInt(r.key,10);return Number.isInteger(e)?t[e]:void 0}return n.find(e=>e.name===r.key)?.text}}function o(e,t){return e.trim()?`${e.replace(/\s+$/u,``)}\n${t}`:t}export{i as parsePromptSelection,r as promptItems,a as resolvePromptSelection,o as stagedEditorText};
+//# sourceMappingURL=promptItems.mjs.map

package/dist/services/promptItems.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"promptItems.mjs","names":[],"sources":["../../src/services/promptItems.ts"],"sourcesContent":["import type { SelectItem } from '@earendil-works/pi-tui';\nimport type { SavedPrompt } from '../types/prompt.ts';\nimport { describePrompt } from './savedPromptDocument.ts';\n\n/**\n * Picker rows for staged and saved prompts.\n *\n * DESIGN PATTERNS:\n * - Values are opaque routing keys, never the prompt text: a value carries the\n *   section and the index or name, and the caller resolves it back to text.\n *   Prompt bodies are multi-line, and a list value has to stay one token.\n * - Section headings are plain disabled-looking rows rather than a new picker\n *   feature, so the shared MatrixPicker stays untouched.\n *\n * AVOID:\n * - Putting the prompt body in the label: the list renders one line per row.\n */\n\nconst RECENT_VALUE_PREFIX = 'recent:';\nconst SAVED_VALUE_PREFIX = 'saved:';\n\nexport interface PromptSelection {\n  kind: 'recent' | 'saved';\n  key: string;\n}\n\nexport function promptItems(recent: readonly string[], saved: readonly SavedPrompt[]): SelectItem[] {\n  const items: SelectItem[] = [];\n  for (const [index, text] of recent.entries()) {\n    items.push({\n      value: `${RECENT_VALUE_PREFIX}${String(index)}`,\n      label: describePrompt(text) || text,\n      description: 'staged this session',\n    });\n  }\n  for (const prompt of saved) {\n    items.push({\n      value: `${SAVED_VALUE_PREFIX}${prompt.name}`,\n      label: `/${prompt.name}`,\n      description: prompt.description || describePrompt(prompt.text),\n    });\n  }\n  return items;\n}\n\n/** Reads a picker value back into the entry it points at. */\nexport function parsePromptSelection(value: string): PromptSelection | undefined {\n  if (value.startsWith(RECENT_VALUE_PREFIX)) {\n    return { kind: 'recent', key: value.slice(RECENT_VALUE_PREFIX.length) };\n  }\n  if (value.startsWith(SAVED_VALUE_PREFIX)) {\n    return { kind: 'saved', key: value.slice(SAVED_VALUE_PREFIX.length) };\n  }\n  return undefined;\n}\n\n/** The text a selected row stages, or undefined when the row went stale. */\nexport function resolvePromptSelection(\n  value: string,\n  recent: readonly string[],\n  saved: readonly SavedPrompt[],\n): string | undefined {\n  const selection = parsePromptSelection(value);\n  if (!selection) return undefined;\n  if (selection.kind === 'recent') {\n    const index = Number.parseInt(selection.key, 10);\n    return Number.isInteger(index) ? recent[index] : undefined;\n  }\n  return saved.find((prompt) => prompt.name === selection.key)?.text;\n}\n\n/** Appends to a draft instead of discarding it, since staging is additive. */\nexport function stagedEditorText(draft: string, chosen: string): string {\n  return draft.trim() ? `${draft.replace(/\\s+$/u, '')}\\n${chosen}` : chosen;\n}\n"],"mappings":"2DAkBA,MAAM,EAAsB,UACtB,EAAqB,SAO3B,SAAgB,EAAY,EAA2B,EAA6C,CAClG,IAAM,EAAsB,CAAC,EAC7B,IAAK,GAAM,CAAC,EAAO,KAAS,EAAO,QAAQ,EACzC,EAAM,KAAK,CACT,MAAO,GAAG,IAAsB,OAAO,CAAK,IAC5C,MAAO,EAAe,CAAI,GAAK,EAC/B,YAAa,qBACf,CAAC,EAEH,IAAK,IAAM,KAAU,EACnB,EAAM,KAAK,CACT,MAAO,GAAG,IAAqB,EAAO,OACtC,MAAO,IAAI,EAAO,OAClB,YAAa,EAAO,aAAe,EAAe,EAAO,IAAI,CAC/D,CAAC,EAEH,OAAO,CACT,CAGA,SAAgB,EAAqB,EAA4C,CAC/E,GAAI,EAAM,WAAW,CAAmB,EACtC,MAAO,CAAE,KAAM,SAAU,IAAK,EAAM,MAAM,CAA0B,CAAE,EAExE,GAAI,EAAM,WAAW,CAAkB,EACrC,MAAO,CAAE,KAAM,QAAS,IAAK,EAAM,MAAM,CAAyB,CAAE,CAGxE,CAGA,SAAgB,EACd,EACA,EACA,EACoB,CACpB,IAAM,EAAY,EAAqB,CAAK,EACvC,KACL,IAAI,EAAU,OAAS,SAAU,CAC/B,IAAM,EAAQ,OAAO,SAAS,EAAU,IAAK,EAAE,EAC/C,OAAO,OAAO,UAAU,CAAK,EAAI,EAAO,GAAS,IAAA,EACnD,CACA,OAAO,EAAM,KAAM,GAAW,EAAO,OAAS,EAAU,GAAG,CAAC,EAAE,IAD9D,CAEF,CAGA,SAAgB,EAAiB,EAAe,EAAwB,CACtE,OAAO,EAAM,KAAK,EAAI,GAAG,EAAM,QAAQ,QAAS,EAAE,EAAE,IAAI,IAAW,CACrE"}

package/dist/services/recentPrompts.cjs

@@ -0,0 +1,2 @@
+function e(e=3){let t=[];return{push(n){let r=n.trim();r&&t[0]!==r&&(t=[r,...t].slice(0,e))},list(){return t}}}exports.RECENT_PROMPT_LIMIT=3,exports.createRecentPrompts=e;
+//# sourceMappingURL=recentPrompts.cjs.map

package/dist/services/recentPrompts.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"recentPrompts.cjs","names":[],"sources":["../../src/services/recentPrompts.ts"],"sourcesContent":["import type { RecentPrompts } from '../types/prompt.ts';\n\n/**\n * The staged prompt ring.\n *\n * DESIGN PATTERNS:\n * - Session-scoped and in memory. Nothing here touches the filesystem, so a\n *   prompt the user never explicitly saved is never written anywhere.\n * - Mirrors pi-tui's own history rules (trim, drop empty, skip a consecutive\n *   duplicate) so the picker and arrow up/down agree on what counts as an entry.\n *\n * AVOID:\n * - Growing the ring: three entries is the contract, not a default.\n */\n\n/** How many prompts stay staged for quick reuse. */\nexport const RECENT_PROMPT_LIMIT = 3;\n\nexport function createRecentPrompts(limit: number = RECENT_PROMPT_LIMIT): RecentPrompts {\n  let entries: string[] = [];\n\n  return {\n    push(text: string): void {\n      const trimmed = text.trim();\n      if (!trimmed) return;\n      if (entries[0] === trimmed) return;\n      entries = [trimmed, ...entries].slice(0, limit);\n    },\n    list(): readonly string[] {\n      return entries;\n    },\n  };\n}\n"],"mappings":"AAkBA,SAAgB,EAAoB,EAAA,EAAoD,CACtF,IAAI,EAAoB,CAAC,EAEzB,MAAO,CACL,KAAK,EAAoB,CACvB,IAAM,EAAU,EAAK,KAAK,EACrB,GACD,EAAQ,KAAO,IACnB,EAAU,CAAC,EAAS,GAAG,CAAO,CAAC,CAAC,MAAM,EAAG,CAAK,EAChD,EACA,MAA0B,CACxB,OAAO,CACT,CACF,CACF"}

package/dist/services/recentPrompts.d.cts

@@ -0,0 +1,20 @@
+import { RecentPrompts } from "../types/prompt.cjs";
+//#region src/services/recentPrompts.d.ts
+/**
+ * The staged prompt ring.
+ *
+ * DESIGN PATTERNS:
+ * - Session-scoped and in memory. Nothing here touches the filesystem, so a
+ *   prompt the user never explicitly saved is never written anywhere.
+ * - Mirrors pi-tui's own history rules (trim, drop empty, skip a consecutive
+ *   duplicate) so the picker and arrow up/down agree on what counts as an entry.
+ *
+ * AVOID:
+ * - Growing the ring: three entries is the contract, not a default.
+ */
+/** How many prompts stay staged for quick reuse. */
+declare const RECENT_PROMPT_LIMIT = 3;
+declare function createRecentPrompts(limit?: number): RecentPrompts;
+//#endregion
+export { RECENT_PROMPT_LIMIT, createRecentPrompts };
+//# sourceMappingURL=recentPrompts.d.cts.map

package/dist/services/recentPrompts.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recentPrompts.d.cts","names":[],"sources":["../../src/services/recentPrompts.ts"],"mappings":";;;;;;;;;;;;;;;cAgBa;iBAEG,oBAAoB,iBAAsC"}

package/dist/services/recentPrompts.d.mts

@@ -0,0 +1,20 @@
+import { RecentPrompts } from "../types/prompt.mjs";
+//#region src/services/recentPrompts.d.ts
+/**
+ * The staged prompt ring.
+ *
+ * DESIGN PATTERNS:
+ * - Session-scoped and in memory. Nothing here touches the filesystem, so a
+ *   prompt the user never explicitly saved is never written anywhere.
+ * - Mirrors pi-tui's own history rules (trim, drop empty, skip a consecutive
+ *   duplicate) so the picker and arrow up/down agree on what counts as an entry.
+ *
+ * AVOID:
+ * - Growing the ring: three entries is the contract, not a default.
+ */
+/** How many prompts stay staged for quick reuse. */
+declare const RECENT_PROMPT_LIMIT = 3;
+declare function createRecentPrompts(limit?: number): RecentPrompts;
+//#endregion
+export { RECENT_PROMPT_LIMIT, createRecentPrompts };
+//# sourceMappingURL=recentPrompts.d.mts.map

package/dist/services/recentPrompts.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recentPrompts.d.mts","names":[],"sources":["../../src/services/recentPrompts.ts"],"mappings":";;;;;;;;;;;;;;;cAgBa;iBAEG,oBAAoB,iBAAsC"}

package/dist/services/recentPrompts.mjs

@@ -0,0 +1,2 @@
+const e=3;function t(e=3){let t=[];return{push(n){let r=n.trim();r&&t[0]!==r&&(t=[r,...t].slice(0,e))},list(){return t}}}export{e as RECENT_PROMPT_LIMIT,t as createRecentPrompts};
+//# sourceMappingURL=recentPrompts.mjs.map

package/dist/services/recentPrompts.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"recentPrompts.mjs","names":[],"sources":["../../src/services/recentPrompts.ts"],"sourcesContent":["import type { RecentPrompts } from '../types/prompt.ts';\n\n/**\n * The staged prompt ring.\n *\n * DESIGN PATTERNS:\n * - Session-scoped and in memory. Nothing here touches the filesystem, so a\n *   prompt the user never explicitly saved is never written anywhere.\n * - Mirrors pi-tui's own history rules (trim, drop empty, skip a consecutive\n *   duplicate) so the picker and arrow up/down agree on what counts as an entry.\n *\n * AVOID:\n * - Growing the ring: three entries is the contract, not a default.\n */\n\n/** How many prompts stay staged for quick reuse. */\nexport const RECENT_PROMPT_LIMIT = 3;\n\nexport function createRecentPrompts(limit: number = RECENT_PROMPT_LIMIT): RecentPrompts {\n  let entries: string[] = [];\n\n  return {\n    push(text: string): void {\n      const trimmed = text.trim();\n      if (!trimmed) return;\n      if (entries[0] === trimmed) return;\n      entries = [trimmed, ...entries].slice(0, limit);\n    },\n    list(): readonly string[] {\n      return entries;\n    },\n  };\n}\n"],"mappings":"AAgBA,MAAa,EAAsB,EAEnC,SAAgB,EAAoB,EAAA,EAAoD,CACtF,IAAI,EAAoB,CAAC,EAEzB,MAAO,CACL,KAAK,EAAoB,CACvB,IAAM,EAAU,EAAK,KAAK,EACrB,GACD,EAAQ,KAAO,IACnB,EAAU,CAAC,EAAS,GAAG,CAAO,CAAC,CAAC,MAAM,EAAG,CAAK,EAChD,EACA,MAA0B,CACxB,OAAO,CACT,CACF,CACF"}

package/dist/services/savedPromptDocument.cjs

@@ -0,0 +1,11 @@
+const e=/^[a-z0-9][a-z0-9-]*$/u,t=/\$(?:\d|@|\{|ARGUMENTS)/u;function n(t){return t.length<=64&&e.test(t)}function r(e){return t.test(e)}function i(e){let t=e.split(`
+`).map(e=>e.trim()).find(e=>e.length>0);return t?t.length<=80?t:`${t.slice(0,79).trimEnd()}…`:``}function a(e){return`"${e.replaceAll(/\s+/gu,` `).trim().replaceAll(`\\`,`\\\\`).replaceAll(`"`,`\\"`)}"`}function o(e){let t=e.trim();return!t.startsWith(`"`)||!t.endsWith(`"`)||t.length<2?t:t.slice(1,-1).replaceAll(`\\"`,`"`).replaceAll(`\\\\`,`\\`)}function s(e){let t=e.text.endsWith(`
+`)?e.text:`${e.text}\n`,n=e.description.trim();return n?[`---`,`description: ${a(n)}`,`---`,t].join(`
+`):t}function c(e,t){let n=t.replaceAll(`\r
+`,`
+`);if(!n.startsWith(`---
+`))return{name:e,description:i(n),text:n.trim()};let r=n.indexOf(`
+---
+`,3);if(r===-1)return{name:e,description:i(n),text:n.trim()};let a=n.slice(4,r),s=n.slice(r+3+2).trim(),c=a.split(`
+`).find(e=>e.trimStart().startsWith(`description:`));return{name:e,description:c?o(c.trimStart().slice(12)):i(s),text:s}}exports.PROMPT_NAME_RULE=`lowercase letters, digits and dashes, starting with a letter or digit`,exports.buildPromptDocument=s,exports.describePrompt=i,exports.hasArgumentTokens=r,exports.isValidPromptName=n,exports.parsePromptDocument=c;
+//# sourceMappingURL=savedPromptDocument.cjs.map

package/dist/services/savedPromptDocument.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"savedPromptDocument.cjs","names":[],"sources":["../../src/services/savedPromptDocument.ts"],"sourcesContent":["import type { SavedPrompt } from '../types/prompt.ts';\n\n/**\n * The saved prompt document format.\n *\n * DESIGN PATTERNS:\n * - A saved prompt is an ordinary Pi prompt template: YAML frontmatter with a\n *   description, then the prompt body verbatim. Reusing that format is why\n *   `/<name>` works on the next start without this package registering anything.\n * - Pure string handling. The store owns paths and the filesystem.\n *\n * AVOID:\n * - A richer frontmatter surface. Anything this package invents here stops\n *   being a plain template that Pi can already read.\n */\n\nconst FRONTMATTER_FENCE = '---';\nconst DESCRIPTION_KEY = 'description:';\n/** Keeps the picker's second column to one readable line. */\nconst DESCRIPTION_LIMIT = 80;\n/** Filename and slash command in one, so the name has to be safe as both. */\nconst NAME_PATTERN = /^[a-z0-9][a-z0-9-]*$/u;\nconst NAME_LIMIT = 64;\n/** Tokens Pi's template engine substitutes when the prompt is invoked. */\nconst ARGUMENT_TOKEN_PATTERN = /\\$(?:\\d|@|\\{|ARGUMENTS)/u;\n\n/** The pattern a saved prompt name must match, for user-facing messages. */\nexport const PROMPT_NAME_RULE = 'lowercase letters, digits and dashes, starting with a letter or digit';\n\nexport function isValidPromptName(name: string): boolean {\n  return name.length <= NAME_LIMIT && NAME_PATTERN.test(name);\n}\n\n/** Whether Pi would substitute argument tokens into this text on invocation. */\nexport function hasArgumentTokens(text: string): boolean {\n  return ARGUMENT_TOKEN_PATTERN.test(text);\n}\n\n/** The first non-empty line, shortened for the picker's description column. */\nexport function describePrompt(text: string): string {\n  const firstLine = text\n    .split('\\n')\n    .map((line) => line.trim())\n    .find((line) => line.length > 0);\n  if (!firstLine) return '';\n  if (firstLine.length <= DESCRIPTION_LIMIT) return firstLine;\n  return `${firstLine.slice(0, DESCRIPTION_LIMIT - 1).trimEnd()}…`;\n}\n\n/** Quotes the description so a colon or a quote cannot break the frontmatter. */\nfunction quoteDescription(description: string): string {\n  const flattened = description.replaceAll(/\\s+/gu, ' ').trim();\n  const escaped = flattened.replaceAll('\\\\', '\\\\\\\\').replaceAll('\"', '\\\\\"');\n  return `\"${escaped}\"`;\n}\n\nfunction unquoteDescription(value: string): string {\n  const trimmed = value.trim();\n  if (!trimmed.startsWith('\"') || !trimmed.endsWith('\"') || trimmed.length < 2) return trimmed;\n  return trimmed.slice(1, -1).replaceAll('\\\\\"', '\"').replaceAll('\\\\\\\\', '\\\\');\n}\n\nexport function buildPromptDocument(prompt: Pick<SavedPrompt, 'description' | 'text'>): string {\n  const body = prompt.text.endsWith('\\n') ? prompt.text : `${prompt.text}\\n`;\n  const description = prompt.description.trim();\n  if (!description) return body;\n  return [FRONTMATTER_FENCE, `description: ${quoteDescription(description)}`, FRONTMATTER_FENCE, body].join('\\n');\n}\n\n/**\n * Splits a template back into its description and body.\n *\n * A document without frontmatter, or with frontmatter this package did not\n * write, is still a usable prompt: the whole file becomes the body and the\n * description falls back to the first line.\n */\nexport function parsePromptDocument(name: string, content: string): SavedPrompt {\n  const normalized = content.replaceAll('\\r\\n', '\\n');\n  if (!normalized.startsWith(`${FRONTMATTER_FENCE}\\n`)) {\n    return { name, description: describePrompt(normalized), text: normalized.trim() };\n  }\n\n  const closing = normalized.indexOf(`\\n${FRONTMATTER_FENCE}\\n`, FRONTMATTER_FENCE.length);\n  if (closing === -1) {\n    return { name, description: describePrompt(normalized), text: normalized.trim() };\n  }\n\n  const frontmatter = normalized.slice(FRONTMATTER_FENCE.length + 1, closing);\n  const body = normalized.slice(closing + FRONTMATTER_FENCE.length + 2).trim();\n  const descriptionLine = frontmatter.split('\\n').find((line) => line.trimStart().startsWith(DESCRIPTION_KEY));\n  const description = descriptionLine\n    ? unquoteDescription(descriptionLine.trimStart().slice(DESCRIPTION_KEY.length))\n    : describePrompt(body);\n\n  return { name, description, text: body };\n}\n"],"mappings":"AAgBA,MAKM,EAAe,wBAGf,EAAyB,2BAK/B,SAAgB,EAAkB,EAAuB,CACvD,OAAO,EAAK,QAAU,IAAc,EAAa,KAAK,CAAI,CAC5D,CAGA,SAAgB,EAAkB,EAAuB,CACvD,OAAO,EAAuB,KAAK,CAAI,CACzC,CAGA,SAAgB,EAAe,EAAsB,CACnD,IAAM,EAAY,EACf,MAAM;CAAI,CAAC,CACX,IAAK,GAAS,EAAK,KAAK,CAAC,CAAC,CAC1B,KAAM,GAAS,EAAK,OAAS,CAAC,EAGjC,OAFK,EACD,EAAU,QAAU,GAA0B,EAC3C,GAAG,EAAU,MAAM,EAAG,EAAqB,CAAC,CAAC,QAAQ,EAAE,GAFvC,EAGzB,CAGA,SAAS,EAAiB,EAA6B,CAGrD,MAAO,IAFW,EAAY,WAAW,QAAS,GAAG,CAAC,CAAC,KAC/B,CAAC,CAAC,WAAW,KAAM,MAAM,CAAC,CAAC,WAAW,IAAK,KAClD,EAAE,EACrB,CAEA,SAAS,EAAmB,EAAuB,CACjD,IAAM,EAAU,EAAM,KAAK,EAE3B,MADI,CAAC,EAAQ,WAAW,GAAG,GAAK,CAAC,EAAQ,SAAS,GAAG,GAAK,EAAQ,OAAS,EAAU,EAC9E,EAAQ,MAAM,EAAG,EAAE,CAAC,CAAC,WAAW,MAAO,GAAG,CAAC,CAAC,WAAW,OAAQ,IAAI,CAC5E,CAEA,SAAgB,EAAoB,EAA2D,CAC7F,IAAM,EAAO,EAAO,KAAK,SAAS;CAAI,EAAI,EAAO,KAAO,GAAG,EAAO,KAAK,IACjE,EAAc,EAAO,YAAY,KAAK,EAE5C,OADK,EACE,CAAC,MAAmB,gBAAgB,EAAiB,CAAW,IAAK,MAAmB,CAAI,CAAC,CAAC,KAAK;CAAI,EADrF,CAE3B,CASA,SAAgB,EAAoB,EAAc,EAA8B,CAC9E,IAAM,EAAa,EAAQ,WAAW;EAAQ;CAAI,EAClD,GAAI,CAAC,EAAW,WAAW;CAAwB,EACjD,MAAO,CAAE,OAAM,YAAa,EAAe,CAAU,EAAG,KAAM,EAAW,KAAK,CAAE,EAGlF,IAAM,EAAU,EAAW,QAAQ;;EAA4B,CAAwB,EACvF,GAAI,IAAY,GACd,MAAO,CAAE,OAAM,YAAa,EAAe,CAAU,EAAG,KAAM,EAAW,KAAK,CAAE,EAGlF,IAAM,EAAc,EAAW,MAAM,EAA8B,CAAO,EACpE,EAAO,EAAW,MAAM,EAAU,EAA2B,CAAC,CAAC,CAAC,KAAK,EACrE,EAAkB,EAAY,MAAM;CAAI,CAAC,CAAC,KAAM,GAAS,EAAK,UAAU,CAAC,CAAC,WAAW,cAAe,CAAC,EAK3G,MAAO,CAAE,OAAM,YAJK,EAChB,EAAmB,EAAgB,UAAU,CAAC,CAAC,MAAM,EAAsB,CAAC,EAC5E,EAAe,CAAI,EAEK,KAAM,CAAK,CACzC"}

package/dist/services/savedPromptDocument.d.cts

@@ -0,0 +1,21 @@
+import { SavedPrompt } from "../types/prompt.cjs";
+//#region src/services/savedPromptDocument.d.ts
+/** The pattern a saved prompt name must match, for user-facing messages. */
+declare const PROMPT_NAME_RULE = "lowercase letters, digits and dashes, starting with a letter or digit";
+declare function isValidPromptName(name: string): boolean;
+/** Whether Pi would substitute argument tokens into this text on invocation. */
+declare function hasArgumentTokens(text: string): boolean;
+/** The first non-empty line, shortened for the picker's description column. */
+declare function describePrompt(text: string): string;
+declare function buildPromptDocument(prompt: Pick<SavedPrompt, 'description' | 'text'>): string;
+/**
+ * Splits a template back into its description and body.
+ *
+ * A document without frontmatter, or with frontmatter this package did not
+ * write, is still a usable prompt: the whole file becomes the body and the
+ * description falls back to the first line.
+ */
+declare function parsePromptDocument(name: string, content: string): SavedPrompt;
+//#endregion
+export { PROMPT_NAME_RULE, buildPromptDocument, describePrompt, hasArgumentTokens, isValidPromptName, parsePromptDocument };
+//# sourceMappingURL=savedPromptDocument.d.cts.map

package/dist/services/savedPromptDocument.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"savedPromptDocument.d.cts","names":[],"sources":["../../src/services/savedPromptDocument.ts"],"mappings":";;;cA2Ba;iBAEG,kBAAkB;;iBAKlB,kBAAkB;;iBAKlB,eAAe;iBAuBf,oBAAoB,QAAQ,KAAK;;;;;;;;iBAcjC,oBAAoB,cAAc,kBAAkB"}

package/dist/services/savedPromptDocument.d.mts

@@ -0,0 +1,21 @@
+import { SavedPrompt } from "../types/prompt.mjs";
+//#region src/services/savedPromptDocument.d.ts
+/** The pattern a saved prompt name must match, for user-facing messages. */
+declare const PROMPT_NAME_RULE = "lowercase letters, digits and dashes, starting with a letter or digit";
+declare function isValidPromptName(name: string): boolean;
+/** Whether Pi would substitute argument tokens into this text on invocation. */
+declare function hasArgumentTokens(text: string): boolean;
+/** The first non-empty line, shortened for the picker's description column. */
+declare function describePrompt(text: string): string;
+declare function buildPromptDocument(prompt: Pick<SavedPrompt, 'description' | 'text'>): string;
+/**
+ * Splits a template back into its description and body.
+ *
+ * A document without frontmatter, or with frontmatter this package did not
+ * write, is still a usable prompt: the whole file becomes the body and the
+ * description falls back to the first line.
+ */
+declare function parsePromptDocument(name: string, content: string): SavedPrompt;
+//#endregion
+export { PROMPT_NAME_RULE, buildPromptDocument, describePrompt, hasArgumentTokens, isValidPromptName, parsePromptDocument };
+//# sourceMappingURL=savedPromptDocument.d.mts.map

package/dist/services/savedPromptDocument.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"savedPromptDocument.d.mts","names":[],"sources":["../../src/services/savedPromptDocument.ts"],"mappings":";;;cA2Ba;iBAEG,kBAAkB;;iBAKlB,kBAAkB;;iBAKlB,eAAe;iBAuBf,oBAAoB,QAAQ,KAAK;;;;;;;;iBAcjC,oBAAoB,cAAc,kBAAkB"}

package/dist/services/savedPromptDocument.mjs

@@ -0,0 +1,11 @@
+const e=/^[a-z0-9][a-z0-9-]*$/u,t=/\$(?:\d|@|\{|ARGUMENTS)/u,n=`lowercase letters, digits and dashes, starting with a letter or digit`;function r(t){return t.length<=64&&e.test(t)}function i(e){return t.test(e)}function a(e){let t=e.split(`
+`).map(e=>e.trim()).find(e=>e.length>0);return t?t.length<=80?t:`${t.slice(0,79).trimEnd()}…`:``}function o(e){return`"${e.replaceAll(/\s+/gu,` `).trim().replaceAll(`\\`,`\\\\`).replaceAll(`"`,`\\"`)}"`}function s(e){let t=e.trim();return!t.startsWith(`"`)||!t.endsWith(`"`)||t.length<2?t:t.slice(1,-1).replaceAll(`\\"`,`"`).replaceAll(`\\\\`,`\\`)}function c(e){let t=e.text.endsWith(`
+`)?e.text:`${e.text}\n`,n=e.description.trim();return n?[`---`,`description: ${o(n)}`,`---`,t].join(`
+`):t}function l(e,t){let n=t.replaceAll(`\r
+`,`
+`);if(!n.startsWith(`---
+`))return{name:e,description:a(n),text:n.trim()};let r=n.indexOf(`
+---
+`,3);if(r===-1)return{name:e,description:a(n),text:n.trim()};let i=n.slice(4,r),o=n.slice(r+3+2).trim(),c=i.split(`
+`).find(e=>e.trimStart().startsWith(`description:`));return{name:e,description:c?s(c.trimStart().slice(12)):a(o),text:o}}export{n as PROMPT_NAME_RULE,c as buildPromptDocument,a as describePrompt,i as hasArgumentTokens,r as isValidPromptName,l as parsePromptDocument};
+//# sourceMappingURL=savedPromptDocument.mjs.map

package/dist/services/savedPromptDocument.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"savedPromptDocument.mjs","names":[],"sources":["../../src/services/savedPromptDocument.ts"],"sourcesContent":["import type { SavedPrompt } from '../types/prompt.ts';\n\n/**\n * The saved prompt document format.\n *\n * DESIGN PATTERNS:\n * - A saved prompt is an ordinary Pi prompt template: YAML frontmatter with a\n *   description, then the prompt body verbatim. Reusing that format is why\n *   `/<name>` works on the next start without this package registering anything.\n * - Pure string handling. The store owns paths and the filesystem.\n *\n * AVOID:\n * - A richer frontmatter surface. Anything this package invents here stops\n *   being a plain template that Pi can already read.\n */\n\nconst FRONTMATTER_FENCE = '---';\nconst DESCRIPTION_KEY = 'description:';\n/** Keeps the picker's second column to one readable line. */\nconst DESCRIPTION_LIMIT = 80;\n/** Filename and slash command in one, so the name has to be safe as both. */\nconst NAME_PATTERN = /^[a-z0-9][a-z0-9-]*$/u;\nconst NAME_LIMIT = 64;\n/** Tokens Pi's template engine substitutes when the prompt is invoked. */\nconst ARGUMENT_TOKEN_PATTERN = /\\$(?:\\d|@|\\{|ARGUMENTS)/u;\n\n/** The pattern a saved prompt name must match, for user-facing messages. */\nexport const PROMPT_NAME_RULE = 'lowercase letters, digits and dashes, starting with a letter or digit';\n\nexport function isValidPromptName(name: string): boolean {\n  return name.length <= NAME_LIMIT && NAME_PATTERN.test(name);\n}\n\n/** Whether Pi would substitute argument tokens into this text on invocation. */\nexport function hasArgumentTokens(text: string): boolean {\n  return ARGUMENT_TOKEN_PATTERN.test(text);\n}\n\n/** The first non-empty line, shortened for the picker's description column. */\nexport function describePrompt(text: string): string {\n  const firstLine = text\n    .split('\\n')\n    .map((line) => line.trim())\n    .find((line) => line.length > 0);\n  if (!firstLine) return '';\n  if (firstLine.length <= DESCRIPTION_LIMIT) return firstLine;\n  return `${firstLine.slice(0, DESCRIPTION_LIMIT - 1).trimEnd()}…`;\n}\n\n/** Quotes the description so a colon or a quote cannot break the frontmatter. */\nfunction quoteDescription(description: string): string {\n  const flattened = description.replaceAll(/\\s+/gu, ' ').trim();\n  const escaped = flattened.replaceAll('\\\\', '\\\\\\\\').replaceAll('\"', '\\\\\"');\n  return `\"${escaped}\"`;\n}\n\nfunction unquoteDescription(value: string): string {\n  const trimmed = value.trim();\n  if (!trimmed.startsWith('\"') || !trimmed.endsWith('\"') || trimmed.length < 2) return trimmed;\n  return trimmed.slice(1, -1).replaceAll('\\\\\"', '\"').replaceAll('\\\\\\\\', '\\\\');\n}\n\nexport function buildPromptDocument(prompt: Pick<SavedPrompt, 'description' | 'text'>): string {\n  const body = prompt.text.endsWith('\\n') ? prompt.text : `${prompt.text}\\n`;\n  const description = prompt.description.trim();\n  if (!description) return body;\n  return [FRONTMATTER_FENCE, `description: ${quoteDescription(description)}`, FRONTMATTER_FENCE, body].join('\\n');\n}\n\n/**\n * Splits a template back into its description and body.\n *\n * A document without frontmatter, or with frontmatter this package did not\n * write, is still a usable prompt: the whole file becomes the body and the\n * description falls back to the first line.\n */\nexport function parsePromptDocument(name: string, content: string): SavedPrompt {\n  const normalized = content.replaceAll('\\r\\n', '\\n');\n  if (!normalized.startsWith(`${FRONTMATTER_FENCE}\\n`)) {\n    return { name, description: describePrompt(normalized), text: normalized.trim() };\n  }\n\n  const closing = normalized.indexOf(`\\n${FRONTMATTER_FENCE}\\n`, FRONTMATTER_FENCE.length);\n  if (closing === -1) {\n    return { name, description: describePrompt(normalized), text: normalized.trim() };\n  }\n\n  const frontmatter = normalized.slice(FRONTMATTER_FENCE.length + 1, closing);\n  const body = normalized.slice(closing + FRONTMATTER_FENCE.length + 2).trim();\n  const descriptionLine = frontmatter.split('\\n').find((line) => line.trimStart().startsWith(DESCRIPTION_KEY));\n  const description = descriptionLine\n    ? unquoteDescription(descriptionLine.trimStart().slice(DESCRIPTION_KEY.length))\n    : describePrompt(body);\n\n  return { name, description, text: body };\n}\n"],"mappings":"AAgBA,MAKM,EAAe,wBAGf,EAAyB,2BAGlB,EAAmB,wEAEhC,SAAgB,EAAkB,EAAuB,CACvD,OAAO,EAAK,QAAU,IAAc,EAAa,KAAK,CAAI,CAC5D,CAGA,SAAgB,EAAkB,EAAuB,CACvD,OAAO,EAAuB,KAAK,CAAI,CACzC,CAGA,SAAgB,EAAe,EAAsB,CACnD,IAAM,EAAY,EACf,MAAM;CAAI,CAAC,CACX,IAAK,GAAS,EAAK,KAAK,CAAC,CAAC,CAC1B,KAAM,GAAS,EAAK,OAAS,CAAC,EAGjC,OAFK,EACD,EAAU,QAAU,GAA0B,EAC3C,GAAG,EAAU,MAAM,EAAG,EAAqB,CAAC,CAAC,QAAQ,EAAE,GAFvC,EAGzB,CAGA,SAAS,EAAiB,EAA6B,CAGrD,MAAO,IAFW,EAAY,WAAW,QAAS,GAAG,CAAC,CAAC,KAC/B,CAAC,CAAC,WAAW,KAAM,MAAM,CAAC,CAAC,WAAW,IAAK,KAClD,EAAE,EACrB,CAEA,SAAS,EAAmB,EAAuB,CACjD,IAAM,EAAU,EAAM,KAAK,EAE3B,MADI,CAAC,EAAQ,WAAW,GAAG,GAAK,CAAC,EAAQ,SAAS,GAAG,GAAK,EAAQ,OAAS,EAAU,EAC9E,EAAQ,MAAM,EAAG,EAAE,CAAC,CAAC,WAAW,MAAO,GAAG,CAAC,CAAC,WAAW,OAAQ,IAAI,CAC5E,CAEA,SAAgB,EAAoB,EAA2D,CAC7F,IAAM,EAAO,EAAO,KAAK,SAAS;CAAI,EAAI,EAAO,KAAO,GAAG,EAAO,KAAK,IACjE,EAAc,EAAO,YAAY,KAAK,EAE5C,OADK,EACE,CAAC,MAAmB,gBAAgB,EAAiB,CAAW,IAAK,MAAmB,CAAI,CAAC,CAAC,KAAK;CAAI,EADrF,CAE3B,CASA,SAAgB,EAAoB,EAAc,EAA8B,CAC9E,IAAM,EAAa,EAAQ,WAAW;EAAQ;CAAI,EAClD,GAAI,CAAC,EAAW,WAAW;CAAwB,EACjD,MAAO,CAAE,OAAM,YAAa,EAAe,CAAU,EAAG,KAAM,EAAW,KAAK,CAAE,EAGlF,IAAM,EAAU,EAAW,QAAQ;;EAA4B,CAAwB,EACvF,GAAI,IAAY,GACd,MAAO,CAAE,OAAM,YAAa,EAAe,CAAU,EAAG,KAAM,EAAW,KAAK,CAAE,EAGlF,IAAM,EAAc,EAAW,MAAM,EAA8B,CAAO,EACpE,EAAO,EAAW,MAAM,EAAU,EAA2B,CAAC,CAAC,CAAC,KAAK,EACrE,EAAkB,EAAY,MAAM;CAAI,CAAC,CAAC,KAAM,GAAS,EAAK,UAAU,CAAC,CAAC,WAAW,cAAe,CAAC,EAK3G,MAAO,CAAE,OAAM,YAJK,EAChB,EAAmB,EAAgB,UAAU,CAAC,CAAC,MAAM,EAAsB,CAAC,EAC5E,EAAe,CAAI,EAEK,KAAM,CAAK,CACzC"}

package/dist/types/prompt.d.cts

@@ -0,0 +1,54 @@
+//#region src/types/prompt.d.ts
+/**
+ * Ports and domain contracts for the prompt library.
+ *
+ * DESIGN PATTERNS:
+ * - The store port is named in this package's vocabulary; the filesystem
+ *   implementation lives in src/adapters/node and imports the port from here.
+ * - Staged prompts are session-scoped and never reach a port: the ring is pure
+ *   in-memory state, so nothing here describes persistence for them.
+ *
+ * AVOID:
+ * - Declaring a port beside its implementation, which would force services to
+ *   depend on the filesystem.
+ */
+/** A prompt saved as a Pi prompt template on disk. */
+interface SavedPrompt {
+  /** Template name without the `.md` suffix, which is also its slash command. */
+  name: string;
+  /** Frontmatter description, empty when the document declares none. */
+  description: string;
+  /** Prompt body, verbatim. */
+  text: string;
+}
+/** Where a saved prompt landed, so a command can tell the user. */
+interface SavedPromptWrite {
+  name: string;
+  path: string;
+}
+/** Reads and writes the Pi prompt templates this package owns. */
+interface SavedPromptStore {
+  /** Every readable template in the prompts directory, sorted by name. */
+  list(): Promise<readonly SavedPrompt[]>;
+  /** Whether a template file already exists under that name. */
+  has(name: string): Promise<boolean>;
+  /** Writes the template, replacing any existing file with the same name. */
+  save(prompt: SavedPrompt): Promise<SavedPromptWrite>;
+  /** Deletes the template, answering false when there was none to delete. */
+  remove(name: string): Promise<boolean>;
+}
+/** The session-scoped ring of prompts the user submitted. */
+interface RecentPrompts {
+  /** Records a submitted prompt as the newest entry. */
+  push(text: string): void;
+  /** Staged prompts, newest first. */
+  list(): readonly string[];
+}
+/** Everything the extension needs, constructed in src/container. */
+interface PromptExtensionDependencies {
+  store: SavedPromptStore;
+  recent: RecentPrompts;
+}
+//#endregion
+export { PromptExtensionDependencies, RecentPrompts, SavedPrompt, SavedPromptStore, SavedPromptWrite };
+//# sourceMappingURL=prompt.d.cts.map

package/dist/types/prompt.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.cts","names":[],"sources":["../../src/types/prompt.ts"],"mappings":";;;;;;;;;;;;;;;UAeiB;;EAEf;;EAEA;;EAEA;;;UAIe;EACf;EACA;;;UAIe;;EAEf,QAAQ,iBAAiB;;EAEzB,IAAI,eAAe;;EAEnB,KAAK,QAAQ,cAAc,QAAQ;;EAEnC,OAAO,eAAe;;;UAIP;;EAEf,KAAK;;EAEL;;;UAIe;EACf,OAAO;EACP,QAAQ"}

package/dist/types/prompt.d.mts

@@ -0,0 +1,54 @@
+//#region src/types/prompt.d.ts
+/**
+ * Ports and domain contracts for the prompt library.
+ *
+ * DESIGN PATTERNS:
+ * - The store port is named in this package's vocabulary; the filesystem
+ *   implementation lives in src/adapters/node and imports the port from here.
+ * - Staged prompts are session-scoped and never reach a port: the ring is pure
+ *   in-memory state, so nothing here describes persistence for them.
+ *
+ * AVOID:
+ * - Declaring a port beside its implementation, which would force services to
+ *   depend on the filesystem.
+ */
+/** A prompt saved as a Pi prompt template on disk. */
+interface SavedPrompt {
+  /** Template name without the `.md` suffix, which is also its slash command. */
+  name: string;
+  /** Frontmatter description, empty when the document declares none. */
+  description: string;
+  /** Prompt body, verbatim. */
+  text: string;
+}
+/** Where a saved prompt landed, so a command can tell the user. */
+interface SavedPromptWrite {
+  name: string;
+  path: string;
+}
+/** Reads and writes the Pi prompt templates this package owns. */
+interface SavedPromptStore {
+  /** Every readable template in the prompts directory, sorted by name. */
+  list(): Promise<readonly SavedPrompt[]>;
+  /** Whether a template file already exists under that name. */
+  has(name: string): Promise<boolean>;
+  /** Writes the template, replacing any existing file with the same name. */
+  save(prompt: SavedPrompt): Promise<SavedPromptWrite>;
+  /** Deletes the template, answering false when there was none to delete. */
+  remove(name: string): Promise<boolean>;
+}
+/** The session-scoped ring of prompts the user submitted. */
+interface RecentPrompts {
+  /** Records a submitted prompt as the newest entry. */
+  push(text: string): void;
+  /** Staged prompts, newest first. */
+  list(): readonly string[];
+}
+/** Everything the extension needs, constructed in src/container. */
+interface PromptExtensionDependencies {
+  store: SavedPromptStore;
+  recent: RecentPrompts;
+}
+//#endregion
+export { PromptExtensionDependencies, RecentPrompts, SavedPrompt, SavedPromptStore, SavedPromptWrite };
+//# sourceMappingURL=prompt.d.mts.map

package/dist/types/prompt.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.mts","names":[],"sources":["../../src/types/prompt.ts"],"mappings":";;;;;;;;;;;;;;;UAeiB;;EAEf;;EAEA;;EAEA;;;UAIe;EACf;EACA;;;UAIe;;EAEf,QAAQ,iBAAiB;;EAEzB,IAAI,eAAe;;EAEnB,KAAK,QAAQ,cAAc,QAAQ;;EAEnC,OAAO,eAAe;;;UAIP;;EAEf,KAAK;;EAEL;;;UAIe;EACf,OAAO;EACP,QAAQ"}

package/dist/types/webPrompts.cjs

@@ -0,0 +1,2 @@
+exports.API_BASE_PATH=`prompts`,exports.PROMPTS_PATH=`/prompts`;
+//# sourceMappingURL=webPrompts.cjs.map

package/dist/types/webPrompts.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"webPrompts.cjs","names":[],"sources":["../../src/types/webPrompts.ts"],"sourcesContent":["/**\n * The vocabulary this package's HTTP API and its cockpit plugin share.\n *\n * DESIGN PATTERNS:\n * - Wire JSON only, no node types, so the browser bundle can carry this module.\n * - Route paths and URL building live here, so a page never assembles a URL of\n *   its own and the two halves cannot drift.\n * - Saved prompts are machine-wide, so no route names a session.\n *\n * AVOID:\n * - Importing anything from src/services or src/adapters here.\n */\n\n/** Where a host mounts this package's API; the segment after /api/plugin/. */\nexport const API_BASE_PATH = 'prompts';\n\n/** The collection, relative to the API's own mount. */\nexport const PROMPTS_PATH = '/prompts';\n\n/** One saved prompt, relative to the API's own mount. */\nexport function promptPath(name: string): string {\n  return `${PROMPTS_PATH}/${encodeURIComponent(name)}`;\n}\n\n/** The absolute URL a page fetches for the collection. */\nexport function promptsUrl(): string {\n  return `/api/plugin/${API_BASE_PATH}${PROMPTS_PATH}`;\n}\n\n/** The absolute URL a page fetches for one saved prompt. */\nexport function promptUrl(name: string): string {\n  return `/api/plugin/${API_BASE_PATH}${promptPath(name)}`;\n}\n\n/** One saved prompt, as the cockpit shows it. */\nexport interface SavedPromptView {\n  name: string;\n  description: string;\n  text: string;\n}\n\n/** What the collection route answers with. */\nexport interface SavedPromptListResponse {\n  prompts: readonly SavedPromptView[];\n}\n\n/** What a write route answers with. */\nexport interface SavedPromptWriteResponse {\n  prompt: SavedPromptView;\n  /** True when the write replaced a template that already existed. */\n  replaced: boolean;\n}\n\n/** What every route answers with when it refuses. */\nexport interface PromptErrorResponse {\n  error: string;\n}\n\nexport function isPromptErrorResponse(value: unknown): value is PromptErrorResponse {\n  return typeof value === 'object' && value !== null && typeof (value as PromptErrorResponse).error === 'string';\n}\n"],"mappings":""}

package/dist/types/webPrompts.mjs

@@ -0,0 +1,2 @@
+const e=`prompts`,t=`/prompts`;export{e as API_BASE_PATH,t as PROMPTS_PATH};
+//# sourceMappingURL=webPrompts.mjs.map

package/dist/types/webPrompts.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"webPrompts.mjs","names":[],"sources":["../../src/types/webPrompts.ts"],"sourcesContent":["/**\n * The vocabulary this package's HTTP API and its cockpit plugin share.\n *\n * DESIGN PATTERNS:\n * - Wire JSON only, no node types, so the browser bundle can carry this module.\n * - Route paths and URL building live here, so a page never assembles a URL of\n *   its own and the two halves cannot drift.\n * - Saved prompts are machine-wide, so no route names a session.\n *\n * AVOID:\n * - Importing anything from src/services or src/adapters here.\n */\n\n/** Where a host mounts this package's API; the segment after /api/plugin/. */\nexport const API_BASE_PATH = 'prompts';\n\n/** The collection, relative to the API's own mount. */\nexport const PROMPTS_PATH = '/prompts';\n\n/** One saved prompt, relative to the API's own mount. */\nexport function promptPath(name: string): string {\n  return `${PROMPTS_PATH}/${encodeURIComponent(name)}`;\n}\n\n/** The absolute URL a page fetches for the collection. */\nexport function promptsUrl(): string {\n  return `/api/plugin/${API_BASE_PATH}${PROMPTS_PATH}`;\n}\n\n/** The absolute URL a page fetches for one saved prompt. */\nexport function promptUrl(name: string): string {\n  return `/api/plugin/${API_BASE_PATH}${promptPath(name)}`;\n}\n\n/** One saved prompt, as the cockpit shows it. */\nexport interface SavedPromptView {\n  name: string;\n  description: string;\n  text: string;\n}\n\n/** What the collection route answers with. */\nexport interface SavedPromptListResponse {\n  prompts: readonly SavedPromptView[];\n}\n\n/** What a write route answers with. */\nexport interface SavedPromptWriteResponse {\n  prompt: SavedPromptView;\n  /** True when the write replaced a template that already existed. */\n  replaced: boolean;\n}\n\n/** What every route answers with when it refuses. */\nexport interface PromptErrorResponse {\n  error: string;\n}\n\nexport function isPromptErrorResponse(value: unknown): value is PromptErrorResponse {\n  return typeof value === 'object' && value !== null && typeof (value as PromptErrorResponse).error === 'string';\n}\n"],"mappings":"AAcA,MAAa,EAAgB,UAGhB,EAAe"}

package/llms.txt

@@ -0,0 +1,11 @@
+# @agimon-ai/doompi-prompt
+
+Package-owned guidance for Staged recent prompts and saved prompt templates for DoomPi
+
+## How to use
+
+- [Use Prompt](./src/prompts/doompi-use-prompt/SKILL.md): Run the package command and follow its package-specific usage guidance.
+
+## Resources
+
+- [Package README](./README.md): Installation, development commands, Pi entrypoint, and extension-specific usage.

package/package.json

@@ -0,0 +1,124 @@
+{
+  "name": "@agimon-ai/doompi-prompt",
+  "version": "0.0.1-alpha.0",
+  "description": "Staged recent prompts and saved prompt templates for DoomPi",
+  "keywords": [
+    "ai",
+    "coding-agent",
+    "developer-tools",
+    "doompi",
+    "pi-coding-agent",
+    "pi-extension",
+    "pi-package",
+    "prompt-library",
+    "typescript"
+  ],
+  "homepage": "https://agimon.ai",
+  "bugs": {
+    "url": "https://github.com/AgiFlow/doompi/issues"
+  },
+  "license": "MIT",
+  "author": "Vuong Ngo",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AgiFlow/doompi.git",
+    "directory": "packages/default/doompi-prompt"
+  },
+  "files": [
+    "dist",
+    "src/web",
+    "src/exports/webClient.ts",
+    "src/types/webPrompts.ts",
+    "src/prompts",
+    "llms.txt",
+    "README.md",
+    "LICENSE",
+    "package.json"
+  ],
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "types": "./dist/index.d.mts",
+  "jsnext:main": "./dist/index.mjs",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    },
+    "./extensions/pi": {
+      "types": "./dist/extensions/pi.d.mts",
+      "import": "./dist/extensions/pi.mjs",
+      "require": "./dist/extensions/pi.cjs"
+    },
+    "./hub-api": {
+      "types": "./dist/hubApi.d.mts",
+      "import": "./dist/hubApi.mjs",
+      "require": "./dist/hubApi.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@deepseek-ai/cordis": "4.0.1",
+    "hono": "4.13.5",
+    "@agimon-ai/doompi-ui": "0.0.1-alpha.50",
+    "@agimon-ai/doompi-web-components": "0.0.1-alpha.10",
+    "@agimon-ai/doompi-extension-contracts": "0.0.1-alpha.49",
+    "@agimon-ai/doompi-web-contracts": "0.0.1-alpha.13",
+    "@agimon-ai/doompi-web-security": "0.0.1-alpha.11"
+  },
+  "devDependencies": {
+    "@earendil-works/pi-coding-agent": "0.84.4",
+    "@earendil-works/pi-tui": "0.84.4",
+    "@types/node": "26.2.0",
+    "@types/react": "19.2.18",
+    "@types/react-dom": "19.2.3",
+    "@vitest/coverage-v8": "4.1.11",
+    "react": "19.2.8",
+    "react-dom": "19.2.8",
+    "tsdown": "0.22.14",
+    "typescript": "7.0.2",
+    "vitest": "4.1.11",
+    "@agimon-ai/vibe-lint-plugin-doom-extension": "0.0.1-alpha.47"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "0.84.4",
+    "@earendil-works/pi-tui": "0.84.4"
+  },
+  "peerDependenciesMeta": {
+    "@earendil-works/pi-coding-agent": {
+      "optional": true
+    },
+    "@earendil-works/pi-tui": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "doompiApi": {
+    "basePath": "prompts",
+    "hub": {
+      "entry": "./src/exports/hubApi.ts",
+      "dist": "./dist/hubApi.mjs"
+    }
+  },
+  "doompiWeb": {
+    "pluginId": "prompts",
+    "client": "./src/exports/webClient.ts"
+  },
+  "pi": {
+    "extensions": [
+      "./dist/extensions/pi.mjs"
+    ]
+  },
+  "scripts": {
+    "build": "tsdown",
+    "test": "vitest --run",
+    "typecheck": "tsc --noEmit && tsc --noEmit -p src/web/tsconfig.json",
+    "lint": "oxlint . && oxfmt . --check",
+    "fixcode": "oxlint . --fix && oxfmt ."
+  }
+}

package/src/exports/webClient.ts

@@ -0,0 +1,2 @@
+// @scaffold-generated
+export { webPlugin } from '../web/index.ts';

package/src/prompts/doompi-use-prompt/SKILL.md

@@ -0,0 +1,17 @@
+---
+name: doompi-use-prompt
+description: 'Use @agimon-ai/doompi-prompt: Staged recent prompts and saved prompt templates for DoomPi'
+---
+
+# Use Prompt
+
+Read the package [README](../../../README.md) for its exact installation, command, configuration, and behavior.
+
+## Guidance
+
+- `/prompts`, or `SPC e p`, opens a filterable picker over the last three prompts of this session and every saved prompt, then stages the chosen one in the editor rather than sending it.
+- `/prompt-save <name>` saves the current draft, or the newest staged prompt when the draft is empty, as `~/.pi/agent/prompts/<name>.md`. Names are lowercase letters, digits and dashes.
+- A saved prompt is an ordinary Pi prompt template, so it is also `/<name>` from the next start, with `$1` and `$@` argument substitution. Text containing those tokens is substituted on invocation; the save command says so when it sees them.
+- Staged prompts live in memory for the session only. Nothing reaches disk until the user saves a prompt explicitly.
+- Arrow up and down are Pi's own in-session history and are not modified by this package.
+- Do not require DoomPi Help for runtime activation. Help only makes this package guidance discoverable while the minor mode is active.