@zhixuan92/multi-model-agent 3.5.2 → 3.6.0

package/dist/telemetry/queue.js

@@ -0,0 +1,239 @@
+import { createHash } from 'node:crypto';
+import { writeFile, readFile, rename, stat, open } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import lockfile from 'proper-lockfile';
+const QUEUE_FILE = 'telemetry-queue.ndjson';
+const MAX_SIZE_BYTES = 10 * 1024 * 1024; // 10 MiB
+const MAX_RECORDS = 10_000;
+const CAP_TRUNCATE_COUNT = 1_000;
+const MAX_BATCH_READ = 500;
+const LOCK_OPTIONS = {
+    retries: { retries: 10, minTimeout: 50, maxTimeout: 150, factor: 1.3 },
+};
+let capWarned = false;
+function resetCapWarning() {
+    capWarned = false;
+}
+function deepSort(obj) {
+    if (Array.isArray(obj))
+        return obj.map(deepSort);
+    if (obj !== null && typeof obj === 'object') {
+        const sorted = {};
+        for (const key of Object.keys(obj).sort()) {
+            sorted[key] = deepSort(obj[key]);
+        }
+        return sorted;
+    }
+    return obj;
+}
+function canonicalSerialize(record) {
+    return JSON.stringify(deepSort(record)) + '\n';
+}
+function hashLine(line) {
+    return createHash('sha256').update(line).digest('hex');
+}
+async function ensureFile(p) {
+    if (!existsSync(p)) {
+        try {
+            await writeFile(p, '', { mode: 0o600, flag: 'wx' });
+        }
+        catch {
+            // race: another process created it between our check and write
+        }
+    }
+}
+export class Queue {
+    #dir;
+    #queuePath;
+    #approxCount = 0;
+    #appendsSinceCapCheck = 0;
+    constructor(dir) {
+        this.#dir = dir;
+        this.#queuePath = join(dir, QUEUE_FILE);
+    }
+    get queuePath() {
+        return this.#queuePath;
+    }
+    async append(record) {
+        // Ensure file exists before locking (proper-lockfile requires it)
+        await ensureFile(this.#queuePath);
+        let release = null;
+        try {
+            release = await lockfile.lock(this.#queuePath, LOCK_OPTIONS);
+        }
+        catch {
+            return; // lock timeout — silently skip
+        }
+        try {
+            await this.#enforceCap();
+            const line = canonicalSerialize(record);
+            const fd = await open(this.#queuePath, 'a', 0o600);
+            try {
+                await fd.write(line);
+            }
+            finally {
+                await fd.close();
+            }
+            // fsync skipped here — best-effort, adds significant per-append latency.
+            // OS buffers are flushed on process exit; crash recovery is handled by
+            // the corruption-rotation path on next readBatch.
+        }
+        finally {
+            if (release)
+                await release();
+        }
+    }
+    async readBatch(maxRecords = MAX_BATCH_READ) {
+        const records = [];
+        const meta = [];
+        // Don't create if missing; just return empty
+        if (!existsSync(this.#queuePath))
+            return { records, meta };
+        let release = null;
+        try {
+            release = await lockfile.lock(this.#queuePath, LOCK_OPTIONS);
+        }
+        catch {
+            return { records, meta };
+        }
+        try {
+            if (!existsSync(this.#queuePath))
+                return { records, meta };
+            const content = await readFile(this.#queuePath, 'utf8');
+            if (!content.trim())
+                return { records, meta };
+            const lines = content.split('\n');
+            let byteOffset = 0;
+            for (const line of lines) {
+                if (records.length >= maxRecords)
+                    break;
+                if (!line.trim()) {
+                    byteOffset += line.length + 1;
+                    continue;
+                }
+                const lineBytes = line + '\n';
+                try {
+                    const record = JSON.parse(line);
+                    records.push(record);
+                    meta.push({
+                        byteOffset,
+                        byteLength: Buffer.byteLength(lineBytes),
+                        sha256: hashLine(lineBytes),
+                    });
+                }
+                catch {
+                    // Corrupted line: rotate entire file and stop reading
+                    await this.#rotateCorrupted();
+                    return { records, meta: [] };
+                }
+                byteOffset += Buffer.byteLength(lineBytes);
+            }
+        }
+        finally {
+            if (release)
+                await release();
+        }
+        return { records, meta };
+    }
+    async truncate(expectedMeta) {
+        if (expectedMeta.length === 0)
+            return;
+        if (!existsSync(this.#queuePath))
+            return;
+        let release = null;
+        try {
+            release = await lockfile.lock(this.#queuePath, LOCK_OPTIONS);
+        }
+        catch {
+            return;
+        }
+        try {
+            if (!existsSync(this.#queuePath))
+                return;
+            const content = await readFile(this.#queuePath, 'utf8');
+            const lines = content.split('\n');
+            // Verify SHA-256 of the first expectedMeta.length records
+            let byteOffset = 0;
+            let verified = 0;
+            for (const line of lines) {
+                if (verified >= expectedMeta.length)
+                    break;
+                if (!line.trim()) {
+                    byteOffset += line.length + 1;
+                    continue;
+                }
+                const lineBytes = line + '\n';
+                const actualHash = hashLine(lineBytes);
+                if (actualHash !== expectedMeta[verified].sha256 ||
+                    byteOffset !== expectedMeta[verified].byteOffset) {
+                    return; // hash mismatch — don't truncate
+                }
+                byteOffset += Buffer.byteLength(lineBytes);
+                verified++;
+            }
+            if (verified === 0)
+                return;
+            // Atomically truncate: write remainder to temp file + rename
+            const remainder = content.slice(byteOffset);
+            const tmpPath = this.#queuePath + '.tmp.' + Date.now();
+            await writeFile(tmpPath, remainder, { mode: 0o600 });
+            await rename(tmpPath, this.#queuePath);
+        }
+        finally {
+            if (release)
+                await release();
+        }
+    }
+    async #enforceCap() {
+        this.#approxCount++;
+        this.#appendsSinceCapCheck++;
+        // Only check periodically to avoid reading the file on every append
+        if (this.#appendsSinceCapCheck < 100 && this.#approxCount < MAX_RECORDS)
+            return;
+        this.#appendsSinceCapCheck = 0;
+        // Quick size check first
+        const st = await stat(this.#queuePath);
+        if (st.size <= MAX_SIZE_BYTES && this.#approxCount <= MAX_RECORDS)
+            return;
+        // Full check: read the file to get exact record count
+        const content = await readFile(this.#queuePath, 'utf8');
+        const lines = content.split('\n').filter(l => l.trim());
+        const recordCount = lines.length;
+        if (st.size <= MAX_SIZE_BYTES && recordCount <= MAX_RECORDS) {
+            this.#approxCount = recordCount;
+            return;
+        }
+        if (!capWarned) {
+            console.warn('mma-telemetry: queue capped (10 MiB or 10,000 events), dropping oldest 1,000');
+            capWarned = true;
+        }
+        // Compute byte offset to drop exactly CAP_TRUNCATE_COUNT records
+        let dropped = 0;
+        let cutOffset = 0;
+        for (const line of content.split('\n')) {
+            if (dropped >= CAP_TRUNCATE_COUNT)
+                break;
+            if (!line.trim()) {
+                cutOffset += line.length + 1;
+                continue;
+            }
+            cutOffset += Buffer.byteLength(line + '\n');
+            dropped++;
+        }
+        const remainder = content.slice(cutOffset);
+        const tmpPath = this.#queuePath + '.cap.' + Date.now();
+        await writeFile(tmpPath, remainder, { mode: 0o600 });
+        await rename(tmpPath, this.#queuePath);
+        // Reset approximate counter after truncation
+        this.#approxCount = Math.max(0, recordCount - CAP_TRUNCATE_COUNT);
+    }
+    async #rotateCorrupted() {
+        const ts = Date.now();
+        const corruptedPath = this.#queuePath.replace('.ndjson', `.corrupted-${ts}.ndjson`);
+        await rename(this.#queuePath, corruptedPath);
+        await writeFile(this.#queuePath, '', { mode: 0o600 });
+    }
+}
+export { resetCapWarning };
+//# sourceMappingURL=queue.js.map

package/dist/telemetry/queue.js.map

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

package/dist/telemetry/recorder.d.ts

@@ -0,0 +1,18 @@
+import { type BuildContext, type SessionSnapshot } from '@zhixuan92/multi-model-agent-core/telemetry/event-builder';
+export interface Recorder {
+    readonly signal: AbortSignal;
+    recordTaskCompleted(ctx: BuildContext): void;
+    recordSessionStarted(snap: SessionSnapshot): void;
+    recordInstallChanged(from: string | null, to: string, trigger: string): void;
+    recordSkillInstalled(skillId: string, client: string): void;
+    revokeIdentity(options?: {
+        deleteInstallId?: boolean;
+    }): Promise<void>;
+}
+export declare function getRecorder(): Recorder;
+export declare function setRecorderForTest(r: Recorder): void;
+export declare function createRecorder(opts: {
+    homeDir: string;
+    mmagentVersion: string;
+}): Recorder;
+//# sourceMappingURL=recorder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"recorder.d.ts","sourceRoot":"","sources":["../../src/telemetry/recorder.ts"],"names":[],"mappings":"AAQA,OAAO,EAKL,KAAK,YAAY,EACjB,KAAK,eAAe,EACrB,MAAM,2DAA2D,CAAC;AAEnE,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,mBAAmB,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,CAAC;IAC7C,oBAAoB,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,CAAC;IAClD,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7E,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5D,cAAc,CAAC,OAAO,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxE;AAID,wBAAgB,WAAW,IAAI,QAAQ,CAKtC;AAED,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,QAAQ,GAAG,IAAI,CAEpD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GAAG,QAAQ,CAI1F"}

package/dist/telemetry/recorder.js

@@ -0,0 +1,123 @@
+import { existsSync, unlinkSync } from 'node:fs';
+import { join } from 'node:path';
+import { decide } from './consent.js';
+import { getOrCreateInstallId, deleteInstallId } from './install-id.js';
+import { buildInstallMeta } from './install-meta.js';
+import { Queue } from './queue.js';
+import { readGeneration, bumpGeneration } from './generation.js';
+import { SCHEMA_VERSION } from '@zhixuan92/multi-model-agent-core/telemetry/types';
+import { buildTaskCompletedEvent, buildSessionStartedEvent, buildInstallChangedEvent, buildSkillInstalledEvent, } from '@zhixuan92/multi-model-agent-core/telemetry/event-builder';
+let _recorder = null;
+export function getRecorder() {
+    if (!_recorder) {
+        throw new Error('Recorder not initialized — call createRecorder first');
+    }
+    return _recorder;
+}
+export function setRecorderForTest(r) {
+    _recorder = r;
+}
+export function createRecorder(opts) {
+    const recorder = _buildRecorder(opts);
+    _recorder = recorder;
+    return recorder;
+}
+function _buildRecorder(opts) {
+    const { homeDir, mmagentVersion } = opts;
+    const queue = new Queue(homeDir);
+    const controller = new AbortController();
+    let _installId = null;
+    let dropped = 0;
+    const resolveInstallId = () => {
+        if (!_installId) {
+            _installId = getOrCreateInstallId(homeDir);
+        }
+        return _installId;
+    };
+    const enqueue = (event) => {
+        try {
+            const id = resolveInstallId();
+            const meta = buildInstallMeta({ installId: id, mmagentVersion });
+            const gen = readGeneration(homeDir);
+            queue.append({
+                schemaVersion: SCHEMA_VERSION,
+                install: {
+                    installId: meta.installId,
+                    mmagentVersion: meta.mmagentVersion,
+                    os: meta.os,
+                    nodeMajor: meta.nodeMajor,
+                    language: meta.language,
+                    tzOffsetBucket: meta.tzOffsetBucket,
+                },
+                generation: gen,
+                event,
+            }).catch(() => {
+                dropped++;
+            });
+        }
+        catch {
+            dropped++;
+        }
+    };
+    return {
+        get signal() {
+            return controller.signal;
+        },
+        recordTaskCompleted(ctx) {
+            try {
+                const d = decide(homeDir);
+                if (!d.enabled)
+                    return;
+                enqueue(buildTaskCompletedEvent(ctx));
+            }
+            catch {
+                dropped++;
+            }
+        },
+        recordSessionStarted(snap) {
+            try {
+                const d = decide(homeDir);
+                if (!d.enabled)
+                    return;
+                enqueue(buildSessionStartedEvent(snap));
+            }
+            catch {
+                dropped++;
+            }
+        },
+        recordInstallChanged(from, to, trigger) {
+            try {
+                const d = decide(homeDir);
+                if (!d.enabled)
+                    return;
+                enqueue(buildInstallChangedEvent(from, to, trigger));
+            }
+            catch {
+                dropped++;
+            }
+        },
+        recordSkillInstalled(skillId, client) {
+            try {
+                const d = decide(homeDir);
+                if (!d.enabled)
+                    return;
+                enqueue(buildSkillInstalledEvent(skillId, client));
+            }
+            catch {
+                dropped++;
+            }
+        },
+        async revokeIdentity(options) {
+            await bumpGeneration(homeDir);
+            controller.abort();
+            const queuePath = join(homeDir, 'telemetry-queue.ndjson');
+            if (existsSync(queuePath))
+                unlinkSync(queuePath);
+            _installId = null;
+            if (options?.deleteInstallId) {
+                deleteInstallId(homeDir);
+            }
+        },
+    };
+}
+//# sourceMappingURL=recorder.js.map

package/dist/telemetry/recorder.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhixuan92/multi-model-agent",
-  "version": "3.5.2",
+  "version": "3.6.0",
   "type": "module",
   "license": "MIT",
   "description": "Standalone HTTP server for multi-model-agent. Routes tool-invocation work to Claude, Codex, or OpenAI-compatible sub-agents with async-polling REST dispatch and installable skills for Claude Code, Gemini CLI, Codex CLI, and Cursor.",
@@ -52,12 +52,14 @@
   },
   "dependencies": {
     "@asteasolutions/zod-to-openapi": "^8.5.0",
-    "@zhixuan92/multi-model-agent-core": "^3.5.2",
+    "@zhixuan92/multi-model-agent-core": "^3.6.0",
     "gray-matter": "^4.0.3",
     "minimist": "^1.2.8",
+    "proper-lockfile": "^4.1.2",
     "zod": "^4.0.0"
   },
   "devDependencies": {
-    "@types/minimist": "^1.2.5"
+    "@types/minimist": "^1.2.5",
+    "@types/proper-lockfile": "^4.1.4"
   }
 }