lastlight 0.16.0 → 0.16.2

package/dist/notify/notifier.js

@@ -1,100 +0,0 @@
-/**
- * `ProgressNotifier` — the concrete {@link ProgressReporter} the runner drives.
- *
- * It owns the current {@link ProgressModel}, re-renders once per mutation, and
- * fans the rendered markdown out to every wired transport's `publish()`. It
- * knows nothing about GitHub or Slack — that lives behind
- * {@link NotifierTransport}. Multiple transports can be attached (e.g. a
- * GitHub-triggered build that also mirrors to a Slack thread); each owns its
- * own in-place-update handle.
- *
- * Mutations are serialized through an in-flight chain so two quick transitions
- * can't race on `publish()` and post out of order (or double-create the
- * surface before the first create's handle is stored).
- */
-import { renderProgress } from "./render.js";
-import { setStep, upsertBefore } from "./model.js";
-export class ProgressNotifier {
-    model = null;
-    transports;
-    chain = Promise.resolve();
-    constructor(transports) {
-        this.transports = transports.filter(Boolean);
-    }
-    /** Serialize a mutation + publish so transitions can't interleave. */
-    enqueue(fn) {
-        this.chain = this.chain.then(fn, fn);
-        return this.chain;
-    }
-    async publish() {
-        if (!this.model)
-            return;
-        const model = this.model;
-        const body = renderProgress(model);
-        // Best-effort per transport — one platform failing must not block the other.
-        await Promise.all(this.transports.map((t) => t.publish(body, model).catch((err) => {
-            const m = err instanceof Error ? err.message : String(err);
-            console.warn(`[notifier] publish failed: ${m}`);
-        })));
-    }
-    start(model) {
-        return this.enqueue(async () => {
-            this.model = model;
-            await this.publish();
-        });
-    }
-    step(key, status, detail) {
-        return this.enqueue(async () => {
-            if (!this.model)
-                return;
-            this.model = { ...this.model, steps: setStep(this.model.steps, key, status, detail) };
-            await this.publish();
-        });
-    }
-    insertStep(step, beforeKey) {
-        return this.enqueue(async () => {
-            if (!this.model)
-                return;
-            this.model = { ...this.model, steps: upsertBefore(this.model.steps, step, beforeKey) };
-            await this.publish();
-        });
-    }
-    footer(markdown) {
-        return this.enqueue(async () => {
-            if (!this.model)
-                return;
-            const footer = markdown.trim() || undefined;
-            this.model = { ...this.model, footer };
-            await this.publish();
-        });
-    }
-    note(markdown) {
-        return this.noteTo(this.transports, markdown);
-    }
-    noteApproval(markdown, meta) {
-        return this.enqueue(async () => {
-            if (!markdown.trim() || this.transports.length === 0)
-                return;
-            await Promise.all(this.transports.map((t) => 
-            // Rich surfaces render interactive controls; the rest post plain text.
-            (t.noteApproval ? t.noteApproval(markdown, meta) : t.note(markdown)).catch((err) => {
-                const m = err instanceof Error ? err.message : String(err);
-                console.warn(`[notifier] noteApproval failed: ${m}`);
-            })));
-        });
-    }
-    noteTerminal(markdown) {
-        return this.noteTo(this.transports.filter((t) => t.terminalPing), markdown);
-    }
-    noteTo(transports, markdown) {
-        return this.enqueue(async () => {
-            if (!markdown.trim() || transports.length === 0)
-                return;
-            await Promise.all(transports.map((t) => t.note(markdown).catch((err) => {
-                const m = err instanceof Error ? err.message : String(err);
-                console.warn(`[notifier] note failed: ${m}`);
-            })));
-        });
-    }
-}
-//# sourceMappingURL=notifier.js.map

package/dist/notify/notifier.js.map

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

package/dist/notify/render.d.ts

@@ -1,21 +0,0 @@
-/**
- * The single shared renderer. Turns a {@link ProgressModel} into markdown.
- * GitHub posts the output as-is; the Slack transport converts it via
- * `markdownToSlackMrkdwn` first. There is exactly one renderer so the two
- * platforms can never drift in content.
- */
-import type { ProgressModel, StepStatus } from "./types.js";
-/** Status → leading emoji. Ported from the Mastra rebuild's EMOJI map. */
-export declare const STATUS_EMOJI: Record<StepStatus, string>;
-/** Render the model to a single markdown body. */
-export declare function renderProgress(model: ProgressModel): string;
-/**
- * Collapse a rendered multi-line message into a compact one-line checklist
- * detail: the first non-empty line, capped on *visible* length. The cap
- * measures the rendered length (a markdown link counts as just its link
- * text, not its URL) so a short label backed by a long URL is kept whole —
- * truncating the raw string would slice through the URL and break the link.
- * When a detail is genuinely too long, the link-stripped form is truncated,
- * which can never produce a broken link.
- */
-export declare function collapseDetail(s: string): string | undefined;

package/dist/notify/render.js

@@ -1,59 +0,0 @@
-/** Status → leading emoji. Ported from the Mastra rebuild's EMOJI map. */
-export const STATUS_EMOJI = {
-    pending: "⬜",
-    running: "🔄",
-    done: "✅",
-    blocked: "⛔",
-    awaiting: "⏸️",
-    failed: "❌",
-    skipped: "➖",
-};
-/** Render the model to a single markdown body. */
-export function renderProgress(model) {
-    const lines = [];
-    lines.push(`### 🤖 ${model.title}`);
-    if (model.subtitle) {
-        lines.push("");
-        lines.push(`**${model.subtitle}**`);
-    }
-    if (model.meta && model.meta.length > 0) {
-        lines.push("");
-        for (const m of model.meta)
-            if (m.trim())
-                lines.push(m);
-    }
-    lines.push("");
-    for (const step of model.steps) {
-        const emoji = STATUS_EMOJI[step.status] ?? STATUS_EMOJI.pending;
-        const detail = step.detail ? ` — ${step.detail}` : "";
-        lines.push(`- ${emoji} **${step.label}**${detail}`);
-    }
-    if (model.footer && model.footer.trim()) {
-        lines.push("");
-        lines.push(model.footer);
-    }
-    return lines.join("\n");
-}
-/** Markdown link `[text](url)` → its visible text, for length measurement. */
-const visibleText = (s) => s.replace(/\[([^\]]+)\]\([^)]+\)/g, "$1");
-/**
- * Collapse a rendered multi-line message into a compact one-line checklist
- * detail: the first non-empty line, capped on *visible* length. The cap
- * measures the rendered length (a markdown link counts as just its link
- * text, not its URL) so a short label backed by a long URL is kept whole —
- * truncating the raw string would slice through the URL and break the link.
- * When a detail is genuinely too long, the link-stripped form is truncated,
- * which can never produce a broken link.
- */
-export function collapseDetail(s) {
-    const first = s
-        .split("\n")
-        .map((l) => l.trim())
-        .find((l) => l.length > 0);
-    if (!first)
-        return undefined;
-    if (visibleText(first).length <= 160)
-        return first;
-    return `${visibleText(first).slice(0, 159)}…`;
-}
-//# sourceMappingURL=render.js.map

package/dist/notify/render.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"render.js","sourceRoot":"","sources":["../../src/notify/render.ts"],"names":[],"mappings":"AAQA,0EAA0E;AAC1E,MAAM,CAAC,MAAM,YAAY,GAA+B;IACtD,OAAO,EAAE,GAAG;IACZ,OAAO,EAAE,IAAI;IACb,IAAI,EAAE,GAAG;IACT,OAAO,EAAE,GAAG;IACZ,QAAQ,EAAE,IAAI;IACd,MAAM,EAAE,GAAG;IACX,OAAO,EAAE,GAAG;CACb,CAAC;AAEF,kDAAkD;AAClD,MAAM,UAAU,cAAc,CAAC,KAAoB;IACjD,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,UAAU,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;IACpC,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACnB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,QAAQ,IAAI,CAAC,CAAC;IACtC,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,IAAI;YAAE,IAAI,CAAC,CAAC,IAAI,EAAE;gBAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,YAAY,CAAC,OAAO,CAAC;QAChE,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtD,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,MAAM,IAAI,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC,CAAC;IACtD,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;QACxC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,8EAA8E;AAC9E,MAAM,WAAW,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,wBAAwB,EAAE,IAAI,CAAC,CAAC;AAErF;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAAC,CAAS;IACtC,MAAM,KAAK,GAAG,CAAC;SACZ,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC7B,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,IAAI,WAAW,CAAC,KAAK,CAAC,CAAC,MAAM,IAAI,GAAG;QAAE,OAAO,KAAK,CAAC;IACnD,OAAO,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC;AAChD,CAAC"}

package/dist/notify/transports/github.d.ts

@@ -1,26 +0,0 @@
-/**
- * GitHub binding for the progress notifier. Owns a single comment id and edits
- * it in place on every `publish()`; `note()` posts a fresh comment for moments
- * that deserve a real notification (approval prompts, terminal summary).
- */
-import type { GitHubClient } from "../../engine/github/github.js";
-import type { NotifierTransport, ProgressModel } from "../types.js";
-export interface GitHubTransportDeps {
-    github: GitHubClient;
-    owner: string;
-    repo: string;
-    issueNumber: number;
-    /** Existing status-comment id from a resumed run, if any. */
-    commentId?: number;
-    /** Persist the comment id the first time it's created (so resume re-attaches). */
-    save?: (commentId: number) => void;
-}
-export declare class GitHubTransport implements NotifierTransport {
-    private readonly deps;
-    /** No terminal ping — the finished checklist + the PR-opened event suffice. */
-    readonly terminalPing = false;
-    private commentId?;
-    constructor(deps: GitHubTransportDeps);
-    publish(markdown: string, _model?: ProgressModel): Promise<void>;
-    note(markdown: string): Promise<void>;
-}

package/dist/notify/transports/github.js

@@ -1,27 +0,0 @@
-export class GitHubTransport {
-    deps;
-    /** No terminal ping — the finished checklist + the PR-opened event suffice. */
-    terminalPing = false;
-    commentId;
-    constructor(deps) {
-        this.deps = deps;
-        this.commentId = deps.commentId;
-    }
-    async publish(markdown, _model) {
-        // GitHub renders markdown natively — the structured model is Slack-only.
-        const { github, owner, repo, issueNumber } = this.deps;
-        if (this.commentId !== undefined) {
-            await github.updateComment(owner, repo, this.commentId, markdown);
-        }
-        else {
-            const id = await github.postComment(owner, repo, issueNumber, markdown);
-            this.commentId = id;
-            this.deps.save?.(id);
-        }
-    }
-    async note(markdown) {
-        const { github, owner, repo, issueNumber } = this.deps;
-        await github.postComment(owner, repo, issueNumber, markdown);
-    }
-}
-//# sourceMappingURL=github.js.map

package/dist/notify/transports/github.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"github.js","sourceRoot":"","sources":["../../../src/notify/transports/github.ts"],"names":[],"mappings":"AAmBA,MAAM,OAAO,eAAe;IAKG;IAJ7B,+EAA+E;IACtE,YAAY,GAAG,KAAK,CAAC;IACtB,SAAS,CAAU;IAE3B,YAA6B,IAAyB;QAAzB,SAAI,GAAJ,IAAI,CAAqB;QACpD,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,QAAgB,EAAE,MAAsB;QACpD,yEAAyE;QACzE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC;QACvD,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YACjC,MAAM,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QACpE,CAAC;aAAM,CAAC;YACN,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;YACxE,IAAI,CAAC,SAAS,GAAG,EAAE,CAAC;YACpB,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,QAAgB;QACzB,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC;QACvD,MAAM,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;IAC/D,CAAC;CACF"}

package/dist/notify/transports/slack.d.ts

@@ -1,27 +0,0 @@
-/**
- * Slack binding for the progress notifier. Owns a single message `ts` and
- * edits it in place via `chat.update` on every `publish()`; `note()` posts a
- * fresh threaded message for moments that deserve a real ping (approval
- * prompts, terminal summary) — `chat.update` itself is silent.
- */
-import type { SlackConnector } from "../../connectors/slack/connector.js";
-import type { ApprovalNoteMeta, NotifierTransport, ProgressModel } from "../types.js";
-export interface SlackTransportDeps {
-    slack: SlackConnector;
-    channel: string;
-    thread: string;
-    /** Existing status-message ts from a resumed run, if any. */
-    ts?: string;
-    /** Persist the ts the first time it's created (so resume re-attaches). */
-    save?: (ts: string) => void;
-}
-export declare class SlackTransport implements NotifierTransport {
-    private readonly deps;
-    /** Slack edits are silent and there's no other signal — so it wants the ping. */
-    readonly terminalPing = true;
-    private ts?;
-    constructor(deps: SlackTransportDeps);
-    publish(markdown: string, model?: ProgressModel): Promise<void>;
-    note(markdown: string): Promise<void>;
-    noteApproval(markdown: string, meta: ApprovalNoteMeta): Promise<void>;
-}

package/dist/notify/transports/slack.js

@@ -1,37 +0,0 @@
-import { renderApprovalBlocks, renderProgressBlocks } from "../blocks.js";
-export class SlackTransport {
-    deps;
-    /** Slack edits are silent and there's no other signal — so it wants the ping. */
-    terminalPing = true;
-    ts;
-    constructor(deps) {
-        this.deps = deps;
-        this.ts = deps.ts;
-    }
-    async publish(markdown, model) {
-        const { slack, channel, thread } = this.deps;
-        // Render Block Kit from the model when available; `markdown` stays the
-        // notification/accessibility fallback carried alongside the blocks.
-        const blocks = model ? renderProgressBlocks(model) : undefined;
-        if (this.ts !== undefined) {
-            await slack.updateMessage(channel, this.ts, markdown, blocks);
-        }
-        else {
-            const ts = await slack.sendMessage(channel, thread, markdown, blocks);
-            if (typeof ts === "string") {
-                this.ts = ts;
-                this.deps.save?.(ts);
-            }
-        }
-    }
-    async note(markdown) {
-        const { slack, channel, thread } = this.deps;
-        await slack.sendMessage(channel, thread, markdown);
-    }
-    async noteApproval(markdown, meta) {
-        const { slack, channel, thread } = this.deps;
-        const blocks = renderApprovalBlocks(markdown, meta.workflowRunId);
-        await slack.sendMessage(channel, thread, markdown, blocks);
-    }
-}
-//# sourceMappingURL=slack.js.map

package/dist/notify/transports/slack.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"slack.js","sourceRoot":"","sources":["../../../src/notify/transports/slack.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAa1E,MAAM,OAAO,cAAc;IAKI;IAJ7B,iFAAiF;IACxE,YAAY,GAAG,IAAI,CAAC;IACrB,EAAE,CAAU;IAEpB,YAA6B,IAAwB;QAAxB,SAAI,GAAJ,IAAI,CAAoB;QACnD,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;IACpB,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,QAAgB,EAAE,KAAqB;QACnD,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC;QAC7C,uEAAuE;QACvE,oEAAoE;QACpE,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC/D,IAAI,IAAI,CAAC,EAAE,KAAK,SAAS,EAAE,CAAC;YAC1B,MAAM,KAAK,CAAC,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;QAChE,CAAC;aAAM,CAAC;YACN,MAAM,EAAE,GAAG,MAAM,KAAK,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;YACtE,IAAI,OAAO,EAAE,KAAK,QAAQ,EAAE,CAAC;gBAC3B,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;gBACb,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,QAAgB;QACzB,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC;QAC7C,MAAM,KAAK,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IACrD,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,QAAgB,EAAE,IAAsB;QACzD,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC;QAC7C,MAAM,MAAM,GAAG,oBAAoB,CAAC,QAAQ,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;QAClE,MAAM,KAAK,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC7D,CAAC;CACF"}

package/dist/notify/types.d.ts

@@ -1,119 +0,0 @@
-/**
- * Shared, platform-agnostic notification model.
- *
- * The notifier renders workflow progress as a single "task list" surface that
- * is **edited in place** as phases run — one GitHub comment (via
- * `issues.updateComment`) and/or one Slack message (via `chat.update`) instead
- * of a fresh comment per phase. The model here is the canonical content; the
- * renderer (`render.ts`) turns it into markdown that both platforms consume
- * (Slack runs the markdown through `markdownToSlackMrkdwn` in its transport).
- *
- * Nothing in this module imports GitHub or Slack — platform code lives behind
- * the `NotifierTransport` interface so the content model stays decoupled and
- * shared.
- */
-/** Lifecycle state of a single checklist step. */
-export type StepStatus = "pending" | "running" | "done" | "blocked" | "awaiting" | "failed" | "skipped";
-/** One row in the task list. `key` is stable; `label` is what humans see. */
-export interface ProgressStep {
-    key: string;
-    label: string;
-    status: StepStatus;
-    /** Optional one-line context shown after the label (e.g. a link or status). */
-    detail?: string;
-}
-/** Metadata carried alongside an interactive approval prompt. */
-export interface ApprovalNoteMeta {
-    /** The paused workflow run id — a Slack Approve/Reject button carries it as
-     *  its action value so the click resolves the right gate. */
-    workflowRunId: string;
-}
-/** The full content model rendered into the single status surface. */
-export interface ProgressModel {
-    /** Heading line, e.g. "build for #18". */
-    title: string;
-    /** Optional bold sub-heading, e.g. the issue title. */
-    subtitle?: string;
-    /** Optional metadata lines under the heading (branch link, PR link, …). */
-    meta?: string[];
-    /** Ordered checklist. */
-    steps: ProgressStep[];
-    /** Optional trailing line (e.g. artifacts link). */
-    footer?: string;
-}
-/**
- * A platform binding. Each transport owns its own in-place-update handle
- * (a GitHub comment id or a Slack message ts) internally.
- */
-export interface NotifierTransport {
-    /**
-     * Create-or-update the single status surface with the rendered markdown.
-     * The `model` is the same content source the markdown was rendered from —
-     * a transport that can render richer UI (Slack Block Kit) uses it directly
-     * while keeping `markdown` as the notification/accessibility fallback.
-     * Transports that only speak markdown (GitHub) ignore it.
-     */
-    publish(markdown: string, model?: ProgressModel): Promise<void>;
-    /**
-     * Post a *new, separate* message (not an edit). Used for approval prompts —
-     * moments worth an actual notification, since an in-place edit is silent.
-     */
-    note(markdown: string): Promise<void>;
-    /**
-     * Post a standalone *approval prompt*. Rich surfaces (Slack) render
-     * interactive Approve/Reject controls from `meta`; markdown-only surfaces
-     * (GitHub) omit this and the notifier falls back to `note(markdown)`.
-     * Optional so a plain transport needs only `note`.
-     */
-    noteApproval?(markdown: string, meta: ApprovalNoteMeta): Promise<void>;
-    /**
-     * Whether this surface wants a separate *completion* ping at the end of a
-     * run. Slack sets this (its in-place edits are silent and it has no other
-     * signal); GitHub leaves it false — the edited checklist plus the
-     * PR-opened event already notify watchers, so a terminal comment would just
-     * be noise. Default false.
-     */
-    readonly terminalPing?: boolean;
-}
-/**
- * The runner-facing API. `runner.ts` only ever sees this interface — it never
- * touches a transport or the markdown directly.
- */
-export interface ProgressReporter {
-    /** Seed the task list. Idempotent: a resumed run re-seeds the same surface. */
-    start(model: ProgressModel): Promise<void>;
-    /** Transition a step's status (and optionally set its one-line detail). */
-    step(key: string, status: StepStatus, detail?: string): Promise<void>;
-    /**
-     * Insert (or update) a dynamic step before `beforeKey` — used for loop
-     * iterations (re-review / fix cycles). Appends when `beforeKey` is omitted
-     * or not found.
-     */
-    insertStep(step: ProgressStep, beforeKey?: string): Promise<void>;
-    /** Post a standalone message to every surface (e.g. an approval prompt). */
-    note(markdown: string): Promise<void>;
-    /**
-     * Post an interactive approval prompt to every surface. Rich surfaces render
-     * Approve/Reject controls (Slack Block Kit); others fall back to plain text.
-     */
-    noteApproval(markdown: string, meta: ApprovalNoteMeta): Promise<void>;
-    /**
-     * Set (or clear) the trailing footer of the single status surface and
-     * re-publish in place. Used to fold a workflow's final synthesized result
-     * into the same comment as the checklist rather than posting a new one.
-     * Pass an empty string to clear.
-     */
-    footer(markdown: string): Promise<void>;
-    /**
-     * Post the run's completion message, but only to surfaces that want a
-     * terminal ping (Slack) — GitHub is left with just the finished checklist.
-     */
-    noteTerminal(markdown: string): Promise<void>;
-}
-/** Persisted in-place-update handles, stored under `workflow_runs.scratch.notifier`. */
-export interface NotifierState {
-    githubCommentId?: number;
-    slackTs?: string;
-    slackChannel?: string;
-    slackThread?: string;
-}

package/dist/notify/types.js

@@ -1,16 +0,0 @@
-/**
- * Shared, platform-agnostic notification model.
- *
- * The notifier renders workflow progress as a single "task list" surface that
- * is **edited in place** as phases run — one GitHub comment (via
- * `issues.updateComment`) and/or one Slack message (via `chat.update`) instead
- * of a fresh comment per phase. The model here is the canonical content; the
- * renderer (`render.ts`) turns it into markdown that both platforms consume
- * (Slack runs the markdown through `markdownToSlackMrkdwn` in its transport).
- *
- * Nothing in this module imports GitHub or Slack — platform code lives behind
- * the `NotifierTransport` interface so the content model stays decoupled and
- * shared.
- */
-export {};
-//# sourceMappingURL=types.js.map

package/dist/notify/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/notify/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG"}

package/dist/providers.d.ts

@@ -1,125 +0,0 @@
-/**
- * Provider registry — single source of truth for the LLM providers Last Light
- * knows how to wire end-to-end.
- *
- * pi-ai (`@earendil-works/pi-ai`) is provider-agnostic and supports 15+
- * providers out of the box. Of those, only a subset is "wizard-able" here:
- * they authenticate with a single API-key env var and expose a stable
- * endpoint reachable from the sandbox egress firewall. Excluded are the
- * OAuth-only providers (`openai-codex`, `github-copilot`), the multi-env
- * Ambient-cred ones (`amazon-bedrock`, `google-vertex`, `azure-openai-*`,
- * `cloudflare-*`), and the regional-CN variants.
- *
- * This registry is consumed by:
- *   - `src/engine/llm.ts` — the cheap one-shot helper used by the
- *     prompt screener + intent classifier. It builds requests for the
- *     `openai-completions` family (which is most wizard-able providers —
- *     Google and Mistral are routed through their OpenAI-compatible
- *     endpoints) and the `anthropic-messages` family (Kimi for Coding,
- *     MiniMax, Anthropic itself).
- *   - `src/engine/agent-executor.ts` — forwards each provider's env var
- *     into the sandbox so agentic-pi can auth.
- *   - `src/sandbox/egress-allowlist.ts` — the SNI/firewall allowlist is
- *     seeded from each provider's `host`.
- *   - `src/cli/setup.ts` — the install wizard's step-4 provider picker.
- *
- * Keep this list aligned with pi-ai's provider registry. When pi-ai adds a
- * new provider that we want to surface, add an entry here and everything
- * else (forwarding, egress, wizard UI) follows automatically.
- */
-/** API request/response family pi-ai uses to talk to a provider. */
-export type ApiType = 
-/** Anthropic Messages API — `system` field, content-block response. */
-"anthropic-messages"
-/** OpenAI Chat Completions API — `messages`, `choices[0].message.content`. */
- | "openai-completions";
-/**
- * Metadata for one wizard-able provider. The request-building differences
- * between OpenAI-completions-family providers (maxTokensField name,
- * extra headers, nested-model-id quirk) are small, so they live as optional
- * fields here rather than separate adapter objects.
- */
-export interface ProviderSpec {
-    /** pi-ai model-spec prefix — the part before `/` in `provider/model`. */
-    readonly prefix: string;
-    /** Display name (shown in the wizard). */
-    readonly displayName: string;
-    /** Env var that carries the API key (also the env var forwarded into the sandbox). */
-    readonly envKey: string;
-    /** API base URL — `chat/completions` or `messages` is appended per `api`. */
-    readonly baseUrl: string;
-    /** API request/response family. */
-    readonly api: ApiType;
-    /** Egress allowlist host — apex (matches all subdomains) or specific host. */
-    readonly host: string;
-    /** Small/fast model id used by the screener + classifier cheap helper. */
-    readonly fastModel: string;
-    /** Canonical primary model id (used as the wizard placeholder). */
-    readonly sampleModel: string;
-    /** OpenAI-completions only: body field for the token cap. Default `max_tokens`. */
-    readonly maxTokensField?: "max_tokens" | "max_completion_tokens";
-    /** OpenAI-completions only: keep the nested `vendor/model` tail verbatim (OpenRouter). */
-    readonly preserveNestedModelId?: boolean;
-    /** OpenAI-completions only: extra request headers (OpenRouter's referer/title). */
-    readonly extraHeaders?: Readonly<Record<string, string>>;
-    /** Optional wizard hint for the API-key prefix (used in placeholder + loose validation). */
-    readonly keyPrefix?: string;
-}
-/**
- * The registry. Order matters — `defaultFastModel()` in `llm.ts` selects
- * a fast model by iterating this list and picking the first provider
- * whose env var is present. Always keep Anthropic first (best raw-latency
- * cheap helper) then OpenAI then OpenRouter, then the rest grouped by
- * families so the array is easy to scan.
- */
-export declare const PROVIDERS: readonly ProviderSpec[];
-export declare function providerByPrefix(prefix: string): ProviderSpec | undefined;
-export declare function providerByEnvKey(envKey: string): ProviderSpec | undefined;
-/** All the env var names a harness must forward to reach every registered provider. */
-export declare const PROVIDER_ENV_KEYS: readonly string[];
-/** All the hosts the sandbox egress firewall must allowlist to reach these providers. */
-export declare const PROVIDER_HOSTS: readonly string[];
-/**
- * Default model spec shipped with the harness. Keep aligned with the
- * `OPENCODE_MODEL` default in `config/default.yaml` and the wizard's
- * initial provider selection.
- */
-export declare const DEFAULT_PROVIDER = "anthropic";
-export declare const DEFAULT_MODEL = "anthropic/claude-sonnet-4-6";
-/**
- * OAuth (subscription-login) providers — the ones the API-key registry above
- * deliberately excludes. These don't authenticate with a static key env var;
- * a user logs in once (`lastlight oauth login <id>`) and pi-ai manages the
- * token. Two consumption seams with different reach:
- *
- *   - **chat** (in-process pi-ai) supports ALL of these — the chat runner
- *     passes the resolved token as the per-call `apiKey`.
- *   - **sandbox** (agentic-pi) resolves creds from ENV only, so a provider is
- *     sandbox-usable ONLY if `sandboxEnvVar` is set (the env var pi-ai reads
- *     inside the sandbox). Codex has none → chat-only.
- *
- * Egress note: chat is in-process (not behind the sandbox firewall), and the
- * one sandbox-capable OAuth provider whose models we ship (`anthropic`) reuses
- * the `anthropic.com` host already in the API-key registry — so no OAuth host
- * is added to the sandbox allowlist here.
- */
-export interface OAuthProviderSpec {
-    /** pi-ai OAuth provider id — also `lastlight oauth login <id>`. */
-    readonly id: string;
-    /** Display name (wizard + CLI). */
-    readonly displayName: string;
-    /** pi-ai model-spec prefix (`provider` in `provider/model`) for its models. */
-    readonly modelPrefix: string;
-    /** Representative model spec — wizard placeholder / docs hint. */
-    readonly sampleModel: string;
-    /**
-     * Env var pi-ai reads for this provider's OAuth token inside a sandbox, or
-     * `null` when there's no env route (⇒ chat-only; cannot run sandbox phases).
-     */
-    readonly sandboxEnvVar: string | null;
-    /** True when login is mandatory (no API-key fallback). */
-    readonly oauthOnly: boolean;
-}
-export declare const OAUTH_PROVIDERS: readonly OAuthProviderSpec[];
-export declare function oauthProviderByModelPrefix(prefix: string): OAuthProviderSpec | undefined;
-export declare function oauthProviderById(id: string): OAuthProviderSpec | undefined;