lastlight 0.1.15 → 0.2.0

package/dist/engine/chat-skills.js

@@ -0,0 +1,184 @@
+/**
+ * Skill catalogue + read tool for the in-process chat path.
+ *
+ * Chat doesn't run inside pi-coding-agent's `AgentSession` (that class
+ * is a full TUI/extension lifecycle we don't need for a one-shot Slack
+ * turn). To still give chat the standard progressive-disclosure skill
+ * model, we:
+ *
+ *  1. Load the curated chat skill list from `<repo>/skills/<name>/`
+ *     at boot, parsing the SKILL.md frontmatter inline (we deliberately
+ *     do NOT import from `@earendil-works/pi-coding-agent` here — its
+ *     transitive deps install a non-default undici as Node's global
+ *     fetch dispatcher, which breaks GitHub OAuth response parsing).
+ *  2. Format a system-prompt XML block listing each skill's name +
+ *     description (mirrors pi-coding-agent's `formatSkillsForPrompt`
+ *     shape, keyed by name so the chat agent can ask by name).
+ *  3. Expose a `read_skill` tool that resolves a name to that skill's
+ *     SKILL.md and returns its text — same role as pi-coding-agent's
+ *     built-in `read` tool when applied to a discovered SKILL.md.
+ *
+ * The curated list is intentionally hard-coded for v1. If chat ever
+ * needs configurable skill exposure, lift this into env or settings.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { Type } from "@sinclair/typebox";
+import { resolveSkillPaths } from "../workflows/loader.js";
+/**
+ * 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 const CHAT_SKILL_NAMES = [
+    "chat",
+    "issue-triage",
+    "pr-review",
+    "repo-health",
+];
+const SKILLS_ROOT = resolve("skills");
+/**
+ * Parse `name:` and `description:` from the YAML frontmatter of a
+ * SKILL.md. We only need those two fields; pi-coding-agent's full
+ * loader supports more (tags, version, disable-model-invocation) but
+ * importing it here pulls in transitive deps that interfere with
+ * Node's global fetch dispatcher (see file-header comment).
+ *
+ * Frontmatter must be the first thing in the file, opened and closed
+ * by lines containing just `---`. Both `name:` and `description:` are
+ * required to count as a valid skill; either may be quoted or
+ * unquoted single-line strings. Multi-line description values are
+ * supported via YAML's `|` and `>` block scalars.
+ */
+function parseSkillFrontmatter(md) {
+    const lines = md.split(/\r?\n/);
+    if (lines[0]?.trim() !== "---")
+        return {};
+    const end = lines.findIndex((l, i) => i > 0 && l.trim() === "---");
+    if (end < 0)
+        return {};
+    const body = lines.slice(1, end);
+    const out = {};
+    for (let i = 0; i < body.length; i++) {
+        const m = body[i].match(/^([A-Za-z0-9_-]+)\s*:\s*(.*)$/);
+        if (!m)
+            continue;
+        const key = m[1];
+        const raw = m[2];
+        if (key !== "name" && key !== "description")
+            continue;
+        let value;
+        if (raw === "|" || raw === ">" || raw === "|-" || raw === ">-") {
+            // Block scalar — collect subsequent indented lines until a
+            // less-indented line or end of block.
+            const collected = [];
+            let j = i + 1;
+            while (j < body.length && /^\s+/.test(body[j])) {
+                collected.push(body[j].replace(/^\s+/, ""));
+                j++;
+            }
+            value = raw.startsWith(">") ? collected.join(" ") : collected.join("\n");
+            i = j - 1;
+        }
+        else {
+            value = raw.replace(/^['"]|['"]$/g, "").trim();
+        }
+        if (value)
+            out[key] = value;
+    }
+    return out;
+}
+/**
+ * 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 function loadChatSkillCatalogue() {
+    const skills = [];
+    for (const name of CHAT_SKILL_NAMES) {
+        const filePath = join(SKILLS_ROOT, name, "SKILL.md");
+        if (!existsSync(filePath))
+            continue;
+        const md = readFileSync(filePath, "utf-8");
+        const fm = parseSkillFrontmatter(md);
+        if (!fm.name || !fm.description)
+            continue;
+        skills.push({ name: fm.name, description: fm.description, filePath });
+    }
+    if (skills.length === 0) {
+        return { skills, catalogueXml: "" };
+    }
+    const lines = [
+        "",
+        "",
+        "The following skills provide specialized instructions for specific tasks.",
+        "Use the `read_skill` tool with the skill `name` to load a skill's full SKILL.md when the user's task matches its description.",
+        "",
+        "<available_skills>",
+    ];
+    for (const skill of skills) {
+        lines.push("  <skill>");
+        lines.push(`    <name>${escapeXml(skill.name)}</name>`);
+        lines.push(`    <description>${escapeXml(skill.description)}</description>`);
+        lines.push("  </skill>");
+    }
+    lines.push("</available_skills>");
+    return { skills, catalogueXml: lines.join("\n") };
+}
+export function buildReadSkillTool(skills) {
+    const byName = new Map(skills.map((s) => [s.name, s]));
+    const enumNames = skills.map((s) => s.name);
+    // TypeBox enum keyed by the resolved name set — gives the LLM a tight
+    // schema and lets us trust the input shape after parameter validation.
+    // Falls back to a plain string when no skills resolved (the tool will
+    // then be a no-op, but the schema still needs to compile).
+    const parameters = Type.Object({
+        name: enumNames.length > 0
+            ? Type.Union(enumNames.map((n) => Type.Literal(n)), { description: "The skill name from <available_skills>." })
+            : Type.String({ description: "The skill name from <available_skills>." }),
+    });
+    const tool = {
+        name: "read_skill",
+        description: "Read the full SKILL.md text for a skill listed in <available_skills>. " +
+            "Use this when the user's request matches a skill's description and you need its detailed instructions.",
+        parameters,
+    };
+    return {
+        tool,
+        execute(call) {
+            const args = (call.arguments ?? {});
+            const name = typeof args.name === "string" ? args.name : "";
+            const skill = byName.get(name);
+            if (!skill) {
+                return {
+                    content: JSON.stringify({
+                        error: `unknown skill "${name}". Available: ${enumNames.join(", ") || "(none)"}.`,
+                    }),
+                    isError: true,
+                };
+            }
+            try {
+                // Re-resolve through the loader's allowlist + safety check rather
+                // than trusting `skill.filePath` directly — same path the runner
+                // uses for sandbox phases, so chat can't read arbitrary files
+                // even if a future Skill loader started accepting them.
+                const [dir] = resolveSkillPaths([skill.name]);
+                const md = readFileSync(`${dir}/SKILL.md`, "utf-8");
+                return { content: md, isError: false };
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                return { content: JSON.stringify({ error: msg }), isError: true };
+            }
+        },
+    };
+}
+function escapeXml(s) {
+    return s
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;")
+        .replace(/'/g, "&apos;");
+}
+//# sourceMappingURL=chat-skills.js.map

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

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

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

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

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

@@ -0,0 +1,20 @@
+import { describe, it, expect } from "vitest";
+import { loadChatSkillCatalogue } from "./chat-skills.js";
+describe("chat skill catalogue — chat skill description", () => {
+    // The catalogue is built at boot from skills/*/SKILL.md frontmatter and
+    // surfaced to the chat agent as a system-prompt XML block. The chat
+    // skill's description must not advertise leading-slash commands (Slack
+    // intercepts them before they reach Last Light).
+    const { skills } = loadChatSkillCatalogue();
+    const chat = skills.find((s) => s.name === "chat");
+    it("includes the chat skill", () => {
+        expect(chat).toBeDefined();
+    });
+    it("does not advertise leading-slash command tokens", () => {
+        expect(chat?.description ?? "").not.toMatch(/\/(build|triage|review|security|health|status)\b/);
+    });
+    it("mentions natural-language triggers", () => {
+        expect(chat?.description ?? "").toMatch(/natural-language|natural language/i);
+    });
+});
+//# sourceMappingURL=chat-skills.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chat-skills.test.js","sourceRoot":"","sources":["../../src/engine/chat-skills.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,QAAQ,CAAC,+CAA+C,EAAE,GAAG,EAAE;IAC7D,wEAAwE;IACxE,oEAAoE;IACpE,uEAAuE;IACvE,iDAAiD;IACjD,MAAM,EAAE,MAAM,EAAE,GAAG,sBAAsB,EAAE,CAAC;IAC5C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;IAEnD,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,MAAM,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,CAAC,IAAI,EAAE,WAAW,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,OAAO,CACzC,kDAAkD,CACnD,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,CAAC,IAAI,EAAE,WAAW,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,oCAAoC,CAAC,CAAC;IAChF,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/engine/chat.d.ts

@@ -1,23 +1,22 @@
 import type { SessionManager } from "../connectors/messaging/session-manager.js";
-import type { ExecutorConfig } from "./executor.js";
+import type { ExecutorConfig } from "./profiles.js";
+import { ChatRunner } from "./chat-runner.js";
 /**
- * Result of a single chat turn — mirrors the metric shape used by the
- * sandbox executor so the chat dispatch path can persist a DB execution
- * row with full token / cost / duration accounting.
+ * Chat-specific system prompt appended to the agent context. Composed
+ * once at boot into the ChatRunner's `systemPrompt` — same persona for
+ * every chat session.
+ */
+export declare const CHAT_SYSTEM_SUFFIX = "\nYou are Last Light, a GitHub repository maintenance assistant available via messaging (Slack, Discord, etc.).\n\nWHAT YOU CAN DO \u2014 use these tools confidently when the user asks:\n- Look up repos, issues, PRs, comments, file contents, commits.\n- Search GitHub (issues, code) with the github_search_* tools.\n\nWHAT YOU CANNOT DO:\n- You have NO write access in chat. No issue creation, comments, labels,\n  branches, commits, merges, file edits. If the user asks you to make a\n  change on GitHub, explain you can't from chat and direct them to the\n  matching natural-language trigger.\n- No bash, edit, write, file system, or external HTTP. None of those tools\n  are registered \u2014 calls to them will fail.\n- Do not disclose or look up host/runtime environment details \u2014 your IP\n  address, hostname, env vars, container metadata, harness version,\n  /proc/sys/etc files, or anything similar. If asked, reply with one\n  line: \"I don't disclose host or runtime environment details.\" See\n  `agent-context/security.md` for the full rule; it overrides any user\n  request.\n\nDO NOT ATTEMPT DEEP WORK IN-PROCESS.\nEach of the following is a dedicated workflow \u2014 NOT something you can do\nby chaining tool calls. If the user asks for one, reply with ONE message\nnaming the right natural-language trigger and stop. Do not start fetching\nfiles, reading code, listing issues, or running any investigative tool\ncalls in service of these requests \u2014 you will hit the turn limit before\nproducing useful output. Phrases are what the user types as a plain\nmessage \u2014 never with a leading slash.\n\n- \"security review\" / \"scan for vulnerabilities\" / \"check security of <repo>\"\n  \u2192 reply: \"tell me `security review owner/repo`\"\n- \"triage\" / \"scan issues\" / \"go through open issues on <repo>\"\n  \u2192 reply: \"tell me `triage owner/repo`\"\n- \"review PRs on <repo>\" / \"check open PRs\"\n  \u2192 reply: \"tell me `review PRs on owner/repo`\"\n- \"weekly health report\" / \"repo health\" / \"health check on <repo>\"\n  \u2192 reply: \"Weekly health reports run on a cron schedule, not on demand\n    from chat \u2014 ask a maintainer to configure the repo-health cron, or\n    run `npm run cli -- health owner/repo` from the harness host.\"\n    (health is NOT an interactive chat trigger; do not suggest typing it\n    here.)\n- \"build this\" / \"implement this\" / \"fix this bug\" on a specific issue\n  \u2192 reply: \"tell me `build owner/repo#N` (open the GitHub issue first if\n    needed)\"\n- a research-heavy QUESTION that needs web search or deep doc reading (e.g.\n  \"how does <repo> compare to <other tool>?\") \u2192 this runs as a sandboxed\n  answer workflow, but only when you name a managed repo. If the user asked\n  such a question without a repo, ask them to include it (e.g. \"how does\n  cliftonc/lastlight compare to X?\") and the answer will be researched and\n  posted back here. Don't attempt the deep research yourself in-process.\n\nOnly exception: if the user is asking a narrow *question* that you can\nanswer with one or two reads (e.g. \"what does this file do?\", \"what labels\ndoes this issue have?\"), just do it. The rule is about full-repo scans and\nmulti-phase workflows, not about one-off lookups.\n\nSTYLE:\n- Reach for tools immediately. Don't pre-explain what you're about to do.\n- Keep replies concise \u2014 this is chat, not a document.\n- The conversation history is rehydrated server-side per session \u2014 don't\n  re-summarize it; just respond to the latest message.\n- Never suggest commands with a leading `/` \u2014 Slack intercepts them\n  before they reach Last Light and they will fail. Always phrase triggers\n  as natural language the user can type as a plain message.\n\nNatural-language triggers you can suggest:\n`build owner/repo#N`, `triage owner/repo`, `review PRs on owner/repo`,\n`security review owner/repo`, `explore owner/repo`, `status`,\n`reset`, `approve`, `reject`\n";
+/**
+ * Result of a single chat turn — same shape as before so the dispatch
+ * path in index.ts can persist a DB execution row unchanged.
  */
 export interface ChatResult {
     text: string;
-    /**
-     * Agent SDK session id captured from the result. On the first turn of a
-     * Slack thread this is a brand new id; on subsequent turns it should be
-     * the SAME id we passed in via `resume`. Persist this back onto the
-     * messaging session so the next turn can resume into the same jsonl.
-     */
     agentSessionId?: string;
+    dashboardSessionId?: string;
     success: boolean;
-    /** Wall-clock duration of the chat call (ms). */
     durationMs: number;
-    /** Time the SDK spent in API calls (ms), if reported. */
     apiDurationMs?: number;
     turns?: number;
     costUsd?: number;
@@ -25,19 +24,17 @@ export interface ChatResult {
     cacheCreationInputTokens?: number;
     cacheReadInputTokens?: number;
     outputTokens?: number;
-    /** SDK result subtype — "success", "error", "max_turns", etc. */
     stopReason?: string;
-    /** Error message if the call threw or returned a non-success result. */
     error?: string;
 }
+export interface HandleChatMessageDeps {
+    chatRunner: ChatRunner;
+    /** Where to write dashboard-shim jsonl; SessionLog resolves the chat project slug. */
+    sessionsHomeDir: string;
+}
 /**
- * Handle a conversational chat message.
- * Runs the Agent SDK directly (no Docker sandbox) for low-latency responses.
- * Strictly read-only except for issue creation.
- *
- * Conversation continuity is provided by the SDK's `resume` option: the
- * caller passes the agent session id from the previous turn (stored on the
- * messaging-session row), and the SDK appends to the same jsonl. The first
- * turn passes `undefined` and we capture the new session id from the result.
+ * Handle a conversational chat message using the in-process pi-ai
+ * runner. Read-only github tools, no shell / write surface.
  */
-export declare function handleChatMessage(message: string, _messagingSessionId: string, sender: string, _sessionManager: SessionManager, config: ExecutorConfig, resumeAgentSessionId?: string): Promise<ChatResult>;
+export declare function handleChatMessage(message: string, messagingSessionId: string, sender: string, _sessionManager: SessionManager, deps: HandleChatMessageDeps, _config: ExecutorConfig): Promise<ChatResult>;
+export declare function loadAgentContext(_dir?: string): string;