@atomic-chat/core 0.5.1

package/dist/telemetry/envelope.js

@@ -0,0 +1,95 @@
+import { errorCodeOf, sanitizeTags } from './policy.js';
+import { headline, scrubText } from './scrub.js';
+import { parseStack } from './stack.js';
+const MAX_EXTRA = 4096;
+function describeThrown(error, scrub) {
+    if (error instanceof Error) {
+        const code = errorCodeOf(error);
+        // A coded core error reads best as its code: "OUT_OF_MEMORY: Out of memory".
+        const type = error.name === 'AtomicCoreError' && code ? code : error.name || 'Error';
+        return {
+            type,
+            value: headline(scrubText(error.message, scrub)) || type,
+            ...(error.stack ? { stack: error.stack } : {}),
+        };
+    }
+    if (typeof error === 'string')
+        return { type: 'NonError', value: headline(scrubText(error, scrub)) || 'NonError' };
+    // Never stringify an arbitrary object: it may hold a request body.
+    return { type: 'NonError', value: `A non-Error ${error === null ? 'null' : typeof error} was thrown` };
+}
+/**
+ * The Sentry event for one report. Zero-PII by construction: no server name, no IP, no local
+ * variables, no URL or body; every string passes the scrubber; tags are allow-listed and short.
+ */
+export function buildEvent(report, ctx) {
+    const thrown = report.error !== undefined
+        ? describeThrown(report.error, ctx.scrub)
+        : {
+            type: report.type ?? report.source,
+            value: headline(scrubText(report.message ?? '', ctx.scrub)) || report.source,
+        };
+    const frames = 'stack' in thrown ? parseStack(thrown.stack) : [];
+    const tags = {
+        ...sanitizeTags({
+            core_version: ctx.coreVersion,
+            arch: ctx.arch,
+            owner_scope: ctx.ownerScope,
+            host: ctx.host,
+            host_version: ctx.hostVersion,
+            cpu_model: ctx.system?.cpuModel,
+            system_ram_mb: ctx.system?.memoryMb,
+        }),
+        ...ctx.appTags,
+        ...sanitizeTags({ source: report.source, ...report.tags }, { scrub: ctx.scrub }),
+    };
+    const extra = {};
+    for (const [key, value] of Object.entries(report.extra ?? {})) {
+        extra[key] = scrubText(value, ctx.scrub).slice(0, MAX_EXTRA);
+    }
+    return {
+        event_id: ctx.eventId,
+        timestamp: ctx.timestamp,
+        platform: 'node',
+        level: report.level,
+        logger: 'atomic-chat-core',
+        release: ctx.config.release,
+        ...(ctx.config.dist ? { dist: ctx.config.dist } : {}),
+        environment: ctx.config.environment,
+        sdk: { name: 'atomic-chat-core.telemetry', version: ctx.coreVersion },
+        user: { ...(ctx.userId ? { id: ctx.userId } : {}), ip_address: null },
+        contexts: {
+            os: { name: ctx.platform, ...(ctx.system?.osRelease ? { version: ctx.system.osRelease } : {}) },
+            device: {
+                arch: ctx.arch,
+                ...(ctx.system?.memoryMb ? { memory_size: ctx.system.memoryMb * 1024 * 1024 } : {}),
+            },
+        },
+        tags,
+        ...(report.fingerprint ? { fingerprint: report.fingerprint } : {}),
+        exception: {
+            values: [
+                {
+                    type: thrown.type,
+                    value: thrown.value,
+                    mechanism: { type: report.source, handled: report.level !== 'fatal' },
+                    ...(frames.length ? { stacktrace: { frames } } : {}),
+                },
+            ],
+        },
+        ...(ctx.breadcrumbs.length
+            ? { breadcrumbs: { values: ctx.breadcrumbs.map((b) => ({ ...b, category: 'log' })) } }
+            : {}),
+        ...(Object.keys(extra).length ? { extra } : {}),
+    };
+}
+/** A single-event envelope: envelope header, item header, payload, newline-separated. */
+export function buildEnvelope(event, dsn, sentAt) {
+    const header = JSON.stringify({ event_id: event.event_id, sent_at: sentAt.toISOString(), dsn: dsn.dsn });
+    return `${header}\n${JSON.stringify({ type: 'event' })}\n${JSON.stringify(event)}\n`;
+}
+/** The `X-Sentry-Auth` header of an envelope POST. */
+export function authHeader(dsn, version) {
+    return `Sentry sentry_version=7, sentry_client=atomic-chat-core/${version}, sentry_key=${dsn.publicKey}`;
+}
+//# sourceMappingURL=envelope.js.map

package/dist/telemetry/envelope.js.map

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

package/dist/telemetry/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Error reporting to the core's own Sentry project (`atomic-chat-core`), with the app's zero-PII
+ * doctrine and its `productAnalytic` consent. See docs/decisions/*-report-core-errors-to-its-own-sentry-project.md.
+ */
+export * from './types.js';
+export * from './config.js';
+export * from './dsn.js';
+export * from './scrub.js';
+export * from './stack.js';
+export * from './policy.js';
+export * from './reports.js';
+export * from './envelope.js';
+export * from './reporter.js';
+export * from './daemon.js';
+export * from './subscribe.js';
+export * from './consent.js';
+export * from './store.js';
+export * from './core-reporter.js';

package/dist/telemetry/index.js

@@ -0,0 +1,19 @@
+/**
+ * Error reporting to the core's own Sentry project (`atomic-chat-core`), with the app's zero-PII
+ * doctrine and its `productAnalytic` consent. See docs/decisions/*-report-core-errors-to-its-own-sentry-project.md.
+ */
+export * from './types.js';
+export * from './config.js';
+export * from './dsn.js';
+export * from './scrub.js';
+export * from './stack.js';
+export * from './policy.js';
+export * from './reports.js';
+export * from './envelope.js';
+export * from './reporter.js';
+export * from './daemon.js';
+export * from './subscribe.js';
+export * from './consent.js';
+export * from './store.js';
+export * from './core-reporter.js';
+//# sourceMappingURL=index.js.map

package/dist/telemetry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/telemetry/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,UAAU,CAAA;AACxB,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,eAAe,CAAA;AAC7B,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,oBAAoB,CAAA"}

package/dist/telemetry/policy.d.ts

@@ -0,0 +1,39 @@
+import type { ScrubContext } from './scrub.js';
+/**
+ * Tags the app may attach (`toSentryTags` + `SENTRY_TAG_KEYS` in the web app's
+ * `AnalyticProvider.tsx`): the same zero-PII hardware and backend context its own projects carry.
+ */
+export declare const APP_TAG_KEYS: ReadonlySet<string>;
+/**
+ * Tags as Sentry takes them: valid keys only (and only allowed ones, when a list is given), values
+ * stringified, scrubbed, single-line and short. Empty values are dropped.
+ */
+export declare function sanitizeTags(tags: Record<string, unknown> | undefined, options?: {
+    allow?: ReadonlySet<string>;
+    scrub?: ScrubContext;
+}): Record<string, string>;
+/**
+ * The few lines of engine output worth a report: marker lines only, never anything that may quote the
+ * user's content (sd-server always runs with `-v`, and llama-server can be made verbose), capped in
+ * count and size, newest kept, scrubbed.
+ */
+export declare function markerLines(text: string | undefined, options?: {
+    maxLines?: number;
+    maxBytes?: number;
+    scrub?: ScrubContext;
+}): string | undefined;
+/** A code worth a tag: the core's SCREAMING_SNAKE codes and Node's `E…` codes. */
+export declare function errorCodeOf(error: unknown): string | undefined;
+/** The user (or a caller) stopped the operation: the feature working, not a defect. */
+export declare function isCancellation(error: unknown): boolean;
+/** A client that went away mid-request: its socket, not our code. */
+export declare function isClientAbort(error: unknown): boolean;
+/**
+ * Causes that live in the user's environment rather than in our code (the web app's
+ * `ENVIRONMENT_FAILURE_CODES`): counted, but at `warning`, so they do not compete with crashes.
+ */
+export declare const ENVIRONMENT_FAILURE_CODES: ReadonlySet<string>;
+/** Where an out-of-memory failure happened (the web app's `oomSubtype`). */
+export declare function oomSubtype(text: string | undefined): string | undefined;
+/** The quantisation named in a model id (the web app's `quantFromModelId`). */
+export declare function quantOf(modelId: string | undefined): string | undefined;

package/dist/telemetry/policy.js

@@ -0,0 +1,142 @@
+import { scrubText } from './scrub.js';
+/**
+ * Tags the app may attach (`toSentryTags` + `SENTRY_TAG_KEYS` in the web app's
+ * `AnalyticProvider.tsx`): the same zero-PII hardware and backend context its own projects carry.
+ */
+export const APP_TAG_KEYS = new Set([
+    'app_version',
+    'platform',
+    'os',
+    'os_build',
+    'arch',
+    'cpu_avx',
+    'gpu_vendor',
+    'gpu_model',
+    'vram_mb',
+    'system_ram_mb',
+    'nvidia_driver_version',
+    'cuda_runtime_version',
+    'vulkan_version',
+    'active_backend',
+    'device_backend_pref',
+    'recommended_backend',
+    'installer_type',
+]);
+const TAG_KEY_RE = /^[a-z][a-z0-9_.]{0,31}$/;
+const MAX_TAG_VALUE = 100;
+/**
+ * Tags as Sentry takes them: valid keys only (and only allowed ones, when a list is given), values
+ * stringified, scrubbed, single-line and short. Empty values are dropped.
+ */
+export function sanitizeTags(tags, options = {}) {
+    const out = {};
+    for (const [key, raw] of Object.entries(tags ?? {})) {
+        if (!TAG_KEY_RE.test(key) || (options.allow && !options.allow.has(key)))
+            continue;
+        if (raw === undefined || raw === null || typeof raw === 'object' || typeof raw === 'function')
+            continue;
+        const value = scrubText(String(raw), options.scrub)
+            .replace(/[\r\n\t]+/g, ' ')
+            .trim()
+            .slice(0, MAX_TAG_VALUE);
+        if (value)
+            out[key] = value;
+    }
+    return out;
+}
+/** Lines of engine output that say what went wrong, as opposed to what it was doing. */
+const MARKER_RE = /GGML_ASSERT|\berror\b|\babort|\bassert|\bfailed\b|\bfailure\b|\bfatal\b|\bpanic|out of memory|\boom\b|cuda|metal|vulkan|segmentation|exception|\bcannot\b|\bunable\b/i;
+/** Lines that may carry what the user typed: prompts, chat messages, raw JSON bodies. */
+const CONTENT_RE = /prompt|"content"|"messages"|\{"/i;
+/**
+ * The few lines of engine output worth a report: marker lines only, never anything that may quote the
+ * user's content (sd-server always runs with `-v`, and llama-server can be made verbose), capped in
+ * count and size, newest kept, scrubbed.
+ */
+export function markerLines(text, options = {}) {
+    if (!text)
+        return undefined;
+    const maxLines = options.maxLines ?? 20;
+    const maxBytes = options.maxBytes ?? 2048;
+    const lines = text
+        .split(/\r?\n/)
+        .map((line) => line.trim())
+        .filter((line) => line && MARKER_RE.test(line) && !CONTENT_RE.test(line))
+        .map((line) => scrubText(line.length > 300 ? `${line.slice(0, 299)}…` : line, options.scrub));
+    const kept = [];
+    let bytes = 0;
+    for (let i = lines.length - 1; i >= 0 && kept.length < maxLines; i--) {
+        const line = lines[i];
+        if (bytes + line.length + 1 > maxBytes)
+            break;
+        kept.unshift(line);
+        bytes += line.length + 1;
+    }
+    return kept.length ? kept.join('\n') : undefined;
+}
+/** A code worth a tag: the core's SCREAMING_SNAKE codes and Node's `E…` codes. */
+export function errorCodeOf(error) {
+    const code = error?.code;
+    return typeof code === 'string' && /^[A-Z][A-Z0-9_]{1,63}$/.test(code) ? code : undefined;
+}
+const CANCELLATION_CODES = new Set(['MODEL_LOAD_CANCELLED', 'CANCELLED', 'AUTH_CANCELLED', 'ABORT_ERR']);
+/** The user (or a caller) stopped the operation: the feature working, not a defect. */
+export function isCancellation(error) {
+    const code = errorCodeOf(error);
+    if (code && CANCELLATION_CODES.has(code))
+        return true;
+    return error?.name === 'AbortError';
+}
+const CLIENT_ABORT_CODES = new Set([
+    'ECONNRESET',
+    'EPIPE',
+    'ECONNABORTED',
+    'ERR_STREAM_PREMATURE_CLOSE',
+    'ERR_STREAM_DESTROYED',
+    'ERR_STREAM_WRITE_AFTER_END',
+]);
+/** A client that went away mid-request: its socket, not our code. */
+export function isClientAbort(error) {
+    const code = errorCodeOf(error);
+    return (code !== undefined && CLIENT_ABORT_CODES.has(code)) || isCancellation(error);
+}
+/**
+ * Causes that live in the user's environment rather than in our code (the web app's
+ * `ENVIRONMENT_FAILURE_CODES`): counted, but at `warning`, so they do not compete with crashes.
+ */
+export const ENVIRONMENT_FAILURE_CODES = new Set([
+    'OUT_OF_MEMORY',
+    'MODEL_FILE_NOT_FOUND',
+    'MODEL_FILE_CORRUPT',
+    'MODEL_SHARDS_INCOMPLETE',
+    'MODEL_ARCH_NOT_SUPPORTED',
+    'MODEL_LOAD_TIMED_OUT',
+    'MULTIMODAL_PROJECTOR_LOAD_FAILED',
+    'BINARY_NOT_FOUND',
+    'LIBRARY_PATH_INVALID',
+    'OS_VERSION_UNSUPPORTED',
+    'CPU_NO_AVX',
+    'IO_ERROR',
+    'INVALID_ARGUMENT',
+]);
+/** Where an out-of-memory failure happened (the web app's `oomSubtype`). */
+export function oomSubtype(text) {
+    if (!text)
+        return undefined;
+    const t = text.toLowerCase();
+    if (t.includes('cuda'))
+        return 'cuda';
+    if (t.includes('vulkan') || t.includes('vk_error'))
+        return 'vulkan';
+    if (t.includes('metal') || t.includes('iogpu') || t.includes('mtl'))
+        return 'metal';
+    if (t.includes('host') || t.includes('system memory') || t.includes('requires more ram'))
+        return 'host_ram';
+    return 'unknown';
+}
+/** The quantisation named in a model id (the web app's `quantFromModelId`). */
+export function quantOf(modelId) {
+    const match = modelId?.match(/\b(IQ\d+_[A-Z0-9]+|Q\d+_[A-Z0-9_]+|Q\d+|MXFP\d+|\d+bit|bf16|fp16|fp8|f16|f32)\b/i);
+    return match?.[1];
+}
+//# sourceMappingURL=policy.js.map

package/dist/telemetry/policy.js.map

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

package/dist/telemetry/reporter.d.ts

@@ -0,0 +1,80 @@
+import type { TelemetryConfig } from './config.js';
+import type { SystemContext } from './envelope.js';
+import type { ScrubContext } from './scrub.js';
+import type { TelemetryState } from '../contracts/index.js';
+import type { ErrorReport, TelemetryControl, TelemetryUpdate } from './types.js';
+/** An identical event inside this window is one event (the app's `EVENT_DEDUP_WINDOW`). */
+export declare const DEDUP_WINDOW_MS = 60000;
+/** Reports per fingerprint per hour, and in total: a runaway loop must not drain the quota. */
+export declare const PER_ISSUE_HOURLY_CAP = 5;
+export declare const TOTAL_HOURLY_CAP = 50;
+export interface ErrorReporterOptions {
+    /** Null when this build or environment reports nowhere; consent is still tracked for the host. */
+    config: TelemetryConfig | null;
+    coreVersion: string;
+    platform: NodeJS.Platform;
+    arch: string;
+    ownerScope?: 'app' | 'cli' | undefined;
+    /** Who embeds the core: `atomic-chat` (the app's daemon), `cli`, `library`, or a host's own name. */
+    host?: string | undefined;
+    hostVersion?: string | undefined;
+    /** The host's consent at start-up (`daemon --telemetry on|off`, `AtomicCore.create`); later `update`s replace it. */
+    enabled?: boolean | undefined;
+    /** What the environment says (`DO_NOT_TRACK`, `ATOMIC_CORE_TELEMETRY`), see `envConsent`. */
+    envConsent?: boolean | undefined;
+    /** The user's stored choice (`atomic-chat-core telemetry on|off`). */
+    storedConsent?: boolean | undefined;
+    /** The anonymous install id of this data folder: the user when no host names one. */
+    installId?: string | undefined;
+    /** What the core knows of the machine by itself, so a report is useful without a host's tags. */
+    system?: SystemContext | undefined;
+    scrub?: ScrubContext | undefined;
+    fetch?: typeof fetch | undefined;
+    now?: (() => number) | undefined;
+    newEventId?: (() => string) | undefined;
+    /** Where a failed send is mentioned; never back into the reporter. */
+    onSendError?: ((message: string) => void) | undefined;
+}
+/**
+ * Sends error reports to the core's Sentry project, by hand-built envelopes over `fetch` — no SDK:
+ * `@sentry/node` needs loader hooks a single-file binary cannot offer, and the core adds no runtime
+ * dependencies. Fire-and-forget: a reporting outage never reaches the caller. Nothing leaves without
+ * consent; repeats are collapsed and a crash loop is capped.
+ */
+export declare class ErrorReporter implements TelemetryControl {
+    private readonly options;
+    private readonly fetchImpl;
+    private readonly now;
+    private readonly newEventId;
+    private hostConsent;
+    private userId;
+    private appTags;
+    private scrub;
+    private readonly breadcrumbs;
+    private readonly throttled;
+    private readonly lastSeen;
+    private readonly perIssue;
+    private total;
+    private blockedUntil;
+    private readonly pending;
+    constructor(options: ErrorReporterOptions);
+    private consent;
+    /** Apply what the host says: consent, its anonymous user id, its hardware tags. */
+    update(update: TelemetryUpdate): void;
+    setScrubContext(scrub: ScrubContext): void;
+    state(): TelemetryState;
+    /** A warn/error log line: the trail an event carries. */
+    breadcrumb(level: 'warning' | 'error', message: string): void;
+    capture(report: ErrorReport): void;
+    /** Wait for in-flight sends, at most `timeoutMs`. Never rejects. */
+    flush(timeoutMs?: number): Promise<void>;
+    private admitThrottle;
+    /** Dedup, per-issue and total hourly caps, and the server's own rate limit. */
+    private admit;
+    private send;
+}
+/**
+ * How long Sentry asked us to stay quiet: the error category of `X-Sentry-Rate-Limits`
+ * (`<seconds>:<categories>:<scope>, …`, an empty category list meaning all), else `Retry-After`.
+ */
+export declare function retryAfterMs(headers: Headers): number;

package/dist/telemetry/reporter.js.map

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

package/dist/telemetry/reports.d.ts

@@ -0,0 +1,68 @@
+/**
+ * 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 type { CoreEvents, LocalProviderId } from '../contracts/index.js';
+import type { ErrorReport, ErrorSink } from './types.js';
+/** Hand a report to the sink when there is one and the failure is worth reporting. */
+export declare function captureReport(sink: ErrorSink | undefined, report: ErrorReport | null): void;
+/** A crash-looping engine is one report per model, code and window (the web app's throttle). */
+export declare const ENGINE_THROTTLE_MS: number;
+export type ProcessFailureSource = 'uncaught_exception' | 'unhandled_rejection' | 'startup' | 'event_listener';
+/** A throw nothing caught: the daemon dies (fatal), or an event listener lost one event (error). */
+export declare function processFailureReport(source: ProcessFailureSource, error: unknown, context?: {
+    event?: string;
+}): ErrorReport | null;
+/**
+ * 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 declare function internalErrorReport(input: {
+    source: 'control_route' | 'public_server';
+    error: unknown;
+    status: number;
+    route?: string;
+}): ErrorReport | null;
+/**
+ * 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 declare function sessionDeathReport(died: Pick<CoreEvents['session:died'], 'provider' | 'model_id' | 'exit_code' | 'signal' | 'message'>, platform: NodeJS.Platform): ErrorReport | null;
+/**
+ * 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 declare function loadFailureReport(input: {
+    provider: LocalProviderId;
+    modelId: string;
+    error: unknown;
+    overrides?: Record<string, unknown> | undefined;
+    isEmbedding?: boolean | undefined;
+}): ErrorReport | null;
+/**
+ * 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 declare const RECOVERABLE_DIFFUSION_CODES: ReadonlySet<string>;
+/** sd.cpp failing to load a model (`load`) or to finish an image (`job`). */
+export declare function diffusionFailureReport(input: {
+    phase: 'load' | 'job';
+    error: unknown;
+    family?: string | undefined;
+    engine?: string | undefined;
+}): ErrorReport | null;
+/**
+ * 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 declare function inferenceFailureReport(input: {
+    provider: LocalProviderId;
+    modelId: string;
+    status: number;
+    body: string;
+    compute: boolean;
+    oom: boolean;
+}): ErrorReport | null;