@tangle-network/browser-agent-driver 0.29.0 → 0.30.0

package/dist/telemetry/client.js

@@ -0,0 +1,203 @@
+/**
+ * Telemetry client — process-singleton gate over the sinks.
+ *
+ * Use `getTelemetry()` from anywhere in the codebase. The first call wires
+ * sinks based on env:
+ *   - BAD_TELEMETRY=0|off|false                 disable everything
+ *   - BAD_TELEMETRY_DIR=/path                    local file root (default ~/.bad/telemetry)
+ *   - BAD_TELEMETRY_ENDPOINT=https://...         optional remote POST
+ *   - BAD_TELEMETRY_BEARER=...                   bearer token for the endpoint
+ *
+ * Why a singleton: every CLI invocation should see the same sink, and
+ * subscribers (audit pipeline, evolve loop, GEPA) may be on different code
+ * paths but share one runId. Globals are usually a smell; for cross-cutting
+ * observability they're the standard.
+ */
+import { execSync } from 'node:child_process';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { randomUUID } from 'node:crypto';
+import { FanoutTelemetrySink, FileTelemetrySink, HttpTelemetrySink, NullTelemetrySink, defaultTelemetryDir, } from './sink.js';
+import { TELEMETRY_SCHEMA_VERSION } from './schema.js';
+let singleton = null;
+let cachedSource = null;
+let cliVersion = '0.0.0';
+/**
+ * Resolve the parentRunId for a child envelope. Order:
+ *   1. explicit args.parentRunId
+ *   2. BAD_PARENT_RUN_ID env var (host-injected for sandbox runs)
+ */
+function resolveParentRunId(explicit) {
+    if (explicit)
+        return explicit;
+    const fromEnv = process.env.BAD_PARENT_RUN_ID?.trim();
+    return fromEnv || undefined;
+}
+export class TelemetryClient {
+    sink;
+    constructor(sink) {
+        this.sink = sink;
+    }
+    emit(args) {
+        const parentRunId = resolveParentRunId(args.parentRunId);
+        const envelope = {
+            schemaVersion: TELEMETRY_SCHEMA_VERSION,
+            envelopeId: randomUUID(),
+            runId: args.runId,
+            timestamp: new Date().toISOString(),
+            source: getSource(),
+            kind: args.kind,
+            ok: args.ok,
+            durationMs: args.durationMs,
+            data: args.data ?? {},
+            metrics: args.metrics ?? {},
+            ...(parentRunId ? { parentRunId } : {}),
+            ...(args.model ? { model: args.model } : {}),
+            ...(args.tags ? { tags: args.tags } : {}),
+            ...(args.error ? { error: args.error } : {}),
+        };
+        try {
+            this.sink.emit(envelope);
+        }
+        catch {
+            // swallow — telemetry never breaks the calling code path
+        }
+    }
+    async close() {
+        await this.sink.close?.();
+    }
+}
+export function getTelemetry() {
+    if (singleton)
+        return singleton;
+    singleton = new TelemetryClient(buildSink());
+    return singleton;
+}
+/** Override for tests + benches that want their own sink. */
+export function setTelemetryClient(client) {
+    singleton = client;
+}
+export function resetTelemetryClient() {
+    singleton = null;
+    cachedSource = null;
+}
+export function setCliVersion(v) {
+    cliVersion = v;
+}
+function buildSink() {
+    const flag = (process.env.BAD_TELEMETRY ?? '').toLowerCase();
+    if (flag === '0' || flag === 'off' || flag === 'false' || flag === 'no') {
+        return new NullTelemetrySink();
+    }
+    const sinks = [];
+    try {
+        sinks.push(new FileTelemetrySink(defaultTelemetryDir()));
+    }
+    catch {
+        // dir not writable — fall through to null
+    }
+    const endpoint = process.env.BAD_TELEMETRY_ENDPOINT?.trim();
+    if (endpoint) {
+        sinks.push(new HttpTelemetrySink(endpoint, process.env.BAD_TELEMETRY_BEARER?.trim()));
+    }
+    if (sinks.length === 0)
+        return new NullTelemetrySink();
+    return new FanoutTelemetrySink(sinks);
+}
+function getSource() {
+    if (cachedSource) {
+        return { ...cachedSource, invocation: cachedSource.invocation };
+    }
+    const cwd = process.cwd();
+    // BAD_SOURCE_REPO override takes precedence — useful inside sandbox/container
+    // runs where cwd is something like /workspace and `git remote -v` is meaningless.
+    const repo = process.env.BAD_SOURCE_REPO?.trim() || inferRepoName(cwd);
+    // Skip the two child_process calls when the host already told us what we are.
+    const { gitSha, gitBranch } = process.env.BAD_SOURCE_REPO ? {} : inferGit(cwd);
+    const tenantId = process.env.BAD_TENANT_ID?.trim();
+    const customerId = process.env.BAD_CUSTOMER_ID?.trim();
+    const apiKeyHash = process.env.BAD_API_KEY_HASH?.trim();
+    cachedSource = {
+        repo,
+        cwd,
+        cliVersion,
+        invocation: process.env.BAD_INVOCATION || 'unknown',
+        ...(gitSha ? { gitSha } : {}),
+        ...(gitBranch ? { gitBranch } : {}),
+        ...(tenantId ? { tenantId } : {}),
+        ...(customerId ? { customerId } : {}),
+        ...(apiKeyHash ? { apiKeyHash } : {}),
+    };
+    return cachedSource;
+}
+export function setInvocation(label, argv) {
+    // Allow the CLI to label each run accurately once it knows what it's doing.
+    if (!cachedSource)
+        getSource();
+    if (cachedSource) {
+        cachedSource.invocation = label;
+        if (argv)
+            cachedSource.argv = sanitiseArgv(argv);
+    }
+}
+function inferRepoName(cwd) {
+    // Prefer git remote basename → falls back to package.json `name` → cwd basename.
+    try {
+        const url = execSync('git config --get remote.origin.url', { cwd, stdio: ['ignore', 'pipe', 'ignore'] })
+            .toString()
+            .trim();
+        if (url) {
+            const m = url.match(/([^/:]+?)(?:\.git)?$/);
+            if (m?.[1])
+                return m[1];
+        }
+    }
+    catch {
+        /* not a git repo */
+    }
+    try {
+        const pkgPath = path.join(cwd, 'package.json');
+        if (fs.existsSync(pkgPath)) {
+            const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+            if (pkg.name)
+                return pkg.name.replace(/^@[^/]+\//, '');
+        }
+    }
+    catch {
+        /* no package.json or unreadable */
+    }
+    return path.basename(cwd) || 'unknown';
+}
+function inferGit(cwd) {
+    try {
+        const sha = execSync('git rev-parse HEAD', { cwd, stdio: ['ignore', 'pipe', 'ignore'] })
+            .toString()
+            .trim();
+        const branch = execSync('git rev-parse --abbrev-ref HEAD', { cwd, stdio: ['ignore', 'pipe', 'ignore'] })
+            .toString()
+            .trim();
+        return { gitSha: sha || undefined, gitBranch: branch || undefined };
+    }
+    catch {
+        return {};
+    }
+}
+const SECRET_FLAGS = new Set(['--api-key', '--bearer', '--token', '--password']);
+function sanitiseArgv(argv) {
+    const out = [];
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (SECRET_FLAGS.has(a)) {
+            out.push(a, '<redacted>');
+            i++;
+            continue;
+        }
+        if (/^(?:--api-key|--bearer|--token|--password)=/.test(a)) {
+            out.push(a.replace(/=.*$/, '=<redacted>'));
+            continue;
+        }
+        out.push(a);
+    }
+    return out;
+}
+//# sourceMappingURL=client.js.map

package/dist/telemetry/client.js.map

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

package/dist/telemetry/hash.d.ts

@@ -0,0 +1,4 @@
+/** 12-hex-char SHA-256 prefix — collision-resistant enough for prompt/rubric
+ *  identity without being noisy. Mirrors agent-eval's PromptRegistry style. */
+export declare function shortHash(input: string): string;
+//# sourceMappingURL=hash.d.ts.map

package/dist/telemetry/hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../src/telemetry/hash.ts"],"names":[],"mappings":"AAEA;+EAC+E;AAC/E,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/C"}

package/dist/telemetry/hash.js

@@ -0,0 +1,7 @@
+import { createHash } from 'node:crypto';
+/** 12-hex-char SHA-256 prefix — collision-resistant enough for prompt/rubric
+ *  identity without being noisy. Mirrors agent-eval's PromptRegistry style. */
+export function shortHash(input) {
+    return createHash('sha256').update(input).digest('hex').slice(0, 12);
+}
+//# sourceMappingURL=hash.js.map

package/dist/telemetry/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../../src/telemetry/hash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAExC;+EAC+E;AAC/E,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;AACtE,CAAC"}

package/dist/telemetry/index.d.ts

@@ -0,0 +1,6 @@
+export { TELEMETRY_SCHEMA_VERSION } from './schema.js';
+export type { TelemetryEnvelope, TelemetryKind, TelemetrySource, TelemetryModel, } from './schema.js';
+export { shortHash } from './hash.js';
+export { TelemetryClient, getTelemetry, setTelemetryClient, resetTelemetryClient, setCliVersion, setInvocation, type EmitArgs, } from './client.js';
+export { type TelemetrySink, FileTelemetrySink, HttpTelemetrySink, FanoutTelemetrySink, NullTelemetrySink, defaultTelemetryDir, } from './sink.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/telemetry/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/telemetry/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAA;AACtD,YAAY,EACV,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,cAAc,GACf,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AACrC,OAAO,EACL,eAAe,EACf,YAAY,EACZ,kBAAkB,EAClB,oBAAoB,EACpB,aAAa,EACb,aAAa,EACb,KAAK,QAAQ,GACd,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,KAAK,aAAa,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,WAAW,CAAA"}

package/dist/telemetry/index.js

@@ -0,0 +1,5 @@
+export { TELEMETRY_SCHEMA_VERSION } from './schema.js';
+export { shortHash } from './hash.js';
+export { TelemetryClient, getTelemetry, setTelemetryClient, resetTelemetryClient, setCliVersion, setInvocation, } from './client.js';
+export { FileTelemetrySink, HttpTelemetrySink, FanoutTelemetrySink, NullTelemetrySink, defaultTelemetryDir, } from './sink.js';
+//# sourceMappingURL=index.js.map

package/dist/telemetry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/telemetry/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAA;AAOtD,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AACrC,OAAO,EACL,eAAe,EACf,YAAY,EACZ,kBAAkB,EAClB,oBAAoB,EACpB,aAAa,EACb,aAAa,GAEd,MAAM,aAAa,CAAA;AACpB,OAAO,EAEL,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,WAAW,CAAA"}

package/dist/telemetry/schema.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Fleet telemetry envelope.
+ *
+ * One envelope per meaningful unit of work — a page audit, an evolve round, a
+ * full bad run. Envelopes are append-only and JSONL-friendly. Schema is
+ * deliberately a superset of agent-eval's Run/Span trace shape so a future
+ * rollup script can promote these into agent-eval traces without translation.
+ *
+ * Versioning: bump `schemaVersion` only when readers must change. Adding
+ * optional fields is backwards-compatible and does not require a bump.
+ */
+export declare const TELEMETRY_SCHEMA_VERSION = 1;
+/** Discriminator for the high-level invocation that produced this envelope. */
+export type TelemetryKind = 'design-audit-page' | 'design-audit-run' | 'design-evolve-round' | 'design-evolve-run' | 'agent-run' | 'gepa-trial' | 'gepa-generation';
+export interface TelemetryEnvelope {
+    schemaVersion: typeof TELEMETRY_SCHEMA_VERSION;
+    /** Unique id for this envelope. */
+    envelopeId: string;
+    /** Groups envelopes from a single CLI invocation. */
+    runId: string;
+    /** When this envelope was finalised. */
+    timestamp: string;
+    /** Optional: link a child envelope (e.g. one page) to a parent run envelope. */
+    parentRunId?: string;
+    source: TelemetrySource;
+    model?: TelemetryModel;
+    kind: TelemetryKind;
+    ok: boolean;
+    durationMs: number;
+    /**
+     * Kind-specific payload. Stays loose on purpose — readers query by `kind` and
+     * key into `data`. Keep shapes flat and JSON-serialisable; large blobs
+     * (screenshots, full snapshots) belong on disk in the run's sink, not here.
+     */
+    data: Record<string, unknown>;
+    /**
+     * Numeric metrics suitable for aggregation: scores, counts, durations, costs.
+     * Kept separate from `data` so a rollup can sum/avg without schema awareness.
+     */
+    metrics: Record<string, number>;
+    /** Free-form labels for filtering during rollup. */
+    tags?: Record<string, string>;
+    /** Populated only when `ok === false`. */
+    error?: string;
+}
+export interface TelemetrySource {
+    /** Repo identity — basename of cwd plus git remote if discoverable. */
+    repo: string;
+    cwd: string;
+    gitSha?: string;
+    gitBranch?: string;
+    cliVersion: string;
+    /** What was invoked, e.g. `design-audit`, `design-audit --evolve`, `run`. */
+    invocation: string;
+    /** Sanitised argv minus secrets. */
+    argv?: string[];
+    /**
+     * Multi-tenant identity. Set when the CLI runs inside a hosted product
+     * (bad-app, agent-platform) so a fleet rollup can group by tenant without
+     * leaking customer URLs or PII. The host populates this via
+     * `BAD_TENANT_ID` env var when it spawns the sandbox.
+     */
+    tenantId?: string;
+    /**
+     * Optional sub-tenant identity (project, suite, walkthrough, customer).
+     * Convention: opaque string the host can map back to its own entities.
+     */
+    customerId?: string;
+    /**
+     * SHA-256 (12 hex) of the API key used to authenticate this run, when the
+     * host supplies one. Lets a rollup attribute usage to a key without
+     * holding the key itself. Set via `BAD_API_KEY_HASH` env var.
+     */
+    apiKeyHash?: string;
+}
+export interface TelemetryModel {
+    provider: string;
+    name: string;
+    /** SHA-256 (12 hex chars) of the prompt(s) used. Lets a rollup correlate
+     *  outcome shifts to specific prompt versions. */
+    promptHash?: string;
+    /** SHA-256 (12 hex chars) of the composed rubric body if applicable. */
+    rubricHash?: string;
+}
+//# sourceMappingURL=schema.d.ts.map

package/dist/telemetry/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/telemetry/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,eAAO,MAAM,wBAAwB,IAAI,CAAA;AAEzC,+EAA+E;AAC/E,MAAM,MAAM,aAAa,GACrB,mBAAmB,GACnB,kBAAkB,GAClB,qBAAqB,GACrB,mBAAmB,GACnB,WAAW,GACX,YAAY,GACZ,iBAAiB,CAAA;AAErB,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,OAAO,wBAAwB,CAAA;IAC9C,mCAAmC;IACnC,UAAU,EAAE,MAAM,CAAA;IAClB,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAA;IACb,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAA;IACjB,gFAAgF;IAChF,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB,MAAM,EAAE,eAAe,CAAA;IACvB,KAAK,CAAC,EAAE,cAAc,CAAA;IACtB,IAAI,EAAE,aAAa,CAAA;IACnB,EAAE,EAAE,OAAO,CAAA;IACX,UAAU,EAAE,MAAM,CAAA;IAElB;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAE7B;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAE/B,oDAAoD;IACpD,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAE7B,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,6EAA6E;IAC7E,UAAU,EAAE,MAAM,CAAA;IAClB,oCAAoC;IACpC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ;sDACkD;IAClD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB"}

package/dist/telemetry/schema.js

@@ -0,0 +1,13 @@
+/**
+ * Fleet telemetry envelope.
+ *
+ * One envelope per meaningful unit of work — a page audit, an evolve round, a
+ * full bad run. Envelopes are append-only and JSONL-friendly. Schema is
+ * deliberately a superset of agent-eval's Run/Span trace shape so a future
+ * rollup script can promote these into agent-eval traces without translation.
+ *
+ * Versioning: bump `schemaVersion` only when readers must change. Adding
+ * optional fields is backwards-compatible and does not require a bump.
+ */
+export const TELEMETRY_SCHEMA_VERSION = 1;
+//# sourceMappingURL=schema.js.map

package/dist/telemetry/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/telemetry/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAA"}

package/dist/telemetry/sink.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Telemetry sinks — destinations for envelopes.
+ *
+ * The default policy emits to two sinks:
+ *   1. Local file at `${BAD_TELEMETRY_DIR ?? ~/.bad/telemetry}/<repo>/<date>.jsonl`
+ *      — always on, cheap, survives across machines via dotfiles/sync.
+ *   2. HTTP POST to `BAD_TELEMETRY_ENDPOINT` if set — for fleet rollups.
+ *
+ * Both sinks are best-effort: a failure here MUST NOT break the calling
+ * invocation. Telemetry is observability, not a feature.
+ */
+import type { TelemetryEnvelope } from './schema.js';
+export interface TelemetrySink {
+    emit(envelope: TelemetryEnvelope): Promise<void> | void;
+    close?(): Promise<void> | void;
+}
+/** Append envelopes to a JSONL file rolling by date and repo. */
+export declare class FileTelemetrySink implements TelemetrySink {
+    private readonly baseDir;
+    private streams;
+    constructor(baseDir: string);
+    emit(envelope: TelemetryEnvelope): void;
+    close(): Promise<void>;
+}
+/** Best-effort POST to a remote collector. Batches small payloads via fetch. */
+export declare class HttpTelemetrySink implements TelemetrySink {
+    private readonly endpoint;
+    private readonly bearer?;
+    private inflight;
+    constructor(endpoint: string, bearer?: string | undefined);
+    emit(envelope: TelemetryEnvelope): void;
+    close(): Promise<void>;
+}
+/** Fanout to multiple sinks — failures in one do not affect others. */
+export declare class FanoutTelemetrySink implements TelemetrySink {
+    private readonly sinks;
+    constructor(sinks: TelemetrySink[]);
+    emit(envelope: TelemetryEnvelope): void;
+    close(): Promise<void>;
+}
+/** No-op sink — used when telemetry is explicitly disabled. */
+export declare class NullTelemetrySink implements TelemetrySink {
+    emit(): void;
+}
+export declare function defaultTelemetryDir(): string;
+//# sourceMappingURL=sink.d.ts.map

package/dist/telemetry/sink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sink.d.ts","sourceRoot":"","sources":["../../src/telemetry/sink.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAEpD,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;IACvD,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;CAC/B;AAED,iEAAiE;AACjE,qBAAa,iBAAkB,YAAW,aAAa;IAGzC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,OAAO,CAAC,OAAO,CAAoC;gBAEtB,OAAO,EAAE,MAAM;IAI5C,IAAI,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAcjC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAO7B;AAED,gFAAgF;AAChF,qBAAa,iBAAkB,YAAW,aAAa;IAInD,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IAJ1B,OAAO,CAAC,QAAQ,CAA2B;gBAGxB,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,YAAA;IAGlC,IAAI,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAWjC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B;AAED,uEAAuE;AACvE,qBAAa,mBAAoB,YAAW,aAAa;IAC3C,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,aAAa,EAAE;IAEnD,IAAI,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAajC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B;AAED,+DAA+D;AAC/D,qBAAa,iBAAkB,YAAW,aAAa;IACrD,IAAI,IAAI,IAAI;CACb;AAED,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C"}

package/dist/telemetry/sink.js

@@ -0,0 +1,97 @@
+/**
+ * Telemetry sinks — destinations for envelopes.
+ *
+ * The default policy emits to two sinks:
+ *   1. Local file at `${BAD_TELEMETRY_DIR ?? ~/.bad/telemetry}/<repo>/<date>.jsonl`
+ *      — always on, cheap, survives across machines via dotfiles/sync.
+ *   2. HTTP POST to `BAD_TELEMETRY_ENDPOINT` if set — for fleet rollups.
+ *
+ * Both sinks are best-effort: a failure here MUST NOT break the calling
+ * invocation. Telemetry is observability, not a feature.
+ */
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+/** Append envelopes to a JSONL file rolling by date and repo. */
+export class FileTelemetrySink {
+    baseDir;
+    streams = new Map();
+    constructor(baseDir) {
+        this.baseDir = baseDir;
+        fs.mkdirSync(baseDir, { recursive: true });
+    }
+    emit(envelope) {
+        const date = envelope.timestamp.slice(0, 10); // YYYY-MM-DD
+        const repo = envelope.source.repo || 'unknown';
+        const key = `${repo}/${date}`;
+        let stream = this.streams.get(key);
+        if (!stream) {
+            const dir = path.join(this.baseDir, repo);
+            fs.mkdirSync(dir, { recursive: true });
+            stream = fs.createWriteStream(path.join(dir, `${date}.jsonl`), { flags: 'a', encoding: 'utf-8' });
+            this.streams.set(key, stream);
+        }
+        stream.write(`${JSON.stringify(envelope)}\n`);
+    }
+    async close() {
+        const closes = Array.from(this.streams.values()).map((s) => new Promise((resolve) => s.end(() => resolve())));
+        this.streams.clear();
+        await Promise.all(closes);
+    }
+}
+/** Best-effort POST to a remote collector. Batches small payloads via fetch. */
+export class HttpTelemetrySink {
+    endpoint;
+    bearer;
+    inflight = new Set();
+    constructor(endpoint, bearer) {
+        this.endpoint = endpoint;
+        this.bearer = bearer;
+    }
+    emit(envelope) {
+        const body = JSON.stringify(envelope);
+        const headers = { 'content-type': 'application/json' };
+        if (this.bearer)
+            headers.authorization = `Bearer ${this.bearer}`;
+        const promise = fetch(this.endpoint, { method: 'POST', headers, body })
+            .then(() => undefined)
+            .catch(() => undefined);
+        this.inflight.add(promise);
+        promise.finally(() => this.inflight.delete(promise));
+    }
+    async close() {
+        await Promise.allSettled(Array.from(this.inflight));
+    }
+}
+/** Fanout to multiple sinks — failures in one do not affect others. */
+export class FanoutTelemetrySink {
+    sinks;
+    constructor(sinks) {
+        this.sinks = sinks;
+    }
+    emit(envelope) {
+        for (const sink of this.sinks) {
+            try {
+                const result = sink.emit(envelope);
+                if (result && typeof result.catch === 'function') {
+                    ;
+                    result.catch(() => undefined);
+                }
+            }
+            catch {
+                // swallow — telemetry must never break a run
+            }
+        }
+    }
+    async close() {
+        await Promise.allSettled(this.sinks.map((s) => Promise.resolve(s.close?.())));
+    }
+}
+/** No-op sink — used when telemetry is explicitly disabled. */
+export class NullTelemetrySink {
+    emit() { }
+}
+export function defaultTelemetryDir() {
+    return process.env.BAD_TELEMETRY_DIR || path.join(os.homedir(), '.bad', 'telemetry');
+}
+//# sourceMappingURL=sink.js.map

package/dist/telemetry/sink.js.map

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

package/dist/types.d.ts

@@ -324,8 +324,8 @@ export interface Scenario {
     parentRunId?: string;
 }
 export interface AgentConfig {
-    /** LLM provider: 'openai' (default), 'anthropic', 'google', 'codex-cli', 'claude-code', or 'sandbox-backend' */
-    provider?: 'openai' | 'anthropic' | 'google' | 'codex-cli' | 'claude-code' | 'sandbox-backend';
+    /** LLM provider: 'openai' (default), 'anthropic', 'google', 'cli-bridge', 'codex-cli', 'claude-code', 'sandbox-backend', or 'zai-coding-plan' */
+    provider?: 'openai' | 'anthropic' | 'google' | 'cli-bridge' | 'codex-cli' | 'claude-code' | 'sandbox-backend' | 'zai-coding-plan';
     /** LLM model (default: gpt-5.4) */
     model?: string;
     /** Enable adaptive model routing for decide() (default: false) */
@@ -333,7 +333,7 @@ export interface AgentConfig {
     /** Fast navigation model used when adaptive routing is enabled */
     navModel?: string;
     /** Provider for navModel (defaults to provider) */
-    navProvider?: 'openai' | 'anthropic' | 'google' | 'codex-cli' | 'claude-code' | 'sandbox-backend';
+    navProvider?: 'openai' | 'anthropic' | 'google' | 'cli-bridge' | 'codex-cli' | 'claude-code' | 'sandbox-backend' | 'zai-coding-plan';
     /** Gen 28: per-role model overrides. Each role falls back to the main model/provider. */
     models?: {
         /** Planner — needs best reasoning. Default: main model. */
@@ -468,7 +468,7 @@ export interface ScoutConfig {
     /** Optional model override for scout reasoning */
     model?: string;
     /** Optional provider override for scout model */
-    provider?: 'openai' | 'anthropic' | 'google' | 'codex-cli' | 'claude-code' | 'sandbox-backend';
+    provider?: 'openai' | 'anthropic' | 'google' | 'cli-bridge' | 'codex-cli' | 'claude-code' | 'sandbox-backend' | 'zai-coding-plan';
     /** Allow the scout to inspect the current screenshot when available */
     useVision?: boolean;
     /** Max ranked candidates sent to the scout */
@@ -486,7 +486,7 @@ export interface SupervisorConfig {
     /** Optional model override for supervisor reasoning */
     model?: string;
     /** Optional provider override for supervisor model */
-    provider?: 'openai' | 'anthropic' | 'google' | 'codex-cli' | 'claude-code' | 'sandbox-backend';
+    provider?: 'openai' | 'anthropic' | 'google' | 'cli-bridge' | 'codex-cli' | 'claude-code' | 'sandbox-backend' | 'zai-coding-plan';
     /** Allow the supervisor to inspect the current screenshot when available */
     useVision?: boolean;
     /** Minimum completed turns before supervisor can intervene */