@agentstrack/collector 0.1.0

package/dist/adapters/opencode.js

@@ -0,0 +1,338 @@
+import Database from 'better-sqlite3';
+import { existsSync, readdirSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { isAbsolute, join } from 'node:path';
+import { num, safeJsonParse, str } from './types.js';
+import { readOpenCodeAccounts } from './account.js';
+import { countEditLines } from './claude.js';
+import { emptyUsage } from '../schema.js';
+import { deriveTitle } from '../sessions/title.js';
+/**
+ * OpenCode adapter.
+ *
+ * Source: a SQLite database, not a log — `<data>/opencode.db`, where <data> is
+ * `$XDG_DATA_HOME/opencode` (falling back to `~/.local/share/opencode`) and the
+ * filename may be overridden by $OPENCODE_DB or suffixed with a release channel
+ * (`opencode-dev.db`). That is what OpenCode 1.18 itself does, checked against
+ * the shipped binary rather than assumed.
+ *
+ * Three tables matter:
+ *   session — one row per session, already carrying running token totals, the
+ *             provider's REAL cost, model, cwd, title and version.
+ *   message — role + model per turn, JSON in `data`.
+ *   part    — the timeline: text, tool calls with input/output and timings.
+ *
+ * THIS IS A LIVE DATABASE THE USER'S EDITOR IS WRITING TO. It is opened
+ * read-only with a busy timeout, one short query at a time, and closed again.
+ * The collector must never be the reason someone's session data is corrupted
+ * or their editor blocks.
+ *
+ * Because there are no lines, normalize() has nothing to do and the adapter
+ * implements poll() instead (see AgentAdapter.poll). Resumption uses the
+ * spool's meta store: three cursors, no per-session bookkeeping.
+ */
+export const OPENCODE_DATA_DIR = process.env['OPENCODE_DATA_DIR'] ??
+    join(process.env['XDG_DATA_HOME'] ?? join(homedir(), '.local', 'share'), 'opencode');
+/**
+ * Resolves the database file the way OpenCode does.
+ *
+ * $OPENCODE_DB wins (absolute path used as-is, relative resolved inside the
+ * data dir). Otherwise release channels other than latest/beta/prod write to
+ * `opencode-<channel>.db`; the channel is not discoverable from outside the
+ * binary, so the plain file is preferred and a channel file is accepted as a
+ * fallback rather than guessed at.
+ */
+export function resolveDbPath(dataDir = OPENCODE_DATA_DIR) {
+    const override = process.env['OPENCODE_DB'];
+    if (override && override !== ':memory:') {
+        const path = isAbsolute(override) ? override : join(dataDir, override);
+        return existsSync(path) ? path : undefined;
+    }
+    const plain = join(dataDir, 'opencode.db');
+    if (existsSync(plain))
+        return plain;
+    try {
+        const channel = readdirSync(dataDir)
+            .filter((f) => /^opencode-[\w.-]+\.db$/.test(f))
+            .sort();
+        const first = channel[0];
+        return first ? join(dataDir, first) : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** How far back a first-ever poll reaches, matching the tailer's transcript horizon. */
+const BACKFILL_DAYS = 7;
+/** Bounds one poll so a cold start drains over several cycles instead of one huge batch. */
+const SESSION_LIMIT = 200;
+const PART_LIMIT = 1000;
+const CURSOR_SESSION_CREATED = 'opencode:cursor:session_created';
+const CURSOR_SESSION_UPDATED = 'opencode:cursor:session_updated';
+const CURSOR_PART_UPDATED = 'opencode:cursor:part_updated';
+export class OpenCodeAdapter {
+    dataDir;
+    id = 'opencode';
+    constructor(dataDir = OPENCODE_DATA_DIR) {
+        this.dataDir = dataDir;
+    }
+    async detect() {
+        const db = resolveDbPath(this.dataDir);
+        if (!db) {
+            return { installed: false, watchPaths: [], note: `No OpenCode database under ${this.dataDir}` };
+        }
+        // watchPaths stays empty on purpose: there is nothing here for the tailer
+        // to read, and handing it a .db file would have it stream binary pages.
+        return { installed: true, version: this.latestVersion(), watchPaths: [], note: db };
+    }
+    async health() {
+        const detection = await this.detect();
+        if (!detection.installed)
+            return { healthy: false, filesTracked: 0, error: detection.note };
+        try {
+            const sessions = this.query('SELECT COUNT(*) AS n FROM session')[0]?.n ?? 0;
+            return { healthy: true, filesTracked: sessions };
+        }
+        catch (error) {
+            return {
+                healthy: false,
+                filesTracked: 0,
+                error: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+    /** No-op: OpenCode has no log lines. Everything arrives through poll(). */
+    normalize(_line, _ctx) {
+        return [];
+    }
+    /*
+     * There is deliberately no adapter-wide account(): OpenCode holds one active
+     * account PER PROVIDER, and this machine's sessions span several. Answering
+     * with "the" account would attribute an OpenAI session to an OpenRouter key.
+     * Each event carries the identity of its own session's provider instead.
+     */
+    async poll(ctx) {
+        if (!resolveDbPath(this.dataDir))
+            return [];
+        const floor = Date.now() - BACKFILL_DAYS * 86_400_000;
+        const cursor = (key) => {
+            const stored = Number(ctx.getMeta(key));
+            return Number.isFinite(stored) && stored > 0 ? stored : floor;
+        };
+        const events = [];
+        const sessionUpdated = cursor(CURSOR_SESSION_UPDATED);
+        const sessionCreated = cursor(CURSOR_SESSION_CREATED);
+        const partUpdated = cursor(CURSOR_PART_UPDATED);
+        const sessions = this.query(`SELECT id, parent_id, directory, title, version, agent, model, cost,
+              tokens_input, tokens_output, tokens_reasoning, tokens_cache_read, tokens_cache_write,
+              time_created, time_updated, time_compacting, time_archived
+         FROM session
+        WHERE time_updated > ?
+        ORDER BY time_updated ASC
+        LIMIT ?`, sessionUpdated, SESSION_LIMIT);
+        const sessionAccounts = readOpenCodeAccounts(this.dataDir);
+        let maxUpdated = sessionUpdated;
+        let maxCreated = sessionCreated;
+        for (const row of sessions) {
+            events.push(...this.sessionEvents(row, sessionCreated, sessionAccounts));
+            maxUpdated = Math.max(maxUpdated, row.time_updated);
+            maxCreated = Math.max(maxCreated, row.time_created);
+        }
+        const parts = this.query(`SELECT p.session_id, p.time_created, p.time_updated, p.data,
+              m.data AS message_data, s.directory, s.version, s.model
+         FROM part p
+         JOIN message m ON m.id = p.message_id
+         JOIN session s ON s.id = p.session_id
+        WHERE p.time_updated > ?
+        ORDER BY p.time_updated ASC
+        LIMIT ?`, partUpdated, PART_LIMIT);
+        let maxPart = partUpdated;
+        const accounts = readOpenCodeAccounts(this.dataDir);
+        for (const row of parts) {
+            events.push(...this.partEvents(row, accounts));
+            maxPart = Math.max(maxPart, row.time_updated);
+        }
+        ctx.setMeta(CURSOR_SESSION_UPDATED, String(maxUpdated));
+        ctx.setMeta(CURSOR_SESSION_CREATED, String(maxCreated));
+        ctx.setMeta(CURSOR_PART_UPDATED, String(maxPart));
+        return events;
+    }
+    sessionEvents(row, createdCursor, accounts) {
+        const { model, provider } = parseModel(row.model);
+        const wrap = wrapper(row.id, row.version ?? undefined, row.directory, account(accounts, provider));
+        const events = [];
+        if (row.time_created > createdCursor) {
+            events.push(wrap(row.time_created, 'session.started', {
+                external_session_id: row.id,
+                cwd: row.directory,
+                parent_session_id: row.parent_id ?? undefined,
+                agent_mode: row.agent ?? undefined,
+                model,
+                provider,
+                derived_title: row.title ?? undefined,
+            }));
+        }
+        // The session row holds RUNNING TOTALS, exactly like Codex's token_count.
+        // Marked cumulative so the server takes the max rather than summing — every
+        // poll would otherwise re-add the whole session's tokens.
+        events.push(wrap(row.time_updated, 'usage.reported', {
+            model,
+            provider,
+            usage: {
+                ...emptyUsage(),
+                input_tokens: num(row.tokens_input),
+                output_tokens: num(row.tokens_output),
+                reasoning_output_tokens: num(row.tokens_reasoning),
+                cached_input_tokens: num(row.tokens_cache_read),
+                cache_creation_input_tokens: num(row.tokens_cache_write),
+            },
+            cumulative: true,
+            // OpenCode settles the real provider bill per session, so this is a
+            // REPORTED cost, not our estimate from a rate card.
+            ...(row.cost > 0 ? { reported_cost_usd: row.cost } : {}),
+        }));
+        const endedAt = row.time_archived ?? row.time_compacting;
+        if (endedAt) {
+            events.push(wrap(endedAt, 'session.ended', {
+                reason: row.time_archived ? 'archived' : 'compacted',
+            }));
+        }
+        return events;
+    }
+    partEvents(row, accounts) {
+        const data = safeJsonParse(row.data);
+        if (!data)
+            return [];
+        const { provider } = parseModel(row.model);
+        const wrap = wrapper(row.session_id, row.version ?? undefined, row.directory, account(accounts, provider));
+        const type = str(data['type']);
+        if (type === 'text') {
+            const message = safeJsonParse(row.message_data);
+            // Assistant text is the model talking to itself; only a user part is a prompt.
+            if (!message || str(message['role']) !== 'user')
+                return [];
+            const text = str(data['text']);
+            if (!text)
+                return [];
+            return [
+                wrap(row.time_created, 'user.prompted', {
+                    prompt_chars: text.length,
+                    prompt_text: text,
+                    derived_title: deriveTitle(text),
+                }),
+            ];
+        }
+        if (type === 'tool')
+            return toolEvents(data, row.time_created, wrap);
+        return [];
+    }
+    /** Newest session's `version` column — OpenCode stamps its own version on every row. */
+    latestVersion() {
+        try {
+            return (this.query('SELECT version FROM session ORDER BY time_updated DESC LIMIT 1')[0]?.version ?? undefined);
+        }
+        catch {
+            return undefined; // absent beats fabricated
+        }
+    }
+    /**
+     * One short read-only query, then the handle is closed.
+     *
+     * readonly + fileMustExist means a bug here cannot write, migrate or create
+     * anything; busy_timeout means a concurrent OpenCode write makes us wait
+     * briefly instead of failing, and query_only is the belt to that suspenders.
+     */
+    query(sql, ...params) {
+        const path = resolveDbPath(this.dataDir);
+        if (!path)
+            return [];
+        const db = new Database(path, { readonly: true, fileMustExist: true });
+        try {
+            db.pragma('busy_timeout = 3000');
+            db.pragma('query_only = 1');
+            return db.prepare(sql).all(...params);
+        }
+        finally {
+            db.close();
+        }
+    }
+}
+function account(accounts, provider) {
+    return provider ? accounts.get(provider) : undefined;
+}
+function wrapper(sessionId, version, cwd, identity) {
+    return (atMs, event_type, payload) => ({
+        account: identity,
+        event: {
+            occurred_at: new Date(atMs).toISOString(),
+            session_id: sessionId,
+            agent: 'opencode',
+            agent_version: version,
+            event_type,
+            payload,
+        },
+        cwd: cwd || undefined,
+        repo: cwd ? { project_path: cwd } : undefined,
+    });
+}
+/** `session.model` is a JSON blob — `{"id":"…","providerID":"…","variant":"…"}`. */
+export function parseModel(raw) {
+    if (!raw)
+        return {};
+    const parsed = safeJsonParse(raw);
+    if (!parsed)
+        return { model: raw }; // older rows may store a bare string
+    return { model: str(parsed['id']), provider: str(parsed['providerID']) };
+}
+/**
+ * Events recovered from one `tool` part.
+ *
+ * The part carries the whole call — status, input, and start/end timestamps —
+ * so only the terminal event is emitted, timestamped at the call's START with
+ * its real duration. That is what the server's interval merge needs: a separate
+ * tool.started would add an event without adding information, and the server
+ * already backfills the invocation count from the terminal events.
+ *
+ * `state.output` is deliberately never read. It is raw command output and file
+ * contents, i.e. exactly the code content the privacy pipeline exists to keep
+ * off the wire.
+ */
+export function toolEvents(data, fallbackMs, wrap) {
+    const tool = str(data['tool']) ?? 'unknown';
+    const state = (data['state'] ?? {});
+    const time = (state['time'] ?? {});
+    const start = num(time['start']) || fallbackMs;
+    const end = num(time['end']);
+    const status = str(state['status']);
+    // A call still running has no terminal event yet; it will be re-read when the
+    // row is updated, because the part cursor tracks time_updated.
+    if (status !== 'completed' && status !== 'error')
+        return [];
+    const input = (state['input'] ?? {});
+    const events = [
+        wrap(start, status === 'error' ? 'tool.failed' : 'tool.completed', {
+            tool_name: tool,
+            tool_call_id: str(data['callID']),
+            duration_ms: end > start ? end - start : 0,
+        }),
+    ];
+    const command = str(input['command']);
+    if (tool === 'bash' && command)
+        events.push(wrap(start, 'command.executed', { command }));
+    const path = str(input['filePath']);
+    if (!path)
+        return events;
+    if (tool === 'read')
+        events.push(wrap(start, 'file.read', { path }));
+    else if (tool === 'write' || tool === 'edit') {
+        // Same line-counting rules as Claude Code: a line present on both sides of
+        // an edit is neither added nor removed. Reused so the two agents' file
+        // stats are actually comparable.
+        const counts = tool === 'write'
+            ? countEditLines('Write', { content: input['content'] })
+            : countEditLines('Edit', { old_string: input['oldString'], new_string: input['newString'] });
+        events.push(wrap(start, 'file.changed', { path, change_kind: tool === 'write' ? 'create' : 'edit', ...counts }));
+    }
+    return events;
+}
+//# sourceMappingURL=opencode.js.map

package/dist/adapters/opencode.js.map

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

package/dist/adapters/types.d.ts

@@ -0,0 +1,97 @@
+import type { EventEnvelope, RepoContext } from '../schema.js';
+export interface DetectionResult {
+    installed: boolean;
+    version?: string;
+    /** Directories the tailer should watch. */
+    watchPaths: string[];
+    note?: string;
+}
+export interface HealthStatus {
+    healthy: boolean;
+    filesTracked: number;
+    lastEventAt?: string;
+    error?: string;
+}
+/**
+ * Per-agent adapter (BLUEPRINT §9.2).
+ *
+ * Note there is no installHooks(): the collector reads the agent's own log
+ * files rather than injecting itself into the agent's config. That keeps us
+ * out of files other tools also own, and the logs carry token counts that
+ * hooks never deliver.
+ */
+export interface AgentAdapter {
+    readonly id: string;
+    detect(): Promise<DetectionResult>;
+    health(): Promise<HealthStatus>;
+    /**
+     * Converts one raw log line into zero or more normalized events.
+     * MUST NOT throw on unrecognised input — agents change their formats between
+     * releases, and one unknown line must not stop the file.
+     */
+    normalize(line: string, ctx: NormalizeContext): NormalizedEvent[];
+    /**
+     * Optional pull-based source, for agents that keep state in a database
+     * instead of an append-only log.
+     *
+     * normalize() is line-oriented and there are no lines in a SQLite file, so
+     * rather than pretend otherwise these adapters produce their events by
+     * polling. The daemon drives poll() on the same scan cycle as the tailer,
+     * with the same `tracking.agents` gating and the same excluded_projects
+     * filter applied to what comes back. Resumption is the adapter's own
+     * problem — the tailer's (path, inode, offset) checkpoint means nothing to a
+     * database, so PollContext hands it the spool's meta store instead.
+     */
+    poll?(ctx: PollContext): Promise<NormalizedEvent[]>;
+    /**
+     * The account this agent is signed in as RIGHT NOW, or undefined when the
+     * agent is logged out or exposes no stable id.
+     *
+     * Called once per scan cycle, not once at boot: these files are rewritten in
+     * place when the user switches accounts.
+     */
+    account?(): AccountIdentity | undefined;
+}
+/**
+ * Non-PII account attribution, attached by the daemon to session.started and
+ * user.prompted.
+ *
+ * `key` is opaque and stable and always travels — it is what makes sessions
+ * split per account. `label` and `org` identify a person and their employer
+ * and are stripped by the privacy pipeline below `analytics` mode.
+ */
+export interface AccountIdentity {
+    /** Subscription/plan signal, when the agent exposes one. Drives cost basis. */
+    planType?: string;
+    key: string;
+    label?: string;
+    org?: string;
+    provider?: string;
+}
+export interface PollContext {
+    collectorId: string;
+    /** The spool's meta store: a database adapter's resume cursor lives here. */
+    getMeta(key: string): string | null;
+    setMeta(key: string, value: string): void;
+}
+export interface NormalizeContext {
+    collectorId: string;
+    /** Path of the file this line came from, for session grouping. */
+    sourceFile: string;
+}
+/** An event plus the side-channel facts the session tracker needs. */
+export interface NormalizedEvent {
+    event: Omit<EventEnvelope, 'event_id' | 'collector_id' | 'schema_version'>;
+    cwd?: string;
+    repo?: RepoContext;
+    /**
+     * Account this specific event belongs to, when the adapter can pin it down
+     * more precisely than adapter.account() can — OpenCode holds one active
+     * account per provider, so the answer differs between two sessions on the
+     * same machine. Takes precedence over adapter.account().
+     */
+    account?: AccountIdentity;
+}
+export declare function safeJsonParse(line: string): Record<string, unknown> | null;
+export declare function num(value: unknown): number;
+export declare function str(value: unknown): string | undefined;

package/dist/adapters/types.js

@@ -0,0 +1,20 @@
+export function safeJsonParse(line) {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed[0] !== '{')
+        return null;
+    try {
+        const parsed = JSON.parse(trimmed);
+        return parsed && typeof parsed === 'object' ? parsed : null;
+    }
+    catch {
+        // Partial line from a file still being written; the tailer will retry.
+        return null;
+    }
+}
+export function num(value) {
+    return typeof value === 'number' && Number.isFinite(value) ? value : 0;
+}
+export function str(value) {
+    return typeof value === 'string' && value.length > 0 ? value : undefined;
+}
+//# sourceMappingURL=types.js.map

package/dist/adapters/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/adapters/types.ts"],"names":[],"mappings":"AAsGA,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IAChD,IAAI,CAAC;QACH,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC5C,OAAO,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAE,MAAkC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC3F,CAAC;IAAC,MAAM,CAAC;QACP,uEAAuE;QACvE,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,KAAc;IAChC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,KAAc;IAChC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3E,CAAC"}

package/dist/cli.d.ts

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