@antseed/telemetry 0.0.0-stage → 0.1.1

package/dist/buckets.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Coarse buckets for the counts, durations and amounts that are sent as a
+ * range, not an exact value (for example a deposit amount). Request timings
+ * and token counts are sent exactly; see docs/telemetry.md.
+ */
+export type DurationBucket = 'under_30s' | '30s_2m' | '2m_5m' | 'over_5m';
+export type CountBucket = '0' | '1' | '2_5' | '6_20' | '21_plus';
+export type SmallCountBucket = '0' | '1' | '2_3' | '4_plus';
+export type AttemptCountBucket = '1' | '2' | '3_plus';
+export type SellersTriedBucket = '0' | '1' | '2' | '3_plus';
+/** USDC amount buckets, from integer base units (6 decimals). */
+export type UsdcAmountBucket = 'zero' | 'under_0_01' | '0_01_0_1' | '0_1_1' | '1_10' | 'over_10';
+export declare const DURATION_BUCKETS: ReadonlySet<string>;
+export declare const COUNT_BUCKETS: ReadonlySet<string>;
+export declare const SMALL_COUNT_BUCKETS: ReadonlySet<string>;
+export declare const ATTEMPT_COUNT_BUCKETS: ReadonlySet<string>;
+export declare const SELLERS_TRIED_BUCKETS: ReadonlySet<string>;
+export declare const USDC_AMOUNT_BUCKETS: ReadonlySet<string>;
+export declare function durationBucket(ms: number): DurationBucket;
+export declare function countBucket(count: number): CountBucket;
+export declare function smallCountBucket(count: number): SmallCountBucket;
+export declare function attemptCountBucket(attempts: number): AttemptCountBucket;
+export declare function sellersTriedBucket(count: number): SellersTriedBucket;
+/** Buckets a USDC amount given as integer base units (6 decimals). Never a float. */
+export declare function usdcAmountBucket(baseUnits: bigint): UsdcAmountBucket;
+/** HTTP status as sent: an integer in 100–599, else undefined. */
+export declare function telemetryHttpStatus(statusCode: number | undefined): number | undefined;
+//# sourceMappingURL=buckets.d.ts.map

package/dist/buckets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buckets.d.ts","sourceRoot":"","sources":["../src/buckets.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;AAC1E,MAAM,MAAM,WAAW,GAAG,GAAG,GAAG,GAAG,GAAG,KAAK,GAAG,MAAM,GAAG,SAAS,CAAC;AACjE,MAAM,MAAM,gBAAgB,GAAG,GAAG,GAAG,GAAG,GAAG,KAAK,GAAG,QAAQ,CAAC;AAC5D,MAAM,MAAM,kBAAkB,GAAG,GAAG,GAAG,GAAG,GAAG,QAAQ,CAAC;AACtD,MAAM,MAAM,kBAAkB,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,QAAQ,CAAC;AAC5D,iEAAiE;AACjE,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,YAAY,GAAG,UAAU,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;AAEjG,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,MAAM,CAAwD,CAAC;AAC1G,eAAO,MAAM,aAAa,EAAE,WAAW,CAAC,MAAM,CAAiD,CAAC;AAChG,eAAO,MAAM,mBAAmB,EAAE,WAAW,CAAC,MAAM,CAAwC,CAAC;AAC7F,eAAO,MAAM,qBAAqB,EAAE,WAAW,CAAC,MAAM,CAAiC,CAAC;AACxF,eAAO,MAAM,qBAAqB,EAAE,WAAW,CAAC,MAAM,CAAsC,CAAC;AAC7F,eAAO,MAAM,mBAAmB,EAAE,WAAW,CAAC,MAAM,CAA2E,CAAC;AAChI,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,CAKzD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAMtD;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,CAKhE;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,CAIvE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,CAKpE;AAED,qFAAqF;AACrF,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,CAOpE;AAED,kEAAkE;AAClE,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAItF"}

package/dist/buckets.js

@@ -0,0 +1,77 @@
+/**
+ * Coarse buckets for the counts, durations and amounts that are sent as a
+ * range, not an exact value (for example a deposit amount). Request timings
+ * and token counts are sent exactly; see docs/telemetry.md.
+ */
+export const DURATION_BUCKETS = new Set(['under_30s', '30s_2m', '2m_5m', 'over_5m']);
+export const COUNT_BUCKETS = new Set(['0', '1', '2_5', '6_20', '21_plus']);
+export const SMALL_COUNT_BUCKETS = new Set(['0', '1', '2_3', '4_plus']);
+export const ATTEMPT_COUNT_BUCKETS = new Set(['1', '2', '3_plus']);
+export const SELLERS_TRIED_BUCKETS = new Set(['0', '1', '2', '3_plus']);
+export const USDC_AMOUNT_BUCKETS = new Set(['zero', 'under_0_01', '0_01_0_1', '0_1_1', '1_10', 'over_10']);
+export function durationBucket(ms) {
+    if (ms < 30_000)
+        return 'under_30s';
+    if (ms < 2 * 60_000)
+        return '30s_2m';
+    if (ms < 5 * 60_000)
+        return '2m_5m';
+    return 'over_5m';
+}
+export function countBucket(count) {
+    if (count <= 0)
+        return '0';
+    if (count === 1)
+        return '1';
+    if (count <= 5)
+        return '2_5';
+    if (count <= 20)
+        return '6_20';
+    return '21_plus';
+}
+export function smallCountBucket(count) {
+    if (count <= 0)
+        return '0';
+    if (count === 1)
+        return '1';
+    if (count <= 3)
+        return '2_3';
+    return '4_plus';
+}
+export function attemptCountBucket(attempts) {
+    if (attempts <= 1)
+        return '1';
+    if (attempts === 2)
+        return '2';
+    return '3_plus';
+}
+export function sellersTriedBucket(count) {
+    if (count <= 0)
+        return '0';
+    if (count === 1)
+        return '1';
+    if (count === 2)
+        return '2';
+    return '3_plus';
+}
+/** Buckets a USDC amount given as integer base units (6 decimals). Never a float. */
+export function usdcAmountBucket(baseUnits) {
+    if (baseUnits <= 0n)
+        return 'zero';
+    if (baseUnits < 10000n)
+        return 'under_0_01';
+    if (baseUnits < 100000n)
+        return '0_01_0_1';
+    if (baseUnits < 1000000n)
+        return '0_1_1';
+    if (baseUnits < 10000000n)
+        return '1_10';
+    return 'over_10';
+}
+/** HTTP status as sent: an integer in 100–599, else undefined. */
+export function telemetryHttpStatus(statusCode) {
+    return typeof statusCode === 'number' && Number.isInteger(statusCode) && statusCode >= 100 && statusCode <= 599
+        ? statusCode
+        : undefined;
+}
+//# sourceMappingURL=buckets.js.map

package/dist/buckets.js.map

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

package/dist/client.d.ts

@@ -0,0 +1,49 @@
+import { type EventCatalog } from './sanitize.js';
+import { type PostHogSender } from './posthog.js';
+import type { PostHogConfig } from './consent.js';
+export declare const TELEMETRY_SCHEMA_VERSION = 2;
+/**
+ * A host reports only its own UI (the desktop's screens, the gateway's setup
+ * funnel); all usage comes from the buyer, whichever host runs it.
+ */
+export type TelemetryProduct = 'desktop' | 'gateway' | 'buyer';
+export type BuyerHost = 'desktop' | 'gateway' | 'standalone';
+export declare const BUYER_HOSTS: ReadonlySet<string>;
+/** Env a host sets on the buyer it spawns. */
+export declare const TELEMETRY_HOST_ENV = "ANTSEED_TELEMETRY_HOST";
+export declare const TELEMETRY_HOST_SESSION_ID_ENV = "ANTSEED_TELEMETRY_HOST_SESSION_ID";
+/** RFC 9562 UUIDv7. PostHog's Sessions explorer derives session start from these bits. */
+export declare function uuidV7(timestampMs?: number): string;
+export declare const UUID_PATTERN: RegExp;
+/** The buyer's normalized EVM address, or null. Nothing else is a distinct id. */
+export declare function normalizeDistinctId(value: string | null | undefined): string | null;
+export declare function normalizeBuyerHost(value: string | undefined): BuyerHost;
+export type TelemetryClientOptions = {
+    product: TelemetryProduct;
+    appVersion: string;
+    platform?: string;
+    arch?: string;
+    installSource?: string;
+    catalog: EventCatalog;
+    getDistinctId: () => string | null;
+    /** Checked on every capture and before every flush. */
+    isEnabled: () => boolean;
+    sender?: PostHogSender;
+    posthog?: PostHogConfig | null;
+    /** Buyer events: who started this buyer, and that host's session. */
+    buyerHost?: BuyerHost;
+    hostSessionId?: string | null;
+    nowMs?: () => number;
+    flushIntervalMs?: number;
+    maxQueue?: number;
+};
+export type TelemetryClient = {
+    readonly sessionId: string;
+    /** Returns whether the event was queued. Never throws. */
+    capture: (event: string, properties?: Readonly<Record<string, unknown>>, eventTsMs?: number) => boolean;
+    flush: () => Promise<void>;
+    /** Bounded flush for shutdown. */
+    close: (timeoutMs?: number) => Promise<void>;
+};
+export declare function createTelemetryClient(options: TelemetryClientOptions): TelemetryClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AASA,OAAO,EAA2B,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAC3E,OAAO,EAAsD,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AACtG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAE1C;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAC/D,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,YAAY,CAAC;AAE7D,eAAO,MAAM,WAAW,EAAE,WAAW,CAAC,MAAM,CAA4D,CAAC;AAEzG,8CAA8C;AAC9C,eAAO,MAAM,kBAAkB,2BAA2B,CAAC;AAC3D,eAAO,MAAM,6BAA6B,sCAAsC,CAAC;AAEjF,0FAA0F;AAC1F,wBAAgB,MAAM,CAAC,WAAW,GAAE,MAAmB,GAAG,MAAM,CAW/D;AAED,eAAO,MAAM,YAAY,QAA+E,CAAC;AAEzG,kFAAkF;AAClF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAGnF;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAGvE;AAED,MAAM,MAAM,sBAAsB,GAAG;IACnC,OAAO,EAAE,gBAAgB,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,YAAY,CAAC;IACtB,aAAa,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IACnC,uDAAuD;IACvD,SAAS,EAAE,MAAM,OAAO,CAAC;IACzB,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,OAAO,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IAC/B,qEAAqE;IACrE,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,0DAA0D;IAC1D,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;IACxG,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,kCAAkC;IAClC,KAAK,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9C,CAAC;AAEF,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,eAAe,CA+DtF"}

package/dist/client.js

@@ -0,0 +1,107 @@
+/**
+ * A product's telemetry client: one envelope, one sanitizer, one queue.
+ *
+ * Every event carries `schema_version`, `product`, a per-process UUIDv7
+ * session id, the app version and platform. Person profiles are never
+ * processed, and every capture sets `$geoip_disable: true`, so PostHog derives
+ * no location from the request IP.
+ */
+import { randomBytes } from 'node:crypto';
+import { sanitizeEventProperties } from './sanitize.js';
+import { BatchQueue, createPostHogSender } from './posthog.js';
+export const TELEMETRY_SCHEMA_VERSION = 2;
+export const BUYER_HOSTS = new Set(['desktop', 'gateway', 'standalone']);
+/** Env a host sets on the buyer it spawns. */
+export const TELEMETRY_HOST_ENV = 'ANTSEED_TELEMETRY_HOST';
+export const TELEMETRY_HOST_SESSION_ID_ENV = 'ANTSEED_TELEMETRY_HOST_SESSION_ID';
+/** RFC 9562 UUIDv7. PostHog's Sessions explorer derives session start from these bits. */
+export function uuidV7(timestampMs = Date.now()) {
+    const bytes = randomBytes(16);
+    let remaining = Math.max(0, Math.floor(timestampMs));
+    for (let i = 5; i >= 0; i -= 1) {
+        bytes[i] = remaining % 256;
+        remaining = Math.floor(remaining / 256);
+    }
+    bytes[6] = (bytes[6] & 0x0f) | 0x70;
+    bytes[8] = (bytes[8] & 0x3f) | 0x80;
+    const hex = bytes.toString('hex');
+    return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
+}
+export const UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+/** The buyer's normalized EVM address, or null. Nothing else is a distinct id. */
+export function normalizeDistinctId(value) {
+    const normalized = value?.trim().toLowerCase() ?? '';
+    return /^0x[0-9a-f]{40}$/.test(normalized) ? normalized : null;
+}
+export function normalizeBuyerHost(value) {
+    const normalized = value?.trim().toLowerCase() ?? '';
+    return BUYER_HOSTS.has(normalized) ? normalized : 'standalone';
+}
+export function createTelemetryClient(options) {
+    const now = options.nowMs ?? (() => Date.now());
+    const sessionId = uuidV7(now());
+    const sender = options.sender
+        ?? (options.posthog ? createPostHogSender(options.posthog) : async () => undefined);
+    const enabled = () => {
+        try {
+            return options.isEnabled();
+        }
+        catch {
+            return false;
+        }
+    };
+    const queue = new BatchQueue({
+        send: sender,
+        isEnabled: enabled,
+        ...(options.flushIntervalMs !== undefined ? { flushIntervalMs: options.flushIntervalMs } : {}),
+        ...(options.maxQueue !== undefined ? { maxQueue: options.maxQueue } : {}),
+    });
+    const hostSessionId = options.hostSessionId && UUID_PATTERN.test(options.hostSessionId)
+        ? options.hostSessionId.toLowerCase()
+        : null;
+    const capture = (event, properties, eventTsMs = now()) => {
+        try {
+            if (!enabled())
+                return false;
+            const distinctId = normalizeDistinctId(options.getDistinctId());
+            if (!distinctId)
+                return false;
+            const sanitized = sanitizeEventProperties(options.catalog, event, properties);
+            if (!sanitized)
+                return false;
+            const payload = {
+                event,
+                distinct_id: distinctId,
+                timestamp: new Date(eventTsMs).toISOString(),
+                properties: {
+                    $geoip_disable: true,
+                    $process_person_profile: false,
+                    schema_version: TELEMETRY_SCHEMA_VERSION,
+                    product: options.product,
+                    event_ts_ms: eventTsMs,
+                    session_id: sessionId,
+                    $session_id: sessionId,
+                    app_version: options.appVersion,
+                    platform: options.platform ?? process.platform,
+                    arch: options.arch ?? process.arch,
+                    install_source: options.installSource ?? 'unknown',
+                    ...(options.buyerHost ? { buyer_host: options.buyerHost } : {}),
+                    ...(hostSessionId ? { host_session_id: hostSessionId } : {}),
+                    ...sanitized,
+                },
+            };
+            queue.push(payload);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    };
+    return {
+        sessionId,
+        capture,
+        flush: () => queue.flush(),
+        close: (timeoutMs) => queue.close(timeoutMs),
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/consent.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Whether a process may send telemetry. One rule for every product, highest
+ * first:
+ * 1. `DO_NOT_TRACK=1`, or `ANTSEED_TELEMETRY=0|false|no|off`: always off.
+ * 2. CI (`CI` set and not false): off.
+ * 3. No PostHog project configured (source builds bake none): off.
+ * 4. The persisted choice (`telemetry.enabled` in the config file, or the
+ *    desktop's own preference): `false` turns it off.
+ * 5. The product default: off. Only an explicit `true` (the user turned it
+ *    on) sends anything.
+ */
+export declare const TELEMETRY_ENV = "ANTSEED_TELEMETRY";
+export declare const DO_NOT_TRACK_ENV = "DO_NOT_TRACK";
+export declare const POSTHOG_HOST_ENV = "POSTHOG_HOST";
+export declare const POSTHOG_PROJECT_API_KEY_ENV = "POSTHOG_PROJECT_API_KEY";
+export type ConsentDecision = {
+    enabled: true;
+} | {
+    enabled: false;
+    reason: 'do_not_track' | 'env_disabled' | 'ci' | 'not_configured' | 'user_disabled' | 'not_enabled' | 'dev_build';
+};
+export declare function isCiEnvironment(env: NodeJS.ProcessEnv): boolean;
+export type PostHogConfig = {
+    host: string;
+    projectApiKey: string;
+};
+/** Runtime env wins over baked values; only HTTPS hosts are accepted. */
+export declare function resolvePostHogConfig(env: NodeJS.ProcessEnv, baked: {
+    host: string | null;
+    projectApiKey: string | null;
+}): PostHogConfig | null;
+export declare function resolveConsent(input: {
+    env: NodeJS.ProcessEnv;
+    configured: boolean;
+    /** The persisted user choice; undefined when never set. */
+    persisted?: boolean;
+    isDev?: boolean;
+}): ConsentDecision;
+//# sourceMappingURL=consent.d.ts.map

package/dist/consent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consent.d.ts","sourceRoot":"","sources":["../src/consent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,eAAO,MAAM,aAAa,sBAAsB,CAAC;AACjD,eAAO,MAAM,gBAAgB,iBAAiB,CAAC;AAC/C,eAAO,MAAM,gBAAgB,iBAAiB,CAAC;AAC/C,eAAO,MAAM,2BAA2B,4BAA4B,CAAC;AAErE,MAAM,MAAM,eAAe,GACvB;IAAE,OAAO,EAAE,IAAI,CAAA;CAAE,GACjB;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,cAAc,GAAG,cAAc,GAAG,IAAI,GAAG,gBAAgB,GAAG,eAAe,GAAG,aAAa,GAAG,WAAW,CAAA;CAAE,CAAC;AAa1I,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,OAAO,CAG/D;AAED,MAAM,MAAM,aAAa,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpE,yEAAyE;AACzE,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,MAAM,CAAC,UAAU,EACtB,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAC3D,aAAa,GAAG,IAAI,CAUtB;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE;IACpC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,UAAU,EAAE,OAAO,CAAC;IACpB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,GAAG,eAAe,CAUlB"}

package/dist/consent.js

@@ -0,0 +1,65 @@
+/**
+ * Whether a process may send telemetry. One rule for every product, highest
+ * first:
+ * 1. `DO_NOT_TRACK=1`, or `ANTSEED_TELEMETRY=0|false|no|off`: always off.
+ * 2. CI (`CI` set and not false): off.
+ * 3. No PostHog project configured (source builds bake none): off.
+ * 4. The persisted choice (`telemetry.enabled` in the config file, or the
+ *    desktop's own preference): `false` turns it off.
+ * 5. The product default: off. Only an explicit `true` (the user turned it
+ *    on) sends anything.
+ */
+export const TELEMETRY_ENV = 'ANTSEED_TELEMETRY';
+export const DO_NOT_TRACK_ENV = 'DO_NOT_TRACK';
+export const POSTHOG_HOST_ENV = 'POSTHOG_HOST';
+export const POSTHOG_PROJECT_API_KEY_ENV = 'POSTHOG_PROJECT_API_KEY';
+const FALSY = new Set(['0', 'false', 'no', 'off']);
+const TRUTHY = new Set(['1', 'true', 'yes', 'on']);
+function envFlag(value) {
+    const normalized = value?.trim().toLowerCase();
+    if (!normalized)
+        return null;
+    if (FALSY.has(normalized))
+        return false;
+    if (TRUTHY.has(normalized))
+        return true;
+    return null;
+}
+export function isCiEnvironment(env) {
+    const ci = env['CI']?.trim().toLowerCase();
+    return Boolean(ci) && ci !== '0' && ci !== 'false';
+}
+/** Runtime env wins over baked values; only HTTPS hosts are accepted. */
+export function resolvePostHogConfig(env, baked) {
+    const host = (env[POSTHOG_HOST_ENV]?.trim() || baked.host || '').replace(/\/+$/, '');
+    const projectApiKey = env[POSTHOG_PROJECT_API_KEY_ENV]?.trim() || baked.projectApiKey || '';
+    if (!host || !projectApiKey)
+        return null;
+    try {
+        if (new URL(host).protocol !== 'https:')
+            return null;
+    }
+    catch {
+        return null;
+    }
+    return { host, projectApiKey };
+}
+export function resolveConsent(input) {
+    const { env } = input;
+    if (envFlag(env[DO_NOT_TRACK_ENV]) === true)
+        return { enabled: false, reason: 'do_not_track' };
+    if (envFlag(env[TELEMETRY_ENV]) === false)
+        return { enabled: false, reason: 'env_disabled' };
+    if (input.isDev)
+        return { enabled: false, reason: 'dev_build' };
+    if (isCiEnvironment(env))
+        return { enabled: false, reason: 'ci' };
+    if (!input.configured)
+        return { enabled: false, reason: 'not_configured' };
+    if (input.persisted === false)
+        return { enabled: false, reason: 'user_disabled' };
+    if (input.persisted !== true)
+        return { enabled: false, reason: 'not_enabled' };
+    return { enabled: true };
+}
+//# sourceMappingURL=consent.js.map

package/dist/consent.js.map

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

package/dist/failure.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Fixed `failure_reason` taxonomy for a model request, shared by the desktop
+ * chat (what the user saw) and the buyer proxy (what the network did). Raw
+ * error text is read here and discarded; only the enum leaves the device.
+ */
+export type FailureReason = 'none' | 'out_of_credits' | 'model_needs_paid' | 'seller_dropped_before_output' | 'seller_dropped_mid_answer' | 'seller_5xx' | 'request_rejected' | 'rate_limited' | 'no_seller_available' | 'no_seller_yet' | 'seller_unreachable' | 'timeout' | 'local_error' | 'unknown';
+export declare const FAILURE_REASONS: ReadonlySet<string>;
+/** A classified stop: the kind of failure, and its HTTP status when known. */
+export type FailureSignal = {
+    kind: string;
+    statusCode?: number;
+};
+export type FailureReasonContext = {
+    /** Whether any text/tool output reached the client before the failure. */
+    hadPartialOutput: boolean;
+    /** Whether any online peer was known when the request was sent. */
+    peersDiscoveredAtSend: boolean;
+    /** Distinct free sellers known for the model at send. */
+    freeSellersKnown: number;
+    /** Undefined when the balance is unknown. */
+    buyerBalanceZero?: boolean;
+};
+/**
+ * The status an SDK puts in front of an error body: "402 You are out of…",
+ * "502 Pinned peer …", "503 {json}", or a streamed "… 400 data: {". Prose such
+ * as "429 requests remaining" is not read as a status.
+ */
+export declare function leadingHttpStatus(rawMessage: string): number | undefined;
+export declare function failureHttpStatus(signal: FailureSignal, rawMessage?: string): number | undefined;
+/**
+ * Collapse a failed request into the fixed taxonomy.
+ *
+ * - `out_of_credits` / `model_needs_paid`: a 402 or payment-required body;
+ *   `model_needs_paid` when the balance is zero and no free seller serves
+ *   the model, so funding is the only way to use it.
+ * - `no_seller_yet`: no seller and no peers were known at send (still
+ *   starting up); `no_seller_available` once peers were known.
+ * - `seller_dropped_*`: a stream or connection that ended without a status,
+ *   split by whether output had started.
+ */
+export declare function classifyFailureReason(signal: FailureSignal, rawMessage: string, context: FailureReasonContext): FailureReason;
+//# sourceMappingURL=failure.d.ts.map

package/dist/failure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure.d.ts","sourceRoot":"","sources":["../src/failure.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,aAAa,GACrB,MAAM,GACN,gBAAgB,GAChB,kBAAkB,GAClB,8BAA8B,GAC9B,2BAA2B,GAC3B,YAAY,GACZ,kBAAkB,GAClB,cAAc,GACd,qBAAqB,GACrB,eAAe,GACf,oBAAoB,GACpB,SAAS,GACT,aAAa,GACb,SAAS,CAAC;AAEd,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,MAAM,CAe9C,CAAC;AAEH,8EAA8E;AAC9E,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,0EAA0E;IAC1E,gBAAgB,EAAE,OAAO,CAAC;IAC1B,mEAAmE;IACnE,qBAAqB,EAAE,OAAO,CAAC;IAC/B,yDAAyD;IACzD,gBAAgB,EAAE,MAAM,CAAC;IACzB,6CAA6C;IAC7C,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AASF;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAMxE;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,aAAa,EAAE,UAAU,SAAK,GAAG,MAAM,GAAG,SAAS,CAE5F;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,aAAa,EACrB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,oBAAoB,GAC5B,aAAa,CAyBf"}

package/dist/failure.js

@@ -0,0 +1,87 @@
+/**
+ * Fixed `failure_reason` taxonomy for a model request, shared by the desktop
+ * chat (what the user saw) and the buyer proxy (what the network did). Raw
+ * error text is read here and discarded; only the enum leaves the device.
+ */
+export const FAILURE_REASONS = new Set([
+    'none',
+    'out_of_credits',
+    'model_needs_paid',
+    'seller_dropped_before_output',
+    'seller_dropped_mid_answer',
+    'seller_5xx',
+    'request_rejected',
+    'rate_limited',
+    'no_seller_available',
+    'no_seller_yet',
+    'seller_unreachable',
+    'timeout',
+    'local_error',
+    'unknown',
+]);
+const BUYER_SIDE_FAULT = /antseed_buyer_fault|buyer_request_failed|buyer_payments_inactive|payments_inactive|payment_negotiation_failed/i;
+const PAYMENT_SIGNAL = /payment_required|insufficient_deposits|out of antseed credits/i;
+const NO_SELLER_SIGNAL = /model_not_found|no policy-allowed peer|not served by this peer|model .* not (?:served|available)|no verified peer currently serves|no sellers available/i;
+const NO_PEERS_SIGNAL = /no peers discovered|no sellers available on the network/i;
+const UNREACHABLE_SIGNAL = /\bis not reachable\b|p2p request failed|connection to \S+ failed|\bpeer unreachable\b|ehostunreach|econnrefused/i;
+const TIMEOUT_SIGNAL = /\btimed out\b|\btimeout\b|no answer within/i;
+/**
+ * The status an SDK puts in front of an error body: "402 You are out of…",
+ * "502 Pinned peer …", "503 {json}", or a streamed "… 400 data: {". Prose such
+ * as "429 requests remaining" is not read as a status.
+ */
+export function leadingHttpStatus(rawMessage) {
+    const match = /(?:^|:\s)([45]\d{2})\s+data:\s*\{/i.exec(rawMessage)
+        ?? /^\s*([45]\d{2})\s+(?=[{A-Z])/.exec(rawMessage);
+    if (!match)
+        return undefined;
+    const statusCode = Number(match[1]);
+    return Number.isFinite(statusCode) ? statusCode : undefined;
+}
+export function failureHttpStatus(signal, rawMessage = '') {
+    return signal.statusCode ?? leadingHttpStatus(rawMessage);
+}
+/**
+ * Collapse a failed request into the fixed taxonomy.
+ *
+ * - `out_of_credits` / `model_needs_paid`: a 402 or payment-required body;
+ *   `model_needs_paid` when the balance is zero and no free seller serves
+ *   the model, so funding is the only way to use it.
+ * - `no_seller_yet`: no seller and no peers were known at send (still
+ *   starting up); `no_seller_available` once peers were known.
+ * - `seller_dropped_*`: a stream or connection that ended without a status,
+ *   split by whether output had started.
+ */
+export function classifyFailureReason(signal, rawMessage, context) {
+    if (signal.kind === 'aborted')
+        return 'none';
+    const statusCode = failureHttpStatus(signal, rawMessage);
+    if (signal.kind === 'payment_required' || statusCode === 402 || PAYMENT_SIGNAL.test(rawMessage)) {
+        return context.buyerBalanceZero === true && context.freeSellersKnown === 0
+            ? 'model_needs_paid'
+            : 'out_of_credits';
+    }
+    if (BUYER_SIDE_FAULT.test(rawMessage))
+        return 'local_error';
+    if (NO_SELLER_SIGNAL.test(rawMessage) || NO_PEERS_SIGNAL.test(rawMessage)) {
+        return context.peersDiscoveredAtSend && !NO_PEERS_SIGNAL.test(rawMessage)
+            ? 'no_seller_available'
+            : 'no_seller_yet';
+    }
+    if (signal.kind === 'timeout' || statusCode === 408 || statusCode === 504 || TIMEOUT_SIGNAL.test(rawMessage)) {
+        return 'timeout';
+    }
+    if (statusCode === 429)
+        return 'rate_limited';
+    if (UNREACHABLE_SIGNAL.test(rawMessage))
+        return 'seller_unreachable';
+    if (typeof statusCode === 'number' && statusCode >= 500 && statusCode < 600)
+        return 'seller_5xx';
+    if (typeof statusCode === 'number' && statusCode >= 400 && statusCode < 500)
+        return 'request_rejected';
+    if (signal.kind === 'network_error' || signal.kind === 'stream_error' || signal.kind === 'unknown') {
+        return context.hadPartialOutput ? 'seller_dropped_mid_answer' : 'seller_dropped_before_output';
+    }
+    return 'unknown';
+}
+//# sourceMappingURL=failure.js.map

package/dist/failure.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from './buckets.js';
+export * from './failure.js';
+export * from './sanitize.js';
+export * from './consent.js';
+export * from './posthog.js';
+export * from './client.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export * from './buckets.js';
+export * from './failure.js';
+export * from './sanitize.js';
+export * from './consent.js';
+export * from './posthog.js';
+export * from './client.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,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC"}

package/dist/posthog.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Bounded PostHog transport. Captures queue in memory and leave in batches
+ * (`/batch/`), with a short timeout and no retries. Every failure is
+ * swallowed: telemetry never affects a request, startup or shutdown.
+ */
+export declare const POSTHOG_CAPTURE_TIMEOUT_MS = 4000;
+export type PostHogEvent = {
+    event: string;
+    distinct_id: string;
+    timestamp: string;
+    properties: Record<string, unknown>;
+};
+export type PostHogSender = (events: PostHogEvent[]) => Promise<void>;
+export declare function createPostHogSender(options: {
+    host: string;
+    projectApiKey: string;
+    timeoutMs?: number;
+}): PostHogSender;
+export type BatchQueueOptions = {
+    send: PostHogSender;
+    /** Oldest events are dropped beyond this. */
+    maxQueue?: number;
+    maxBatch?: number;
+    flushIntervalMs?: number;
+    /** Checked before each batch is sent; when false the rest of the queue is dropped unsent. */
+    isEnabled?: () => boolean;
+};
+export declare class BatchQueue {
+    private readonly options;
+    private readonly queue;
+    private timer;
+    private inFlight;
+    private readonly maxQueue;
+    private readonly maxBatch;
+    private readonly flushIntervalMs;
+    constructor(options: BatchQueueOptions);
+    get size(): number;
+    push(event: PostHogEvent): void;
+    /** Sends everything queued. Safe to call concurrently; never rejects. */
+    flush(): Promise<void>;
+    /** Flushes, waiting at most `timeoutMs`. */
+    close(timeoutMs?: number): Promise<void>;
+}
+//# sourceMappingURL=posthog.d.ts.map

package/dist/posthog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"posthog.d.ts","sourceRoot":"","sources":["../src/posthog.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,0BAA0B,OAAQ,CAAC;AAEhD,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAEtE,wBAAgB,mBAAmB,CAAC,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,aAAa,CAgBvH;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,aAAa,CAAC;IACpB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,6FAA6F;IAC7F,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC;CAC3B,CAAC;AAEF,qBAAa,UAAU;IAQT,OAAO,CAAC,QAAQ,CAAC,OAAO;IAPpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsB;IAC5C,OAAO,CAAC,KAAK,CAA+B;IAC5C,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;gBAEZ,OAAO,EAAE,iBAAiB;IAMvD,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAY/B,yEAAyE;IACnE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB5B,4CAA4C;IACtC,KAAK,CAAC,SAAS,SAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAe5C"}