@songsid/agend 2.2.0-alpha.1 → 2.2.0-alpha.2

package/dist/cache-prices.d.ts

@@ -0,0 +1,32 @@
+/**
+ * #1468: list prices for the prompt-cache analysis — the one table, with the day it was checked against the vendors'
+ * own pricing pages. USD per million tokens, standard tier, global routing (no batch, fast, data-residency or
+ * regional uplift: AgEnD's CLIs run on subscriptions, so these are list-price equivalents, not a bill).
+ *
+ * Claude (platform.claude.com/docs/en/about-claude/pricing): a 5-minute cache write is 1.25x base input, a 1-hour
+ * write 2x; a cache hit is 0.1x, except 0.05x on Opus/Sonnet 5.5 and 0.025x on Fable/Mythos 5.1. Haiku 5.5 is priced
+ * by prompt length (over 100,000 tokens: the higher row), counting cache reads and writes.
+ * OpenAI (developers.openai.com/api/docs/pricing, …/guides/prompt-caching): on GPT-5.6 and later a cache write is
+ * 1.25x uncached input and the cache lives 30 minutes after its last write or reuse; prompts over 272K input tokens
+ * pay the long-context row.
+ */
+export declare const PRICES_CHECKED = "2026-10-09";
+export declare const PRICE_SOURCES: readonly ["https://platform.claude.com/docs/en/about-claude/pricing", "https://developers.openai.com/api/docs/pricing", "https://developers.openai.com/api/docs/guides/prompt-caching"];
+/** USD per million tokens. `write` is the one cache-write rate an OpenAI model has; Claude has `write5m`/`write1h`. */
+export interface Rates {
+    input: number;
+    read: number;
+    write5m: number;
+    write1h: number;
+    write: number;
+    output: number;
+}
+/**
+ * The table's key for a model id as a transcript records it: "claude-opus-4-5-20251101" → "claude-opus-4-5",
+ * "claude-opus-5-5[1m]" → "claude-opus-5-5". Exact keys only — "claude-opus-5" never prices "claude-opus-5-5".
+ */
+export declare function priceKey(model: string | null | undefined): string | null;
+/** The rates for one request of `model` with a prompt of `promptTokens`; null when the model is not in the table. */
+export declare function ratesFor(model: string | null | undefined, promptTokens?: number): Rates | null;
+/** Whether a prompt of this size pays the model's long-context (or over-100K) row. */
+export declare function isLongPrompt(model: string | null | undefined, promptTokens: number): boolean;

package/dist/cache-prices.js

@@ -0,0 +1,73 @@
+/**
+ * #1468: list prices for the prompt-cache analysis — the one table, with the day it was checked against the vendors'
+ * own pricing pages. USD per million tokens, standard tier, global routing (no batch, fast, data-residency or
+ * regional uplift: AgEnD's CLIs run on subscriptions, so these are list-price equivalents, not a bill).
+ *
+ * Claude (platform.claude.com/docs/en/about-claude/pricing): a 5-minute cache write is 1.25x base input, a 1-hour
+ * write 2x; a cache hit is 0.1x, except 0.05x on Opus/Sonnet 5.5 and 0.025x on Fable/Mythos 5.1. Haiku 5.5 is priced
+ * by prompt length (over 100,000 tokens: the higher row), counting cache reads and writes.
+ * OpenAI (developers.openai.com/api/docs/pricing, …/guides/prompt-caching): on GPT-5.6 and later a cache write is
+ * 1.25x uncached input and the cache lives 30 minutes after its last write or reuse; prompts over 272K input tokens
+ * pay the long-context row.
+ */
+export const PRICES_CHECKED = "2026-10-09";
+export const PRICE_SOURCES = [
+    "https://platform.claude.com/docs/en/about-claude/pricing",
+    "https://developers.openai.com/api/docs/pricing",
+    "https://developers.openai.com/api/docs/guides/prompt-caching",
+];
+const claude = (input, read, output) => ({ input, read, write5m: input * 1.25, write1h: input * 2, write: input * 1.25, output });
+const openai = (input, read, write, output) => ({ input, read, write5m: write, write1h: write, write, output });
+const TABLE = {
+    "claude-fable-5-1": { rates: [claude(10, 0.25, 50)] },
+    "claude-mythos-5-1": { rates: [claude(10, 0.25, 50)] },
+    "claude-fable-5": { rates: [claude(10, 1, 50)] },
+    "claude-mythos-5": { rates: [claude(10, 1, 50)] },
+    "claude-opus-5-5": { rates: [claude(4, 0.20, 20)] },
+    "claude-opus-5": { rates: [claude(5, 0.50, 25)] },
+    "claude-opus-4-8": { rates: [claude(5, 0.50, 25)] },
+    "claude-opus-4-7": { rates: [claude(5, 0.50, 25)] },
+    "claude-opus-4-6": { rates: [claude(5, 0.50, 25)] },
+    "claude-opus-4-5": { rates: [claude(5, 0.50, 25)] },
+    "claude-opus-4-1": { rates: [claude(15, 1.50, 75)] },
+    "claude-opus-4": { rates: [claude(15, 1.50, 75)] },
+    "claude-sonnet-5-5": { rates: [claude(2, 0.10, 10)] },
+    "claude-sonnet-5": { rates: [claude(2, 0.20, 10)] },
+    "claude-sonnet-4-6": { rates: [claude(3, 0.30, 15)] },
+    "claude-sonnet-4-5": { rates: [claude(3, 0.30, 15)] },
+    "claude-sonnet-4": { rates: [claude(3, 0.30, 15)] },
+    "claude-haiku-5-5": { rates: [claude(0.10, 0.01, 0.50), claude(0.50, 0.05, 2.50)], longOver: 100_000 },
+    "claude-haiku-4-5": { rates: [claude(1, 0.10, 5)] },
+    "gpt-6.1-sol": { rates: [openai(2, 0.10, 2.50, 10), openai(4, 0.20, 5, 15)], longOver: 272_000 },
+    "gpt-6-sol": { rates: [openai(2, 0.20, 2.50, 10), openai(4, 0.40, 5, 15)], longOver: 272_000 },
+    "gpt-6-astra": { rates: [openai(10, 1, 12.50, 50), openai(20, 2, 25, 75)], longOver: 272_000 },
+    "gpt-6-luna": { rates: [openai(0.10, 0.01, 0.125, 0.50), openai(0.20, 0.02, 0.25, 0.75)], longOver: 272_000 },
+    "gpt-5.6-sol": { rates: [openai(4, 0.40, 5, 20), openai(8, 0.80, 10, 30)], longOver: 272_000 },
+    "gpt-5.6-terra": { rates: [openai(2, 0.20, 2.50, 12), openai(4, 0.40, 5, 18)], longOver: 272_000 },
+    "gpt-5.6-luna": { rates: [openai(0.20, 0.02, 0.25, 1.20), openai(0.40, 0.04, 0.50, 1.80)], longOver: 272_000 },
+};
+/**
+ * The table's key for a model id as a transcript records it: "claude-opus-4-5-20251101" → "claude-opus-4-5",
+ * "claude-opus-5-5[1m]" → "claude-opus-5-5". Exact keys only — "claude-opus-5" never prices "claude-opus-5-5".
+ */
+export function priceKey(model) {
+    if (typeof model !== "string")
+        return null;
+    const id = model.trim().toLowerCase().replace(/\[[^\]]*\]$/, "").replace(/-\d{8}$/, "");
+    return Object.prototype.hasOwnProperty.call(TABLE, id) ? id : null;
+}
+/** The rates for one request of `model` with a prompt of `promptTokens`; null when the model is not in the table. */
+export function ratesFor(model, promptTokens = 0) {
+    const key = priceKey(model);
+    if (!key)
+        return null;
+    const row = TABLE[key];
+    return row.longOver !== undefined && promptTokens > row.longOver && row.rates[1] ? row.rates[1] : row.rates[0];
+}
+/** Whether a prompt of this size pays the model's long-context (or over-100K) row. */
+export function isLongPrompt(model, promptTokens) {
+    const key = priceKey(model);
+    const row = key ? TABLE[key] : undefined;
+    return !!row && row.longOver !== undefined && promptTokens > row.longOver;
+}
+//# sourceMappingURL=cache-prices.js.map

package/dist/cache-prices.js.map

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

package/dist/cache-scan.d.ts

@@ -0,0 +1,39 @@
+export interface ScanOptions {
+    maxBytes: number;
+    /** The inode the caller's cursor belongs to: if the descriptor opened is another file, nothing is read. */
+    ino?: number;
+    chunkBytes?: number;
+    wholeUpTo?: number;
+    headBytes?: number;
+    tailBytes?: number;
+}
+/** A whole line (`whole`), or a long one's two ends (`head`/`tail`). `length` is the line's size in bytes. */
+export type ScanLine = {
+    whole: Buffer;
+    length: number;
+} | {
+    head: Buffer;
+    tail: Buffer;
+    length: number;
+};
+export interface ScanResult {
+    /** Where the next pass starts: just after the last complete line read. */
+    offset: number;
+    /** The file's size when this pass started (of the descriptor actually opened). */
+    size: number;
+    /** Nothing complete is left before `size`. */
+    done: boolean;
+    /** Bytes committed (whole lines). */
+    bytes: number;
+    /** Bytes physically read — what a pass's budget is charged, unfinished line included. */
+    read: number;
+    /** The inode of the descriptor opened. */
+    ino: number;
+    /** `opts.ino` was given and the path now names another file: nothing was read. */
+    replaced?: true;
+}
+export declare const SCAN_CHUNK_BYTES: number;
+export declare const SCAN_WHOLE_UP_TO: number;
+export declare function scanJsonl(path: string, from: number, opts: ScanOptions, onLine: (line: ScanLine) => void): Promise<ScanResult>;
+/** The JSON object that starts at `start` (an opening brace) in `text`, or null if it does not close there. */
+export declare function objectAt(text: string, start: number): string | null;

package/dist/cache-scan.js

@@ -0,0 +1,115 @@
+/**
+ * #1468: read a JSONL file from a byte offset, line by line, without ever holding a large line or blocking the
+ * fleet loop. Transcripts reach hundreds of MB, and a single line (a tool result) can be tens of MB:
+ * - every chunk read is awaited, so the event loop runs between chunks;
+ * - a line up to `wholeUpTo` bytes is handed over whole; a longer one only as its first `headBytes` and last
+ *   `tailBytes` (a Claude assistant line has its model/id at the start and its usage/timestamp at the end);
+ * - a pass stops at the first line end once `maxBytes` have been read (physically: an unfinished line costs what it
+ *   took to read) and returns the offset to resume from — always a line start. An unfinished last line (a file
+ *   being appended to) is left for the next pass;
+ * - given the cursor's inode, a descriptor that turns out to be another file is not read at all.
+ */
+import { open } from "node:fs/promises";
+export const SCAN_CHUNK_BYTES = 256 * 1024;
+export const SCAN_WHOLE_UP_TO = 1024 * 1024;
+const HEAD_BYTES = 8 * 1024;
+const TAIL_BYTES = 64 * 1024;
+export async function scanJsonl(path, from, opts, onLine) {
+    const chunkBytes = opts.chunkBytes ?? SCAN_CHUNK_BYTES;
+    const wholeUpTo = opts.wholeUpTo ?? SCAN_WHOLE_UP_TO;
+    const headBytes = opts.headBytes ?? HEAD_BYTES;
+    const tailBytes = opts.tailBytes ?? TAIL_BYTES;
+    const fh = await open(path, "r");
+    try {
+        const st = await fh.stat();
+        const size = st.size, ino = st.ino;
+        // The file as opened, not as listed: a rename between the two must not feed another file's lines to this cursor.
+        if (opts.ino !== undefined && ino !== opts.ino)
+            return { offset: from, size, done: true, bytes: 0, read: 0, ino, replaced: true };
+        let pos = from, committed = from;
+        let parts = [], partLen = 0;
+        let big = false, head = Buffer.alloc(0), tail = Buffer.alloc(0), total = 0;
+        const append = (seg) => {
+            if (!big) {
+                if (partLen + seg.length <= wholeUpTo) {
+                    parts.push(seg);
+                    partLen += seg.length;
+                    return;
+                }
+                const all = Buffer.concat([...parts, seg]);
+                head = Buffer.from(all.subarray(0, headBytes));
+                tail = Buffer.from(all.subarray(Math.max(0, all.length - tailBytes)));
+                total = all.length;
+                big = true;
+                parts = [];
+                partLen = 0;
+                return;
+            }
+            total += seg.length;
+            const joined = seg.length >= tailBytes ? seg : Buffer.concat([tail, seg]);
+            tail = Buffer.from(joined.subarray(Math.max(0, joined.length - tailBytes)));
+        };
+        const emit = () => {
+            if (big)
+                onLine({ head, tail, length: total });
+            else if (partLen > 0)
+                onLine({ whole: parts.length === 1 ? parts[0] : Buffer.concat(parts, partLen), length: partLen });
+            parts = [];
+            partLen = 0;
+            big = false;
+            head = Buffer.alloc(0);
+            tail = Buffer.alloc(0);
+            total = 0;
+        };
+        while (pos < size) {
+            const want = Math.min(chunkBytes, size - pos);
+            const chunk = Buffer.allocUnsafe(want);
+            const { bytesRead } = await fh.read(chunk, 0, want, pos);
+            if (bytesRead <= 0)
+                break;
+            let i = 0;
+            while (i < bytesRead) {
+                const nl = chunk.indexOf(10, i);
+                if (nl === -1 || nl >= bytesRead) {
+                    append(chunk.subarray(i, bytesRead));
+                    i = bytesRead;
+                    break;
+                }
+                append(chunk.subarray(i, nl));
+                emit();
+                committed = pos + nl + 1;
+                i = nl + 1;
+                if (pos + bytesRead - from >= opts.maxBytes)
+                    return { offset: committed, size, done: committed >= size, bytes: committed - from, read: pos + bytesRead - from, ino };
+            }
+            pos += bytesRead;
+        }
+        return { offset: committed, size, done: true, bytes: committed - from, read: pos - from, ino };
+    }
+    finally {
+        await fh.close();
+    }
+}
+/** The JSON object that starts at `start` (an opening brace) in `text`, or null if it does not close there. */
+export function objectAt(text, start) {
+    if (text[start] !== "{")
+        return null;
+    let depth = 0, inString = false;
+    for (let i = start; i < text.length; i++) {
+        const c = text[i];
+        if (inString) {
+            if (c === "\\")
+                i++;
+            else if (c === "\"")
+                inString = false;
+        }
+        else if (c === "\"")
+            inString = true;
+        else if (c === "{")
+            depth++;
+        else if (c === "}" && --depth === 0)
+            return text.slice(start, i + 1);
+    }
+    return null;
+}
+//# sourceMappingURL=cache-scan.js.map

package/dist/cache-scan.js.map

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

package/dist/cache-service.d.ts

@@ -0,0 +1,115 @@
+import { type InstanceAnalysis } from "./cache-analysis.js";
+/** An instance to analyse: a fleet.yaml instance, or a ClassicBot room (its workspace under the AgEnD home). */
+export interface CacheInstance {
+    name: string;
+    backend: string;
+    workingDirectory: string;
+    ledgerPath: string;
+}
+export interface CacheServiceOptions {
+    instances(): CacheInstance[];
+    claudeProjectsDir(): string;
+    claudeKey(workingDirectory: string): string;
+    codexSessionsDir(): string;
+    /** Rollout files with their mtimes (the shared rollout index). */
+    listRollouts(root: string): Array<{
+        path: string;
+        mtimeMs: number;
+    }>;
+    /** Where the rollout → working-directory map is kept (one session_meta read per rollout, ever). */
+    metaPath: string;
+    now?: () => number;
+    passBytes?: number;
+    pauseMs?: number;
+    intervalMs?: number;
+    log?: (level: "info" | "warn" | "debug", msg: string, extra?: Record<string, unknown>) => void;
+}
+export type CacheWindow = "24h" | "7d" | "30d";
+export declare const WINDOWS: Record<CacheWindow, number>;
+export interface InstanceReport {
+    name: string;
+    backend: string;
+    /**
+     * "ok" with `analysis`; "no_data": nothing read yet (or no transcript); "credit_billed": kiro; "unsupported";
+     * "shared": its transcripts cannot be told apart from another instance's (the same working directory) — `with`.
+     */
+    status: "ok" | "no_data" | "credit_billed" | "unsupported" | "shared";
+    with?: string[];
+    analysis?: InstanceAnalysis;
+}
+export interface CacheReport {
+    window: CacheWindow;
+    from: number;
+    to: number;
+    pricesChecked: string;
+    priceSources: readonly string[];
+    /** `caughtUp`: a catch-up has finished since the fleet started (before that, what is shown may be partial). */
+    scanning: {
+        active: boolean;
+        caughtUp: boolean;
+        pendingBytes: number;
+        pendingFiles: number;
+    };
+    fleet: {
+        expiryCost: number;
+        saving: number;
+        recommended: number;
+        analysed: number;
+        priced: boolean;
+    };
+    instances: InstanceReport[];
+}
+export declare class CacheService {
+    private readonly o;
+    private readonly ledgers;
+    private readonly dirty;
+    /** Rollout path → the inode its session_meta was read from, and the cwd it names (null: not a session_meta). */
+    private meta;
+    private metaDirty;
+    private running;
+    private timer;
+    private stopped;
+    private pending;
+    private caughtUp;
+    private readonly now;
+    constructor(o: CacheServiceOptions);
+    /** Catch up now (joins a catch-up already running). */
+    kick(): Promise<void>;
+    /** Keep up on a timer from now on (the first report starts it). */
+    start(): void;
+    stop(): void;
+    scanning(): CacheReport["scanning"];
+    private catchUp;
+    private ledgerFor;
+    /**
+     * The instances whose transcripts land where another's do — the same Claude project (working directory), the
+     * same Codex cwd — mapped to the others. They are not read: nothing in a transcript says which one wrote it.
+     */
+    private shared;
+    private passing;
+    /**
+     * One bounded pass over every instance's files. Returns the bytes still behind afterwards. Passes never overlap
+     * (two reading one file from the same cursor would count it twice): a pass asked for during another runs after it.
+     */
+    pass(): Promise<number>;
+    private passOnce;
+    /** A file that is not the one the cursor read (another inode, or shorter): keep the session's end, start at its end. */
+    private followFromEnd;
+    private read;
+    private claudeFiles;
+    /** Codex rollouts of the last KEEP_DAYS, by the instance whose working directory their session_meta names. */
+    private codexFilesByInstance;
+    /** Write what changed; whatever fails to write stays dirty and is written by a later pass. */
+    private save;
+    /** The analysis for a window, from the ledgers as they are now (a catch-up is started, not waited for). */
+    report(window: CacheWindow): Promise<CacheReport>;
+}
+/**
+ * A rollout's session_meta, read with one bounded read through the descriptor whose inode it records. Null while the
+ * first line is not complete yet (the next pass reads it again); `cwd: null` for a complete first line that is not
+ * a session_meta.
+ */
+export declare function rolloutMeta(path: string): Promise<{
+    ino: number;
+    cwd: string | null;
+} | null>;