lastlight 0.1.8 → 0.2.0

package/dist/engine/chat-runner.js

@@ -0,0 +1,379 @@
+/**
+ * In-process chat agent for Slack/Discord threads. Replaces the
+ * `opencode serve` HTTP supervisor with a direct pi-ai conversation:
+ *
+ *  - One pi-ai conversation per messaging thread.
+ *  - Conversation state lives in our existing `messaging_messages` DB
+ *    table — rehydrated on every turn so harness restarts are transparent.
+ *  - Tools are limited to read-only GitHub (see github-tools.ts). No bash,
+ *    no edit, no file system, no MCP.
+ *  - Per-thread in-flight chain so two messages in the same thread
+ *    serialize cleanly while different threads stay parallel.
+ */
+import { randomUUID } from "node:crypto";
+import { Octokit } from "octokit";
+import { completeSimple, getModel, } from "@earendil-works/pi-ai";
+import { buildChatGitHubTools } from "./github-tools.js";
+const MAX_TOOL_ROUNDS = 8;
+/**
+ * Exponential backoff schedule (ms) for transient chat-model failures —
+ * rate limits (429) and provider hiccups (5xx / overloaded / transient
+ * network). pi-ai disables the provider SDK's own retries (`maxRetries: 0`),
+ * so without this a single 429 from the model would kill the whole turn.
+ * The sandbox path already retries via pi-coding-agent's auto-retry; the
+ * chat path drives pi-ai directly, so it needs its own.
+ */
+const CHAT_RETRY_BACKOFF_MS = [10_000, 30_000, 60_000];
+/**
+ * Match transient, retryable model errors. Deliberately conservative: auth /
+ * validation / context-overflow / other 4xx (anything but 429) are NOT
+ * retried — only rate limits, server errors, and transient network faults.
+ */
+export function isRetryableModelError(message) {
+    const m = message.toLowerCase();
+    return (/\b429\b/.test(m) ||
+        m.includes("rate limit") ||
+        m.includes("rate_limit") ||
+        m.includes("too many requests") ||
+        m.includes("overloaded") ||
+        /\b50[0234]\b/.test(m) || // 500 / 502 / 503 / 504
+        m.includes("service unavailable") ||
+        m.includes("timeout") ||
+        m.includes("etimedout") ||
+        m.includes("econnreset") ||
+        m.includes("fetch failed"));
+}
+const sleepMs = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+/**
+ * Call `complete`, retrying transient failures with exponential backoff.
+ * Handles both shapes pi-ai surfaces a failure as: a thrown error, and a
+ * returned AssistantMessage with `stopReason === "error"`. Non-retryable
+ * outcomes (and the final attempt) are returned/thrown unchanged so the
+ * caller's existing error handling still applies. Dependency-injected for
+ * testing (`delaysMs` / `sleepFn` / `onRetry`).
+ */
+export async function completeWithRetry(complete, model, context, opts, deps = {}) {
+    const delays = deps.delaysMs ?? CHAT_RETRY_BACKOFF_MS;
+    const doSleep = deps.sleepFn ?? sleepMs;
+    let attempt = 0;
+    for (;;) {
+        let assistant;
+        let errMsg;
+        let thrown;
+        try {
+            assistant = await complete(model, context, opts);
+            if (assistant.stopReason !== "error")
+                return assistant;
+            errMsg = assistant.errorMessage ?? "error";
+        }
+        catch (err) {
+            thrown = err;
+            errMsg = err instanceof Error ? err.message : String(err);
+        }
+        if (attempt >= delays.length || !isRetryableModelError(errMsg)) {
+            if (thrown !== undefined)
+                throw thrown; // preserve the original error
+            return assistant; // non-retryable / exhausted errored assistant
+        }
+        const delayMs = delays[attempt];
+        deps.onRetry?.({ attempt: attempt + 1, delayMs, reason: errMsg });
+        await doSleep(delayMs);
+        attempt++;
+    }
+}
+export class ChatRunner {
+    cfg;
+    sessionManager;
+    tools;
+    extraTools;
+    /** Concatenated tool list passed to pi-ai (github + extra). */
+    mergedTools;
+    /**
+     * Resolved lazily on the first chat turn. A bad chat model spec
+     * (unknown id) MUST NOT crash the whole harness — webhooks, crons and
+     * workflows don't depend on it.
+     */
+    model;
+    modelError;
+    chains = new Map();
+    constructor(cfg, sessionManager) {
+        this.cfg = cfg;
+        this.sessionManager = sessionManager;
+        if (cfg.github) {
+            this.tools = buildChatGitHubTools(cfg.github);
+        }
+        this.extraTools = cfg.extraTools;
+        const merged = [
+            ...(this.tools?.tools ?? []),
+            ...(this.extraTools?.tools ?? []),
+        ];
+        this.mergedTools = merged.length > 0 ? merged : undefined;
+    }
+    /**
+     * Dispatch a tool call to whichever toolset registered it. Github
+     * tools take precedence (they're registered first); fall back to the
+     * extra toolset for anything not in the github name set.
+     */
+    async dispatchTool(call) {
+        if (this.tools?.tools.some((t) => t.name === call.name)) {
+            return this.tools.execute(call);
+        }
+        if (this.extraTools?.tools.some((t) => t.name === call.name)) {
+            return this.extraTools.execute(call);
+        }
+        return {
+            content: JSON.stringify({ error: `unknown tool: ${call.name}` }),
+            isError: true,
+        };
+    }
+    resolveModelLazy() {
+        if (this.model)
+            return this.model;
+        if (this.modelError)
+            return undefined;
+        try {
+            this.model = resolveModel(this.cfg.model);
+            return this.model;
+        }
+        catch (err) {
+            this.modelError = err instanceof Error ? err.message : String(err);
+            console.error(`[chat] ${this.modelError}`);
+            return undefined;
+        }
+    }
+    /**
+     * Run one chat turn. Each messagingSessionId maps to a stable pi-ai
+     * `agentSessionId` (a UUID we mint on first turn) which the dashboard
+     * uses to look up the JSONL on disk.
+     */
+    async turn(messagingSessionId, prompt) {
+        const prev = this.chains.get(messagingSessionId) ?? Promise.resolve();
+        const next = prev
+            .catch(() => undefined)
+            .then(() => this.doTurn(messagingSessionId, prompt));
+        this.chains.set(messagingSessionId, next);
+        const cleanup = () => {
+            if (this.chains.get(messagingSessionId) === next) {
+                this.chains.delete(messagingSessionId);
+            }
+        };
+        next.then(cleanup, cleanup);
+        return next;
+    }
+    async doTurn(messagingSessionId, prompt) {
+        // Resolve (or mint) the stable agentSessionId pinned to this thread.
+        const session = this.sessionManager.getSession(messagingSessionId);
+        let agentSessionId = session?.agentSessionId || null;
+        if (!agentSessionId) {
+            agentSessionId = randomUUID();
+            this.sessionManager.setAgentSessionId(messagingSessionId, agentSessionId);
+        }
+        // Bail with a clear error if the chat model spec is unknown to pi-ai.
+        // Done here rather than in the constructor so a misconfigured chat
+        // model only fails chat turns, not the whole server.
+        const model = this.resolveModelLazy();
+        if (!model) {
+            return {
+                text: "",
+                agentSessionId,
+                tokens: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
+                costUsd: 0,
+                modelTurns: 0,
+                finish: "error",
+                errors: [this.modelError ?? "chat model not configured"],
+                assistantMessages: [],
+                toolResults: [],
+                modelId: this.cfg.model,
+            };
+        }
+        // Rehydrate conversation context from the DB. Messages were stored
+        // text-only on prior turns; we replay them as alternating user /
+        // assistant text messages. Tool calls/results inside a single turn
+        // never persist (they only live for that turn's loop) — that's a
+        // deliberate simplification: the agent gets a clean conversation
+        // history and can re-tool if asked again.
+        const history = this.sessionManager.getHistory(messagingSessionId, 50);
+        const messages = history.map((h) => textMessage(h.role, h.content, h.timestamp));
+        messages.push(textMessage("user", prompt, new Date().toISOString()));
+        const context = {
+            systemPrompt: this.cfg.systemPrompt,
+            messages,
+            tools: this.mergedTools,
+        };
+        const errors = [];
+        const assistantMessages = [];
+        const toolResults = [];
+        const opts = {
+            reasoning: pickReasoning(this.cfg.thinking),
+            timeoutMs: this.cfg.timeoutMs ?? 120_000,
+        };
+        let finish = "stop";
+        let tokensIn = 0;
+        let tokensOut = 0;
+        let cacheRead = 0;
+        let cacheWrite = 0;
+        let costUsd = 0;
+        let modelTurns = 0;
+        let finalText = "";
+        for (let round = 0; round < MAX_TOOL_ROUNDS + 1; round++) {
+            modelTurns++;
+            let assistant;
+            try {
+                assistant = await completeWithRetry(completeSimple, model, context, opts, {
+                    onRetry: ({ attempt, delayMs, reason }) => console.warn(`[chat] transient model error (retry ${attempt}/${CHAT_RETRY_BACKOFF_MS.length} ` +
+                        `in ${delayMs / 1000}s): ${reason}`),
+                });
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                errors.push(msg);
+                finish = "error";
+                break;
+            }
+            assistantMessages.push(assistant);
+            context.messages.push(assistant);
+            tokensIn += assistant.usage.input;
+            tokensOut += assistant.usage.output;
+            cacheRead += assistant.usage.cacheRead;
+            cacheWrite += assistant.usage.cacheWrite;
+            costUsd += assistant.usage.cost.total;
+            if (assistant.stopReason === "error" || assistant.stopReason === "aborted") {
+                errors.push(assistant.errorMessage ?? assistant.stopReason);
+                finish = "error";
+                break;
+            }
+            // Pull text out (last text block wins — same convention as pi-ai's run() helper).
+            const text = assistant.content
+                .filter((c) => c.type === "text" && typeof c.text === "string")
+                .map((c) => c.text)
+                .join("");
+            if (text)
+                finalText = text;
+            // Tool calls? Execute and loop.
+            const toolCalls = assistant.content.filter((c) => c.type === "toolCall");
+            if (toolCalls.length === 0) {
+                finish = "stop";
+                break;
+            }
+            if (!this.mergedTools) {
+                // Model emitted a tool call without any tools registered — shouldn't
+                // happen, but bail out rather than loop forever.
+                errors.push("Model called a tool, but no tools are registered for chat.");
+                finish = "error";
+                break;
+            }
+            for (const call of toolCalls) {
+                const { content, isError } = await this.dispatchTool(call);
+                const tr = {
+                    role: "toolResult",
+                    toolCallId: call.id,
+                    toolName: call.name,
+                    content: [{ type: "text", text: content }],
+                    isError,
+                    timestamp: Date.now(),
+                };
+                toolResults.push(tr);
+                context.messages.push(tr);
+                if (isError)
+                    errors.push(`${call.name}: ${content}`);
+            }
+            if (round === MAX_TOOL_ROUNDS) {
+                finish = "max-rounds";
+                errors.push(`Hit MAX_TOOL_ROUNDS (${MAX_TOOL_ROUNDS}); giving up on this turn.`);
+                break;
+            }
+        }
+        // Persist this turn's user + final assistant text. We do NOT persist
+        // tool calls or intermediate model responses — only the human-visible
+        // turn boundaries — to keep the rehydrated context compact.
+        this.sessionManager.addMessage(messagingSessionId, "user", prompt);
+        if (finalText) {
+            this.sessionManager.addMessage(messagingSessionId, "assistant", finalText);
+        }
+        this.sessionManager.touchSession(messagingSessionId);
+        return {
+            text: finalText,
+            agentSessionId,
+            tokens: {
+                input: tokensIn,
+                output: tokensOut,
+                cacheRead,
+                cacheWrite,
+            },
+            costUsd,
+            modelTurns,
+            finish,
+            errors,
+            assistantMessages,
+            toolResults,
+            modelId: this.cfg.model,
+        };
+    }
+}
+// ── Helpers ─────────────────────────────────────────────────────────
+function resolveModel(spec) {
+    const idx = spec.indexOf("/");
+    if (idx < 0)
+        throw new Error(`model spec must be 'provider/id', got '${spec}'`);
+    const provider = spec.slice(0, idx);
+    const modelId = spec.slice(idx + 1);
+    // pi-ai's getModel is typed against its static registry; at runtime it
+    // accepts arbitrary strings AND returns undefined for unknown ids rather
+    // than throwing. Without this guard the first chat turn crashes deep in
+    // the provider stack with "Cannot read properties of undefined (reading
+    // 'api')" — surface a clear, actionable error instead.
+    const model = getModel(provider, modelId);
+    if (!model) {
+        throw new Error(`Unknown chat model '${spec}'. pi-ai's registry has no '${modelId}' for provider '${provider}'. ` +
+            `Set LASTLIGHT_MODELS (or LASTLIGHT_MODEL) to a registered model id.`);
+    }
+    return model;
+}
+function textMessage(role, content, timestamp) {
+    const ts = parseTimestamp(timestamp);
+    if (role === "user") {
+        const m = { role: "user", content, timestamp: ts };
+        return m;
+    }
+    // Treat any non-user historical role as assistant text.
+    const m = {
+        role: "assistant",
+        content: [{ type: "text", text: content }],
+        api: "openai-completions",
+        provider: "history",
+        model: "history",
+        usage: zeroUsage(),
+        stopReason: "stop",
+        timestamp: ts,
+    };
+    return m;
+}
+function parseTimestamp(raw) {
+    const ms = Date.parse(raw);
+    return Number.isFinite(ms) ? ms : Date.now();
+}
+function zeroUsage() {
+    return {
+        input: 0,
+        output: 0,
+        cacheRead: 0,
+        cacheWrite: 0,
+        totalTokens: 0,
+        cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },
+    };
+}
+function pickReasoning(level) {
+    // pi-ai's SimpleStreamOptions.reasoning excludes "off" — pi-ai default
+    // is no reasoning, so we pass undefined for "off".
+    if (!level || level === "off")
+        return undefined;
+    return level;
+}
+/**
+ * Octokit is bundled here only because github-tools.ts imports it at module
+ * load. Re-export so callers can probe whether the integration is wired
+ * without round-tripping through that file. Typed as `unknown` to avoid
+ * dragging the Octokit type chain into the published .d.ts.
+ */
+export const __octokitForTest = Octokit;
+//# sourceMappingURL=chat-runner.js.map

package/dist/engine/chat-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-runner.js","sourceRoot":"","sources":["../../src/engine/chat-runner.ts"],"names":[],"mappings":"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"}

package/dist/engine/chat-runner.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/engine/chat-runner.test.js

@@ -0,0 +1,104 @@
+import { describe, it, expect, vi } from "vitest";
+import { completeWithRetry, isRetryableModelError } from "./chat-runner.js";
+// Minimal stand-ins — the helper only ever forwards these to `complete`.
+const model = {};
+const context = { messages: [] };
+const opts = {};
+function ok(text = "hi") {
+    return {
+        role: "assistant",
+        content: [{ type: "text", text }],
+        stopReason: "stop",
+        usage: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, cost: { total: 0 } },
+    };
+}
+function erroredAssistant(message) {
+    return {
+        role: "assistant",
+        content: [],
+        stopReason: "error",
+        errorMessage: message,
+        usage: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, cost: { total: 0 } },
+    };
+}
+const noSleep = () => Promise.resolve();
+const delays = [10, 20, 30];
+describe("isRetryableModelError", () => {
+    it("matches rate limits and transient server/network errors", () => {
+        for (const m of [
+            '429 {"error":{"code":"RATE_LIMIT_EXCEEDED"}}',
+            "You have exceeded your rate limit for this API",
+            "Error: overloaded_error",
+            "503 Service Unavailable",
+            "502 Bad Gateway",
+            "fetch failed",
+            "ETIMEDOUT",
+        ]) {
+            expect(isRetryableModelError(m)).toBe(true);
+        }
+    });
+    it("does NOT match auth / validation / overflow (non-transient)", () => {
+        for (const m of [
+            "401 Unauthorized",
+            "403 Resource not accessible by integration",
+            "400 invalid_request_error",
+            "context length exceeded",
+            "Unknown chat model",
+        ]) {
+            expect(isRetryableModelError(m)).toBe(false);
+        }
+    });
+});
+describe("completeWithRetry", () => {
+    it("returns immediately on success (no retries)", async () => {
+        const complete = vi.fn().mockResolvedValue(ok());
+        const onRetry = vi.fn();
+        const res = await completeWithRetry(complete, model, context, opts, { delaysMs: delays, sleepFn: noSleep, onRetry });
+        expect(res.stopReason).toBe("stop");
+        expect(complete).toHaveBeenCalledTimes(1);
+        expect(onRetry).not.toHaveBeenCalled();
+    });
+    it("retries a thrown 429 then succeeds, backing off per the schedule", async () => {
+        const complete = vi
+            .fn()
+            .mockRejectedValueOnce(new Error('429 {"code":"RATE_LIMIT_EXCEEDED"}'))
+            .mockResolvedValueOnce(ok("recovered"));
+        const slept = [];
+        const sleepFn = (ms) => { slept.push(ms); return Promise.resolve(); };
+        const res = await completeWithRetry(complete, model, context, opts, { delaysMs: delays, sleepFn });
+        expect(res.stopReason).toBe("stop");
+        expect(complete).toHaveBeenCalledTimes(2);
+        expect(slept).toEqual([10]); // first backoff only
+    });
+    it("retries an errored-assistant 429 (non-throw shape)", async () => {
+        const complete = vi
+            .fn()
+            .mockResolvedValueOnce(erroredAssistant("rate limit exceeded"))
+            .mockResolvedValueOnce(ok());
+        const res = await completeWithRetry(complete, model, context, opts, { delaysMs: delays, sleepFn: noSleep });
+        expect(res.stopReason).toBe("stop");
+        expect(complete).toHaveBeenCalledTimes(2);
+    });
+    it("does NOT retry a non-retryable thrown error", async () => {
+        const complete = vi.fn().mockRejectedValue(new Error("401 Unauthorized"));
+        await expect(completeWithRetry(complete, model, context, opts, { delaysMs: delays, sleepFn: noSleep })).rejects.toThrow("401");
+        expect(complete).toHaveBeenCalledTimes(1);
+    });
+    it("gives up after exhausting the backoff schedule and rethrows the last error", async () => {
+        const complete = vi.fn().mockRejectedValue(new Error("429 rate limit"));
+        const slept = [];
+        await expect(completeWithRetry(complete, model, context, opts, {
+            delaysMs: delays,
+            sleepFn: (ms) => { slept.push(ms); return Promise.resolve(); },
+        })).rejects.toThrow("429");
+        expect(complete).toHaveBeenCalledTimes(delays.length + 1); // initial + 3 retries
+        expect(slept).toEqual(delays);
+    });
+    it("returns the errored assistant unchanged when retries are exhausted (non-throw shape)", async () => {
+        const complete = vi.fn().mockResolvedValue(erroredAssistant("429 rate limit"));
+        const res = await completeWithRetry(complete, model, context, opts, { delaysMs: [5], sleepFn: noSleep });
+        expect(res.stopReason).toBe("error");
+        expect(complete).toHaveBeenCalledTimes(2); // initial + 1 retry, then surfaces the errored assistant
+    });
+});
+//# sourceMappingURL=chat-runner.test.js.map

package/dist/engine/chat-runner.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-runner.test.js","sourceRoot":"","sources":["../../src/engine/chat-runner.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAElD,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAE5E,yEAAyE;AACzE,MAAM,KAAK,GAAG,EAAgB,CAAC;AAC/B,MAAM,OAAO,GAAG,EAAE,QAAQ,EAAE,EAAE,EAAwB,CAAC;AACvD,MAAM,IAAI,GAAG,EAAyB,CAAC;AAEvC,SAAS,EAAE,CAAC,IAAI,GAAG,IAAI;IACrB,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QACjC,UAAU,EAAE,MAAM;QAClB,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;KACjD,CAAC;AACnC,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAe;IACvC,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,EAAE;QACX,UAAU,EAAE,OAAO;QACnB,YAAY,EAAE,OAAO;QACrB,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;KACjD,CAAC;AACnC,CAAC;AAED,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;AACxC,MAAM,MAAM,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;AAE5B,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;IACrC,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,KAAK,MAAM,CAAC,IAAI;YACd,8CAA8C;YAC9C,gDAAgD;YAChD,yBAAyB;YACzB,yBAAyB;YACzB,iBAAiB;YACjB,cAAc;YACd,WAAW;SACZ,EAAE,CAAC;YACF,MAAM,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACrE,KAAK,MAAM,CAAC,IAAI;YACd,kBAAkB;YAClB,4CAA4C;YAC5C,2BAA2B;YAC3B,yBAAyB;YACzB,oBAAoB;SACrB,EAAE,CAAC;YACF,MAAM,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,EAAE,CAAC,6CAA6C,EAAE,KAAK,IAAI,EAAE;QAC3D,MAAM,QAAQ,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,EAAE,CAAC,CAAC;QACjD,MAAM,OAAO,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QACxB,MAAM,GAAG,GAAG,MAAM,iBAAiB,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;QACrH,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACpC,MAAM,CAAC,QAAQ,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QAC1C,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kEAAkE,EAAE,KAAK,IAAI,EAAE;QAChF,MAAM,QAAQ,GAAG,EAAE;aAChB,EAAE,EAAE;aACJ,qBAAqB,CAAC,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;aACtE,qBAAqB,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC;QAC1C,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,CAAC,EAAU,EAAE,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;QAC9E,MAAM,GAAG,GAAG,MAAM,iBAAiB,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;QACnG,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACpC,MAAM,CAAC,QAAQ,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QAC1C,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,qBAAqB;IACpD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,KAAK,IAAI,EAAE;QAClE,MAAM,QAAQ,GAAG,EAAE;aAChB,EAAE,EAAE;aACJ,qBAAqB,CAAC,gBAAgB,CAAC,qBAAqB,CAAC,CAAC;aAC9D,qBAAqB,CAAC,EAAE,EAAE,CAAC,CAAC;QAC/B,MAAM,GAAG,GAAG,MAAM,iBAAiB,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;QAC5G,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACpC,MAAM,CAAC,QAAQ,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,KAAK,IAAI,EAAE;QAC3D,MAAM,QAAQ,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC,CAAC;QAC1E,MAAM,MAAM,CACV,iBAAiB,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAC1F,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACzB,MAAM,CAAC,QAAQ,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4EAA4E,EAAE,KAAK,IAAI,EAAE;QAC1F,MAAM,QAAQ,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC;QACxE,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,MAAM,MAAM,CACV,iBAAiB,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE;YAChD,QAAQ,EAAE,MAAM;YAChB,OAAO,EAAE,CAAC,EAAE,EAAE,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;SAC/D,CAAC,CACH,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACzB,MAAM,CAAC,QAAQ,CAAC,CAAC,qBAAqB,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,sBAAsB;QACjF,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sFAAsF,EAAE,KAAK,IAAI,EAAE;QACpG,MAAM,QAAQ,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,gBAAgB,CAAC,gBAAgB,CAAC,CAAC,CAAC;QAC/E,MAAM,GAAG,GAAG,MAAM,iBAAiB,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;QACzG,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACrC,MAAM,CAAC,QAAQ,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAAC,yDAAyD;IACtG,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/engine/chat-skills.d.ts

@@ -0,0 +1,45 @@
+import type { Tool, ToolCall } from "@earendil-works/pi-ai";
+/**
+ * Minimal subset of pi-coding-agent's `Skill` shape — only the fields
+ * the chat catalogue + read tool actually use.
+ */
+export interface ChatSkill {
+    name: string;
+    description: string;
+    filePath: string;
+}
+/**
+ * Skills exposed to chat threads. `chat` is the always-on persona;
+ * the others let chat assist with one-off lookups that map to these
+ * domains without delegating to a full workflow run.
+ */
+export declare const CHAT_SKILL_NAMES: readonly ["chat", "issue-triage", "pr-review", "repo-health"];
+export interface ChatSkillCatalogue {
+    /** Skills the chat agent can read on demand, keyed by name. */
+    skills: ChatSkill[];
+    /**
+     * XML block describing each skill (name + description) suitable for
+     * prepending to the chat system prompt. Empty string if no skills
+     * resolved cleanly.
+     */
+    catalogueXml: string;
+}
+/**
+ * Load the curated chat skill catalogue from `<repo>/skills/`.
+ * Skills missing `name` or `description` frontmatter are silently
+ * dropped, matching pi-coding-agent's behaviour on the sandbox path.
+ */
+export declare function loadChatSkillCatalogue(): ChatSkillCatalogue;
+/**
+ * Build the `read_skill` tool that chat uses to pull a SKILL.md on
+ * demand. Returns the pi-ai `Tool` definition plus a name-keyed
+ * dispatcher the chat-runner's toolset can merge into its `execute`.
+ */
+export interface ReadSkillToolset {
+    tool: Tool;
+    execute(call: ToolCall): {
+        content: string;
+        isError: boolean;
+    };
+}
+export declare function buildReadSkillTool(skills: ChatSkill[]): ReadSkillToolset;