@zhixuan92/multi-model-agent 5.0.1 → 5.0.3

package/dist/telemetry/consent.js

@@ -0,0 +1,40 @@
+import { readFileSync, watch } from 'node:fs';
+import { join } from 'node:path';
+import { decideConsent } from '@zhixuan92/multi-model-agent-core/events/consent-rules';
+export function decide(homeDir) {
+    const env = process.env.MMAGENT_TELEMETRY;
+    const cfgPath = join(homeDir, 'config.json');
+    let config = undefined;
+    try {
+        const txt = readFileSync(cfgPath, 'utf8');
+        const obj = JSON.parse(txt);
+        if (obj && typeof obj === 'object' && obj.telemetry &&
+            typeof obj.telemetry === 'object' &&
+            typeof obj.telemetry.enabled === 'boolean') {
+            config = { enabled: obj.telemetry.enabled };
+        }
+        else if (obj && typeof obj === 'object' && typeof obj.enabled === 'boolean') {
+            config = { enabled: obj.enabled };
+        }
+    }
+    catch (e) {
+        if (e.code !== 'ENOENT') {
+            config = { kind: 'unreadable' };
+        }
+    }
+    return decideConsent({ env, config });
+}
+export function watchConfigForChanges(homeDir, onChange) {
+    const filename = 'config.json';
+    let timer = null;
+    const w = watch(homeDir, { persistent: false }, (_event, fname) => {
+        if (fname !== filename)
+            return;
+        if (timer)
+            clearTimeout(timer);
+        timer = setTimeout(() => onChange(decide(homeDir)), 500);
+    });
+    return () => { w.close(); if (timer)
+        clearTimeout(timer); };
+}
+//# sourceMappingURL=consent.js.map

package/dist/telemetry/consent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consent.js","sourceRoot":"","sources":["../../src/telemetry/consent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,aAAa,EAAwB,MAAM,wDAAwD,CAAC;AAE7G,MAAM,UAAU,MAAM,CAAC,OAAe;IACpC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;IAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;IAC7C,IAAI,MAAM,GAA8D,SAAS,CAAC;IAClF,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC1C,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAQ,CAAC;QACnC,IACE,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,SAAS;YAC/C,OAAO,GAAG,CAAC,SAAS,KAAK,QAAQ;YACjC,OAAO,GAAG,CAAC,SAAS,CAAC,OAAO,KAAK,SAAS,EAC1C,CAAC;YACD,MAAM,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;QAC9C,CAAC;aAAM,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAC9E,MAAM,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;QACpC,CAAC;IACH,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAK,CAA2B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACnD,MAAM,GAAG,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;QAClC,CAAC;IACH,CAAC;IACD,OAAO,aAAa,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,OAAe,EAAE,QAAsC;IAC3F,MAAM,QAAQ,GAAG,aAAa,CAAC;IAC/B,IAAI,KAAK,GAA0B,IAAI,CAAC;IACxC,MAAM,CAAC,GAAG,KAAK,CAAC,OAAO,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;QAChE,IAAI,KAAK,KAAK,QAAQ;YAAE,OAAO;QAC/B,IAAI,KAAK;YAAE,YAAY,CAAC,KAAK,CAAC,CAAC;QAC/B,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IACH,OAAO,GAAG,EAAE,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,KAAK;QAAE,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AAC9D,CAAC"}

package/dist/telemetry/flusher.d.ts

@@ -0,0 +1,19 @@
+import { Queue } from './queue.js';
+export interface FlusherOptions {
+    queue: Queue;
+    dir: string;
+    endpoint: string;
+}
+export declare class Flusher {
+    #private;
+    constructor(opts: FlusherOptions);
+    get controller(): AbortController;
+    get dropped(): number;
+    get backoffActive(): boolean;
+    start(): void;
+    stop(): void;
+    drain(): Promise<void>;
+    flush(): Promise<void>;
+    clearBackoff(): void;
+}
+//# sourceMappingURL=flusher.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"flusher.d.ts","sourceRoot":"","sources":["../../src/telemetry/flusher.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAMnC,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,KAAK,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;CAClB;AA2BD,qBAAa,OAAO;;gBAYN,IAAI,EAAE,cAAc;IAOhC,IAAI,UAAU,IAAI,eAAe,CAEhC;IAED,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,IAAI,aAAa,IAAI,OAAO,CAE3B;IAED,KAAK,IAAI,IAAI;IAeb,IAAI,IAAI,IAAI;IAaN,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAYtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAyM5B,YAAY,IAAI,IAAI;CAOrB"}

package/dist/telemetry/flusher.js

@@ -0,0 +1,277 @@
+import { gzipSync } from 'node:zlib';
+import { readGeneration } from './generation.js';
+import { getOrCreateIdentity, sign } from './identity.js';
+import { SCHEMA_VERSION } from '@zhixuan92/multi-model-agent-core/events/wire-schema';
+const MAX_BATCH = 500;
+const INTERVAL_MS = 5 * 60 * 1000; // 5 minutes
+const BOOT_DELAY_MS = 5_000; // 5 seconds
+const QUEUE_SIZE_TRIGGER = 100;
+const DRAIN_BUDGET_MS = 2_000; // 2 seconds
+const MAX_BACKOFF_MS = 60 * 60 * 1000; // 1 hour cap
+const NO_RETRY_AFTER_DEFAULT = 60 * 60 * 1000; // 1 hour
+const INITIAL_BACKOFF_MS = 5 * 60 * 1000; // 5 minutes
+function groupKey(record) {
+    return `${record.schemaVersion}|${record.installId}|${record.mmagentVersion}|${record.os}|${record.nodeMajor}|${record.generation}`;
+}
+export class Flusher {
+    #queue;
+    #dir;
+    #endpoint;
+    #controller;
+    #timer = null;
+    #bootTimer = null;
+    #backoffTimer = null;
+    #backoffMs = 0;
+    #inFlight = false;
+    #dropped = 0;
+    constructor(opts) {
+        this.#queue = opts.queue;
+        this.#dir = opts.dir;
+        this.#endpoint = opts.endpoint;
+        this.#controller = new AbortController();
+    }
+    get controller() {
+        return this.#controller;
+    }
+    get dropped() {
+        return this.#dropped;
+    }
+    get backoffActive() {
+        return this.#backoffTimer !== null;
+    }
+    start() {
+        this.#timer = setInterval(() => {
+            if (!this.#inFlight && !this.backoffActive) {
+                this.flush().catch(() => { });
+            }
+        }, INTERVAL_MS);
+        this.#timer.unref();
+        this.#bootTimer = setTimeout(() => {
+            this.#bootTimer = null;
+            this.flush().catch(() => { });
+        }, BOOT_DELAY_MS);
+        this.#bootTimer.unref();
+    }
+    stop() {
+        if (this.#timer) {
+            clearInterval(this.#timer);
+            this.#timer = null;
+        }
+        if (this.#bootTimer) {
+            clearTimeout(this.#bootTimer);
+            this.#bootTimer = null;
+        }
+        this.clearBackoff();
+        this.#controller.abort();
+    }
+    async drain() {
+        this.stop();
+        const deadline = Date.now() + DRAIN_BUDGET_MS;
+        const drainSignal = AbortSignal.timeout(DRAIN_BUDGET_MS);
+        try {
+            await this.#doFlush(drainSignal, deadline);
+        }
+        catch {
+            // drain is best-effort
+        }
+    }
+    async flush() {
+        if (this.#inFlight)
+            return;
+        if (this.backoffActive)
+            return;
+        return this.#doFlush(this.#controller.signal);
+    }
+    async #doFlush(signal, deadline) {
+        if (signal.aborted)
+            return;
+        this.#inFlight = true;
+        try {
+            // Step 1: read up to 500 records + capture generation snapshot
+            let batch = await this.#queue.readBatch(MAX_BATCH);
+            if (batch.records.length === 0) {
+                this.clearBackoff();
+                return;
+            }
+            // Single identity snapshot per flush — threaded into both head-truncation and uploadBatch.
+            const identity = getOrCreateIdentity(this.#dir);
+            // V4-only: drop EVERY record that can't be authenticated, not just a
+            // contiguous head-prefix. Records older than SCHEMA_VERSION or whose
+            // installId doesn't match the current identity are permanently
+            // un-authenticatable; retrying the same signed payload always fails.
+            // Previously we only dropped a contiguous head — a sandwiched older
+            // record (e.g. queued during a roll-back/forward, or installId churn)
+            // would either propagate into an upload or split the upload into
+            // versioned groups. Now: full-batch filter, then re-read to refresh
+            // meta byteOffsets after the file rewrite.
+            const dropHashes = new Set();
+            for (let i = 0; i < batch.records.length; i++) {
+                const r = batch.records[i];
+                if (r.schemaVersion < SCHEMA_VERSION || r.installId !== identity.installId) {
+                    dropHashes.add(batch.meta[i].sha256);
+                }
+            }
+            if (dropHashes.size > 0) {
+                const removed = await this.#queue.removeRecords(dropHashes);
+                this.#dropped += removed;
+                batch = await this.#queue.readBatch(MAX_BATCH);
+                if (batch.records.length === 0) {
+                    this.clearBackoff();
+                    return;
+                }
+            }
+            const genSnapshot = readGeneration(this.#dir);
+            // Step 4: Group consecutive records by (schemaVersion, install, generation)
+            const groups = [];
+            let currentKey = '';
+            let currentRecords = [];
+            let currentMeta = [];
+            for (let i = 0; i < batch.records.length; i++) {
+                const key = groupKey(batch.records[i]);
+                if (currentKey && key !== currentKey) {
+                    groups.push({ records: currentRecords, meta: currentMeta });
+                    currentRecords = [];
+                    currentMeta = [];
+                }
+                currentKey = key;
+                currentRecords.push(batch.records[i]);
+                currentMeta.push(batch.meta[i]);
+            }
+            if (currentRecords.length > 0) {
+                groups.push({ records: currentRecords, meta: currentMeta });
+            }
+            // Steps 5-6: Process each batch in order
+            let acknowledgedCount = 0;
+            let shouldBackoff = false;
+            let backoffDuration = 0;
+            for (const group of groups) {
+                if (deadline && Date.now() > deadline)
+                    break;
+                // Re-check generation; if changed since read, abort
+                const currentGen = readGeneration(this.#dir);
+                if (currentGen !== genSnapshot)
+                    break;
+                if (signal.aborted)
+                    break;
+                const result = await this.#uploadBatch(group, signal, identity);
+                if (result.status === '204' || result.status === '400' || result.status === '413') {
+                    acknowledgedCount += group.records.length;
+                    if (result.status === '400' || result.status === '413') {
+                        this.#dropped += group.records.length;
+                    }
+                }
+                else {
+                    shouldBackoff = true;
+                    if (result.status === '429') {
+                        backoffDuration = result.retryAfterSeconds !== null
+                            ? result.retryAfterSeconds * 1000
+                            : NO_RETRY_AFTER_DEFAULT;
+                    }
+                    else {
+                        backoffDuration = this.#nextBackoff();
+                    }
+                    break; // stop iterating on non-success
+                }
+            }
+            // Steps 7-9: truncate acknowledged prefix
+            if (acknowledgedCount > 0) {
+                await this.#queue.truncate(batch.meta.slice(0, acknowledgedCount));
+            }
+            // Apply or clear backoff
+            if (shouldBackoff) {
+                this.#scheduleBackoff(backoffDuration);
+            }
+            else {
+                // Reset backoff on successful drain (all batches processed)
+                this.clearBackoff();
+            }
+        }
+        finally {
+            this.#inFlight = false;
+        }
+    }
+    async #uploadBatch(group, signal, identity) {
+        const first = group.records[0];
+        const events = group.records.flatMap(r => r.events);
+        const jsonBody = JSON.stringify({
+            schemaVersion: first.schemaVersion,
+            installId: first.installId,
+            mmagentVersion: first.mmagentVersion,
+            os: first.os,
+            nodeMajor: first.nodeMajor,
+            events,
+        });
+        const signature = sign(identity.privateKeyPkcs8, jsonBody);
+        const body = gzipSync(Buffer.from(jsonBody, 'utf8'));
+        try {
+            const response = await fetch(this.#endpoint, {
+                method: 'POST',
+                headers: {
+                    'Content-Encoding': 'gzip',
+                    'Content-Type': 'application/json',
+                    'X-Mmagent-Install-Id': identity.installId,
+                    'X-Mmagent-Signature': signature,
+                    'X-Mmagent-Pubkey': identity.publicKeyRaw,
+                },
+                body,
+                signal,
+            });
+            const status = response.status;
+            if (status === 204)
+                return { status: '204', retryAfterSeconds: null };
+            if (status === 400 || status === 413) {
+                let body = '';
+                try {
+                    body = (await response.text()).slice(0, 200);
+                }
+                catch { /* ignore */ }
+                process.stderr.write(`[mmagent] telemetry upload dropped: status=${status} records=${group.records.length} body=${body}\n`);
+                return { status: status === 400 ? '400' : '413', retryAfterSeconds: null };
+            }
+            if (status === 429) {
+                const retryAfter = response.headers.get('Retry-After');
+                const seconds = retryAfter ? parseInt(retryAfter, 10) : null;
+                return { status: '429', retryAfterSeconds: Number.isFinite(seconds) ? seconds : null };
+            }
+            if (status >= 500)
+                return { status: '5xx', retryAfterSeconds: null };
+            // Unexpected status: treat as 5xx
+            return { status: '5xx', retryAfterSeconds: null };
+        }
+        catch (err) {
+            if (err instanceof DOMException && err.name === 'AbortError') {
+                throw err;
+            }
+            return { status: 'network', retryAfterSeconds: null };
+        }
+    }
+    #nextBackoff() {
+        if (this.#backoffMs === 0) {
+            this.#backoffMs = INITIAL_BACKOFF_MS;
+        }
+        else {
+            this.#backoffMs = Math.min(this.#backoffMs * 2, MAX_BACKOFF_MS);
+        }
+        return this.#backoffMs;
+    }
+    #scheduleBackoff(ms) {
+        if (this.#backoffTimer) {
+            clearTimeout(this.#backoffTimer);
+            this.#backoffTimer = null;
+        }
+        this.#backoffTimer = setTimeout(() => {
+            this.#backoffTimer = null;
+            this.flush().catch(() => { });
+        }, ms);
+        if (this.#backoffTimer.unref)
+            this.#backoffTimer.unref();
+    }
+    clearBackoff() {
+        if (this.#backoffTimer) {
+            clearTimeout(this.#backoffTimer);
+            this.#backoffTimer = null;
+        }
+        this.#backoffMs = 0;
+    }
+}
+//# sourceMappingURL=flusher.js.map

package/dist/telemetry/flusher.js.map

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

package/dist/telemetry/generation.d.ts

@@ -0,0 +1,9 @@
+export declare function readGeneration(dir: string): number;
+/**
+ * Atomic increment. Uses proper-lockfile (already a dep for queue.ts) so two
+ * simultaneous `mmagent telemetry disable` invocations cannot both read N and
+ * both write N+1 (which would silently lose a generation bump and leave a
+ * revoked identity's events accepted by the backend).
+ */
+export declare function bumpGeneration(dir: string): Promise<number>;
+//# sourceMappingURL=generation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generation.d.ts","sourceRoot":"","sources":["../../src/telemetry/generation.ts"],"names":[],"mappings":"AAMA,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAKlD;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAYjE"}

package/dist/telemetry/generation.js

@@ -0,0 +1,33 @@
+import { readFileSync, writeFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import lockfile from 'proper-lockfile';
+const FILE = 'telemetry-generation';
+export function readGeneration(dir) {
+    const p = join(dir, FILE);
+    if (!existsSync(p))
+        return 0;
+    const n = Number.parseInt(readFileSync(p, 'utf8').trim(), 10);
+    return Number.isFinite(n) && n >= 0 ? n : 0;
+}
+/**
+ * Atomic increment. Uses proper-lockfile (already a dep for queue.ts) so two
+ * simultaneous `mmagent telemetry disable` invocations cannot both read N and
+ * both write N+1 (which would silently lose a generation bump and leave a
+ * revoked identity's events accepted by the backend).
+ */
+export async function bumpGeneration(dir) {
+    const p = join(dir, FILE);
+    if (!existsSync(p))
+        writeFileSync(p, '0', { mode: 0o600 });
+    const release = await lockfile.lock(p, { retries: { retries: 15, minTimeout: 50, maxTimeout: 500 } });
+    try {
+        const current = readGeneration(dir);
+        const next = current + 1;
+        writeFileSync(p, String(next), { mode: 0o600 });
+        return next;
+    }
+    finally {
+        await release();
+    }
+}
+//# sourceMappingURL=generation.js.map

package/dist/telemetry/generation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generation.js","sourceRoot":"","sources":["../../src/telemetry/generation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,QAAQ,MAAM,iBAAiB,CAAC;AAEvC,MAAM,IAAI,GAAG,sBAAsB,CAAC;AAEpC,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC1B,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QAAE,OAAO,CAAC,CAAC;IAC7B,MAAM,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IAC9D,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,GAAW;IAC9C,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC1B,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QAAE,aAAa,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3D,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;IACtG,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;QACpC,MAAM,IAAI,GAAG,OAAO,GAAG,CAAC,CAAC;QACzB,aAAa,CAAC,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAChD,OAAO,IAAI,CAAC;IACd,CAAC;YAAS,CAAC;QACT,MAAM,OAAO,EAAE,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/telemetry/identity.d.ts

@@ -0,0 +1,9 @@
+export interface Identity {
+    installId: string;
+    generatedAt: string;
+    privateKeyPkcs8: string;
+    publicKeyRaw: string;
+}
+export declare function getOrCreateIdentity(homeDir: string): Identity;
+export declare function sign(privateKeyPkcs8Base64: string, jsonBody: string): string;
+//# sourceMappingURL=identity.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/telemetry/identity.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,CAqB7D;AAED,wBAAgB,IAAI,CAAC,qBAAqB,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAO5E"}

package/dist/telemetry/identity.js

@@ -0,0 +1,35 @@
+import { createPrivateKey, generateKeyPairSync, randomUUID, sign as edSign, } from 'node:crypto';
+import { readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+export function getOrCreateIdentity(homeDir) {
+    const path = join(homeDir, 'identity.json');
+    try {
+        const id = JSON.parse(readFileSync(path, 'utf8'));
+        const ageMs = Date.now() - new Date(id.generatedAt).getTime();
+        if (ageMs < 365 * 24 * 3600 * 1000) {
+            return id;
+        }
+        // Older than 365 days → falls through to regeneration block below.
+    }
+    catch {
+        // missing or corrupt → regenerate
+    }
+    const { privateKey, publicKey } = generateKeyPairSync('ed25519');
+    const id = {
+        installId: randomUUID(),
+        generatedAt: new Date().toISOString(),
+        privateKeyPkcs8: privateKey.export({ type: 'pkcs8', format: 'der' }).toString('base64'),
+        publicKeyRaw: publicKey.export({ type: 'spki', format: 'der' }).toString('base64'),
+    };
+    writeFileSync(path, JSON.stringify(id), { mode: 0o600 });
+    return id;
+}
+export function sign(privateKeyPkcs8Base64, jsonBody) {
+    const key = createPrivateKey({
+        key: Buffer.from(privateKeyPkcs8Base64, 'base64'),
+        format: 'der',
+        type: 'pkcs8',
+    });
+    return edSign(null, Buffer.from(jsonBody, 'utf8'), key).toString('base64');
+}
+//# sourceMappingURL=identity.js.map

package/dist/telemetry/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../src/telemetry/identity.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,UAAU,EACV,IAAI,IAAI,MAAM,GACf,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACtD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AASjC,MAAM,UAAU,mBAAmB,CAAC,OAAe;IACjD,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;IAC5C,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAa,CAAC;QAC9D,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,OAAO,EAAE,CAAC;QAC9D,IAAI,KAAK,GAAG,GAAG,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,EAAE,CAAC;YACnC,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,mEAAmE;IACrE,CAAC;IAAC,MAAM,CAAC;QACP,kCAAkC;IACpC,CAAC;IACD,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,mBAAmB,CAAC,SAAS,CAAC,CAAC;IACjE,MAAM,EAAE,GAAa;QACnB,SAAS,EAAE,UAAU,EAAE;QACvB,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACrC,eAAe,EAAE,UAAU,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;QACvF,YAAY,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;KACnF,CAAC;IACF,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACzD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,qBAA6B,EAAE,QAAgB;IAClE,MAAM,GAAG,GAAG,gBAAgB,CAAC;QAC3B,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,qBAAqB,EAAE,QAAQ,CAAC;QACjD,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,OAAO;KACd,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AAC7E,CAAC"}

package/dist/telemetry/install-id.d.ts

@@ -0,0 +1,13 @@
+export declare function hasInstallId(dir: string): boolean;
+/**
+ * Atomic create-or-read.
+ * - `openSync(path, 'wx')` is exclusive — succeeds only if the file does not exist.
+ * - Two concurrent processes racing here: one wins the create, the other gets EEXIST
+ *   and falls through to the read path. No `proper-lockfile` needed for this one.
+ * - We `fsyncSync` the WRITE descriptor (not a re-opened read fd) so the kernel
+ *   actually flushes the bytes; this is the data-durability guarantee that survives
+ *   power loss.
+ */
+export declare function getOrCreateInstallId(dir: string): string;
+export declare function deleteInstallId(dir: string): void;
+//# sourceMappingURL=install-id.d.ts.map

package/dist/telemetry/install-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-id.d.ts","sourceRoot":"","sources":["../../src/telemetry/install-id.ts"],"names":[],"mappings":"AAMA,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAwBxD;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAGjD"}

package/dist/telemetry/install-id.js

@@ -0,0 +1,49 @@
+import { readFileSync, openSync, closeSync, writeSync, fsyncSync, existsSync, unlinkSync } from 'node:fs';
+import { join } from 'node:path';
+import { randomUUID } from 'node:crypto';
+const FILE = 'install-id';
+export function hasInstallId(dir) {
+    return existsSync(join(dir, FILE));
+}
+/**
+ * Atomic create-or-read.
+ * - `openSync(path, 'wx')` is exclusive — succeeds only if the file does not exist.
+ * - Two concurrent processes racing here: one wins the create, the other gets EEXIST
+ *   and falls through to the read path. No `proper-lockfile` needed for this one.
+ * - We `fsyncSync` the WRITE descriptor (not a re-opened read fd) so the kernel
+ *   actually flushes the bytes; this is the data-durability guarantee that survives
+ *   power loss.
+ */
+export function getOrCreateInstallId(dir) {
+    const path = join(dir, FILE);
+    // Fast path: file already exists.
+    if (existsSync(path)) {
+        return readFileSync(path, 'utf8').trim();
+    }
+    // Race-safe create.
+    const id = randomUUID();
+    let fd;
+    try {
+        fd = openSync(path, 'wx', 0o600); // EEXIST if a concurrent process beat us
+    }
+    catch (e) {
+        if (e.code === 'EEXIST') {
+            return readFileSync(path, 'utf8').trim();
+        }
+        throw e;
+    }
+    try {
+        writeSync(fd, id);
+        fsyncSync(fd); // flush data to durable storage on the WRITE fd
+    }
+    finally {
+        closeSync(fd);
+    }
+    return id;
+}
+export function deleteInstallId(dir) {
+    const path = join(dir, FILE);
+    if (existsSync(path))
+        unlinkSync(path);
+}
+//# sourceMappingURL=install-id.js.map

package/dist/telemetry/install-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-id.js","sourceRoot":"","sources":["../../src/telemetry/install-id.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1G,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,IAAI,GAAG,YAAY,CAAC;AAE1B,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,OAAO,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;AACrC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAW;IAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC7B,kCAAkC;IAClC,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACrB,OAAO,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3C,CAAC;IACD,oBAAoB;IACpB,MAAM,EAAE,GAAG,UAAU,EAAE,CAAC;IACxB,IAAI,EAAU,CAAC;IACf,IAAI,CAAC;QACH,EAAE,GAAG,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAE,yCAAyC;IAC9E,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAK,CAA2B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACnD,OAAO,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QAC3C,CAAC;QACD,MAAM,CAAC,CAAC;IACV,CAAC;IACD,IAAI,CAAC;QACH,SAAS,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QAClB,SAAS,CAAC,EAAE,CAAC,CAAC,CAAE,gDAAgD;IAClE,CAAC;YAAS,CAAC;QACT,SAAS,CAAC,EAAE,CAAC,CAAC;IAChB,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC7B,IAAI,UAAU,CAAC,IAAI,CAAC;QAAE,UAAU,CAAC,IAAI,CAAC,CAAC;AACzC,CAAC"}

package/dist/telemetry/install-meta.d.ts

@@ -0,0 +1,10 @@
+export declare function buildInstallMeta(args: {
+    installId: string;
+    mmagentVersion: string;
+}): {
+    installId: string;
+    mmagentVersion: string;
+    os: "darwin" | "linux" | "win32" | "other";
+    nodeMajor: number;
+};
+//# sourceMappingURL=install-meta.d.ts.map

package/dist/telemetry/install-meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-meta.d.ts","sourceRoot":"","sources":["../../src/telemetry/install-meta.ts"],"names":[],"mappings":"AAMA,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE;;;;;EAOnF"}

package/dist/telemetry/install-meta.js

@@ -0,0 +1,15 @@
+function bucketOs() {
+    const p = process.platform;
+    if (p === 'darwin' || p === 'linux' || p === 'win32')
+        return p;
+    return 'other';
+}
+export function buildInstallMeta(args) {
+    return {
+        installId: args.installId,
+        mmagentVersion: args.mmagentVersion,
+        os: bucketOs(),
+        nodeMajor: Number(process.versions.node.split('.')[0]),
+    };
+}
+//# sourceMappingURL=install-meta.js.map

package/dist/telemetry/install-meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-meta.js","sourceRoot":"","sources":["../../src/telemetry/install-meta.ts"],"names":[],"mappings":"AAAA,SAAS,QAAQ;IACf,MAAM,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC;IAC3B,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,OAAO,IAAI,CAAC,KAAK,OAAO;QAAE,OAAO,CAAC,CAAC;IAC/D,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAmD;IAClF,OAAO;QACL,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,EAAE,EAAE,QAAQ,EAAE;QACd,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;KACvD,CAAC;AACJ,CAAC"}

package/dist/telemetry/queue.d.ts

@@ -0,0 +1,35 @@
+declare function resetCapWarning(): void;
+export interface QueueRecord {
+    schemaVersion: number;
+    installId: string;
+    mmagentVersion: string;
+    os: 'darwin' | 'linux' | 'win32' | 'other';
+    nodeMajor: number;
+    generation: number;
+    events: Record<string, unknown>[];
+}
+export interface RecordMeta {
+    byteOffset: number;
+    byteLength: number;
+    sha256: string;
+}
+export interface ReadBatchResult {
+    records: QueueRecord[];
+    meta: RecordMeta[];
+}
+export declare class Queue {
+    #private;
+    constructor(dir: string);
+    get queuePath(): string;
+    append(record: QueueRecord): Promise<void>;
+    readBatch(maxRecords?: number): Promise<ReadBatchResult>;
+    /**
+     * Remove records whose SHA-256 hashes are in the provided set.
+     * Rebuilds the queue file from scratch — safe for arbitrary (non-contiguous)
+     * removal. Returns the number of records actually removed.
+     */
+    removeRecords(hashes: Set<string>): Promise<number>;
+    truncate(expectedMeta: RecordMeta[]): Promise<void>;
+}
+export { resetCapWarning };
+//# sourceMappingURL=queue.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../src/telemetry/queue.ts"],"names":[],"mappings":"AAkBA,iBAAS,eAAe,IAAI,IAAI,CAE/B;AAED,MAAM,WAAW,WAAW;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,EAAE,EAAE,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,IAAI,EAAE,UAAU,EAAE,CAAC;CACpB;AAgCD,qBAAa,KAAK;;gBAMJ,GAAG,EAAE,MAAM;IAKvB,IAAI,SAAS,IAAI,MAAM,CAEtB;IAEK,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IA8B1C,SAAS,CAAC,UAAU,SAAiB,GAAG,OAAO,CAAC,eAAe,CAAC;IAqDtE;;;;OAIG;IACG,aAAa,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAyCnD,QAAQ,CAAC,YAAY,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CA+G1D;AAED,OAAO,EAAE,eAAe,EAAE,CAAC"}