@a5c-ai/genty-runtime 5.1.1-staging.0c6199708314

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

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

package/dist/session/types.js

@@ -0,0 +1,45 @@
+"use strict";
+/**
+ * Session state management types for babysitter orchestration.
+ * These types represent the state stored in markdown files with YAML frontmatter.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionErrorCode = exports.SessionError = void 0;
+/**
+ * Error thrown when session operations fail.
+ */
+class SessionError extends Error {
+    code;
+    details;
+    constructor(message, code, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = 'SessionError';
+    }
+}
+exports.SessionError = SessionError;
+/**
+ * Session error codes.
+ */
+var SessionErrorCode;
+(function (SessionErrorCode) {
+    /** Session ID not provided */
+    SessionErrorCode["MISSING_SESSION_ID"] = "MISSING_SESSION_ID";
+    /** State file already exists */
+    SessionErrorCode["SESSION_EXISTS"] = "SESSION_EXISTS";
+    /** State file not found */
+    SessionErrorCode["SESSION_NOT_FOUND"] = "SESSION_NOT_FOUND";
+    /** Run already associated */
+    SessionErrorCode["RUN_ALREADY_ASSOCIATED"] = "RUN_ALREADY_ASSOCIATED";
+    /** Run not found */
+    SessionErrorCode["RUN_NOT_FOUND"] = "RUN_NOT_FOUND";
+    /** Run already completed */
+    SessionErrorCode["RUN_COMPLETED"] = "RUN_COMPLETED";
+    /** State file corrupted */
+    SessionErrorCode["CORRUPTED_STATE"] = "CORRUPTED_STATE";
+    /** Invalid state value */
+    SessionErrorCode["INVALID_STATE_VALUE"] = "INVALID_STATE_VALUE";
+    /** File system error */
+    SessionErrorCode["FS_ERROR"] = "FS_ERROR";
+})(SessionErrorCode || (exports.SessionErrorCode = SessionErrorCode = {}));

package/dist/session/write.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Session state file writing utilities.
+ * Provides atomic writes for session state files.
+ */
+import type { SessionState } from './types';
+/**
+ * Serialize session state to YAML frontmatter format.
+ */
+export declare function serializeSessionState(state: SessionState): string;
+/**
+ * Create full session file content with YAML frontmatter and prompt.
+ */
+export declare function createSessionFileContent(state: SessionState, prompt: string): string;
+/**
+ * Write session state file atomically.
+ * Uses temp file + rename pattern to ensure atomic writes.
+ */
+export declare function writeSessionFile(filePath: string, state: SessionState, prompt: string): Promise<void>;
+/**
+ * Update specific fields in an existing session state file.
+ * Reads, modifies, and atomically writes the file.
+ */
+export declare function updateSessionState(filePath: string, updates: Partial<SessionState>, existingContent?: {
+    state: SessionState;
+    prompt: string;
+}): Promise<SessionState>;
+/**
+ * Bind a new run to the session, retiring the previous active run to history.
+ *
+ * Invariant: only one run is active at a time (`runId`).
+ * The previous `runId` (if any) is pushed into `runIds` as audit history.
+ * Idempotent: re-binding the same runId is a no-op.
+ *
+ * Throws if the caller tries to bind a new run while `runId` is still set
+ * and `retirePrevious` is not explicitly true — this forces callers to
+ * acknowledge that the prior run is done.
+ */
+export declare function addRunToSession(state: SessionState, runId: string, options?: {
+    retirePrevious?: boolean;
+}): SessionState;
+/**
+ * Get the historical audit trail of all run IDs for this session (GAP-SESSION-001).
+ * Falls back to [runId] when runIds is empty for backward compatibility
+ * with sessions created before the runIds field existed.
+ */
+export declare function getSessionRuns(state: SessionState): string[];
+/**
+ * Get current ISO timestamp.
+ */
+export declare function getCurrentTimestamp(): string;
+/**
+ * Convert ISO timestamp to epoch seconds.
+ * Returns null if conversion fails.
+ */
+export declare function isoToEpochSeconds(isoTimestamp: string): number | null;
+/**
+ * Calculate iteration duration and update times array.
+ * Keeps only the last 10 durations for diagnostics.
+ */
+export declare function updateIterationTimes(existingTimes: number[], lastIterationAt: string, currentTime: string): number[];
+//# sourceMappingURL=write.d.ts.map

package/dist/session/write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../src/session/write.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAG5C;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAgBjE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAGpF;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CA6Bf;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,EAC9B,eAAe,CAAC,EAAE;IAAE,KAAK,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACxD,OAAO,CAAC,YAAY,CAAC,CAyBvB;AAGD;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,YAAY,EACnB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;IAAE,cAAc,CAAC,EAAE,OAAO,CAAA;CAAE,GACrC,YAAY,CAyBd;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,EAAE,CAG5D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CASrE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,aAAa,EAAE,MAAM,EAAE,EACvB,eAAe,EAAE,MAAM,EACvB,WAAW,EAAE,MAAM,GAClB,MAAM,EAAE,CAgBV"}

package/dist/session/write.js

@@ -0,0 +1,213 @@
+"use strict";
+/**
+ * Session state file writing utilities.
+ * Provides atomic writes for session state files.
+ */
+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.serializeSessionState = serializeSessionState;
+exports.createSessionFileContent = createSessionFileContent;
+exports.writeSessionFile = writeSessionFile;
+exports.updateSessionState = updateSessionState;
+exports.addRunToSession = addRunToSession;
+exports.getSessionRuns = getSessionRuns;
+exports.getCurrentTimestamp = getCurrentTimestamp;
+exports.isoToEpochSeconds = isoToEpochSeconds;
+exports.updateIterationTimes = updateIterationTimes;
+const node_fs_1 = require("node:fs");
+const path = __importStar(require("node:path"));
+const types_1 = require("./types");
+/**
+ * Serialize session state to YAML frontmatter format.
+ */
+function serializeSessionState(state) {
+    const lines = [];
+    lines.push(`active: ${state.active}`);
+    lines.push(`iteration: ${state.iteration}`);
+    lines.push(`max_iterations: ${state.maxIterations}`);
+    lines.push(`run_id: "${state.runId}"`);
+    lines.push(`run_ids: ${state.runIds.join(',')}`);
+    lines.push(`started_at: "${state.startedAt}"`);
+    lines.push(`last_iteration_at: "${state.lastIterationAt}"`);
+    lines.push(`iteration_times: ${state.iterationTimes.join(',')}`);
+    for (const [key, value] of Object.entries(state.metadata ?? {})) {
+        lines.push(`metadata_${key}: "${String(value).replace(/\\/g, '\\\\').replace(/"/g, '\\"')}"`);
+    }
+    return lines.join('\n');
+}
+/**
+ * Create full session file content with YAML frontmatter and prompt.
+ */
+function createSessionFileContent(state, prompt) {
+    const frontmatter = serializeSessionState(state);
+    return `---\n${frontmatter}\n---\n\n${prompt}\n`;
+}
+/**
+ * Write session state file atomically.
+ * Uses temp file + rename pattern to ensure atomic writes.
+ */
+async function writeSessionFile(filePath, state, prompt) {
+    const content = createSessionFileContent(state, prompt);
+    const dir = path.dirname(filePath);
+    const tempPath = `${filePath}.tmp.${process.pid}`;
+    try {
+        // Ensure directory exists
+        await node_fs_1.promises.mkdir(dir, { recursive: true });
+        // Write to temp file
+        await node_fs_1.promises.writeFile(tempPath, content, 'utf8');
+        // Atomic rename
+        await node_fs_1.promises.rename(tempPath, filePath);
+    }
+    catch (error) {
+        // Clean up temp file on error
+        try {
+            await node_fs_1.promises.unlink(tempPath);
+        }
+        catch {
+            // Ignore cleanup errors
+        }
+        const err = error;
+        throw new types_1.SessionError(`Failed to write session state file: ${err.message}`, types_1.SessionErrorCode.FS_ERROR, { filePath, originalError: err.message });
+    }
+}
+/**
+ * Update specific fields in an existing session state file.
+ * Reads, modifies, and atomically writes the file.
+ */
+async function updateSessionState(filePath, updates, existingContent) {
+    let state;
+    let prompt;
+    if (existingContent) {
+        state = existingContent.state;
+        prompt = existingContent.prompt;
+    }
+    else {
+        // Read existing file
+        const { readSessionFile } = await Promise.resolve().then(() => __importStar(require('./parse')));
+        const file = await readSessionFile(filePath);
+        state = file.state;
+        prompt = file.prompt;
+    }
+    // Apply updates
+    const updatedState = {
+        ...state,
+        ...updates,
+    };
+    // Write updated file
+    await writeSessionFile(filePath, updatedState, prompt);
+    return updatedState;
+}
+/**
+ * Bind a new run to the session, retiring the previous active run to history.
+ *
+ * Invariant: only one run is active at a time (`runId`).
+ * The previous `runId` (if any) is pushed into `runIds` as audit history.
+ * Idempotent: re-binding the same runId is a no-op.
+ *
+ * Throws if the caller tries to bind a new run while `runId` is still set
+ * and `retirePrevious` is not explicitly true — this forces callers to
+ * acknowledge that the prior run is done.
+ */
+function addRunToSession(state, runId, options) {
+    // Idempotent: already bound to this run
+    if (state.runId === runId)
+        return state;
+    // Guard: refuse to silently overwrite an active run
+    if (state.runId && !options?.retirePrevious) {
+        throw new types_1.SessionError(`Session already bound to run ${state.runId}. ` +
+            `Pass { retirePrevious: true } to retire it and bind ${runId}.`, types_1.SessionErrorCode.RUN_ALREADY_ASSOCIATED, { currentRunId: state.runId, requestedRunId: runId });
+    }
+    // Retire the old runId into history (if not already there)
+    const runIds = [...state.runIds];
+    if (state.runId && !runIds.includes(state.runId)) {
+        runIds.push(state.runId);
+    }
+    // Add the new one to the audit trail too
+    if (!runIds.includes(runId)) {
+        runIds.push(runId);
+    }
+    return { ...state, runId, runIds };
+}
+/**
+ * Get the historical audit trail of all run IDs for this session (GAP-SESSION-001).
+ * Falls back to [runId] when runIds is empty for backward compatibility
+ * with sessions created before the runIds field existed.
+ */
+function getSessionRuns(state) {
+    if (state.runIds.length > 0)
+        return state.runIds;
+    return state.runId ? [state.runId] : [];
+}
+/**
+ * Get current ISO timestamp.
+ */
+function getCurrentTimestamp() {
+    return new Date().toISOString().replace(/\.\d{3}Z$/, 'Z');
+}
+/**
+ * Convert ISO timestamp to epoch seconds.
+ * Returns null if conversion fails.
+ */
+function isoToEpochSeconds(isoTimestamp) {
+    if (!isoTimestamp)
+        return null;
+    try {
+        const date = new Date(isoTimestamp);
+        if (Number.isNaN(date.getTime()))
+            return null;
+        return Math.floor(date.getTime() / 1000);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Calculate iteration duration and update times array.
+ * Keeps only the last 10 durations for diagnostics.
+ */
+function updateIterationTimes(existingTimes, lastIterationAt, currentTime) {
+    const lastEpoch = isoToEpochSeconds(lastIterationAt);
+    const currentEpoch = isoToEpochSeconds(currentTime);
+    if (lastEpoch === null || currentEpoch === null) {
+        return existingTimes;
+    }
+    const duration = currentEpoch - lastEpoch;
+    if (duration <= 0) {
+        return existingTimes;
+    }
+    const newTimes = [...existingTimes, duration];
+    // Keep only last 10
+    return newTimes.slice(-10);
+}

package/dist/shellInvocation.d.ts

@@ -0,0 +1,6 @@
+export interface ShellInvocation {
+    command: string;
+    args: string[];
+}
+export declare function buildShellInvocation(command: string, platform?: NodeJS.Platform): ShellInvocation;
+//# sourceMappingURL=shellInvocation.d.ts.map

package/dist/shellInvocation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shellInvocation.d.ts","sourceRoot":"","sources":["../src/shellInvocation.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAC3C,eAAe,CAIjB"}

package/dist/shellInvocation.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildShellInvocation = buildShellInvocation;
+function buildShellInvocation(command, platform = process.platform) {
+    return platform === "win32"
+        ? { command: "cmd.exe", args: ["/c", command] }
+        : { command: "/bin/bash", args: ["-c", command] };
+}

package/dist/shellInvocation.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=shellInvocation.test.d.ts.map

package/dist/shellInvocation.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shellInvocation.test.d.ts","sourceRoot":"","sources":["../src/shellInvocation.test.ts"],"names":[],"mappings":""}

package/dist/shellInvocation.test.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const shellInvocation_1 = require("./shellInvocation");
+(0, vitest_1.describe)("buildShellInvocation", () => {
+    (0, vitest_1.it)("builds the Windows command shell argv contract", () => {
+        (0, vitest_1.expect)((0, shellInvocation_1.buildShellInvocation)("echo \"hello world\"", "win32")).toEqual({
+            command: "cmd.exe",
+            args: ["/c", "echo \"hello world\""],
+        });
+    });
+    (0, vitest_1.it)("builds the POSIX bash argv contract", () => {
+        (0, vitest_1.expect)((0, shellInvocation_1.buildShellInvocation)("printf '%s' \"$HOME\"", "linux")).toEqual({
+            command: "/bin/bash",
+            args: ["-c", "printf '%s' \"$HOME\""],
+        });
+    });
+});

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