@knpkv/agent-usage 0.1.0

package/dist/core/Store.js

@@ -0,0 +1,376 @@
+/**
+ * The per-machine SQLite store: Usage Events, Ingest Cursors, Limit Snapshots, Balance Readings and
+ * cached ticket titles.
+ *
+ * **Mental model**
+ *
+ * - **Facts only** (ADR 0002). Rows hold token counts and Attribution Inputs; Bookings and costs are
+ *   derived by callers. No column can hold prompt or response text.
+ * - **A chunk commits whole.** A file chunk's events, observations and the cursor past them land in
+ *   one transaction, so a pass killed mid-backfill neither loses nor double-counts: the next pass
+ *   resumes from the cursor, and event keys absorb any overlap.
+ * - **Every observation is kept; series are compressed when read.** Rollouts are read file by file,
+ *   so a limit's history arrives interleaved; compressing at write time would lose confirmations a
+ *   later file needs. Reads keep only the rows where a series' reading changed (Codex echoes one per
+ *   request), plus each series' last observation, which is what "read … ago" reports.
+ * - **Usage is pre-aggregated into 15-minute buckets** by every dimension pricing and Booking need.
+ *   Every time zone's offset is a multiple of 15 minutes, so callers roll buckets up into local
+ *   hours, days and weeks without touching raw events.
+ *
+ * @module
+ */
+import { SqliteMigrator } from "@effect/sql-sqlite-node";
+import { Context, Effect, Layer, Option, Schema } from "effect";
+import { SqlClient } from "effect/sql";
+import { Agent, AttributionInputs, BalanceKind, BalanceValue, Count, LimitReading, ObservationSource, Tokens, WindowMinutes } from "./Model.js";
+import { LONG_PROMPT_TOKENS } from "./Pricing.js";
+export class StoreError extends Schema.TaggedError()("StoreError", {
+    operation: Schema.String,
+    cause: Schema.Defect()
+}) {
+}
+const storeError = (operation) => (cause) => new StoreError({ operation, cause });
+/** How far a source file has been read, and the reader state to resume with (reader-owned JSON). */
+export const Cursor = Schema.Struct({
+    /** Device and inode: a file that was replaced reads from 0 again. */
+    identity: Schema.String,
+    offset: Count,
+    state: Schema.String
+});
+/** Usage summed over one 15-minute bucket and every dimension that prices or books it. */
+export const UsageGroup = Schema.Struct({
+    bucketStart: Schema.Int,
+    agent: Agent,
+    model: Schema.String,
+    fast: Schema.Boolean,
+    longPrompt: Schema.Boolean,
+    attribution: AttributionInputs,
+    requests: Count,
+    tokens: Tokens
+});
+export const TicketTitle = Schema.Struct({
+    key: Schema.String,
+    /** Null when the lookup ran and found no title. */
+    summary: Schema.NullOr(Schema.String),
+    fetchedAt: Schema.Int
+});
+export const BUCKET_MILLIS = 15 * 60 * 1000;
+const EVENT_BATCH = 400;
+/**
+ * A limit series' identity, as the report draws it: Codex windows by length (a plan change moves the
+ * weekly window between its primary and secondary slots), everything else by the provider's key.
+ * Compression must use the same identity, or a slot change hides a real transition.
+ */
+const seriesOf = (table) => `CASE WHEN ${table}source = 'codex-rollout' AND ${table}window_minutes IS NOT NULL` +
+    ` THEN 'w' || ${table}window_minutes ELSE ${table}label END`;
+const GroupRow = Schema.Struct({
+    bucket_start: Schema.Int,
+    agent: Agent,
+    model: Schema.String,
+    fast: Schema.Literals([0, 1]),
+    long_prompt: Schema.Literals([0, 1]),
+    cwd: Schema.String,
+    branch: Schema.String,
+    active_ticket: Schema.NullOr(Schema.String),
+    requests: Count,
+    input: Count,
+    output: Count,
+    reasoning: Count,
+    cache_read: Count,
+    cache_write_5m: Count,
+    cache_write_1h: Count
+});
+const SnapshotRow = Schema.Struct({
+    agent: Agent,
+    machine: Schema.String,
+    source: ObservationSource,
+    label: Schema.String,
+    window_minutes: WindowMinutes,
+    observed_at: Schema.Int,
+    reading: Schema.fromJsonString(LimitReading)
+});
+const BalanceRow = Schema.Struct({
+    kind: BalanceKind,
+    machine: Schema.String,
+    observed_at: Schema.Int,
+    value: Schema.fromJsonString(BalanceValue)
+});
+const CursorRow = Schema.Struct({ identity: Schema.String, offset: Count, state: Schema.String });
+const TicketRow = Schema.Struct({ key: Schema.String, summary: Schema.NullOr(Schema.String), fetched_at: Schema.Int });
+const ReadingJson = Schema.fromJsonString(LimitReading);
+const BalanceJson = Schema.fromJsonString(BalanceValue);
+const encodeReading = Schema.encodeSync(ReadingJson);
+const encodeBalance = Schema.encodeSync(BalanceJson);
+const migrations = SqliteMigrator.fromRecord({
+    "0001_usage": Effect.gen(function* () {
+        const sql = yield* SqlClient.SqlClient;
+        yield* sql `
+      CREATE TABLE usage_events (
+        agent TEXT NOT NULL,
+        dedupe_key TEXT NOT NULL,
+        machine TEXT NOT NULL,
+        session_id TEXT NOT NULL,
+        occurred_at INTEGER NOT NULL,
+        model TEXT NOT NULL,
+        fast INTEGER NOT NULL CHECK (fast IN (0, 1)),
+        input INTEGER NOT NULL,
+        output INTEGER NOT NULL,
+        reasoning INTEGER NOT NULL,
+        cache_read INTEGER NOT NULL,
+        cache_write_5m INTEGER NOT NULL,
+        cache_write_1h INTEGER NOT NULL,
+        cwd TEXT NOT NULL,
+        branch TEXT NOT NULL,
+        active_ticket TEXT,
+        PRIMARY KEY (agent, dedupe_key)
+      )
+    `;
+        yield* sql `CREATE INDEX usage_events_time ON usage_events (occurred_at)`;
+        yield* sql `
+      CREATE TABLE ingest_cursors (
+        agent TEXT NOT NULL,
+        file_key TEXT NOT NULL,
+        identity TEXT NOT NULL,
+        offset INTEGER NOT NULL,
+        state TEXT NOT NULL,
+        PRIMARY KEY (agent, file_key)
+      )
+    `;
+        yield* sql `
+      CREATE TABLE limit_snapshots (
+        agent TEXT NOT NULL,
+        machine TEXT NOT NULL,
+        source TEXT NOT NULL,
+        label TEXT NOT NULL,
+        window_minutes INTEGER,
+        observed_at INTEGER NOT NULL,
+        reading TEXT NOT NULL,
+        PRIMARY KEY (machine, agent, source, label, observed_at)
+      )
+    `;
+        yield* sql `CREATE INDEX limit_snapshots_time ON limit_snapshots (machine, observed_at)`;
+        yield* sql `
+      CREATE TABLE balance_readings (
+        kind TEXT NOT NULL,
+        machine TEXT NOT NULL,
+        observed_at INTEGER NOT NULL,
+        value TEXT NOT NULL,
+        PRIMARY KEY (kind, machine, observed_at)
+      )
+    `;
+        yield* sql `
+      CREATE TABLE tickets (
+        key TEXT PRIMARY KEY,
+        summary TEXT,
+        fetched_at INTEGER NOT NULL
+      )
+    `;
+    })
+});
+export class UsageStore extends Context.Service()("@knpkv/agent-usage/core/Store/UsageStore") {
+    static layer = Layer.effect(UsageStore, Effect.gen(function* () {
+        const sql = yield* SqlClient.SqlClient;
+        yield* SqliteMigrator.run({ loader: migrations }).pipe(Effect.mapError(storeError("migrate")));
+        const insertEvents = Effect.fnUntraced(function* (events) {
+            let added = 0;
+            for (let start = 0; start < events.length; start += EVENT_BATCH) {
+                const rows = events.slice(start, start + EVENT_BATCH).map((event) => ({
+                    agent: event.agent,
+                    dedupe_key: event.dedupeKey,
+                    machine: event.machine,
+                    session_id: event.sessionId,
+                    occurred_at: event.occurredAt,
+                    model: event.model,
+                    fast: event.fast ? 1 : 0,
+                    input: event.tokens.input,
+                    output: event.tokens.output,
+                    reasoning: event.tokens.reasoning,
+                    cache_read: event.tokens.cacheRead,
+                    cache_write_5m: event.tokens.cacheWrite5m,
+                    cache_write_1h: event.tokens.cacheWrite1h,
+                    cwd: event.attribution.cwd,
+                    branch: event.attribution.branch,
+                    active_ticket: event.attribution.activeTicket
+                }));
+                const inserted = yield* sql `
+            INSERT INTO usage_events ${sql.insert(rows)}
+            ON CONFLICT DO NOTHING
+            RETURNING dedupe_key
+          `.pipe(Effect.flatMap(Schema.decodeUnknownEffect(Schema.Array(Schema.Struct({ dedupe_key: Schema.String })))));
+                added += inserted.length;
+                // A Claude request read again with larger counts (its final streamed usage) takes them;
+                // its time and attribution stay as first recorded. Codex keys are byte offsets: never.
+                const fresh = new Set(inserted.map((row) => row.dedupe_key));
+                for (const event of events.slice(start, start + EVENT_BATCH)) {
+                    if (event.agent !== "claude" || fresh.has(event.dedupeKey))
+                        continue;
+                    yield* sql `
+              UPDATE usage_events SET
+                input = ${event.tokens.input}, output = ${event.tokens.output},
+                reasoning = ${event.tokens.reasoning}, cache_read = ${event.tokens.cacheRead},
+                cache_write_5m = ${event.tokens.cacheWrite5m}, cache_write_1h = ${event.tokens.cacheWrite1h}
+              WHERE agent = 'claude' AND dedupe_key = ${event.dedupeKey} AND output < ${event.tokens.output}
+            `;
+                }
+            }
+            return added;
+        });
+        const insertSnapshots = Effect.fnUntraced(function* (snapshots) {
+            for (let start = 0; start < snapshots.length; start += EVENT_BATCH) {
+                const rows = snapshots.slice(start, start + EVENT_BATCH).map((snapshot) => ({
+                    agent: snapshot.agent,
+                    machine: snapshot.machine,
+                    source: snapshot.source,
+                    label: snapshot.label,
+                    window_minutes: snapshot.windowMinutes,
+                    observed_at: snapshot.observedAt,
+                    reading: encodeReading(snapshot.reading)
+                }));
+                yield* sql `INSERT INTO limit_snapshots ${sql.insert(rows)} ON CONFLICT DO NOTHING`;
+            }
+        });
+        const insertBalances = Effect.fnUntraced(function* (balances) {
+            for (let start = 0; start < balances.length; start += EVENT_BATCH) {
+                const rows = balances.slice(start, start + EVENT_BATCH).map((balance) => ({
+                    kind: balance.kind,
+                    machine: balance.machine,
+                    observed_at: balance.observedAt,
+                    value: encodeBalance(balance.value)
+                }));
+                yield* sql `INSERT INTO balance_readings ${sql.insert(rows)} ON CONFLICT DO NOTHING`;
+            }
+        });
+        const recordObservations = Effect.fn("UsageStore.recordObservations")((snapshots, balances) => sql.withTransaction(Effect.andThen(insertSnapshots(snapshots), insertBalances(balances))).pipe(Effect.mapError(storeError("record-observations"))));
+        const commitChunk = Effect.fn("UsageStore.commitChunk")((chunk) => sql.withTransaction(Effect.gen(function* () {
+            const eventsAdded = yield* insertEvents(chunk.events);
+            yield* insertSnapshots(chunk.snapshots);
+            yield* insertBalances(chunk.balances);
+            yield* sql `
+            INSERT INTO ingest_cursors ${sql.insert({
+                agent: chunk.agent,
+                file_key: chunk.fileKey,
+                identity: chunk.cursor.identity,
+                offset: chunk.cursor.offset,
+                state: chunk.cursor.state
+            })}
+            ON CONFLICT (agent, file_key) DO UPDATE SET
+              identity = excluded.identity, offset = excluded.offset, state = excluded.state
+          `;
+            return { eventsAdded };
+        })).pipe(Effect.mapError(storeError("commit-chunk"))));
+        const cursor = Effect.fn("UsageStore.cursor")((agent, fileKey) => sql `SELECT identity, offset, state FROM ingest_cursors WHERE agent = ${agent} AND file_key = ${fileKey}`.pipe(Effect.flatMap(Schema.decodeUnknownEffect(Schema.Array(CursorRow))), Effect.map((rows) => Option.fromNullishOr(rows[0])), Effect.mapError(storeError("read-cursor"))));
+        const usageGroups = Effect.fn("UsageStore.usageGroups")((range) => sql `
+          SELECT
+            (occurred_at - occurred_at % ${BUCKET_MILLIS}) AS bucket_start,
+            agent, model, fast,
+            (input + cache_read + cache_write_5m + cache_write_1h) > ${LONG_PROMPT_TOKENS} AS long_prompt,
+            cwd, branch, active_ticket,
+            count(*) AS requests,
+            sum(input) AS input, sum(output) AS output, sum(reasoning) AS reasoning,
+            sum(cache_read) AS cache_read, sum(cache_write_5m) AS cache_write_5m, sum(cache_write_1h) AS cache_write_1h
+          FROM usage_events
+          WHERE machine = ${range.machine} AND occurred_at >= ${range.from} AND occurred_at < ${range.to}
+          -- Requests with and without cache traffic price apart: a model may lack a cache rate, and
+          -- that must leave only those requests unpriced, not the whole bucket.
+          GROUP BY bucket_start, agent, model, fast, long_prompt, cache_read > 0,
+            cache_write_5m + cache_write_1h > 0, cwd, branch, active_ticket
+          ORDER BY bucket_start, agent, model
+        `.pipe(Effect.flatMap(Schema.decodeUnknownEffect(Schema.Array(GroupRow))), Effect.map((rows) => rows.map((row) => ({
+            bucketStart: row.bucket_start,
+            agent: row.agent,
+            model: row.model,
+            fast: row.fast === 1,
+            longPrompt: row.long_prompt === 1,
+            attribution: { cwd: row.cwd, branch: row.branch, activeTicket: row.active_ticket },
+            requests: row.requests,
+            tokens: {
+                input: row.input,
+                output: row.output,
+                reasoning: row.reasoning,
+                cacheRead: row.cache_read,
+                cacheWrite5m: row.cache_write_5m,
+                cacheWrite1h: row.cache_write_1h
+            }
+        }))), Effect.mapError(storeError("usage-groups"))));
+        const places = Effect.fn("UsageStore.places")((machine) => sql `SELECT DISTINCT branch, cwd FROM usage_events WHERE machine = ${machine}`.pipe(Effect.flatMap(Schema.decodeUnknownEffect(Schema.Array(Schema.Struct({ branch: Schema.String, cwd: Schema.String })))), Effect.mapError(storeError("places"))));
+        const limitSnapshots = Effect.fn("UsageStore.limitSnapshots")((range) => sql `
+          WITH in_range AS (
+            SELECT agent, machine, source, label, window_minutes, observed_at, reading, series,
+              coalesce(window_minutes, 'null') || ' ' || reading AS signature,
+              lag(coalesce(window_minutes, 'null') || ' ' || reading)
+                OVER (PARTITION BY agent, source, series ORDER BY observed_at) AS previous,
+              lag(observed_at) OVER (PARTITION BY agent, source, series ORDER BY observed_at) AS previous_at,
+              max(CASE WHEN label = '*' THEN observed_at END) OVER (
+                PARTITION BY agent, source ORDER BY observed_at ROWS BETWEEN UNBOUNDED PRECEDING AND 1 PRECEDING
+              ) AS failed_at,
+              max(CASE WHEN label <> '*' THEN observed_at END) OVER (
+                PARTITION BY agent, source ORDER BY observed_at ROWS BETWEEN UNBOUNDED PRECEDING AND 1 PRECEDING
+              ) AS succeeded_at,
+              row_number() OVER (PARTITION BY agent, source, series ORDER BY observed_at DESC) AS from_end
+            FROM (
+              SELECT *, ${sql.literal(seriesOf(""))} AS series FROM limit_snapshots
+              WHERE machine = ${range.machine} AND observed_at >= ${range.from} AND observed_at < ${range.to}
+            )
+          ),
+          series_before AS (
+            SELECT agent, source, ${sql.literal(seriesOf(""))} AS series, max(observed_at) AS observed_at FROM limit_snapshots
+            WHERE machine = ${range.machine} AND observed_at < ${range.from}
+            GROUP BY agent, source, series
+          )
+          SELECT snapshot.agent, snapshot.machine, snapshot.source, snapshot.label, snapshot.window_minutes,
+            snapshot.observed_at, snapshot.reading
+          FROM series_before JOIN limit_snapshots AS snapshot
+            ON snapshot.machine = ${range.machine} AND snapshot.agent = series_before.agent
+            AND snapshot.source = series_before.source AND snapshot.observed_at = series_before.observed_at
+            AND ${sql.literal(seriesOf("snapshot."))} = series_before.series
+          UNION ALL
+          -- A row starts a new step when its reading changed, or when the other kind of reading (a
+          -- source-wide failure for a window, a window for a failure) came since this series' last row.
+          SELECT agent, machine, source, label, window_minutes, observed_at, reading FROM in_range
+          WHERE from_end = 1 OR previous IS NULL OR previous <> signature
+            OR (label <> '*' AND failed_at > previous_at)
+            OR (label = '*' AND succeeded_at > previous_at)
+          ORDER BY observed_at, agent, label
+        `.pipe(Effect.flatMap(Schema.decodeUnknownEffect(Schema.Array(SnapshotRow))), Effect.map((rows) => rows.map((row) => ({
+            agent: row.agent,
+            machine: row.machine,
+            source: row.source,
+            label: row.label,
+            windowMinutes: row.window_minutes,
+            observedAt: row.observed_at,
+            reading: row.reading
+        }))), Effect.mapError(storeError("limit-snapshots"))));
+        const latestBalances = Effect.fn("UsageStore.latestBalances")((machine) => sql `
+        SELECT kind, machine, observed_at, value FROM balance_readings AS outer_reading
+        WHERE machine = ${machine} AND observed_at = (
+          SELECT max(observed_at) FROM balance_readings AS inner_reading
+          WHERE inner_reading.kind = outer_reading.kind AND inner_reading.machine = outer_reading.machine
+        )
+        ORDER BY kind, machine
+      `.pipe(Effect.flatMap(Schema.decodeUnknownEffect(Schema.Array(BalanceRow))), Effect.map((rows) => rows.map((row) => ({
+            kind: row.kind,
+            machine: row.machine,
+            observedAt: row.observed_at,
+            value: row.value
+        }))), Effect.mapError(storeError("latest-balances"))));
+        const tickets = Effect.fn("UsageStore.tickets")((keys) => keys.length === 0
+            ? Effect.succeed([])
+            : sql `SELECT key, summary, fetched_at FROM tickets WHERE ${sql.in("key", keys)}`.pipe(Effect.flatMap(Schema.decodeUnknownEffect(Schema.Array(TicketRow))), Effect.map((rows) => rows.map((row) => ({ key: row.key, summary: row.summary, fetchedAt: row.fetched_at }))), Effect.mapError(storeError("tickets"))));
+        const saveTicket = Effect.fn("UsageStore.saveTicket")((ticket) => sql `
+          INSERT INTO tickets ${sql.insert({ key: ticket.key, summary: ticket.summary, fetched_at: ticket.fetchedAt })}
+          ON CONFLICT (key) DO UPDATE SET summary = excluded.summary, fetched_at = excluded.fetched_at
+        `.pipe(Effect.asVoid, Effect.mapError(storeError("save-ticket"))));
+        return UsageStore.of({
+            cursor,
+            commitChunk,
+            recordObservations,
+            usageGroups,
+            places,
+            limitSnapshots,
+            latestBalances,
+            tickets,
+            saveTicket
+        });
+    }));
+}
+//# sourceMappingURL=Store.js.map

package/dist/core/Store.js.map

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

package/dist/core/Tickets.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Jira titles for ticket Bookings, looked up with `acli` and cached in the store for a day.
+ *
+ * **Mental model**
+ *
+ * - **Optional decoration.** A Booking is its key; a title only helps read it. Lookups run in the
+ *   background after an ingest pass, so a slow or missing `acli` never delays a page.
+ * - **Three answers, never blank.** A title is Known, or Unknown because Jira has no such ticket
+ *   (`NotFound`, cached like a title) or because no lookup has succeeded yet (`NotLookedUp`).
+ * - **A failed lookup caches nothing**, so the next pass tries again, and the failure is reported
+ *   rather than swallowed.
+ *
+ * @module
+ */
+import { Effect } from "effect";
+import { ChildProcessSpawner } from "effect/process";
+import type { TicketTitleValue } from "./Model.js";
+import { type StoreError, UsageStore } from "./Store.js";
+declare const TicketLookupFailed_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "TicketLookupFailed";
+} & Readonly<A>;
+export declare class TicketLookupFailed extends TicketLookupFailed_base<{
+    readonly reason: string;
+}> {
+}
+/** Finds the summaries of the given keys; a key Jira does not return is absent from the map. */
+export type TicketSearch = (keys: ReadonlyArray<string>) => Effect.Effect<ReadonlyMap<string, string>, TicketLookupFailed>;
+/** Looks up keys whose cached title is missing or older than a day. Returns the lookups that failed. */
+export declare const refreshTicketTitles: (keys: ReadonlyArray<string>, search: TicketSearch) => Effect.Effect<ReadonlyArray<TicketLookupFailed>, StoreError, UsageStore>;
+/** The cached title of each key. */
+export declare const ticketTitles: (keys: ReadonlyArray<string>) => Effect.Effect<Readonly<Record<string, TicketTitleValue>>, StoreError, UsageStore>;
+/**
+ * What one `acli` search said, from its exit code and stdout. A nonzero exit is a failed lookup even
+ * when it printed something: a failed search cannot show that a ticket does not exist.
+ */
+export declare const searchOutcome: (exitCode: number, stdout: string) => Effect.Effect<ReadonlyMap<string, string>, TicketLookupFailed>;
+/**
+ * `acli jira workitem search` for a batch of keys. Keys reach the JQL only after the Booking
+ * pattern accepted them, so they cannot carry JQL syntax.
+ */
+export declare const acliTicketSearch: Effect.Effect<TicketSearch, never, ChildProcessSpawner.ChildProcessSpawner>;
+export {};

package/dist/core/Tickets.js

@@ -0,0 +1,125 @@
+/**
+ * Jira titles for ticket Bookings, looked up with `acli` and cached in the store for a day.
+ *
+ * **Mental model**
+ *
+ * - **Optional decoration.** A Booking is its key; a title only helps read it. Lookups run in the
+ *   background after an ingest pass, so a slow or missing `acli` never delays a page.
+ * - **Three answers, never blank.** A title is Known, or Unknown because Jira has no such ticket
+ *   (`NotFound`, cached like a title) or because no lookup has succeeded yet (`NotLookedUp`).
+ * - **A failed lookup caches nothing**, so the next pass tries again, and the failure is reported
+ *   rather than swallowed.
+ *
+ * @module
+ */
+import { Clock, Data, Duration, Effect, Schema, Stream } from "effect";
+import { ChildProcess, ChildProcessSpawner } from "effect/process";
+import { UsageStore } from "./Store.js";
+export class TicketLookupFailed extends Data.TaggedError("TicketLookupFailed") {
+}
+const ACLI_TIMEOUT = Duration.seconds(30);
+const FRESH_FOR_MILLIS = 24 * 60 * 60 * 1000;
+const KEYS_PER_SEARCH = 50;
+/** Looks up keys whose cached title is missing or older than a day. Returns the lookups that failed. */
+export const refreshTicketTitles = (keys, search) => Effect.gen(function* () {
+    const store = yield* UsageStore;
+    const now = yield* Clock.currentTimeMillis;
+    const cached = new Map((yield* store.tickets(keys)).map((ticket) => [ticket.key, ticket.fetchedAt]));
+    const stale = [...new Set(keys)].filter((key) => {
+        const fetchedAt = cached.get(key);
+        return fetchedAt === undefined || now - fetchedAt > FRESH_FOR_MILLIS;
+    });
+    const failures = [];
+    for (let start = 0; start < stale.length; start += KEYS_PER_SEARCH) {
+        const batch = stale.slice(start, start + KEYS_PER_SEARCH);
+        const found = yield* Effect.result(search(batch));
+        if (found._tag === "Success") {
+            for (const key of batch) {
+                yield* store.saveTicket({ key, summary: found.success.get(key) ?? null, fetchedAt: now });
+            }
+            continue;
+        }
+        // Jira refuses a whole search when one key in it does not exist. Asking key by key keeps one
+        // bad key from leaving the rest untitled; a key that still fails stays uncached and reported.
+        if (batch.length === 1) {
+            failures.push(found.failure);
+            continue;
+        }
+        for (const key of batch) {
+            const single = yield* Effect.result(search([key]));
+            if (single._tag === "Failure")
+                failures.push(single.failure);
+            else
+                yield* store.saveTicket({ key, summary: single.success.get(key) ?? null, fetchedAt: now });
+        }
+    }
+    return failures;
+});
+/** The cached title of each key. */
+export const ticketTitles = (keys) => Effect.gen(function* () {
+    const store = yield* UsageStore;
+    const cached = new Map((yield* store.tickets(keys)).map((ticket) => [ticket.key, ticket.summary]));
+    const titles = {};
+    for (const key of keys) {
+        const summary = cached.get(key);
+        titles[key] = summary === undefined
+            ? { _tag: "Unknown", reason: "NotLookedUp" }
+            : summary === null
+                ? { _tag: "Unknown", reason: "NotFound" }
+                : { _tag: "Known", summary };
+    }
+    return titles;
+});
+const SearchResult = Schema.fromJsonString(Schema.Array(Schema.Struct({
+    key: Schema.String,
+    fields: Schema.Struct({ summary: Schema.optionalKey(Schema.String) })
+})));
+const decodeSearch = Schema.decodeUnknownEffect(SearchResult);
+/**
+ * What one `acli` search said, from its exit code and stdout. A nonzero exit is a failed lookup even
+ * when it printed something: a failed search cannot show that a ticket does not exist.
+ */
+export const searchOutcome = (exitCode, stdout) => exitCode !== 0
+    ? Effect.fail(new TicketLookupFailed({ reason: `acli exited with status ${exitCode}` }))
+    : decodeSearch(stdout).pipe(Effect.mapError(() => new TicketLookupFailed({ reason: "acli returned an unreadable reply" })), Effect.map((items) => {
+        const found = new Map();
+        for (const item of items) {
+            if (item.fields.summary !== undefined)
+                found.set(item.key, item.fields.summary);
+        }
+        return found;
+    }));
+/**
+ * `acli jira workitem search` for a batch of keys. Keys reach the JQL only after the Booking
+ * pattern accepted them, so they cannot carry JQL syntax.
+ */
+export const acliTicketSearch = Effect.gen(function* () {
+    const spawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+    const search = (keys) => Effect.scoped(Effect.gen(function* () {
+        const handle = yield* spawner.spawn(ChildProcess.make("acli", [
+            "jira",
+            "workitem",
+            "search",
+            "--jql",
+            `key in (${keys.join(",")})`,
+            "--fields",
+            "key,summary",
+            "--limit",
+            String(keys.length),
+            "--json"
+        ]));
+        const [stdout, exitCode] = yield* Effect.all([Stream.mkString(Stream.decodeText(handle.stdout)), handle.exitCode], { concurrency: 2 });
+        return { stdout, exitCode };
+    })).pipe(
+    // A hung acli (waiting on a login, a dead network) must not hold up the work behind it.
+    Effect.timeoutOrElse({
+        duration: ACLI_TIMEOUT,
+        orElse: () => Effect.fail(new TicketLookupFailed({ reason: "acli did not answer within 30 seconds" }))
+    }), Effect.mapError((error) => error._tag === "TicketLookupFailed" ? error : new TicketLookupFailed({
+        reason: error.reason._tag === "NotFound"
+            ? "ticket titles need acli, which is not installed"
+            : `acli could not run (${error.reason._tag})`
+    })), Effect.flatMap(({ exitCode, stdout }) => searchOutcome(exitCode, stdout)));
+    return search;
+});
+//# sourceMappingURL=Tickets.js.map

package/dist/core/Tickets.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * `@knpkv/agent-usage` — Claude and Codex subscription usage on this Machine: per ticket, over
+ * time, and against subscription limits.
+ *
+ * @module
+ */
+export * as Attribution from "./core/Attribution.js";
+export * as Ingest from "./core/Ingest.js";
+export * as Model from "./core/Model.js";
+export * as Pricing from "./core/Pricing.js";
+export * as Report from "./core/Report.js";
+export * as Store from "./core/Store.js";
+export * as Api from "./server/Api.js";
+export * as Server from "./server/Server.js";

package/dist/index.js

@@ -0,0 +1,15 @@
+/**
+ * `@knpkv/agent-usage` — Claude and Codex subscription usage on this Machine: per ticket, over
+ * time, and against subscription limits.
+ *
+ * @module
+ */
+export * as Attribution from "./core/Attribution.js";
+export * as Ingest from "./core/Ingest.js";
+export * as Model from "./core/Model.js";
+export * as Pricing from "./core/Pricing.js";
+export * as Report from "./core/Report.js";
+export * as Store from "./core/Store.js";
+export * as Api from "./server/Api.js";
+export * as Server from "./server/Server.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,WAAW,MAAM,uBAAuB,CAAA;AACpD,OAAO,KAAK,MAAM,MAAM,kBAAkB,CAAA;AAC1C,OAAO,KAAK,KAAK,MAAM,iBAAiB,CAAA;AACxC,OAAO,KAAK,OAAO,MAAM,mBAAmB,CAAA;AAC5C,OAAO,KAAK,MAAM,MAAM,kBAAkB,CAAA;AAC1C,OAAO,KAAK,KAAK,MAAM,iBAAiB,CAAA;AACxC,OAAO,KAAK,GAAG,MAAM,iBAAiB,CAAA;AACtC,OAAO,KAAK,MAAM,MAAM,oBAAoB,CAAA"}

package/dist/main.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};