@ashx-j/lunr 0.1.0

package/dist/core/process-registry.js

@@ -0,0 +1,190 @@
+/**
+ * lunR: session-scoped process tracking — in-memory registry of detached child
+ * processes started via the bash tool.
+ *
+ * Tracks running processes so the user can see them (/processes), kill them,
+ * and is prompted at quit time. Processes are tagged with the owning session id
+ * so concurrent gateway chats do not share process visibility.
+ *
+ * pause/resume are Unix-only (SIGSTOP/SIGCONT); they throw on win32.
+ * restart re-spawns the recorded command detached and registers the new pid.
+ */
+import { spawn } from "node:child_process";
+import { getShellConfig, killProcessTree } from "../utils/shell.js";
+const isWin32 = process.platform === "win32";
+/** Only retain exited processes that ran longer than this (ms). */
+const EXIT_NOISE_GATE_MS = 3000;
+/** Evict exited entries after this TTL (ms). */
+const EXIT_TTL_MS = 5 * 60 * 1000;
+/** Hard cap on tracked entries to prevent unbounded growth. */
+const MAX_TRACKED = 100;
+const processes = new Map();
+export function register(pid, command, cwd, sessionId) {
+    if (!pid)
+        return;
+    // Evict the oldest non-busy entry when over cap. Exited entries are preferred
+    // for eviction; if none, evict the oldest running entry.
+    if (processes.size >= MAX_TRACKED) {
+        let oldest;
+        for (const [p, entry] of processes) {
+            if (entry.status === "exited") {
+                oldest = { pid: p, entry };
+                break;
+            }
+            if (!oldest || entry.startedAt < oldest.entry.startedAt) {
+                oldest = { pid: p, entry };
+            }
+        }
+        if (oldest)
+            processes.delete(oldest.pid);
+    }
+    processes.set(pid, { pid, command, cwd, startedAt: Date.now(), status: "running", sessionId });
+}
+export function unregister(pid) {
+    if (!pid)
+        return;
+    processes.delete(pid);
+}
+/**
+ * Mark a tracked process as exited. Short-lived processes (< 3s) are deleted
+ * immediately to avoid noise; longer ones are retained as "exited" for 5 minutes.
+ */
+export function markExited(pid, exitCode) {
+    if (!pid)
+        return;
+    const entry = processes.get(pid);
+    if (!entry)
+        return;
+    const livedMs = Date.now() - entry.startedAt;
+    if (livedMs < EXIT_NOISE_GATE_MS) {
+        processes.delete(pid);
+        return;
+    }
+    entry.status = "exited";
+    entry.exitCode = exitCode ?? undefined;
+    entry.exitedAt = Date.now();
+}
+/** Returns the list, pruning dead entries via a liveness probe. */
+export function list(sessionId) {
+    prune();
+    return [...processes.values()].filter((p) => sessionId === undefined || p.sessionId === sessionId);
+}
+function prune() {
+    for (const [pid, entry] of processes) {
+        if (entry.status === "exited") {
+            if (!entry.exitedAt || Date.now() - entry.exitedAt > EXIT_TTL_MS) {
+                processes.delete(pid);
+            }
+            continue;
+        }
+        if (!isAlive(pid)) {
+            // A running/paused process that died unexpectedly becomes exited so
+            // the user can see it, then the TTL evicts it.
+            markExited(pid, null);
+        }
+    }
+}
+function isAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function kill(pid) {
+    if (!processes.has(pid))
+        return;
+    killProcessTree(pid);
+    processes.delete(pid);
+}
+export function killAll(sessionId) {
+    for (const [pid, entry] of processes) {
+        if (sessionId !== undefined && entry.sessionId !== sessionId)
+            continue;
+        try {
+            killProcessTree(pid);
+        }
+        catch {
+            // ignore
+        }
+        processes.delete(pid);
+    }
+}
+export function pause(pid) {
+    if (isWin32)
+        throw new Error("Pause/resume is unsupported on Windows.");
+    if (!processes.has(pid))
+        throw new Error(`Process ${pid} is not tracked.`);
+    try {
+        process.kill(pid, "SIGSTOP");
+        const entry = processes.get(pid);
+        if (entry)
+            entry.status = "paused";
+    }
+    catch {
+        // process may have died
+        processes.delete(pid);
+    }
+}
+export function resume(pid) {
+    if (isWin32)
+        throw new Error("Pause/resume is unsupported on Windows.");
+    if (!processes.has(pid))
+        throw new Error(`Process ${pid} is not tracked.`);
+    try {
+        process.kill(pid, "SIGCONT");
+        const entry = processes.get(pid);
+        if (entry)
+            entry.status = "running";
+    }
+    catch {
+        processes.delete(pid);
+    }
+}
+export function restart(pid) {
+    const entry = processes.get(pid);
+    if (!entry)
+        return undefined;
+    try {
+        killProcessTree(pid);
+    }
+    catch {
+        // ignore
+    }
+    processes.delete(pid);
+    try {
+        const shellConfig = getShellConfig();
+        const child = spawn(shellConfig.shell, [...shellConfig.args, entry.command], {
+            cwd: entry.cwd,
+            detached: true,
+            stdio: "ignore",
+            windowsHide: true,
+        });
+        if (child.pid) {
+            register(child.pid, entry.command, entry.cwd, entry.sessionId);
+            child.unref();
+            return child.pid;
+        }
+    }
+    catch {
+        // re-spawn failed
+    }
+    return undefined;
+}
+export function isWindows() {
+    return isWin32;
+}
+/** Clear the registry (called on session replace). Pass sessionId to clear only one session's entries. */
+export function clearRegistry(sessionId) {
+    if (sessionId === undefined) {
+        processes.clear();
+        return;
+    }
+    for (const [pid, entry] of processes) {
+        if (entry.sessionId === sessionId)
+            processes.delete(pid);
+    }
+}
+//# sourceMappingURL=process-registry.js.map

package/dist/core/process-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-registry.js","sourceRoot":"","sources":["../../src/core/process-registry.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * lunR: session-scoped process tracking — in-memory registry of detached child\n * processes started via the bash tool.\n *\n * Tracks running processes so the user can see them (/processes), kill them,\n * and is prompted at quit time. Processes are tagged with the owning session id\n * so concurrent gateway chats do not share process visibility.\n *\n * pause/resume are Unix-only (SIGSTOP/SIGCONT); they throw on win32.\n * restart re-spawns the recorded command detached and registers the new pid.\n */\n\nimport { spawn } from \"node:child_process\";\nimport { getShellConfig, killProcessTree } from \"../utils/shell.ts\";\n\nexport interface TrackedProcess {\n\tpid: number;\n\tcommand: string;\n\tcwd: string;\n\tstartedAt: number;\n\tstatus: \"running\" | \"paused\" | \"exited\";\n\texitCode?: number;\n\texitedAt?: number;\n\t/** Owning session id (gateway chats use this for isolation). */\n\tsessionId?: string;\n}\n\nconst isWin32 = process.platform === \"win32\";\n\n/** Only retain exited processes that ran longer than this (ms). */\nconst EXIT_NOISE_GATE_MS = 3000;\n/** Evict exited entries after this TTL (ms). */\nconst EXIT_TTL_MS = 5 * 60 * 1000;\n/** Hard cap on tracked entries to prevent unbounded growth. */\nconst MAX_TRACKED = 100;\n\nconst processes = new Map<number, TrackedProcess>();\n\nexport function register(pid: number, command: string, cwd: string, sessionId?: string): void {\n\tif (!pid) return;\n\t// Evict the oldest non-busy entry when over cap. Exited entries are preferred\n\t// for eviction; if none, evict the oldest running entry.\n\tif (processes.size >= MAX_TRACKED) {\n\t\tlet oldest: { pid: number; entry: TrackedProcess } | undefined;\n\t\tfor (const [p, entry] of processes) {\n\t\t\tif (entry.status === \"exited\") {\n\t\t\t\toldest = { pid: p, entry };\n\t\t\t\tbreak;\n\t\t\t}\n\t\t\tif (!oldest || entry.startedAt < oldest.entry.startedAt) {\n\t\t\t\toldest = { pid: p, entry };\n\t\t\t}\n\t\t}\n\t\tif (oldest) processes.delete(oldest.pid);\n\t}\n\tprocesses.set(pid, { pid, command, cwd, startedAt: Date.now(), status: \"running\", sessionId });\n}\n\nexport function unregister(pid: number): void {\n\tif (!pid) return;\n\tprocesses.delete(pid);\n}\n\n/**\n * Mark a tracked process as exited. Short-lived processes (< 3s) are deleted\n * immediately to avoid noise; longer ones are retained as \"exited\" for 5 minutes.\n */\nexport function markExited(pid: number, exitCode: number | null): void {\n\tif (!pid) return;\n\tconst entry = processes.get(pid);\n\tif (!entry) return;\n\tconst livedMs = Date.now() - entry.startedAt;\n\tif (livedMs < EXIT_NOISE_GATE_MS) {\n\t\tprocesses.delete(pid);\n\t\treturn;\n\t}\n\tentry.status = \"exited\";\n\tentry.exitCode = exitCode ?? undefined;\n\tentry.exitedAt = Date.now();\n}\n\n/** Returns the list, pruning dead entries via a liveness probe. */\nexport function list(sessionId?: string): TrackedProcess[] {\n\tprune();\n\treturn [...processes.values()].filter((p) => sessionId === undefined || p.sessionId === sessionId);\n}\n\nfunction prune(): void {\n\tfor (const [pid, entry] of processes) {\n\t\tif (entry.status === \"exited\") {\n\t\t\tif (!entry.exitedAt || Date.now() - entry.exitedAt > EXIT_TTL_MS) {\n\t\t\t\tprocesses.delete(pid);\n\t\t\t}\n\t\t\tcontinue;\n\t\t}\n\t\tif (!isAlive(pid)) {\n\t\t\t// A running/paused process that died unexpectedly becomes exited so\n\t\t\t// the user can see it, then the TTL evicts it.\n\t\t\tmarkExited(pid, null);\n\t\t}\n\t}\n}\n\nfunction isAlive(pid: number): boolean {\n\ttry {\n\t\tprocess.kill(pid, 0);\n\t\treturn true;\n\t} catch {\n\t\treturn false;\n\t}\n}\n\nexport function kill(pid: number): void {\n\tif (!processes.has(pid)) return;\n\tkillProcessTree(pid);\n\tprocesses.delete(pid);\n}\n\nexport function killAll(sessionId?: string): void {\n\tfor (const [pid, entry] of processes) {\n\t\tif (sessionId !== undefined && entry.sessionId !== sessionId) continue;\n\t\ttry {\n\t\t\tkillProcessTree(pid);\n\t\t} catch {\n\t\t\t// ignore\n\t\t}\n\t\tprocesses.delete(pid);\n\t}\n}\n\nexport function pause(pid: number): void {\n\tif (isWin32) throw new Error(\"Pause/resume is unsupported on Windows.\");\n\tif (!processes.has(pid)) throw new Error(`Process ${pid} is not tracked.`);\n\ttry {\n\t\tprocess.kill(pid, \"SIGSTOP\");\n\t\tconst entry = processes.get(pid);\n\t\tif (entry) entry.status = \"paused\";\n\t} catch {\n\t\t// process may have died\n\t\tprocesses.delete(pid);\n\t}\n}\n\nexport function resume(pid: number): void {\n\tif (isWin32) throw new Error(\"Pause/resume is unsupported on Windows.\");\n\tif (!processes.has(pid)) throw new Error(`Process ${pid} is not tracked.`);\n\ttry {\n\t\tprocess.kill(pid, \"SIGCONT\");\n\t\tconst entry = processes.get(pid);\n\t\tif (entry) entry.status = \"running\";\n\t} catch {\n\t\tprocesses.delete(pid);\n\t}\n}\n\nexport function restart(pid: number): number | undefined {\n\tconst entry = processes.get(pid);\n\tif (!entry) return undefined;\n\ttry {\n\t\tkillProcessTree(pid);\n\t} catch {\n\t\t// ignore\n\t}\n\tprocesses.delete(pid);\n\n\ttry {\n\t\tconst shellConfig = getShellConfig();\n\t\tconst child = spawn(shellConfig.shell, [...shellConfig.args, entry.command], {\n\t\t\tcwd: entry.cwd,\n\t\t\tdetached: true,\n\t\t\tstdio: \"ignore\",\n\t\t\twindowsHide: true,\n\t\t});\n\t\tif (child.pid) {\n\t\t\tregister(child.pid, entry.command, entry.cwd, entry.sessionId);\n\t\t\tchild.unref();\n\t\t\treturn child.pid;\n\t\t}\n\t} catch {\n\t\t// re-spawn failed\n\t}\n\treturn undefined;\n}\n\nexport function isWindows(): boolean {\n\treturn isWin32;\n}\n\n/** Clear the registry (called on session replace). Pass sessionId to clear only one session's entries. */\nexport function clearRegistry(sessionId?: string): void {\n\tif (sessionId === undefined) {\n\t\tprocesses.clear();\n\t\treturn;\n\t}\n\tfor (const [pid, entry] of processes) {\n\t\tif (entry.sessionId === sessionId) processes.delete(pid);\n\t}\n}\n"]}

package/dist/core/project-trust.d.ts

@@ -0,0 +1,15 @@
+import type { LoadExtensionsResult, ProjectTrustContext } from "./extensions/types.ts";
+import type { DefaultProjectTrust } from "./settings-manager.ts";
+import { type ProjectTrustStore } from "./trust-manager.ts";
+export type AppMode = "interactive" | "print" | "json" | "rpc";
+export interface ResolveProjectTrustedOptions {
+    cwd: string;
+    trustStore: ProjectTrustStore;
+    trustOverride?: boolean;
+    defaultProjectTrust?: DefaultProjectTrust;
+    extensionsResult?: LoadExtensionsResult;
+    projectTrustContext: ProjectTrustContext;
+    onExtensionError?: (message: string) => void;
+}
+export declare function resolveProjectTrusted(options: ResolveProjectTrustedOptions): Promise<boolean>;
+//# sourceMappingURL=project-trust.d.ts.map

package/dist/core/project-trust.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-trust.d.ts","sourceRoot":"","sources":["../../src/core/project-trust.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACvF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAIN,KAAK,iBAAiB,EACtB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,MAAM,OAAO,GAAG,aAAa,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC;AAE/D,MAAM,WAAW,4BAA4B;IAC5C,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,iBAAiB,CAAC;IAC9B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAC1C,gBAAgB,CAAC,EAAE,oBAAoB,CAAC;IACxC,mBAAmB,EAAE,mBAAmB,CAAC;IACzC,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7C;AAwBD,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,4BAA4B,GAAG,OAAO,CAAC,OAAO,CAAC,CAkDnG","sourcesContent":["import { APP_NAME, CONFIG_DIR_NAME } from \"../config.ts\";\nimport { emitProjectTrustEvent } from \"./extensions/runner.ts\";\nimport type { LoadExtensionsResult, ProjectTrustContext } from \"./extensions/types.ts\";\nimport type { DefaultProjectTrust } from \"./settings-manager.ts\";\nimport {\n\tgetProjectTrustOptions,\n\thasTrustRequiringProjectResources,\n\ttype ProjectTrustOption,\n\ttype ProjectTrustStore,\n} from \"./trust-manager.ts\";\n\nexport type AppMode = \"interactive\" | \"print\" | \"json\" | \"rpc\";\n\nexport interface ResolveProjectTrustedOptions {\n\tcwd: string;\n\ttrustStore: ProjectTrustStore;\n\ttrustOverride?: boolean;\n\tdefaultProjectTrust?: DefaultProjectTrust;\n\textensionsResult?: LoadExtensionsResult;\n\tprojectTrustContext: ProjectTrustContext;\n\tonExtensionError?: (message: string) => void;\n}\n\nfunction formatProjectTrustPrompt(cwd: string): string {\n\treturn `Trust project folder?\\n${cwd}\\n\\nThis allows ${APP_NAME} to load ${CONFIG_DIR_NAME} settings and resources, install missing project packages, and execute project extensions.`;\n}\n\nasync function selectProjectTrustOption(\n\tcwd: string,\n\tctx: ProjectTrustContext,\n): Promise<ProjectTrustOption | undefined> {\n\tconst options = getProjectTrustOptions(cwd, { includeSessionOnly: true });\n\tconst selected = await ctx.ui.select(\n\t\tformatProjectTrustPrompt(cwd),\n\t\toptions.map((option) => option.label),\n\t);\n\treturn options.find((option) => option.label === selected);\n}\n\nfunction saveProjectTrustPromptResult(trustStore: ProjectTrustStore, result: ProjectTrustOption): void {\n\tif (result.updates.length > 0) {\n\t\ttrustStore.setMany(result.updates);\n\t}\n}\n\nexport async function resolveProjectTrusted(options: ResolveProjectTrustedOptions): Promise<boolean> {\n\tif (options.trustOverride !== undefined) {\n\t\treturn options.trustOverride;\n\t}\n\tif (!hasTrustRequiringProjectResources(options.cwd)) {\n\t\treturn true;\n\t}\n\n\tif (options.extensionsResult) {\n\t\tconst { result, errors } = await emitProjectTrustEvent(\n\t\t\toptions.extensionsResult,\n\t\t\t{ type: \"project_trust\", cwd: options.cwd },\n\t\t\toptions.projectTrustContext,\n\t\t);\n\t\tfor (const error of errors) {\n\t\t\toptions.onExtensionError?.(`Extension \"${error.extensionPath}\" project_trust error: ${error.error}`);\n\t\t}\n\t\tif (result) {\n\t\t\tconst trusted = result.trusted === \"yes\";\n\t\t\tif (result.remember === true) {\n\t\t\t\toptions.trustStore.set(options.cwd, trusted);\n\t\t\t}\n\t\t\treturn trusted;\n\t\t}\n\t}\n\n\tconst decision = options.trustStore.get(options.cwd);\n\tif (decision !== null) {\n\t\treturn decision;\n\t}\n\n\tswitch (options.defaultProjectTrust ?? \"ask\") {\n\t\tcase \"always\":\n\t\t\treturn true;\n\t\tcase \"never\":\n\t\t\treturn false;\n\t\tcase \"ask\":\n\t\t\tbreak;\n\t}\n\n\tif (!options.projectTrustContext.hasUI) {\n\t\treturn false;\n\t}\n\n\tconst selected = await selectProjectTrustOption(options.cwd, options.projectTrustContext);\n\tif (selected !== undefined) {\n\t\tsaveProjectTrustPromptResult(options.trustStore, selected);\n\t\treturn selected.trusted;\n\t}\n\treturn false;\n}\n"]}

package/dist/core/project-trust.js

@@ -0,0 +1,59 @@
+import { APP_NAME, CONFIG_DIR_NAME } from "../config.js";
+import { emitProjectTrustEvent } from "./extensions/runner.js";
+import { getProjectTrustOptions, hasTrustRequiringProjectResources, } from "./trust-manager.js";
+function formatProjectTrustPrompt(cwd) {
+    return `Trust project folder?\n${cwd}\n\nThis allows ${APP_NAME} to load ${CONFIG_DIR_NAME} settings and resources, install missing project packages, and execute project extensions.`;
+}
+async function selectProjectTrustOption(cwd, ctx) {
+    const options = getProjectTrustOptions(cwd, { includeSessionOnly: true });
+    const selected = await ctx.ui.select(formatProjectTrustPrompt(cwd), options.map((option) => option.label));
+    return options.find((option) => option.label === selected);
+}
+function saveProjectTrustPromptResult(trustStore, result) {
+    if (result.updates.length > 0) {
+        trustStore.setMany(result.updates);
+    }
+}
+export async function resolveProjectTrusted(options) {
+    if (options.trustOverride !== undefined) {
+        return options.trustOverride;
+    }
+    if (!hasTrustRequiringProjectResources(options.cwd)) {
+        return true;
+    }
+    if (options.extensionsResult) {
+        const { result, errors } = await emitProjectTrustEvent(options.extensionsResult, { type: "project_trust", cwd: options.cwd }, options.projectTrustContext);
+        for (const error of errors) {
+            options.onExtensionError?.(`Extension "${error.extensionPath}" project_trust error: ${error.error}`);
+        }
+        if (result) {
+            const trusted = result.trusted === "yes";
+            if (result.remember === true) {
+                options.trustStore.set(options.cwd, trusted);
+            }
+            return trusted;
+        }
+    }
+    const decision = options.trustStore.get(options.cwd);
+    if (decision !== null) {
+        return decision;
+    }
+    switch (options.defaultProjectTrust ?? "ask") {
+        case "always":
+            return true;
+        case "never":
+            return false;
+        case "ask":
+            break;
+    }
+    if (!options.projectTrustContext.hasUI) {
+        return false;
+    }
+    const selected = await selectProjectTrustOption(options.cwd, options.projectTrustContext);
+    if (selected !== undefined) {
+        saveProjectTrustPromptResult(options.trustStore, selected);
+        return selected.trusted;
+    }
+    return false;
+}
+//# sourceMappingURL=project-trust.js.map

package/dist/core/project-trust.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-trust.js","sourceRoot":"","sources":["../../src/core/project-trust.ts"],"names":[],"mappings":"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","sourcesContent":["import { APP_NAME, CONFIG_DIR_NAME } from \"../config.ts\";\nimport { emitProjectTrustEvent } from \"./extensions/runner.ts\";\nimport type { LoadExtensionsResult, ProjectTrustContext } from \"./extensions/types.ts\";\nimport type { DefaultProjectTrust } from \"./settings-manager.ts\";\nimport {\n\tgetProjectTrustOptions,\n\thasTrustRequiringProjectResources,\n\ttype ProjectTrustOption,\n\ttype ProjectTrustStore,\n} from \"./trust-manager.ts\";\n\nexport type AppMode = \"interactive\" | \"print\" | \"json\" | \"rpc\";\n\nexport interface ResolveProjectTrustedOptions {\n\tcwd: string;\n\ttrustStore: ProjectTrustStore;\n\ttrustOverride?: boolean;\n\tdefaultProjectTrust?: DefaultProjectTrust;\n\textensionsResult?: LoadExtensionsResult;\n\tprojectTrustContext: ProjectTrustContext;\n\tonExtensionError?: (message: string) => void;\n}\n\nfunction formatProjectTrustPrompt(cwd: string): string {\n\treturn `Trust project folder?\\n${cwd}\\n\\nThis allows ${APP_NAME} to load ${CONFIG_DIR_NAME} settings and resources, install missing project packages, and execute project extensions.`;\n}\n\nasync function selectProjectTrustOption(\n\tcwd: string,\n\tctx: ProjectTrustContext,\n): Promise<ProjectTrustOption | undefined> {\n\tconst options = getProjectTrustOptions(cwd, { includeSessionOnly: true });\n\tconst selected = await ctx.ui.select(\n\t\tformatProjectTrustPrompt(cwd),\n\t\toptions.map((option) => option.label),\n\t);\n\treturn options.find((option) => option.label === selected);\n}\n\nfunction saveProjectTrustPromptResult(trustStore: ProjectTrustStore, result: ProjectTrustOption): void {\n\tif (result.updates.length > 0) {\n\t\ttrustStore.setMany(result.updates);\n\t}\n}\n\nexport async function resolveProjectTrusted(options: ResolveProjectTrustedOptions): Promise<boolean> {\n\tif (options.trustOverride !== undefined) {\n\t\treturn options.trustOverride;\n\t}\n\tif (!hasTrustRequiringProjectResources(options.cwd)) {\n\t\treturn true;\n\t}\n\n\tif (options.extensionsResult) {\n\t\tconst { result, errors } = await emitProjectTrustEvent(\n\t\t\toptions.extensionsResult,\n\t\t\t{ type: \"project_trust\", cwd: options.cwd },\n\t\t\toptions.projectTrustContext,\n\t\t);\n\t\tfor (const error of errors) {\n\t\t\toptions.onExtensionError?.(`Extension \"${error.extensionPath}\" project_trust error: ${error.error}`);\n\t\t}\n\t\tif (result) {\n\t\t\tconst trusted = result.trusted === \"yes\";\n\t\t\tif (result.remember === true) {\n\t\t\t\toptions.trustStore.set(options.cwd, trusted);\n\t\t\t}\n\t\t\treturn trusted;\n\t\t}\n\t}\n\n\tconst decision = options.trustStore.get(options.cwd);\n\tif (decision !== null) {\n\t\treturn decision;\n\t}\n\n\tswitch (options.defaultProjectTrust ?? \"ask\") {\n\t\tcase \"always\":\n\t\t\treturn true;\n\t\tcase \"never\":\n\t\t\treturn false;\n\t\tcase \"ask\":\n\t\t\tbreak;\n\t}\n\n\tif (!options.projectTrustContext.hasUI) {\n\t\treturn false;\n\t}\n\n\tconst selected = await selectProjectTrustOption(options.cwd, options.projectTrustContext);\n\tif (selected !== undefined) {\n\t\tsaveProjectTrustPromptResult(options.trustStore, selected);\n\t\treturn selected.trusted;\n\t}\n\treturn false;\n}\n"]}

package/dist/core/prompt-templates.d.ts

@@ -0,0 +1,53 @@
+import { type SourceInfo } from "./source-info.ts";
+/**
+ * Represents a prompt template loaded from a markdown file
+ */
+export interface PromptTemplate {
+    name: string;
+    description: string;
+    argumentHint?: string;
+    content: string;
+    sourceInfo: SourceInfo;
+    filePath: string;
+}
+/**
+ * Parse command arguments respecting quoted strings (bash-style)
+ * Returns array of arguments
+ */
+export declare function parseCommandArgs(argsString: string): string[];
+/**
+ * Substitute argument placeholders in template content
+ * Supports:
+ * - $1, $2, ... for positional args
+ * - $@ and $ARGUMENTS for all args
+ * - ${N:-default} for positional arg N with default when missing/empty
+ * - ${@:N} for args from Nth onwards (bash-style slicing)
+ * - ${@:N:L} for L args starting from Nth
+ *
+ * Note: Replacement happens on the template string only. Argument and default values
+ * containing patterns like $1, $@, or $ARGUMENTS are NOT recursively substituted.
+ */
+export declare function substituteArgs(content: string, args: string[]): string;
+export interface LoadPromptTemplatesOptions {
+    /** Working directory for project-local templates. */
+    cwd: string;
+    /** Agent config directory for global templates. */
+    agentDir: string;
+    /** Explicit prompt template paths (files or directories). */
+    promptPaths: string[];
+    /** Include default prompt directories. */
+    includeDefaults: boolean;
+}
+/**
+ * Load all prompt templates from:
+ * 1. Global: agentDir/prompts/
+ * 2. Project: cwd/{CONFIG_DIR_NAME}/prompts/
+ * 3. Explicit prompt paths
+ */
+export declare function loadPromptTemplates(options: LoadPromptTemplatesOptions): PromptTemplate[];
+/**
+ * Expand a prompt template if it matches a template name.
+ * Returns the expanded content or the original text if not a template.
+ */
+export declare function expandPromptTemplate(text: string, templates: PromptTemplate[]): string;
+//# sourceMappingURL=prompt-templates.d.ts.map

package/dist/core/prompt-templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-templates.d.ts","sourceRoot":"","sources":["../../src/core/prompt-templates.ts"],"names":[],"mappings":"AAKA,OAAO,EAA6B,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9E;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,UAAU,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CA+B7D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAgCtE;AA2ED,MAAM,WAAW,0BAA0B;IAC1C,qDAAqD;IACrD,GAAG,EAAE,MAAM,CAAC;IACZ,mDAAmD;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,0CAA0C;IAC1C,eAAe,EAAE,OAAO,CAAC;CACzB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,0BAA0B,GAAG,cAAc,EAAE,CAqEzF;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,EAAE,GAAG,MAAM,CAgBtF","sourcesContent":["import { existsSync, readdirSync, readFileSync, statSync } from \"fs\";\nimport { basename, dirname, join, resolve, sep } from \"path\";\nimport { CONFIG_DIR_NAME } from \"../config.ts\";\nimport { parseFrontmatter } from \"../utils/frontmatter.ts\";\nimport { resolvePath } from \"../utils/paths.ts\";\nimport { createSyntheticSourceInfo, type SourceInfo } from \"./source-info.ts\";\n\n/**\n * Represents a prompt template loaded from a markdown file\n */\nexport interface PromptTemplate {\n\tname: string;\n\tdescription: string;\n\targumentHint?: string;\n\tcontent: string;\n\tsourceInfo: SourceInfo;\n\tfilePath: string; // Absolute path to the template file\n}\n\n/**\n * Parse command arguments respecting quoted strings (bash-style)\n * Returns array of arguments\n */\nexport function parseCommandArgs(argsString: string): string[] {\n\tconst args: string[] = [];\n\tlet current = \"\";\n\tlet inQuote: string | null = null;\n\n\tfor (let i = 0; i < argsString.length; i++) {\n\t\tconst char = argsString[i];\n\n\t\tif (inQuote) {\n\t\t\tif (char === inQuote) {\n\t\t\t\tinQuote = null;\n\t\t\t} else {\n\t\t\t\tcurrent += char;\n\t\t\t}\n\t\t} else if (char === '\"' || char === \"'\") {\n\t\t\tinQuote = char;\n\t\t} else if (/\\s/.test(char)) {\n\t\t\tif (current) {\n\t\t\t\targs.push(current);\n\t\t\t\tcurrent = \"\";\n\t\t\t}\n\t\t} else {\n\t\t\tcurrent += char;\n\t\t}\n\t}\n\n\tif (current) {\n\t\targs.push(current);\n\t}\n\n\treturn args;\n}\n\n/**\n * Substitute argument placeholders in template content\n * Supports:\n * - $1, $2, ... for positional args\n * - $@ and $ARGUMENTS for all args\n * - ${N:-default} for positional arg N with default when missing/empty\n * - ${@:N} for args from Nth onwards (bash-style slicing)\n * - ${@:N:L} for L args starting from Nth\n *\n * Note: Replacement happens on the template string only. Argument and default values\n * containing patterns like $1, $@, or $ARGUMENTS are NOT recursively substituted.\n */\nexport function substituteArgs(content: string, args: string[]): string {\n\tconst allArgs = args.join(\" \");\n\n\treturn content.replace(\n\t\t/\\$\\{(\\d+):-([^}]*)\\}|\\$\\{@:(\\d+)(?::(\\d+))?\\}|\\$(ARGUMENTS|@|\\d+)/g,\n\t\t(_match, defaultNum, defaultValue, sliceStart, sliceLength, simple) => {\n\t\t\tif (defaultNum) {\n\t\t\t\tconst index = parseInt(defaultNum, 10) - 1;\n\t\t\t\tconst value = args[index];\n\t\t\t\treturn value ? value : defaultValue;\n\t\t\t}\n\n\t\t\tif (sliceStart) {\n\t\t\t\tlet start = parseInt(sliceStart, 10) - 1; // Convert to 0-indexed (user provides 1-indexed)\n\t\t\t\t// Treat 0 as 1 (bash convention: args start at 1)\n\t\t\t\tif (start < 0) start = 0;\n\n\t\t\t\tif (sliceLength) {\n\t\t\t\t\tconst length = parseInt(sliceLength, 10);\n\t\t\t\t\treturn args.slice(start, start + length).join(\" \");\n\t\t\t\t}\n\t\t\t\treturn args.slice(start).join(\" \");\n\t\t\t}\n\n\t\t\tif (simple === \"ARGUMENTS\" || simple === \"@\") {\n\t\t\t\treturn allArgs;\n\t\t\t}\n\n\t\t\tconst index = parseInt(simple, 10) - 1;\n\t\t\treturn args[index] ?? \"\";\n\t\t},\n\t);\n}\n\nfunction loadTemplateFromFile(filePath: string, sourceInfo: SourceInfo): PromptTemplate | null {\n\ttry {\n\t\tconst rawContent = readFileSync(filePath, \"utf-8\");\n\t\tconst { frontmatter, body } = parseFrontmatter<Record<string, string>>(rawContent);\n\n\t\tconst name = basename(filePath).replace(/\\.md$/, \"\");\n\n\t\t// Get description from frontmatter or first non-empty line\n\t\tlet description = frontmatter.description || \"\";\n\t\tif (!description) {\n\t\t\tconst firstLine = body.split(\"\\n\").find((line) => line.trim());\n\t\t\tif (firstLine) {\n\t\t\t\t// Truncate if too long\n\t\t\t\tdescription = firstLine.slice(0, 60);\n\t\t\t\tif (firstLine.length > 60) description += \"...\";\n\t\t\t}\n\t\t}\n\n\t\treturn {\n\t\t\tname,\n\t\t\tdescription,\n\t\t\t...(frontmatter[\"argument-hint\"] && { argumentHint: frontmatter[\"argument-hint\"] }),\n\t\t\tcontent: body,\n\t\t\tsourceInfo,\n\t\t\tfilePath,\n\t\t};\n\t} catch {\n\t\treturn null;\n\t}\n}\n\n/**\n * Scan a directory for .md files (non-recursive) and load them as prompt templates.\n */\nfunction loadTemplatesFromDir(dir: string, getSourceInfo: (filePath: string) => SourceInfo): PromptTemplate[] {\n\tconst templates: PromptTemplate[] = [];\n\n\tif (!existsSync(dir)) {\n\t\treturn templates;\n\t}\n\n\ttry {\n\t\tconst entries = readdirSync(dir, { withFileTypes: true });\n\n\t\tfor (const entry of entries) {\n\t\t\tconst fullPath = join(dir, entry.name);\n\n\t\t\t// For symlinks, check if they point to a file\n\t\t\tlet isFile = entry.isFile();\n\t\t\tif (entry.isSymbolicLink()) {\n\t\t\t\ttry {\n\t\t\t\t\tconst stats = statSync(fullPath);\n\t\t\t\t\tisFile = stats.isFile();\n\t\t\t\t} catch {\n\t\t\t\t\t// Broken symlink, skip it\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tif (isFile && entry.name.endsWith(\".md\")) {\n\t\t\t\tconst template = loadTemplateFromFile(fullPath, getSourceInfo(fullPath));\n\t\t\t\tif (template) {\n\t\t\t\t\ttemplates.push(template);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t} catch {\n\t\treturn templates;\n\t}\n\n\treturn templates;\n}\n\nexport interface LoadPromptTemplatesOptions {\n\t/** Working directory for project-local templates. */\n\tcwd: string;\n\t/** Agent config directory for global templates. */\n\tagentDir: string;\n\t/** Explicit prompt template paths (files or directories). */\n\tpromptPaths: string[];\n\t/** Include default prompt directories. */\n\tincludeDefaults: boolean;\n}\n\n/**\n * Load all prompt templates from:\n * 1. Global: agentDir/prompts/\n * 2. Project: cwd/{CONFIG_DIR_NAME}/prompts/\n * 3. Explicit prompt paths\n */\nexport function loadPromptTemplates(options: LoadPromptTemplatesOptions): PromptTemplate[] {\n\tconst resolvedCwd = resolvePath(options.cwd);\n\tconst resolvedAgentDir = resolvePath(options.agentDir);\n\tconst promptPaths = options.promptPaths;\n\tconst includeDefaults = options.includeDefaults;\n\n\tconst templates: PromptTemplate[] = [];\n\n\tconst globalPromptsDir = join(resolvedAgentDir, \"prompts\");\n\tconst projectPromptsDir = resolve(resolvedCwd, CONFIG_DIR_NAME, \"prompts\");\n\n\tconst isUnderPath = (target: string, root: string): boolean => {\n\t\tconst normalizedRoot = resolve(root);\n\t\tif (target === normalizedRoot) {\n\t\t\treturn true;\n\t\t}\n\t\tconst prefix = normalizedRoot.endsWith(sep) ? normalizedRoot : `${normalizedRoot}${sep}`;\n\t\treturn target.startsWith(prefix);\n\t};\n\n\tconst getSourceInfo = (resolvedPath: string): SourceInfo => {\n\t\tif (isUnderPath(resolvedPath, globalPromptsDir)) {\n\t\t\treturn createSyntheticSourceInfo(resolvedPath, {\n\t\t\t\tsource: \"local\",\n\t\t\t\tscope: \"user\",\n\t\t\t\tbaseDir: globalPromptsDir,\n\t\t\t});\n\t\t}\n\t\tif (isUnderPath(resolvedPath, projectPromptsDir)) {\n\t\t\treturn createSyntheticSourceInfo(resolvedPath, {\n\t\t\t\tsource: \"local\",\n\t\t\t\tscope: \"project\",\n\t\t\t\tbaseDir: projectPromptsDir,\n\t\t\t});\n\t\t}\n\t\treturn createSyntheticSourceInfo(resolvedPath, {\n\t\t\tsource: \"local\",\n\t\t\tbaseDir: statSync(resolvedPath).isDirectory() ? resolvedPath : dirname(resolvedPath),\n\t\t});\n\t};\n\n\tif (includeDefaults) {\n\t\ttemplates.push(...loadTemplatesFromDir(globalPromptsDir, getSourceInfo));\n\t\ttemplates.push(...loadTemplatesFromDir(projectPromptsDir, getSourceInfo));\n\t}\n\n\t// 3. Load explicit prompt paths\n\tfor (const rawPath of promptPaths) {\n\t\tconst resolvedPath = resolvePath(rawPath, resolvedCwd, { trim: true });\n\t\tif (!existsSync(resolvedPath)) {\n\t\t\tcontinue;\n\t\t}\n\n\t\ttry {\n\t\t\tconst stats = statSync(resolvedPath);\n\t\t\tif (stats.isDirectory()) {\n\t\t\t\ttemplates.push(...loadTemplatesFromDir(resolvedPath, getSourceInfo));\n\t\t\t} else if (stats.isFile() && resolvedPath.endsWith(\".md\")) {\n\t\t\t\tconst template = loadTemplateFromFile(resolvedPath, getSourceInfo(resolvedPath));\n\t\t\t\tif (template) {\n\t\t\t\t\ttemplates.push(template);\n\t\t\t\t}\n\t\t\t}\n\t\t} catch {\n\t\t\t// Ignore read failures\n\t\t}\n\t}\n\n\treturn templates;\n}\n\n/**\n * Expand a prompt template if it matches a template name.\n * Returns the expanded content or the original text if not a template.\n */\nexport function expandPromptTemplate(text: string, templates: PromptTemplate[]): string {\n\tif (!text.startsWith(\"/\")) return text;\n\n\tconst match = text.match(/^\\/([^\\s]+)(?:\\s+([\\s\\S]*))?$/);\n\tif (!match) return text;\n\n\tconst templateName = match[1];\n\tconst argsString = match[2] ?? \"\";\n\n\tconst template = templates.find((t) => t.name === templateName);\n\tif (template) {\n\t\tconst args = parseCommandArgs(argsString);\n\t\treturn substituteArgs(template.content, args);\n\t}\n\n\treturn text;\n}\n"]}

package/dist/core/prompt-templates.js

@@ -0,0 +1,236 @@
+import { existsSync, readdirSync, readFileSync, statSync } from "fs";
+import { basename, dirname, join, resolve, sep } from "path";
+import { CONFIG_DIR_NAME } from "../config.js";
+import { parseFrontmatter } from "../utils/frontmatter.js";
+import { resolvePath } from "../utils/paths.js";
+import { createSyntheticSourceInfo } from "./source-info.js";
+/**
+ * Parse command arguments respecting quoted strings (bash-style)
+ * Returns array of arguments
+ */
+export function parseCommandArgs(argsString) {
+    const args = [];
+    let current = "";
+    let inQuote = null;
+    for (let i = 0; i < argsString.length; i++) {
+        const char = argsString[i];
+        if (inQuote) {
+            if (char === inQuote) {
+                inQuote = null;
+            }
+            else {
+                current += char;
+            }
+        }
+        else if (char === '"' || char === "'") {
+            inQuote = char;
+        }
+        else if (/\s/.test(char)) {
+            if (current) {
+                args.push(current);
+                current = "";
+            }
+        }
+        else {
+            current += char;
+        }
+    }
+    if (current) {
+        args.push(current);
+    }
+    return args;
+}
+/**
+ * Substitute argument placeholders in template content
+ * Supports:
+ * - $1, $2, ... for positional args
+ * - $@ and $ARGUMENTS for all args
+ * - ${N:-default} for positional arg N with default when missing/empty
+ * - ${@:N} for args from Nth onwards (bash-style slicing)
+ * - ${@:N:L} for L args starting from Nth
+ *
+ * Note: Replacement happens on the template string only. Argument and default values
+ * containing patterns like $1, $@, or $ARGUMENTS are NOT recursively substituted.
+ */
+export function substituteArgs(content, args) {
+    const allArgs = args.join(" ");
+    return content.replace(/\$\{(\d+):-([^}]*)\}|\$\{@:(\d+)(?::(\d+))?\}|\$(ARGUMENTS|@|\d+)/g, (_match, defaultNum, defaultValue, sliceStart, sliceLength, simple) => {
+        if (defaultNum) {
+            const index = parseInt(defaultNum, 10) - 1;
+            const value = args[index];
+            return value ? value : defaultValue;
+        }
+        if (sliceStart) {
+            let start = parseInt(sliceStart, 10) - 1; // Convert to 0-indexed (user provides 1-indexed)
+            // Treat 0 as 1 (bash convention: args start at 1)
+            if (start < 0)
+                start = 0;
+            if (sliceLength) {
+                const length = parseInt(sliceLength, 10);
+                return args.slice(start, start + length).join(" ");
+            }
+            return args.slice(start).join(" ");
+        }
+        if (simple === "ARGUMENTS" || simple === "@") {
+            return allArgs;
+        }
+        const index = parseInt(simple, 10) - 1;
+        return args[index] ?? "";
+    });
+}
+function loadTemplateFromFile(filePath, sourceInfo) {
+    try {
+        const rawContent = readFileSync(filePath, "utf-8");
+        const { frontmatter, body } = parseFrontmatter(rawContent);
+        const name = basename(filePath).replace(/\.md$/, "");
+        // Get description from frontmatter or first non-empty line
+        let description = frontmatter.description || "";
+        if (!description) {
+            const firstLine = body.split("\n").find((line) => line.trim());
+            if (firstLine) {
+                // Truncate if too long
+                description = firstLine.slice(0, 60);
+                if (firstLine.length > 60)
+                    description += "...";
+            }
+        }
+        return {
+            name,
+            description,
+            ...(frontmatter["argument-hint"] && { argumentHint: frontmatter["argument-hint"] }),
+            content: body,
+            sourceInfo,
+            filePath,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Scan a directory for .md files (non-recursive) and load them as prompt templates.
+ */
+function loadTemplatesFromDir(dir, getSourceInfo) {
+    const templates = [];
+    if (!existsSync(dir)) {
+        return templates;
+    }
+    try {
+        const entries = readdirSync(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = join(dir, entry.name);
+            // For symlinks, check if they point to a file
+            let isFile = entry.isFile();
+            if (entry.isSymbolicLink()) {
+                try {
+                    const stats = statSync(fullPath);
+                    isFile = stats.isFile();
+                }
+                catch {
+                    // Broken symlink, skip it
+                    continue;
+                }
+            }
+            if (isFile && entry.name.endsWith(".md")) {
+                const template = loadTemplateFromFile(fullPath, getSourceInfo(fullPath));
+                if (template) {
+                    templates.push(template);
+                }
+            }
+        }
+    }
+    catch {
+        return templates;
+    }
+    return templates;
+}
+/**
+ * Load all prompt templates from:
+ * 1. Global: agentDir/prompts/
+ * 2. Project: cwd/{CONFIG_DIR_NAME}/prompts/
+ * 3. Explicit prompt paths
+ */
+export function loadPromptTemplates(options) {
+    const resolvedCwd = resolvePath(options.cwd);
+    const resolvedAgentDir = resolvePath(options.agentDir);
+    const promptPaths = options.promptPaths;
+    const includeDefaults = options.includeDefaults;
+    const templates = [];
+    const globalPromptsDir = join(resolvedAgentDir, "prompts");
+    const projectPromptsDir = resolve(resolvedCwd, CONFIG_DIR_NAME, "prompts");
+    const isUnderPath = (target, root) => {
+        const normalizedRoot = resolve(root);
+        if (target === normalizedRoot) {
+            return true;
+        }
+        const prefix = normalizedRoot.endsWith(sep) ? normalizedRoot : `${normalizedRoot}${sep}`;
+        return target.startsWith(prefix);
+    };
+    const getSourceInfo = (resolvedPath) => {
+        if (isUnderPath(resolvedPath, globalPromptsDir)) {
+            return createSyntheticSourceInfo(resolvedPath, {
+                source: "local",
+                scope: "user",
+                baseDir: globalPromptsDir,
+            });
+        }
+        if (isUnderPath(resolvedPath, projectPromptsDir)) {
+            return createSyntheticSourceInfo(resolvedPath, {
+                source: "local",
+                scope: "project",
+                baseDir: projectPromptsDir,
+            });
+        }
+        return createSyntheticSourceInfo(resolvedPath, {
+            source: "local",
+            baseDir: statSync(resolvedPath).isDirectory() ? resolvedPath : dirname(resolvedPath),
+        });
+    };
+    if (includeDefaults) {
+        templates.push(...loadTemplatesFromDir(globalPromptsDir, getSourceInfo));
+        templates.push(...loadTemplatesFromDir(projectPromptsDir, getSourceInfo));
+    }
+    // 3. Load explicit prompt paths
+    for (const rawPath of promptPaths) {
+        const resolvedPath = resolvePath(rawPath, resolvedCwd, { trim: true });
+        if (!existsSync(resolvedPath)) {
+            continue;
+        }
+        try {
+            const stats = statSync(resolvedPath);
+            if (stats.isDirectory()) {
+                templates.push(...loadTemplatesFromDir(resolvedPath, getSourceInfo));
+            }
+            else if (stats.isFile() && resolvedPath.endsWith(".md")) {
+                const template = loadTemplateFromFile(resolvedPath, getSourceInfo(resolvedPath));
+                if (template) {
+                    templates.push(template);
+                }
+            }
+        }
+        catch {
+            // Ignore read failures
+        }
+    }
+    return templates;
+}
+/**
+ * Expand a prompt template if it matches a template name.
+ * Returns the expanded content or the original text if not a template.
+ */
+export function expandPromptTemplate(text, templates) {
+    if (!text.startsWith("/"))
+        return text;
+    const match = text.match(/^\/([^\s]+)(?:\s+([\s\S]*))?$/);
+    if (!match)
+        return text;
+    const templateName = match[1];
+    const argsString = match[2] ?? "";
+    const template = templates.find((t) => t.name === templateName);
+    if (template) {
+        const args = parseCommandArgs(argsString);
+        return substituteArgs(template.content, args);
+    }
+    return text;
+}
+//# sourceMappingURL=prompt-templates.js.map