@atomic-chat/core 0.5.1

package/dist/telemetry/reports.js

@@ -0,0 +1,212 @@
+/**
+ * What each failure the core observes becomes as a report — or null when it is not a defect worth
+ * an issue. Pure: callers hand in what they know, the reporter scrubs and sends.
+ */
+import { AtomicCoreError } from '../contracts/index.js';
+import { RECOVERABLE_LOAD_ERROR_CODES, isCrashExit, signalNumber } from '../runtime/llamacpp/index.js';
+import { ENVIRONMENT_FAILURE_CODES, errorCodeOf, isCancellation, isClientAbort, markerLines, oomSubtype, quantOf, } from './policy.js';
+import { headline } from './scrub.js';
+/** Hand a report to the sink when there is one and the failure is worth reporting. */
+export function captureReport(sink, report) {
+    if (sink && report)
+        sink.capture(report);
+}
+/** A crash-looping engine is one report per model, code and window (the web app's throttle). */
+export const ENGINE_THROTTLE_MS = 5 * 60_000;
+function modelTag(modelId) {
+    return modelId.replace(/\\/g, '/');
+}
+function detailsOf(error) {
+    if (error instanceof AtomicCoreError)
+        return error.details ?? error.message;
+    return error instanceof Error ? error.message : undefined;
+}
+/** A throw nothing caught: the daemon dies (fatal), or an event listener lost one event (error). */
+export function processFailureReport(source, error, context = {}) {
+    // Losing the race for the instance lock is how a second launch learns an owner already runs.
+    if (source === 'startup' && errorCodeOf(error) === 'CORE_ALREADY_RUNNING')
+        return null;
+    return {
+        source,
+        level: source === 'event_listener' ? 'error' : 'fatal',
+        error,
+        tags: { error_code: errorCodeOf(error), event: context.event },
+    };
+}
+// ── the HTTP servers ─────────────────────────────────────────────────────────
+/**
+ * A request that failed on our side. Coded `AtomicCoreError`s are answers, not defects, and a client
+ * that hung up is its own business; what is left is a bug behind the HTTP boundary.
+ */
+export function internalErrorReport(input) {
+    if (input.status < 500 || input.error instanceof AtomicCoreError || isClientAbort(input.error))
+        return null;
+    return {
+        source: input.source,
+        level: 'error',
+        error: input.error,
+        tags: { route: input.route, http_status: input.status, error_code: errorCodeOf(input.error) },
+    };
+}
+// ── local engines ────────────────────────────────────────────────────────────
+/**
+ * A loaded engine that exited. A native crash is an error, a kill from outside (the OOM killer,
+ * Jetsam) or an out-of-memory exit a warning; a polite stop or a clean exit is nothing. Loads that
+ * crash are reported by `loadFailureReport`: `session:died` fires only for a session that was up.
+ */
+export function sessionDeathReport(died, platform) {
+    const signal = signalNumber(died.signal);
+    const crashed = isCrashExit({ code: died.exit_code, signal: died.signal }, platform);
+    const oom = /out of memory|\boom\b/i.test(died.message);
+    let kind;
+    if (crashed)
+        kind = signal === 11 ? 'sigsegv' : signal === 6 ? 'sigabrt' : 'native_crash';
+    else if (signal === 9)
+        kind = 'sigkill';
+    else if (oom)
+        kind = 'oom';
+    else if (signal === null && died.exit_code !== null && died.exit_code !== 0)
+        kind = 'exit';
+    else
+        return null;
+    return {
+        source: 'backend_crash',
+        level: kind === 'sigkill' || kind === 'oom' ? 'warning' : 'error',
+        type: 'BackendCrash',
+        message: headline(died.message),
+        fingerprint: ['backend-crash', died.provider, kind],
+        tags: {
+            provider: died.provider,
+            model_id: modelTag(died.model_id),
+            quant: quantOf(died.model_id),
+            crash_kind: kind,
+            exit_code: died.exit_code,
+            signal: died.signal,
+        },
+        throttle: { key: `died:${died.provider}:${died.model_id}:${kind}`, windowMs: ENGINE_THROTTLE_MS },
+    };
+}
+/**
+ * Refusals before any engine starts: an unknown provider or model, a model another owner holds, a
+ * core that is stopping. They are answers to the caller, not load failures.
+ */
+const NOT_ENGINE_FAILURES = new Set([
+    'PROVIDER_NOT_FOUND',
+    'MODEL_NOT_FOUND',
+    'CORE_ALREADY_RUNNING',
+    'CORE_NOT_RUNNING',
+]);
+/**
+ * A model that did not load, from any caller (the app, the public API, a remote client, the CLI).
+ * The user stopping it and the conditions they can fix themselves (a missing file, an old OS) are
+ * not reported; environment causes are counted at `warning`, like the web app did.
+ */
+export function loadFailureReport(input) {
+    if (isCancellation(input.error))
+        return null;
+    const code = errorCodeOf(input.error) ?? 'UNKNOWN';
+    if (RECOVERABLE_LOAD_ERROR_CODES.has(code) || NOT_ENGINE_FAILURES.has(code))
+        return null;
+    const details = detailsOf(input.error);
+    const o = input.overrides ?? {};
+    const engineErrors = markerLines(details);
+    return {
+        source: 'model_load',
+        level: ENVIRONMENT_FAILURE_CODES.has(code) ? 'warning' : 'error',
+        error: input.error,
+        fingerprint: ['model-load-failure', input.provider, code],
+        tags: {
+            provider: input.provider,
+            error_code: code,
+            model_id: modelTag(input.modelId),
+            quant: quantOf(input.modelId),
+            backend: o['version_backend'],
+            context_length: (o['ctx_size'] ?? o['ctx_len']),
+            gpu_layers: o['n_gpu_layers'],
+            cache_type_k: o['cache_type_k'],
+            is_embedding: input.isEmbedding || undefined,
+            oom_subtype: code === 'OUT_OF_MEMORY' ? oomSubtype(details) : undefined,
+        },
+        ...(engineErrors ? { extra: { engine_errors: engineErrors } } : {}),
+        throttle: { key: `load:${input.provider}:${input.modelId}:${code}`, windowMs: ENGINE_THROTTLE_MS },
+    };
+}
+/**
+ * Image-generation codes that name something the user or the app can fix — a missing engine or
+ * file, an unsupported request, a busy queue, a full disk — rather than an engine or core defect.
+ */
+export const RECOVERABLE_DIFFUSION_CODES = new Set([
+    'ENGINE_MISSING',
+    'ENGINE_UPDATE_REQUIRED',
+    'MODEL_MISSING',
+    'SIDE_FILE_MISSING',
+    'MODEL_INCOMPATIBLE',
+    'MODEL_NOT_LOADED',
+    'UNSUPPORTED_BACKEND',
+    'UNSUPPORTED_WORKFLOW',
+    'INVALID_DIMENSIONS',
+    'INVALID_REQUEST',
+    'JOB_BUSY',
+    'JOB_NOT_FOUND',
+    'QUEUE_FULL',
+    'CANCELLED',
+    'DISK_FULL',
+    'BACKEND_IN_USE',
+    'NOT_CONFIGURED',
+]);
+/** sd.cpp failing to load a model (`load`) or to finish an image (`job`). */
+export function diffusionFailureReport(input) {
+    if (isCancellation(input.error))
+        return null;
+    const code = errorCodeOf(input.error) ?? 'INTERNAL';
+    if (RECOVERABLE_DIFFUSION_CODES.has(code))
+        return null;
+    const engineErrors = markerLines(detailsOf(input.error));
+    return {
+        source: input.phase === 'load' ? 'diffusion_load' : 'diffusion_job',
+        level: code === 'OUT_OF_MEMORY' || code === 'INVALID_OUTPUT' ? 'warning' : 'error',
+        error: input.error,
+        fingerprint: [input.phase === 'load' ? 'diffusion-load-failure' : 'diffusion-failure', code],
+        tags: { provider: 'diffusion', error_code: code, diffusion_family: input.family, engine: input.engine },
+        ...(engineErrors ? { extra: { engine_errors: engineErrors } } : {}),
+        throttle: { key: `diffusion:${input.phase}:${input.family ?? ''}:${code}`, windowMs: ENGINE_THROTTLE_MS },
+    };
+}
+function upstreamMessage(body) {
+    try {
+        const parsed = JSON.parse(body);
+        const message = typeof parsed.error === 'string' ? parsed.error : (parsed.error?.message ?? parsed.message);
+        if (typeof message === 'string')
+            return headline(message);
+    }
+    catch {
+        /* not JSON: the body is the message */
+    }
+    return headline(body);
+}
+/**
+ * A running local engine that failed a request: a compute failure that leaves the backend unusable
+ * (a Metal OOM during prompt processing, "failed to decode") at `warning`, any other 5xx at `error`.
+ * A 4xx is about the request (context overflow included) and stays with the app.
+ */
+export function inferenceFailureReport(input) {
+    if (!input.compute && input.status < 500)
+        return null;
+    const kind = input.compute ? (input.oom ? 'oom' : 'compute') : String(input.status);
+    return {
+        source: 'inference',
+        level: input.compute ? 'warning' : 'error',
+        type: 'InferenceFailure',
+        message: upstreamMessage(input.body) || `HTTP ${input.status}`,
+        fingerprint: ['inference-failure', input.provider, kind],
+        tags: {
+            provider: input.provider,
+            model_id: modelTag(input.modelId),
+            quant: quantOf(input.modelId),
+            http_status: input.status,
+            failure_kind: kind,
+        },
+        throttle: { key: `inference:${input.provider}:${input.modelId}:${kind}`, windowMs: ENGINE_THROTTLE_MS },
+    };
+}
+//# sourceMappingURL=reports.js.map

package/dist/telemetry/reports.js.map

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

package/dist/telemetry/scrub.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Zero-PII scrubbing for everything an error report carries. A port of the app's
+ * `src-tauri/src/core/telemetry/scrub.rs` (itself a mirror of `scrubPii` in the web app), plus what
+ * only the core sees: its data folder, the tunnel host, LAN addresses and more token shapes.
+ * Structure is kept so a report stays debuggable: `/Users/<redacted>/models/x.gguf`, not `<path>`.
+ */
+export interface ScrubContext {
+    /** The canonical data folder; every path under it becomes `<data>/…`. */
+    dataFolder?: string;
+    /** The user's home folder; becomes `~`. */
+    homeDir?: string;
+}
+export declare const REDACTED = "<redacted>";
+/** Mask user names, credentials, tokens, e-mail and network addresses in free text. */
+export declare function scrubText(input: string, context?: ScrubContext): string;
+/** Scrub every string in a JSON-like value; values under sensitive keys are dropped wholesale. */
+export declare function scrubValue(value: unknown, context?: ScrubContext): unknown;
+/** The first non-empty line, cut to `max` characters: an engine's headline, not its pasted log. */
+export declare function headline(text: string, max?: number): string;

package/dist/telemetry/scrub.js

@@ -0,0 +1,75 @@
+/**
+ * Zero-PII scrubbing for everything an error report carries. A port of the app's
+ * `src-tauri/src/core/telemetry/scrub.rs` (itself a mirror of `scrubPii` in the web app), plus what
+ * only the core sees: its data folder, the tunnel host, LAN addresses and more token shapes.
+ * Structure is kept so a report stays debuggable: `/Users/<redacted>/models/x.gguf`, not `<path>`.
+ */
+export const REDACTED = '<redacted>';
+/** Object keys whose values are dropped wholesale — the web app's `SENSITIVE_KEY_RE`. */
+const SENSITIVE_KEY_RE = /^(authorization|cookie|set-cookie|x-api-key|api[_-]?key|token|access_token|refresh_token|auth|secret|password|passwd|base_url|hf_token|huggingface_token|proxy|email|username|user_name|ip|ip_address|serial|uuid|hostname|host_name|machine|machine_name)$/i;
+const RULES = [
+    // The first segment after a home-folder marker is the OS user name.
+    [/([/\\](?:Users|home)[/\\])[^/\\\s"'`)\]},;:|]+/g, `$1${REDACTED}`],
+    // `scheme://user:pass@host` keeps the scheme and the host.
+    [/(\b[a-z][a-z0-9+.-]*:\/\/)[^\s/?#@]+@/gi, `$1${REDACTED}@`],
+    // A quick tunnel's name is the only thing that guards it.
+    [/\b[a-z0-9-]+\.trycloudflare\.com\b/gi, '<tunnel>.trycloudflare.com'],
+    [/\bhf_[A-Za-z0-9_]+/g, REDACTED],
+    [/\bsk-ant-[\w-]+/g, REDACTED],
+    [/\bsk-[\w-]{10,}/g, REDACTED],
+    [/\bAIza[\w-]{20,}/g, REDACTED],
+    [/\b(?:ghp|gho|ghu|ghs|github_pat)_[A-Za-z0-9_]+/g, REDACTED],
+    [/\beyJ[\w-]+\.[\w-]+\.[\w-]+/g, REDACTED],
+    [/(\bbearer\s+)[^\s"']+/gi, `$1${REDACTED}`],
+    [
+        /([?&](?:access_token|refresh_token|api_key|apikey|password|secret|signature|token|auth|key|sig)=)[^&#"'\s]*/gi,
+        `$1${REDACTED}`,
+    ],
+    [/[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}/g, '<email>'],
+    // LAN and public addresses; loopback and the wildcard say nothing about the user.
+    [
+        /\b(?!127\.0\.0\.1\b)(?!0\.0\.0\.0\b)(?:25[0-5]|2[0-4]\d|1?\d?\d)(?:\.(?:25[0-5]|2[0-4]\d|1?\d?\d)){3}\b/g,
+        '<ip>',
+    ],
+];
+function replaceFolder(input, folder, token) {
+    if (!folder || folder.length < 2)
+        return input;
+    let out = input;
+    for (const variant of new Set([folder, folder.replace(/\\/g, '/'), folder.replace(/\//g, '\\')])) {
+        out = out.split(variant).join(token);
+    }
+    return out;
+}
+/** Mask user names, credentials, tokens, e-mail and network addresses in free text. */
+export function scrubText(input, context = {}) {
+    let out = replaceFolder(input, context.dataFolder, '<data>');
+    out = replaceFolder(out, context.homeDir, '~');
+    for (const [pattern, replacement] of RULES)
+        out = out.replace(pattern, replacement);
+    return out;
+}
+/** Scrub every string in a JSON-like value; values under sensitive keys are dropped wholesale. */
+export function scrubValue(value, context = {}) {
+    if (typeof value === 'string')
+        return scrubText(value, context);
+    if (Array.isArray(value))
+        return value.map((item) => scrubValue(item, context));
+    if (value && typeof value === 'object') {
+        const out = {};
+        for (const [key, item] of Object.entries(value)) {
+            out[key] = SENSITIVE_KEY_RE.test(key) ? REDACTED : scrubValue(item, context);
+        }
+        return out;
+    }
+    return value;
+}
+/** The first non-empty line, cut to `max` characters: an engine's headline, not its pasted log. */
+export function headline(text, max = 200) {
+    const line = text
+        .split(/\r?\n/)
+        .map((l) => l.trim())
+        .find(Boolean) ?? '';
+    return line.length > max ? `${line.slice(0, max - 1)}…` : line;
+}
+//# sourceMappingURL=scrub.js.map

package/dist/telemetry/scrub.js.map

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

package/dist/telemetry/stack.d.ts

@@ -0,0 +1,21 @@
+/** One Sentry stack frame. */
+export interface StackFrame {
+    function?: string;
+    filename: string;
+    lineno?: number;
+    colno?: number;
+    /** Ours (`src/…`), not the runtime's or a dependency's. */
+    in_app: boolean;
+}
+/**
+ * Where a frame's file lives, without the machine it was built or run on. The compiled binary
+ * already reports repo-relative `src/…` paths (Bun embeds the source map); under Node the path is
+ * absolute and is cut at `src/` or `dist/`; anything else keeps only its file name, which drops the
+ * home folder and the user name with it. Runtime pseudo-files (`native`, `node:internal/…`) stay.
+ */
+export declare function framePath(raw: string): string;
+/**
+ * Parse a V8- or JavaScriptCore-style `error.stack` into Sentry frames, oldest call first (the order
+ * Sentry expects; `error.stack` lists the innermost call first).
+ */
+export declare function parseStack(stack: string | undefined): StackFrame[];

package/dist/telemetry/stack.js

@@ -0,0 +1,68 @@
+const MAX_FRAMES = 50;
+/**
+ * Where a frame's file lives, without the machine it was built or run on. The compiled binary
+ * already reports repo-relative `src/…` paths (Bun embeds the source map); under Node the path is
+ * absolute and is cut at `src/` or `dist/`; anything else keeps only its file name, which drops the
+ * home folder and the user name with it. Runtime pseudo-files (`native`, `node:internal/…`) stay.
+ */
+export function framePath(raw) {
+    let path = raw.replace(/^file:\/\/\/?/, '/').replace(/\\/g, '/');
+    if (/^\/[A-Za-z]:\//.test(path))
+        path = path.slice(1);
+    if (path === 'native' || path.startsWith('node:') || path.startsWith('src/'))
+        return path;
+    const dependency = /(?:^|\/)(node_modules\/.+)$/.exec(path);
+    if (dependency?.[1])
+        return dependency[1];
+    // The last `src/` or `dist/`: a checkout under `~/src/` must not keep that prefix.
+    const cut = /^.*(?:^|\/)((?:src|dist)\/.+)$/.exec(path);
+    if (cut?.[1])
+        return cut[1];
+    return path.slice(path.lastIndexOf('/') + 1);
+}
+function parseLocation(location) {
+    const match = /^(.*?)(?::(\d+))?(?::(\d+))?$/.exec(location);
+    const [, path = '', line, column] = match;
+    return {
+        path,
+        ...(line ? { line: Number(line) } : {}),
+        ...(column ? { column: Number(column) } : {}),
+    };
+}
+/**
+ * Parse a V8- or JavaScriptCore-style `error.stack` into Sentry frames, oldest call first (the order
+ * Sentry expects; `error.stack` lists the innermost call first).
+ */
+export function parseStack(stack) {
+    if (!stack)
+        return [];
+    const frames = [];
+    for (const line of stack.split('\n')) {
+        const at = /^\s*at\s+(.+?)\s*$/.exec(line);
+        if (!at?.[1])
+            continue;
+        const body = at[1];
+        let fn;
+        let location = body;
+        const open = body.lastIndexOf(' (');
+        if (open > 0 && body.endsWith(')')) {
+            fn = body.slice(0, open).replace(/^async\s+/, '');
+            location = body.slice(open + 2, -1);
+        }
+        const { path, line: lineno, column } = parseLocation(location);
+        if (!path)
+            continue;
+        const filename = framePath(path);
+        frames.push({
+            ...(fn ? { function: fn } : {}),
+            filename,
+            ...(lineno !== undefined ? { lineno } : {}),
+            ...(column !== undefined ? { colno: column } : {}),
+            in_app: filename.startsWith('src/') || filename.startsWith('dist/'),
+        });
+        if (frames.length === MAX_FRAMES)
+            break;
+    }
+    return frames.reverse();
+}
+//# sourceMappingURL=stack.js.map

package/dist/telemetry/stack.js.map

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

package/dist/telemetry/store.d.ts

@@ -0,0 +1,17 @@
+/**
+ * `<data>/atomic-core/telemetry.json`: the core's own error-reporting state for one data folder — the
+ * user's stored choice (`atomic-chat-core telemetry on|off`), the anonymous install id every report
+ * carries when no host names a user, and whether the first-run notice was shown.
+ */
+export interface TelemetryFile {
+    /** The user's stored choice; absent until they make one. */
+    enabled?: boolean;
+    install_id?: string;
+    notice_shown?: boolean;
+}
+/** The file as it is; a missing or unreadable one reads as empty (nothing chosen, no id yet). */
+export declare function readTelemetryFile(path: string): Promise<TelemetryFile>;
+/** Write through a hidden sibling, so a reader never sees half of it. Best effort: never throws. */
+export declare function writeTelemetryFile(path: string, file: TelemetryFile): Promise<boolean>;
+/** The install id, minted and stored on first use. */
+export declare function ensureInstallId(path: string, file: TelemetryFile): Promise<string>;

package/dist/telemetry/store.js

@@ -0,0 +1,51 @@
+/**
+ * `<data>/atomic-core/telemetry.json`: the core's own error-reporting state for one data folder — the
+ * user's stored choice (`atomic-chat-core telemetry on|off`), the anonymous install id every report
+ * carries when no host names a user, and whether the first-run notice was shown.
+ */
+import { randomUUID } from 'node:crypto';
+import { mkdir, readFile, rename, rm, writeFile } from 'node:fs/promises';
+import { basename, dirname, join } from 'node:path';
+function parse(text) {
+    const raw = JSON.parse(text);
+    const file = {};
+    if (typeof raw['enabled'] === 'boolean')
+        file.enabled = raw['enabled'];
+    if (typeof raw['install_id'] === 'string' && /^[0-9a-f-]{32,36}$/.test(raw['install_id']))
+        file.install_id = raw['install_id'];
+    if (raw['notice_shown'] === true)
+        file.notice_shown = true;
+    return file;
+}
+/** The file as it is; a missing or unreadable one reads as empty (nothing chosen, no id yet). */
+export async function readTelemetryFile(path) {
+    try {
+        return parse(await readFile(path, 'utf8'));
+    }
+    catch {
+        return {};
+    }
+}
+/** Write through a hidden sibling, so a reader never sees half of it. Best effort: never throws. */
+export async function writeTelemetryFile(path, file) {
+    const tmp = join(dirname(path), `.${basename(path)}.tmp`);
+    try {
+        await mkdir(dirname(path), { recursive: true });
+        await writeFile(tmp, `${JSON.stringify(file, null, 2)}\n`);
+        await rename(tmp, path);
+        return true;
+    }
+    catch {
+        await rm(tmp, { force: true }).catch(() => { });
+        return false;
+    }
+}
+/** The install id, minted and stored on first use. */
+export async function ensureInstallId(path, file) {
+    if (file.install_id)
+        return file.install_id;
+    const installId = randomUUID();
+    await writeTelemetryFile(path, { ...file, install_id: installId });
+    return installId;
+}
+//# sourceMappingURL=store.js.map

package/dist/telemetry/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/telemetry/store.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACzE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AASnD,SAAS,KAAK,CAAC,IAAY;IACzB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAA4B,CAAA;IACvD,MAAM,IAAI,GAAkB,EAAE,CAAA;IAC9B,IAAI,OAAO,GAAG,CAAC,SAAS,CAAC,KAAK,SAAS;QAAE,IAAI,CAAC,OAAO,GAAG,GAAG,CAAC,SAAS,CAAC,CAAA;IACtE,IAAI,OAAO,GAAG,CAAC,YAAY,CAAC,KAAK,QAAQ,IAAI,oBAAoB,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QACvF,IAAI,CAAC,UAAU,GAAG,GAAG,CAAC,YAAY,CAAC,CAAA;IACrC,IAAI,GAAG,CAAC,cAAc,CAAC,KAAK,IAAI;QAAE,IAAI,CAAC,YAAY,GAAG,IAAI,CAAA;IAC1D,OAAO,IAAI,CAAA;AACb,CAAC;AAED,iGAAiG;AACjG,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAY;IAClD,IAAI,CAAC;QACH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAA;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAA;IACX,CAAC;AACH,CAAC;AAED,oGAAoG;AACpG,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAAY,EAAE,IAAmB;IACxE,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IACzD,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QAC/C,MAAM,SAAS,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAA;QAC1D,MAAM,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;QACvB,OAAO,IAAI,CAAA;IACb,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;QAC9C,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC;AAED,sDAAsD;AACtD,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAY,EAAE,IAAmB;IACrE,IAAI,IAAI,CAAC,UAAU;QAAE,OAAO,IAAI,CAAC,UAAU,CAAA;IAC3C,MAAM,SAAS,GAAG,UAAU,EAAE,CAAA;IAC9B,MAAM,kBAAkB,CAAC,IAAI,EAAE,EAAE,GAAG,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,CAAA;IAClE,OAAO,SAAS,CAAA;AAClB,CAAC"}

package/dist/telemetry/subscribe.d.ts

@@ -0,0 +1,13 @@
+import type { CoreEvents } from '../contracts/index.js';
+import type { ErrorSink } from './types.js';
+type ReportedEvent = 'session:died' | 'diffusion:error';
+export interface ReportableEvents {
+    on<K extends ReportedEvent>(name: K, listener: (payload: CoreEvents[K]) => void): () => void;
+}
+/**
+ * Report what the core already announces as events: an engine that died after it had loaded, and an
+ * image model or image job that failed. Subscribing keeps the runtimes and the diffusion module
+ * unaware of error reporting. Returns the unsubscribe.
+ */
+export declare function reportCoreEvents(events: ReportableEvents, sink: ErrorSink, platform: NodeJS.Platform): () => void;
+export {};

package/dist/telemetry/subscribe.js

@@ -0,0 +1,19 @@
+import { AtomicCoreError } from '../contracts/index.js';
+import { captureReport, diffusionFailureReport, sessionDeathReport } from './reports.js';
+/**
+ * Report what the core already announces as events: an engine that died after it had loaded, and an
+ * image model or image job that failed. Subscribing keeps the runtimes and the diffusion module
+ * unaware of error reporting. Returns the unsubscribe.
+ */
+export function reportCoreEvents(events, sink, platform) {
+    const offDied = events.on('session:died', (died) => captureReport(sink, sessionDeathReport(died, platform)));
+    const offDiffusion = events.on('diffusion:error', (failure) => captureReport(sink, diffusionFailureReport({
+        phase: failure.jobId === undefined ? 'load' : 'job',
+        error: new AtomicCoreError(failure.code, failure.message, failure.details),
+    })));
+    return () => {
+        offDied();
+        offDiffusion();
+    };
+}
+//# sourceMappingURL=subscribe.js.map

package/dist/telemetry/subscribe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscribe.js","sourceRoot":"","sources":["../../src/telemetry/subscribe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAEvD,OAAO,EAAE,aAAa,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AASxF;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAC9B,MAAwB,EACxB,IAAe,EACf,QAAyB;IAEzB,MAAM,OAAO,GAAG,MAAM,CAAC,EAAE,CAAC,cAAc,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,kBAAkB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAA;IAC5G,MAAM,YAAY,GAAG,MAAM,CAAC,EAAE,CAAC,iBAAiB,EAAE,CAAC,OAAO,EAAE,EAAE,CAC5D,aAAa,CACX,IAAI,EACJ,sBAAsB,CAAC;QACrB,KAAK,EAAE,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK;QACnD,KAAK,EAAE,IAAI,eAAe,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC;KAC3E,CAAC,CACH,CACF,CAAA;IACD,OAAO,GAAG,EAAE;QACV,OAAO,EAAE,CAAA;QACT,YAAY,EAAE,CAAA;IAChB,CAAC,CAAA;AACH,CAAC"}

package/dist/telemetry/types.d.ts

@@ -0,0 +1,40 @@
+import type { TelemetryState } from '../contracts/index.js';
+export type ReportLevel = 'fatal' | 'error' | 'warning';
+/** Where a report comes from; it becomes the `source` tag and the exception mechanism. */
+export type ReportSource = 'uncaught_exception' | 'unhandled_rejection' | 'startup' | 'control_route' | 'public_server' | 'event_listener' | 'backend_crash' | 'model_load' | 'diffusion_load' | 'diffusion_job' | 'inference';
+/** One failure worth an issue, before scrubbing: what the rest of the core hands the reporter. */
+export interface ErrorReport {
+    source: ReportSource;
+    level: ReportLevel;
+    /** The thrown value: its type, headline and stack. */
+    error?: unknown;
+    /** Exception type when nothing was thrown (an engine that exited). */
+    type?: string;
+    /** Headline when nothing was thrown. */
+    message?: string;
+    /** Explicit grouping; without it Sentry groups by stack. */
+    fingerprint?: string[];
+    tags?: Record<string, string | number | boolean | null | undefined>;
+    /** Free text attached after scrubbing, e.g. the engine's error lines. */
+    extra?: Record<string, string>;
+    /** Repeats with the same key inside the window are dropped (a load crash-loop is one report). */
+    throttle?: {
+        key: string;
+        windowMs: number;
+    };
+}
+/** What the core's services see of error reporting. No-ops when reporting is off. */
+export interface ErrorSink {
+    capture(report: ErrorReport): void;
+}
+/** What the app changes over `PUT /atomic/v1/telemetry`; an omitted field keeps its value. */
+export interface TelemetryUpdate {
+    enabled?: boolean | undefined;
+    user_id?: string | null | undefined;
+    tags?: Record<string, unknown> | undefined;
+}
+/** The reporter as the control API drives it: the sink, plus the app's consent, user and tags. */
+export interface TelemetryControl extends ErrorSink {
+    state(): TelemetryState;
+    update(update: TelemetryUpdate): void;
+}

package/dist/telemetry/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/telemetry/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/telemetry/types.ts"],"names":[],"mappings":""}

package/dist/util/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Small shared helpers with no I/O. Rust-compatible number parsing/formatting lives here because
+ * several ports (argv, GGUF, log parsers) must reproduce `str::parse` / `to_string` exactly.
+ */
+export * from './rust-number.js';

package/dist/util/index.js

@@ -0,0 +1,6 @@
+/**
+ * Small shared helpers with no I/O. Rust-compatible number parsing/formatting lives here because
+ * several ports (argv, GGUF, log parsers) must reproduce `str::parse` / `to_string` exactly.
+ */
+export * from './rust-number.js';
+//# sourceMappingURL=index.js.map

package/dist/util/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/util/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,kBAAkB,CAAA"}

package/dist/util/rust-number.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Rust-compatible number parsing and formatting, shared by every port that has to reproduce
+ * `str::parse::<T>()` and `T::to_string()` behaviour (argv floats, GGUF scalar stringification,
+ * log-line parsers).
+ */
+/** `str::parse::<i32>()`: optional sign, digits only, in range. */
+export declare function parseRustI32(s: string): number | undefined;
+/** `str::parse::<u64>()`: optional `+`, digits only. Values above 2^53 lose precision. */
+export declare function parseRustU64(s: string): number | undefined;
+/** `str::parse::<f64>()` for the shapes that matter: decimal, exponent, inf/infinity/nan. */
+export declare function parseRustF64(s: string): number | undefined;
+/** Rewrite JS exponent notation into the plain decimal Rust's `Display` prints. */
+export declare function expandExponent(s: string): string;
+/**
+ * `f32::to_string()`: shortest decimal that round-trips through f32, no exponent, integers
+ * without a fractional part (`2.0 → "2"`), `inf` / `-inf` / `NaN` spelled as Rust does.
+ * Values arriving as JSON doubles serialised from f32 are rounded through `Math.fround` first.
+ */
+export declare function formatRustF32(value: number): string;
+/** `f64::to_string()`: JS already prints the shortest round-trip; only the spelling differs. */
+export declare function formatRustF64(value: number): string;
+/** `(a - b).abs() > f32::EPSILON` evaluated in f32 as Rust does. */
+export declare function f32Differs(a: number, b: number): boolean;
+/** `(v) as u64` on a float: NaN → 0, negative → 0, truncates; saturates at MAX_SAFE_INTEGER. */
+export declare function floatAsU64(v: number): number;
+/** `a.saturating_sub(b)` on u64. */
+export declare function saturatingSub(a: number, b: number): number;