im-hub-pro 0.2.29

package/dist/core/job-board.js

@@ -0,0 +1,379 @@
+// Job Board — persistent async job queue backed by SQLite
+//
+// Jobs survive restarts. Each job executes an agent invocation and stores the result.
+// Supports: create, list, get, cancel.
+//
+// Ownership (H5/M6/H7, code-review-2026-05-06):
+//   - Each row carries `creator_id` (the IM userId that originated the job)
+//     and `workspace_id`. Commands that the user runs through IM
+//     (`/job list|check|cancel|run`) MUST pass the caller's userId via
+//     opts.creatorId so users can't peek at or stomp on each others' jobs.
+//     Internal callers (REST `/api/jobs`, ACP server, scheduler) pass no
+//     filter and see every row — that's intentional, those entry-points
+//     are guarded by the web / API token.
+//   - Legacy rows (created before the migration) have creator_id = ''.
+//     They're treated as "ownerless / system" and visible to every owner-
+//     scoped query (so an upgrade doesn't appear to vanish the user's
+//     prior history).
+//   - pruneOldJobs() walks completed/failed/cancelled rows older than
+//     `IM_HUB_JOB_RETENTION_DAYS` (default 30) and deletes them; runs every
+//     6h via setInterval, mirroring audit-log.
+import { homedir } from 'os';
+import { join } from 'path';
+import { logger as rootLogger } from './logger.js';
+import { eventBus } from './event-bus.js';
+import { createSqliteHelper } from './sqlite-helper.js';
+const BOARD_DB = join(homedir(), '.im-hub', 'jobs.db');
+/** Hard cap on a single job's accumulated result. A misbehaving agent (or a
+ * runaway tool that dumps a giant file) could otherwise keep filling the
+ * Buffer in {@link runJob} until the host OOMs and rage-stuff the SQLite TEXT
+ * column with the same payload. We cap at 1 MiB by default; chunks that would
+ * push past the cap are dropped and a truncation footer is appended. Override
+ * via env IMHUB_JOB_RESULT_MAX_BYTES. */
+function resolveMaxResultBytes() {
+    const raw = process.env.IMHUB_JOB_RESULT_MAX_BYTES;
+    if (raw) {
+        const n = parseInt(raw, 10);
+        if (Number.isFinite(n) && n > 0)
+            return n;
+    }
+    return 1 * 1024 * 1024;
+}
+/** Hard cap on concurrent runJob() invocations. Spawning more than this
+ * would let a few /job run X requests OOM the host (each agent process
+ * carries hundreds of MB). Override via env IM_HUB_MAX_CONCURRENT_JOBS. */
+function resolveMaxConcurrent() {
+    const raw = process.env.IM_HUB_MAX_CONCURRENT_JOBS;
+    if (raw) {
+        const n = parseInt(raw, 10);
+        if (Number.isFinite(n) && n > 0)
+            return n;
+    }
+    return 3;
+}
+// Running job controllers (for cancellation)
+const runningControllers = new Map();
+// Wait queue for jobs that arrived while at capacity. Each entry is the
+// resolver of a Promise the caller is awaiting on.
+const waitQueue = [];
+let activeJobs = 0;
+/**
+ * Reset jobs that were 'running' when the previous im-hub process died.
+ * Without this, those rows stay marked 'running' forever and every
+ * /job list shows ghosts.
+ */
+function reapStaleRunning(d) {
+    try {
+        const stmt = d.prepare("UPDATE jobs SET status='failed', error='im-hub restarted while running', completed_at=datetime('now') WHERE status='running'");
+        const info = stmt.run();
+        if (info.changes > 0) {
+            rootLogger.warn({ event: 'job-board.reap', stale: info.changes }, `Marked ${info.changes} stale running job(s) as failed`);
+        }
+    }
+    catch {
+        // best-effort; missing table is fine on first start
+    }
+}
+/**
+ * Idempotent column-add for ownership tracking. Run on every helper init —
+ * SQLite's ALTER TABLE ADD COLUMN throws "duplicate column name" if the
+ * column already exists, which we silently swallow. Cheaper than the full
+ * pragma table_info() inspection round-trip.
+ */
+function migrateOwnership(d) {
+    for (const col of ['creator_id', 'workspace_id']) {
+        try {
+            d.prepare(`ALTER TABLE jobs ADD COLUMN ${col} TEXT NOT NULL DEFAULT ''`).run();
+            rootLogger.info({ component: 'job-board', column: col, event: 'job-board.migration' }, `Added ${col} column to jobs table`);
+        }
+        catch {
+            // duplicate column — already migrated
+        }
+    }
+}
+/** Default number of days a completed/failed/cancelled job is retained. */
+function resolveRetentionDays() {
+    const raw = process.env.IM_HUB_JOB_RETENTION_DAYS;
+    if (raw) {
+        const n = parseInt(raw, 10);
+        if (Number.isFinite(n) && n > 0)
+            return n;
+    }
+    return 30;
+}
+/** How often pruneOldJobs() is fired by the auto-sweep timer. 0 disables. */
+const RETENTION_SWEEP_INTERVAL_MS = 6 * 60 * 60 * 1000;
+let retentionSweepTimer = null;
+const helper = createSqliteHelper({
+    file: BOARD_DB,
+    component: 'job-board',
+    logger: rootLogger,
+    schema: `
+    CREATE TABLE IF NOT EXISTS jobs (
+      id            INTEGER PRIMARY KEY AUTOINCREMENT,
+      agent         TEXT    NOT NULL,
+      prompt        TEXT    NOT NULL,
+      status        TEXT    NOT NULL DEFAULT 'pending',
+      result        TEXT,
+      error         TEXT,
+      created_at    TEXT    NOT NULL DEFAULT (datetime('now')),
+      completed_at  TEXT,
+      creator_id    TEXT    NOT NULL DEFAULT '',
+      workspace_id  TEXT    NOT NULL DEFAULT ''
+    );
+    CREATE INDEX IF NOT EXISTS idx_jobs_created ON jobs(created_at);
+    CREATE INDEX IF NOT EXISTS idx_jobs_creator ON jobs(creator_id);
+    CREATE INDEX IF NOT EXISTS idx_jobs_status_created ON jobs(status, created_at);
+  `,
+    init: (d) => {
+        migrateOwnership(d);
+        // First-time / cold-start cleanup: any 'running' rows are leftover from a
+        // prior process that didn't get to finalize.
+        reapStaleRunning(d);
+        // Initial retention sweep + periodic timer. Mirrors audit-log shape so
+        // both tables stay bounded without operator intervention.
+        pruneOldJobs(d);
+        if (RETENTION_SWEEP_INTERVAL_MS > 0 && retentionSweepTimer === null) {
+            retentionSweepTimer = setInterval(() => {
+                const live = helper.get();
+                if (live)
+                    pruneOldJobs(live);
+            }, RETENTION_SWEEP_INTERVAL_MS);
+            if (typeof retentionSweepTimer === 'object' && retentionSweepTimer && 'unref' in retentionSweepTimer) {
+                retentionSweepTimer.unref();
+            }
+        }
+    },
+});
+/** Stop the retention sweep (used by tests + graceful shutdown). */
+export function stopJobRetentionSweep() {
+    if (retentionSweepTimer) {
+        clearInterval(retentionSweepTimer);
+        retentionSweepTimer = null;
+    }
+}
+/** Close the underlying SQLite handle. Called by cli.ts on graceful
+ *  shutdown so the WAL is checkpointed before exit (L2). */
+export function closeJobBoardDb() {
+    helper.close();
+}
+function getDb() {
+    return helper.get();
+}
+export function createJob(agent, prompt, opts = {}) {
+    const d = getDb();
+    if (!d)
+        throw new Error('Job board unavailable (SQLite not initialized)');
+    const row = d.prepare('INSERT INTO jobs (agent, prompt, status, creator_id, workspace_id) VALUES (?, ?, ?, ?, ?)').run(agent, prompt, 'pending', opts.creatorId || '', opts.workspaceId || '');
+    const id = Number(row.lastInsertRowid);
+    eventBus.publish({ type: 'job', phase: 'created', jobId: id, agent });
+    return id;
+}
+export function getJob(id, opts = {}) {
+    const d = getDb();
+    if (!d)
+        return null;
+    const row = (opts.creatorId !== undefined
+        ? d.prepare("SELECT * FROM jobs WHERE id = ? AND (creator_id = ? OR creator_id = '')")
+            .get(id, opts.creatorId)
+        : d.prepare('SELECT * FROM jobs WHERE id = ?').get(id));
+    return row || null;
+}
+export function listJobs(limit = 20, status, opts = {}) {
+    const d = getDb();
+    if (!d)
+        return [];
+    const safeLimit = Number.isFinite(limit) && limit > 0 ? Math.min(Math.floor(limit), 1000) : 20;
+    const conditions = [];
+    const params = [];
+    if (status) {
+        conditions.push('status = ?');
+        params.push(status);
+    }
+    if (opts.creatorId !== undefined) {
+        conditions.push("(creator_id = ? OR creator_id = '')");
+        params.push(opts.creatorId);
+    }
+    if (opts.agent) {
+        conditions.push('agent = ?');
+        params.push(opts.agent);
+    }
+    const where = conditions.length ? `WHERE ${conditions.join(' AND ')}` : '';
+    return d.prepare(`SELECT * FROM jobs ${where} ORDER BY created_at DESC LIMIT ?`)
+        .all(...params, safeLimit);
+}
+function updateJob(id, fields) {
+    const d = getDb();
+    if (!d)
+        return;
+    const sets = [];
+    const vals = [];
+    for (const [k, v] of Object.entries(fields)) {
+        if (v !== undefined) {
+            sets.push(`${k} = ?`);
+            vals.push(v);
+        }
+    }
+    if (!sets.length)
+        return;
+    d.prepare(`UPDATE jobs SET ${sets.join(', ')} WHERE id = ?`).run(...vals, id);
+}
+/**
+ * Acquire a job slot. Returns immediately when capacity available, otherwise
+ * queues the caller and returns a promise that resolves when a slot frees.
+ */
+async function acquireSlot() {
+    const max = resolveMaxConcurrent();
+    if (activeJobs < max) {
+        activeJobs++;
+        return;
+    }
+    await new Promise((resolve) => waitQueue.push(resolve));
+    activeJobs++;
+}
+function releaseSlot() {
+    activeJobs = Math.max(0, activeJobs - 1);
+    const next = waitQueue.shift();
+    if (next)
+        next();
+}
+export async function runJob(id, runner, logger) {
+    const job = getJob(id);
+    if (!job)
+        return;
+    // Block here if the job board is at capacity. The job stays 'pending' in
+    // SQLite while waiting — visible to /job list as queued.
+    await acquireSlot();
+    const controller = new AbortController();
+    runningControllers.set(id, controller);
+    updateJob(id, { status: 'running' });
+    eventBus.publish({ type: 'job', phase: 'started', jobId: id, agent: job.agent });
+    logger.info({ event: 'job.start', jobId: id, agent: job.agent, active: activeJobs });
+    let fullText = '';
+    let bytes = 0;
+    let droppedBytes = 0;
+    let truncated = false;
+    const cap = resolveMaxResultBytes();
+    try {
+        for await (const chunk of runner(job, logger, controller.signal)) {
+            if (controller.signal.aborted)
+                break;
+            const chunkBytes = Buffer.byteLength(chunk, 'utf-8');
+            if (truncated) {
+                droppedBytes += chunkBytes;
+                continue;
+            }
+            if (bytes + chunkBytes > cap) {
+                // Drop the entire over-cap chunk to keep the boundary on a UTF-8 /
+                // line boundary the producer chose; partial slicing risks splitting
+                // a multibyte char or a JSON object mid-event.
+                truncated = true;
+                droppedBytes += chunkBytes;
+                continue;
+            }
+            fullText += chunk;
+            bytes += chunkBytes;
+        }
+        if (truncated) {
+            const note = `\n\n[im-hub: result truncated — ${droppedBytes} bytes dropped after ${cap}-byte cap; raise IMHUB_JOB_RESULT_MAX_BYTES if needed]`;
+            fullText += note;
+            logger.warn({ event: 'job.result.truncated', jobId: id, droppedBytes, cap });
+        }
+        // Only update if not cancelled
+        if (!controller.signal.aborted) {
+            updateJob(id, { status: 'completed', result: fullText, completed_at: new Date().toISOString() });
+            eventBus.publish({ type: 'job', phase: 'completed', jobId: id, agent: job.agent });
+            logger.info({ event: 'job.complete', jobId: id, resultLen: fullText.length, truncated });
+        }
+        else {
+            updateJob(id, { status: 'cancelled', result: fullText || null, completed_at: new Date().toISOString() });
+            eventBus.publish({ type: 'job', phase: 'cancelled', jobId: id, agent: job.agent });
+            logger.info({ event: 'job.cancelled', jobId: id });
+        }
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        const stack = err instanceof Error ? err.stack : undefined;
+        updateJob(id, { status: 'failed', error: msg, completed_at: new Date().toISOString() });
+        eventBus.publish({ type: 'job', phase: 'failed', jobId: id, agent: job.agent });
+        logger.error({ event: 'job.failed', jobId: id, error: msg, stack });
+    }
+    finally {
+        runningControllers.delete(id);
+        releaseSlot();
+    }
+}
+/** Test/diagnostic accessor: how many runJob invocations are currently in flight. */
+export function _activeJobCount() { return activeJobs; }
+/** Test/diagnostic accessor: the wait queue depth. */
+export function _waitQueueDepth() { return waitQueue.length; }
+/** Test-only: directly exercise the concurrency gate without SQLite. */
+export const _testSlot = { acquire: acquireSlot, release: releaseSlot };
+export function cancelJob(id, opts = {}) {
+    const job = getJob(id, opts);
+    if (!job || (job.status !== 'pending' && job.status !== 'running'))
+        return false;
+    const ctrl = runningControllers.get(id);
+    if (ctrl) {
+        ctrl.abort();
+        runningControllers.delete(id);
+    }
+    updateJob(id, { status: 'cancelled', completed_at: new Date().toISOString() });
+    eventBus.publish({ type: 'job', phase: 'cancelled', jobId: id, agent: job.agent });
+    return true;
+}
+/**
+ * Delete jobs that finished (completed / failed / cancelled) more than
+ * `daysRetention` days ago. 'pending' / 'running' rows are never pruned —
+ * a stalled-but-resumable job is the operator's call. Returns the row
+ * count so callers / tests can assert.
+ */
+export function pruneOldJobs(d = getDb(), daysRetention = resolveRetentionDays()) {
+    if (!d)
+        return 0;
+    try {
+        const info = d.prepare(`
+      DELETE FROM jobs
+      WHERE status IN ('completed', 'failed', 'cancelled')
+        AND completed_at IS NOT NULL
+        AND completed_at < datetime('now', ?)
+    `).run(`-${daysRetention} days`);
+        if (info.changes > 0) {
+            rootLogger.info({
+                component: 'job-board', event: 'job-board.pruned',
+                deleted: info.changes, days: daysRetention,
+            }, `Pruned ${info.changes} job row(s) older than ${daysRetention}d`);
+        }
+        return info.changes;
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        rootLogger.warn({ component: 'job-board', event: 'job-board.prune.failed', error: msg }, 'job-board retention sweep failed');
+        return 0;
+    }
+}
+export function getJobStats() {
+    const empty = { total: 0, pending: 0, running: 0, completed: 0, failed: 0 };
+    const d = getDb();
+    if (!d)
+        return empty;
+    try {
+        const row = d.prepare(`
+      SELECT
+        COUNT(*) as total,
+        SUM(CASE WHEN status='pending' THEN 1 ELSE 0 END) as pending,
+        SUM(CASE WHEN status='running' THEN 1 ELSE 0 END) as running,
+        SUM(CASE WHEN status='completed' THEN 1 ELSE 0 END) as completed,
+        SUM(CASE WHEN status='failed' THEN 1 ELSE 0 END) as failed
+      FROM jobs
+    `).get();
+        return {
+            total: row.total || 0, pending: row.pending || 0, running: row.running || 0,
+            completed: row.completed || 0, failed: row.failed || 0,
+        };
+    }
+    catch {
+        return empty;
+    }
+}
+//# sourceMappingURL=job-board.js.map

package/dist/core/job-board.js.map

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

package/dist/core/logger.d.ts

@@ -0,0 +1,6 @@
+import pino from 'pino';
+declare const root: pino.Logger<never, boolean>;
+export declare function generateTraceId(): string;
+export declare function createLogger(bindings?: Record<string, unknown>): pino.Logger;
+export { root as logger };
+//# sourceMappingURL=logger.d.ts.map

package/dist/core/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/core/logger.ts"],"names":[],"mappings":"AAEA,OAAO,IAAI,MAAM,MAAM,CAAA;AAQvB,QAAA,MAAM,IAAI,6BAoCR,CAAA;AAEF,wBAAgB,eAAe,IAAI,MAAM,CAMxC;AAED,wBAAgB,YAAY,CAAC,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,IAAI,CAAC,MAAM,CAEhF;AAED,OAAO,EAAE,IAAI,IAAI,MAAM,EAAE,CAAA"}

package/dist/core/logger.js

@@ -0,0 +1,54 @@
+// Structured logging with trace id support
+import pino from 'pino';
+import { randomUUID } from 'crypto';
+const level = process.env.LOG_LEVEL || 'info';
+const usePretty = process.env.LOG_FORMAT === 'pretty' || (process.env.LOG_FORMAT !== 'json' && process.stdout.isTTY);
+const root = pino({
+    level,
+    ...(usePretty ? {
+        transport: {
+            target: 'pino-pretty',
+            options: {
+                colorize: true,
+                translateTime: 'yyyy-mm-dd HH:MM:ss.l',
+                ignore: 'pid,hostname',
+            },
+        },
+    } : {}),
+    serializers: {
+        token: () => '[REDACTED]',
+        botToken: () => '[REDACTED]',
+        bot_token: () => '[REDACTED]',
+        appSecret: () => '[REDACTED]',
+        app_secret: () => '[REDACTED]',
+        password: () => '[REDACTED]',
+    },
+    // serializers above only apply to top-level keys passed to log methods.
+    // redact.paths walks nested structures (config objects, error contexts)
+    // and is the line of defense against tokens that leaked into wrapped
+    // payloads, e.g. `log.info({ config: { botToken: '...' } })` or
+    // `log.warn({ err: { url: '...?token=...' } })`.
+    redact: {
+        paths: [
+            '*.token', '*.botToken', '*.bot_token',
+            '*.apiKey', '*.api_key',
+            '*.appSecret', '*.app_secret',
+            '*.password', '*.secret',
+            'headers.authorization',
+            'headers["x-im-hub-token"]',
+        ],
+        censor: '[REDACTED]',
+    },
+});
+export function generateTraceId() {
+    // 16 hex chars (≈ 2^64). 12 hex (≈ 2^48) collides ~once per 16M ids on
+    // average — visible at sustained > 1 K req/s. 16 hex pushes the
+    // expectation past the realistic lifetime of any single im-hub process
+    // without burning much log volume (4 extra chars per line).
+    return randomUUID().replace(/-/g, '').slice(0, 16);
+}
+export function createLogger(bindings = {}) {
+    return root.child(bindings);
+}
+export { root as logger };
+//# sourceMappingURL=logger.js.map

package/dist/core/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/core/logger.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAE3C,OAAO,IAAI,MAAM,MAAM,CAAA;AACvB,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAA;AAEnC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,MAAM,CAAA;AAC7C,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,KAAK,QAAQ,IAAI,CACvD,OAAO,CAAC,GAAG,CAAC,UAAU,KAAK,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,CAC1D,CAAA;AAED,MAAM,IAAI,GAAG,IAAI,CAAC;IAChB,KAAK;IACL,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC;QACd,SAAS,EAAE;YACT,MAAM,EAAE,aAAa;YACrB,OAAO,EAAE;gBACP,QAAQ,EAAE,IAAI;gBACd,aAAa,EAAE,uBAAuB;gBACtC,MAAM,EAAE,cAAc;aACvB;SACF;KACF,CAAC,CAAC,CAAC,EAAE,CAAC;IACP,WAAW,EAAE;QACX,KAAK,EAAE,GAAG,EAAE,CAAC,YAAY;QACzB,QAAQ,EAAE,GAAG,EAAE,CAAC,YAAY;QAC5B,SAAS,EAAE,GAAG,EAAE,CAAC,YAAY;QAC7B,SAAS,EAAE,GAAG,EAAE,CAAC,YAAY;QAC7B,UAAU,EAAE,GAAG,EAAE,CAAC,YAAY;QAC9B,QAAQ,EAAE,GAAG,EAAE,CAAC,YAAY;KAC7B;IACD,wEAAwE;IACxE,wEAAwE;IACxE,qEAAqE;IACrE,gEAAgE;IAChE,iDAAiD;IACjD,MAAM,EAAE;QACN,KAAK,EAAE;YACL,SAAS,EAAE,YAAY,EAAE,aAAa;YACtC,UAAU,EAAE,WAAW;YACvB,aAAa,EAAE,cAAc;YAC7B,YAAY,EAAE,UAAU;YACxB,uBAAuB;YACvB,2BAA2B;SAC5B;QACD,MAAM,EAAE,YAAY;KACrB;CACF,CAAC,CAAA;AAEF,MAAM,UAAU,eAAe;IAC7B,uEAAuE;IACvE,gEAAgE;IAChE,uEAAuE;IACvE,4DAA4D;IAC5D,OAAO,UAAU,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;AACpD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,WAAoC,EAAE;IACjE,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;AAC7B,CAAC;AAED,OAAO,EAAE,IAAI,IAAI,MAAM,EAAE,CAAA"}

package/dist/core/metrics.d.ts

@@ -0,0 +1,55 @@
+/** Increment when audit-log retention sweep fails. Exposed as a Prometheus
+ *  counter; ops should alert on any non-zero rate. */
+export declare function recordAuditPruneFailure(): void;
+/** Increment when an agent's per-spawn cleanup hook throws. Exposed as a
+ *  Prometheus counter so leaked tmpdirs (mcp-config etc.) become visible
+ *  on /api/metrics rather than only in warn-level pino output. */
+export declare function recordAgentCleanupFailure(): void;
+/** Type for the optional approval-bus metrics snapshot pulled in at scrape
+ *  time. Kept structural to avoid importing approval-bus at module load
+ *  (would risk a circular). */
+export interface ApprovalBusMetricsLike {
+    pending: number;
+    totalRequests: number;
+    totalResolved: number;
+    totalAllowed: number;
+    totalDenied: number;
+    totalTimedOut: number;
+}
+export declare function setApprovalBusSnapshotProvider(fn: (() => ApprovalBusMetricsLike) | null): void;
+export interface RecordedInvocation {
+    agent: string;
+    intent: string;
+    platform: string;
+    durationMs: number;
+    cost: number;
+    success: boolean;
+}
+export declare function recordInvocation(rec: RecordedInvocation): void;
+export interface MetricsSnapshot {
+    uptimeSec: number;
+    agents: Array<{
+        agent: string;
+        total: number;
+        success: number;
+        failure: number;
+        successRate: number;
+        costSum: number;
+        sampleCount: number;
+        p50Ms: number;
+        p95Ms: number;
+        p99Ms: number;
+    }>;
+    intentTotals: Record<string, number>;
+    platformTotals: Record<string, number>;
+}
+export declare function snapshot(): MetricsSnapshot;
+/**
+ * Render the snapshot in Prometheus text exposition format. Keeps line
+ * count low and uses bare metric names without a HELP/TYPE preamble per
+ * line family (we emit one preamble each).
+ */
+export declare function toPrometheus(): string;
+/** Reset all counters. Test-only. */
+export declare function reset(): void;
+//# sourceMappingURL=metrics.d.ts.map

package/dist/core/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../src/core/metrics.ts"],"names":[],"mappings":"AA8HA;sDACsD;AACtD,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C;AAED;;kEAEkE;AAClE,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD;AAED;;+BAE+B;AAC/B,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAA;IACf,aAAa,EAAE,MAAM,CAAA;IACrB,aAAa,EAAE,MAAM,CAAA;IACrB,YAAY,EAAE,MAAM,CAAA;IACpB,WAAW,EAAE,MAAM,CAAA;IACnB,aAAa,EAAE,MAAM,CAAA;CACtB;AAQD,wBAAgB,8BAA8B,CAAC,EAAE,EAAE,CAAC,MAAM,sBAAsB,CAAC,GAAG,IAAI,GAAG,IAAI,CAE9F;AAuCD,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,OAAO,CAAA;CACjB;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,kBAAkB,GAAG,IAAI,CAa9D;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,KAAK,CAAC;QACZ,KAAK,EAAE,MAAM,CAAA;QACb,KAAK,EAAE,MAAM,CAAA;QACb,OAAO,EAAE,MAAM,CAAA;QACf,OAAO,EAAE,MAAM,CAAA;QACf,WAAW,EAAE,MAAM,CAAA;QACnB,OAAO,EAAE,MAAM,CAAA;QACf,WAAW,EAAE,MAAM,CAAA;QACnB,KAAK,EAAE,MAAM,CAAA;QACb,KAAK,EAAE,MAAM,CAAA;QACb,KAAK,EAAE,MAAM,CAAA;KACd,CAAC,CAAA;IACF,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACpC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACvC;AAED,wBAAgB,QAAQ,IAAI,eAAe,CA0B1C;AAED;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAqErC;AAED,qCAAqC;AACrC,wBAAgB,KAAK,IAAI,IAAI,CAM5B"}