@mono-agent/observability 0.1.0

package/dist/recorded-runs.js

@@ -0,0 +1,372 @@
+import { readdir, readFile, stat } from "node:fs/promises";
+import { resolve } from "node:path";
+import { DEFAULT_MAX_EVENTS_PER_RUN, DEFAULT_MAX_RUNS, DEFAULT_MAX_STRING_BYTES, errorMessage, isErrno, isRecord, minInteger, normalizeRunId as normalizeRunIdGuard, positiveInteger, safeArtifactName, safeJoin as safeJoinGuard, stringField, } from "./artifact-fs.js";
+import { classifyAssistantContent, compactString } from "./content.js";
+import { redactJsonValue } from "./recorder.js";
+const SUMMARY_SUFFIX = ".summary.json";
+const EVENTS_SUFFIX = ".events.jsonl";
+export class ObservabilityReadError extends Error {
+    code;
+    details;
+    constructor(code, message, details = {}) {
+        super(message);
+        this.name = "ObservabilityReadError";
+        this.code = code;
+        this.details = { ...details, code };
+    }
+}
+export async function listRecordedRuns(options) {
+    const normalized = normalizeReaderOptions(options);
+    const { summaries, warnings } = await loadSummaryFiles(normalized);
+    return {
+        runs: [...summaries]
+            .sort((a, b) => summaryUpdatedAtMs(b) - summaryUpdatedAtMs(a))
+            .slice(0, normalized.maxRuns)
+            .map((entry) => summaryToListItem(entry.summary, entry.updatedAt, normalized.maxStringBytes)),
+        warnings,
+    };
+}
+export async function readRecordedRun(options, runId) {
+    const normalized = normalizeReaderOptions(options);
+    const normalizedRunId = normalizeRunId(runId);
+    const baseName = safeArtifactName(normalizedRunId);
+    const summaryPath = safeJoin(normalized.artifactDir, `${baseName}${SUMMARY_SUFFIX}`);
+    const warnings = [];
+    const summary = await readSummaryFile(summaryPath, `${baseName}${SUMMARY_SUFFIX}`, normalized, warnings);
+    if (summary === undefined || summary.summary.runId !== normalizedRunId) {
+        return undefined;
+    }
+    const eventsPath = safeJoin(normalized.artifactDir, `${baseName}${EVENTS_SUFFIX}`);
+    const events = await readEventsFile(eventsPath, normalized, warnings);
+    return {
+        summary: summaryToListItem(summary.summary, summary.updatedAt, normalized.maxStringBytes),
+        events,
+        warnings,
+    };
+}
+export function classifyRecordedRunEvent(event) {
+    if (!isRecord(event)) {
+        return "runtime";
+    }
+    const type = stringField(event, "type")?.toLowerCase() ?? "";
+    if (type.includes("error") ||
+        type.includes("failure") ||
+        type.includes("failed") ||
+        event.error !== undefined ||
+        event.failureKind !== undefined) {
+        return "error";
+    }
+    if (type.includes("tool") ||
+        stringField(event, "toolName") !== undefined ||
+        stringField(event, "tool") !== undefined ||
+        stringField(event, "tool_call_id") !== undefined ||
+        stringField(event, "toolCallId") !== undefined) {
+        return "tool";
+    }
+    if (type.includes("thinking") || type.includes("reasoning") || type.includes("thought")) {
+        return "thinking";
+    }
+    if (assistantMessageContentKind(event) === "thinking") {
+        return "thinking";
+    }
+    if (type === "assistant" || type === "user" || type.includes("message") || event.message !== undefined) {
+        return "message";
+    }
+    return "runtime";
+}
+async function loadSummaryFiles(normalized) {
+    const warnings = [];
+    let entries;
+    try {
+        entries = await readdir(normalized.artifactDir, { withFileTypes: true });
+    }
+    catch (error) {
+        if (isErrno(error, "ENOENT")) {
+            return { summaries: [], warnings };
+        }
+        return {
+            summaries: [],
+            warnings: [`Unable to read artifact directory: ${errorMessage(error)}.`],
+        };
+    }
+    const summaries = [];
+    for (const entry of entries) {
+        if (!entry.isFile() || !entry.name.endsWith(SUMMARY_SUFFIX)) {
+            continue;
+        }
+        const filePath = safeJoin(normalized.artifactDir, entry.name);
+        const parsed = await readSummaryFile(filePath, entry.name, normalized, warnings);
+        if (parsed !== undefined) {
+            summaries.push(parsed);
+        }
+    }
+    return { summaries, warnings };
+}
+async function readSummaryFile(filePath, fileName, normalized, warnings) {
+    let raw;
+    try {
+        raw = await readFile(filePath, "utf8");
+    }
+    catch (error) {
+        if (isErrno(error, "ENOENT")) {
+            return undefined;
+        }
+        warnings.push(`Unable to read ${fileName}: ${errorMessage(error)}.`);
+        return undefined;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (error) {
+        warnings.push(`Skipping ${fileName}: invalid JSON (${errorMessage(error)}).`);
+        return undefined;
+    }
+    const summary = coerceRunSummary(parsed, fileName, warnings, normalized.maxStringBytes);
+    if (summary === undefined) {
+        return undefined;
+    }
+    let stats;
+    try {
+        stats = await stat(filePath);
+    }
+    catch (error) {
+        warnings.push(`Unable to stat ${fileName}: ${errorMessage(error)}.`);
+        return undefined;
+    }
+    return {
+        fileName,
+        summary,
+        updatedAt: stats.mtime.toISOString(),
+        mtimeMs: stats.mtimeMs,
+    };
+}
+async function readEventsFile(filePath, normalized, warnings) {
+    let raw;
+    try {
+        raw = await readFile(filePath, "utf8");
+    }
+    catch (error) {
+        if (isErrno(error, "ENOENT")) {
+            warnings.push("Event artifact is missing for this run.");
+            return [];
+        }
+        warnings.push(`Unable to read event artifact: ${errorMessage(error)}.`);
+        return [];
+    }
+    const events = [];
+    const lines = raw.split(/\r?\n/u);
+    for (let i = 0; i < lines.length; i += 1) {
+        const line = lines[i];
+        if (line === undefined || line.trim().length === 0) {
+            continue;
+        }
+        if (events.length >= normalized.maxEventsPerRun) {
+            warnings.push(`Event list was capped at ${normalized.maxEventsPerRun} events.`);
+            break;
+        }
+        try {
+            const parsed = JSON.parse(line);
+            events.push(toRecordedEvent(parsed, events.length, normalized.maxStringBytes));
+        }
+        catch (error) {
+            warnings.push(`Skipping malformed event line ${i + 1}: ${errorMessage(error)}.`);
+        }
+    }
+    return events;
+}
+function coerceRunSummary(value, fileName, warnings, maxStringBytes) {
+    if (!isRecord(value)) {
+        warnings.push(`Skipping ${fileName}: summary is not an object.`);
+        return undefined;
+    }
+    const runId = stringField(value, "runId");
+    const conversationId = stringField(value, "conversationId");
+    const status = runSummaryStatus(value.status);
+    const durationMs = finiteNumberField(value, "durationMs");
+    const eventCount = integerNumberField(value, "eventCount");
+    if (runId === undefined || conversationId === undefined || status === undefined || durationMs === undefined || eventCount === undefined) {
+        warnings.push(`Skipping ${fileName}: summary is missing required run metadata.`);
+        return undefined;
+    }
+    const failureKind = stringField(value, "failureKind");
+    const startedAt = stringField(value, "startedAt");
+    const endedAt = stringField(value, "endedAt");
+    const updatedAt = stringField(value, "updatedAt");
+    const providerSessionId = providerSessionIdField(value.providerSessionId);
+    const artifactPaths = Array.isArray(value.artifactPaths) ? value.artifactPaths.filter((entry) => typeof entry === "string") : [];
+    const summary = {
+        runId,
+        conversationId,
+        status,
+        ...(failureKind === undefined ? {} : { failureKind }),
+        ...(startedAt === undefined ? {} : { startedAt }),
+        ...(endedAt === undefined ? {} : { endedAt }),
+        ...(updatedAt === undefined ? {} : { updatedAt }),
+        durationMs,
+        ...(value.usage === undefined ? {} : { usage: redactJsonValue(value.usage, maxStringBytes) }),
+        ...(value.cost === undefined ? {} : { cost: redactJsonValue(value.cost, maxStringBytes) }),
+        ...(providerSessionId === undefined ? {} : { providerSessionId }),
+        eventCount,
+        artifactPaths,
+        ...(value.runtimeWarnings === undefined ? {} : { runtimeWarnings: redactJsonValue(value.runtimeWarnings, maxStringBytes) }),
+        ...(value.diagnostics === undefined ? {} : { diagnostics: redactJsonValue(value.diagnostics, maxStringBytes) }),
+        ...(value.capabilitiesUsed === undefined ? {} : { capabilitiesUsed: redactJsonValue(value.capabilitiesUsed, maxStringBytes) }),
+    };
+    return summary;
+}
+function summaryToListItem(summary, updatedAt, maxStringBytes) {
+    return {
+        runId: summary.runId,
+        conversationId: summary.conversationId,
+        status: summary.status,
+        ...(summary.failureKind === undefined ? {} : { failureKind: summary.failureKind }),
+        ...(summary.startedAt === undefined ? {} : { startedAt: summary.startedAt }),
+        ...(summary.endedAt === undefined ? {} : { endedAt: summary.endedAt }),
+        durationMs: summary.durationMs,
+        eventCount: summary.eventCount,
+        updatedAt: summary.updatedAt ?? updatedAt,
+        ...(summary.usage === undefined ? {} : { usage: redactJsonValue(summary.usage, maxStringBytes) }),
+        ...(summary.cost === undefined ? {} : { cost: redactJsonValue(summary.cost, maxStringBytes) }),
+        ...(summary.providerSessionId === undefined ? {} : { providerSessionId: summary.providerSessionId }),
+        ...(summary.runtimeWarnings === undefined ? {} : { runtimeWarnings: redactJsonValue(summary.runtimeWarnings, maxStringBytes) }),
+        ...(summary.diagnostics === undefined ? {} : { diagnostics: redactJsonValue(summary.diagnostics, maxStringBytes) }),
+        ...(summary.capabilitiesUsed === undefined ? {} : { capabilitiesUsed: redactJsonValue(summary.capabilitiesUsed, maxStringBytes) }),
+    };
+}
+function toRecordedEvent(raw, index, maxStringBytes) {
+    const payload = redactJsonValue(raw, maxStringBytes);
+    const category = classifyRecordedRunEvent(payload);
+    const record = isRecord(payload) ? payload : {};
+    const type = stringField(record, "type");
+    const timestamp = stringField(record, "timestamp") ?? stringField(record, "createdAt") ?? stringField(record, "time");
+    return {
+        index,
+        ...(type === undefined ? {} : { type }),
+        category,
+        ...(timestamp === undefined ? {} : { timestamp }),
+        label: eventLabel(record, category, type),
+        summary: eventSummary(record, category, payload, maxStringBytes),
+        payload,
+    };
+}
+function eventLabel(record, category, type) {
+    const toolName = stringField(record, "toolName") ?? stringField(record, "tool") ?? stringField(record, "name");
+    if (category === "tool" && toolName !== undefined) {
+        return `Tool: ${toolName}`;
+    }
+    const role = stringField(record, "role");
+    if (category === "message" && role !== undefined) {
+        return `Message: ${role}`;
+    }
+    if (category === "thinking") {
+        return type ?? "Reasoning event";
+    }
+    if (category === "error") {
+        return type ?? stringField(record, "failureKind") ?? "Error";
+    }
+    return type ?? "Runtime event";
+}
+function eventSummary(record, category, payload, maxStringBytes) {
+    const direct = stringField(record, "summary") ?? stringField(record, "text") ?? stringField(record, "delta") ?? stringField(record, "error");
+    if (direct !== undefined) {
+        return compactString(direct);
+    }
+    const messageText = textFromMessage(record.message);
+    if (messageText !== undefined) {
+        return compactString(messageText);
+    }
+    if (category === "tool") {
+        const status = stringField(record, "status") ?? stringField(record, "state");
+        const toolName = stringField(record, "toolName") ?? stringField(record, "tool") ?? stringField(record, "name");
+        if (toolName !== undefined && status !== undefined) {
+            return `${toolName} — ${status}`;
+        }
+        if (toolName !== undefined) {
+            return toolName;
+        }
+    }
+    if (category === "thinking") {
+        return "Runtime emitted a reasoning/thinking process event.";
+    }
+    return compactString(JSON.stringify(redactJsonValue(payload, maxStringBytes)));
+}
+function textFromMessage(value) {
+    if (typeof value === "string") {
+        return value;
+    }
+    if (!isRecord(value)) {
+        return undefined;
+    }
+    const content = value.content;
+    if (typeof content === "string") {
+        return content;
+    }
+    if (!Array.isArray(content)) {
+        return undefined;
+    }
+    const text = content
+        .map((block) => {
+        if (typeof block === "string") {
+            return block;
+        }
+        if (isRecord(block) && block.type === "text" && typeof block.text === "string") {
+            return block.text;
+        }
+        return "";
+    })
+        .join("");
+    return text.length > 0 ? text : undefined;
+}
+function assistantMessageContentKind(event) {
+    if (stringField(event, "type") !== "assistant") {
+        return undefined;
+    }
+    return classifyAssistantContent(event.message)?.kind;
+}
+function normalizeReaderOptions(options) {
+    if (typeof options.artifactDir !== "string" || options.artifactDir.trim().length === 0) {
+        throw new ObservabilityReadError("invalid_reader_options", "artifactDir must be a non-empty path.");
+    }
+    const raiseOptions = (message, field) => {
+        throw new ObservabilityReadError("invalid_reader_options", message, { field });
+    };
+    return {
+        artifactDir: resolve(options.artifactDir),
+        maxRuns: positiveInteger(options.maxRuns, DEFAULT_MAX_RUNS, "maxRuns", raiseOptions),
+        maxEventsPerRun: positiveInteger(options.maxEventsPerRun, DEFAULT_MAX_EVENTS_PER_RUN, "maxEventsPerRun", raiseOptions),
+        maxStringBytes: minInteger(options.maxStringBytes, DEFAULT_MAX_STRING_BYTES, 64, "maxStringBytes", raiseOptions),
+    };
+}
+function normalizeRunId(runId) {
+    return normalizeRunIdGuard(runId, (message) => {
+        throw new ObservabilityReadError("invalid_run_id", message);
+    });
+}
+function safeJoin(root, fileName) {
+    return safeJoinGuard(root, fileName, () => {
+        throw new ObservabilityReadError("invalid_run_id", "Resolved artifact path escapes artifactDir.");
+    });
+}
+function runSummaryStatus(value) {
+    return value === "running" || value === "succeeded" || value === "failed" || value === "cancelled" ? value : undefined;
+}
+function summaryUpdatedAtMs(entry) {
+    const parsed = entry.summary.updatedAt === undefined ? Number.NaN : Date.parse(entry.summary.updatedAt);
+    return Number.isFinite(parsed) ? parsed : entry.mtimeMs;
+}
+function providerSessionIdField(value) {
+    if (value === null) {
+        return null;
+    }
+    return typeof value === "string" ? value : undefined;
+}
+function finiteNumberField(record, key) {
+    const value = record[key];
+    return typeof value === "number" && Number.isFinite(value) ? value : undefined;
+}
+function integerNumberField(record, key) {
+    const value = record[key];
+    return typeof value === "number" && Number.isInteger(value) && value >= 0 ? value : undefined;
+}
+//# sourceMappingURL=recorded-runs.js.map

package/dist/recorded-runs.js.map

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

package/dist/recorder.d.ts

@@ -0,0 +1,13 @@
+import type { JsonlRunRecorderOptions, RunRecorder } from "./types.js";
+export type ObservabilityErrorCode = "invalid_recorder_options" | "artifact_write_failed";
+export type ObservabilityErrorDetails = Record<string, unknown> & {
+    readonly code: ObservabilityErrorCode;
+};
+export declare class ObservabilityError extends Error {
+    readonly code: ObservabilityErrorCode;
+    readonly details: ObservabilityErrorDetails;
+    constructor(code: ObservabilityErrorCode, message: string, details?: Record<string, unknown>);
+}
+export declare function createJsonlRunRecorder(options: JsonlRunRecorderOptions): RunRecorder;
+export declare function redactJsonValue(value: unknown, maxStringBytes?: number): unknown;
+//# sourceMappingURL=recorder.d.ts.map

package/dist/recorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recorder.d.ts","sourceRoot":"","sources":["../src/recorder.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,uBAAuB,EAAE,WAAW,EAAmD,MAAM,YAAY,CAAC;AAIxH,MAAM,MAAM,sBAAsB,GAAG,0BAA0B,GAAG,uBAAuB,CAAC;AAC1F,MAAM,MAAM,yBAAyB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAA;CAAE,CAAC;AAE5G,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,yBAAyB,CAAC;gBAEhC,IAAI,EAAE,sBAAsB,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;CAMjG;AAoGD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,uBAAuB,GAAG,WAAW,CAEpF;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,cAAc,SAA2B,GAAG,OAAO,CAElG"}

package/dist/recorder.js

@@ -0,0 +1,188 @@
+import { join, resolve } from "node:path";
+import { DEFAULT_MAX_STRING_BYTES, mkdir, safeArtifactName, writeJsonAtomic } from "./artifact-fs.js";
+const SENSITIVE_KEY_PATTERN = /(token|secret|password|authorization|api[_-]?key|cookie)/iu;
+export class ObservabilityError extends Error {
+    code;
+    details;
+    constructor(code, message, details = {}) {
+        super(message);
+        this.name = "ObservabilityError";
+        this.code = code;
+        this.details = { ...details, code };
+    }
+}
+class JsonlRunRecorder {
+    runId;
+    conversationId;
+    artifactDir;
+    clock;
+    maxStringBytes;
+    startedAt;
+    startedAtIso;
+    events = [];
+    constructor(options) {
+        this.runId = normalizeId(options.runId, "runId");
+        this.conversationId = normalizeId(options.conversationId, "conversationId");
+        if (typeof options.artifactDir !== "string" || options.artifactDir.trim().length === 0) {
+            throw new ObservabilityError("invalid_recorder_options", "artifactDir must be a non-empty path.");
+        }
+        if (options.maxStringBytes !== undefined && (!Number.isInteger(options.maxStringBytes) || options.maxStringBytes < 64)) {
+            throw new ObservabilityError("invalid_recorder_options", "maxStringBytes must be an integer of at least 64.");
+        }
+        this.artifactDir = resolve(options.artifactDir);
+        this.clock = options.clock ?? (() => Date.now());
+        this.maxStringBytes = options.maxStringBytes ?? DEFAULT_MAX_STRING_BYTES;
+        this.startedAt = this.clock();
+        this.startedAtIso = new Date(this.startedAt).toISOString();
+    }
+    async start() {
+        return await this.writeArtifacts(this.buildSummary("running", undefined, {}));
+    }
+    onEvent(event) {
+        this.events.push(redactJsonValue(event, this.maxStringBytes));
+    }
+    async finish(result) {
+        const status = result.cancelled === true ? "cancelled" : runtimeFailureKind(result) === undefined ? "succeeded" : "failed";
+        const baseSummary = this.buildSummary(status, runtimeFailureKind(result), result);
+        return await this.writeArtifacts(baseSummary);
+    }
+    async fail(error) {
+        const failureKind = errorFailureKind(error);
+        const summary = this.buildSummary("failed", failureKind, {
+            diagnostics: {
+                error: redactJsonValue(errorToJson(error), this.maxStringBytes),
+            },
+        });
+        return await this.writeArtifacts(summary);
+    }
+    buildSummary(status, failureKind, result) {
+        const now = this.clock();
+        const nowIso = new Date(now).toISOString();
+        const summary = {
+            runId: this.runId,
+            conversationId: this.conversationId,
+            status,
+            ...(failureKind === undefined ? {} : { failureKind }),
+            startedAt: this.startedAtIso,
+            ...(status === "running" ? {} : { endedAt: nowIso }),
+            updatedAt: nowIso,
+            durationMs: Math.max(0, now - this.startedAt),
+            ...(result.usage === undefined ? {} : { usage: redactJsonValue(result.usage, this.maxStringBytes) }),
+            ...(result.cost === undefined ? {} : { cost: redactJsonValue(result.cost, this.maxStringBytes) }),
+            ...(result.providerSessionId === undefined ? {} : { providerSessionId: result.providerSessionId }),
+            eventCount: this.events.length,
+            artifactPaths: this.artifactPaths(),
+            ...(result.runtimeWarnings === undefined ? {} : { runtimeWarnings: redactJsonValue(result.runtimeWarnings, this.maxStringBytes) }),
+            ...(result.diagnostics === undefined ? {} : { diagnostics: redactJsonValue(result.diagnostics, this.maxStringBytes) }),
+            ...(result.capabilitiesUsed === undefined ? {} : { capabilitiesUsed: redactJsonValue(result.capabilitiesUsed, this.maxStringBytes) }),
+        };
+        return summary;
+    }
+    artifactPaths() {
+        const base = safeArtifactName(this.runId);
+        return [join(this.artifactDir, `${base}.events.jsonl`), join(this.artifactDir, `${base}.summary.json`)];
+    }
+    async writeArtifacts(summary) {
+        const [eventsPath, summaryPath] = summary.artifactPaths;
+        if (eventsPath === undefined || summaryPath === undefined) {
+            throw new ObservabilityError("artifact_write_failed", "Recorder artifact paths were not generated.");
+        }
+        try {
+            await mkdir(this.artifactDir, { recursive: true });
+            const eventsJsonl = this.events.map((event) => JSON.stringify(event)).join("\n");
+            await writeJsonAtomic(eventsPath, eventsJsonl.length === 0 ? "" : `${eventsJsonl}\n`);
+            await writeJsonAtomic(summaryPath, `${JSON.stringify(summary, null, 2)}\n`);
+            return summary;
+        }
+        catch (error) {
+            throw new ObservabilityError("artifact_write_failed", "Unable to write run artifacts.", {
+                cause: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+}
+export function createJsonlRunRecorder(options) {
+    return new JsonlRunRecorder(options);
+}
+export function redactJsonValue(value, maxStringBytes = DEFAULT_MAX_STRING_BYTES) {
+    return redact(value, maxStringBytes, 0, undefined, new WeakSet());
+}
+function redact(value, maxStringBytes, depth, key, seen) {
+    if (key !== undefined && SENSITIVE_KEY_PATTERN.test(key)) {
+        return "[redacted]";
+    }
+    if (value === null || typeof value === "boolean" || typeof value === "number") {
+        return value;
+    }
+    if (typeof value === "string") {
+        return truncateString(value, maxStringBytes);
+    }
+    if (typeof value === "bigint") {
+        return value.toString();
+    }
+    if (typeof value === "undefined" || typeof value === "function" || typeof value === "symbol") {
+        return String(value);
+    }
+    if (value instanceof Error) {
+        return errorToJson(value);
+    }
+    if (depth >= 12) {
+        return "[max-depth]";
+    }
+    if (seen.has(value)) {
+        return "[circular]";
+    }
+    seen.add(value);
+    if (Array.isArray(value)) {
+        return value.map((item) => redact(item, maxStringBytes, depth + 1, undefined, seen));
+    }
+    const out = {};
+    for (const [entryKey, entryValue] of Object.entries(value)) {
+        out[entryKey] = redact(entryValue, maxStringBytes, depth + 1, entryKey, seen);
+    }
+    return out;
+}
+function truncateString(value, maxStringBytes) {
+    const bytes = Buffer.byteLength(value, "utf8");
+    if (bytes <= maxStringBytes) {
+        return value;
+    }
+    return `${value.slice(0, maxStringBytes)}…[truncated ${bytes - maxStringBytes} bytes]`;
+}
+function normalizeId(value, field) {
+    if (typeof value !== "string" || value.trim().length === 0) {
+        throw new ObservabilityError("invalid_recorder_options", `${field} must be a non-empty string.`, { field });
+    }
+    return value.trim();
+}
+function runtimeFailureKind(result) {
+    if (typeof result.failureKind === "string" && result.failureKind.trim().length > 0) {
+        return result.failureKind;
+    }
+    if (typeof result.error === "string" && result.error.trim().length > 0) {
+        return "runtime_error";
+    }
+    return undefined;
+}
+function errorFailureKind(error) {
+    if (typeof error === "object" && error !== null && "failureKind" in error) {
+        const failureKind = error.failureKind;
+        if (typeof failureKind === "string" && failureKind.trim().length > 0) {
+            return failureKind;
+        }
+    }
+    if (error instanceof Error && error.name.length > 0) {
+        return error.name;
+    }
+    return "exception";
+}
+function errorToJson(error) {
+    if (error instanceof Error) {
+        return {
+            name: error.name,
+            message: error.message,
+        };
+    }
+    return { message: String(error) };
+}
+//# sourceMappingURL=recorder.js.map

package/dist/recorder.js.map

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

package/dist/trace-sources.d.ts

@@ -0,0 +1,15 @@
+import type { RegisterTraceSourceOptions, TraceRunDetail, TraceRunListOptions, TraceRunListResult, TraceSourceHandle, TraceSourceListResult, TraceSourceRegistryOptions } from "./types.js";
+export type TraceSourceRegistryErrorCode = "invalid_registry_options" | "invalid_source_id" | "invalid_run_id" | "manifest_write_failed";
+export type TraceSourceRegistryErrorDetails = Record<string, unknown> & {
+    readonly code: TraceSourceRegistryErrorCode;
+};
+export declare class TraceSourceRegistryError extends Error {
+    readonly code: TraceSourceRegistryErrorCode;
+    readonly details: TraceSourceRegistryErrorDetails;
+    constructor(code: TraceSourceRegistryErrorCode, message: string, details?: Record<string, unknown>);
+}
+export declare function registerTraceSource(options: RegisterTraceSourceOptions): Promise<TraceSourceHandle>;
+export declare function listTraceSources(options: TraceSourceRegistryOptions): Promise<TraceSourceListResult>;
+export declare function listTraceRuns(options: TraceRunListOptions): Promise<TraceRunListResult>;
+export declare function readTraceRun(options: TraceRunListOptions, sourceId: string, runId: string): Promise<TraceRunDetail | undefined>;
+//# sourceMappingURL=trace-sources.d.ts.map

package/dist/trace-sources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-sources.d.ts","sourceRoot":"","sources":["../src/trace-sources.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAEV,0BAA0B,EAC1B,cAAc,EAEd,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EAEjB,qBAAqB,EAErB,0BAA0B,EAG3B,MAAM,YAAY,CAAC;AAOpB,MAAM,MAAM,4BAA4B,GACpC,0BAA0B,GAC1B,mBAAmB,GACnB,gBAAgB,GAChB,uBAAuB,CAAC;AAC5B,MAAM,MAAM,+BAA+B,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,4BAA4B,CAAA;CAAE,CAAC;AAExH,qBAAa,wBAAyB,SAAQ,KAAK;IACjD,QAAQ,CAAC,IAAI,EAAE,4BAA4B,CAAC;IAC5C,QAAQ,CAAC,OAAO,EAAE,+BAA+B,CAAC;gBAEtC,IAAI,EAAE,4BAA4B,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;CAMvG;AAED,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,0BAA0B,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA4DzG;AAED,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,0BAA0B,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAQ1G;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA0B7F;AAED,wBAAsB,YAAY,CAChC,OAAO,EAAE,mBAAmB,EAC5B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAWrC"}