managed-deepagents 0.9.6-dev.15 → 0.9.6-dev.17

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

@@ -0,0 +1,57 @@
+/** Run metadata key that carries the trace id from ingress into the run. */
+export declare const TRACE_ID_METADATA_KEY = "mda_trace_id";
+export type LogSeverity = "INFO" | "WARN" | "ERROR";
+export type LogAttributeValue = string | number | boolean;
+export type LogAttributes = Record<string, LogAttributeValue>;
+export interface LogRecord {
+    /**
+     * Unique to this record and kept across retries, so copies of a batch sent
+     * twice can be told apart from distinct records.
+     */
+    uid: string;
+    timeUnixNano: string;
+    severity: LogSeverity;
+    body: string;
+    attributes: LogAttributes;
+    traceId: string;
+    spanId: string;
+}
+export interface LogContext {
+    traceId: string;
+    spanId: string;
+    /** Attached to every later record, so a fact learned mid-request sticks. */
+    attributes: LogAttributes;
+    /** Work that outlives the request; ingress completes after it settles. */
+    pending: Promise<unknown>[];
+}
+/** A fresh 16-byte trace id as 32 lowercase hex characters. */
+export declare function newTraceId(): string;
+/** A fresh 8-byte span id as 16 lowercase hex characters. */
+export declare function newSpanId(): string;
+/** The trace id of a W3C `traceparent` header, or a new one. */
+export declare function traceIdFromTraceparent(header: string | null | undefined): string;
+/** A trace id handed over through run metadata, or a new one. */
+export declare function traceIdFromMetadata(metadata: Record<string, unknown> | undefined): string;
+/** A new, empty log context for `traceId` with its own span id. */
+export declare function createLogContext(traceId: string): LogContext;
+/** Run `fn` inside `context`. */
+export declare function runInLogContext<T>(context: LogContext, fn: () => T): T;
+/** Run `fn` with a new log context for `traceId`. */
+export declare function withLogContext<T>(traceId: string, fn: (context: LogContext) => T): T;
+export declare function currentLogContext(): LogContext | undefined;
+/** Keep the current context open until `work` settles. */
+export declare function holdLogContext(work: Promise<unknown>): void;
+/** Add attributes to the current context's later records. */
+export declare function setLogAttributes(attributes: Record<string, LogAttributeValue | null | undefined>): void;
+/** OTel `exception.*` attributes for an error. */
+export declare function exceptionAttributes(error: unknown): LogAttributes;
+/**
+ * Queue a record under the current context's ids on the process-wide log
+ * sink, with the middle cut out of any string over the per-value limit. Does
+ * nothing outside a context or when the sink is disabled.
+ */
+export declare function recordLog(severity: LogSeverity, body: string, options?: {
+    error?: unknown;
+    attributes?: LogAttributes;
+}): void;
+//# sourceMappingURL=context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/telemetry/otel/context.ts"],"names":[],"mappings":"AAgBA,4EAA4E;AAC5E,eAAO,MAAM,qBAAqB,iBAAiB,CAAC;AAEpD,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AACpD,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAC1D,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;AAE9D,MAAM,WAAW,SAAS;IACxB;;;OAGG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,WAAW,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,aAAa,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,UAAU,EAAE,aAAa,CAAC;IAC1B,0EAA0E;IAC1E,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;CAC7B;AAWD,+DAA+D;AAC/D,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED,6DAA6D;AAC7D,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED,gEAAgE;AAChE,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAChC,MAAM,CAGR;AAED,iEAAiE;AACjE,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAC5C,MAAM,CAKR;AAED,mEAAmE;AACnE,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAO5D;AAED,iCAAiC;AACjC,wBAAgB,eAAe,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAEtE;AAED,qDAAqD;AACrD,wBAAgB,cAAc,CAAC,CAAC,EAC9B,OAAO,EAAE,MAAM,EACf,EAAE,EAAE,CAAC,OAAO,EAAE,UAAU,KAAK,CAAC,GAC7B,CAAC,CAGH;AAED,wBAAgB,iBAAiB,IAAI,UAAU,GAAG,SAAS,CAE1D;AAED,0DAA0D;AAC1D,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAE3D;AAED,6DAA6D;AAC7D,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,GAAG,SAAS,CAAC,GAC/D,IAAI,CAQN;AAED,kDAAkD;AAClD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,CAYjE;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CACvB,QAAQ,EAAE,WAAW,EACrB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,aAAa,CAAA;CAAO,GAC5D,IAAI,CAqBN"}

package/dist/telemetry/otel/context.js

@@ -0,0 +1,122 @@
+/**
+ * Per-request log context for the OTel log forwarder.
+ *
+ * Ingress and the run execute in different processes, so each holds its own
+ * context, and records go straight to the process-wide log sink stamped with
+ * that context's ids. Both share one trace id: ingress takes
+ * it from the incoming `traceparent` (or mints one) and hands it to the run as
+ * `config.metadata.mda_trace_id`. Each side gets its own span id so Datadog can
+ * tell which process wrote a record.
+ */
+import { AsyncLocalStorage } from "node:async_hooks";
+import { randomBytes, randomUUID } from "node:crypto";
+import { logSink } from "./exporter.js";
+import { truncateMiddle } from "./truncate.js";
+/** Run metadata key that carries the trace id from ingress into the run. */
+export const TRACE_ID_METADATA_KEY = "mda_trace_id";
+const storage = new AsyncLocalStorage();
+const TRACE_ID = /^[0-9a-f]{32}$/;
+const TRACEPARENT = /^[0-9a-f]{2}-([0-9a-f]{32})-[0-9a-f]{16}-[0-9a-f]{2}$/;
+function isValidTraceId(value) {
+    return TRACE_ID.test(value) && !/^0+$/.test(value);
+}
+/** A fresh 16-byte trace id as 32 lowercase hex characters. */
+export function newTraceId() {
+    return randomBytes(16).toString("hex");
+}
+/** A fresh 8-byte span id as 16 lowercase hex characters. */
+export function newSpanId() {
+    return randomBytes(8).toString("hex");
+}
+/** The trace id of a W3C `traceparent` header, or a new one. */
+export function traceIdFromTraceparent(header) {
+    const traceId = TRACEPARENT.exec(header?.trim().toLowerCase() ?? "")?.[1];
+    return traceId && isValidTraceId(traceId) ? traceId : newTraceId();
+}
+/** A trace id handed over through run metadata, or a new one. */
+export function traceIdFromMetadata(metadata) {
+    const value = metadata?.[TRACE_ID_METADATA_KEY];
+    return typeof value === "string" && isValidTraceId(value)
+        ? value
+        : newTraceId();
+}
+/** A new, empty log context for `traceId` with its own span id. */
+export function createLogContext(traceId) {
+    return {
+        traceId,
+        spanId: newSpanId(),
+        attributes: {},
+        pending: [],
+    };
+}
+/** Run `fn` inside `context`. */
+export function runInLogContext(context, fn) {
+    return storage.run(context, fn);
+}
+/** Run `fn` with a new log context for `traceId`. */
+export function withLogContext(traceId, fn) {
+    const context = createLogContext(traceId);
+    return storage.run(context, () => fn(context));
+}
+export function currentLogContext() {
+    return storage.getStore();
+}
+/** Keep the current context open until `work` settles. */
+export function holdLogContext(work) {
+    currentLogContext()?.pending.push(work);
+}
+/** Add attributes to the current context's later records. */
+export function setLogAttributes(attributes) {
+    const context = currentLogContext();
+    if (!context)
+        return;
+    for (const [key, value] of Object.entries(attributes)) {
+        if (value !== null && value !== undefined) {
+            context.attributes[key] = value;
+        }
+    }
+}
+/** OTel `exception.*` attributes for an error. */
+export function exceptionAttributes(error) {
+    if (!(error instanceof Error)) {
+        return { "exception.type": typeof error };
+    }
+    const attributes = {
+        "exception.type": error.name,
+        "exception.message": error.message,
+    };
+    if (error.stack) {
+        attributes["exception.stacktrace"] = error.stack;
+    }
+    return attributes;
+}
+/**
+ * Queue a record under the current context's ids on the process-wide log
+ * sink, with the middle cut out of any string over the per-value limit. Does
+ * nothing outside a context or when the sink is disabled.
+ */
+export function recordLog(severity, body, options = {}) {
+    const context = currentLogContext();
+    const sink = logSink();
+    if (!context || !sink.enabled)
+        return;
+    const attributes = {
+        ...context.attributes,
+        ...options.attributes,
+        ...(options.error === undefined ? {} : exceptionAttributes(options.error)),
+    };
+    for (const [key, value] of Object.entries(attributes)) {
+        if (typeof value === "string")
+            attributes[key] = truncateMiddle(value);
+    }
+    sink.push({
+        uid: randomUUID(),
+        timeUnixNano: `${BigInt(Date.now()) * 1000000n}`,
+        severity,
+        body: truncateMiddle(body),
+        attributes,
+        traceId: context.traceId,
+        spanId: context.spanId,
+    });
+}
+//# sourceMappingURL=context.js.map

package/dist/telemetry/otel/context.js.map

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

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

@@ -0,0 +1,53 @@
+import type { RetryPolicy } from "../../resilience/retry.js";
+import type { LogRecord } from "./context.js";
+import type { ExportLogsServiceRequest, OtlpLogRecord } from "./otlp.js";
+/** The collection endpoint accepts at most this many records per request. */
+export declare const MAX_RECORDS_PER_REQUEST = 200;
+/** Encoded records per request, under the endpoint's 5MB body limit. */
+export declare const MAX_REQUEST_BYTES: number;
+export interface OtelLogConfig {
+    url: string;
+    headers: Record<string, string>;
+}
+/**
+ * Where and how to send logs, or `undefined` when logs must not be sent:
+ * telemetry is off, the process is not a LangSmith deployment, there is no
+ * key, or the key would cross the network in cleartext.
+ */
+export declare function resolveOtelLogConfig(env?: Record<string, string | undefined>): OtelLogConfig | undefined;
+export declare function toOtlpLogRecord(record: LogRecord): OtlpLogRecord;
+/**
+ * One OTLP `ExportLogsServiceRequest`. Records from many contexts can share a
+ * request; each keeps its own trace and span ids.
+ */
+export declare function encodeLogs(records: OtlpLogRecord[], serviceVersion?: string): ExportLogsServiceRequest;
+/** Where records go once built. Never blocks or throws. */
+export interface LogSink {
+    /** Whether pushed records go anywhere; when not, callers skip building them. */
+    readonly enabled: boolean;
+    push(record: LogRecord): void;
+    /** Resolves once every pushed record has been handled. */
+    idle(): Promise<void>;
+    /** Refuse new records and drain what is queued until `deadlineMs`. */
+    shutdown(deadlineMs: number): Promise<void>;
+}
+export interface LogSinkOptions {
+    env?: Record<string, string | undefined>;
+    fetch?: typeof fetch;
+    maxWaitMs?: number;
+    retry?: RetryPolicy;
+}
+/**
+ * A sink that batches records in the background and sends them to the
+ * collection endpoint. Drops everything when {@link resolveOtelLogConfig}
+ * returns nothing.
+ */
+export declare function createLogSink(options?: LogSinkOptions): LogSink;
+/**
+ * The process-wide sink, created on first use. When it exports, it drains at
+ * process shutdown.
+ */
+export declare function logSink(): LogSink;
+/** @internal Test-only sink override; `undefined` restores the default. */
+export declare function setLogSinkForTests(override: LogSink | undefined): void;
+//# sourceMappingURL=exporter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"exporter.d.ts","sourceRoot":"","sources":["../../../src/telemetry/otel/exporter.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAc7D,OAAO,KAAK,EAAoC,SAAS,EAAE,MAAM,cAAc,CAAC;AAChF,OAAO,KAAK,EACV,wBAAwB,EAGxB,aAAa,EACd,MAAM,WAAW,CAAC;AAUnB,6EAA6E;AAC7E,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAC3C,wEAAwE;AACxE,eAAO,MAAM,iBAAiB,QAAU,CAAC;AAOzC,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAMD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GACpD,aAAa,GAAG,SAAS,CAqB3B;AAmBD,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,aAAa,CAahE;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,aAAa,EAAE,EACxB,cAAc,GAAE,MAAyB,GACxC,wBAAwB,CAgB1B;AAWD,2DAA2D;AAC3D,MAAM,WAAW,OAAO;IACtB,gFAAgF;IAChF,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,IAAI,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAAC;IAC9B,0DAA0D;IAC1D,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,sEAAsE;IACtE,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7C;AASD,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAsBnE;AA0BD;;;GAGG;AACH,wBAAgB,OAAO,IAAI,OAAO,CAOjC;AAED,2EAA2E;AAC3E,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,IAAI,CAEtE"}

package/dist/telemetry/otel/exporter.js

@@ -0,0 +1,190 @@
+/**
+ * The process-wide log sink: sends records from every log context to the
+ * LangSmith MDA log collection endpoint as OTLP/HTTP JSON, which forwards them
+ * to Datadog.
+ *
+ * Built on our own `BatchProcessor` and `withRetry` rather than the OTel SDK.
+ * PostHog events need the same batching and retry, so both sinks share one
+ * mechanism, and the Python runtime mirrors it.
+ */
+import { agentAuthHeaders } from "../../agent-auth.js";
+import { resolveAgentAuthBaseUrl } from "../../connections.js";
+import { sendsKeySecurely } from "../../identity/loopback.js";
+import { BatchProcessor } from "../../concurrency/batch-processor.js";
+import { withRetry } from "../../resilience/retry.js";
+import { fetchWithTimeout, HttpStatusError, isRetryable, requestedDelayMs, } from "../../runtime/http.js";
+import { resolveServerApiKey, resolveTenantWorkspaceId, } from "../../runtime/langsmith-env.js";
+import { isTelemetryDisabled } from "../gates.js";
+import { onShutdown } from "../lifecycle.js";
+import { packageVersion } from "../metadata.js";
+const LOGS_PATH = "/v1/platform/mda/otel/v1/logs";
+const SERVICE_NAME = "mda-node";
+/** Bounds one export request; the OTel exporters' default. */
+const EXPORT_TIMEOUT_MS = 10_000;
+/** How long a partial batch waits for more records. */
+const BATCH_WAIT_MS = 1_000;
+/** Records waiting to send; later ones are dropped. */
+const MAX_QUEUED_RECORDS = 10_000;
+/** The collection endpoint accepts at most this many records per request. */
+export const MAX_RECORDS_PER_REQUEST = 200;
+/** Encoded records per request, under the endpoint's 5MB body limit. */
+export const MAX_REQUEST_BYTES = 4 << 20;
+/** OTel semantic-convention attribute for a log record's unique id. */
+const RECORD_UID_KEY = "log.record.uid";
+const SEVERITY_NUMBER = { INFO: 9, WARN: 13, ERROR: 17 };
+function nonempty(value) {
+    return value?.trim() || undefined;
+}
+/**
+ * Where and how to send logs, or `undefined` when logs must not be sent:
+ * telemetry is off, the process is not a LangSmith deployment, there is no
+ * key, or the key would cross the network in cleartext.
+ */
+export function resolveOtelLogConfig(env = process.env) {
+    if (isTelemetryDisabled(env))
+        return undefined;
+    if (env.MDA_LOCAL_DEV === "1" || !nonempty(env.LANGSMITH_HOST_PROJECT_ID)) {
+        return undefined;
+    }
+    const apiKey = resolveServerApiKey(env);
+    if (!apiKey)
+        return undefined;
+    let url;
+    try {
+        url = new URL(LOGS_PATH, resolveAgentAuthBaseUrl(env));
+    }
+    catch {
+        return undefined;
+    }
+    if (!sendsKeySecurely(url))
+        return undefined;
+    return {
+        url: url.toString(),
+        headers: agentAuthHeaders({
+            apiKey,
+            workspaceId: resolveTenantWorkspaceId(env),
+        }),
+    };
+}
+function anyValue(value) {
+    if (typeof value === "boolean")
+        return { boolValue: value };
+    if (typeof value === "number") {
+        return Number.isInteger(value)
+            ? { intValue: String(value) }
+            : { doubleValue: value };
+    }
+    return { stringValue: value };
+}
+function keyValues(attributes) {
+    return Object.entries(attributes).map(([key, value]) => ({
+        key,
+        value: anyValue(value),
+    }));
+}
+export function toOtlpLogRecord(record) {
+    return {
+        timeUnixNano: record.timeUnixNano,
+        severityNumber: SEVERITY_NUMBER[record.severity],
+        severityText: record.severity,
+        body: { stringValue: record.body },
+        attributes: [
+            ...keyValues(record.attributes),
+            { key: RECORD_UID_KEY, value: { stringValue: record.uid } },
+        ],
+        traceId: record.traceId,
+        spanId: record.spanId,
+    };
+}
+/**
+ * One OTLP `ExportLogsServiceRequest`. Records from many contexts can share a
+ * request; each keeps its own trace and span ids.
+ */
+export function encodeLogs(records, serviceVersion = packageVersion()) {
+    return {
+        resourceLogs: [
+            {
+                resource: {
+                    attributes: keyValues({
+                        "service.name": SERVICE_NAME,
+                        "service.version": serviceVersion,
+                    }),
+                },
+                scopeLogs: [
+                    { scope: { name: "managed-deepagents" }, logRecords: records },
+                ],
+            },
+        ],
+    };
+}
+/** 429 and 5xx (including timeouts and network failures) are tried again. */
+const EXPORT_RETRY = {
+    maxAttempts: 5,
+    baseDelayMs: 1_000,
+    maxDelayMs: 30_000,
+    retryOn: isRetryable,
+    delayFor: requestedDelayMs,
+};
+const NOOP_SINK = {
+    enabled: false,
+    push: () => undefined,
+    idle: async () => undefined,
+    shutdown: async () => undefined,
+};
+/**
+ * A sink that batches records in the background and sends them to the
+ * collection endpoint. Drops everything when {@link resolveOtelLogConfig}
+ * returns nothing.
+ */
+export function createLogSink(options = {}) {
+    const config = resolveOtelLogConfig(options.env);
+    if (!config)
+        return NOOP_SINK;
+    const processor = new BatchProcessor({
+        handle: withRetry((batch, signal) => postLogs(config, batch, signal, options.fetch), options.retry ?? EXPORT_RETRY),
+        maxBatchSize: MAX_RECORDS_PER_REQUEST,
+        maxBatchBytes: MAX_REQUEST_BYTES,
+        sizeOf: (record) => Buffer.byteLength(JSON.stringify(record)),
+        maxWaitMs: options.maxWaitMs ?? BATCH_WAIT_MS,
+        maxQueued: MAX_QUEUED_RECORDS,
+    });
+    return {
+        enabled: true,
+        push: (record) => {
+            processor.push(toOtlpLogRecord(record));
+        },
+        idle: () => processor.idle(),
+        shutdown: (deadlineMs) => processor.shutdown(deadlineMs),
+    };
+}
+async function postLogs(config, batch, signal, fetchImpl) {
+    const response = await fetchWithTimeout(config.url, {
+        method: "POST",
+        headers: config.headers,
+        body: JSON.stringify(encodeLogs(batch)),
+        redirect: "error",
+        signal,
+    }, EXPORT_TIMEOUT_MS, fetchImpl);
+    await response.body?.cancel();
+    if (!response.ok)
+        throw HttpStatusError.from(response);
+}
+let sink;
+/**
+ * The process-wide sink, created on first use. When it exports, it drains at
+ * process shutdown.
+ */
+export function logSink() {
+    if (!sink) {
+        const created = createLogSink();
+        if (created !== NOOP_SINK)
+            onShutdown((ms) => created.shutdown(ms));
+        sink = created;
+    }
+    return sink;
+}
+/** @internal Test-only sink override; `undefined` restores the default. */
+export function setLogSinkForTests(override) {
+    sink = override;
+}
+//# sourceMappingURL=exporter.js.map

package/dist/telemetry/otel/exporter.js.map

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

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

@@ -0,0 +1,6 @@
+export { createLogContext, currentLogContext, exceptionAttributes, holdLogContext, newSpanId, newTraceId, recordLog, runInLogContext, setLogAttributes, TRACE_ID_METADATA_KEY, traceIdFromMetadata, traceIdFromTraceparent, withLogContext, } from "./context.js";
+export type { LogAttributes, LogAttributeValue, LogContext, LogRecord, LogSeverity, } from "./context.js";
+export { createLogSink, encodeLogs, logSink, MAX_RECORDS_PER_REQUEST, MAX_REQUEST_BYTES, resolveOtelLogConfig, setLogSinkForTests, toOtlpLogRecord, } from "./exporter.js";
+export type { LogSink, LogSinkOptions, OtelLogConfig } from "./exporter.js";
+export type { ExportLogsServiceRequest, OtlpAnyValue, OtlpKeyValue, OtlpLogRecord, OtlpResourceLogs, OtlpScopeLogs, } from "./otlp.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/telemetry/otel/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,SAAS,EACT,UAAU,EACV,SAAS,EACT,eAAe,EACf,gBAAgB,EAChB,qBAAqB,EACrB,mBAAmB,EACnB,sBAAsB,EACtB,cAAc,GACf,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,aAAa,EACb,iBAAiB,EACjB,UAAU,EACV,SAAS,EACT,WAAW,GACZ,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,aAAa,EACb,UAAU,EACV,OAAO,EACP,uBAAuB,EACvB,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,eAAe,GAChB,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC5E,YAAY,EACV,wBAAwB,EACxB,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,aAAa,GACd,MAAM,WAAW,CAAC"}

package/dist/telemetry/otel/index.js

@@ -0,0 +1,3 @@
+export { createLogContext, currentLogContext, exceptionAttributes, holdLogContext, newSpanId, newTraceId, recordLog, runInLogContext, setLogAttributes, TRACE_ID_METADATA_KEY, traceIdFromMetadata, traceIdFromTraceparent, withLogContext, } from "./context.js";
+export { createLogSink, encodeLogs, logSink, MAX_RECORDS_PER_REQUEST, MAX_REQUEST_BYTES, resolveOtelLogConfig, setLogSinkForTests, toOtlpLogRecord, } from "./exporter.js";
+//# sourceMappingURL=index.js.map

package/dist/telemetry/otel/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/telemetry/otel/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,SAAS,EACT,UAAU,EACV,SAAS,EACT,eAAe,EACf,gBAAgB,EAChB,qBAAqB,EACrB,mBAAmB,EACnB,sBAAsB,EACtB,cAAc,GACf,MAAM,cAAc,CAAC;AAQtB,OAAO,EACL,aAAa,EACb,UAAU,EACV,OAAO,EACP,uBAAuB,EACvB,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,eAAe,GAChB,MAAM,eAAe,CAAC"}

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

@@ -0,0 +1,44 @@
+/**
+ * The OTLP/HTTP JSON shapes the log collection endpoint accepts: the subset of
+ * `ExportLogsServiceRequest` this runtime sends. Field names follow the OTLP
+ * JSON encoding (lowerCamelCase; 64-bit integers as decimal strings).
+ */
+export type OtlpAnyValue = {
+    stringValue: string;
+} | {
+    boolValue: boolean;
+} | {
+    intValue: string;
+} | {
+    doubleValue: number;
+};
+export interface OtlpKeyValue {
+    key: string;
+    value: OtlpAnyValue;
+}
+/** One record, carrying its own context's trace and span ids. */
+export interface OtlpLogRecord {
+    timeUnixNano: string;
+    severityNumber: number;
+    severityText: string;
+    body: OtlpAnyValue;
+    attributes: OtlpKeyValue[];
+    traceId: string;
+    spanId: string;
+}
+export interface OtlpScopeLogs {
+    scope: {
+        name: string;
+    };
+    logRecords: OtlpLogRecord[];
+}
+export interface OtlpResourceLogs {
+    resource: {
+        attributes: OtlpKeyValue[];
+    };
+    scopeLogs: OtlpScopeLogs[];
+}
+export interface ExportLogsServiceRequest {
+    resourceLogs: OtlpResourceLogs[];
+}
+//# sourceMappingURL=otlp.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"otlp.d.ts","sourceRoot":"","sources":["../../../src/telemetry/otel/otlp.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,YAAY,GACpB;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,GACvB;IAAE,SAAS,EAAE,OAAO,CAAA;CAAE,GACtB;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,GACpB;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5B,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,YAAY,CAAC;CACrB;AAED,iEAAiE;AACjE,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,YAAY,CAAC;IACnB,UAAU,EAAE,YAAY,EAAE,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACxB,UAAU,EAAE,aAAa,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE;QAAE,UAAU,EAAE,YAAY,EAAE,CAAA;KAAE,CAAC;IACzC,SAAS,EAAE,aAAa,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,wBAAwB;IACvC,YAAY,EAAE,gBAAgB,EAAE,CAAC;CAClC"}

package/dist/telemetry/otel/otlp.js

@@ -0,0 +1,7 @@
+/**
+ * The OTLP/HTTP JSON shapes the log collection endpoint accepts: the subset of
+ * `ExportLogsServiceRequest` this runtime sends. Field names follow the OTLP
+ * JSON encoding (lowerCamelCase; 64-bit integers as decimal strings).
+ */
+export {};
+//# sourceMappingURL=otlp.js.map

package/dist/telemetry/otel/otlp.js.map

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

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

@@ -0,0 +1,10 @@
+/**
+ * Keeps a log value within the collection endpoint's per-value limit by
+ * cutting its middle, as the CLI does: the start says what failed, and the end
+ * of a stacktrace or a child's output usually says why.
+ */
+/** The collection endpoint keeps up to this many bytes of a value. */
+export declare const MAX_VALUE_BYTES: number;
+/** `value` within `maxBytes` of UTF-8: its start and end, with the cut size. */
+export declare function truncateMiddle(value: string, maxBytes?: number): string;
+//# sourceMappingURL=truncate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"truncate.d.ts","sourceRoot":"","sources":["../../../src/telemetry/otel/truncate.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,sEAAsE;AACtE,eAAO,MAAM,eAAe,QAAW,CAAC;AAMxC,gFAAgF;AAChF,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,QAAQ,GAAE,MAAwB,GACjC,MAAM,CAaR"}

package/dist/telemetry/otel/truncate.js

@@ -0,0 +1,39 @@
+/**
+ * Keeps a log value within the collection endpoint's per-value limit by
+ * cutting its middle, as the CLI does: the start says what failed, and the end
+ * of a stacktrace or a child's output usually says why.
+ */
+/** The collection endpoint keeps up to this many bytes of a value. */
+export const MAX_VALUE_BYTES = 32 << 10;
+/** Kept from the start of a value that is too long; the rest keeps its end. */
+const HEAD_BYTES = 1 << 10;
+/** Room for the omission marker. */
+const MARKER_BYTES = 48;
+/** `value` within `maxBytes` of UTF-8: its start and end, with the cut size. */
+export function truncateMiddle(value, maxBytes = MAX_VALUE_BYTES) {
+    // A UTF-16 code unit is at most 3 UTF-8 bytes.
+    if (value.length * 3 <= maxBytes)
+        return value;
+    const bytes = Buffer.from(value, "utf8");
+    if (bytes.length <= maxBytes)
+        return value;
+    const headEnd = floorBoundary(bytes, HEAD_BYTES);
+    const tailStart = ceilBoundary(bytes, bytes.length - (maxBytes - HEAD_BYTES - MARKER_BYTES));
+    return `${bytes.subarray(0, headEnd).toString("utf8")}\n… ${tailStart - headEnd} bytes omitted …\n${bytes.subarray(tailStart).toString("utf8")}`;
+}
+function isContinuation(byte) {
+    return byte !== undefined && (byte & 0xc0) === 0x80;
+}
+function floorBoundary(bytes, index) {
+    let at = index;
+    while (at > 0 && isContinuation(bytes[at]))
+        at--;
+    return at;
+}
+function ceilBoundary(bytes, index) {
+    let at = index;
+    while (at < bytes.length && isContinuation(bytes[at]))
+        at++;
+    return at;
+}
+//# sourceMappingURL=truncate.js.map

package/dist/telemetry/otel/truncate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"truncate.js","sourceRoot":"","sources":["../../../src/telemetry/otel/truncate.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,sEAAsE;AACtE,MAAM,CAAC,MAAM,eAAe,GAAG,EAAE,IAAI,EAAE,CAAC;AACxC,+EAA+E;AAC/E,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,CAAC;AAC3B,oCAAoC;AACpC,MAAM,YAAY,GAAG,EAAE,CAAC;AAExB,gFAAgF;AAChF,MAAM,UAAU,cAAc,CAC5B,KAAa,EACb,QAAQ,GAAW,eAAe;IAElC,+CAA+C;IAC/C,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC/C,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACzC,IAAI,KAAK,CAAC,MAAM,IAAI,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC3C,MAAM,OAAO,GAAG,aAAa,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IACjD,MAAM,SAAS,GAAG,YAAY,CAC5B,KAAK,EACL,KAAK,CAAC,MAAM,GAAG,CAAC,QAAQ,GAAG,UAAU,GAAG,YAAY,CAAC,CACtD,CAAC;IACF,OAAO,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,OACnD,SAAS,GAAG,OACd,qBAAqB,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;AACpE,CAAC;AAED,SAAS,cAAc,CAAC,IAAwB;IAC9C,OAAO,IAAI,KAAK,SAAS,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,IAAI,CAAC;AACtD,CAAC;AAED,SAAS,aAAa,CAAC,KAAa,EAAE,KAAa;IACjD,IAAI,EAAE,GAAG,KAAK,CAAC;IACf,OAAO,EAAE,GAAG,CAAC,IAAI,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAAE,EAAE,EAAE,CAAC;IACjD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,YAAY,CAAC,KAAa,EAAE,KAAa;IAChD,IAAI,EAAE,GAAG,KAAK,CAAC;IACf,OAAO,EAAE,GAAG,KAAK,CAAC,MAAM,IAAI,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAAE,EAAE,EAAE,CAAC;IAC5D,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/telemetry/run-listener.d.ts

@@ -14,7 +14,7 @@ export declare class RunTelemetryListener extends GraphCallbackHandler {
     handleChainStart(_chain: unknown, _inputs: unknown, runId: string): void;
     handleInterrupt(event: GraphInterruptEvent): void;
     handleChainEnd(_outputs: unknown, runId: string): void;
-    handleChainError(_error: unknown, runId: string): void;
+    handleChainError(error: unknown, runId: string): void;
     private report;
 }
 //# sourceMappingURL=run-listener.d.ts.map

package/dist/telemetry/run-listener.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-listener.d.ts","sourceRoot":"","sources":["../../src/telemetry/run-listener.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEhE,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAG9C,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAc,MAAM,UAAU,CAAC;AAY1E,8CAA8C;AAC9C,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,eAAe,CAAC,iBAAiB,CAAC,GAAG,SAAS,GACvD,IAAI,CAEN;AAED,qBAAa,oBAAqB,SAAQ,oBAAoB;IAMhD,OAAO,CAAC,QAAQ,CAAC,OAAO;IALpC,IAAI,SAA0B;IAC9B,aAAa,UAAQ;IACrB,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,WAAW,CAAS;IAE5B,YAA6B,OAAO,EAAE,UAAU,EAE/C;IAED,gBAAgB,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAGvE;IAED,eAAe,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI,CAIhD;IAED,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAIrD;IAED,gBAAgB,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAIrD;IAED,OAAO,CAAC,MAAM;CAQf"}
+{"version":3,"file":"run-listener.d.ts","sourceRoot":"","sources":["../../src/telemetry/run-listener.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEhE,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAK9C,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAc,MAAM,UAAU,CAAC;AAY1E,8CAA8C;AAC9C,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,eAAe,CAAC,iBAAiB,CAAC,GAAG,SAAS,GACvD,IAAI,CAEN;AAED,qBAAa,oBAAqB,SAAQ,oBAAoB;IAMhD,OAAO,CAAC,QAAQ,CAAC,OAAO;IALpC,IAAI,SAA0B;IAC9B,aAAa,UAAQ;IACrB,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,WAAW,CAAS;IAE5B,YAA6B,OAAO,EAAE,UAAU,EAE/C;IAED,gBAAgB,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAGvE;IAED,eAAe,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI,CAIhD;IAED,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAIrD;IAED,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAKpD;IAED,OAAO,CAAC,MAAM;CAYf"}