@songsid/agend 2.2.0-beta.7 → 2.2.0-beta.9

package/dist/log-service.d.ts

@@ -0,0 +1,99 @@
+import { type LogStep } from "./log-steps.js";
+export declare const LOG_STEPS_LIMIT = 200;
+export declare const LOG_OLDER_LIMIT = 100;
+export declare const LOG_RESPONSE_MAX_BYTES: number;
+export declare const WATCH_LEASE_MS = 45000;
+export declare const WATCH_POLL_MS = 2000;
+export declare const LOG_EVENTS_LIMIT = 50;
+/** Where an instance's steps come from, as the fleet resolves it (only when the Log asks). */
+export interface LogSource {
+    backend: string;
+    /** The transcript to read, or null: none known now. */
+    path: string | null;
+    /** The parser for it: claude / codex (kiro: its own reader, later in phase 1); null: this backend has none. */
+    format: "claude" | "codex" | null;
+    /** Why there is nothing to read: "not_running" (its transcript is found while it runs), "no_transcript", "unsupported". */
+    reason?: string;
+}
+export interface LogEventRow {
+    id: number;
+    event_type: string;
+    payload: unknown;
+    created_at: string;
+}
+export interface LogServiceDeps {
+    enabled(): boolean;
+    /** An instance the Log may show (a fleet instance or a ClassicBot room). */
+    known(name: string): boolean;
+    source(name: string): LogSource;
+    /** The instance's newest event-log rows (newest first), at most `limit`. */
+    events(name: string, limit: number): LogEventRow[];
+    /** Broadcast to the web stream. */
+    emit(event: string, data: unknown): void;
+    now?(): number;
+    setInterval?(fn: () => void, ms: number): unknown;
+    clearInterval?(handle: unknown): void;
+}
+export interface LogQuery {
+    after?: number;
+    before?: number;
+    key?: string;
+    skip?: boolean;
+    limit?: number;
+    watch?: boolean;
+    ev?: number;
+}
+/** A fleet event as the page shows it: its type (the page words it) and its details, masked. */
+export interface LogEvent {
+    id: number;
+    ts: number;
+    type: string;
+    detail?: string;
+}
+/** The event types a Log shows: what changed for the instance itself, not bookkeeping (tips, cost snapshots). */
+export declare const LOG_EVENT_TYPES: ReadonlySet<string>;
+export type LogAnswer = {
+    enabled: false;
+} | {
+    enabled: true;
+    instance: string;
+    backend: string;
+    supported: boolean;
+    reason?: string;
+    /** The transcript's identity (device-inode): a cursor of another one is reset. */
+    key?: string;
+    steps: LogStep[];
+    events: LogEvent[];
+    /** Offset to ask `before=` for older steps; null: nothing older. */
+    before: number | null;
+    /** Offset to ask `after=` for newer steps (with `skip` when it is inside a long record). */
+    after: number | null;
+    skip?: boolean;
+    /** More is already waiting after `after`. */
+    more?: boolean;
+    /** The page's cursor was for another transcript (a new session) or past its end: start again from this answer. */
+    reset?: boolean;
+    /** The newest event id this answer saw (for `ev=`). */
+    ev: number;
+};
+export declare class LogService {
+    private readonly deps;
+    private readonly watches;
+    constructor(deps: LogServiceDeps);
+    private now;
+    /** GET /ui/steps — null: no such instance. */
+    steps(name: string, q: LogQuery): Promise<LogAnswer | null>;
+    /** The steps before `end` (the newest when undefined), at most `limit`, and where older ones start. */
+    private backward;
+    /** The steps after `from` (≤ LOOKS_PER_POLL looks), and the cursor after them. */
+    private forward;
+    private eventsFor;
+    /** Hold (or renew) the watch on `name`: its transcript's size is looked at while the lease lasts. */
+    private watch;
+    private look;
+    private unwatch;
+    /** Every watch ends (the Log was turned off, the fleet stops). */
+    unwatchAll(): void;
+    /** How many instances are watched now (for tests and diagnostics). */
+    watched(): number;
+}

package/dist/log-service.js

@@ -0,0 +1,235 @@
+/**
+ * #1218 phase 1: the Log tab's server side — on demand only (the user's decision on load, 2026-10-13). Off by default
+ * (`web.log_tab`); off, it answers `{ enabled: false }` and does no work at all. On:
+ *
+ * - **Nothing runs in the background.** No collector, no step log on disk: each GET /ui/steps reads a bounded range of
+ *   the instance's own transcript (async, ≤ 8 MiB back or ≤ 4 MiB forward) and parses it with the backend's parser
+ *   (log-steps.ts). Step ids depend on the bytes, not on the range, so the page merges ranges.
+ * - **Live only under a watch.** A request with `watch` holds a lease (WATCH_LEASE_MS, renewed by every request); while
+ *   one is held the fleet looks at the transcript's size every WATCH_POLL_MS and, when it moved, broadcasts a tiny
+ *   `steps_tick { instance }` — the page then fetches `after=` its cursor. No lease: no timer, no read.
+ * - **Fleet events** (crash, restart, hang, a prompt waiting, a pause) come from the existing event log, by id.
+ *
+ * Nothing here runs in the daemon, and nothing reads a CLI's file on a tool call.
+ */
+import { stat } from "node:fs/promises";
+import { ClaudeStepParser, CodexStepParser, bounded, readTailRecords } from "./log-steps.js";
+import { LOOKS_PER_POLL, isClaudeAssistantHead, readNewLines, readWholeLine } from "./transcript-jsonl.js";
+export const LOG_STEPS_LIMIT = 200;
+export const LOG_OLDER_LIMIT = 100;
+export const LOG_RESPONSE_MAX_BYTES = 512 * 1024;
+export const WATCH_LEASE_MS = 45_000;
+export const WATCH_POLL_MS = 2_000;
+export const LOG_EVENTS_LIMIT = 50;
+/** The event types a Log shows: what changed for the instance itself, not bookkeeping (tips, cost snapshots). */
+export const LOG_EVENT_TYPES = new Set([
+    "crash_respawn", "crash_loop", "hang_detected", "hang_action", "instance_paused", "instance_resumed",
+    "interactive_prompt", "interactive_prompt_assist", "dialog_parked", "model_failover", "model_recovered",
+    "mcp_died", "mcp_recovered", "mcp_auto_restart", "message_failed", "pty_error", "pty_recovered",
+    "backend_unreachable", "startup_backend_unreachable", "backend_launch_warning", "clear_action", "normal_exit_action",
+    "reply_drop_detected", "reply_drop_recovered", "reply_drop_unrecovered", "supervision_ended", "tmux_server_crash",
+    "malformed_tool_call", "health_check_error",
+]);
+const parserFor = (format) => (format === "claude" ? new ClaudeStepParser() : new CodexStepParser());
+/** The long records worth reading whole for a Log (a reply, a turn record); every other long one by its head. */
+const wholeFor = (format) => (head) => (format === "claude"
+    ? isClaudeAssistantHead(head)
+    : head.includes('"type":"event_msg"') || (head.includes('"type":"response_item"') && /"payload":\{"type":"message"/.test(head)));
+const dbTime = (s) => { const t = Date.parse(s.replace(" ", "T") + "Z"); return Number.isFinite(t) ? t : 0; };
+export class LogService {
+    deps;
+    watches = new Map();
+    constructor(deps) {
+        this.deps = deps;
+    }
+    now() { return this.deps.now ? this.deps.now() : performance.now(); }
+    /** GET /ui/steps — null: no such instance. */
+    async steps(name, q) {
+        if (!this.deps.enabled()) {
+            this.unwatchAll();
+            return { enabled: false };
+        }
+        if (!this.deps.known(name))
+            return null;
+        const src = this.deps.source(name);
+        const evs = this.eventsFor(name, q.ev);
+        const base = { enabled: true, instance: name, backend: src.backend, events: evs.events, ev: evs.ev };
+        if (!src.format || !src.path) {
+            return { ...base, supported: !!src.format, reason: src.reason ?? (src.format ? "no_transcript" : "unsupported"), steps: [], before: null, after: null };
+        }
+        let st;
+        try {
+            st = await stat(src.path);
+        }
+        catch {
+            return { ...base, supported: true, reason: "no_transcript", steps: [], before: null, after: null };
+        }
+        const key = `${st.dev}-${st.ino}`;
+        if (q.watch)
+            this.watch(name, src.path, st.size, st.ino);
+        const answer = { ...base, supported: true, key };
+        const fresh = q.key !== undefined && q.key !== key;
+        const past = q.after !== undefined && q.after > st.size;
+        if (q.after !== undefined && !fresh && !past)
+            return { ...answer, ...(await this.forward(src.path, src.format, q.after, !!q.skip)) };
+        if (q.before !== undefined && !fresh)
+            return { ...answer, ...(await this.backward(src.path, src.format, q.before, Math.min(q.limit ?? LOG_OLDER_LIMIT, LOG_OLDER_LIMIT))), after: null };
+        const back = await this.backward(src.path, src.format, undefined, Math.min(q.limit ?? LOG_STEPS_LIMIT, LOG_STEPS_LIMIT));
+        return { ...answer, ...back, ...((fresh || past) && (q.after !== undefined || q.before !== undefined) ? { reset: true } : {}) };
+    }
+    /** The steps before `end` (the newest when undefined), at most `limit`, and where older ones start. */
+    async backward(path, format, end, limit) {
+        const tail = await readTailRecords(path, { maxLines: 4000, ...(end !== undefined ? { end } : {}) });
+        const parser = parserFor(format);
+        const whole = wholeFor(format);
+        const firstAt = new Map();
+        for (const r of tail.records) {
+            let record = r.record;
+            // #1788 review P3: a long reply or turn record is read whole here too, as the live read does.
+            if (typeof record !== "string" && whole(record.head)) {
+                const text = await readWholeLine(path, r.at, record.bytes).catch(() => null);
+                if (text !== null)
+                    record = text;
+            }
+            for (const s of parser.push(record, r.at))
+                if (!firstAt.has(s.id))
+                    firstAt.set(s.id, r.at);
+        }
+        let steps = fitBytes(parser.steps.slice(-limit));
+        // #1788 review P3: cut only at a record's boundary — one record can make several steps (a reply's text and its
+        // call): the oldest kept record comes whole, so `before` (its start) never leaves one of its steps out for good.
+        let from = parser.steps.length - steps.length;
+        const recordOf = (i) => firstAt.get(parser.steps[i].id);
+        while (from > 0 && steps.length && recordOf(from - 1) === recordOf(from))
+            from--;
+        steps = parser.steps.slice(from);
+        // Older steps exist when the read stopped before the file's start, or when steps it parsed were left out (the limit,
+        // the answer's size): they start at the record of the oldest step shown. Otherwise nothing is older.
+        const all = !tail.truncated && steps.length === parser.steps.length;
+        const first = steps.length ? Math.min(...steps.map(s => firstAt.get(s.id) ?? Infinity)) : (tail.records[0]?.at ?? 0);
+        const before = !all && Number.isFinite(first) && first > 0 ? first : null;
+        return { steps, before, after: tail.end };
+    }
+    /** The steps after `from` (≤ LOOKS_PER_POLL looks), and the cursor after them. */
+    async forward(path, format, from, skip) {
+        const parser = parserFor(format);
+        const whole = wholeFor(format);
+        let offset = from, skipping = skip, more = false;
+        for (let look = 0; look < LOOKS_PER_POLL; look++) {
+            const read = await readNewLines(path, offset, { skipping });
+            const moved = read.newOffset !== offset;
+            offset = read.newOffset;
+            skipping = read.skipping;
+            more = read.more;
+            // In file order: complete lines with their offsets, long lines by their head — or whole, for a reply or turn record.
+            let li = 0;
+            const pushLong = async (l) => {
+                if (l.complete && whole(l.head)) {
+                    const text = await readWholeLine(path, l.offset, l.bytes).catch(() => null);
+                    if (text !== null) {
+                        parser.push(text, l.offset);
+                        return;
+                    }
+                }
+                parser.push(l, l.offset);
+            };
+            for (const l of read.long) {
+                while (li < l.at) {
+                    parser.push(read.lines[li], read.offsets[li]);
+                    li++;
+                }
+                await pushLong(l);
+            }
+            while (li < read.lines.length) {
+                parser.push(read.lines[li], read.offsets[li]);
+                li++;
+            }
+            if (!moved || !read.more)
+                break;
+        }
+        const steps = fitBytes(parser.steps);
+        return { steps, before: null, after: offset, ...(skipping ? { skip: true } : {}), ...(more || skipping ? { more: true } : {}) };
+    }
+    eventsFor(name, after) {
+        let rows = [];
+        try {
+            rows = this.deps.events(name, LOG_EVENTS_LIMIT);
+        }
+        catch {
+            rows = [];
+        }
+        const ev = rows.reduce((m, r) => Math.max(m, r.id), after ?? 0);
+        const events = rows
+            .filter(r => (after === undefined || r.id > after) && LOG_EVENT_TYPES.has(r.event_type))
+            .map(r => {
+            const detail = r.payload && typeof r.payload === "object" && Object.keys(r.payload).length
+                ? bounded(JSON.stringify(r.payload), 300).text : undefined;
+            return { id: r.id, ts: dbTime(r.created_at), type: r.event_type, ...(detail ? { detail } : {}) };
+        })
+            .reverse();
+        return { events, ev };
+    }
+    /** Hold (or renew) the watch on `name`: its transcript's size is looked at while the lease lasts. */
+    watch(name, path, size, ino) {
+        const until = this.now() + WATCH_LEASE_MS;
+        const held = this.watches.get(name);
+        if (held && held.path === path) {
+            held.until = until;
+            return;
+        }
+        if (held)
+            this.unwatch(name);
+        const setI = this.deps.setInterval ?? ((fn, ms) => { const t = setInterval(fn, ms); t.unref?.(); return t; });
+        const w = { until, path, size, ino, timer: null };
+        w.timer = setI(() => { void this.look(name); }, WATCH_POLL_MS);
+        this.watches.set(name, w);
+    }
+    async look(name) {
+        const w = this.watches.get(name);
+        if (!w)
+            return;
+        if (this.now() > w.until || !this.deps.enabled()) {
+            this.unwatch(name);
+            return;
+        }
+        let st;
+        try {
+            st = await stat(w.path);
+        }
+        catch {
+            return;
+        }
+        if (this.watches.get(name) !== w)
+            return;
+        if (st.size !== w.size || st.ino !== w.ino) {
+            w.size = st.size;
+            w.ino = st.ino;
+            this.deps.emit("steps_tick", { instance: name });
+        }
+    }
+    unwatch(name) {
+        const w = this.watches.get(name);
+        if (!w)
+            return;
+        (this.deps.clearInterval ?? ((h) => clearInterval(h)))(w.timer);
+        this.watches.delete(name);
+    }
+    /** Every watch ends (the Log was turned off, the fleet stops). */
+    unwatchAll() { for (const name of [...this.watches.keys()])
+        this.unwatch(name); }
+    /** How many instances are watched now (for tests and diagnostics). */
+    watched() { return this.watches.size; }
+}
+/** The newest steps whose JSON fits LOG_RESPONSE_MAX_BYTES (each step is already bounded; this bounds their number). */
+function fitBytes(steps) {
+    let total = 0, i = steps.length;
+    while (i > 0) {
+        const size = JSON.stringify(steps[i - 1]).length + 1;
+        if (total + size > LOG_RESPONSE_MAX_BYTES)
+            break;
+        total += size;
+        i--;
+    }
+    return steps.slice(i);
+}
+//# sourceMappingURL=log-service.js.map

package/dist/log-service.js.map

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

package/dist/log-steps.d.ts

@@ -0,0 +1,169 @@
+import { type LongLine } from "./transcript-jsonl.js";
+export type StepKind = "user" | "assistant" | "tool" | "error" | "turn_end" | "state";
+/** What a tool call does, for its icon and words on the page. */
+export type StepCat = "read" | "edit" | "search" | "run" | "web" | "mcp" | "agent" | "plan" | "message" | "other";
+export type StepStatus = "running" | "done" | "failed" | "interrupted";
+export interface LogStep {
+    /**
+     * Stable for the step's life, and the same whichever range of the transcript is parsed: a tool call's own id, or
+     * `o<byte offset of its record>.<n>`. A later emission with the same id updates it (a call, then its result) — the
+     * page merges it into what it shows.
+     */
+    id: string;
+    /** The turn it belongs to: the transcript's own id for it (claude: the prompt record's uuid; codex: turn_id); "" before the first. */
+    turn: string;
+    /** When the record was written (ms), or 0 when the record has no time. */
+    ts: number;
+    kind: StepKind;
+    /** tool: the CLI's tool name ("Bash", "exec_command", "fs_read"). */
+    tool?: string;
+    cat?: StepCat;
+    /** tool: what it acts on — a path, a command, a pattern, `server:tool` — masked, ≤ SUBJECT_MAX. */
+    subject?: string;
+    /** tool: its arguments as text (JSON or the command), masked, ≤ INPUT_MAX — the page shows it on demand. */
+    input?: string;
+    inputCut?: number;
+    status?: StepStatus;
+    durationMs?: number;
+    exitCode?: number;
+    /** user / assistant / error text, or a tool's result, masked and cut (≤ TEXT_MAX / RESULT_MAX). */
+    body?: string;
+    /** Characters cut from `body` (0 or absent: nothing), or the bytes of a result too long to read (`bodyBytes`). */
+    bodyCut?: number;
+    bodyBytes?: number;
+    /** state: what happened ("compacted"); error: a status code. */
+    note?: string;
+}
+export declare const SUBJECT_MAX = 300;
+export declare const INPUT_MAX = 2000;
+export declare const TEXT_MAX = 4000;
+export declare const RESULT_MAX = 4000;
+/**
+ * Mask secret values in `text` (#1788 review P1: every common way a secret is written, since arguments and results are
+ * shown): a private key block; a secret-named JSON field, flag or assignment (any identifier containing password,
+ * secret, token, api/access/private key, credential — DB_PASSWORD, "api_key", --password); then the bubble's redactor
+ * (known key shapes, Bearer, URL userinfo); then long mixed-case opaque tokens. Numbers, booleans and null are kept.
+ */
+export declare function maskSecrets(text: string): string;
+/**
+ * `text` masked and cut to `max` characters (never inside a surrogate pair), with how many were cut. Only the part that
+ * can be shown (plus MASK_MARGIN) is masked: a tool result can be megabytes.
+ */
+export declare function bounded(text: string, max: number): {
+    text: string;
+    cut: number;
+};
+/** A "tool" that is the model's thinking (kiro's `thinking`): never a step (the user's decision: thinking is never shown). */
+export declare const THINKING_TOOLS: ReadonlySet<string>;
+/** The category and subject of a tool call, from its name and input. An unknown tool: "other", its name. */
+export declare function describeTool(name: string, input: unknown): {
+    cat: StepCat;
+    subject?: string;
+};
+/** What a parser gives back for one record: the steps it created or changed (each a complete, latest copy). */
+export type Emission = LogStep[];
+declare abstract class StepParser {
+    protected turn: string;
+    private open;
+    private n;
+    /** The byte offset of the record being parsed (-1: unknown), for ids that do not depend on where parsing began. */
+    protected at: number;
+    private k;
+    /** Steps in the order they were first seen (updated in place). */
+    readonly steps: LogStep[];
+    protected abstract record(entry: Record<string, unknown>): Emission;
+    /** A record too long to parse: what its head still says (by default nothing). */
+    protected long(_head: string, _bytes: number): Emission;
+    /** One transcript line (JSON text) or a long line's head: the steps it created or changed. Malformed: none. */
+    push(item: string | LongLine, at?: number): Emission;
+    protected add(step: Omit<LogStep, "id" | "turn"> & {
+        id?: string;
+    }): LogStep;
+    protected openTool(id: string): LogStep | undefined;
+    protected close(id: string): LogStep | undefined;
+    /** A new turn (`key`: the transcript's id for it): every tool still running in the last one is interrupted. */
+    protected newTurn(key: string): Emission;
+    protected endOpen(status: StepStatus): Emission;
+}
+/**
+ * claude-code: the JSONL at statusline.json's transcript_path. user: a prompt (string content; `isMeta` records and
+ * tool results are not prompts); assistant: `text` (thinking never), `tool_use` (running); a `tool_result` (by
+ * `tool_use_id`, `is_error`) completes its call; an API error is an assistant record with `isApiErrorMessage`;
+ * `system` `turn_duration` ends a turn, `compact_boundary` is a state.
+ */
+export declare class ClaudeStepParser extends StepParser {
+    private started;
+    protected record(e: Record<string, unknown>): Emission;
+    private result;
+    /** A tool result too long to parse (most long claude lines are): its call completes, with the start of its text. */
+    protected long(head: string, bytes: number): Emission;
+}
+/**
+ * codex: the rollout JSONL. `response_item`: `message` (user / assistant), `function_call` / `custom_tool_call` /
+ * `local_shell_call` (running, by `call_id`) and their `*_output` (exec_command's output says its exit code and wall
+ * time); `event_msg`: `task_started` (a turn), `task_complete` / `turn_aborted` (its end), and — on versions that
+ * write them — `item_completed` items: CommandExecution (a command, with exit code and duration), McpToolCall,
+ * FileChange. Their AgentMessage / UserMessage duplicate the response items and are not shown twice; reasoning never.
+ */
+export declare class CodexStepParser extends StepParser {
+    private started;
+    protected record(e: Record<string, unknown>): Emission;
+    private item;
+    /** A long rollout line: an output completes its call with the start of its text; a call starts by its name. */
+    protected long(head: string, bytes: number): Emission;
+}
+/**
+ * kiro TUI (v2): the session's message log `<KIRO_HOME>/sessions/cli/<id>.jsonl` — `Prompt` (a turn: its text),
+ * `AssistantMessage` (`text`; `toolUse` running, by `toolUseId`; `thinking` never), `ToolResults` (`toolResult`
+ * completes its call: status, stdout/stderr, exit status). Only a Prompt carries a time.
+ */
+export declare class KiroV2StepParser extends StepParser {
+    private skipped;
+    protected record(e: Record<string, unknown>): Emission;
+    /**
+     * A tool result too long to parse (a command's whole output): its first call completes with the start of its output
+     * and the exit code the head shows. A long reply or prompt is read whole by the Log instead (log-service.ts).
+     */
+    protected long(head: string, bytes: number): Emission;
+}
+/**
+ * kiro classic (v1): one conversation row's `history` — each entry a user side (`Prompt`, `ToolUseResults`,
+ * `CancelledToolUses`) and an assistant side (`ToolUse` with its text and calls, or `Response`). The row is rewritten
+ * as the conversation goes on, so its steps are the whole history's; ids are by entry (`h<i>.<n>`) and calls by their
+ * own id. Read in the kiro worker (never on the fleet loop); `max` bounds what comes back.
+ */
+export declare function kiroClassicSteps(value: unknown, max?: number): {
+    steps: LogStep[];
+    entries: number;
+};
+export declare const BACKFILL_MAX_BYTES: number;
+/**
+ * The last records of a JSONL transcript, in file order, each with its byte offset — complete lines, and long lines (over LINE_MAX_BYTES) by
+ * their head and size — read backwards in BACKFILL_CHUNK chunks, at most `maxBytes`, stopping once `maxLines` records
+ * are held. A record still being written (after the last line end) is not included. `truncated`: older records exist
+ * that were not read. Async and bounded — for an on-demand backfill when a Log is opened, never a whole-file read.
+ * `end` (a record start from an earlier read) reads the records before it instead: the older page.
+ *
+ * Of the record that crosses a chunk's left edge only its first LINE_MAX_BYTES + LONG_HEAD_BYTES are kept (with its
+ * exact length): enough for a short record whole, or for a long one's head.
+ */
+/** A record and where it starts in the file (its byte offset). */
+export interface TailRecord {
+    record: string | LongLine;
+    at: number;
+}
+export declare function readTailRecords(path: string, opts?: {
+    maxBytes?: number;
+    maxLines?: number;
+    end?: number;
+}): Promise<{
+    records: TailRecord[];
+    truncated: boolean;
+    end: number;
+}>;
+/** Parse `records` (file order) with `parser` and return its last `max` steps. */
+export declare function stepsOf(parser: {
+    push(item: string | LongLine, at?: number): Emission;
+    steps: LogStep[];
+}, records: readonly TailRecord[], max?: number): LogStep[];
+export {};