elasticdash-sdk 0.2.0

package/dist/interceptors/http.js

@@ -0,0 +1,356 @@
+import { getCaptureContext } from '../capture/recorder.js';
+import { getCurrentTrace } from '../trace-adapter/context.js';
+import { getHttpRunContext, getHttpFrozenEvent, pushTelemetryEvent, tryAutoInitHttpContext, getObservabilityContext } from './telemetry-push.js';
+import { rawDateNow } from './side-effects.js';
+// AI provider URLs are already captured by ai-interceptor.ts as "llm" steps.
+// Skip them here to avoid duplicate observations.
+const AI_URL_PATTERNS = [
+    /https?:\/\/api\.openai\.com\/v1\/((chat\/)?completions|embeddings)/,
+    /https?:\/\/api\.anthropic\.com\/v1\/messages/,
+    /https?:\/\/generativelanguage\.googleapis\.com\/.*\/models\/[^/:]+:(generateContent|streamGenerateContent)/,
+    /https?:\/\/api\.x\.ai\/v1\/(chat\/)?completions/,
+    /https?:\/\/api\.moonshot\.ai\/v1\/(chat\/)?completions/,
+];
+function isAIProviderUrl(url) {
+    return AI_URL_PATTERNS.some(p => p.test(url));
+}
+function parseQuery(url) {
+    try {
+        const { searchParams } = new URL(url);
+        if (searchParams.size === 0)
+            return undefined;
+        return Object.fromEntries(searchParams.entries());
+    }
+    catch {
+        // Relative URL — extract manually
+        const qIdx = url.indexOf('?');
+        if (qIdx === -1)
+            return undefined;
+        try {
+            const params = new URLSearchParams(url.slice(qIdx + 1));
+            if (![...params].length)
+                return undefined;
+            return Object.fromEntries(params.entries());
+        }
+        catch {
+            return undefined;
+        }
+    }
+}
+function parseBody(body) {
+    if (body == null)
+        return undefined;
+    if (typeof body === 'string') {
+        try {
+            return JSON.parse(body);
+        }
+        catch {
+            return body;
+        }
+    }
+    if (body instanceof URLSearchParams) {
+        return Object.fromEntries(body.entries());
+    }
+    return '[binary]';
+}
+function normalizeHeaders(headers) {
+    if (!headers)
+        return undefined;
+    if (headers instanceof Headers) {
+        const obj = {};
+        headers.forEach((v, k) => { obj[k] = v; });
+        return obj;
+    }
+    if (Array.isArray(headers))
+        return Object.fromEntries(headers);
+    return headers;
+}
+function pickReplayResponseHeaders(headers) {
+    if (!headers)
+        return { 'Content-Type': 'application/json' };
+    const out = {};
+    for (const [key, value] of Object.entries(headers)) {
+        if (typeof value === 'string')
+            out[key] = value;
+    }
+    if (!out['Content-Type'])
+        out['Content-Type'] = 'application/json';
+    return out;
+}
+function isStreamingContentType(headers) {
+    const ct = headers.get('content-type') ?? '';
+    return (ct.includes('text/event-stream') ||
+        ct.includes('application/x-ndjson') ||
+        ct.includes('application/stream+json') ||
+        ct.includes('application/jsonl') ||
+        headers.get('x-vercel-ai-data-stream') === 'v1');
+}
+function isVercelAIDataStream(headers) {
+    return headers.get('x-vercel-ai-data-stream') === 'v1';
+}
+function parseVercelAIDataStream(raw) {
+    let accumulatedText = '';
+    let resultData = {};
+    let errorMessage = '';
+    let hasError = false;
+    for (const line of raw.split('\n')) {
+        if (!line)
+            continue;
+        const colonIdx = line.indexOf(':');
+        if (colonIdx === -1)
+            continue;
+        const prefix = line.slice(0, colonIdx);
+        const payload = line.slice(colonIdx + 1);
+        try {
+            if (prefix === '0') {
+                accumulatedText += JSON.parse(payload);
+            }
+            else if (prefix === '2') {
+                const events = JSON.parse(payload);
+                for (const event of events) {
+                    if (event.type === 'result' || event.type === 'plan') {
+                        resultData = { ...resultData, ...event };
+                    }
+                }
+            }
+            else if (prefix === '3') {
+                hasError = true;
+                errorMessage = JSON.parse(payload);
+            }
+        }
+        catch {
+            // ignore malformed frames
+        }
+    }
+    if (hasError) {
+        return { message: errorMessage, type: 'error', error: errorMessage };
+    }
+    if (accumulatedText) {
+        return { message: accumulatedText, type: 'text', refinedQuery: resultData.refinedQuery };
+    }
+    if (resultData.type === 'plan') {
+        return {
+            message: resultData.message ?? '',
+            type: 'plan',
+            sessionId: resultData.sessionId,
+            awaitingApproval: true,
+            executionPlan: resultData.executionPlan,
+            refinedQuery: resultData.refinedQuery,
+        };
+    }
+    return {
+        message: resultData.message ?? '',
+        type: 'result',
+        refinedQuery: resultData.refinedQuery,
+        error: resultData.error,
+        planRejected: resultData.planRejected,
+    };
+}
+/**
+ * Reads a Vercel AI SDK data-stream response to completion and returns a
+ * structured result. Use this inside workflow functions that call the streaming
+ * endpoint via fetch so the framework can intercept and replay the call.
+ *
+ * @param response - The fetch Response whose body carries the
+ *                   `x-vercel-ai-data-stream: v1` wire protocol.
+ */
+export async function readVercelAIStream(response) {
+    if (!response.body) {
+        return { message: 'No response body', type: 'error', error: 'No response body' };
+    }
+    const reader = response.body.getReader();
+    const decoder = new TextDecoder();
+    let raw = '';
+    try {
+        for (;;) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            raw += decoder.decode(value, { stream: true });
+        }
+    }
+    finally {
+        reader.releaseLock();
+    }
+    return parseVercelAIDataStream(raw);
+}
+function reconstructStream(raw) {
+    const encoder = new TextEncoder();
+    return new ReadableStream({
+        start(ctrl) {
+            ctrl.enqueue(encoder.encode(raw));
+            ctrl.close();
+        },
+    });
+}
+let originalFetch;
+/**
+ * Returns the original unpatched fetch. SDK-internal calls (telemetry,
+ * catalog, triggers) must use this to avoid being recorded as trace events.
+ */
+export function getOriginalFetch() {
+    return originalFetch ?? globalThis.fetch;
+}
+/** Synthesize a Response from a frozen HTTP event */
+function synthesizeFrozenResponse(frozen) {
+    const frozenInput = frozen.input;
+    const responseMeta = (frozenInput?.__elasticdashResponse ?? {});
+    const status = typeof responseMeta.status === 'number' ? responseMeta.status : 200;
+    const statusText = typeof responseMeta.statusText === 'string' ? responseMeta.statusText : '';
+    const headers = pickReplayResponseHeaders(responseMeta.headers && typeof responseMeta.headers === 'object'
+        ? responseMeta.headers
+        : undefined);
+    if (frozen.streamed === true) {
+        const raw = typeof frozen.streamRaw === 'string' ? frozen.streamRaw : '';
+        return new Response(reconstructStream(raw), { status, statusText, headers });
+    }
+    const body = frozen.output != null ? JSON.stringify(frozen.output) : null;
+    return new Response(body, { status, statusText, headers });
+}
+/** Execute a live fetch and record the event, returning both the Response and the recorded event */
+async function executeLiveAndRecord(originalFetchFn, input, init, id, url, method, rawHeaders, rawBody) {
+    const query = parseQuery(url);
+    const body = parseBody(rawBody);
+    const headers = normalizeHeaders(rawHeaders);
+    const start = rawDateNow();
+    const res = await originalFetchFn(input, init);
+    const responseHeadersObj = {};
+    res.headers.forEach((v, k) => { responseHeadersObj[k] = v; });
+    const elasticdashResponse = { status: res.status, statusText: res.statusText, headers: responseHeadersObj, url: res.url };
+    const baseInput = {
+        url, method,
+        ...(query ? { query } : {}),
+        ...(body !== undefined ? { body } : {}),
+        ...(headers && Object.keys(headers).length > 0 ? { headers } : {}),
+        __elasticdashResponse: elasticdashResponse,
+    };
+    if (isStreamingContentType(res.headers) && res.body) {
+        // Streaming responses are not captured — the individual tool/AI calls
+        // inside the handler are already recorded separately. Pass through
+        // without buffering to avoid holding large streams in memory.
+        const event = {
+            id, type: 'http', name: 'fetch', input: baseInput,
+            output: null, streamed: true, timestamp: start, durationMs: rawDateNow() - start,
+        };
+        return { response: res, event };
+    }
+    let output = null;
+    try {
+        output = await res.clone().json();
+    }
+    catch { /* not JSON */ }
+    const event = {
+        id, type: 'http', name: 'fetch', input: baseInput, output, timestamp: start, durationMs: rawDateNow() - start,
+    };
+    return { response: res, event };
+}
+export function interceptFetch() {
+    if (originalFetch)
+        return; // already installed
+    originalFetch = globalThis.fetch;
+    globalThis.fetch = async (input, init) => {
+        await tryAutoInitHttpContext();
+        const ctx = getCaptureContext();
+        const httpCtx = getHttpRunContext();
+        const obsCtx = getObservabilityContext();
+        if (!ctx && !httpCtx && !obsCtx)
+            return originalFetch(input, init);
+        const url = typeof input === 'string'
+            ? input
+            : input instanceof URL
+                ? input.href
+                : input.url;
+        const method = (init?.method ?? (input instanceof Request ? input.method : 'GET')).toUpperCase();
+        const rawHeaders = init?.headers ?? (input instanceof Request ? input.headers : undefined);
+        const rawBody = init?.body ?? (input instanceof Request ? input.body : undefined);
+        // Let ai-interceptor handle AI provider URLs — it assigns its own event IDs
+        if (isAIProviderUrl(url)) {
+            return originalFetch(input, init);
+        }
+        // --- Observability-only mode: record and push, no mocks/replay ---
+        if (!ctx && !httpCtx && obsCtx) {
+            const id = obsCtx.nextId();
+            const { response, event } = await executeLiveAndRecord(originalFetch, input, init, id, url, method, rawHeaders, rawBody);
+            const eventPromise = response.__eventPromise;
+            if (eventPromise) {
+                eventPromise.then((ev) => pushTelemetryEvent(ev)).catch(() => { });
+            }
+            else if (event) {
+                pushTelemetryEvent(event);
+            }
+            return response;
+        }
+        // --- HTTP mode (no capture context) — replay frozen events or execute live ---
+        if (!ctx && httpCtx) {
+            const id = httpCtx.nextId();
+            // Replay frozen step
+            const frozen = getHttpFrozenEvent(id);
+            if (frozen && frozen.type === 'http') {
+                pushTelemetryEvent(frozen);
+                return synthesizeFrozenResponse(frozen);
+            }
+            // Not frozen → execute live, push telemetry
+            const { response, event } = await executeLiveAndRecord(originalFetch, input, init, id, url, method, rawHeaders, rawBody);
+            const eventPromise = response.__eventPromise;
+            if (eventPromise) {
+                eventPromise.then((ev) => pushTelemetryEvent(ev)).catch(() => { });
+            }
+            else if (event) {
+                pushTelemetryEvent(event);
+            }
+            return response;
+        }
+        // --- Capture mode (existing behaviour, enhanced with telemetry + TraceHandle) ---
+        const trace = getCurrentTrace();
+        const { recorder, replay } = ctx;
+        const id = recorder.nextId();
+        if (replay.shouldReplay(id)) {
+            const historicalEvent = replay.getRecordedEvent(id);
+            const historicalInput = historicalEvent?.input;
+            const historicalMethod = typeof historicalInput?.method === 'string' ? historicalInput.method.toUpperCase() : 'GET';
+            const historicalUrl = typeof historicalInput?.url === 'string' ? historicalInput.url : undefined;
+            const isReplayMatch = !!historicalEvent
+                && historicalEvent.type === 'http'
+                && historicalEvent.name === 'fetch'
+                && historicalMethod === method
+                && historicalUrl === url;
+            if (isReplayMatch && historicalEvent) {
+                recorder.record(historicalEvent);
+                if (httpCtx)
+                    pushTelemetryEvent(historicalEvent);
+                if (trace && typeof trace.recordToolCall === 'function') {
+                    trace.recordToolCall({ name: 'fetch', args: { url, method }, result: historicalEvent.output, workflowEventId: id });
+                }
+                return synthesizeFrozenResponse(historicalEvent);
+            }
+        }
+        const { response, event } = await executeLiveAndRecord(originalFetch, input, init, id, url, method, rawHeaders, rawBody);
+        const eventPromise = response.__eventPromise;
+        if (eventPromise) {
+            recorder.trackAsync(eventPromise.then((ev) => {
+                recorder.record(ev);
+                if (httpCtx)
+                    pushTelemetryEvent(ev);
+                if (trace && typeof trace.recordToolCall === 'function') {
+                    trace.recordToolCall({ name: 'fetch', args: { url, method }, result: ev.output, workflowEventId: id });
+                }
+            }).catch(() => { }));
+        }
+        else if (event) {
+            recorder.record(event);
+            if (httpCtx)
+                pushTelemetryEvent(event);
+            if (trace && typeof trace.recordToolCall === 'function') {
+                trace.recordToolCall({ name: 'fetch', args: { url, method }, result: event.output, workflowEventId: id });
+            }
+        }
+        return response;
+    };
+}
+export function restoreFetch() {
+    if (originalFetch) {
+        globalThis.fetch = originalFetch;
+        originalFetch = undefined;
+    }
+}
+//# sourceMappingURL=http.js.map

package/dist/interceptors/http.js.map

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

package/dist/interceptors/side-effects.d.ts

@@ -0,0 +1,7 @@
+/** Call the real Date.now(), bypassing any interception. Safe to call from inside interceptors. */
+export declare function rawDateNow(): number;
+export declare function interceptRandom(): void;
+export declare function restoreRandom(): void;
+export declare function interceptDateNow(): void;
+export declare function restoreDateNow(): void;
+//# sourceMappingURL=side-effects.d.ts.map

package/dist/interceptors/side-effects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"side-effects.d.ts","sourceRoot":"","sources":["../../src/interceptors/side-effects.ts"],"names":[],"mappings":"AAKA,mGAAmG;AACnG,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED,wBAAgB,eAAe,IAAI,IAAI,CA4BtC;AAED,wBAAgB,aAAa,IAAI,IAAI,CAKpC;AAED,wBAAgB,gBAAgB,IAAI,IAAI,CA4BvC;AAED,wBAAgB,cAAc,IAAI,IAAI,CAKrC"}

package/dist/interceptors/side-effects.js

@@ -0,0 +1,72 @@
+import { getCaptureContext } from '../capture/recorder.js';
+let originalRandom;
+let originalDateNow;
+/** Call the real Date.now(), bypassing any interception. Safe to call from inside interceptors. */
+export function rawDateNow() {
+    return originalDateNow ? originalDateNow() : Date.now();
+}
+export function interceptRandom() {
+    if (originalRandom)
+        return; // already installed
+    originalRandom = Math.random;
+    Math.random = () => {
+        const ctx = getCaptureContext();
+        if (!ctx)
+            return originalRandom();
+        const { recorder, replay } = ctx;
+        const n = recorder.nextSideEffectId();
+        if (replay.shouldReplaySideEffectOfType(n, 'Math.random')) {
+            return replay.getSideEffectResultOfType(n, 'Math.random');
+        }
+        const value = originalRandom();
+        recorder.record({
+            id: n,
+            type: 'side_effect',
+            name: 'Math.random',
+            input: null,
+            output: value,
+            timestamp: rawDateNow(),
+            durationMs: 0,
+        });
+        return value;
+    };
+}
+export function restoreRandom() {
+    if (originalRandom) {
+        Math.random = originalRandom;
+        originalRandom = undefined;
+    }
+}
+export function interceptDateNow() {
+    if (originalDateNow)
+        return; // already installed
+    originalDateNow = Date.now;
+    Date.now = () => {
+        const ctx = getCaptureContext();
+        if (!ctx)
+            return originalDateNow();
+        const { recorder, replay } = ctx;
+        const n = recorder.nextSideEffectId();
+        if (replay.shouldReplaySideEffectOfType(n, 'Date.now')) {
+            return replay.getSideEffectResultOfType(n, 'Date.now');
+        }
+        const value = originalDateNow();
+        recorder.record({
+            id: n,
+            type: 'side_effect',
+            name: 'Date.now',
+            input: null,
+            output: value,
+            timestamp: value,
+            durationMs: 0,
+        });
+        return value;
+    };
+}
+export function restoreDateNow() {
+    if (originalDateNow) {
+        Date.now = originalDateNow;
+        originalDateNow = undefined;
+    }
+}
+//# sourceMappingURL=side-effects.js.map

package/dist/interceptors/side-effects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"side-effects.js","sourceRoot":"","sources":["../../src/interceptors/side-effects.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAE1D,IAAI,cAA0C,CAAA;AAC9C,IAAI,eAA2C,CAAA;AAE/C,mGAAmG;AACnG,MAAM,UAAU,UAAU;IACxB,OAAO,eAAe,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAA;AACzD,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,IAAI,cAAc;QAAE,OAAM,CAAC,oBAAoB;IAC/C,cAAc,GAAG,IAAI,CAAC,MAAM,CAAA;IAE5B,IAAI,CAAC,MAAM,GAAG,GAAW,EAAE;QACzB,MAAM,GAAG,GAAG,iBAAiB,EAAE,CAAA;QAC/B,IAAI,CAAC,GAAG;YAAE,OAAO,cAAe,EAAE,CAAA;QAElC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,GAAG,CAAA;QAChC,MAAM,CAAC,GAAG,QAAQ,CAAC,gBAAgB,EAAE,CAAA;QAErC,IAAI,MAAM,CAAC,4BAA4B,CAAC,CAAC,EAAE,aAAa,CAAC,EAAE,CAAC;YAC1D,OAAO,MAAM,CAAC,yBAAyB,CAAC,CAAC,EAAE,aAAa,CAAW,CAAA;QACrE,CAAC;QAED,MAAM,KAAK,GAAG,cAAe,EAAE,CAAA;QAC/B,QAAQ,CAAC,MAAM,CAAC;YACd,EAAE,EAAE,CAAC;YACL,IAAI,EAAE,aAAa;YACnB,IAAI,EAAE,aAAa;YACnB,KAAK,EAAE,IAAI;YACX,MAAM,EAAE,KAAK;YACb,SAAS,EAAE,UAAU,EAAE;YACvB,UAAU,EAAE,CAAC;SACd,CAAC,CAAA;QAEF,OAAO,KAAK,CAAA;IACd,CAAC,CAAA;AACH,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,IAAI,cAAc,EAAE,CAAC;QACnB,IAAI,CAAC,MAAM,GAAG,cAAc,CAAA;QAC5B,cAAc,GAAG,SAAS,CAAA;IAC5B,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,IAAI,eAAe;QAAE,OAAM,CAAC,oBAAoB;IAChD,eAAe,GAAG,IAAI,CAAC,GAAG,CAAA;IAE1B,IAAI,CAAC,GAAG,GAAG,GAAW,EAAE;QACtB,MAAM,GAAG,GAAG,iBAAiB,EAAE,CAAA;QAC/B,IAAI,CAAC,GAAG;YAAE,OAAO,eAAgB,EAAE,CAAA;QAEnC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,GAAG,CAAA;QAChC,MAAM,CAAC,GAAG,QAAQ,CAAC,gBAAgB,EAAE,CAAA;QAErC,IAAI,MAAM,CAAC,4BAA4B,CAAC,CAAC,EAAE,UAAU,CAAC,EAAE,CAAC;YACvD,OAAO,MAAM,CAAC,yBAAyB,CAAC,CAAC,EAAE,UAAU,CAAW,CAAA;QAClE,CAAC;QAED,MAAM,KAAK,GAAG,eAAgB,EAAE,CAAA;QAChC,QAAQ,CAAC,MAAM,CAAC;YACd,EAAE,EAAE,CAAC;YACL,IAAI,EAAE,aAAa;YACnB,IAAI,EAAE,UAAU;YAChB,KAAK,EAAE,IAAI;YACX,MAAM,EAAE,KAAK;YACb,SAAS,EAAE,KAAK;YAChB,UAAU,EAAE,CAAC;SACd,CAAC,CAAA;QAEF,OAAO,KAAK,CAAA;IACd,CAAC,CAAA;AACH,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,IAAI,eAAe,EAAE,CAAC;QACpB,IAAI,CAAC,GAAG,GAAG,eAAe,CAAA;QAC1B,eAAe,GAAG,SAAS,CAAA;IAC7B,CAAC;AACH,CAAC"}

package/dist/interceptors/telemetry-push.d.ts

@@ -0,0 +1,142 @@
+import type { WorkflowEvent } from '../capture/event.js';
+import type { AIMockEntry, UserPromptMockEntry } from '../internals/mock-resolver.js';
+import type { TelemetryBatcher } from '../telemetry-batcher.js';
+interface ToolMockEntry {
+    mode: 'live' | 'mock-all' | 'mock-specific';
+    callIndices?: number[];
+    mockData?: Record<number, unknown>;
+}
+type MockResult = {
+    mocked: true;
+    result: unknown;
+} | {
+    mocked: false;
+};
+export interface HttpRunContext {
+    runId: string;
+    dashboardUrl: string;
+    nextId: () => number;
+    frozenEvents: Map<number, WorkflowEvent>;
+    /** System-prompt-keyed overrides: original system prompt → replacement system prompt */
+    promptMocks: Map<string, string>;
+    /** User prompt mock configuration (keyed by original user message text) */
+    userPromptMocks?: Record<string, UserPromptMockEntry>;
+    /** Tool output mock configuration (keyed by tool name) */
+    toolMockConfig?: Record<string, ToolMockEntry>;
+    /** AI output mock configuration (keyed by model name) */
+    aiMockConfig?: Record<string, AIMockEntry>;
+    /** Per-tool call counters for mock resolution (scoped to this request) */
+    toolCallCounters: Record<string, number>;
+    /** Per-model call counters for AI mock resolution (scoped to this request) */
+    aiCallCounters: Record<string, number>;
+    /** Per-user-prompt-text call counters for user prompt mock resolution */
+    userPromptCallCounters: Record<string, number>;
+}
+export interface ObservabilityContext {
+    sessionId: string;
+    serverUrl: string;
+    apiKey?: string;
+    batcher: TelemetryBatcher;
+    nextId: () => number;
+    sampleRate: number;
+    redactKeys: string[];
+    traceId: string;
+    /** The default workflow name discovered from ed_workflows.ts, used as traceId prefix */
+    defaultWorkflowName: string;
+    /** When true, events captured during trigger rerun execution are marked as isRerun */
+    isRerun?: boolean;
+    /** When set, pushTelemetryEvent also collects events here (used by trace capture) */
+    eventCollector?: WorkflowEvent[];
+}
+export declare function setObservabilityContext(ctx: ObservabilityContext): void;
+export declare function getObservabilityContext(): ObservabilityContext | undefined;
+export declare function clearObservabilityContext(): void;
+/**
+ * Sets a global (non-ALS) fallback context that `getHttpRunContext` checks when
+ * ALS returns `undefined`. Use this in streaming frameworks where ALS context is
+ * lost after the handler returns a ReadableStream.
+ */
+export declare function setGlobalHttpContext(ctx: HttpRunContext): void;
+/**
+ * Clears the global fallback context. Call this at the start of non-ElasticDash
+ * requests (or when a stream closes) to prevent stale context from leaking.
+ */
+export declare function clearGlobalHttpContext(): void;
+/** Synchronous setup — use when there are no frozen events (live run with no replay). */
+export declare function setHttpRunContext(runId: string, dashboardUrl: string): void;
+/**
+ * Async setup — fetches frozen events from the dashboard then sets the ALS context.
+ * Use this in request handlers instead of setHttpRunContext when step freezing is needed.
+ * Falls back to a live (no-replay) context if the fetch fails or returns nothing.
+ */
+export declare function initHttpRunContext(runId: string, dashboardUrl: string): Promise<void>;
+export declare function getHttpRunContext(): HttpRunContext | undefined;
+/** Returns the frozen WorkflowEvent for the given event id, or undefined if not frozen. */
+export declare function getHttpFrozenEvent(id: number): WorkflowEvent | undefined;
+/**
+ * If a prompt mock is configured for the system prompt found in `input`, returns
+ * a copy of `input` with the system prompt replaced. Otherwise returns `undefined`.
+ */
+export declare function getHttpPromptMock(input: unknown): unknown | undefined;
+/**
+ * If user prompt mocks are configured, applies all matching replacements to `input`.
+ * Returns modified input or `undefined` if no replacements applied.
+ * Uses fuzzy matching (strip/add JSON quotes) to handle serialization mismatches.
+ */
+export declare function getHttpUserPromptMock(input: unknown): unknown | undefined;
+/**
+ * Resolves whether the current HTTP-mode call to `toolName` should be mocked.
+ * Mirrors `resolveMock()` but reads from the per-request HttpRunContext.
+ */
+export declare function getHttpToolMock(toolName: string): MockResult;
+/**
+ * Resolves whether the current HTTP-mode call to `modelName` should be mocked.
+ * Mirrors `resolveAIMock()` but reads from the per-request HttpRunContext.
+ */
+export declare function getHttpAIMock(modelName: string): MockResult;
+export declare function pushTelemetryEvent(event: WorkflowEvent, explicitCtx?: {
+    runId: string;
+    dashboardUrl: string;
+}): void;
+/**
+ * Lazily initialises an HTTP run context from environment variables when none
+ * has been set up explicitly. Only activates when `ELASTICDASH_SERVER` is set.
+ *
+ * - If `ELASTICDASH_RUN_ID` is also set, calls `initHttpRunContext` so that
+ *   frozen steps are fetched from the dashboard (enables step freezing).
+ * - Otherwise calls `setHttpRunContext` with a fresh UUID (live/telemetry mode).
+ *
+ * The initialisation runs at most once per process — subsequent calls are
+ * no-ops once the context is established. Errors (e.g. dashboard unreachable)
+ * are swallowed so that live execution always continues unaffected.
+ *
+ * Typical usage: set `ELASTICDASH_SERVER=http://localhost:4573` and optionally
+ * `ELASTICDASH_RUN_ID=<id>` before starting your server or script. Every
+ * `wrapTool` / `wrapAI` call will then auto-connect to the dashboard without
+ * any explicit `initHttpRunContext` call in your code.
+ */
+/**
+ * Runs `callback` inside a fresh HTTP run context scoped to `runId` / `dashboardUrl`.
+ * Uses `als.run()` which guarantees the store is inherited by all async descendants of
+ * `callback`, even when intermediate code (e.g. Langfuse / OTel) spawns its own async
+ * contexts via `als.run()`. Prefer this over `setHttpRunContext` when wrapping a long-lived
+ * async pipeline such as a streaming route handler.
+ */
+export declare function runInHttpContext<T>(runId: string, dashboardUrl: string, callback: () => Promise<T>): Promise<T>;
+/**
+ * Fetches frozen events and prompt mocks from the dashboard, then runs `callback`
+ * inside an HTTP run context using `als.run()`. This is the preferred function for
+ * streaming route handlers that sit behind Langfuse / OTel instrumentation:
+ *
+ * - `als.run()` guarantees the elasticdash store is inherited through any nested
+ *   `als.run()` calls made by third-party libraries (e.g. `startActiveObservation`).
+ * - Frozen events and prompt mocks are fetched before the callback so step replay
+ *   and prompt mocking work correctly on reruns.
+ *
+ * Falls back to an empty context (live execution, no replay) if the dashboard is
+ * unreachable or the run config is not found.
+ */
+export declare function runWithInitializedHttpContext<T>(runId: string, dashboardUrl: string, callback: () => Promise<T>): Promise<T>;
+export declare function tryAutoInitHttpContext(): Promise<void>;
+export {};
+//# sourceMappingURL=telemetry-push.d.ts.map

package/dist/interceptors/telemetry-push.d.ts.map

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