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

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}`);
+    }
+}

package/dist/telemetry/span-tree.d.ts

@@ -0,0 +1,46 @@
+/**
+ * SpanTree — builds a parent/child tree from a flat list of TelemetrySpans.
+ *
+ * Useful for rendering trace waterfalls, computing subtree durations, and
+ * serializing trace hierarchies to JSON for the observer UI.
+ */
+import type { TelemetrySpan } from "./types";
+/** A tree node wrapping a span with its children. */
+export interface SpanTreeNode {
+    readonly span: TelemetrySpan;
+    readonly children: SpanTreeNode[];
+}
+/** Serializable representation of a SpanTreeNode. */
+export interface SerializedSpanTreeNode {
+    readonly spanId: string;
+    readonly name: string;
+    readonly traceId: string;
+    readonly parentSpanId?: string;
+    readonly startTime: string;
+    readonly endTime?: string;
+    readonly status: string;
+    readonly attributes: Record<string, string | number | boolean>;
+    readonly events: Array<{
+        readonly name: string;
+        readonly timestamp: string;
+        readonly attributes?: Record<string, string | number | boolean>;
+    }>;
+    readonly children: SerializedSpanTreeNode[];
+}
+/** Tree built from a flat span list. */
+export declare class SpanTree {
+    /** All nodes keyed by spanId for O(1) lookup. */
+    private readonly nodes;
+    /** Root node ids (spans with no parent or whose parent is unknown). */
+    private readonly rootIds;
+    /** Insert a span into the tree, linking it to its parent if present. */
+    addSpan(span: TelemetrySpan): void;
+    /** Get direct children of a span. */
+    getChildren(spanId: string): TelemetrySpan[];
+    /** Get top-level spans (those with no parent). */
+    getRoots(): TelemetrySpan[];
+    /** Serialize the full tree to a JSON-safe structure. */
+    toJSON(): SerializedSpanTreeNode[];
+    private serializeNode;
+}
+//# sourceMappingURL=span-tree.d.ts.map

package/dist/telemetry/span-tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"span-tree.d.ts","sourceRoot":"","sources":["../../src/telemetry/span-tree.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAM7C,qDAAqD;AACrD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,YAAY,EAAE,CAAC;CACnC;AAED,qDAAqD;AACrD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;IAC/D,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;QACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;KACjE,CAAC,CAAC;IACH,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,EAAE,CAAC;CAC7C;AAMD,wCAAwC;AACxC,qBAAa,QAAQ;IACnB,iDAAiD;IACjD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAmC;IACzD,uEAAuE;IACvE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IAExC,wEAAwE;IACxE,OAAO,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI;IAgClC,qCAAqC;IACrC,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,EAAE;IAM5C,kDAAkD;IAClD,QAAQ,IAAI,aAAa,EAAE;IAO3B,wDAAwD;IACxD,MAAM,IAAI,sBAAsB,EAAE;IAOlC,OAAO,CAAC,aAAa;CAmBtB"}

package/dist/telemetry/span-tree.js

@@ -0,0 +1,93 @@
+"use strict";
+/**
+ * SpanTree — builds a parent/child tree from a flat list of TelemetrySpans.
+ *
+ * Useful for rendering trace waterfalls, computing subtree durations, and
+ * serializing trace hierarchies to JSON for the observer UI.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SpanTree = void 0;
+// ---------------------------------------------------------------------------
+// Implementation
+// ---------------------------------------------------------------------------
+/** Tree built from a flat span list. */
+class SpanTree {
+    /** All nodes keyed by spanId for O(1) lookup. */
+    nodes = new Map();
+    /** Root node ids (spans with no parent or whose parent is unknown). */
+    rootIds = [];
+    /** Insert a span into the tree, linking it to its parent if present. */
+    addSpan(span) {
+        // Create or retrieve the node for this span.
+        let node = this.nodes.get(span.spanId);
+        if (node) {
+            // Node was pre-created as a placeholder by a child — update the span.
+            node.span = span;
+        }
+        else {
+            node = { span, children: [] };
+            this.nodes.set(span.spanId, node);
+        }
+        if (span.parentSpanId) {
+            let parentNode = this.nodes.get(span.parentSpanId);
+            if (!parentNode) {
+                // Parent hasn't been added yet — create a placeholder.
+                parentNode = {
+                    span: undefined,
+                    children: [],
+                };
+                this.nodes.set(span.parentSpanId, parentNode);
+            }
+            // Avoid duplicate children on re-add.
+            if (!parentNode.children.some((c) => c.span?.spanId === span.spanId)) {
+                parentNode.children.push(node);
+            }
+        }
+        else {
+            if (!this.rootIds.includes(span.spanId)) {
+                this.rootIds.push(span.spanId);
+            }
+        }
+    }
+    /** Get direct children of a span. */
+    getChildren(spanId) {
+        const node = this.nodes.get(spanId);
+        if (!node)
+            return [];
+        return node.children.map((c) => c.span);
+    }
+    /** Get top-level spans (those with no parent). */
+    getRoots() {
+        return this.rootIds
+            .map((id) => this.nodes.get(id))
+            .filter((n) => n != null && n.span != null)
+            .map((n) => n.span);
+    }
+    /** Serialize the full tree to a JSON-safe structure. */
+    toJSON() {
+        return this.getRoots()
+            .map((root) => this.nodes.get(root.spanId))
+            .filter((n) => n != null)
+            .map((n) => this.serializeNode(n));
+    }
+    serializeNode(node) {
+        const { span } = node;
+        return {
+            spanId: span.spanId,
+            name: span.name,
+            traceId: span.traceId,
+            parentSpanId: span.parentSpanId,
+            startTime: span.startTime,
+            endTime: span.endTime,
+            status: span.status,
+            attributes: { ...span.attributes },
+            events: span.events.map((e) => ({
+                name: e.name,
+                timestamp: e.timestamp,
+                ...(e.attributes ? { attributes: { ...e.attributes } } : {}),
+            })),
+            children: node.children.map((c) => this.serializeNode(c)),
+        };
+    }
+}
+exports.SpanTree = SpanTree;

package/dist/telemetry/traceContext.d.ts

@@ -0,0 +1,10 @@
+import type { TraceContext } from "./types";
+export declare function parseTraceParent(header: string): TraceContext | null;
+export declare function serializeTraceParent(context: TraceContext): string;
+export interface CreateTraceContextOptions {
+    parent?: TraceContext;
+    correlationId?: string;
+    sampled?: boolean;
+}
+export declare function createTraceContext(options?: CreateTraceContextOptions): TraceContext;
+//# sourceMappingURL=traceContext.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"traceContext.d.ts","sourceRoot":"","sources":["../../src/telemetry/traceContext.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAQ5C,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAQpE;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAElE;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,wBAAgB,kBAAkB,CAAC,OAAO,CAAC,EAAE,yBAAyB,GAAG,YAAY,CAYpF"}

package/dist/telemetry/traceContext.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseTraceParent = parseTraceParent;
+exports.serializeTraceParent = serializeTraceParent;
+exports.createTraceContext = createTraceContext;
+const node_crypto_1 = require("node:crypto");
+const TRACEPARENT_PATTERN = /^([0-9a-f]{2})-([0-9a-f]{32})-([0-9a-f]{16})-([0-9a-f]{2})$/;
+function allZero(value) {
+    return /^0+$/.test(value);
+}
+function parseTraceParent(header) {
+    const match = TRACEPARENT_PATTERN.exec(header.trim());
+    if (!match)
+        return null;
+    const [, version, traceId, spanId, traceFlags] = match;
+    if (version !== "00" || allZero(traceId) || allZero(spanId)) {
+        return null;
+    }
+    return { version, traceId, spanId, traceFlags };
+}
+function serializeTraceParent(context) {
+    return `${context.version}-${context.traceId}-${context.spanId}-${context.traceFlags}`;
+}
+function createTraceContext(options) {
+    const traceId = options?.parent?.traceId ?? randomHex(16);
+    const spanId = randomHex(8);
+    const traceFlags = options?.sampled === false ? "00" : options?.parent?.traceFlags ?? "01";
+    return {
+        version: "00",
+        traceId,
+        spanId,
+        traceFlags,
+        parentSpanId: options?.parent?.spanId,
+        correlationId: options?.correlationId ?? options?.parent?.correlationId,
+    };
+}
+function randomHex(bytes) {
+    let value = (0, node_crypto_1.randomBytes)(bytes).toString("hex");
+    while (allZero(value)) {
+        value = (0, node_crypto_1.randomBytes)(bytes).toString("hex");
+    }
+    return value;
+}

package/dist/telemetry/types.d.ts

@@ -0,0 +1,109 @@
+/**
+ * OpenTelemetry-aligned structured telemetry interfaces for Babysitter Agent Runtime.
+ *
+ * These are interface-only type stubs — implementations will follow in issue #217.
+ */
+/** Status of a telemetry span, aligned with OpenTelemetry StatusCode. */
+export declare enum TelemetrySpanStatus {
+    /** The span completed without error. */
+    Ok = "Ok",
+    /** The span ended with an error. */
+    Error = "Error",
+    /** Status has not been explicitly set (default). */
+    Unset = "Unset"
+}
+/** A discrete event recorded within a span. */
+export interface TelemetryEvent {
+    /** Human-readable event name. */
+    readonly name: string;
+    /** ISO-8601 timestamp of when the event occurred. */
+    readonly timestamp: string;
+    /** Optional key-value attributes attached to the event. */
+    readonly attributes?: Record<string, string | number | boolean>;
+}
+/** A unit of work within a trace, aligned with the OpenTelemetry Span model. */
+export interface TelemetrySpan {
+    /** Human-readable span name. */
+    readonly name: string;
+    /** Trace identifier shared across the entire distributed trace. */
+    readonly traceId: string;
+    /** Unique identifier for this span within the trace. */
+    readonly spanId: string;
+    /** Span ID of the parent span, if this is a child span. */
+    readonly parentSpanId?: string;
+    /** ISO-8601 timestamp when the span started. */
+    readonly startTime: string;
+    /** ISO-8601 timestamp when the span ended; undefined while in-flight. */
+    readonly endTime?: string;
+    /** Terminal status of the span. */
+    readonly status: TelemetrySpanStatus;
+    /** Key-value attributes attached to the span. */
+    readonly attributes: Record<string, string | number | boolean>;
+    /** Discrete events recorded during the span's lifetime. */
+    readonly events: TelemetryEvent[];
+}
+export interface TraceContext {
+    readonly version: "00";
+    readonly traceId: string;
+    readonly spanId: string;
+    readonly traceFlags: string;
+    readonly parentSpanId?: string;
+    readonly correlationId?: string;
+}
+export interface TelemetrySpanStartOptions {
+    readonly parentSpanId?: string;
+    readonly traceContext?: TraceContext;
+    readonly correlationId?: string;
+    readonly attributes?: Record<string, string | number | boolean>;
+}
+/** Abstraction over a telemetry backend (e.g. OTLP exporter, console, no-op). */
+export interface TelemetryProvider {
+    /**
+     * Begin a new span.
+     *
+     * @param name - Human-readable span name.
+     * @param parentSpanId - Optional parent span to nest under.
+     * @returns The newly created span.
+     */
+    startSpan(name: string, parentSpanId?: string): Promise<TelemetrySpan>;
+    startSpan(name: string, options?: TelemetrySpanStartOptions): Promise<TelemetrySpan>;
+    /**
+     * End an in-flight span.
+     *
+     * @param spanId - ID of the span to end.
+     * @param status - Terminal status; defaults to `Ok` if omitted.
+     */
+    endSpan(spanId: string, status?: TelemetrySpanStatus): Promise<void>;
+    /**
+     * Record a discrete event on an active span.
+     *
+     * @param spanId - ID of the span to attach the event to.
+     * @param event - The event payload.
+     */
+    recordEvent(spanId: string, event: TelemetryEvent): Promise<void>;
+    /**
+     * Flush any buffered telemetry data to the configured exporters.
+     */
+    flush(): Promise<void>;
+}
+/** Configuration for the telemetry subsystem. */
+export interface TelemetryConfig {
+    /** Whether telemetry collection is enabled. */
+    readonly enabled: boolean;
+    /** Provider implementation to use; when absent a no-op provider is assumed. */
+    readonly provider?: TelemetryProvider;
+    /** Sampling rate between 0 (none) and 1 (all traces). */
+    readonly sampleRate?: number;
+    /** Named exporters to send telemetry data to (e.g. "otlp", "console", "file"). */
+    readonly exporters?: string[];
+}
+export interface TelemetryExportResult {
+    readonly ok: boolean;
+    readonly exported: number;
+    readonly error?: string;
+}
+export interface TelemetryExporter {
+    export(spans: readonly TelemetrySpan[]): Promise<TelemetryExportResult>;
+    flush?(): Promise<TelemetryExportResult>;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/telemetry/types.js

@@ -0,0 +1,21 @@
+"use strict";
+/**
+ * OpenTelemetry-aligned structured telemetry interfaces for Babysitter Agent Runtime.
+ *
+ * These are interface-only type stubs — implementations will follow in issue #217.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TelemetrySpanStatus = void 0;
+// ---------------------------------------------------------------------------
+// Span Status
+// ---------------------------------------------------------------------------
+/** Status of a telemetry span, aligned with OpenTelemetry StatusCode. */
+var TelemetrySpanStatus;
+(function (TelemetrySpanStatus) {
+    /** The span completed without error. */
+    TelemetrySpanStatus["Ok"] = "Ok";
+    /** The span ended with an error. */
+    TelemetrySpanStatus["Error"] = "Error";
+    /** Status has not been explicitly set (default). */
+    TelemetrySpanStatus["Unset"] = "Unset";
+})(TelemetrySpanStatus || (exports.TelemetrySpanStatus = TelemetrySpanStatus = {}));

package/dist/types/sdk.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Locally-defined types that mirror the SDK storage/runtime types needed
+ * by genty-runtime modules.
+ *
+ * These replace direct `@a5c-ai/babysitter-sdk` type imports so the runtime
+ * package does not depend on SDK type definitions at compile time.
+ */
+/** A JSON-serialisable record. */
+export type JsonRecord = Record<string, unknown>;
+export interface JournalEvent {
+    seq: number;
+    ulid: string;
+    filename: string;
+    path: string;
+    type: string;
+    recordedAt: string;
+    sdkVersion?: string;
+    data: JsonRecord;
+    checksum?: string;
+}
+export interface AppendEventOptions {
+    runDir: string;
+    event: JsonRecord;
+    eventType: string;
+}
+export interface AppendEventResult {
+    seq: number;
+    ulid: string;
+    filename: string;
+    checksum: string;
+    path: string;
+    recordedAt: string;
+}
+export interface RunEntrypointMetadata {
+    importPath: string;
+    exportName?: string;
+}
+export interface RunMetadata extends JsonRecord {
+    runId: string;
+    request: string;
+    processId: string;
+    sdkVersion?: string;
+    harness?: string;
+    entrypoint: RunEntrypointMetadata;
+    processPath?: string;
+    processRevision?: string;
+    layoutVersion: string;
+    createdAt: string;
+    prompt?: string;
+}
+/** Index over all effects in a run, queryable by effectId. */
+export interface EffectIndex {
+    listEffects(): Array<{
+        effectId: string;
+        taskId: string;
+        kind?: string;
+        status?: string;
+        inputTokens?: number;
+        outputTokens?: number;
+        cacheCreationInputTokens?: number;
+        cacheReadInputTokens?: number;
+        costUsd?: number;
+        costModel?: string;
+    }>;
+}
+//# sourceMappingURL=sdk.d.ts.map

package/dist/types/sdk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../../src/types/sdk.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,kCAAkC;AAClC,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAIjD,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,UAAU,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAID,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAY,SAAQ,UAAU;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,qBAAqB,CAAC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAID,8DAA8D;AAC9D,MAAM,WAAW,WAAW;IAC1B,WAAW,IAAI,KAAK,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,wBAAwB,CAAC,EAAE,MAAM,CAAC;QAClC,oBAAoB,CAAC,EAAE,MAAM,CAAC;QAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC,CAAC;CACJ"}