@agentstrack/collector 0.1.0

package/dist/queue/spool.d.ts

@@ -0,0 +1,47 @@
+import type { EventEnvelope } from '../schema.js';
+/**
+ * Durable local spool.
+ *
+ * Everything the collector observes lands here first and is only deleted once
+ * the server has acknowledged it. That is what makes the collector survive
+ * being offline, killed mid-flight, or pointed at an API that is down — a
+ * developer's day of work is never lost to a network blip.
+ *
+ * Also stores per-file read offsets so a restart resumes mid-file instead of
+ * re-uploading or skipping.
+ */
+export declare class Spool {
+    private readonly db;
+    constructor(path: string);
+    private migrate;
+    enqueue(events: EventEnvelope[]): number;
+    /** Oldest-first so a backlog drains in the order it happened. */
+    peek(limit: number): {
+        eventId: string;
+        event: EventEnvelope;
+    }[];
+    ack(eventIds: string[]): void;
+    /**
+     * Records a failed attempt so poison events can be dropped eventually.
+     *
+     * Two things this must not do, both of which it used to:
+     *  - delete across the whole table. Only the events in THIS batch have just
+     *    failed; an untouched event elsewhere in the spool is not poison.
+     *  - honour maxAttempts <= 0. `attempts >= 0` matches every row including
+     *    never-attempted ones, so a config of 0 wiped the entire queue on the
+     *    first network blip. At least one attempt must always be allowed.
+     */
+    fail(eventIds: string[], maxAttempts: number): number;
+    depth(): number;
+    getCheckpoint(path: string): {
+        inode: string;
+        offset: number;
+        size: number;
+    } | null;
+    setCheckpoint(path: string, inode: string, offset: number, size: number): void;
+    getMeta(key: string): string | null;
+    setMeta(key: string, value: string): void;
+    /** Stable per-install id, generated once. */
+    installId(): string;
+    close(): void;
+}

package/dist/queue/spool.js

@@ -0,0 +1,152 @@
+import Database from 'better-sqlite3';
+import { chmodSync, mkdirSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { randomUUID } from 'node:crypto';
+/**
+ * Durable local spool.
+ *
+ * Everything the collector observes lands here first and is only deleted once
+ * the server has acknowledged it. That is what makes the collector survive
+ * being offline, killed mid-flight, or pointed at an API that is down — a
+ * developer's day of work is never lost to a network blip.
+ *
+ * Also stores per-file read offsets so a restart resumes mid-file instead of
+ * re-uploading or skipping.
+ */
+export class Spool {
+    db;
+    constructor(path) {
+        mkdirSync(dirname(path), { recursive: true, mode: 0o700 });
+        this.db = new Database(path);
+        // The spool holds un-uploaded telemetry; default umask makes it world-readable.
+        for (const suffix of ['', '-wal', '-shm']) {
+            try {
+                chmodSync(`${path}${suffix}`, 0o600);
+            }
+            catch {
+                // WAL/SHM may not exist yet; the main db is the one that matters.
+            }
+        }
+        // WAL so a crash mid-write cannot corrupt the queue.
+        this.db.pragma('journal_mode = WAL');
+        this.db.pragma('synchronous = NORMAL');
+        this.migrate();
+    }
+    migrate() {
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS events (
+        event_id   TEXT PRIMARY KEY,
+        body       TEXT NOT NULL,
+        created_at INTEGER NOT NULL,
+        attempts   INTEGER NOT NULL DEFAULT 0
+      );
+      CREATE INDEX IF NOT EXISTS idx_events_created ON events(created_at);
+
+      CREATE TABLE IF NOT EXISTS checkpoints (
+        path   TEXT PRIMARY KEY,
+        inode  TEXT NOT NULL,
+        offset INTEGER NOT NULL,
+        size   INTEGER NOT NULL
+      );
+
+      CREATE TABLE IF NOT EXISTS meta (
+        key   TEXT PRIMARY KEY,
+        value TEXT NOT NULL
+      );
+    `);
+    }
+    enqueue(events) {
+        if (events.length === 0)
+            return 0;
+        const stmt = this.db.prepare('INSERT OR IGNORE INTO events (event_id, body, created_at) VALUES (?, ?, ?)');
+        const now = Date.now();
+        const insertAll = this.db.transaction((batch) => {
+            let written = 0;
+            for (const event of batch)
+                written += stmt.run(event.event_id, JSON.stringify(event), now).changes;
+            return written;
+        });
+        return insertAll(events);
+    }
+    /** Oldest-first so a backlog drains in the order it happened. */
+    peek(limit) {
+        const rows = this.db
+            .prepare('SELECT event_id, body FROM events ORDER BY created_at ASC, rowid ASC LIMIT ?')
+            .all(limit);
+        return rows.flatMap((row) => {
+            try {
+                return [{ eventId: row.event_id, event: JSON.parse(row.body) }];
+            }
+            catch {
+                // Unparseable row would block the queue forever; drop it.
+                this.ack([row.event_id]);
+                return [];
+            }
+        });
+    }
+    ack(eventIds) {
+        if (eventIds.length === 0)
+            return;
+        const stmt = this.db.prepare('DELETE FROM events WHERE event_id = ?');
+        this.db.transaction((ids) => ids.forEach((id) => stmt.run(id)))(eventIds);
+    }
+    /**
+     * Records a failed attempt so poison events can be dropped eventually.
+     *
+     * Two things this must not do, both of which it used to:
+     *  - delete across the whole table. Only the events in THIS batch have just
+     *    failed; an untouched event elsewhere in the spool is not poison.
+     *  - honour maxAttempts <= 0. `attempts >= 0` matches every row including
+     *    never-attempted ones, so a config of 0 wiped the entire queue on the
+     *    first network blip. At least one attempt must always be allowed.
+     */
+    fail(eventIds, maxAttempts) {
+        if (eventIds.length === 0)
+            return 0;
+        const limit = Math.max(1, maxAttempts);
+        const bump = this.db.prepare('UPDATE events SET attempts = attempts + 1 WHERE event_id = ?');
+        const drop = this.db.prepare('DELETE FROM events WHERE event_id = ? AND attempts >= ?');
+        return this.db.transaction((ids) => {
+            let dropped = 0;
+            for (const id of ids) {
+                bump.run(id);
+                dropped += drop.run(id, limit).changes;
+            }
+            return dropped;
+        })(eventIds);
+    }
+    depth() {
+        return this.db.prepare('SELECT COUNT(*) AS n FROM events').get().n;
+    }
+    getCheckpoint(path) {
+        return (this.db.prepare('SELECT inode, offset, size FROM checkpoints WHERE path = ?').get(path) ?? null);
+    }
+    setCheckpoint(path, inode, offset, size) {
+        this.db
+            .prepare(`INSERT INTO checkpoints (path, inode, offset, size) VALUES (?, ?, ?, ?)
+         ON CONFLICT(path) DO UPDATE SET inode = excluded.inode, offset = excluded.offset, size = excluded.size`)
+            .run(path, inode, offset, size);
+    }
+    getMeta(key) {
+        return (this.db.prepare('SELECT value FROM meta WHERE key = ?').get(key)?.value ??
+            null);
+    }
+    setMeta(key, value) {
+        this.db
+            .prepare('INSERT INTO meta (key, value) VALUES (?, ?) ON CONFLICT(key) DO UPDATE SET value = excluded.value')
+            .run(key, value);
+    }
+    /** Stable per-install id, generated once. */
+    installId() {
+        let id = this.getMeta('install_id');
+        if (!id) {
+            id = randomUUID();
+            this.setMeta('install_id', id);
+        }
+        return id;
+    }
+    close() {
+        this.db.close();
+    }
+}
+//# sourceMappingURL=spool.js.map

package/dist/queue/spool.js.map

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

package/dist/queue/tailer.d.ts

@@ -0,0 +1,25 @@
+import type { Spool } from './spool.js';
+/**
+ * Resumable line tailer.
+ *
+ * Checkpoints (path, inode, offset) after every read so a restart continues
+ * exactly where it stopped. Three failure modes it must survive:
+ *
+ *  - rotation/replacement: the inode changes, so the old offset is meaningless
+ *    and we start from zero.
+ *  - truncation: the file is smaller than our offset, so the offset is past
+ *    the end and we start from zero.
+ *  - a partial trailing line: the agent is mid-write. We must NOT consume it —
+ *    emitting half a JSON object loses that event permanently, because the
+ *    remainder arrives on the next pass as an orphaned fragment and both
+ *    halves fail to parse. So the checkpoint stops at the last complete
+ *    newline and the partial line is re-read whole next time.
+ *
+ * Offsets are byte offsets, computed from the buffer rather than from decoded
+ * strings — a multi-byte character would otherwise desynchronise the position.
+ */
+export interface TailResult {
+    lines: string[];
+    bytesRead: number;
+}
+export declare function tailFile(path: string, spool: Spool): Promise<TailResult>;

package/dist/queue/tailer.js

@@ -0,0 +1,48 @@
+import { existsSync, statSync } from 'node:fs';
+import { open } from 'node:fs/promises';
+const NEWLINE = 0x0a;
+export async function tailFile(path, spool) {
+    if (!existsSync(path))
+        return { lines: [], bytesRead: 0 };
+    const stats = statSync(path);
+    const inode = String(stats.ino);
+    const checkpoint = spool.getCheckpoint(path);
+    let start = 0;
+    if (checkpoint && checkpoint.inode === inode && checkpoint.offset <= stats.size) {
+        start = checkpoint.offset;
+    }
+    // else: rotated (inode differs) or truncated (offset > size) — reread from 0.
+    if (start >= stats.size) {
+        spool.setCheckpoint(path, inode, stats.size, stats.size);
+        return { lines: [], bytesRead: 0 };
+    }
+    const length = stats.size - start;
+    const buffer = Buffer.allocUnsafe(length);
+    const handle = await open(path, 'r');
+    try {
+        await handle.read(buffer, 0, length, start);
+    }
+    finally {
+        await handle.close();
+    }
+    // Consume only up to the final newline. Anything after it is a line the
+    // agent has not finished writing.
+    const lastNewline = buffer.lastIndexOf(NEWLINE);
+    if (lastNewline === -1) {
+        // No complete line yet — leave the checkpoint untouched so the whole
+        // partial line is re-read once it is terminated.
+        return { lines: [], bytesRead: 0 };
+    }
+    const consumable = buffer.subarray(0, lastNewline + 1);
+    const lines = consumable
+        .toString('utf8')
+        .split('\n')
+        // The trailing element after the final \n is always '' — drop it, and drop
+        // any blank lines rather than handing '' to a parser.
+        .filter((line) => line.length > 0)
+        .map((line) => (line.endsWith('\r') ? line.slice(0, -1) : line));
+    const consumed = start + consumable.length;
+    spool.setCheckpoint(path, inode, consumed, stats.size);
+    return { lines, bytesRead: consumable.length };
+}
+//# sourceMappingURL=tailer.js.map

package/dist/queue/tailer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tailer.js","sourceRoot":"","sources":["../../src/queue/tailer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AA2BxC,MAAM,OAAO,GAAG,IAAI,CAAC;AAErB,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,IAAY,EAAE,KAAY;IACvD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IAE1D,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC7B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAChC,MAAM,UAAU,GAAG,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IAE7C,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,UAAU,IAAI,UAAU,CAAC,KAAK,KAAK,KAAK,IAAI,UAAU,CAAC,MAAM,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;QAChF,KAAK,GAAG,UAAU,CAAC,MAAM,CAAC;IAC5B,CAAC;IACD,8EAA8E;IAE9E,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;QACxB,KAAK,CAAC,aAAa,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACzD,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IACrC,CAAC;IAED,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC;IAClC,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAE1C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACrC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IAC9C,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAED,wEAAwE;IACxE,kCAAkC;IAClC,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IAChD,IAAI,WAAW,KAAK,CAAC,CAAC,EAAE,CAAC;QACvB,qEAAqE;QACrE,iDAAiD;QACjD,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IACrC,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,WAAW,GAAG,CAAC,CAAC,CAAC;IACvD,MAAM,KAAK,GAAG,UAAU;SACrB,QAAQ,CAAC,MAAM,CAAC;SAChB,KAAK,CAAC,IAAI,CAAC;QACZ,2EAA2E;QAC3E,sDAAsD;SACrD,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;SACjC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAEnE,MAAM,QAAQ,GAAG,KAAK,GAAG,UAAU,CAAC,MAAM,CAAC;IAC3C,KAAK,CAAC,aAAa,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IACvD,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC;AACjD,CAAC"}

package/dist/schema.d.ts

@@ -0,0 +1,76 @@
+import { z } from 'zod';
+/**
+ * AgentsTrack telemetry envelope, schema v1.
+ *
+ * This file is the collector's copy of the wire contract, documented in
+ * docs/EVENT_SCHEMA.md. The server holds the canonical EVENT_SCHEMA.json and
+ * validates against the same shape; `npm test` includes a contract test that
+ * asserts the two agree whenever the server repo is checked out alongside
+ * this one (or AGENTSTRACK_SERVER_REPO points at it).
+ *
+ * Note what is NOT here: organization_id and user_id. The server derives both
+ * from your API key. A collector cannot name its own tenant, by design.
+ */
+export declare const SCHEMA_VERSION = 1;
+export declare const AGENTS: readonly ["claude_code", "codex", "gemini_cli", "opencode", "cursor", "cline", "copilot_cli", "other"];
+export type AgentId = (typeof AGENTS)[number];
+export declare const EVENT_TYPES: readonly ["session.started", "session.ended", "user.prompted", "agent.turn.started", "agent.turn.ended", "model.request", "model.response", "tool.started", "tool.completed", "tool.failed", "file.read", "file.changed", "command.executed", "git.commit", "git.branch_changed", "usage.reported", "error", "heartbeat"];
+export type EventType = (typeof EVENT_TYPES)[number];
+export declare const PRIVACY_MODES: readonly ["metadata", "analytics", "full"];
+export type PrivacyMode = (typeof PRIVACY_MODES)[number];
+export interface TokenUsage {
+    input_tokens: number;
+    cached_input_tokens: number;
+    cache_creation_input_tokens: number;
+    output_tokens: number;
+    reasoning_output_tokens: number;
+}
+export declare const emptyUsage: () => TokenUsage;
+export declare const EventEnvelope: z.ZodObject<{
+    event_id: z.ZodString;
+    schema_version: z.ZodLiteral<1>;
+    occurred_at: z.ZodString;
+    collector_id: z.ZodString;
+    session_id: z.ZodString;
+    agent: z.ZodEnum<{
+        claude_code: "claude_code";
+        codex: "codex";
+        gemini_cli: "gemini_cli";
+        opencode: "opencode";
+        cursor: "cursor";
+        cline: "cline";
+        copilot_cli: "copilot_cli";
+        other: "other";
+    }>;
+    agent_version: z.ZodOptional<z.ZodString>;
+    event_type: z.ZodEnum<{
+        "session.started": "session.started";
+        "session.ended": "session.ended";
+        "user.prompted": "user.prompted";
+        "agent.turn.started": "agent.turn.started";
+        "agent.turn.ended": "agent.turn.ended";
+        "model.request": "model.request";
+        "model.response": "model.response";
+        "tool.started": "tool.started";
+        "tool.completed": "tool.completed";
+        "tool.failed": "tool.failed";
+        "file.read": "file.read";
+        "file.changed": "file.changed";
+        "command.executed": "command.executed";
+        "git.commit": "git.commit";
+        "git.branch_changed": "git.branch_changed";
+        "usage.reported": "usage.reported";
+        error: "error";
+        heartbeat: "heartbeat";
+    }>;
+    payload: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type EventEnvelope = z.infer<typeof EventEnvelope>;
+export interface RepoContext {
+    remote_hash?: string;
+    remote_owner?: string;
+    remote_name?: string;
+    branch?: string;
+    project_path?: string;
+    project_name?: string;
+}

package/dist/schema.js

@@ -0,0 +1,46 @@
+import { z } from 'zod';
+/**
+ * AgentsTrack telemetry envelope, schema v1.
+ *
+ * This file is the collector's copy of the wire contract, documented in
+ * docs/EVENT_SCHEMA.md. The server holds the canonical EVENT_SCHEMA.json and
+ * validates against the same shape; `npm test` includes a contract test that
+ * asserts the two agree whenever the server repo is checked out alongside
+ * this one (or AGENTSTRACK_SERVER_REPO points at it).
+ *
+ * Note what is NOT here: organization_id and user_id. The server derives both
+ * from your API key. A collector cannot name its own tenant, by design.
+ */
+export const SCHEMA_VERSION = 1;
+export const AGENTS = ['claude_code', 'codex', 'gemini_cli', 'opencode', 'cursor', 'cline', 'copilot_cli', 'other'];
+export const EVENT_TYPES = [
+    'session.started', 'session.ended', 'user.prompted',
+    'agent.turn.started', 'agent.turn.ended',
+    'model.request', 'model.response',
+    'tool.started', 'tool.completed', 'tool.failed',
+    'file.read', 'file.changed', 'command.executed',
+    'git.commit', 'git.branch_changed',
+    'usage.reported', 'error', 'heartbeat',
+];
+export const PRIVACY_MODES = ['metadata', 'analytics', 'full'];
+export const emptyUsage = () => ({
+    input_tokens: 0,
+    cached_input_tokens: 0,
+    cache_creation_input_tokens: 0,
+    output_tokens: 0,
+    reasoning_output_tokens: 0,
+});
+export const EventEnvelope = z.object({
+    event_id: z.string().uuid(),
+    schema_version: z.literal(SCHEMA_VERSION),
+    occurred_at: z.string(),
+    collector_id: z.string().uuid(),
+    session_id: z.string().min(1).max(200),
+    agent: z.enum(AGENTS),
+    agent_version: z.string().max(50).optional(),
+    event_type: z.enum(EVENT_TYPES),
+    // zod 4 requires an explicit key schema for z.record(); string keys is the
+    // same runtime behaviour z.record(z.unknown()) had under zod 3.
+    payload: z.record(z.string(), z.unknown()).default({}),
+});
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC;AAEhC,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,aAAa,EAAE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,CAAU,CAAC;AAG7H,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,iBAAiB,EAAE,eAAe,EAAE,eAAe;IACnD,oBAAoB,EAAE,kBAAkB;IACxC,eAAe,EAAE,gBAAgB;IACjC,cAAc,EAAE,gBAAgB,EAAE,aAAa;IAC/C,WAAW,EAAE,cAAc,EAAE,kBAAkB;IAC/C,YAAY,EAAE,oBAAoB;IAClC,gBAAgB,EAAE,OAAO,EAAE,WAAW;CAC9B,CAAC;AAGX,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,UAAU,EAAE,WAAW,EAAE,MAAM,CAAU,CAAC;AAWxE,MAAM,CAAC,MAAM,UAAU,GAAG,GAAe,EAAE,CAAC,CAAC;IAC3C,YAAY,EAAE,CAAC;IACf,mBAAmB,EAAE,CAAC;IACtB,2BAA2B,EAAE,CAAC;IAC9B,aAAa,EAAE,CAAC;IAChB,uBAAuB,EAAE,CAAC;CAC3B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IAC3B,cAAc,EAAE,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC;IACzC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IAC/B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IACtC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;IACrB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC5C,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC;IAC/B,2EAA2E;IAC3E,gEAAgE;IAChE,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CACvD,CAAC,CAAC"}

package/dist/sessions/title.d.ts

@@ -0,0 +1,2 @@
+/** First meaningful line of a prompt, trimmed to a usable title length. */
+export declare function deriveTitle(text: string, maxLength?: number): string;

package/dist/sessions/title.js

@@ -0,0 +1,11 @@
+/** First meaningful line of a prompt, trimmed to a usable title length. */
+export function deriveTitle(text, maxLength = 120) {
+    const line = text
+        .split('\n')
+        .map((l) => l.trim())
+        // Skip markdown fences, quotes and system-reminder noise.
+        .find((l) => l.length > 0 && !l.startsWith('```') && !l.startsWith('<') && !l.startsWith('>')) ?? '';
+    const cleaned = line.replace(/\s+/g, ' ').trim();
+    return cleaned.length <= maxLength ? cleaned : `${cleaned.slice(0, maxLength - 1)}…`;
+}
+//# sourceMappingURL=title.js.map

package/dist/sessions/title.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"title.js","sourceRoot":"","sources":["../../src/sessions/title.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,SAAS,GAAG,GAAG;IACvD,MAAM,IAAI,GACR,IAAI;SACD,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACrB,0DAA0D;SACzD,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACzG,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACjD,OAAO,OAAO,CAAC,MAAM,IAAI,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,GAAG,CAAC;AACvF,CAAC"}

package/dist/transport/client.d.ts

@@ -0,0 +1,76 @@
+import type { EventEnvelope } from '../schema.js';
+/**
+ * HTTP client for the AgentsTrack API.
+ *
+ * Bodies are gzipped: a session's events compress by roughly 10x and a
+ * developer on a hotel connection should not notice the collector at all.
+ */
+export interface ClientOptions {
+    apiUrl: string;
+    apiKey: string;
+    timeoutMs?: number;
+}
+export interface BatchResult {
+    accepted: number;
+    duplicates: number;
+    rejected: {
+        index: number;
+        reason: string;
+    }[];
+}
+export interface ServerConfig {
+    privacy_mode: 'metadata' | 'analytics' | 'full';
+    idle_timeout_seconds: number;
+    retention_days: number;
+    redaction_rules: {
+        pattern: string;
+        replacement: string;
+    }[];
+    max_batch_events: number;
+    batch_interval_seconds: number;
+}
+export declare class ApiError extends Error {
+    readonly status: number;
+    /** Whether trying again later could succeed. */
+    readonly retryable: boolean;
+    constructor(message: string, status: number, 
+    /** Whether trying again later could succeed. */
+    retryable: boolean);
+}
+export declare class ApiClient {
+    private readonly options;
+    constructor(options: ClientOptions);
+    registerCollector(input: {
+        hostname: string;
+        label?: string;
+        os?: string;
+        arch?: string;
+        version?: string;
+        /** The mode this device will actually enforce, which may be stricter than the org's. */
+        privacy_mode?: string;
+        agents: {
+            agent: string;
+            version?: string;
+        }[];
+    }): Promise<{
+        collector_id: string;
+        privacy_mode: string;
+    }>;
+    getConfig(): Promise<ServerConfig>;
+    sendBatch(events: EventEnvelope[]): Promise<BatchResult>;
+    health(input: {
+        collector_id: string;
+        queue_depth: number;
+        version?: string;
+        privacy_mode?: string;
+        agents: {
+            agent: string;
+            version?: string;
+        }[];
+    }): Promise<{
+        ok: boolean;
+    }>;
+    private request;
+}
+/** Exponential backoff with jitter, capped. */
+export declare function backoffMs(attempt: number, baseMs?: number, capMs?: number): number;

package/dist/transport/client.js

@@ -0,0 +1,80 @@
+import { gzipSync } from 'node:zlib';
+export class ApiError extends Error {
+    status;
+    retryable;
+    constructor(message, status, 
+    /** Whether trying again later could succeed. */
+    retryable) {
+        super(message);
+        this.status = status;
+        this.retryable = retryable;
+        this.name = 'ApiError';
+    }
+}
+export class ApiClient {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    async registerCollector(input) {
+        return this.request('POST', '/v1/collector/register', input);
+    }
+    async getConfig() {
+        return this.request('GET', '/v1/collector/config');
+    }
+    async sendBatch(events) {
+        return this.request('POST', '/v1/events/batch', { events }, true);
+    }
+    async health(input) {
+        return this.request('POST', '/v1/collector/health', input);
+    }
+    async request(method, path, body, compress = false) {
+        const url = `${this.options.apiUrl.replace(/\/$/, '')}${path}`;
+        const headers = {
+            authorization: `Bearer ${this.options.apiKey}`,
+            accept: 'application/json',
+        };
+        let payload;
+        if (body !== undefined) {
+            headers['content-type'] = 'application/json';
+            const json = JSON.stringify(body);
+            if (compress && json.length > 1024) {
+                payload = gzipSync(json);
+                headers['content-encoding'] = 'gzip';
+            }
+            else {
+                payload = json;
+            }
+        }
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), this.options.timeoutMs ?? 30_000);
+        try {
+            const response = await fetch(url, { method, headers, body: payload, signal: controller.signal });
+            if (!response.ok) {
+                const text = await response.text().catch(() => '');
+                // 4xx means we sent something wrong — retrying will not fix it, except
+                // 408/429 which are explicitly "try again".
+                const retryable = response.status >= 500 || response.status === 408 || response.status === 429;
+                throw new ApiError(`${method} ${path} failed: ${response.status} ${text.slice(0, 200)}`, response.status, retryable);
+            }
+            return (await response.json());
+        }
+        catch (error) {
+            if (error instanceof ApiError)
+                throw error;
+            // Network failure, DNS, timeout: always worth retrying.
+            throw new ApiError(error instanceof Error ? error.message : String(error), 0, true);
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+}
+/** Exponential backoff with jitter, capped. */
+export function backoffMs(attempt, baseMs = 1000, capMs = 300_000) {
+    const exponential = Math.min(capMs, baseMs * 2 ** attempt);
+    // Jitter prevents a fleet of collectors reconnecting in lockstep after an
+    // outage and immediately knocking the API over again.
+    return Math.round(exponential / 2 + Math.random() * (exponential / 2));
+}
+//# sourceMappingURL=client.js.map

package/dist/transport/client.js.map

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

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@agentstrack/collector",
+  "version": "0.1.0",
+  "description": "Privacy-first telemetry collector for AI coding agents — Claude Code, Codex, and more. Local-first, open source.",
+  "license": "Apache-2.0",
+  "type": "module",
+  "bin": { "agentstrack": "./dist/cli.js" },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": ["dist", "README.md", "LICENSE", "CHANGELOG.md"],
+  "engines": { "node": ">=24" },
+  "keywords": [
+    "claude-code", "codex", "ai-coding", "telemetry", "analytics", "developer-tools",
+    "observability", "token-usage", "ai-cost-tracking", "openai", "anthropic"
+  ],
+  "repository": { "type": "git", "url": "git+https://github.com/agentstrack/collector.git" },
+  "homepage": "https://agentstrack.ai",
+  "bugs": { "url": "https://github.com/agentstrack/collector/issues" },
+  "scripts": {
+    "build": "tsc -p tsconfig.json && chmod +x dist/cli.js",
+    "dev": "tsc -p tsconfig.json --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "lint": "tsc -p tsconfig.json --noEmit",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "dependencies": {
+    "better-sqlite3": "^13.0.3",
+    "chokidar": "^4.0.3",
+    "commander": "^12.1.0",
+    "picocolors": "^1.1.1",
+    "yaml": "^2.6.1",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.12",
+    "@types/node": "^24.0.0",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  }
+}