@ashx-j/lunr 0.1.0

package/dist/builtin-extensions/lunr-local-providers/local-servers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-servers.d.ts","sourceRoot":"","sources":["../../../src/builtin-extensions/lunr-local-providers/local-servers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAE3E,MAAM,WAAW,eAAe;IAC/B,4DAA4D;IAC5D,UAAU,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,WAAW,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,OAAO,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,SAAS,EAAE,MAAM,CAAC;IAClB,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,QAAQ,EAAE,MAAM,CAAC;CACjB;AAKD,eAAO,MAAM,YAAY,EAAE,eAS1B,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,eAQvB,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,SAAS,eAAe,EAA8B,CAAC;AAEnF;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,EAAE,CA+B1D;AAuBD;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACvC,IAAI,EAAE,eAAe,EACrB,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAQ1B;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,mBAAmB,CAU7D","sourcesContent":["/**\n * Local model server discovery for lunR (Ollama, LM Studio).\n *\n * Pure functions with no runtime imports so the probing and response\n * normalization can be harness-tested directly against a mock HTTP server.\n * The extension factory lives in index.ts.\n */\n\nimport type { ProviderModelConfig } from \"@earendil-works/pi-coding-agent\";\n\nexport interface LocalServerSpec {\n\t/** Provider id used for registration and auth.json keys. */\n\tproviderId: string;\n\t/** Display name shown in /login and /model. */\n\tdisplayName: string;\n\t/** Bare product name used in probe/login messages. */\n\tproductName: string;\n\t/** localhost port, for failure messages. */\n\tport: number;\n\t/** OpenAI-compatible base URL registered with the provider. */\n\tbaseUrl: string;\n\t/** OpenAI-style model listing endpoint ({ data: [{ id }] }). */\n\tmodelsUrl: string;\n\t/** Ollama-only fallback listing endpoint ({ models: [{ name }] }). */\n\ttagsUrl?: string;\n\t/** Dummy credential value; local servers need no real key. */\n\tdummyKey: string;\n}\n\nconst OLLAMA_ORIGIN = \"http://localhost:11434\";\nconst LM_STUDIO_ORIGIN = \"http://localhost:1234\";\n\nexport const OLLAMA_LOCAL: LocalServerSpec = {\n\tproviderId: \"ollama-local\",\n\tdisplayName: \"Ollama (local)\",\n\tproductName: \"Ollama\",\n\tport: 11434,\n\tbaseUrl: `${OLLAMA_ORIGIN}/v1`,\n\tmodelsUrl: `${OLLAMA_ORIGIN}/v1/models`,\n\ttagsUrl: `${OLLAMA_ORIGIN}/api/tags`,\n\tdummyKey: \"ollama\",\n};\n\nexport const LM_STUDIO: LocalServerSpec = {\n\tproviderId: \"lm-studio\",\n\tdisplayName: \"LM Studio (local)\",\n\tproductName: \"LM Studio\",\n\tport: 1234,\n\tbaseUrl: `${LM_STUDIO_ORIGIN}/v1`,\n\tmodelsUrl: `${LM_STUDIO_ORIGIN}/v1/models`,\n\tdummyKey: \"local\",\n};\n\nexport const LOCAL_SERVERS: readonly LocalServerSpec[] = [OLLAMA_LOCAL, LM_STUDIO];\n\n/**\n * Normalize the two known listing shapes into a deduped id list:\n * - OpenAI style `{ data: [{ id, ... }] }` (Ollama /v1/models, LM Studio)\n * - Ollama /api/tags `{ models: [{ name, ... }] }`\n * Bare string arrays and `id`/`name`/`model` entry fields are tolerated.\n */\nexport function extractModelIds(payload: unknown): string[] {\n\tconst ids: string[] = [];\n\tconst push = (value: unknown): void => {\n\t\tif (typeof value === \"string\" && value.length > 0 && !ids.includes(value)) {\n\t\t\tids.push(value);\n\t\t}\n\t};\n\tconst fromEntry = (entry: unknown): void => {\n\t\tif (typeof entry === \"string\") {\n\t\t\tpush(entry);\n\t\t\treturn;\n\t\t}\n\t\tif (entry !== null && typeof entry === \"object\") {\n\t\t\tconst record = entry as Record<string, unknown>;\n\t\t\tpush(record.id ?? record.name ?? record.model);\n\t\t}\n\t};\n\tif (Array.isArray(payload)) {\n\t\tfor (const entry of payload) fromEntry(entry);\n\t\treturn ids;\n\t}\n\tif (payload !== null && typeof payload === \"object\") {\n\t\tconst record = payload as Record<string, unknown>;\n\t\tif (Array.isArray(record.data)) {\n\t\t\tfor (const entry of record.data) fromEntry(entry);\n\t\t}\n\t\tif (Array.isArray(record.models)) {\n\t\t\tfor (const entry of record.models) fromEntry(entry);\n\t\t}\n\t}\n\treturn ids;\n}\n\n/** Fetch JSON with a hard timeout; null on any network/HTTP/parse failure. Never throws. */\nasync function fetchJson(url: string, timeoutMs: number, signal?: AbortSignal): Promise<unknown | null> {\n\tconst controller = new AbortController();\n\tconst timer = setTimeout(() => controller.abort(), timeoutMs);\n\tconst onAbort = (): void => controller.abort();\n\tsignal?.addEventListener(\"abort\", onAbort, { once: true });\n\ttry {\n\t\tconst response = await fetch(url, {\n\t\t\theaders: { accept: \"application/json\" },\n\t\t\tsignal: controller.signal,\n\t\t});\n\t\tif (!response.ok) return null;\n\t\treturn (await response.json()) as unknown;\n\t} catch {\n\t\treturn null;\n\t} finally {\n\t\tclearTimeout(timer);\n\t\tsignal?.removeEventListener(\"abort\", onAbort);\n\t}\n}\n\n/**\n * Probe a local server for its model list.\n * Returns a (possibly empty) id list when the server responded, or null when\n * nothing usable answered — unreachable port, non-JSON, or error status on\n * every known endpoint. Never throws; worst-case delay is ~timeoutMs per\n * endpoint.\n */\nexport async function fetchLocalModelIds(\n\tspec: LocalServerSpec,\n\ttimeoutMs: number,\n\tsignal?: AbortSignal,\n): Promise<string[] | null> {\n\tconst payload = await fetchJson(spec.modelsUrl, timeoutMs, signal);\n\tif (payload !== null) return extractModelIds(payload);\n\tif (spec.tagsUrl) {\n\t\tconst fallback = await fetchJson(spec.tagsUrl, timeoutMs, signal);\n\t\tif (fallback !== null) return extractModelIds(fallback);\n\t}\n\treturn null;\n}\n\n/**\n * ProviderModelConfig defaults for local models: 32k context, zero cost,\n * text-only. Local servers do not advertise per-model limits, so these are\n * conservative fixed values.\n */\nexport function toModelConfig(id: string): ProviderModelConfig {\n\treturn {\n\t\tid,\n\t\tname: id,\n\t\treasoning: false,\n\t\tinput: [\"text\"],\n\t\tcost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },\n\t\tcontextWindow: 32768,\n\t\tmaxTokens: 8192,\n\t};\n}\n"]}

package/dist/builtin-extensions/lunr-local-providers/local-servers.js

@@ -0,0 +1,128 @@
+/**
+ * Local model server discovery for lunR (Ollama, LM Studio).
+ *
+ * Pure functions with no runtime imports so the probing and response
+ * normalization can be harness-tested directly against a mock HTTP server.
+ * The extension factory lives in index.ts.
+ */
+const OLLAMA_ORIGIN = "http://localhost:11434";
+const LM_STUDIO_ORIGIN = "http://localhost:1234";
+export const OLLAMA_LOCAL = {
+    providerId: "ollama-local",
+    displayName: "Ollama (local)",
+    productName: "Ollama",
+    port: 11434,
+    baseUrl: `${OLLAMA_ORIGIN}/v1`,
+    modelsUrl: `${OLLAMA_ORIGIN}/v1/models`,
+    tagsUrl: `${OLLAMA_ORIGIN}/api/tags`,
+    dummyKey: "ollama",
+};
+export const LM_STUDIO = {
+    providerId: "lm-studio",
+    displayName: "LM Studio (local)",
+    productName: "LM Studio",
+    port: 1234,
+    baseUrl: `${LM_STUDIO_ORIGIN}/v1`,
+    modelsUrl: `${LM_STUDIO_ORIGIN}/v1/models`,
+    dummyKey: "local",
+};
+export const LOCAL_SERVERS = [OLLAMA_LOCAL, LM_STUDIO];
+/**
+ * Normalize the two known listing shapes into a deduped id list:
+ * - OpenAI style `{ data: [{ id, ... }] }` (Ollama /v1/models, LM Studio)
+ * - Ollama /api/tags `{ models: [{ name, ... }] }`
+ * Bare string arrays and `id`/`name`/`model` entry fields are tolerated.
+ */
+export function extractModelIds(payload) {
+    const ids = [];
+    const push = (value) => {
+        if (typeof value === "string" && value.length > 0 && !ids.includes(value)) {
+            ids.push(value);
+        }
+    };
+    const fromEntry = (entry) => {
+        if (typeof entry === "string") {
+            push(entry);
+            return;
+        }
+        if (entry !== null && typeof entry === "object") {
+            const record = entry;
+            push(record.id ?? record.name ?? record.model);
+        }
+    };
+    if (Array.isArray(payload)) {
+        for (const entry of payload)
+            fromEntry(entry);
+        return ids;
+    }
+    if (payload !== null && typeof payload === "object") {
+        const record = payload;
+        if (Array.isArray(record.data)) {
+            for (const entry of record.data)
+                fromEntry(entry);
+        }
+        if (Array.isArray(record.models)) {
+            for (const entry of record.models)
+                fromEntry(entry);
+        }
+    }
+    return ids;
+}
+/** Fetch JSON with a hard timeout; null on any network/HTTP/parse failure. Never throws. */
+async function fetchJson(url, timeoutMs, signal) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    const onAbort = () => controller.abort();
+    signal?.addEventListener("abort", onAbort, { once: true });
+    try {
+        const response = await fetch(url, {
+            headers: { accept: "application/json" },
+            signal: controller.signal,
+        });
+        if (!response.ok)
+            return null;
+        return (await response.json());
+    }
+    catch {
+        return null;
+    }
+    finally {
+        clearTimeout(timer);
+        signal?.removeEventListener("abort", onAbort);
+    }
+}
+/**
+ * Probe a local server for its model list.
+ * Returns a (possibly empty) id list when the server responded, or null when
+ * nothing usable answered — unreachable port, non-JSON, or error status on
+ * every known endpoint. Never throws; worst-case delay is ~timeoutMs per
+ * endpoint.
+ */
+export async function fetchLocalModelIds(spec, timeoutMs, signal) {
+    const payload = await fetchJson(spec.modelsUrl, timeoutMs, signal);
+    if (payload !== null)
+        return extractModelIds(payload);
+    if (spec.tagsUrl) {
+        const fallback = await fetchJson(spec.tagsUrl, timeoutMs, signal);
+        if (fallback !== null)
+            return extractModelIds(fallback);
+    }
+    return null;
+}
+/**
+ * ProviderModelConfig defaults for local models: 32k context, zero cost,
+ * text-only. Local servers do not advertise per-model limits, so these are
+ * conservative fixed values.
+ */
+export function toModelConfig(id) {
+    return {
+        id,
+        name: id,
+        reasoning: false,
+        input: ["text"],
+        cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
+        contextWindow: 32768,
+        maxTokens: 8192,
+    };
+}
+//# sourceMappingURL=local-servers.js.map

package/dist/builtin-extensions/lunr-local-providers/local-servers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-servers.js","sourceRoot":"","sources":["../../../src/builtin-extensions/lunr-local-providers/local-servers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAuBH,MAAM,aAAa,GAAG,wBAAwB,CAAC;AAC/C,MAAM,gBAAgB,GAAG,uBAAuB,CAAC;AAEjD,MAAM,CAAC,MAAM,YAAY,GAAoB;IAC5C,UAAU,EAAE,cAAc;IAC1B,WAAW,EAAE,gBAAgB;IAC7B,WAAW,EAAE,QAAQ;IACrB,IAAI,EAAE,KAAK;IACX,OAAO,EAAE,GAAG,aAAa,KAAK;IAC9B,SAAS,EAAE,GAAG,aAAa,YAAY;IACvC,OAAO,EAAE,GAAG,aAAa,WAAW;IACpC,QAAQ,EAAE,QAAQ;CAClB,CAAC;AAEF,MAAM,CAAC,MAAM,SAAS,GAAoB;IACzC,UAAU,EAAE,WAAW;IACvB,WAAW,EAAE,mBAAmB;IAChC,WAAW,EAAE,WAAW;IACxB,IAAI,EAAE,IAAI;IACV,OAAO,EAAE,GAAG,gBAAgB,KAAK;IACjC,SAAS,EAAE,GAAG,gBAAgB,YAAY;IAC1C,QAAQ,EAAE,OAAO;CACjB,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAA+B,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;AAEnF;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,OAAgB,EAAY;IAC3D,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,MAAM,IAAI,GAAG,CAAC,KAAc,EAAQ,EAAE,CAAC;QACtC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3E,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjB,CAAC;IAAA,CACD,CAAC;IACF,MAAM,SAAS,GAAG,CAAC,KAAc,EAAQ,EAAE,CAAC;QAC3C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC/B,IAAI,CAAC,KAAK,CAAC,CAAC;YACZ,OAAO;QACR,CAAC;QACD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YACjD,MAAM,MAAM,GAAG,KAAgC,CAAC;YAChD,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC;QAChD,CAAC;IAAA,CACD,CAAC;IACF,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5B,KAAK,MAAM,KAAK,IAAI,OAAO;YAAE,SAAS,CAAC,KAAK,CAAC,CAAC;QAC9C,OAAO,GAAG,CAAC;IACZ,CAAC;IACD,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QACrD,MAAM,MAAM,GAAG,OAAkC,CAAC;QAClD,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YAChC,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,IAAI;gBAAE,SAAS,CAAC,KAAK,CAAC,CAAC;QACnD,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YAClC,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM;gBAAE,SAAS,CAAC,KAAK,CAAC,CAAC;QACrD,CAAC;IACF,CAAC;IACD,OAAO,GAAG,CAAC;AAAA,CACX;AAED,4FAA4F;AAC5F,KAAK,UAAU,SAAS,CAAC,GAAW,EAAE,SAAiB,EAAE,MAAoB,EAA2B;IACvG,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,SAAS,CAAC,CAAC;IAC9D,MAAM,OAAO,GAAG,GAAS,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;IAC/C,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3D,IAAI,CAAC;QACJ,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YACjC,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE;YACvC,MAAM,EAAE,UAAU,CAAC,MAAM;SACzB,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC;QAC9B,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAY,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,IAAI,CAAC;IACb,CAAC;YAAS,CAAC;QACV,YAAY,CAAC,KAAK,CAAC,CAAC;QACpB,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC/C,CAAC;AAAA,CACD;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACvC,IAAqB,EACrB,SAAiB,EACjB,MAAoB,EACO;IAC3B,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;IACnE,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,eAAe,CAAC,OAAO,CAAC,CAAC;IACtD,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QAClB,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;QAClE,IAAI,QAAQ,KAAK,IAAI;YAAE,OAAO,eAAe,CAAC,QAAQ,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,IAAI,CAAC;AAAA,CACZ;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,EAAU,EAAuB;IAC9D,OAAO;QACN,EAAE;QACF,IAAI,EAAE,EAAE;QACR,SAAS,EAAE,KAAK;QAChB,KAAK,EAAE,CAAC,MAAM,CAAC;QACf,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE;QAC1D,aAAa,EAAE,KAAK;QACpB,SAAS,EAAE,IAAI;KACf,CAAC;AAAA,CACF","sourcesContent":["/**\n * Local model server discovery for lunR (Ollama, LM Studio).\n *\n * Pure functions with no runtime imports so the probing and response\n * normalization can be harness-tested directly against a mock HTTP server.\n * The extension factory lives in index.ts.\n */\n\nimport type { ProviderModelConfig } from \"@earendil-works/pi-coding-agent\";\n\nexport interface LocalServerSpec {\n\t/** Provider id used for registration and auth.json keys. */\n\tproviderId: string;\n\t/** Display name shown in /login and /model. */\n\tdisplayName: string;\n\t/** Bare product name used in probe/login messages. */\n\tproductName: string;\n\t/** localhost port, for failure messages. */\n\tport: number;\n\t/** OpenAI-compatible base URL registered with the provider. */\n\tbaseUrl: string;\n\t/** OpenAI-style model listing endpoint ({ data: [{ id }] }). */\n\tmodelsUrl: string;\n\t/** Ollama-only fallback listing endpoint ({ models: [{ name }] }). */\n\ttagsUrl?: string;\n\t/** Dummy credential value; local servers need no real key. */\n\tdummyKey: string;\n}\n\nconst OLLAMA_ORIGIN = \"http://localhost:11434\";\nconst LM_STUDIO_ORIGIN = \"http://localhost:1234\";\n\nexport const OLLAMA_LOCAL: LocalServerSpec = {\n\tproviderId: \"ollama-local\",\n\tdisplayName: \"Ollama (local)\",\n\tproductName: \"Ollama\",\n\tport: 11434,\n\tbaseUrl: `${OLLAMA_ORIGIN}/v1`,\n\tmodelsUrl: `${OLLAMA_ORIGIN}/v1/models`,\n\ttagsUrl: `${OLLAMA_ORIGIN}/api/tags`,\n\tdummyKey: \"ollama\",\n};\n\nexport const LM_STUDIO: LocalServerSpec = {\n\tproviderId: \"lm-studio\",\n\tdisplayName: \"LM Studio (local)\",\n\tproductName: \"LM Studio\",\n\tport: 1234,\n\tbaseUrl: `${LM_STUDIO_ORIGIN}/v1`,\n\tmodelsUrl: `${LM_STUDIO_ORIGIN}/v1/models`,\n\tdummyKey: \"local\",\n};\n\nexport const LOCAL_SERVERS: readonly LocalServerSpec[] = [OLLAMA_LOCAL, LM_STUDIO];\n\n/**\n * Normalize the two known listing shapes into a deduped id list:\n * - OpenAI style `{ data: [{ id, ... }] }` (Ollama /v1/models, LM Studio)\n * - Ollama /api/tags `{ models: [{ name, ... }] }`\n * Bare string arrays and `id`/`name`/`model` entry fields are tolerated.\n */\nexport function extractModelIds(payload: unknown): string[] {\n\tconst ids: string[] = [];\n\tconst push = (value: unknown): void => {\n\t\tif (typeof value === \"string\" && value.length > 0 && !ids.includes(value)) {\n\t\t\tids.push(value);\n\t\t}\n\t};\n\tconst fromEntry = (entry: unknown): void => {\n\t\tif (typeof entry === \"string\") {\n\t\t\tpush(entry);\n\t\t\treturn;\n\t\t}\n\t\tif (entry !== null && typeof entry === \"object\") {\n\t\t\tconst record = entry as Record<string, unknown>;\n\t\t\tpush(record.id ?? record.name ?? record.model);\n\t\t}\n\t};\n\tif (Array.isArray(payload)) {\n\t\tfor (const entry of payload) fromEntry(entry);\n\t\treturn ids;\n\t}\n\tif (payload !== null && typeof payload === \"object\") {\n\t\tconst record = payload as Record<string, unknown>;\n\t\tif (Array.isArray(record.data)) {\n\t\t\tfor (const entry of record.data) fromEntry(entry);\n\t\t}\n\t\tif (Array.isArray(record.models)) {\n\t\t\tfor (const entry of record.models) fromEntry(entry);\n\t\t}\n\t}\n\treturn ids;\n}\n\n/** Fetch JSON with a hard timeout; null on any network/HTTP/parse failure. Never throws. */\nasync function fetchJson(url: string, timeoutMs: number, signal?: AbortSignal): Promise<unknown | null> {\n\tconst controller = new AbortController();\n\tconst timer = setTimeout(() => controller.abort(), timeoutMs);\n\tconst onAbort = (): void => controller.abort();\n\tsignal?.addEventListener(\"abort\", onAbort, { once: true });\n\ttry {\n\t\tconst response = await fetch(url, {\n\t\t\theaders: { accept: \"application/json\" },\n\t\t\tsignal: controller.signal,\n\t\t});\n\t\tif (!response.ok) return null;\n\t\treturn (await response.json()) as unknown;\n\t} catch {\n\t\treturn null;\n\t} finally {\n\t\tclearTimeout(timer);\n\t\tsignal?.removeEventListener(\"abort\", onAbort);\n\t}\n}\n\n/**\n * Probe a local server for its model list.\n * Returns a (possibly empty) id list when the server responded, or null when\n * nothing usable answered — unreachable port, non-JSON, or error status on\n * every known endpoint. Never throws; worst-case delay is ~timeoutMs per\n * endpoint.\n */\nexport async function fetchLocalModelIds(\n\tspec: LocalServerSpec,\n\ttimeoutMs: number,\n\tsignal?: AbortSignal,\n): Promise<string[] | null> {\n\tconst payload = await fetchJson(spec.modelsUrl, timeoutMs, signal);\n\tif (payload !== null) return extractModelIds(payload);\n\tif (spec.tagsUrl) {\n\t\tconst fallback = await fetchJson(spec.tagsUrl, timeoutMs, signal);\n\t\tif (fallback !== null) return extractModelIds(fallback);\n\t}\n\treturn null;\n}\n\n/**\n * ProviderModelConfig defaults for local models: 32k context, zero cost,\n * text-only. Local servers do not advertise per-model limits, so these are\n * conservative fixed values.\n */\nexport function toModelConfig(id: string): ProviderModelConfig {\n\treturn {\n\t\tid,\n\t\tname: id,\n\t\treasoning: false,\n\t\tinput: [\"text\"],\n\t\tcost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },\n\t\tcontextWindow: 32768,\n\t\tmaxTokens: 8192,\n\t};\n}\n"]}

package/dist/builtin-extensions/lunr-plan-tools.d.ts

@@ -0,0 +1,25 @@
+/**
+ * lunr-plan-tools — lunR-native plan-approval tool for plan mode.
+ *
+ * lunR: this file is lunR-native (not an absorbed upstream extension).
+ *
+ *  - One `present_plan` tool (TypeBox): the model calls it with a plan summary
+ *    while plan mode is active; the user approves or declines in a dedicated
+ *    dialog (kind "plan" approval request, see core/permissions.ts). Any
+ *    approve exits plan mode in interactive-mode BEFORE the result resolves.
+ *  - Outside plan mode the tool returns an error text. Without an approval
+ *    handler (gateway/headless) it passes through instead of deadlocking.
+ *  - Chat render is a quiet one-liner (renderCall/renderResult), matching the
+ *    todo/cron tools' minimal footprint.
+ *
+ * `runPresentPlan` is exported for vitest — see test/plan-approval.test.ts.
+ *
+ * `// @ts-nocheck` matches the builtin-extension convention (see lunr-cron).
+ * Runtime imports stay on concrete core modules — never the package barrel.
+ */
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+export declare const PRESENT_PLAN_WRONG_MODE_TEXT = "present_plan is only available in plan mode.";
+/** Execute-body logic, exported for tests: gate on plan mode, then ask. */
+export declare function runPresentPlan(summary: string): Promise<string>;
+export default function (pi: ExtensionAPI): void;
+//# sourceMappingURL=lunr-plan-tools.d.ts.map

package/dist/builtin-extensions/lunr-plan-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lunr-plan-tools.d.ts","sourceRoot":"","sources":["../../src/builtin-extensions/lunr-plan-tools.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAKpE,eAAO,MAAM,4BAA4B,iDAAiD,CAAC;AAE3F,2EAA2E;AAC3E,wBAAsB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAGrE;AAED,MAAM,CAAC,OAAO,WAAW,EAAE,EAAE,YAAY,GAAG,IAAI,CA0B/C","sourcesContent":["// @ts-nocheck\n/**\n * lunr-plan-tools — lunR-native plan-approval tool for plan mode.\n *\n * lunR: this file is lunR-native (not an absorbed upstream extension).\n *\n *  - One `present_plan` tool (TypeBox): the model calls it with a plan summary\n *    while plan mode is active; the user approves or declines in a dedicated\n *    dialog (kind \"plan\" approval request, see core/permissions.ts). Any\n *    approve exits plan mode in interactive-mode BEFORE the result resolves.\n *  - Outside plan mode the tool returns an error text. Without an approval\n *    handler (gateway/headless) it passes through instead of deadlocking.\n *  - Chat render is a quiet one-liner (renderCall/renderResult), matching the\n *    todo/cron tools' minimal footprint.\n *\n * `runPresentPlan` is exported for vitest — see test/plan-approval.test.ts.\n *\n * `// @ts-nocheck` matches the builtin-extension convention (see lunr-cron).\n * Runtime imports stay on concrete core modules — never the package barrel.\n */\n\nimport type { ExtensionAPI } from \"@earendil-works/pi-coding-agent\";\nimport { Text } from \"@earendil-works/pi-tui\";\nimport { Type } from \"@sinclair/typebox\";\nimport { isPlanModeActive, requestPlanApproval } from \"../core/permissions.ts\";\n\nexport const PRESENT_PLAN_WRONG_MODE_TEXT = \"present_plan is only available in plan mode.\";\n\n/** Execute-body logic, exported for tests: gate on plan mode, then ask. */\nexport async function runPresentPlan(summary: string): Promise<string> {\n\tif (!isPlanModeActive()) return PRESENT_PLAN_WRONG_MODE_TEXT;\n\treturn requestPlanApproval(summary);\n}\n\nexport default function (pi: ExtensionAPI): void {\n\tpi.registerTool({\n\t\tname: \"present_plan\",\n\t\tlabel: \"Plan\",\n\t\tdescription: [\n\t\t\t\"Present the finished plan for user approval. Only available in plan mode.\",\n\t\t\t\"Call once with a concise, concrete summary of the plan; the user approves\",\n\t\t\t\"or declines it in a dialog. The result text says whether to implement or revise.\",\n\t\t].join(\"\\n\"),\n\t\tparameters: Type.Object({\n\t\t\tsummary: Type.String({ description: \"Concise summary of the plan to approve.\" }),\n\t\t}),\n\t\tasync execute(_toolCallId, params) {\n\t\t\tconst summary = typeof params?.summary === \"string\" ? params.summary.trim() : \"\";\n\t\t\treturn { content: [{ type: \"text\" as const, text: await runPresentPlan(summary) }] };\n\t\t},\n\t\trenderCall(_args, theme) {\n\t\t\treturn new Text(theme.fg(\"toolTitle\", theme.bold(\"present_plan\")), 0, 0);\n\t\t},\n\t\trenderResult(result, { isPartial }, theme) {\n\t\t\tif (isPartial) return new Text(theme.fg(\"warning\", \"Presenting plan...\"), 0, 0);\n\t\t\tconst first = result?.content?.[0];\n\t\t\tconst text = first?.type === \"text\" ? first.text : \"\";\n\t\t\treturn new Text(theme.fg(\"dim\", text), 0, 0);\n\t\t},\n\t});\n}\n"]}

package/dist/builtin-extensions/lunr-plan-tools.js

@@ -0,0 +1,59 @@
+// @ts-nocheck
+/**
+ * lunr-plan-tools — lunR-native plan-approval tool for plan mode.
+ *
+ * lunR: this file is lunR-native (not an absorbed upstream extension).
+ *
+ *  - One `present_plan` tool (TypeBox): the model calls it with a plan summary
+ *    while plan mode is active; the user approves or declines in a dedicated
+ *    dialog (kind "plan" approval request, see core/permissions.ts). Any
+ *    approve exits plan mode in interactive-mode BEFORE the result resolves.
+ *  - Outside plan mode the tool returns an error text. Without an approval
+ *    handler (gateway/headless) it passes through instead of deadlocking.
+ *  - Chat render is a quiet one-liner (renderCall/renderResult), matching the
+ *    todo/cron tools' minimal footprint.
+ *
+ * `runPresentPlan` is exported for vitest — see test/plan-approval.test.ts.
+ *
+ * `// @ts-nocheck` matches the builtin-extension convention (see lunr-cron).
+ * Runtime imports stay on concrete core modules — never the package barrel.
+ */
+import { Text } from "@earendil-works/pi-tui";
+import { Type } from "@sinclair/typebox";
+import { isPlanModeActive, requestPlanApproval } from "../core/permissions.js";
+export const PRESENT_PLAN_WRONG_MODE_TEXT = "present_plan is only available in plan mode.";
+/** Execute-body logic, exported for tests: gate on plan mode, then ask. */
+export async function runPresentPlan(summary) {
+    if (!isPlanModeActive())
+        return PRESENT_PLAN_WRONG_MODE_TEXT;
+    return requestPlanApproval(summary);
+}
+export default function (pi) {
+    pi.registerTool({
+        name: "present_plan",
+        label: "Plan",
+        description: [
+            "Present the finished plan for user approval. Only available in plan mode.",
+            "Call once with a concise, concrete summary of the plan; the user approves",
+            "or declines it in a dialog. The result text says whether to implement or revise.",
+        ].join("\n"),
+        parameters: Type.Object({
+            summary: Type.String({ description: "Concise summary of the plan to approve." }),
+        }),
+        async execute(_toolCallId, params) {
+            const summary = typeof params?.summary === "string" ? params.summary.trim() : "";
+            return { content: [{ type: "text", text: await runPresentPlan(summary) }] };
+        },
+        renderCall(_args, theme) {
+            return new Text(theme.fg("toolTitle", theme.bold("present_plan")), 0, 0);
+        },
+        renderResult(result, { isPartial }, theme) {
+            if (isPartial)
+                return new Text(theme.fg("warning", "Presenting plan..."), 0, 0);
+            const first = result?.content?.[0];
+            const text = first?.type === "text" ? first.text : "";
+            return new Text(theme.fg("dim", text), 0, 0);
+        },
+    });
+}
+//# sourceMappingURL=lunr-plan-tools.js.map

package/dist/builtin-extensions/lunr-plan-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lunr-plan-tools.js","sourceRoot":"","sources":["../../src/builtin-extensions/lunr-plan-tools.ts"],"names":[],"mappings":"AAAA,cAAc;AACd;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAE/E,MAAM,CAAC,MAAM,4BAA4B,GAAG,8CAA8C,CAAC;AAE3F,2EAA2E;AAC3E,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAAe,EAAmB;IACtE,IAAI,CAAC,gBAAgB,EAAE;QAAE,OAAO,4BAA4B,CAAC;IAC7D,OAAO,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAAA,CACpC;AAED,MAAM,CAAC,OAAO,WAAW,EAAgB,EAAQ;IAChD,EAAE,CAAC,YAAY,CAAC;QACf,IAAI,EAAE,cAAc;QACpB,KAAK,EAAE,MAAM;QACb,WAAW,EAAE;YACZ,2EAA2E;YAC3E,2EAA2E;YAC3E,kFAAkF;SAClF,CAAC,IAAI,CAAC,IAAI,CAAC;QACZ,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC;YACvB,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,yCAAyC,EAAE,CAAC;SAChF,CAAC;QACF,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE;YAClC,MAAM,OAAO,GAAG,OAAO,MAAM,EAAE,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACjF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;QAAA,CACrF;QACD,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE;YACxB,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAAA,CACzE;QACD,YAAY,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE;YAC1C,IAAI,SAAS;gBAAE,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,SAAS,EAAE,oBAAoB,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;YAChF,MAAM,KAAK,GAAG,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;YACnC,MAAM,IAAI,GAAG,KAAK,EAAE,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YACtD,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAAA,CAC7C;KACD,CAAC,CAAC;AAAA,CACH","sourcesContent":["// @ts-nocheck\n/**\n * lunr-plan-tools — lunR-native plan-approval tool for plan mode.\n *\n * lunR: this file is lunR-native (not an absorbed upstream extension).\n *\n *  - One `present_plan` tool (TypeBox): the model calls it with a plan summary\n *    while plan mode is active; the user approves or declines in a dedicated\n *    dialog (kind \"plan\" approval request, see core/permissions.ts). Any\n *    approve exits plan mode in interactive-mode BEFORE the result resolves.\n *  - Outside plan mode the tool returns an error text. Without an approval\n *    handler (gateway/headless) it passes through instead of deadlocking.\n *  - Chat render is a quiet one-liner (renderCall/renderResult), matching the\n *    todo/cron tools' minimal footprint.\n *\n * `runPresentPlan` is exported for vitest — see test/plan-approval.test.ts.\n *\n * `// @ts-nocheck` matches the builtin-extension convention (see lunr-cron).\n * Runtime imports stay on concrete core modules — never the package barrel.\n */\n\nimport type { ExtensionAPI } from \"@earendil-works/pi-coding-agent\";\nimport { Text } from \"@earendil-works/pi-tui\";\nimport { Type } from \"@sinclair/typebox\";\nimport { isPlanModeActive, requestPlanApproval } from \"../core/permissions.ts\";\n\nexport const PRESENT_PLAN_WRONG_MODE_TEXT = \"present_plan is only available in plan mode.\";\n\n/** Execute-body logic, exported for tests: gate on plan mode, then ask. */\nexport async function runPresentPlan(summary: string): Promise<string> {\n\tif (!isPlanModeActive()) return PRESENT_PLAN_WRONG_MODE_TEXT;\n\treturn requestPlanApproval(summary);\n}\n\nexport default function (pi: ExtensionAPI): void {\n\tpi.registerTool({\n\t\tname: \"present_plan\",\n\t\tlabel: \"Plan\",\n\t\tdescription: [\n\t\t\t\"Present the finished plan for user approval. Only available in plan mode.\",\n\t\t\t\"Call once with a concise, concrete summary of the plan; the user approves\",\n\t\t\t\"or declines it in a dialog. The result text says whether to implement or revise.\",\n\t\t].join(\"\\n\"),\n\t\tparameters: Type.Object({\n\t\t\tsummary: Type.String({ description: \"Concise summary of the plan to approve.\" }),\n\t\t}),\n\t\tasync execute(_toolCallId, params) {\n\t\t\tconst summary = typeof params?.summary === \"string\" ? params.summary.trim() : \"\";\n\t\t\treturn { content: [{ type: \"text\" as const, text: await runPresentPlan(summary) }] };\n\t\t},\n\t\trenderCall(_args, theme) {\n\t\t\treturn new Text(theme.fg(\"toolTitle\", theme.bold(\"present_plan\")), 0, 0);\n\t\t},\n\t\trenderResult(result, { isPartial }, theme) {\n\t\t\tif (isPartial) return new Text(theme.fg(\"warning\", \"Presenting plan...\"), 0, 0);\n\t\t\tconst first = result?.content?.[0];\n\t\t\tconst text = first?.type === \"text\" ? first.text : \"\";\n\t\t\treturn new Text(theme.fg(\"dim\", text), 0, 0);\n\t\t},\n\t});\n}\n"]}

package/dist/builtin-extensions/lunr-skill-creator/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * lunR-native: ships the bundled `skill-creator` skill.
+ *
+ * The skill is contributed through the `resources_discover` hook (the same
+ * mechanism external extensions use to add resource paths) and its frontmatter
+ * sets `disable-model-invocation: true`, so it is EXCLUDED from the system
+ * prompt — zero automatic triggers. It only runs via explicit
+ * `/skill:skill-creator [topic]`.
+ */
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+export default function (pi: ExtensionAPI): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/builtin-extensions/lunr-skill-creator/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/builtin-extensions/lunr-skill-creator/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAMpE,MAAM,CAAC,OAAO,WAAW,EAAE,EAAE,YAAY,QAExC","sourcesContent":["/**\n * lunR-native: ships the bundled `skill-creator` skill.\n *\n * The skill is contributed through the `resources_discover` hook (the same\n * mechanism external extensions use to add resource paths) and its frontmatter\n * sets `disable-model-invocation: true`, so it is EXCLUDED from the system\n * prompt — zero automatic triggers. It only runs via explicit\n * `/skill:skill-creator [topic]`.\n */\n\nimport { dirname, join } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport type { ExtensionAPI } from \"@earendil-works/pi-coding-agent\";\n\n// Resolved like pi-subagents' bundled agents dir: src/ and dist/ mirror each\n// other, and copy-assets carries the SKILL.md into dist.\nconst SKILLS_DIR = join(dirname(fileURLToPath(import.meta.url)), \"skills\");\n\nexport default function (pi: ExtensionAPI) {\n  pi.on(\"resources_discover\", async () => ({ skillPaths: [SKILLS_DIR] }));\n}\n"]}

package/dist/builtin-extensions/lunr-skill-creator/index.js

@@ -0,0 +1,18 @@
+/**
+ * lunR-native: ships the bundled `skill-creator` skill.
+ *
+ * The skill is contributed through the `resources_discover` hook (the same
+ * mechanism external extensions use to add resource paths) and its frontmatter
+ * sets `disable-model-invocation: true`, so it is EXCLUDED from the system
+ * prompt — zero automatic triggers. It only runs via explicit
+ * `/skill:skill-creator [topic]`.
+ */
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+// Resolved like pi-subagents' bundled agents dir: src/ and dist/ mirror each
+// other, and copy-assets carries the SKILL.md into dist.
+const SKILLS_DIR = join(dirname(fileURLToPath(import.meta.url)), "skills");
+export default function (pi) {
+    pi.on("resources_discover", async () => ({ skillPaths: [SKILLS_DIR] }));
+}
+//# sourceMappingURL=index.js.map

package/dist/builtin-extensions/lunr-skill-creator/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/builtin-extensions/lunr-skill-creator/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGzC,6EAA6E;AAC7E,yDAAyD;AACzD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;AAE3E,MAAM,CAAC,OAAO,WAAW,EAAgB,EAAE;IACzC,EAAE,CAAC,EAAE,CAAC,oBAAoB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC;AAAA,CACzE","sourcesContent":["/**\n * lunR-native: ships the bundled `skill-creator` skill.\n *\n * The skill is contributed through the `resources_discover` hook (the same\n * mechanism external extensions use to add resource paths) and its frontmatter\n * sets `disable-model-invocation: true`, so it is EXCLUDED from the system\n * prompt — zero automatic triggers. It only runs via explicit\n * `/skill:skill-creator [topic]`.\n */\n\nimport { dirname, join } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport type { ExtensionAPI } from \"@earendil-works/pi-coding-agent\";\n\n// Resolved like pi-subagents' bundled agents dir: src/ and dist/ mirror each\n// other, and copy-assets carries the SKILL.md into dist.\nconst SKILLS_DIR = join(dirname(fileURLToPath(import.meta.url)), \"skills\");\n\nexport default function (pi: ExtensionAPI) {\n  pi.on(\"resources_discover\", async () => ({ skillPaths: [SKILLS_DIR] }));\n}\n"]}

package/dist/builtin-extensions/lunr-skill-creator/skills/skill-creator/SKILL.md

@@ -0,0 +1,68 @@
+---
+name: skill-creator
+description: Guide for creating new Agent Skills (SKILL.md files). Use when the user asks to create, scaffold, or write a skill.
+disable-model-invocation: true
+---
+
+# Skill Creator
+
+Help the user create a new skill: a directory containing a `SKILL.md` with YAML
+frontmatter, optionally plus supporting files (scripts, references, assets).
+
+## 1. Understand the skill first
+
+Ask (or infer from the request, if clearly specified):
+
+- What should the skill do? What triggers it (tasks, file types, phrases)?
+- Should the model be able to invoke it automatically? If the skill is a
+  workflow the user wants to run only on demand, set
+  `disable-model-invocation: true` — it is then excluded from the system prompt
+  and only runs via `/skill:<name>`.
+- Scope: global (`~/.lunr/agent/skills/<name>/`, every project) or project
+  (`<cwd>/.lunr/skills/<name>/`, this repo only; requires project trust).
+  Default to global unless the skill is project-specific.
+
+## 2. Create the skill
+
+Directory name = skill name. Name rules (validated on load):
+
+- lowercase a-z, 0-9, hyphens only; max 64 chars
+- no leading/trailing hyphen, no consecutive hyphens
+
+Write `<dir>/SKILL.md`:
+
+```markdown
+---
+name: my-skill
+description: One or two sentences — what it does AND when to use it. This is the only part the model sees before deciding to load the skill, so make the trigger conditions explicit.
+---
+
+# My Skill
+
+Step-by-step instructions for the model...
+```
+
+Frontmatter fields: `name` (must match the directory name), `description`
+(required, max 1024 chars), `disable-model-invocation` (optional, default false).
+
+Writing guidance:
+
+- The body is loaded only AFTER the model decides the skill is relevant
+  (progressive disclosure), so put effort into the description.
+- Keep the body focused; a few hundred lines max. Move long reference material
+  into sibling files (e.g. `reference.md`) and point at them — the model reads
+  them on demand. Relative paths in the body resolve against the skill
+  directory.
+- Include concrete examples and exact commands over abstract advice.
+- Scripts shipped in the skill directory can be run with the bash tool.
+
+## 3. Activate it
+
+New skills are picked up on `/reload` (or the next session start). The user can
+then invoke it explicitly with `/skill:<name> [args]` or, when model invocation
+is enabled, just ask for the task it describes.
+
+## 4. Verify
+
+After creating, confirm: frontmatter parses (name/description present), the
+directory name matches `name`, and `/reload` shows no skill warnings.

package/dist/builtin-extensions/lunr-todos.d.ts

@@ -0,0 +1,52 @@
+/**
+ * lunr-todos — lunR-native agent todo list with an above-editor widget.
+ *
+ * lunR: this file is lunR-native (not an absorbed upstream extension).
+ *
+ *  - One `todo` tool (TypeBox), full-replace semantics: every call sends the
+ *    ENTIRE list; an empty array clears it. State is per-session, in-memory
+ *    only (extension closure) — nothing is persisted.
+ *  - Chat render is a quiet one-liner (renderCall/renderResult), matching the
+ *    cron tool's minimal footprint.
+ *  - After every state change the list is mirrored into a `todos` widget above
+ *    the editor (component factory, so MAX_WIDGET_LINES string truncation does
+ *    not apply). Collapsed: up to 3 active rows (in-progress first, then
+ *    pending) + a `✓ N done` summary + a `+N more (<key> to expand)` hint.
+ *    Expanded: every row, completed included.
+ *  - Expansion follows the global ctrl+o toggle via the
+ *    `@lunr/tools-expanded-changed` bridge, invoked from
+ *    interactive-mode.ts `setToolsExpanded` (initial state is read from
+ *    `ctx.ui.getToolsExpanded()`).
+ *
+ * The pure logic (summarizeTodos / buildTodoWidgetLines) is exported for
+ * vitest — see test/lunr-todos.test.ts.
+ *
+ * `// @ts-nocheck` matches the builtin-extension convention (see lunr-cron).
+ * Runtime imports stay on concrete core modules — never the package barrel.
+ */
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+export type TodoStatus = "pending" | "in_progress" | "completed";
+export interface TodoItem {
+    id: string;
+    content: string;
+    status: TodoStatus;
+}
+export interface TodoWidgetLine {
+    kind: "todo" | "summary" | "hint";
+    status?: TodoStatus;
+    text: string;
+}
+/** Collapsed widget shows at most this many active (non-completed) rows. */
+export declare const TODO_WIDGET_COLLAPSED_ROWS = 3;
+/** Short model-facing summary, e.g. "4 todos: 1 in progress, 2 pending, 1 completed". */
+export declare function summarizeTodos(todos: TodoItem[]): string;
+/**
+ * Widget lines for the current list. Collapsed mode shows up to
+ * TODO_WIDGET_COLLAPSED_ROWS active rows (in-progress first, then pending),
+ * collapses completed items into a `✓ N done` summary, and appends a
+ * `+N more (<expandKey> to expand)` hint when active rows are hidden.
+ * Expanded mode shows every row. Empty list → no lines (widget removed).
+ */
+export declare function buildTodoWidgetLines(todos: TodoItem[], expanded: boolean, expandKey?: string): TodoWidgetLine[];
+export default function (pi: ExtensionAPI): void;
+//# sourceMappingURL=lunr-todos.d.ts.map

package/dist/builtin-extensions/lunr-todos.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lunr-todos.d.ts","sourceRoot":"","sources":["../../src/builtin-extensions/lunr-todos.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAoB,MAAM,iCAAiC,CAAC;AAStF,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,aAAa,GAAG,WAAW,CAAC;AAEjE,MAAM,WAAW,QAAQ;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,UAAU,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;IAClC,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CACb;AAED,4EAA4E;AAC5E,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAQ5C,yFAAyF;AACzF,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,MAAM,CAWxD;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,SAAW,GAAG,cAAc,EAAE,CAwBjH;AASD,MAAM,CAAC,OAAO,WAAW,EAAE,EAAE,YAAY,GAAG,IAAI,CAoG/C","sourcesContent":["// @ts-nocheck\n/**\n * lunr-todos — lunR-native agent todo list with an above-editor widget.\n *\n * lunR: this file is lunR-native (not an absorbed upstream extension).\n *\n *  - One `todo` tool (TypeBox), full-replace semantics: every call sends the\n *    ENTIRE list; an empty array clears it. State is per-session, in-memory\n *    only (extension closure) — nothing is persisted.\n *  - Chat render is a quiet one-liner (renderCall/renderResult), matching the\n *    cron tool's minimal footprint.\n *  - After every state change the list is mirrored into a `todos` widget above\n *    the editor (component factory, so MAX_WIDGET_LINES string truncation does\n *    not apply). Collapsed: up to 3 active rows (in-progress first, then\n *    pending) + a `✓ N done` summary + a `+N more (<key> to expand)` hint.\n *    Expanded: every row, completed included.\n *  - Expansion follows the global ctrl+o toggle via the\n *    `@lunr/tools-expanded-changed` bridge, invoked from\n *    interactive-mode.ts `setToolsExpanded` (initial state is read from\n *    `ctx.ui.getToolsExpanded()`).\n *\n * The pure logic (summarizeTodos / buildTodoWidgetLines) is exported for\n * vitest — see test/lunr-todos.test.ts.\n *\n * `// @ts-nocheck` matches the builtin-extension convention (see lunr-cron).\n * Runtime imports stay on concrete core modules — never the package barrel.\n */\n\nimport type { ExtensionAPI, ExtensionContext } from \"@earendil-works/pi-coding-agent\";\nimport { Text } from \"@earendil-works/pi-tui\";\nimport { Type } from \"@sinclair/typebox\";\nimport { keyText } from \"../modes/interactive/components/keybinding-hints.ts\";\n\n// ---------------------------------------------------------------------------\n// Pure logic (exported for tests)\n// ---------------------------------------------------------------------------\n\nexport type TodoStatus = \"pending\" | \"in_progress\" | \"completed\";\n\nexport interface TodoItem {\n\tid: string;\n\tcontent: string;\n\tstatus: TodoStatus;\n}\n\nexport interface TodoWidgetLine {\n\tkind: \"todo\" | \"summary\" | \"hint\";\n\tstatus?: TodoStatus;\n\ttext: string;\n}\n\n/** Collapsed widget shows at most this many active (non-completed) rows. */\nexport const TODO_WIDGET_COLLAPSED_ROWS = 3;\n\nconst STATUS_GLYPHS: Record<TodoStatus, string> = {\n\tin_progress: \"●\",\n\tpending: \"○\",\n\tcompleted: \"✓\",\n};\n\n/** Short model-facing summary, e.g. \"4 todos: 1 in progress, 2 pending, 1 completed\". */\nexport function summarizeTodos(todos: TodoItem[]): string {\n\tif (todos.length === 0) return \"No todos.\";\n\tconst count = (s: TodoStatus) => todos.filter((t) => t.status === s).length;\n\tconst parts: string[] = [];\n\tconst inProgress = count(\"in_progress\");\n\tconst pending = count(\"pending\");\n\tconst completed = count(\"completed\");\n\tif (inProgress > 0) parts.push(`${inProgress} in progress`);\n\tif (pending > 0) parts.push(`${pending} pending`);\n\tif (completed > 0) parts.push(`${completed} completed`);\n\treturn `${todos.length} todo${todos.length === 1 ? \"\" : \"s\"}: ${parts.join(\", \")}`;\n}\n\n/**\n * Widget lines for the current list. Collapsed mode shows up to\n * TODO_WIDGET_COLLAPSED_ROWS active rows (in-progress first, then pending),\n * collapses completed items into a `✓ N done` summary, and appends a\n * `+N more (<expandKey> to expand)` hint when active rows are hidden.\n * Expanded mode shows every row. Empty list → no lines (widget removed).\n */\nexport function buildTodoWidgetLines(todos: TodoItem[], expanded: boolean, expandKey = \"ctrl+o\"): TodoWidgetLine[] {\n\tif (todos.length === 0) return [];\n\tconst row = (t: TodoItem): TodoWidgetLine => ({\n\t\tkind: \"todo\",\n\t\tstatus: t.status,\n\t\ttext: `${STATUS_GLYPHS[t.status]} ${t.content}`,\n\t});\n\tconst active = [\n\t\t...todos.filter((t) => t.status === \"in_progress\"),\n\t\t...todos.filter((t) => t.status === \"pending\"),\n\t];\n\tconst done = todos.filter((t) => t.status === \"completed\");\n\tif (expanded) {\n\t\treturn [...active.map(row), ...done.map(row)];\n\t}\n\tconst lines: TodoWidgetLine[] = active.slice(0, TODO_WIDGET_COLLAPSED_ROWS).map(row);\n\tif (done.length > 0) {\n\t\tlines.push({ kind: \"summary\", text: `✓ ${done.length} done` });\n\t}\n\tconst hidden = active.length - TODO_WIDGET_COLLAPSED_ROWS;\n\tif (hidden > 0) {\n\t\tlines.push({ kind: \"hint\", text: `+${hidden} more (${expandKey} to expand)` });\n\t}\n\treturn lines;\n}\n\n// ---------------------------------------------------------------------------\n// Extension\n// ---------------------------------------------------------------------------\n\nconst WIDGET_KEY = \"todos\";\nconst EXPANDED_BRIDGE_SYMBOL = Symbol.for(\"@lunr/tools-expanded-changed\");\n\nexport default function (pi: ExtensionAPI): void {\n\tlet todos: TodoItem[] = [];\n\tlet expanded = false;\n\tlet lastCtx: ExtensionContext | null = null;\n\n\tfunction colorize(line: TodoWidgetLine, theme: any): string {\n\t\tif (line.kind === \"summary\" || line.kind === \"hint\") return theme.fg(\"muted\", line.text);\n\t\tif (line.status === \"in_progress\") return theme.fg(\"accent\", line.text);\n\t\tif (line.status === \"completed\") return theme.fg(\"dim\", line.text);\n\t\treturn line.text;\n\t}\n\n\tfunction refreshWidget(): void {\n\t\tconst ctx = lastCtx;\n\t\tif (!ctx?.hasUI) return;\n\t\tif (todos.length === 0) {\n\t\t\tctx.ui.setWidget(WIDGET_KEY, undefined);\n\t\t\treturn;\n\t\t}\n\t\tconst lines = buildTodoWidgetLines(todos, expanded, keyText(\"app.tools.expand\"));\n\t\tctx.ui.setWidget(\n\t\t\tWIDGET_KEY,\n\t\t\t(_tui: unknown, theme: any) => new Text(lines.map((l) => colorize(l, theme)).join(\"\\n\"), 1, 0),\n\t\t\t{ placement: \"aboveEditor\" },\n\t\t);\n\t}\n\n\t// --- Expansion bridge (interactive-mode setToolsExpanded invokes this) ---\n\tfunction registerExpandedBridge(): void {\n\t\t(globalThis as Record<symbol, unknown>)[EXPANDED_BRIDGE_SYMBOL] = (value: boolean) => {\n\t\t\texpanded = Boolean(value);\n\t\t\trefreshWidget();\n\t\t};\n\t}\n\tregisterExpandedBridge();\n\n\t// --- Session lifecycle: per-session in-memory state ---\n\tpi.on(\"session_start\", (_event, ctx) => {\n\t\tlastCtx = ctx;\n\t\ttodos = [];\n\t\texpanded = ctx.hasUI ? (ctx.ui.getToolsExpanded?.() ?? false) : false;\n\t\tregisterExpandedBridge();\n\t\tif (ctx.hasUI) ctx.ui.setWidget(WIDGET_KEY, undefined);\n\t});\n\n\tpi.on(\"session_shutdown\", () => {\n\t\tif (lastCtx?.hasUI) lastCtx.ui.setWidget(WIDGET_KEY, undefined);\n\t\tlastCtx = null;\n\t\tdelete (globalThis as Record<symbol, unknown>)[EXPANDED_BRIDGE_SYMBOL];\n\t});\n\n\t// --- todo tool (agent-facing) ---\n\tpi.registerTool({\n\t\tname: \"todo\",\n\t\tlabel: \"Todo\",\n\t\tdescription: [\n\t\t\t\"Manage the session todo list shown above the user's editor. Full-replace semantics:\",\n\t\t\t\"every call must send the ENTIRE list; send an empty array to clear it.\",\n\t\t\t\"Each item: { id, content, status: 'pending' | 'in_progress' | 'completed' }.\",\n\t\t\t\"Use it to track multi-step work; keep exactly one item in_progress at a time.\",\n\t\t].join(\"\\n\"),\n\t\tparameters: Type.Object({\n\t\t\ttodos: Type.Array(\n\t\t\t\tType.Object({\n\t\t\t\t\tid: Type.String({ description: \"Stable id for the item.\" }),\n\t\t\t\t\tcontent: Type.String({ description: \"Short description of the task.\" }),\n\t\t\t\t\tstatus: Type.Union([\n\t\t\t\t\t\tType.Literal(\"pending\"),\n\t\t\t\t\t\tType.Literal(\"in_progress\"),\n\t\t\t\t\t\tType.Literal(\"completed\"),\n\t\t\t\t\t]),\n\t\t\t\t}),\n\t\t\t),\n\t\t}),\n\t\tasync execute(_toolCallId, params, _signal, _onUpdate, ctx) {\n\t\t\tconst text = (t: string) => ({ content: [{ type: \"text\" as const, text: t }] });\n\t\t\tconst incoming = Array.isArray(params?.todos) ? params.todos : [];\n\t\t\ttodos = incoming\n\t\t\t\t.filter((t: any) => t && typeof t.content === \"string\" && t.content.trim().length > 0)\n\t\t\t\t.map((t: any, i: number) => ({\n\t\t\t\t\tid: typeof t.id === \"string\" && t.id ? t.id : String(i + 1),\n\t\t\t\t\tcontent: t.content.trim(),\n\t\t\t\t\tstatus: t.status === \"in_progress\" || t.status === \"completed\" ? t.status : \"pending\",\n\t\t\t\t}));\n\t\t\tlastCtx = ctx;\n\t\t\trefreshWidget();\n\t\t\treturn text(summarizeTodos(todos));\n\t\t},\n\t\trenderCall(args, theme) {\n\t\t\tconst n = Array.isArray(args?.todos) ? args.todos.length : 0;\n\t\t\tconst detail = n === 0 ? \"clear\" : `${n} item${n === 1 ? \"\" : \"s\"}`;\n\t\t\treturn new Text(theme.fg(\"toolTitle\", theme.bold(\"todo \")) + theme.fg(\"dim\", detail), 0, 0);\n\t\t},\n\t\trenderResult(result, { isPartial }, theme) {\n\t\t\tif (isPartial) return new Text(theme.fg(\"warning\", \"Updating todos...\"), 0, 0);\n\t\t\tconst first = result?.content?.[0];\n\t\t\tconst summary = first?.type === \"text\" ? first.text : \"\";\n\t\t\treturn new Text(theme.fg(\"dim\", summary), 0, 0);\n\t\t},\n\t});\n}\n"]}