@quickchatai/pi-quickreview 0.0.0-stage → 1.1.0

package/dist/src/live/events.d.ts

@@ -0,0 +1,188 @@
+export declare const LIVE_EVENT_VERSION: 1;
+/** Which session a log belongs to. */
+export type LiveStreamKind = "main" | "lens";
+/** One child of a lens tool call, reduced to what round-progress reads. `slot`
+ * is its position in the call's `details.results`; a line carries only the
+ * slots that changed since the call's previous line (`n` is the whole count). */
+export interface LiveResult {
+    slot: number;
+    agent?: string;
+    /** The lens run's identity (LensResult v1 `id`); absent on the native shape. */
+    id?: string;
+    /** As reported: a number on every shape pi and the engine produce. */
+    exit_code?: number | string | boolean | null;
+    stop_reason?: string;
+    error_message?: string;
+    progress?: {
+        status?: string;
+        duration_ms?: number;
+        tool_count?: number;
+        last_message?: string;
+        error?: string;
+        /** `{tool, args, status}` as the native extension reports them. */
+        recent_tools?: Array<{
+            tool?: string;
+            args?: string;
+            status?: string;
+        }>;
+    };
+    /** The native shape carries no `progress`: what its transcript says. */
+    native?: {
+        tool_count: number;
+        last_text?: string;
+        last_tool?: string;
+    };
+    /** Dollars this child has spent so far. */
+    cost_usd?: number;
+}
+/** A task a lens tool call launches, as the host resolved it at call start. */
+export interface LiveExecution {
+    agent: string;
+    phase?: "plan" | "sweep" | "optional";
+}
+export interface LiveUsage {
+    input: number;
+    output: number;
+    cache_read: number;
+    cost_usd: number;
+}
+/** What happens on a line, by `type`. */
+export type LiveBody = {
+    type: "session_start";
+    stream: LiveStreamKind;
+    /** The state key (`pr-<n>` on the bot, the review's name on a one-shot). */
+    key: string;
+    round: number;
+    /** The PR number round-progress is published for; null when there is none. */
+    pr: number | null;
+    session: string;
+    /** The lens run id, on a lens stream. */
+    lens_id?: string;
+    agent?: string;
+} | {
+    type: "agent_start";
+} | {
+    type: "agent_end";
+    will_retry?: boolean;
+} | {
+    type: "agent_settled";
+    aborted: boolean;
+} | {
+    type: "turn_start";
+} | {
+    type: "turn_end";
+}
+/** `text` is the joined text of a USER message (the round order carries the
+ * command marker); absent for every other role. */
+ | {
+    type: "message_start";
+    role: string;
+    text?: string;
+}
+/** Streamed text since the previous line, coalesced to ~250 ms. */
+ | {
+    type: "message_delta";
+    text?: string;
+    thinking?: string;
+} | {
+    type: "message_end";
+    role: string;
+    text?: string;
+    tool_calls?: string[];
+    stop_reason?: string;
+    error?: string;
+    usage?: LiveUsage;
+} | {
+    type: "tool_start";
+    id: string;
+    tool: string;
+    /** The tool call this one was made through (`ctx.executeTool`). */
+    parent?: string;
+    /** A lens tool keeps its arguments; any other tool a one-line preview. */
+    args?: Record<string, unknown>;
+    preview?: string;
+    /** What a lens tool call launches, resolved by the host at call start. */
+    executions?: LiveExecution[];
+} | {
+    type: "tool_update";
+    id: string;
+    tool: string;
+    parent?: string;
+    mode?: string;
+    /** Children in the whole call; `results` holds the ones that changed. */
+    n: number;
+    results: LiveResult[];
+} | {
+    type: "tool_end";
+    id: string;
+    tool: string;
+    parent?: string;
+    is_error: boolean;
+    duration_ms?: number;
+    n: number;
+    results: LiveResult[];
+    /** Dollars the call's children spent, summed. */
+    cost_usd?: number;
+} | {
+    type: "queue_update";
+    steering: string[];
+    follow_up: string[];
+} | {
+    type: "compaction_start";
+    reason: string;
+} | {
+    type: "compaction_end";
+    reason: string;
+    aborted: boolean;
+    will_retry: boolean;
+    error?: string;
+} | {
+    type: "retry";
+    phase: "start" | "end";
+    attempt: number;
+    error?: string;
+    success?: boolean;
+};
+export type LiveEvent = {
+    v: 1;
+    seq: number;
+    at: string;
+} & LiveBody;
+/** A line with no seq or instant yet: what a sink hands the file writer. */
+export type LiveDraft = LiveBody & {
+    at: string;
+};
+/** `<root>/state/live/<key>/r<round>`: the directory one round's logs live in.
+ * `root` is the install's (or a run's) state-bearing directory. */
+export declare function liveRoundDir(root: string, key: string, round: number): string;
+export declare const LIVE_MAIN_FILE = "main.jsonl";
+/** `lens-<id>.jsonl`. The id is a path component: anything but a plain token is
+ * refused rather than escaped. */
+export declare function lensLogName(id: string): string;
+export interface LiveRead {
+    events: LiveEvent[];
+    /** Byte offset just past the last complete line read: pass it back as
+     * `fromOffset` to read only what has been appended since. */
+    nextOffset: number;
+    /** Complete lines that were not events (garbage, or a torn line a writer
+     * later closed off). */
+    skipped: number;
+}
+/** Parse the complete lines of `text`; the bytes of a trailing partial line are
+ * not counted in `consumed`. */
+export declare function parseLiveLines(text: Buffer): {
+    events: LiveEvent[];
+    consumed: number;
+    skipped: number;
+};
+/** Read the events appended to `path` from byte `fromOffset` on. A missing file
+ * is an empty read. A last line without its newline is a write in progress (or
+ * a torn one): it is left for the next read. */
+export declare function readLiveEvents(path: string, fromOffset?: number): LiveRead;
+/** Where a file left off: the last good seq, and whether its last line is torn
+ * (non-empty and not newline-ended), so a writer can resume it. */
+export declare function resumePoint(path: string): {
+    lastSeq: number;
+    torn: boolean;
+};
+//# sourceMappingURL=events.d.ts.map

package/dist/src/live/events.d.ts.map

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

package/dist/src/live/events.js

@@ -0,0 +1,136 @@
+// LiveEvent v1: the one event log a viewer reads, whatever hosts the session.
+//
+// A host (the one-shot engine today; a bot round worker later) appends one JSON
+// line per event to
+//
+//   state/live/<key>/r<round>/main.jsonl          the round's main session
+//   state/live/<key>/r<round>/lens-<id>.jsonl     one lens session
+//
+// Each line is `{v:1, seq, at, type, ...}`. `seq` counts from 1 in its own file
+// and never repeats, so a reader that has seen seq N asks only for what follows
+// and a gap is visible. `at` is the instant the event happened, an ISO string.
+//
+// The lines are SLIM: the event stream carries a whole transcript on every
+// `message_update` and `tool_execution_update`, so the log keeps a coalesced
+// text delta per ~250 ms window (writer.ts) and, for a lens tool call, only
+// the fields round-progress reads, and only for the children that changed
+// since the line before. What a line must keep to project round-progress v2
+// (projection.ts) is exactly what the fields below name; everything else of a
+// pi event is dropped on purpose.
+//
+// The reader survives a torn last line: it consumes complete (newline-ended)
+// lines only, and the offset it returns points past the last one, so a tail
+// poll resumes there and never sees half a line. A writer that finds a file
+// whose last line is torn starts a fresh line first; the torn one is skipped.
+import { closeSync, fstatSync, openSync, readSync } from "node:fs";
+import { join } from "node:path";
+export const LIVE_EVENT_VERSION = 1;
+// ---- paths -----------------------------------------------------------------------
+/** `<root>/state/live/<key>/r<round>`: the directory one round's logs live in.
+ * `root` is the install's (or a run's) state-bearing directory. */
+export function liveRoundDir(root, key, round) {
+    return join(root, "state", "live", key, `r${round}`);
+}
+export const LIVE_MAIN_FILE = "main.jsonl";
+/** `lens-<id>.jsonl`. The id is a path component: anything but a plain token is
+ * refused rather than escaped. */
+export function lensLogName(id) {
+    if (!/^[A-Za-z0-9][A-Za-z0-9._-]*$/.test(id))
+        throw new Error(`not a lens log id: ${id}`);
+    return `lens-${id}.jsonl`;
+}
+function isEvent(value) {
+    if (value === null || typeof value !== "object" || Array.isArray(value))
+        return false;
+    const e = value;
+    return (e.v === LIVE_EVENT_VERSION &&
+        typeof e.seq === "number" &&
+        Number.isInteger(e.seq) &&
+        e.seq >= 1 &&
+        typeof e.at === "string" &&
+        Number.isFinite(Date.parse(e.at)) &&
+        typeof e.type === "string");
+}
+/** Parse the complete lines of `text`; the bytes of a trailing partial line are
+ * not counted in `consumed`. */
+export function parseLiveLines(text) {
+    const end = text.lastIndexOf(0x0a);
+    if (end < 0)
+        return { events: [], consumed: 0, skipped: 0 };
+    const events = [];
+    let skipped = 0;
+    for (const line of text.subarray(0, end).toString("utf8").split("\n")) {
+        if (line === "")
+            continue;
+        try {
+            const value = JSON.parse(line);
+            if (isEvent(value))
+                events.push(value);
+            else
+                skipped++;
+        }
+        catch {
+            skipped++;
+        }
+    }
+    return { events, consumed: end + 1, skipped };
+}
+/** Read the events appended to `path` from byte `fromOffset` on. A missing file
+ * is an empty read. A last line without its newline is a write in progress (or
+ * a torn one): it is left for the next read. */
+export function readLiveEvents(path, fromOffset = 0) {
+    let fd;
+    try {
+        fd = openSync(path, "r");
+    }
+    catch (err) {
+        if (err.code === "ENOENT")
+            return { events: [], nextOffset: fromOffset, skipped: 0 };
+        throw err;
+    }
+    try {
+        const size = fstatSync(fd).size;
+        if (size <= fromOffset)
+            return { events: [], nextOffset: Math.min(fromOffset, size), skipped: 0 };
+        const buf = Buffer.alloc(size - fromOffset);
+        let got = 0;
+        while (got < buf.length) {
+            const n = readSync(fd, buf, got, buf.length - got, fromOffset + got);
+            if (n === 0)
+                break;
+            got += n;
+        }
+        const { events, consumed, skipped } = parseLiveLines(buf.subarray(0, got));
+        return { events, nextOffset: fromOffset + consumed, skipped };
+    }
+    finally {
+        closeSync(fd);
+    }
+}
+/** Where a file left off: the last good seq, and whether its last line is torn
+ * (non-empty and not newline-ended), so a writer can resume it. */
+export function resumePoint(path) {
+    let fd;
+    try {
+        fd = openSync(path, "r");
+    }
+    catch (err) {
+        if (err.code === "ENOENT")
+            return { lastSeq: 0, torn: false };
+        throw err;
+    }
+    try {
+        const size = fstatSync(fd).size;
+        if (size === 0)
+            return { lastSeq: 0, torn: false };
+        const last = Buffer.alloc(1);
+        readSync(fd, last, 0, 1, size - 1);
+        const torn = last[0] !== 0x0a;
+        const { events } = readLiveEvents(path);
+        return { lastSeq: events.at(-1)?.seq ?? 0, torn };
+    }
+    finally {
+        closeSync(fd);
+    }
+}
+//# sourceMappingURL=events.js.map

package/dist/src/live/events.js.map

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

package/dist/src/live/writer.d.ts

@@ -0,0 +1,54 @@
+import { type LiveExecution, type LiveResult } from "./events.js";
+/** The delta window: how long text and updates are held before one line. */
+export declare const LIVE_COALESCE_MS = 250;
+type Bag = Record<string, unknown>;
+/** The task slots of a `subagent` / `lens` call (one `{agent, task}` or
+ * `{tasks:[...]}`), with the phase its task-file pointer names. */
+export declare function subagentExecutions(args: Bag): LiveExecution[];
+/** One child of a lens tool call, reduced to what round-progress reads. */
+export declare function slimResult(raw: Bag, slot: number): LiveResult;
+export interface LiveSinkMeta {
+    /** The state key the round lives under. */
+    key: string;
+    round: number;
+    /** The PR number round-progress is published for; null when there is none. */
+    pr: number | null;
+    /** The session's name (round-progress's `session`). */
+    session: string;
+    lensId?: string;
+    agent?: string;
+}
+export interface LiveSink {
+    readonly path: string;
+    /** Hear one event of the session. Never throws. */
+    feed(event: unknown): void;
+    /** Write what is pending now. */
+    flush(): void;
+    /** Flush and stop: the sink writes nothing after this. */
+    close(): void;
+}
+export interface LiveWriterOptions {
+    /** The round's directory (`liveRoundDir`). */
+    dir: string;
+    /** Milliseconds; default the wall clock. */
+    now?: () => number;
+    coalesceMs?: number;
+    /** A write that failed (never fatal): the host's sink. Omitted: nowhere. */
+    warn?: (message: string) => void;
+    /** The environment a launch plan resolves its task dirs against (the
+     * session's, not this process's). */
+    env?: Readonly<Record<string, string | undefined>>;
+    /** What a `launch_plan` call launches: the host resolves it at call start,
+     * because the task files are gone or changed by the time a reader asks. */
+    launchExecutions?: (args: Bag, env: Readonly<Record<string, string | undefined>>) => LiveExecution[];
+}
+export interface LiveWriter {
+    readonly dir: string;
+    main(meta: LiveSinkMeta): LiveSink;
+    lens(id: string, meta: LiveSinkMeta): LiveSink;
+}
+/** The writer of one round's directory: a sink for the main session and one per
+ * lens session. */
+export declare function createLiveWriter(options: LiveWriterOptions): LiveWriter;
+export {};
+//# sourceMappingURL=writer.d.ts.map

package/dist/src/live/writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writer.d.ts","sourceRoot":"","sources":["../../../src/live/writer.ts"],"names":[],"mappings":"AAeA,OAAO,EAOL,KAAK,aAAa,EAClB,KAAK,UAAU,EAEhB,MAAM,aAAa,CAAC;AAErB,4EAA4E;AAC5E,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAMpC,KAAK,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAoCnC;mEACmE;AACnE,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,GAAG,GAAG,aAAa,EAAE,CAmB7D;AAgDD,2EAA2E;AAC3E,wBAAgB,UAAU,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,CAoD7D;AAuDD,MAAM,WAAW,YAAY;IAC3B,2CAA2C;IAC3C,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,8EAA8E;IAC9E,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClB,uDAAuD;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,mDAAmD;IACnD,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IAC3B,iCAAiC;IACjC,KAAK,IAAI,IAAI,CAAC;IACd,0DAA0D;IAC1D,KAAK,IAAI,IAAI,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,8CAA8C;IAC9C,GAAG,EAAE,MAAM,CAAC;IACZ,4CAA4C;IAC5C,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC;yCACqC;IACrC,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IACnD;+EAC2E;IAC3E,gBAAgB,CAAC,EAAE,CACjB,IAAI,EAAE,GAAG,EACT,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,KAC9C,aAAa,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,IAAI,EAAE,YAAY,GAAG,QAAQ,CAAC;IACnC,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,QAAQ,CAAC;CAChD;AA0SD;mBACmB;AACnB,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,UAAU,CAcvE"}