lastlight 0.1.8 → 0.2.0

package/dist/engine/llm.test.js

@@ -0,0 +1,189 @@
+import { describe, it, expect, afterEach, vi } from "vitest";
+import { callLlm, chat, defaultFastModel, resolveProvider } from "./llm.js";
+describe("resolveProvider", () => {
+    it("prefers explicit provider prefix", () => {
+        expect(resolveProvider("anthropic/claude-haiku-4-5")).toEqual({ provider: "anthropic", modelId: "claude-haiku-4-5" });
+        expect(resolveProvider("openai/gpt-4o-mini")).toEqual({ provider: "openai", modelId: "gpt-4o-mini" });
+    });
+    it("keeps the nested vendor/model tail for openrouter ids", () => {
+        expect(resolveProvider("openrouter/anthropic/claude-sonnet-4.5"))
+            .toEqual({ provider: "openrouter", modelId: "anthropic/claude-sonnet-4.5" });
+        expect(resolveProvider("openrouter/google/gemini-2.5-flash"))
+            .toEqual({ provider: "openrouter", modelId: "google/gemini-2.5-flash" });
+    });
+    it("infers from common naming for unprefixed model ids", () => {
+        expect(resolveProvider("claude-3-5-haiku")).toEqual({ provider: "anthropic", modelId: "claude-3-5-haiku" });
+        expect(resolveProvider("gpt-4o-mini")).toEqual({ provider: "openai", modelId: "gpt-4o-mini" });
+    });
+    it("falls back to openai for unrecognized bare ids", () => {
+        expect(resolveProvider("mystery-model")).toEqual({ provider: "openai", modelId: "mystery-model" });
+    });
+    it("throws on an explicit unsupported provider prefix instead of silently mis-routing", () => {
+        expect(() => resolveProvider("mistral/large-latest")).toThrow(/unsupported provider prefix "mistral"/);
+        expect(() => resolveProvider("google/gemini-pro")).toThrow(/unsupported provider prefix "google"/);
+    });
+});
+describe("defaultFastModel", () => {
+    const ORIGINAL_ENV = { ...process.env };
+    afterEach(() => { process.env = { ...ORIGINAL_ENV }; });
+    it("picks an OpenAI model when only OPENAI_API_KEY is set", () => {
+        delete process.env.ANTHROPIC_API_KEY;
+        process.env.OPENAI_API_KEY = "k";
+        delete process.env.OPENCODE_MODELS;
+        expect(defaultFastModel()).toMatch(/^openai\//);
+    });
+    it("picks an Anthropic model when only ANTHROPIC_API_KEY is set", () => {
+        process.env.ANTHROPIC_API_KEY = "k";
+        delete process.env.OPENAI_API_KEY;
+        delete process.env.OPENROUTER_API_KEY;
+        delete process.env.OPENCODE_MODELS;
+        expect(defaultFastModel()).toMatch(/^anthropic\//);
+    });
+    it("picks an OpenRouter model when only OPENROUTER_API_KEY is set", () => {
+        delete process.env.ANTHROPIC_API_KEY;
+        delete process.env.OPENAI_API_KEY;
+        process.env.OPENROUTER_API_KEY = "sk-or-k";
+        delete process.env.OPENCODE_MODELS;
+        expect(defaultFastModel()).toMatch(/^openrouter\//);
+    });
+    it("prefers Anthropic over OpenRouter when both are set (avoids markup)", () => {
+        process.env.ANTHROPIC_API_KEY = "k";
+        process.env.OPENROUTER_API_KEY = "sk-or-k";
+        delete process.env.OPENAI_API_KEY;
+        delete process.env.OPENCODE_MODELS;
+        expect(defaultFastModel()).toMatch(/^anthropic\//);
+    });
+    it("uses the first registry provider when all keys are set", () => {
+        process.env.ANTHROPIC_API_KEY = "k";
+        process.env.OPENAI_API_KEY = "k";
+        process.env.OPENROUTER_API_KEY = "sk-or-k";
+        delete process.env.OPENCODE_MODELS;
+        expect(defaultFastModel()).toMatch(/^anthropic\//);
+    });
+    it("honors per-task OPENCODE_MODELS overrides", () => {
+        process.env.OPENAI_API_KEY = "k";
+        process.env.OPENCODE_MODELS = JSON.stringify({ classifier: "openai/custom-mini" });
+        expect(defaultFastModel("classifier")).toBe("openai/custom-mini");
+        expect(defaultFastModel("screener")).toMatch(/^openai\//);
+    });
+    it("ignores invalid OPENCODE_MODELS JSON", () => {
+        process.env.OPENAI_API_KEY = "k";
+        delete process.env.ANTHROPIC_API_KEY;
+        process.env.OPENCODE_MODELS = "not-json";
+        expect(defaultFastModel("classifier")).toMatch(/^openai\//);
+    });
+});
+describe("chat", () => {
+    const ORIGINAL_ENV = { ...process.env };
+    afterEach(() => {
+        vi.restoreAllMocks();
+        process.env = { ...ORIGINAL_ENV };
+    });
+    it("throws when the relevant API key is missing", async () => {
+        delete process.env.ANTHROPIC_API_KEY;
+        await expect(chat("anthropic/claude-haiku-4-5", [{ role: "system", content: "sys" }, { role: "user", content: "hi" }])).rejects.toThrow(/ANTHROPIC_API_KEY/);
+        delete process.env.OPENAI_API_KEY;
+        await expect(chat("openai/gpt-4o-mini", [{ role: "system", content: "sys" }, { role: "user", content: "hi" }])).rejects.toThrow(/OPENAI_API_KEY/);
+        delete process.env.OPENROUTER_API_KEY;
+        await expect(chat("openrouter/google/gemini-2.5-flash", [{ role: "system", content: "sys" }, { role: "user", content: "hi" }])).rejects.toThrow(/OPENROUTER_API_KEY/);
+    });
+    it("hits the Anthropic endpoint and extracts text from content blocks", async () => {
+        process.env.ANTHROPIC_API_KEY = "test-key";
+        const fetchMock = vi.spyOn(globalThis, "fetch").mockResolvedValueOnce(new Response(JSON.stringify({
+            content: [
+                { type: "text", text: "hello " },
+                { type: "text", text: "world" },
+                { type: "tool_use", text: "ignored" },
+            ],
+        }), { status: 200, headers: { "content-type": "application/json" } }));
+        const out = await chat("claude-haiku-4-5", [{ role: "system", content: "sys" }, { role: "user", content: "user" }]);
+        expect(out).toBe("hello world");
+        expect(fetchMock).toHaveBeenCalledTimes(1);
+        const [url, init] = fetchMock.mock.calls[0];
+        expect(url).toBe("https://api.anthropic.com/v1/messages");
+        expect(init.headers).toMatchObject({ "x-api-key": "test-key" });
+        const body = JSON.parse(init.body);
+        expect(body.model).toBe("claude-haiku-4-5");
+        expect(body.system).toBe("sys");
+        expect(body.messages).toEqual([{ role: "user", content: "user" }]);
+    });
+    it("hits the OpenAI endpoint and extracts choices[0].message.content", async () => {
+        process.env.OPENAI_API_KEY = "test-key";
+        const fetchMock = vi.spyOn(globalThis, "fetch").mockResolvedValueOnce(new Response(JSON.stringify({
+            choices: [{ message: { content: "ok" } }],
+        }), { status: 200, headers: { "content-type": "application/json" } }));
+        const out = await chat("openai/gpt-4o-mini", [{ role: "system", content: "sys" }, { role: "user", content: "user" }]);
+        expect(out).toBe("ok");
+        expect(fetchMock).toHaveBeenCalledTimes(1);
+        const [url, init] = fetchMock.mock.calls[0];
+        expect(url).toBe("https://api.openai.com/v1/chat/completions");
+        expect(init.headers).toMatchObject({ authorization: "Bearer test-key" });
+        const body = JSON.parse(init.body);
+        expect(body.model).toBe("gpt-4o-mini");
+        expect(body.max_completion_tokens).toBe(256);
+        expect(body.max_tokens).toBeUndefined();
+        expect(body.messages).toEqual([
+            { role: "system", content: "sys" },
+            { role: "user", content: "user" },
+        ]);
+    });
+    it("hits the OpenRouter endpoint, sends the nested vendor/model tail, and uses max_tokens", async () => {
+        process.env.OPENROUTER_API_KEY = "sk-or-test";
+        const fetchMock = vi.spyOn(globalThis, "fetch").mockResolvedValueOnce(new Response(JSON.stringify({
+            choices: [{ message: { content: "routed" } }],
+        }), { status: 200, headers: { "content-type": "application/json" } }));
+        const out = await chat("openrouter/anthropic/claude-sonnet-4.5", [{ role: "system", content: "sys" }, { role: "user", content: "user" }]);
+        expect(out).toBe("routed");
+        expect(fetchMock).toHaveBeenCalledTimes(1);
+        const [url, init] = fetchMock.mock.calls[0];
+        expect(url).toBe("https://openrouter.ai/api/v1/chat/completions");
+        expect(init.headers).toMatchObject({ authorization: "Bearer sk-or-test" });
+        const body = JSON.parse(init.body);
+        // The "openrouter/" prefix is stripped but the nested vendor/model tail
+        // is preserved verbatim — that's the id OpenRouter's API expects.
+        expect(body.model).toBe("anthropic/claude-sonnet-4.5");
+        // OpenRouter forwards to many providers — use the cross-provider field,
+        // not OpenAI's newer `max_completion_tokens`.
+        expect(body.max_tokens).toBe(256);
+        expect(body.max_completion_tokens).toBeUndefined();
+        expect(body.messages).toEqual([
+            { role: "system", content: "sys" },
+            { role: "user", content: "user" },
+        ]);
+    });
+    it("throws on non-2xx upstream after exhausting the retry", async () => {
+        process.env.OPENAI_API_KEY = "test-key";
+        const fetchMock = vi.spyOn(globalThis, "fetch")
+            .mockResolvedValueOnce(new Response("rate limited", { status: 429 }))
+            .mockResolvedValueOnce(new Response("rate limited", { status: 429 }));
+        await expect(chat("openai/gpt-4o-mini", [{ role: "system", content: "s" }, { role: "user", content: "u" }])).rejects.toThrow(/429/);
+        expect(fetchMock).toHaveBeenCalledTimes(2);
+    });
+    it("retries transient 429/5xx once and returns the second response", async () => {
+        process.env.OPENAI_API_KEY = "test-key";
+        const fetchMock = vi.spyOn(globalThis, "fetch")
+            .mockResolvedValueOnce(new Response("rate limited", { status: 429 }))
+            .mockResolvedValueOnce(new Response(JSON.stringify({ choices: [{ message: { content: "ok" } }] }), {
+            status: 200,
+            headers: { "content-type": "application/json" },
+        }));
+        const out = await chat("openai/gpt-4o-mini", [{ role: "system", content: "s" }, { role: "user", content: "u" }]);
+        expect(out).toBe("ok");
+        expect(fetchMock).toHaveBeenCalledTimes(2);
+    });
+    it("does not retry deterministic 4xx errors (e.g. 400 bad request)", async () => {
+        process.env.OPENAI_API_KEY = "test-key";
+        const fetchMock = vi.spyOn(globalThis, "fetch").mockResolvedValueOnce(new Response("bad model id", { status: 400 }));
+        await expect(chat("openai/gpt-4o-mini", [{ role: "system", content: "s" }, { role: "user", content: "u" }])).rejects.toThrow(/400/);
+        expect(fetchMock).toHaveBeenCalledTimes(1);
+    });
+    it("callLlm delegates to chat-equivalent behavior", async () => {
+        process.env.OPENAI_API_KEY = "test-key";
+        vi.spyOn(globalThis, "fetch").mockResolvedValueOnce(new Response(JSON.stringify({ choices: [{ message: { content: "delegated" } }] }), {
+            status: 200,
+            headers: { "content-type": "application/json" },
+        }));
+        await expect(callLlm("openai/gpt-4o-mini", "s", "u")).resolves.toBe("delegated");
+    });
+});
+//# sourceMappingURL=llm.test.js.map

package/dist/engine/llm.test.js.map

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

package/dist/engine/profiles.d.ts

@@ -0,0 +1,249 @@
+import type { GitHubTokenPermissions } from "./git-auth.js";
+import type { BuildAssetsLocation, OtelConfig, SandboxBackend } from "../config.js";
+/**
+ * Configuration for an agent execution.
+ */
+export interface ExecutorConfig {
+    /** Working directory for the agent (used by the no-sandbox path). */
+    cwd?: string;
+    /** Maximum conversation turns. Unused by agentic-pi; kept for API stability. */
+    maxTurns?: number;
+    /** Model id (e.g. "anthropic/claude-sonnet-4-6"). */
+    model?: string;
+    /**
+     * Pi thinking level: `off | minimal | low | medium | high | xhigh`.
+     * Forwarded to agentic-pi as the `thinking` option. When omitted,
+     * agentic-pi uses the model's default.
+     */
+    variant?: string;
+    /** Path to agent context directory. */
+    agentContextDir?: string;
+    /** Directory for persistent state. */
+    stateDir?: string;
+    /** Directory for agent sandboxes (cloned repos). */
+    sandboxDir?: string;
+    /** Where the shim writes dashboard envelope jsonl. */
+    sessionsDir?: string;
+    /** Workflow sandbox backend (overrides config-level default). */
+    sandbox?: SandboxBackend;
+    /**
+     * Which docker sandbox image this phase runs in: `"qa"` selects the
+     * browser-QA image (Playwright + Chromium), anything else the lean default.
+     * Overlaid per-phase from `sandbox_image:` by `phaseConfigFor`; only acted on
+     * by the docker path.
+     */
+    sandboxImage?: "default" | "qa";
+    /**
+     * Where build handoff docs live for this run:
+     *   - "repo" (default): the agent writes/commits `.lastlight/<issueKey>/`
+     *     into the target repo branch; the stage-in/harvest seam is skipped.
+     *   - "server": docs are staged in from / harvested back to the server store
+     *     under `buildAssetsDir`, never committed. Set from the runtime config.
+     */
+    buildAssets?: BuildAssetsLocation;
+    /** Filesystem root for the server-mode build-assets store (when buildAssets === "server"). */
+    buildAssetsDir?: string;
+    /**
+     * Server-mode artifact identity for this run. Used by the stage-in/harvest
+     * seam to locate the run's docs in the store at
+     * `<buildAssetsDir>/<owner>/<repo>/<issueKey>/`. Set per run from simple.ts.
+     */
+    buildAssetsKey?: {
+        owner: string;
+        repo: string;
+        issueKey: string;
+    };
+    /**
+     * Bypass the HTTP egress allowlist for this phase. When true:
+     *   - gondolin: `allowedHttpHosts: ["*"]` is passed to agentic-pi.
+     *   - docker:   the sandbox container uses the open CoreDNS/nginx
+     *               egress-firewall pair instead of the strict one.
+     *
+     * Default false. Set via the `unrestricted_egress` field on a workflow
+     * phase — used for phases that need broad web access (e.g. an explore
+     * phase that searches third-party documentation).
+     */
+    unrestrictedEgress?: boolean;
+    /**
+     * Enable agentic-pi's web-search extension (`web_search` / `web_fetch`
+     * tools). Default false. agentic-pi auto-enables web search whenever a
+     * provider env var (`TAVILY_API_KEY`, `BRAVE_SEARCH_API_KEY`,
+     * `EXA_API_KEY`) is present, so we pass an explicit `false` downstream
+     * to suppress auto-enable for non-explore workflows.
+     */
+    webSearch?: boolean;
+    /**
+     * Force a specific web-search provider. When unset, agentic-pi picks
+     * one based on which API key env var is present (Tavily > Exa > Brave).
+     */
+    webSearchProvider?: "tavily" | "brave" | "exa";
+    /** Controls OTEL env forwarding and PI event redaction for workflow phase runs. */
+    otel?: OtelConfig;
+    telemetry?: {
+        workflowName?: string;
+        phaseName?: string;
+        triggerId?: string;
+        workflowRunId?: string;
+    };
+    /**
+     * Absolute host paths to skill directories (each containing SKILL.md
+     * plus optional scripts/, references/, assets/). Staged into a per-phase
+     * bundle at `.lastlight-skills/<phaseName>/<basename>/` before the agent
+     * runs — gondolin/none via symlink, docker via copy — and passed to pi
+     * explicitly (`--skill` in docker, `skillPaths` in-process). cwd stays the
+     * repo; the bundle is a workspace-root sibling of the repo (never committed)
+     * on docker/none, and under the repo + local `.git/info/exclude` on gondolin
+     * (which mounts only cwd). Keyed per phase so parallel phases stay isolated.
+     * Resolved by `phaseConfigFor` in the workflow runner from the phase's
+     * `skill:`/`skills:` field.
+     */
+    skillPaths?: string[];
+}
+/**
+ * Normalized status of one agentic-pi extension for a single run.
+ * Keyed by extension name ("file-search" | "github" | "web-search") in
+ * an {@link ExtensionStatusMap}. agentic-pi emits these as `extension_status`
+ * events at run start and on `RunResult.{fileSearch,github,webSearch}`;
+ * lastlight captures them so the dashboard and logs show which extensions
+ * (e.g. FFF file-search) were actually active.
+ */
+export interface ExtensionStatus {
+    /** "configured" when the extension loaded, "skipped" otherwise. */
+    status: string;
+    /** file-search only: "override" | "tools-only" | "tools-and-ui". */
+    mode?: string;
+    /** web-search only: the resolved search provider. */
+    provider?: string;
+    /** Number of tools the extension registered. */
+    toolCount?: number;
+    /** Why it was skipped (e.g. "no-credentials", "resolve-failed"). */
+    reason?: string;
+}
+export type ExtensionStatusMap = Record<string, ExtensionStatus>;
+/**
+ * One skill agentic-pi discovered for a run, flattened from the
+ * `skills_status` event's `skills[]`. Mirrors agentic-pi's `SkillSummary`.
+ */
+export interface SkillSummary {
+    /** Skill name (from SKILL.md frontmatter). */
+    name: string;
+    /** Absolute path to the skill's SKILL.md. */
+    source: string;
+    /**
+     * Whether the model can auto-invoke it. False when the skill set
+     * `disable-model-invocation: true` — present but not surfaced in the
+     * system prompt, so worth flagging in the dashboard.
+     */
+    modelInvocable: boolean;
+}
+/**
+ * Normalized status of agentic-pi's skill discovery for a single run — the
+ * skill-loading counterpart to {@link ExtensionStatus} (tool loading).
+ * agentic-pi (≥0.2.6) emits this as a single, gated `skills_status` event at
+ * run start: present only when skills were configured (`skillPaths`/`noSkills`)
+ * or at least one was discovered, absent on a default run with no skills.
+ * lastlight captures it so the dashboard's phase-detail panel can show which
+ * skills the agent had available.
+ */
+export interface SkillsStatus {
+    /**
+     * "default" (rely on auto-discovery), "configured" (explicit `skillPaths`
+     * resolved), or "disabled" (`noSkills` with no explicit paths).
+     */
+    status: string;
+    /** Number of skills the resource loader actually discovered. */
+    discovered: number;
+    /** The discovered skills, flattened. */
+    skills: SkillSummary[];
+    /** Operator-mapped skill paths that resolved (echoed for observability). */
+    mappedPaths: string[];
+    /** Whether agentic-pi's default skill discovery was disabled. */
+    noSkills: boolean;
+}
+/**
+ * Result from an agent execution.
+ */
+export interface ExecutionResult {
+    success: boolean;
+    output: string;
+    turns: number;
+    error?: string;
+    durationMs: number;
+    /** Session id captured from the runtime's stream. */
+    sessionId?: string;
+    /** Total USD cost reported by the runtime. Zero under OAuth/subscription auth. */
+    costUsd?: number;
+    /** Tokens billed as fresh input (no cache hit). */
+    inputTokens?: number;
+    /** Tokens that triggered a cache write. */
+    cacheCreationInputTokens?: number;
+    /** Tokens served from prompt cache (heavily discounted). */
+    cacheReadInputTokens?: number;
+    /** Output tokens generated by the model. */
+    outputTokens?: number;
+    /** API-side duration (excludes orchestrator overhead). */
+    apiDurationMs?: number;
+    /** Mapped stop reason ("success" / "error_*" / etc.). */
+    stopReason?: string;
+    /**
+     * Which agentic-pi extensions were active for this run, keyed by name.
+     * Surfaced in the dashboard's phase-detail panel and persisted to the
+     * `executions.extension_status` column.
+     */
+    extensions?: ExtensionStatusMap;
+    /**
+     * Skill-loading status captured from agentic-pi's `skills_status` event.
+     * Surfaced alongside {@link extensions} in the dashboard's phase-detail
+     * panel and persisted to the `executions.skills_status` column. Undefined
+     * when the run reported no skills (the event is gated on the agentic-pi side).
+     */
+    skills?: SkillsStatus;
+}
+export type GitAccessProfile = "read" | "issues-write" | "review-write" | "repo-write";
+/**
+ * agentic-pi's GitHub extension uses the same four profile names — they
+ * pass through unchanged. Kept as an explicit map so renames on either
+ * side surface as a type error rather than a silent runtime mismatch.
+ */
+export declare const AGENTIC_PROFILE_FOR: Record<GitAccessProfile, string>;
+export interface GitSandboxAccess {
+    owner: string;
+    repo: string;
+    profile: GitAccessProfile;
+    /**
+     * When true, sandbox MCP can mint/refresh tokens using the app PEM.
+     * Leave false for lower-trust runs to keep private key material inaccessible.
+     */
+    allowMcpAppAuth?: boolean;
+    /**
+     * When set, the harness pre-clones the repo at this branch into the
+     * task's workspace before the sandbox container starts. The agent then
+     * sees the workspace already checked out — no `clone_repo` call needed
+     * inside the session. Used by read-only workflows (pr-review, pr-fix)
+     * that operate on an existing branch rather than creating one.
+     *
+     * Build-style workflows that create a new lastlight/* branch from main
+     * leave this unset — they start empty and let the agent set up the
+     * branch fresh.
+     */
+    prePopulateBranch?: string;
+    /**
+     * The owning workflow run id. Stamped into a `<workDir>/.lastlight-run`
+     * marker by the pre-clone so a reused per-PR workspace (see
+     * `workflowScopedTaskId` for pr-review / pr-fix) can tell "next phase of
+     * the same run" (preserve the checkout — build's plan.md lives here) from
+     * "a fresh run reusing an old PR dir" (fetch + hard-reset + clean, keeping
+     * node_modules warm). Unset for non-workflow callers, which keep the old
+     * skip-if-`.git`-exists behaviour.
+     */
+    runId?: string;
+    /**
+     * Clone shallowly (`--depth 1 --single-branch`). Set for read-only
+     * workflows that never need history; repo-write workflows (build, pr-fix,
+     * security-feedback) keep the deeper `--depth 50` clone so rebases / amends
+     * have headroom.
+     */
+    shallow?: boolean;
+}
+export declare const GITHUB_PERMISSION_PROFILES: Record<GitAccessProfile, GitHubTokenPermissions>;
+export declare function loadAgentContext(_dir?: string): string;

package/dist/engine/profiles.js

@@ -0,0 +1,42 @@
+import { loadAgentContext as loadResolvedAgentContext } from "../workflows/loader.js";
+/**
+ * agentic-pi's GitHub extension uses the same four profile names — they
+ * pass through unchanged. Kept as an explicit map so renames on either
+ * side surface as a type error rather than a silent runtime mismatch.
+ */
+export const AGENTIC_PROFILE_FOR = {
+    read: "read",
+    "issues-write": "issues-write",
+    "review-write": "review-write",
+    "repo-write": "repo-write",
+};
+export const GITHUB_PERMISSION_PROFILES = {
+    read: {
+        contents: "read",
+        issues: "read",
+        pull_requests: "read",
+        metadata: "read",
+    },
+    "issues-write": {
+        contents: "read",
+        issues: "write",
+        pull_requests: "read",
+        metadata: "read",
+    },
+    "review-write": {
+        contents: "read",
+        issues: "write",
+        pull_requests: "write",
+        metadata: "read",
+    },
+    "repo-write": {
+        contents: "write",
+        issues: "write",
+        pull_requests: "write",
+        metadata: "read",
+    },
+};
+export function loadAgentContext(_dir) {
+    return loadResolvedAgentContext();
+}
+//# sourceMappingURL=profiles.js.map

package/dist/engine/profiles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiles.js","sourceRoot":"","sources":["../../src/engine/profiles.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,IAAI,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AA6MtF;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAqC;IACnE,IAAI,EAAE,MAAM;IACZ,cAAc,EAAE,cAAc;IAC9B,cAAc,EAAE,cAAc;IAC9B,YAAY,EAAE,YAAY;CAC3B,CAAC;AA0CF,MAAM,CAAC,MAAM,0BAA0B,GAAqD;IAC1F,IAAI,EAAE;QACJ,QAAQ,EAAE,MAAM;QAChB,MAAM,EAAE,MAAM;QACd,aAAa,EAAE,MAAM;QACrB,QAAQ,EAAE,MAAM;KACjB;IACD,cAAc,EAAE;QACd,QAAQ,EAAE,MAAM;QAChB,MAAM,EAAE,OAAO;QACf,aAAa,EAAE,MAAM;QACrB,QAAQ,EAAE,MAAM;KACjB;IACD,cAAc,EAAE;QACd,QAAQ,EAAE,MAAM;QAChB,MAAM,EAAE,OAAO;QACf,aAAa,EAAE,OAAO;QACtB,QAAQ,EAAE,MAAM;KACjB;IACD,YAAY,EAAE;QACZ,QAAQ,EAAE,OAAO;QACjB,MAAM,EAAE,OAAO;QACf,aAAa,EAAE,OAAO;QACtB,QAAQ,EAAE,MAAM;KACjB;CACF,CAAC;AAEF,MAAM,UAAU,gBAAgB,CAAC,IAAa;IAC5C,OAAO,wBAAwB,EAAE,CAAC;AACpC,CAAC"}

package/dist/engine/router.d.ts

@@ -1,9 +1,14 @@
 import type { EventEnvelope } from "../connectors/types.js";
 import type { StateDb } from "../state/db.js";
-/** Skill name that should handle this event */
-export type RoutingResult = {
-    action: "skill";
-    skill: string;
+/**
+ * A routing decision — the single term for "what should process this event"
+ * is `handler`. It names either an in-process handler (chat, status-report,
+ * approval-response, …) or a workflow (issue-triage, pr-review, build, …);
+ * the dispatcher decides which. The router itself performs no side effects.
+ */
+export type Route = {
+    action: "handler";
+    handler: string;
     context: Record<string, unknown>;
 } | {
     action: "reply";
@@ -18,6 +23,7 @@ export interface RouterDeps {
 }
 /**
  * Event routing — deterministic for most events, LLM-classified for comments.
- * Maps normalized events to the skill that should handle them.
+ * Maps normalized events to the handler that should process them. Returns a
+ * decision only; the dispatcher performs the side effects.
  */
-export declare function routeEvent(envelope: EventEnvelope, deps?: RouterDeps): Promise<RoutingResult>;
+export declare function routeEvent(envelope: EventEnvelope, deps?: RouterDeps): Promise<Route>;