@a5c-ai/genty-runtime 5.1.1-staging.0007199a1cb2

package/dist/storage/journal.js

@@ -0,0 +1,165 @@
+"use strict";
+/**
+ * Local journal read/write utilities for genty-runtime.
+ *
+ * These are genty-owned implementations that replicate the subset of SDK
+ * storage functions needed by runtime modules (observability, cost tracking).
+ * They operate on the same on-disk layout as the SDK journal but do not
+ * import from @a5c-ai/babysitter-sdk.
+ */
+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.appendEvent = appendEvent;
+exports.loadJournal = loadJournal;
+const node_fs_1 = require("node:fs");
+const path = __importStar(require("node:path"));
+const crypto = __importStar(require("node:crypto"));
+const ulid_1 = require("../utils/ulid");
+// ── Constants ────────────────────────────────────────────────────────────
+const JOURNAL_DIR = "journal";
+const RUN_METADATA_FILE = "run.json";
+function getJournalDir(runDir) {
+    return path.join(runDir, JOURNAL_DIR);
+}
+function formatSeq(seq) {
+    return seq.toString().padStart(6, "0");
+}
+// ── Serialised append queue (prevents concurrent writes to the same run) ─
+const appendQueues = new Map();
+async function withAppendQueue(runDir, op) {
+    const key = path.resolve(runDir);
+    const prev = appendQueues.get(key) ?? Promise.resolve();
+    const next = prev
+        .catch(() => {
+        /* swallow previous failure so queue keeps moving */
+    })
+        .then(op);
+    const tail = next.then(() => undefined, () => undefined);
+    appendQueues.set(key, tail);
+    try {
+        return await next;
+    }
+    finally {
+        if (appendQueues.get(key) === tail) {
+            appendQueues.delete(key);
+        }
+    }
+}
+// ── Write ────────────────────────────────────────────────────────────────
+async function getExistingSeqs(journalDir) {
+    try {
+        const entries = await node_fs_1.promises.readdir(journalDir);
+        return entries
+            .map((name) => Number(name.split(".")[0]))
+            .filter((n) => Number.isFinite(n));
+    }
+    catch (error) {
+        const err = error;
+        if (err.code === "ENOENT")
+            return [];
+        throw error;
+    }
+}
+async function appendEvent(opts) {
+    return withAppendQueue(opts.runDir, async () => {
+        const journalDir = getJournalDir(opts.runDir);
+        await node_fs_1.promises.mkdir(journalDir, { recursive: true });
+        const seqs = await getExistingSeqs(journalDir);
+        const seq = (seqs.length ? Math.max(...seqs) : 0) + 1;
+        const ulid = (0, ulid_1.nextUlid)();
+        const filename = `${formatSeq(seq)}.${ulid}.json`;
+        const recordedAt = new Date().toISOString();
+        const eventPayload = {
+            type: opts.eventType,
+            recordedAt,
+            data: opts.event,
+        };
+        const contents = JSON.stringify(eventPayload, null, 2) + "\n";
+        const checksum = crypto.createHash("sha256").update(contents).digest("hex");
+        const payloadWithChecksum = JSON.stringify({ ...eventPayload, checksum }, null, 2) + "\n";
+        const targetPath = path.join(journalDir, filename);
+        await node_fs_1.promises.writeFile(targetPath, payloadWithChecksum, "utf8");
+        return { seq, ulid, filename, checksum, path: targetPath, recordedAt };
+    });
+}
+// ── Read ─────────────────────────────────────────────────────────────────
+function parseJournalFilename(filename) {
+    const [seqPart, ulidPart] = filename.replace(/\.json$/i, "").split(".");
+    const seq = Number(seqPart);
+    if (!Number.isFinite(seq) || !ulidPart) {
+        throw new Error(`Invalid journal filename: ${filename}`);
+    }
+    return { seq, ulid: ulidPart };
+}
+async function loadJournal(runDir) {
+    const journalDir = getJournalDir(runDir);
+    try {
+        const entries = await node_fs_1.promises.readdir(journalDir);
+        const sorted = entries.filter((name) => name.endsWith(".json")).sort();
+        const events = [];
+        for (const file of sorted) {
+            const { seq, ulid } = parseJournalFilename(file);
+            const fullPath = path.join(journalDir, file);
+            const contents = await node_fs_1.promises.readFile(fullPath, "utf8");
+            let raw;
+            try {
+                raw = JSON.parse(contents);
+            }
+            catch (error) {
+                const parseError = new Error(`Failed to parse journal file ${fullPath}: ${error.message}`);
+                parseError.code = "JOURNAL_PARSE_FAILED";
+                throw parseError;
+            }
+            events.push({
+                seq,
+                ulid,
+                filename: file,
+                path: fullPath,
+                type: raw.type ?? "UNKNOWN",
+                recordedAt: typeof raw.recordedAt === "string" ? raw.recordedAt : new Date().toISOString(),
+                sdkVersion: typeof raw.sdkVersion === "string" ? raw.sdkVersion : undefined,
+                data: raw.data ?? {},
+                checksum: typeof raw.checksum === "string" ? raw.checksum : undefined,
+            });
+        }
+        return events;
+    }
+    catch (error) {
+        const err = error;
+        if (err.code === "ENOENT")
+            return [];
+        throw error;
+    }
+}

package/dist/storage/runFiles.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Local run-file utilities for genty-runtime.
+ *
+ * Reads run metadata from the standard on-disk layout without importing
+ * from @a5c-ai/babysitter-sdk.
+ */
+import type { RunMetadata } from "../types/sdk";
+export declare function readRunMetadata(runDir: string): Promise<RunMetadata>;
+export declare function getRunDir(runsRoot: string, runId: string): string;
+//# sourceMappingURL=runFiles.d.ts.map

package/dist/storage/runFiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runFiles.d.ts","sourceRoot":"","sources":["../../src/storage/runFiles.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAIhD,wBAAsB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAI1E;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjE"}

package/dist/storage/runFiles.js

@@ -0,0 +1,54 @@
+"use strict";
+/**
+ * Local run-file utilities for genty-runtime.
+ *
+ * Reads run metadata from the standard on-disk layout without importing
+ * from @a5c-ai/babysitter-sdk.
+ */
+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.readRunMetadata = readRunMetadata;
+exports.getRunDir = getRunDir;
+const node_fs_1 = require("node:fs");
+const path = __importStar(require("node:path"));
+const RUN_METADATA_FILE = "run.json";
+async function readRunMetadata(runDir) {
+    const metadataPath = path.join(runDir, RUN_METADATA_FILE);
+    const raw = await node_fs_1.promises.readFile(metadataPath, "utf8");
+    return JSON.parse(raw);
+}
+function getRunDir(runsRoot, runId) {
+    return path.join(runsRoot, runId);
+}

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"}