@vibesdotdev/logging 0.0.1 → 1.0.0-rc.4

package/dist/observability/http/instrumented-fetch.js

@@ -0,0 +1,175 @@
+/**
+ * Instrumented Fetch for External API Calls
+ *
+ * Wraps fetch calls with OpenTelemetry spans to track external API dependencies
+ */
+import { getLogger } from "../../contexts/logger.js";
+import * as z from 'zod/v4';
+import { RedactedEndpointSchema, UNSCRUBBABLE_FAILURE_MESSAGE, UNSCRUBBABLE_TEXT, createEndpointFailureSchema, createEndpointTextSchema } from "../../core/endpoint.js";
+import { attempt } from "../../core/outcome.js";
+import { valueFreeFailureSchema } from "../../core/redact.js";
+/** A response's `content-length` as the byte count it states; anything else (absent, or not digits) is 0. */
+const ContentLengthSchema = z.string().regex(/^\d+$/).transform(Number).catch(0);
+/**
+ * The request's headers, built once, before anything is sent, the way `fetch`
+ * itself builds them (`new Headers(init.headers)`, else the `Request`'s own),
+ * and every value as `fetch` would send it: a value is converted to its text
+ * however the caller wrote it (an array, an object with `toString`, a
+ * `[name, value]` pair, an iterable), so the failure description removes each
+ * one. The same `Headers` is what is sent, so a one-shot iterable is read once.
+ * When building them throws (a value the platform refuses, a getter, a trap),
+ * the failure is that throw and is described value-free: what it says may echo
+ * a value that was never read.
+ */
+function readRequestHeaders(input, init) {
+    return attempt(() => {
+        const own = input instanceof Request ? input.headers : undefined;
+        const headers = new Headers(init?.headers ?? own);
+        return { headers, values: [...(own ? [...own.values()] : []), ...headers.values()] };
+    });
+}
+/** Every header value a request carries (see {@link readRequestHeaders}); `null` when they could not be read. */
+function requestHeaderValues(input, init) {
+    const read = readRequestHeaders(input, init);
+    return read.failed ? null : read.value.values;
+}
+/** Text the peer controls (a reason phrase), scrubbed of the URL's credentials and the request's header values; none of it when those could not be read. */
+function peerText(url, headerValues, text) {
+    return headerValues === null ? UNSCRUBBABLE_TEXT : createEndpointTextSchema(url, headerValues).parse(text);
+}
+/** Describes a failure with the URL's credentials and every request header value removed; value-free when the header values could not be read. */
+function createRequestFailureSchema(url, headerValues) {
+    return headerValues === null ? valueFreeFailureSchema(UNSCRUBBABLE_FAILURE_MESSAGE) : createEndpointFailureSchema(url, headerValues);
+}
+/**
+ * Instrumented fetch that creates spans for external API calls and reports them through `runtime`'s logger
+ */
+export async function instrumentedFetch(runtime, input, init) {
+    const logger = getLogger('http-client', runtime);
+    // The module system memoizes the import; a failure to load propagates to the caller.
+    const otel = await import('@opentelemetry/api');
+    const tracer = otel.trace.getTracer('http-client');
+    const url = input instanceof Request ? input.url : input instanceof URL ? input.href : input;
+    // What is logged or attributed about the URL: never its userinfo or query, which may carry credentials.
+    const echoedUrl = RedactedEndpointSchema.parse(url);
+    const method = init?.method || 'GET';
+    // Read once, before the request is sent: a header value the platform refuses must still be scrubbed from the failure it causes.
+    const requestHeaders = readRequestHeaders(input, init);
+    const headerValues = requestHeaders.failed ? null : requestHeaders.value.values;
+    // Host for span naming; an unparseable URL is named 'unknown'
+    const hostname = URL.canParse(url) ? new URL(url).hostname : 'unknown';
+    return tracer.startActiveSpan(`HTTP ${method} ${hostname}`, {
+        kind: otel.SpanKind.CLIENT,
+        attributes: {
+            'http.method': method,
+            'http.url': echoedUrl,
+            'http.target': hostname,
+            'http.scheme': url.startsWith('https') ? 'https' : 'http',
+            component: 'fetch',
+            'span.kind': 'client'
+        }
+    }, async (span) => {
+        const startTime = performance.now();
+        try {
+            // The headers fetch would have refused fail the call here, with the platform's own error.
+            if (requestHeaders.failed)
+                throw requestHeaders.cause;
+            // Add trace context to the headers that were read (the same object is sent) for distributed tracing
+            const headers = requestHeaders.value.headers;
+            // Get current trace context
+            const spanContext = span.spanContext();
+            headers.set('traceparent', `00-${spanContext.traceId}-${spanContext.spanId}-01`);
+            // Make the actual fetch call
+            const response = await fetch(input, {
+                ...init,
+                headers
+            });
+            const duration = performance.now() - startTime;
+            // Add response attributes
+            // Response headers and the reason phrase are the peer's text: a length is a count or 0, and the reason phrase is scrubbed.
+            span.setAttributes({
+                'http.status_code': response.status,
+                'http.response_content_length': ContentLengthSchema.parse(response.headers.get('content-length')),
+                'http.duration_ms': duration
+            });
+            // Set span status based on HTTP status
+            if (response.status >= 400) {
+                span.setStatus({
+                    code: otel.SpanStatusCode.ERROR,
+                    message: `HTTP ${response.status}: ${peerText(url, headerValues, response.statusText)}`
+                });
+            }
+            else {
+                span.setStatus({ code: otel.SpanStatusCode.OK });
+            }
+            // Log the external API call
+            const level = response.status >= 500 ? 'error' : response.status >= 400 ? 'warn' : 'debug';
+            logger[level](`External API call: ${method} ${hostname}`, {
+                method,
+                url: echoedUrl,
+                status: response.status,
+                duration,
+                traceId: spanContext.traceId,
+                spanId: spanContext.spanId,
+                category: 'external-api'
+            });
+            return response;
+        }
+        catch (error) {
+            // Record the exception, described with the URL's credentials and every request header value removed from
+            // every text it carries (the runtime's own error may repeat the userinfo, or a header value it refused).
+            const failure = createRequestFailureSchema(url, headerValues).parse(error);
+            span.recordException({ name: failure.name, message: failure.message, stack: failure.stack });
+            span.setStatus({
+                code: otel.SpanStatusCode.ERROR,
+                message: failure.message
+            });
+            logger.error(`External API call failed: ${method} ${hostname}`, {
+                error: failure,
+                method,
+                url: echoedUrl,
+                category: 'external-api'
+            });
+            throw error;
+        }
+        finally {
+            span.end();
+        }
+    });
+}
+/**
+ * Helper function for JSON API calls with instrumentation
+ */
+export async function instrumentedJsonFetch(runtime, url, options) {
+    // Add query params if provided
+    let finalUrl = url;
+    if (options?.params) {
+        const params = new URLSearchParams(options.params);
+        finalUrl = `${url}?${params.toString()}`;
+    }
+    // The request's own bound, combined with (never replacing) the caller's
+    // signal. The platform timeout signal holds no timer the caller must clear.
+    const signals = [options?.signal, options?.timeout ? AbortSignal.timeout(options.timeout) : undefined].filter((signal) => signal instanceof AbortSignal);
+    const requestInit = {
+        ...options,
+        headers: {
+            'Content-Type': 'application/json',
+            Accept: 'application/json',
+            ...options?.headers
+        }
+    };
+    if (signals.length > 0) {
+        requestInit.signal = signals.length === 1 ? signals[0] : AbortSignal.any(signals);
+    }
+    const response = await instrumentedFetch(runtime, finalUrl, requestInit);
+    if (!response.ok) {
+        // The reason phrase is the peer's text and may echo the request URL's credentials: the caller's failure carries it scrubbed.
+        throw new Error(`HTTP ${response.status}: ${peerText(finalUrl, requestHeaderValues(finalUrl, requestInit), response.statusText)}`);
+    }
+    // SAFETY: this helper's contract is that the caller's T names the endpoint's
+    // JSON response body; the body is decoded here and T is not re-validated.
+    return (await response.json());
+}
+// Default export: the instrumented fetch (it takes the Runtime whose logger reports the call first)
+export default instrumentedFetch;
+//# sourceMappingURL=instrumented-fetch.js.map

package/dist/observability/http/instrumented-fetch.js.map

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

package/dist/observability/index.d.ts

@@ -0,0 +1,8 @@
+export { initializeTelemetry, isTelemetryInitialized, shutdownTelemetry, getTelemetryStatus, getTelemetryInitializationOutcome, type TelemetryInitializationOutcome, type TelemetryHeadersSource } from './telemetry/otel.ts';
+export { TELEMETRY_INSTRUMENTATION_KIND, TelemetryInstrumentationDescriptorSchema, resolveTelemetryInstrumentation, resolveComposedTelemetryInstrumentations, telemetryInstrumentationKind, type TelemetryInstrumentationDescriptor, type TelemetryInstrumentationFactory, type TelemetryRuntimeQuery } from './telemetry-instrumentation.ts';
+export { disposeObservability } from './lifecycle.ts';
+export { ErrorTracker } from './observability/error-tracker.ts';
+export type { ErrorDetails } from './observability/error-tracker.ts';
+export { instrumentedFetch, instrumentedJsonFetch } from './http/instrumented-fetch.ts';
+export { default as instrumentedFetchDefault } from './http/instrumented-fetch.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/observability/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/observability/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,iCAAiC,EAAE,KAAK,8BAA8B,EAAE,KAAK,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC9N,OAAO,EACN,8BAA8B,EAC9B,wCAAwC,EACxC,+BAA+B,EAC/B,wCAAwC,EACxC,4BAA4B,EAC5B,KAAK,kCAAkC,EACvC,KAAK,+BAA+B,EACpC,KAAK,qBAAqB,EAC1B,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAChE,YAAY,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACxF,OAAO,EAAE,OAAO,IAAI,wBAAwB,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/observability/index.js

@@ -0,0 +1,10 @@
+export { initializeTelemetry, isTelemetryInitialized, shutdownTelemetry, getTelemetryStatus, getTelemetryInitializationOutcome } from "./telemetry/otel.js";
+export { TELEMETRY_INSTRUMENTATION_KIND, TelemetryInstrumentationDescriptorSchema, resolveTelemetryInstrumentation, resolveComposedTelemetryInstrumentations, telemetryInstrumentationKind } from "./telemetry-instrumentation.js";
+export { disposeObservability } from "./lifecycle.js";
+export { ErrorTracker } from "./observability/error-tracker.js";
+export { instrumentedFetch, instrumentedJsonFetch } from "./http/instrumented-fetch.js";
+export { default as instrumentedFetchDefault } from "./http/instrumented-fetch.js";
+// Vendor observability clients live in their integrations (RC09):
+// `@vibesdotdev/integrations-signoz`, `-clickhouse` and `-redis`. They read
+// their settings and credentials through `@vibesdotdev/logging/observability/config`.
+//# sourceMappingURL=index.js.map

package/dist/observability/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/observability/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,iCAAiC,EAAoE,MAAM,qBAAqB,CAAC;AAC9N,OAAO,EACN,8BAA8B,EAC9B,wCAAwC,EACxC,+BAA+B,EAC/B,wCAAwC,EACxC,4BAA4B,EAI5B,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAEhE,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACxF,OAAO,EAAE,OAAO,IAAI,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AAEnF,kEAAkE;AAClE,4EAA4E;AAC5E,sFAAsF"}

package/dist/observability/lifecycle.d.ts

@@ -0,0 +1,18 @@
+import type { RuntimeRef } from '@vibesdotdev/kernel';
+interface NamedDisposer {
+    name: string;
+    dispose(): Promise<void>;
+}
+export declare function disposeNamedResources(disposers: readonly NamedDisposer[]): Promise<void>;
+/**
+ * Dispose this Root's OpenTelemetry without assuming ownership of the
+ * process. Executable hosts call this from their lifecycle coordinator;
+ * runtime-backed hosts attach it to their owning plugin's `onDispose`. Vendor
+ * clients own their own disposal: `@vibesdotdev/integrations-redis` closes its
+ * connections from its plugin's `onDispose` (and exports
+ * `disposeRedisConnections`). Concurrent calls for one Root (the Root, its
+ * views or generations) share one disposal; another Root's is independent.
+ */
+export declare function disposeObservability(runtime: RuntimeRef): Promise<void>;
+export {};
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/observability/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/observability/lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAKtD,UAAU,aAAa;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB;AAKD,wBAAsB,qBAAqB,CAAC,SAAS,EAAE,SAAS,aAAa,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAiB9F;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAavE"}

package/dist/observability/lifecycle.js

@@ -0,0 +1,44 @@
+import { shutdownRuntimeTelemetry } from "./telemetry/telemetry-root.js";
+import { loggingRootOf } from "../core/root-identity.js";
+/** In-flight disposals per Root (`loggingRootOf(runtime)`): telemetry is the Root's, so its runtimes share one. */
+const disposals = new WeakMap();
+export async function disposeNamedResources(disposers) {
+    const results = await Promise.allSettled(disposers.map(({ dispose }) => dispose()));
+    const failures = results.flatMap((result, index) => {
+        if (result.status === 'fulfilled')
+            return [];
+        const name = disposers[index]?.name ?? `resource-${index + 1}`;
+        return [
+            new Error(`Failed to dispose observability resource '${name}'`, {
+                cause: result.reason
+            })
+        ];
+    });
+    if (failures.length > 0) {
+        throw new AggregateError(failures, `Observability disposal failed for ${failures.length} resource${failures.length === 1 ? '' : 's'}`);
+    }
+}
+/**
+ * Dispose this Root's OpenTelemetry without assuming ownership of the
+ * process. Executable hosts call this from their lifecycle coordinator;
+ * runtime-backed hosts attach it to their owning plugin's `onDispose`. Vendor
+ * clients own their own disposal: `@vibesdotdev/integrations-redis` closes its
+ * connections from its plugin's `onDispose` (and exports
+ * `disposeRedisConnections`). Concurrent calls for one Root (the Root, its
+ * views or generations) share one disposal; another Root's is independent.
+ */
+export function disposeObservability(runtime) {
+    const root = loggingRootOf(runtime);
+    const pending = disposals.get(root);
+    if (pending)
+        return pending;
+    const disposeOperation = disposeNamedResources([
+        { name: 'opentelemetry', dispose: () => shutdownRuntimeTelemetry(runtime) }
+    ]).finally(() => {
+        if (disposals.get(root) === disposeOperation)
+            disposals.delete(root);
+    });
+    disposals.set(root, disposeOperation);
+    return disposeOperation;
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/observability/lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../../src/observability/lifecycle.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAQzD,mHAAmH;AACnH,MAAM,SAAS,GAAG,IAAI,OAAO,EAAsC,CAAC;AAEpE,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,SAAmC;IAC9E,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IACpF,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;QAClD,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW;YAAE,OAAO,EAAE,CAAC;QAC7C,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,EAAE,IAAI,IAAI,YAAY,KAAK,GAAG,CAAC,EAAE,CAAC;QAC/D,OAAO;YACN,IAAI,KAAK,CAAC,6CAA6C,IAAI,GAAG,EAAE;gBAC/D,KAAK,EAAE,MAAM,CAAC,MAAM;aACpB,CAAC;SACF,CAAC;IACH,CAAC,CAAC,CAAC;IACH,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,cAAc,CACvB,QAAQ,EACR,qCAAqC,QAAQ,CAAC,MAAM,YAAY,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAClG,CAAC;IACH,CAAC;AACF,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAmB;IACvD,MAAM,IAAI,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IACpC,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,OAAO;QAAE,OAAO,OAAO,CAAC;IAE5B,MAAM,gBAAgB,GAAG,qBAAqB,CAAC;QAC9C,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,wBAAwB,CAAC,OAAO,CAAC,EAAE;KAC3E,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE;QACf,IAAI,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,gBAAgB;YAAE,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC;IACtC,OAAO,gBAAgB,CAAC;AACzB,CAAC"}

package/dist/observability/observability/error-tracker.d.ts

@@ -0,0 +1,43 @@
+import type { RuntimeRef } from '@vibesdotdev/kernel';
+import type { LogContext } from '../../schemas/entry.ts';
+export interface ErrorDetails {
+    message: string;
+    stack?: string;
+    /** Logged with the error, so it takes the logger's own context contract. */
+    context?: LogContext;
+}
+/** Windowed error counts, as `ErrorTracker.getStats()` reports them. */
+export interface ErrorTrackerStats {
+    errorTypes: string[];
+    totalErrors: number;
+    recentErrors: {
+        [key: string]: number;
+    };
+}
+/** The error type a tracked error counts under when its `errorType` is not a string. */
+export declare const UNTYPED_ERROR = "untyped";
+/** What a tracked error's `loggingError` says when its `errorType` is not a string: never the value. */
+export declare const ERROR_TYPE_NOT_TEXT_MESSAGE = "A tracked error's type must be a string; it is counted as 'untyped'.";
+export declare class ErrorTracker {
+    private static readonly ALERT_THRESHOLD;
+    private static readonly ALERT_WINDOW;
+    private static readonly ALERT_COOLDOWN;
+    /**
+     * Track an error occurrence on this Runtime
+     */
+    static trackError(runtime: RuntimeRef, errorType: string, details: ErrorDetails): Promise<void>;
+    private static record;
+    /**
+     * Send an alert for repeated errors
+     */
+    private static sendAlert;
+    /**
+     * Get this Runtime's current error statistics
+     */
+    static getStats(runtime: RuntimeRef): ErrorTrackerStats;
+    /**
+     * Reset this Runtime's error counts (for testing)
+     */
+    static reset(runtime: RuntimeRef): void;
+}
+//# sourceMappingURL=error-tracker.d.ts.map

package/dist/observability/observability/error-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-tracker.d.ts","sourceRoot":"","sources":["../../../src/observability/observability/error-tracker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAQtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAIzD,MAAM,WAAW,YAAY;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,OAAO,CAAC,EAAE,UAAU,CAAC;CACrB;AAED,wEAAwE;AACxE,MAAM,WAAW,iBAAiB;IACjC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;CACxC;AAYD,wFAAwF;AACxF,eAAO,MAAM,aAAa,YAAY,CAAC;AACvC,wGAAwG;AACxG,eAAO,MAAM,2BAA2B,yEAAkF,CAAC;AAa3H,qBAAa,YAAY;IAGxB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAK;IAC5C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAU;IAC9C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAU;IAEhD;;OAEG;WACU,UAAU,CAAC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;mBAoBhF,MAAM;IAuC3B;;OAEG;mBACkB,SAAS;IAsB9B;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,UAAU,GAAG,iBAAiB;IAwBvD;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI;CAMvC"}

package/dist/observability/observability/error-tracker.js

@@ -0,0 +1,130 @@
+import { getLogger } from "../../contexts/logger.js";
+import { createFallbackLogger } from "../../contexts/fallback-logger.js";
+import * as z from 'zod/v4';
+import { LoggedErrorSchema } from "../../core/redact.js";
+import { derivedLoggerMetadata, mergeCallContexts } from "../../core/entry-context.js";
+import { settle } from "../../core/outcome.js";
+import { loggingRootOf } from "../../core/root-identity.js";
+const trackers = new WeakMap();
+/** The error type a tracked error counts under when its `errorType` is not a string. */
+export const UNTYPED_ERROR = 'untyped';
+/** What a tracked error's `loggingError` says when its `errorType` is not a string: never the value. */
+export const ERROR_TYPE_NOT_TEXT_MESSAGE = `A tracked error's type must be a string; it is counted as '${UNTYPED_ERROR}'.`;
+/** A string, recognized by `typeof` alone: a schema's failure path would read a Proxy's prototype, which a trap throws from. */
+const ErrorTypeSchema = z.custom((value) => typeof value === 'string');
+function trackerFor(runtime) {
+    let state = trackers.get(loggingRootOf(runtime));
+    if (!state) {
+        state = { errorCounts: new Map(), lastAlertSent: new Map(), errorWindow: new Map() };
+        trackers.set(loggingRootOf(runtime), state);
+    }
+    return state;
+}
+export class ErrorTracker {
+    // Configuration
+    static ALERT_THRESHOLD = 5; // Number of errors before alerting
+    static ALERT_WINDOW = 300000; // 5 minutes
+    static ALERT_COOLDOWN = 300000; // 5 minutes between alerts
+    /**
+     * Track an error occurrence on this Runtime
+     */
+    static async trackError(runtime, errorType, details) {
+        const logger = getLogger('error-tracker', runtime);
+        // The caller's values are read once, through the log call's guarded context path: a getter or Proxy trap never
+        // throws into the caller, and what it threw is never described (it may carry the value); it rides as the `loggingError`.
+        const type = ErrorTypeSchema.safeParse(errorType);
+        const read = mergeCallContexts({}, details);
+        const failure = read.failure ?? (type.success ? undefined : { name: 'TypeError', message: ERROR_TYPE_NOT_TEXT_MESSAGE });
+        const recorded = await settle(this.record(logger, trackerFor(runtime), type.success ? type.data : UNTYPED_ERROR, derivedLoggerMetadata({ context: read.context, failure })));
+        // Error tracking never breaks the app: its own failure is reported, not rethrown.
+        if (!recorded.failed)
+            return;
+        const recordFailure = LoggedErrorSchema.parse(recorded.cause);
+        const reported = await settle(Promise.resolve().then(() => logger.error('Failed to track error', { errorType: type.success ? type.data : UNTYPED_ERROR, error: recordFailure })));
+        // The runtime's own logger is what failed: the host console is the report that remains.
+        if (reported.failed) {
+            (await createFallbackLogger('error-tracker', runtime)).error('Failed to track error, and its report through the runtime logger failed too', {
+                errorType: type.success ? type.data : UNTYPED_ERROR, error: recordFailure, reportError: LoggedErrorSchema.parse(reported.cause)
+            });
+        }
+    }
+    static async record(logger, tracker, errorType, details) {
+        const { errorWindow, errorCounts, lastAlertSent } = tracker;
+        const now = Date.now();
+        // Update error window
+        if (!errorWindow.has(errorType)) {
+            errorWindow.set(errorType, []);
+        }
+        const window = errorWindow.get(errorType);
+        window.push(now);
+        // Remove old entries outside the window
+        const cutoff = now - this.ALERT_WINDOW;
+        const filtered = window.filter((timestamp) => timestamp > cutoff);
+        errorWindow.set(errorType, filtered);
+        // Update total count
+        const count = (errorCounts.get(errorType) || 0) + 1;
+        errorCounts.set(errorType, count);
+        logger.warn('system.error', {
+            errorType,
+            ...details,
+            count,
+            recentCount: filtered.length
+        });
+        // Check if we should send alert
+        if (filtered.length >= this.ALERT_THRESHOLD) {
+            const lastAlert = lastAlertSent.get(errorType) || 0;
+            if (now - lastAlert > this.ALERT_COOLDOWN) {
+                await this.sendAlert(logger, errorType, filtered.length, details);
+                lastAlertSent.set(errorType, now);
+            }
+        }
+    }
+    /**
+     * Send an alert for repeated errors
+     */
+    static async sendAlert(logger, errorType, count, details) {
+        // Log alert
+        logger.error(`ALERT: ${errorType} occurred ${count} times in ${this.ALERT_WINDOW / 60000} minutes`, details);
+        logger.error('system.error.alert', {
+            errorType,
+            severity: 'critical',
+            alert: true,
+            count,
+            window: `${this.ALERT_WINDOW / 60000} minutes`,
+            ...details
+        });
+    }
+    /**
+     * Get this Runtime's current error statistics
+     */
+    static getStats(runtime) {
+        const { errorWindow, errorCounts } = trackerFor(runtime);
+        const now = Date.now();
+        const cutoff = now - this.ALERT_WINDOW;
+        const recentErrors = {};
+        let totalErrors = 0;
+        for (const [errorType, count] of errorCounts) {
+            totalErrors += count;
+            const window = errorWindow.get(errorType) || [];
+            const recent = window.filter((timestamp) => timestamp > cutoff).length;
+            if (recent > 0) {
+                recentErrors[errorType] = recent;
+            }
+        }
+        return {
+            errorTypes: Array.from(errorCounts.keys()),
+            totalErrors,
+            recentErrors
+        };
+    }
+    /**
+     * Reset this Runtime's error counts (for testing)
+     */
+    static reset(runtime) {
+        const { errorWindow, errorCounts, lastAlertSent } = trackerFor(runtime);
+        errorCounts.clear();
+        lastAlertSent.clear();
+        errorWindow.clear();
+    }
+}
+//# sourceMappingURL=error-tracker.js.map

package/dist/observability/observability/error-tracker.js.map

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

package/dist/observability/should-keep-log.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Only `info` is head-sampled (`infoSamplingRate`, the fraction of `info`
+ * entries kept). Every other level is always kept: 10% CF head sampling made
+ * production incidents invisible.
+ */
+export type SampledLogLevel = 'debug' | 'info' | 'warn' | 'error' | 'fatal';
+export declare function shouldKeepLog(level: SampledLogLevel, infoSamplingRate: number): boolean;
+//# sourceMappingURL=should-keep-log.d.ts.map

package/dist/observability/should-keep-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"should-keep-log.d.ts","sourceRoot":"","sources":["../../src/observability/should-keep-log.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAE5E,wBAAgB,aAAa,CAAC,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAKvF"}

package/dist/observability/should-keep-log.js

@@ -0,0 +1,10 @@
+export function shouldKeepLog(level, infoSamplingRate) {
+    if (level !== 'info')
+        return true;
+    if (!Number.isFinite(infoSamplingRate) || infoSamplingRate >= 1)
+        return true;
+    if (infoSamplingRate <= 0)
+        return false;
+    return Math.random() < infoSamplingRate;
+}
+//# sourceMappingURL=should-keep-log.js.map

package/dist/observability/should-keep-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"should-keep-log.js","sourceRoot":"","sources":["../../src/observability/should-keep-log.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,aAAa,CAAC,KAAsB,EAAE,gBAAwB;IAC7E,IAAI,KAAK,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IAClC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAC,IAAI,gBAAgB,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7E,IAAI,gBAAgB,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACxC,OAAO,IAAI,CAAC,MAAM,EAAE,GAAG,gBAAgB,CAAC;AACzC,CAAC"}

package/dist/observability/telemetry/otel.d.ts

@@ -0,0 +1,47 @@
+/**
+ * OpenTelemetry Configuration and Initialization
+ *
+ * This module initializes OpenTelemetry instrumentation for the application,
+ * providing tracing, metrics, and logs to SignOz/OTEL collectors.
+ */
+import { type RuntimeRef, type VibesRuntime } from '@vibesdotdev/kernel';
+import { resolveOtelHeaders, type TelemetryHeadersSource } from '../../core/otlp-headers.ts';
+export { resolveOtelHeaders, type TelemetryHeadersSource };
+import { type TelemetryInitializationOutcome } from './telemetry-root.ts';
+export type { TelemetryInitializationOutcome };
+import { type TelemetryRuntimeQuery } from '../telemetry-instrumentation.ts';
+/** The typed outcome of this Runtime's last `initializeTelemetry` call. */
+export declare function getTelemetryInitializationOutcome(runtime: RuntimeRef): TelemetryInitializationOutcome;
+/**
+ * Initialize OpenTelemetry SDK on the host `runtime`: its composed provider
+ * instrumentations (the `observability/telemetry-instrumentation` kind — AWS
+ * SDK, Redis/ioredis, …) are added beside the built-in HTTP/Express/PG/undici/
+ * gRPC ones.
+ */
+export declare function initializeTelemetry(runtime: TelemetryRuntimeQuery & VibesRuntime): Promise<void>;
+/**
+ * Whether this Runtime's telemetry SDK is running
+ */
+export declare function isTelemetryInitialized(runtime: RuntimeRef): boolean;
+/**
+ * Shut down this Runtime's telemetry (for testing, and for hosts' lifecycle
+ * coordinators). It ends the Runtime's claim on the process's OpenTelemetry
+ * registry; another Runtime's telemetry is untouched.
+ */
+export declare function shutdownTelemetry(runtime: RuntimeRef): Promise<void>;
+/**
+ * Get this Runtime's telemetry configuration and state (for diagnostics)
+ */
+export declare function getTelemetryStatus(runtime: VibesRuntime): Promise<{
+    initialized: boolean;
+    enabled: boolean;
+    outcome: TelemetryInitializationOutcome;
+    config: {
+        serviceName: string;
+        environment: string | undefined;
+        endpoint: string;
+        protocol: "grpc";
+        samplingRate: number;
+    };
+}>;
+//# sourceMappingURL=otel.d.ts.map

package/dist/observability/telemetry/otel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel.d.ts","sourceRoot":"","sources":["../../../src/observability/telemetry/otel.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAmB,KAAK,UAAU,EAAE,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAU1F,OAAO,EAAE,kBAAkB,EAAE,KAAK,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAE7F,OAAO,EAAE,kBAAkB,EAAE,KAAK,sBAAsB,EAAE,CAAC;AAM3D,OAAO,EAMN,KAAK,8BAA8B,EACnC,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,8BAA8B,EAAE,CAAC;AAC/C,OAAO,EAA4C,KAAK,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAsBvH,2EAA2E;AAC3E,wBAAgB,iCAAiC,CAAC,OAAO,EAAE,UAAU,GAAG,8BAA8B,CAErG;AAydD;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,qBAAqB,GAAG,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAmLtG;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAEnE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAEpE;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,YAAY;;;;;;;;;;;GAc7D"}