@a5c-ai/genty-runtime 5.1.1-staging.00ceebd28cf2

package/dist/telemetry/audit-log.d.ts

@@ -0,0 +1,56 @@
+/**
+ * AuditLog — append-only structured log for security-relevant and
+ * compliance-relevant actions within a babysitter agent runtime session.
+ *
+ * Each entry captures *who* did *what* to *which target*, with an optional
+ * telemetry span correlation. Entries are queryable by actor, action, and
+ * time range.
+ */
+/** A single audit log entry. */
+export interface AuditEntry {
+    /** Who performed the action (user id, agent name, system, etc.). */
+    readonly actor: string;
+    /** What action was performed. */
+    readonly action: string;
+    /** What the action was performed on (resource, span, task, etc.). */
+    readonly target: string;
+    /** Optional human-readable detail or serialized context. */
+    readonly detail?: string;
+    /** Optional telemetry span ID to correlate with the span tree. */
+    readonly spanId?: string;
+    /** ISO-8601 timestamp of when the entry was recorded. */
+    readonly timestamp: string;
+}
+/** Filter criteria for querying the audit log. */
+export interface AuditFilter {
+    /** Match entries from this actor. */
+    actor?: string;
+    /** Match entries with this action. */
+    action?: string;
+    /** Match entries recorded at or after this ISO-8601 timestamp. */
+    from?: string;
+    /** Match entries recorded at or before this ISO-8601 timestamp. */
+    to?: string;
+}
+/** Append-only in-memory audit log. */
+export declare class AuditLog {
+    private readonly entries;
+    /**
+     * Record a new audit entry.
+     *
+     * The timestamp is auto-populated to the current time.
+     */
+    record(entry: Omit<AuditEntry, "timestamp">): AuditEntry;
+    /**
+     * Query log entries with optional filters.
+     *
+     * All supplied filter fields are AND-ed together. Omitted fields match
+     * everything.
+     */
+    getEntries(filter?: AuditFilter): AuditEntry[];
+    /** Total number of entries in the log. */
+    get size(): number;
+    /** Clear all entries (useful in tests or session resets). */
+    clear(): void;
+}
+//# sourceMappingURL=audit-log.d.ts.map

package/dist/telemetry/audit-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-log.d.ts","sourceRoot":"","sources":["../../src/telemetry/audit-log.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,gCAAgC;AAChC,MAAM,WAAW,UAAU;IACzB,oEAAoE;IACpE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,iCAAiC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,qEAAqE;IACrE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,4DAA4D;IAC5D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,kEAAkE;IAClE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,yDAAyD;IACzD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,kDAAkD;AAClD,MAAM,WAAW,WAAW;IAC1B,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAMD,uCAAuC;AACvC,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;IAE5C;;;;OAIG;IACH,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,GAAG,UAAU;IAMxD;;;;;OAKG;IACH,UAAU,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,UAAU,EAAE;IAc9C,0CAA0C;IAC1C,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,6DAA6D;IAC7D,KAAK,IAAI,IAAI;CAGd"}

package/dist/telemetry/audit-log.js

@@ -0,0 +1,59 @@
+"use strict";
+/**
+ * AuditLog — append-only structured log for security-relevant and
+ * compliance-relevant actions within a babysitter agent runtime session.
+ *
+ * Each entry captures *who* did *what* to *which target*, with an optional
+ * telemetry span correlation. Entries are queryable by actor, action, and
+ * time range.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuditLog = void 0;
+// ---------------------------------------------------------------------------
+// Implementation
+// ---------------------------------------------------------------------------
+/** Append-only in-memory audit log. */
+class AuditLog {
+    entries = [];
+    /**
+     * Record a new audit entry.
+     *
+     * The timestamp is auto-populated to the current time.
+     */
+    record(entry) {
+        const full = { ...entry, timestamp: new Date().toISOString() };
+        this.entries.push(full);
+        return full;
+    }
+    /**
+     * Query log entries with optional filters.
+     *
+     * All supplied filter fields are AND-ed together. Omitted fields match
+     * everything.
+     */
+    getEntries(filter) {
+        if (!filter) {
+            return [...this.entries];
+        }
+        return this.entries.filter((e) => {
+            if (filter.actor && e.actor !== filter.actor)
+                return false;
+            if (filter.action && e.action !== filter.action)
+                return false;
+            if (filter.from && e.timestamp < filter.from)
+                return false;
+            if (filter.to && e.timestamp > filter.to)
+                return false;
+            return true;
+        });
+    }
+    /** Total number of entries in the log. */
+    get size() {
+        return this.entries.length;
+    }
+    /** Clear all entries (useful in tests or session resets). */
+    clear() {
+        this.entries.length = 0;
+    }
+}
+exports.AuditLog = AuditLog;

package/dist/telemetry/exporters.d.ts

@@ -0,0 +1,35 @@
+import type { TelemetryExporter, TelemetryExportResult, TelemetrySpan } from "./types";
+export declare class NoopTelemetryExporter implements TelemetryExporter {
+    export(spans: readonly TelemetrySpan[]): Promise<TelemetryExportResult>;
+    flush(): Promise<TelemetryExportResult>;
+}
+export declare class InMemoryTelemetryExporter implements TelemetryExporter {
+    private readonly spans;
+    export(spans: readonly TelemetrySpan[]): Promise<TelemetryExportResult>;
+    getSpans(): TelemetrySpan[];
+    clear(): void;
+}
+export declare class FileTelemetryExporter implements TelemetryExporter {
+    private readonly filePath;
+    constructor(filePath: string);
+    export(spans: readonly TelemetrySpan[]): Promise<TelemetryExportResult>;
+}
+export interface OtlpHttpTraceExporterOptions {
+    endpoint: string;
+    headers?: Record<string, string>;
+    fetch?: (input: string, init: {
+        method: string;
+        headers: Record<string, string>;
+        body: string;
+    }) => Promise<{
+        ok: boolean;
+        status: number;
+        text?: () => Promise<string>;
+    }>;
+}
+export declare class OtlpHttpTraceExporter implements TelemetryExporter {
+    private readonly options;
+    constructor(options: OtlpHttpTraceExporterOptions);
+    export(spans: readonly TelemetrySpan[]): Promise<TelemetryExportResult>;
+}
+//# sourceMappingURL=exporters.d.ts.map

package/dist/telemetry/exporters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exporters.d.ts","sourceRoot":"","sources":["../../src/telemetry/exporters.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,iBAAiB,EACjB,qBAAqB,EACrB,aAAa,EACd,MAAM,SAAS,CAAC;AAEjB,qBAAa,qBAAsB,YAAW,iBAAiB;IACvD,MAAM,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAIvE,KAAK,IAAI,OAAO,CAAC,qBAAqB,CAAC;CAG9C;AAED,qBAAa,yBAA0B,YAAW,iBAAiB;IACjE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuB;IAEvC,MAAM,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAK7E,QAAQ,IAAI,aAAa,EAAE;IAI3B,KAAK,IAAI,IAAI;CAGd;AAED,qBAAa,qBAAsB,YAAW,iBAAiB;IACjD,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,MAAM;IAEvC,MAAM,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,GAAG,OAAO,CAAC,qBAAqB,CAAC;CAQ9E;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE;QAC5B,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAChC,IAAI,EAAE,MAAM,CAAC;KACd,KAAK,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAA;KAAE,CAAC,CAAC;CAC9E;AAED,qBAAa,qBAAsB,YAAW,iBAAiB;IACjD,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,4BAA4B;IAE5D,MAAM,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,GAAG,OAAO,CAAC,qBAAqB,CAAC;CAgC9E"}

package/dist/telemetry/exporters.js

@@ -0,0 +1,141 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OtlpHttpTraceExporter = exports.FileTelemetryExporter = exports.InMemoryTelemetryExporter = exports.NoopTelemetryExporter = void 0;
+const node_fs_1 = require("node:fs");
+const path = __importStar(require("node:path"));
+class NoopTelemetryExporter {
+    async export(spans) {
+        return { ok: true, exported: spans.length };
+    }
+    async flush() {
+        return { ok: true, exported: 0 };
+    }
+}
+exports.NoopTelemetryExporter = NoopTelemetryExporter;
+class InMemoryTelemetryExporter {
+    spans = [];
+    async export(spans) {
+        this.spans.push(...spans.map(cloneSpan));
+        return { ok: true, exported: spans.length };
+    }
+    getSpans() {
+        return this.spans.map(cloneSpan);
+    }
+    clear() {
+        this.spans.length = 0;
+    }
+}
+exports.InMemoryTelemetryExporter = InMemoryTelemetryExporter;
+class FileTelemetryExporter {
+    filePath;
+    constructor(filePath) {
+        this.filePath = filePath;
+    }
+    async export(spans) {
+        await node_fs_1.promises.mkdir(path.dirname(this.filePath), { recursive: true });
+        const lines = spans.map((span) => JSON.stringify(span)).join("\n");
+        if (lines) {
+            await node_fs_1.promises.appendFile(this.filePath, `${lines}\n`, "utf-8");
+        }
+        return { ok: true, exported: spans.length };
+    }
+}
+exports.FileTelemetryExporter = FileTelemetryExporter;
+class OtlpHttpTraceExporter {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    async export(spans) {
+        const fetchImpl = this.options.fetch ?? globalThis.fetch;
+        if (!fetchImpl) {
+            return { ok: false, exported: 0, error: "fetch is not available" };
+        }
+        try {
+            const response = await fetchImpl(this.options.endpoint, {
+                method: "POST",
+                headers: {
+                    "content-type": "application/json",
+                    ...this.options.headers,
+                },
+                body: JSON.stringify({ resourceSpans: spans.map(toOtlpSpan) }),
+            });
+            if (!response.ok) {
+                const text = response.text ? await response.text() : "";
+                return {
+                    ok: false,
+                    exported: 0,
+                    error: `OTLP HTTP export failed with status ${response.status}${text ? `: ${text}` : ""}`,
+                };
+            }
+            return { ok: true, exported: spans.length };
+        }
+        catch (error) {
+            return {
+                ok: false,
+                exported: 0,
+                error: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+}
+exports.OtlpHttpTraceExporter = OtlpHttpTraceExporter;
+function cloneSpan(span) {
+    return {
+        ...span,
+        attributes: { ...span.attributes },
+        events: span.events.map((event) => ({
+            ...event,
+            attributes: event.attributes ? { ...event.attributes } : undefined,
+        })),
+    };
+}
+function toOtlpSpan(span) {
+    return {
+        traceId: span.traceId,
+        spanId: span.spanId,
+        parentSpanId: span.parentSpanId,
+        name: span.name,
+        startTimeUnixNano: Date.parse(span.startTime) * 1_000_000,
+        endTimeUnixNano: span.endTime ? Date.parse(span.endTime) * 1_000_000 : undefined,
+        status: { code: span.status },
+        attributes: Object.entries(span.attributes).map(([key, value]) => ({
+            key,
+            value,
+        })),
+        events: span.events,
+    };
+}

package/dist/telemetry/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Telemetry module — OpenTelemetry-aligned structured telemetry interfaces
+ * and in-memory implementations.
+ */
+export { TelemetrySpanStatus, type TelemetryEvent, type TelemetrySpan, type TelemetryProvider, type TelemetryExporter, type TelemetryConfig, type TraceContext, type TelemetrySpanStartOptions, type TelemetryExportResult, } from "./types";
+export { HttpTelemetryExporter, InMemoryTelemetryProvider, } from "./provider";
+export type { HttpTelemetrySend, InMemoryTelemetryProviderOptions, } from "./provider";
+export { AuditLog, type AuditEntry, type AuditFilter, } from "./audit-log";
+export { SpanTree, type SpanTreeNode, type SerializedSpanTreeNode, } from "./span-tree";
+export { createTraceContext, parseTraceParent, serializeTraceParent, type CreateTraceContextOptions, } from "./traceContext";
+export { FileTelemetryExporter, InMemoryTelemetryExporter, NoopTelemetryExporter, OtlpHttpTraceExporter, type OtlpHttpTraceExporterOptions, } from "./exporters";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/telemetry/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EACL,mBAAmB,EACnB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,yBAAyB,EAC9B,KAAK,qBAAqB,GAC3B,MAAM,SAAS,CAAC;AAEjB,OAAO,EACL,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,iBAAiB,EACjB,gCAAgC,GACjC,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,QAAQ,EACR,KAAK,UAAU,EACf,KAAK,WAAW,GACjB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,QAAQ,EACR,KAAK,YAAY,EACjB,KAAK,sBAAsB,GAC5B,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,KAAK,yBAAyB,GAC/B,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,qBAAqB,EACrB,yBAAyB,EACzB,qBAAqB,EACrB,qBAAqB,EACrB,KAAK,4BAA4B,GAClC,MAAM,aAAa,CAAC"}

package/dist/telemetry/index.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OtlpHttpTraceExporter = exports.NoopTelemetryExporter = exports.InMemoryTelemetryExporter = exports.FileTelemetryExporter = exports.serializeTraceParent = exports.parseTraceParent = exports.createTraceContext = exports.SpanTree = exports.AuditLog = exports.InMemoryTelemetryProvider = exports.HttpTelemetryExporter = exports.TelemetrySpanStatus = void 0;
+/**
+ * Telemetry module — OpenTelemetry-aligned structured telemetry interfaces
+ * and in-memory implementations.
+ */
+var types_1 = require("./types");
+Object.defineProperty(exports, "TelemetrySpanStatus", { enumerable: true, get: function () { return types_1.TelemetrySpanStatus; } });
+var provider_1 = require("./provider");
+Object.defineProperty(exports, "HttpTelemetryExporter", { enumerable: true, get: function () { return provider_1.HttpTelemetryExporter; } });
+Object.defineProperty(exports, "InMemoryTelemetryProvider", { enumerable: true, get: function () { return provider_1.InMemoryTelemetryProvider; } });
+var audit_log_1 = require("./audit-log");
+Object.defineProperty(exports, "AuditLog", { enumerable: true, get: function () { return audit_log_1.AuditLog; } });
+var span_tree_1 = require("./span-tree");
+Object.defineProperty(exports, "SpanTree", { enumerable: true, get: function () { return span_tree_1.SpanTree; } });
+var traceContext_1 = require("./traceContext");
+Object.defineProperty(exports, "createTraceContext", { enumerable: true, get: function () { return traceContext_1.createTraceContext; } });
+Object.defineProperty(exports, "parseTraceParent", { enumerable: true, get: function () { return traceContext_1.parseTraceParent; } });
+Object.defineProperty(exports, "serializeTraceParent", { enumerable: true, get: function () { return traceContext_1.serializeTraceParent; } });
+var exporters_1 = require("./exporters");
+Object.defineProperty(exports, "FileTelemetryExporter", { enumerable: true, get: function () { return exporters_1.FileTelemetryExporter; } });
+Object.defineProperty(exports, "InMemoryTelemetryExporter", { enumerable: true, get: function () { return exporters_1.InMemoryTelemetryExporter; } });
+Object.defineProperty(exports, "NoopTelemetryExporter", { enumerable: true, get: function () { return exporters_1.NoopTelemetryExporter; } });
+Object.defineProperty(exports, "OtlpHttpTraceExporter", { enumerable: true, get: function () { return exporters_1.OtlpHttpTraceExporter; } });

package/dist/telemetry/provider.d.ts

@@ -0,0 +1,57 @@
+/**
+ * InMemoryTelemetryProvider — in-process telemetry backend for development,
+ * testing, and single-process agent runtimes.
+ *
+ * Stores spans in memory and supports flush/drain for export pipelines.
+ */
+import type { TelemetryExporter, TelemetryExportResult, TelemetryProvider, TelemetrySpan, TelemetryEvent, TelemetrySpanStartOptions } from "./types";
+import { TelemetrySpanStatus } from "./types";
+export interface InMemoryTelemetryProviderOptions {
+    exporters?: TelemetryExporter[];
+}
+export declare class FileTelemetryExporter implements TelemetryExporter {
+    private readonly filePath;
+    constructor(filePath: string);
+    export(spans: readonly TelemetrySpan[]): Promise<TelemetryExportResult>;
+}
+export type HttpTelemetrySend = (url: string, payload: unknown) => Promise<void>;
+export declare class HttpTelemetryExporter implements TelemetryExporter {
+    private readonly url;
+    private readonly send;
+    constructor(url: string, send?: HttpTelemetrySend);
+    export(spans: readonly TelemetrySpan[]): Promise<TelemetryExportResult>;
+}
+/**
+ * In-memory telemetry provider that satisfies the TelemetryProvider interface.
+ *
+ * - `startSpan` creates a new span and tracks it as active.
+ * - `endSpan` marks a span as completed and moves it to the completed set.
+ * - `recordEvent` appends a discrete event to an active span.
+ * - `flush` returns all completed spans and clears the completed buffer.
+ * - `getActiveSpans` returns all currently open (un-ended) spans.
+ */
+export declare class InMemoryTelemetryProvider implements TelemetryProvider {
+    /** Active (in-flight) spans keyed by spanId. */
+    private readonly active;
+    /** Completed spans awaiting flush. */
+    private readonly completed;
+    /** Maps spanId -> traceId so child spans inherit the parent's trace. */
+    private readonly traceIndex;
+    private readonly exporters;
+    constructor(options?: InMemoryTelemetryProviderOptions);
+    startSpan(name: string, parentSpanId?: string): Promise<TelemetrySpan>;
+    startSpan(name: string, options?: TelemetrySpanStartOptions): Promise<TelemetrySpan>;
+    endSpan(spanId: string, status?: TelemetrySpanStatus): Promise<void>;
+    recordEvent(spanId: string, event: TelemetryEvent): Promise<void>;
+    flush(): Promise<void>;
+    /**
+     * Drain completed spans — returns and clears the completed buffer.
+     *
+     * Unlike `flush()` (which satisfies the TelemetryProvider interface and
+     * returns void), this method hands the span data back to the caller.
+     */
+    drain(): Promise<TelemetrySpan[]>;
+    /** Return a snapshot of all currently open (un-ended) spans. */
+    getActiveSpans(): TelemetrySpan[];
+}
+//# sourceMappingURL=provider.d.ts.map

package/dist/telemetry/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/telemetry/provider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EACV,iBAAiB,EACjB,qBAAqB,EACrB,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,yBAAyB,EAC1B,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAoB9C,MAAM,WAAW,gCAAgC;IAC/C,SAAS,CAAC,EAAE,iBAAiB,EAAE,CAAC;CACjC;AAED,qBAAa,qBAAsB,YAAW,iBAAiB;IACjD,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,MAAM;IAEvC,MAAM,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,GAAG,OAAO,CAAC,qBAAqB,CAAC;CAO9E;AAED,MAAM,MAAM,iBAAiB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAEjF,qBAAa,qBAAsB,YAAW,iBAAiB;IAE3D,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBADJ,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,iBAAmC;IAGtD,MAAM,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,GAAG,OAAO,CAAC,qBAAqB,CAAC;CAK9E;AAaD;;;;;;;;GAQG;AACH,qBAAa,yBAA0B,YAAW,iBAAiB;IACjE,gDAAgD;IAChD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkC;IACzD,sCAAsC;IACtC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAC/C,wEAAwE;IACxE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA6B;IACxD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsB;gBAEpC,OAAO,CAAC,EAAE,gCAAgC;IAMhD,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IACtE,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC,aAAa,CAAC;IA2CpF,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAapE,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IASjE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ5B;;;;;OAKG;IACG,KAAK,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAMvC,gEAAgE;IAChE,cAAc,IAAI,aAAa,EAAE;CAGlC"}

package/dist/telemetry/provider.js

@@ -0,0 +1,261 @@
+"use strict";
+/**
+ * InMemoryTelemetryProvider — in-process telemetry backend for development,
+ * testing, and single-process agent runtimes.
+ *
+ * Stores spans in memory and supports flush/drain for export pipelines.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InMemoryTelemetryProvider = exports.HttpTelemetryExporter = exports.FileTelemetryExporter = void 0;
+const node_crypto_1 = require("node:crypto");
+const node_fs_1 = require("node:fs");
+const path = __importStar(require("node:path"));
+const types_1 = require("./types");
+class FileTelemetryExporter {
+    filePath;
+    constructor(filePath) {
+        this.filePath = filePath;
+    }
+    async export(spans) {
+        if (spans.length === 0)
+            return { ok: true, exported: 0 };
+        await node_fs_1.promises.mkdir(path.dirname(this.filePath), { recursive: true });
+        const payload = spans.map((span) => JSON.stringify(redactSpan(span))).join("\n") + "\n";
+        await node_fs_1.promises.appendFile(this.filePath, payload, "utf-8");
+        return { ok: true, exported: spans.length };
+    }
+}
+exports.FileTelemetryExporter = FileTelemetryExporter;
+class HttpTelemetryExporter {
+    url;
+    send;
+    constructor(url, send = defaultHttpSend) {
+        this.url = url;
+        this.send = send;
+    }
+    async export(spans) {
+        if (spans.length === 0)
+            return { ok: true, exported: 0 };
+        await this.send(this.url, toOtlpPayload(spans.map(redactSpan)));
+        return { ok: true, exported: spans.length };
+    }
+}
+exports.HttpTelemetryExporter = HttpTelemetryExporter;
+function toReadonly(span) {
+    return {
+        ...span,
+        attributes: { ...span.attributes },
+        events: span.events.map((event) => ({
+            ...event,
+            attributes: event.attributes ? { ...event.attributes } : undefined,
+        })),
+    };
+}
+/**
+ * In-memory telemetry provider that satisfies the TelemetryProvider interface.
+ *
+ * - `startSpan` creates a new span and tracks it as active.
+ * - `endSpan` marks a span as completed and moves it to the completed set.
+ * - `recordEvent` appends a discrete event to an active span.
+ * - `flush` returns all completed spans and clears the completed buffer.
+ * - `getActiveSpans` returns all currently open (un-ended) spans.
+ */
+class InMemoryTelemetryProvider {
+    /** Active (in-flight) spans keyed by spanId. */
+    active = new Map();
+    /** Completed spans awaiting flush. */
+    completed = [];
+    /** Maps spanId -> traceId so child spans inherit the parent's trace. */
+    traceIndex = new Map();
+    exporters;
+    constructor(options) {
+        this.exporters = options?.exporters ?? [];
+    }
+    async startSpan(name, optionsOrParentSpanId) {
+        const spanId = (0, node_crypto_1.randomUUID)();
+        const options = typeof optionsOrParentSpanId === "string"
+            ? { parentSpanId: optionsOrParentSpanId }
+            : optionsOrParentSpanId;
+        const parentSpanId = options?.traceContext?.spanId ?? options?.parentSpanId;
+        let traceId;
+        if (options?.traceContext) {
+            traceId = options.traceContext.traceId;
+        }
+        else if (parentSpanId) {
+            // Inherit traceId from the parent span.
+            traceId = this.traceIndex.get(parentSpanId) ?? (0, node_crypto_1.randomUUID)();
+        }
+        else {
+            traceId = (0, node_crypto_1.randomUUID)();
+        }
+        const span = {
+            name,
+            traceId,
+            spanId,
+            parentSpanId,
+            startTime: new Date().toISOString(),
+            status: types_1.TelemetrySpanStatus.Unset,
+            attributes: {
+                ...options?.attributes,
+                ...(options?.correlationId
+                    ? { "babysitter.correlation_id": options.correlationId }
+                    : {}),
+                ...(options?.traceContext?.correlationId && !options?.correlationId
+                    ? { "babysitter.correlation_id": options.traceContext.correlationId }
+                    : {}),
+            },
+            events: [],
+        };
+        this.active.set(spanId, span);
+        this.traceIndex.set(spanId, traceId);
+        return toReadonly(span);
+    }
+    async endSpan(spanId, status) {
+        const span = this.active.get(spanId);
+        if (!span) {
+            return; // Silently ignore unknown/already-ended spans.
+        }
+        span.endTime = new Date().toISOString();
+        span.status = status ?? types_1.TelemetrySpanStatus.Ok;
+        this.active.delete(spanId);
+        this.completed.push(span);
+    }
+    async recordEvent(spanId, event) {
+        const span = this.active.get(spanId);
+        if (!span) {
+            return; // Silently ignore events on unknown/ended spans.
+        }
+        span.events.push(event);
+    }
+    async flush() {
+        const spans = this.completed.map(toReadonly);
+        for (const exporter of this.exporters) {
+            await exporter.export(spans);
+        }
+        this.completed.length = 0;
+    }
+    /**
+     * Drain completed spans — returns and clears the completed buffer.
+     *
+     * Unlike `flush()` (which satisfies the TelemetryProvider interface and
+     * returns void), this method hands the span data back to the caller.
+     */
+    async drain() {
+        return this.completed.splice(0).map(toReadonly);
+    }
+    // ---------- Extra helpers (not on interface) ----------
+    /** Return a snapshot of all currently open (un-ended) spans. */
+    getActiveSpans() {
+        return [...this.active.values()].map(toReadonly);
+    }
+}
+exports.InMemoryTelemetryProvider = InMemoryTelemetryProvider;
+function redactSpan(span) {
+    return {
+        ...span,
+        attributes: redactAttributes(span.attributes),
+        events: span.events.map((event) => ({
+            ...event,
+            attributes: event.attributes ? redactAttributes(event.attributes) : undefined,
+        })),
+    };
+}
+function redactAttributes(attributes) {
+    return Object.fromEntries(Object.entries(attributes).map(([key, value]) => [
+        key,
+        isSecretKey(key) || (typeof value === "string" && looksSecretValue(value))
+            ? "[REDACTED]"
+            : value,
+    ]));
+}
+function isSecretKey(key) {
+    return /(token|secret|password|api[_-]?key|authorization|credential)/i.test(key);
+}
+function looksSecretValue(value) {
+    return /(bearer\s+\S+|token=\S+|password=\S+|secret=\S+)/i.test(value);
+}
+function toOtlpPayload(spans) {
+    return {
+        resourceSpans: [
+            {
+                resource: { attributes: [] },
+                scopeSpans: [
+                    {
+                        scope: { name: "@a5c-ai/genty-runtime" },
+                        spans: spans.map((span) => ({
+                            traceId: span.traceId,
+                            spanId: span.spanId,
+                            parentSpanId: span.parentSpanId,
+                            name: span.name,
+                            startTimeUnixNano: isoToUnixNano(span.startTime),
+                            endTimeUnixNano: span.endTime ? isoToUnixNano(span.endTime) : undefined,
+                            status: { code: span.status },
+                            attributes: toOtlpAttributes(span.attributes),
+                            events: span.events.map((event) => ({
+                                name: event.name,
+                                timeUnixNano: isoToUnixNano(event.timestamp),
+                                attributes: event.attributes ? toOtlpAttributes(event.attributes) : [],
+                            })),
+                        })),
+                    },
+                ],
+            },
+        ],
+    };
+}
+function toOtlpAttributes(attributes) {
+    return Object.entries(attributes).map(([key, value]) => ({
+        key,
+        value: typeof value === "string"
+            ? { stringValue: value }
+            : typeof value === "number"
+                ? { doubleValue: value }
+                : { boolValue: value },
+    }));
+}
+function isoToUnixNano(value) {
+    return String(BigInt(new Date(value).getTime()) * 1000000n);
+}
+async function defaultHttpSend(url, payload) {
+    const response = await fetch(url, {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify(payload),
+    });
+    if (!response.ok) {
+        throw new Error(`Telemetry export failed with HTTP ${response.status}`);
+    }
+}