@songsid/agend 2.3.2-beta.1 → 2.3.2-beta.11

package/dist/kiro-usage-run.js

@@ -0,0 +1,39 @@
+/**
+ * #2122: run one usage scan on a worker thread — Kiro's (kiro-usage-scan.ts: a classic conversation's JSON is tens of MB)
+ * OpenCode's (opencode-usage-scan.ts) or Antigravity's (antigravity-usage-scan.ts: SQLite reads) — so it never runs on the
+ * fleet loop. A scan that has not
+ * answered in `timeoutMs` is terminated and reads as failed; nothing it read is kept, and the next pass reads again from
+ * the same cursors.
+ */
+import { Worker } from "node:worker_threads";
+export const KIRO_SCAN_TIMEOUT_MS = 120_000;
+function worker(entry, input) {
+    const limits = { maxOldGenerationSizeMb: 768 };
+    return import.meta.url.endsWith(".ts")
+        ? new Worker(`const { workerData } = require("node:worker_threads"); import("tsx/esm/api").then(({ tsImport }) => tsImport(workerData.entry, workerData.entry));`, { eval: true, execArgv: [], resourceLimits: limits, workerData: { ...input, entry: new URL(`./${entry}.ts`, import.meta.url).href } })
+        : new Worker(new URL(`./${entry}.js`, import.meta.url), { execArgv: [], resourceLimits: limits, workerData: input });
+}
+function run(entry, input, timeoutMs, what) {
+    return new Promise((resolve, reject) => {
+        let w;
+        try {
+            w = worker(entry, input);
+        }
+        catch (err) {
+            reject(err);
+            return;
+        }
+        let done = false;
+        const finish = (fn) => { if (done)
+            return; done = true; clearTimeout(timer); void w.terminate().catch(() => { }); fn(); };
+        const timer = setTimeout(() => finish(() => reject(new Error(`${what} timed out`))), timeoutMs);
+        timer.unref?.();
+        w.on("message", (m) => finish(() => (m.ok ? resolve(m.out) : reject(new Error(m.error ?? `${what} failed`)))));
+        w.on("error", (err) => finish(() => reject(err)));
+        w.on("exit", (code) => finish(() => reject(new Error(`${what} exited (${code})`))));
+    });
+}
+export const runKiroUsageScan = (input, timeoutMs = KIRO_SCAN_TIMEOUT_MS) => run("kiro-usage-worker", input, timeoutMs, "kiro usage scan");
+export const runOpencodeUsageScan = (input, timeoutMs = KIRO_SCAN_TIMEOUT_MS) => run("opencode-usage-worker", input, timeoutMs, "opencode usage scan");
+export const runAntigravityUsageScan = (input, timeoutMs = KIRO_SCAN_TIMEOUT_MS) => run("antigravity-usage-worker", input, timeoutMs, "antigravity usage scan");
+//# sourceMappingURL=kiro-usage-run.js.map

package/dist/kiro-usage-run.js.map

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

package/dist/kiro-usage-scan.d.ts

@@ -0,0 +1,49 @@
+import type { Turn } from "./cache-ledger.js";
+/** Where reading a source stopped: what it looked like then, and the time of the last turn counted. */
+export interface KiroCursor {
+    sig: string;
+    after: number;
+}
+export interface KiroScanInstance {
+    name: string;
+    /** Its working directory as configured and as resolved (a store records either). */
+    cwds: string[];
+    /** The classic store it writes: its credential profile's, else the shared one. */
+    dbPath: string;
+    /** Keyed `classic:<conversation id>`, `tui:<file>`, `kas:<session dir>`. */
+    cursors: Record<string, KiroCursor>;
+}
+export interface KiroScanInput {
+    /** KIRO_HOME (default ~/.kiro): the TUI and V3 stores, shared by every login. */
+    kiroHome: string;
+    cutoff: number;
+    maxBytes: number;
+    instances: KiroScanInstance[];
+    /** TUI session file → its signature and cwd, from earlier scans (only a changed file is parsed to learn its cwd). */
+    tuiIndex: Record<string, {
+        sig: string;
+        cwd: string | null;
+    }>;
+}
+export interface KiroScanUpdate {
+    key: string;
+    sig: string;
+    after: number;
+    turns: Turn[];
+}
+export interface KiroScanResult {
+    name: string;
+    updates: KiroScanUpdate[];
+    /** Every source of this instance seen now (a cursor for anything else is stale). */
+    live: string[];
+    /** A store was there and could not be read: this scan proves nothing about the instance (no coverage). */
+    failed: boolean;
+}
+export interface KiroScanOutput {
+    instances: KiroScanResult[];
+    tuiIndex: KiroScanInput["tuiIndex"];
+    readBytes: number;
+    behindBytes: number;
+    behindSources: number;
+}
+export declare function scanKiroUsage(input: KiroScanInput): KiroScanOutput;

package/dist/kiro-usage-scan.js

@@ -0,0 +1,223 @@
+/**
+ * #2122 §10 step 2: one bounded read of Kiro's three stores for the usage ledger, run in a worker thread
+ * (kiro-usage-worker.ts) so the fleet loop never parses a conversation (a classic row holds the whole history: tens of
+ * MB). Synchronous and self-contained so a test can run it in-process.
+ *
+ * - Which sources: each Kiro instance's conversations — classic rows whose `key` is its working directory, TUI sessions
+ *   whose `cwd` is, and V3 sessions in its working directory's bucket. Only sources changed since the cutoff.
+ * - Incremental: a source is read again only when it changed (its signature: the row's `updated_at`, a file's
+ *   inode:size:mtime), and only turns after the last one counted (`after`) come back.
+ * - Never: a write to Kiro's stores (the database is opened read-only; each read is one statement, so Kiro's own writer
+ *   waits at most for that), a child process, a network call.
+ * - Bounded: past `maxBytes` read, a changed source is left for the next pass (counted as behind).
+ */
+import Database from "better-sqlite3";
+import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
+import { join } from "node:path";
+import { kasBucket } from "./backend/kiro-kas-store.js";
+import { kiroClassicRequestTimes, kiroClassicTurns, kiroKasTurns, kiroTuiTurns } from "./kiro-usage.js";
+const gone = (err) => err?.code === "ENOENT";
+const sigOf = (path) => {
+    const st = statSync(path);
+    return { sig: `${st.ino}:${st.size}:${st.mtimeMs}`, size: st.size, mtimeMs: st.mtimeMs };
+};
+const lines = (path) => { try {
+    return readFileSync(path, "utf8").split("\n");
+}
+catch (err) {
+    if (gone(err))
+        return [];
+    throw err;
+} };
+export function scanKiroUsage(input) {
+    let budget = input.maxBytes, behindBytes = 0, behindSources = 0;
+    const dbs = new Map();
+    const tuiIndex = Object.create(null);
+    const out = [];
+    const openDb = (path) => {
+        if (dbs.has(path))
+            return dbs.get(path);
+        let db = null;
+        // Not there (no classic conversation yet, or no Kiro at all): nothing to read. There and unopenable: a failure.
+        if (existsSync(path)) {
+            db = new Database(path, { readonly: true, fileMustExist: true });
+            db.pragma("query_only = ON");
+        }
+        dbs.set(path, db);
+        return db;
+    };
+    // A classic conversation's request times, for the dedup of a session that carried it into another engine.
+    const classicTimes = (db, id) => {
+        if (!db)
+            return [];
+        const row = db.prepare("SELECT value FROM conversations_v2 WHERE conversation_id = ?").get(id);
+        if (!row?.value)
+            return [];
+        try {
+            return kiroClassicRequestTimes(JSON.parse(row.value));
+        }
+        catch {
+            return [];
+        }
+    };
+    /** Read one changed source within the budget, or count it as behind. */
+    const within = (bytes) => {
+        if (budget <= 0) {
+            behindBytes += bytes;
+            behindSources++;
+            return false;
+        }
+        budget -= Math.max(bytes, 1);
+        return true;
+    };
+    // TUI sessions: one listing for everyone; a file's cwd is learned once per version of it.
+    let tuiNames = [];
+    let tuiFailed = false;
+    const tuiDir = join(input.kiroHome, "sessions", "cli");
+    try {
+        tuiNames = readdirSync(tuiDir).filter(n => n.endsWith(".json"));
+    }
+    catch (err) {
+        if (!gone(err))
+            tuiFailed = true;
+    }
+    const tuiFiles = [];
+    for (const n of tuiNames) {
+        const path = join(tuiDir, n);
+        try {
+            const s = sigOf(path);
+            if (s.mtimeMs < input.cutoff)
+                continue;
+            const known = input.tuiIndex[path];
+            let cwd = known?.sig === s.sig ? known.cwd : undefined;
+            if (cwd === undefined) {
+                const text = readFileSync(path, "utf8"); // a read that fails is a failure (below), not an empty store
+                try {
+                    const v = JSON.parse(text);
+                    cwd = typeof v.cwd === "string" ? v.cwd : null;
+                }
+                // Being rewritten: read again next pass. Until then whose it is can't be known, so no instance's scan is
+                // complete (no coverage, and no cursor is pruned — Prism #2605).
+                catch {
+                    tuiFailed = true;
+                    continue;
+                }
+            }
+            tuiIndex[path] = { sig: s.sig, cwd };
+            tuiFiles.push({ path, sig: s.sig, size: s.size, cwd });
+        }
+        catch (err) {
+            if (!gone(err))
+                tuiFailed = true;
+        }
+    }
+    try {
+        for (const inst of input.instances) {
+            const res = { name: inst.name, updates: [], live: [], failed: tuiFailed };
+            const cwds = new Set(inst.cwds);
+            const afterOf = (key) => Math.max(inst.cursors[key]?.after ?? -Infinity, input.cutoff);
+            const push = (key, sig, turns) => res.updates.push({ key, sig, after: turns.reduce((m, t) => Math.max(m, t.t), afterOf(key)), turns });
+            // Classic: its working directory's rows.
+            let db = null;
+            try {
+                db = openDb(inst.dbPath);
+                const rows = db ? db.prepare("SELECT conversation_id AS id, key, updated_at AS u, octet_length(value) AS n FROM conversations_v2 WHERE updated_at >= ?").all(input.cutoff) : [];
+                for (const r of rows) {
+                    if (!cwds.has(r.key))
+                        continue;
+                    const key = `classic:${r.id}`, sig = String(r.u);
+                    res.live.push(key);
+                    if (inst.cursors[key]?.sig === sig || !within(r.n))
+                        continue;
+                    const row = db.prepare("SELECT value FROM conversations_v2 WHERE key = ? AND conversation_id = ?").get(r.key, r.id);
+                    if (!row?.value)
+                        continue;
+                    let v;
+                    try {
+                        v = JSON.parse(row.value);
+                    }
+                    catch {
+                        continue;
+                    }
+                    push(key, sig, kiroClassicTurns(v, afterOf(key)));
+                }
+            }
+            catch {
+                res.failed = true;
+            }
+            // TUI: the sessions whose cwd is its working directory.
+            for (const f of tuiFiles) {
+                if (f.cwd === null || !cwds.has(f.cwd))
+                    continue;
+                const key = `tui:${f.path}`;
+                res.live.push(key);
+                if (inst.cursors[key]?.sig === f.sig)
+                    continue;
+                const sidecar = f.path.replace(/\.json$/, ".jsonl");
+                let size = f.size;
+                try {
+                    size += statSync(sidecar).size;
+                }
+                catch { /* none yet */ }
+                if (!within(size))
+                    continue;
+                try {
+                    const session = JSON.parse(readFileSync(f.path, "utf8"));
+                    const id = typeof session.session_id === "string" ? session.session_id : "";
+                    push(key, f.sig, kiroTuiTurns(session, lines(sidecar), afterOf(key), id ? classicTimes(db, id) : []));
+                }
+                catch (err) {
+                    if (!gone(err))
+                        res.failed = true;
+                }
+            }
+            // V3: its working directory's bucket.
+            for (const dir of new Set(inst.cwds.map(c => join(input.kiroHome, "sessions", kasBucket(c))))) {
+                let names = [];
+                try {
+                    names = readdirSync(dir).filter(n => !n.startsWith("."));
+                }
+                catch (err) {
+                    if (!gone(err))
+                        res.failed = true;
+                    continue;
+                }
+                for (const n of names) {
+                    const sessionPath = join(dir, n, "session.json"), messagesPath = join(dir, n, "messages.jsonl");
+                    try {
+                        const a = sigOf(sessionPath);
+                        let m = { sig: "-", size: 0, mtimeMs: 0 };
+                        try {
+                            m = sigOf(messagesPath);
+                        }
+                        catch (err) {
+                            if (!gone(err))
+                                throw err;
+                        }
+                        if (Math.max(a.mtimeMs, m.mtimeMs) < input.cutoff)
+                            continue;
+                        const key = `kas:${join(dir, n)}`, sig = `${a.sig}|${m.sig}`;
+                        res.live.push(key);
+                        if (inst.cursors[key]?.sig === sig || !within(a.size + m.size))
+                            continue;
+                        const session = JSON.parse(readFileSync(sessionPath, "utf8"));
+                        // A converted session's id is `cli_<classic id>_<suffix>`: its source's requests are counted there.
+                        const source = /^cli_(.+)_[^_]+$/.exec(n)?.[1];
+                        push(key, sig, kiroKasTurns(session, lines(messagesPath), afterOf(key), source ? classicTimes(db, source) : []));
+                    }
+                    catch (err) {
+                        if (!gone(err))
+                            res.failed = true;
+                    } // being rewritten (SyntaxError) included: next pass
+                }
+            }
+            out.push(res);
+        }
+    }
+    finally {
+        for (const db of dbs.values())
+            db?.close();
+    }
+    return { instances: out, tuiIndex, readBytes: input.maxBytes - budget, behindBytes, behindSources };
+}
+//# sourceMappingURL=kiro-usage-scan.js.map

package/dist/kiro-usage-scan.js.map

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

package/dist/kiro-usage-worker.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/kiro-usage-worker.js

@@ -0,0 +1,10 @@
+/** #2122: the Kiro usage scan's thread (kiro-usage-scan.ts): one scan per worker, its answer posted back. */
+import { parentPort, workerData } from "node:worker_threads";
+import { scanKiroUsage } from "./kiro-usage-scan.js";
+try {
+    parentPort?.postMessage({ ok: true, out: scanKiroUsage(workerData) });
+}
+catch (err) {
+    parentPort?.postMessage({ ok: false, error: String(err) });
+}
+//# sourceMappingURL=kiro-usage-worker.js.map

package/dist/kiro-usage-worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kiro-usage-worker.js","sourceRoot":"","sources":["../src/kiro-usage-worker.ts"],"names":[],"mappings":"AAAA,6GAA6G;AAC7G,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAsB,MAAM,sBAAsB,CAAC;AAEzE,IAAI,CAAC;IAAC,UAAU,EAAE,WAAW,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,aAAa,CAAC,UAA2B,CAAC,EAAE,CAAC,CAAC;AAAC,CAAC;AAC/F,OAAO,GAAG,EAAE,CAAC;IAAC,UAAU,EAAE,WAAW,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAAC,CAAC"}

package/dist/kiro-usage.d.ts

@@ -0,0 +1,58 @@
+/**
+ * #2122 §10 step 2: Kiro's usage, ESTIMATED. Kiro records no token counts (design §10.1: every `request_metadata` token
+ * field is null in the classic store, every `*_token_count` 0 in the TUI one, and V3 has no such field), so each turn is
+ * estimated from its text size the way tokscale does — the same basis as the user's tokscale-based reports (the user's
+ * decision, option B). Kiro keeps a conversation in one of three stores, by engine:
+ * - classic (legacy UI, engine v1): `<XDG_DATA_HOME>/kiro-cli/data.sqlite3`, table `conversations_v2` — kiroClassicTurns;
+ * - TUI (engine v2): `<KIRO_HOME>/sessions/cli/<id>.json` with its `<id>.jsonl` — kiroTuiTurns;
+ * - V3 (KAS): `<KIRO_HOME>/sessions/<bucket>/sess_<id>/{session.json, messages.jsonl}` — kiroKasTurns.
+ * The estimate:
+ * - fresh input: ceil(bytes / 4) of the prompt (its recorded `user_prompt_length`, else the prompt text) plus the tool
+ *   results the turn sent;
+ * - output: ceil(bytes / 4) of the response (`response_size`, TUI `assistant_response_length`, else its text);
+ * - cache read: the context the turn resent, `floor(window × context_usage_percentage / 100) − fresh input` (never below
+ *   0); the window is the conversation's `context_window_tokens` (classic: none → no cache read; TUI: none → 200,000;
+ *   V3 records none: 200,000);
+ * - cache write and reasoning: 0. A real count, should Kiro ever record one above 0, is taken instead.
+ * Credits are not read: the user's plan is not billed in them (design §10.2).
+ *
+ * The estimation formula and field mapping follow tokscale (github.com/junhoyeo/tokscale,
+ * crates/tokscale-core/src/sessions/kiro.rs at 669fdaeec54502a30468adbfa97789bb7ee2b762), MIT License,
+ * Copyright (c) 2025 Junho Yeo — see THIRD_PARTY_NOTICES.md. The code is AgEnD's own. Pure: no I/O.
+ */
+import type { Turn } from "./cache-ledger.js";
+/** The window when a TUI or V3 session records none (tokscale's DEFAULT_CONTEXT_WINDOW). */
+export declare const KIRO_DEFAULT_WINDOW = 200000;
+export interface KiroClassicTurn extends Turn {
+    index: number;
+}
+/**
+ * The estimated turns of one classic conversation (`conversations_v2.value`, parsed) whose request started after
+ * `after` (ms). One turn per `history[]` entry with `request_metadata`; an entry estimated at nothing is skipped.
+ */
+export declare function kiroClassicTurns(conversation: unknown, after: number): KiroClassicTurn[];
+/** The request start times a classic conversation recorded (for the cross-store dedup below). */
+export declare function kiroClassicRequestTimes(conversation: unknown): number[];
+export interface KiroTuiTurn extends Turn {
+    index: number;
+}
+/**
+ * The estimated turns of one TUI session — its `<id>.json` (parsed) and the lines of its `<id>.jsonl` — that started
+ * after `after` (ms). Only the messages a turn's `message_ids` name count toward it: the sidecar also carries the
+ * messages a conversation brought over from the classic engine.
+ *
+ * Dedup across stores (design §10.1): a conversation can have turns in both engines under one id. A TUI turn whose
+ * window [end − turn_duration, end] holds a request of the same conversation's classic record (`classicTimes`) is that
+ * request's, counted from the classic store: it is dropped here.
+ */
+export declare function kiroTuiTurns(session: unknown, jsonlLines: Iterable<string>, after: number, classicTimes?: readonly number[]): KiroTuiTurn[];
+/**
+ * The estimated turns of one V3 (KAS) session — its `session.json` (parsed) and the lines of its `messages.jsonl` — that
+ * started after `after` (ms). A turn runs to its `turn_end`: its `user` text and `tool_result` text are its fresh input,
+ * its `assistant` text its output, and its last `contextUsage` its context. The window is 200,000 (V3 records none).
+ *
+ * A session converted from another engine (`ensure-session`: a new id, the history copied in) holds turns that store
+ * already counted: a turn that ended before the session was created (`createdAt`) is not counted again, nor one whose
+ * window holds a request of its source's classic record (`classicTimes`).
+ */
+export declare function kiroKasTurns(session: unknown, jsonlLines: Iterable<string>, after: number, classicTimes?: readonly number[]): Turn[];