@truefoundry/ai-gateway-sdk 0.0.0-stage → 0.0.2

package/dist/services/execute.js

@@ -0,0 +1,204 @@
+/**
+ * P7.1 — Combined SDK translation + execution entry.
+ *
+ * Sequences createProviderRequest → fetch/retry → Context-free response/stream
+ * transform → adapter back-transform into {@link SdkExecuteResult}.
+ *
+ * No Hono Context, gateway policy, USD cost, OTel, or dual-run.
+ */
+import { ensureAdaptersInitialized } from '../adapters/index.js';
+import { adaptNonStreamingResponse, adaptStreamingResponse, resolveAdapter } from '../adapters/registry.js';
+import { retryFromExecution } from '../handlers/retryFromExecution.js';
+import { getActualModelId, getFoundationModelId, getProviderConfig } from '../handlers/tfyUtils.js';
+import { deriveProviderHeaderOptions, toLowercaseHeaders } from '../utils/deriveProviderHeaderOptions.js';
+import { logIgnoredFailure } from '../utils/ignoreWithLog.js';
+import { isStreamingEnabledSdk } from '../utils/isStreamingEnabled.js';
+import { sdkRequestUrl } from '../utils/sdkRequestUrl.js';
+import { buildFetchInit } from './buildFetchInit.js';
+import { createProviderRequest } from './createProviderRequest.js';
+import { handleProviderResponse } from './handleProviderResponse.js';
+/**
+ * Clone inbound body for adapter response echo before createProviderRequest
+ * mutates/translates. FormData / streams → `{}` (live ADAPTER_ORIGINAL_REQUEST parity).
+ */
+function cloneOriginalBody(body) {
+    if (body instanceof ReadableStream ||
+        body instanceof FormData ||
+        body instanceof ArrayBuffer ||
+        ArrayBuffer.isView(body) ||
+        typeof body === 'string' ||
+        body instanceof Blob) {
+        return {};
+    }
+    try {
+        return structuredClone(body);
+    }
+    catch (error) {
+        logIgnoredFailure('sdk.cloneOriginalBody.structuredClone', error);
+        try {
+            return JSON.parse(JSON.stringify(body));
+        }
+        catch (jsonError) {
+            logIgnoredFailure('sdk.cloneOriginalBody.jsonClone', jsonError);
+            return {};
+        }
+    }
+}
+function deriveYieldRawBytes(args) {
+    if (!args.streaming)
+        return false;
+    const adapter = resolveAdapter(args.inboundEndpoint);
+    if (!adapter || adapter.format !== 'bedrock-converse')
+        return false;
+    return adapter.supportsNatively(args.provider, args.foundationModelId);
+}
+/**
+ * Inbound endpoints that own their fetch (`requestHandlers`). Adapter translate
+ * never rewrites these onto `chatComplete`, so lookup is on the inbound endpoint.
+ */
+export function findRequestHandler(call) {
+    const configs = getProviderConfig(call.providerOptions.providerAccount, call.providerOptions.model ?? undefined);
+    return configs?.requestHandlers?.[call.request.endpoint];
+}
+/**
+ * Run a provider requestHandler (speech / files / batches / …).
+ * Does not call createProviderRequest or buildFetchInit — the handler owns the body and fetch.
+ */
+async function executeRequestHandler(call, handler) {
+    const headerOptions = deriveProviderHeaderOptions(call.request.headers);
+    const modelId = getActualModelId(call.providerOptions.model);
+    const provider = call.providerOptions.providerAccount.provider;
+    const endpoint = call.request.endpoint;
+    const fetchStartMs = performance.now();
+    // A ReadableStream body can be read once. Retrying the handler would send an
+    // already-consumed upload. FormData can be serialized again.
+    const execution = call.request.body instanceof ReadableStream
+        ? { ...call.execution, retry: { attempts: 0, on_status_codes: [] } }
+        : call.execution;
+    const { response, attempt } = await retryFromExecution('', { method: call.request.method, signal: execution.abortSignal }, execution, signal => handler({
+        request: call.request,
+        providerOptions: call.providerOptions,
+        callConfig: call.callConfig,
+        headerOptions,
+        session: call.session,
+        signal,
+        modelId,
+    }));
+    const latencyMs = performance.now() - fetchStartMs;
+    const streaming = isStreamingEnabledSdk({
+        body: call.request.body,
+        endpoint,
+        path: call.request.path,
+    });
+    const handled = await handleProviderResponse({
+        response,
+        endpoint,
+        provider,
+        providerOptions: call.providerOptions,
+        execution,
+        streaming,
+        yieldRawBytes: false,
+        preserveNonJsonBody: true,
+        gatewayRequestBody: call.request.body,
+        postAdapterBody: call.request.body,
+        requestUrl: sdkRequestUrl(call.request),
+        attempts: attempt ?? 0,
+        timings: { latencyMs },
+        fetchStartMs,
+        modelMetadata: {
+            provider,
+            endpoint,
+            ...(modelId ? { modelId } : {}),
+        },
+        strictOpenAiCompliance: call.callConfig.strictOpenAiCompliance ?? true,
+        headerOptions,
+        callConfig: call.callConfig,
+        inboundEndpoint: endpoint,
+    });
+    return {
+        response: handled.response,
+        executionReport: handled.executionReport,
+        servedEndpoint: endpoint,
+    };
+}
+/**
+ * Run one provider call: requestHandler fetch, or translate → fetch → transform → adapt → report.
+ */
+export async function executeCall(call) {
+    await ensureAdaptersInitialized();
+    const handler = findRequestHandler(call);
+    if (handler) {
+        // requestHandlers skip createProviderRequest — normalize here (live HTTP edge).
+        return executeRequestHandler({
+            ...call,
+            request: { ...call.request, headers: toLowercaseHeaders(call.request.headers) },
+        }, handler);
+    }
+    const originalBody = cloneOriginalBody(call.request.body);
+    const built = await createProviderRequest(call);
+    const streaming = isStreamingEnabledSdk({
+        body: built.postAdapterBody,
+        endpoint: built.endpoint,
+        path: call.request.path,
+    });
+    const provider = call.providerOptions.providerAccount.provider;
+    const foundationModelId = getFoundationModelId(call.providerOptions.model);
+    const yieldRawBytes = deriveYieldRawBytes({
+        streaming,
+        inboundEndpoint: call.request.endpoint,
+        provider,
+        foundationModelId,
+    });
+    const fetchInit = buildFetchInit(built, call);
+    const fetchStartMs = performance.now();
+    const { response, attempt } = await retryFromExecution(built.url, fetchInit, call.execution);
+    const latencyMs = performance.now() - fetchStartMs;
+    const modelId = getActualModelId(call.providerOptions.model) || undefined;
+    const modelMetadata = {
+        provider,
+        endpoint: built.endpoint,
+        ...(modelId ? { modelId } : {}),
+    };
+    const headerOptions = deriveProviderHeaderOptions(call.request.headers);
+    const handled = await handleProviderResponse({
+        response,
+        endpoint: built.endpoint,
+        provider,
+        providerOptions: call.providerOptions,
+        execution: call.execution,
+        streaming,
+        yieldRawBytes,
+        // Client body for billed chars/seconds (TTS/Veo). Not returned from createProviderRequest.
+        gatewayRequestBody: call.request.body,
+        postAdapterBody: built.postAdapterBody,
+        requestUrl: built.url,
+        attempts: attempt ?? 0,
+        timings: { latencyMs },
+        fetchStartMs,
+        modelMetadata,
+        strictOpenAiCompliance: call.callConfig.strictOpenAiCompliance ?? true,
+        headerOptions,
+        callConfig: call.callConfig,
+        inboundEndpoint: call.request.endpoint,
+    });
+    let finalResponse = handled.response;
+    if (built.needsResponseTranslation) {
+        const inboundAdapter = resolveAdapter(call.request.endpoint);
+        if (inboundAdapter) {
+            if (streaming && handled.response.status === 200) {
+                finalResponse = adaptStreamingResponse(handled.response, inboundAdapter, originalBody, {
+                    abortSignal: call.execution.abortSignal,
+                });
+            }
+            else {
+                finalResponse = await adaptNonStreamingResponse(handled.response, inboundAdapter, provider, originalBody);
+            }
+        }
+    }
+    return {
+        response: finalResponse,
+        executionReport: handled.executionReport,
+        servedEndpoint: built.endpoint,
+    };
+}
+//# sourceMappingURL=execute.js.map

package/dist/services/execute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute.js","sourceRoot":"","sources":["../../src/services/execute.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,yBAAyB,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACzG,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAIjG,OAAO,EAAE,2BAA2B,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AACvG,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAElE;;;GAGG;AACH,SAAS,iBAAiB,CAAC,IAAoB;IAC7C,IACE,IAAI,YAAY,cAAc;QAC9B,IAAI,YAAY,QAAQ;QACxB,IAAI,YAAY,WAAW;QAC3B,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC;QACxB,OAAO,IAAI,KAAK,QAAQ;QACxB,IAAI,YAAY,IAAI,EACpB,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,CAAC;QACH,OAAO,eAAe,CAAC,IAAI,CAA4B,CAAC;IAC1D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,iBAAiB,CAAC,uCAAuC,EAAE,KAAK,CAAC,CAAC;QAClE,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAA4B,CAAC;QACrE,CAAC;QAAC,OAAO,SAAS,EAAE,CAAC;YACnB,iBAAiB,CAAC,iCAAiC,EAAE,SAAS,CAAC,CAAC;YAChE,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,mBAAmB,CAAC,IAK5B;IACC,IAAI,CAAC,IAAI,CAAC,SAAS;QAAE,OAAO,KAAK,CAAC;IAClC,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IACrD,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,kBAAkB;QAAE,OAAO,KAAK,CAAC;IACpE,OAAO,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,iBAAiB,CAAC,CAAC;AACzE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAmB;IACpD,MAAM,OAAO,GAAG,iBAAiB,CAAC,IAAI,CAAC,eAAe,CAAC,eAAe,EAAE,IAAI,CAAC,eAAe,CAAC,KAAK,IAAI,SAAS,CAAC,CAAC;IACjH,OAAO,OAAO,EAAE,eAAe,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;AAC3D,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,qBAAqB,CAAC,IAAmB,EAAE,OAAuB;IAC/E,MAAM,aAAa,GAAG,2BAA2B,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACxE,MAAM,OAAO,GAAG,gBAAgB,CAAC,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;IAC7D,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,eAAe,CAAC,QAAQ,CAAC;IAC/D,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;IACvC,MAAM,YAAY,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;IAEvC,6EAA6E;IAC7E,6DAA6D;IAC7D,MAAM,SAAS,GACb,IAAI,CAAC,OAAO,CAAC,IAAI,YAAY,cAAc;QACzC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,eAAe,EAAE,EAAE,EAAE,EAAE;QACpE,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC;IAErB,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,kBAAkB,CACpD,EAAE,EACF,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,WAAW,EAAE,EAC9D,SAAS,EACT,MAAM,CAAC,EAAE,CACP,OAAO,CAAC;QACN,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,eAAe,EAAE,IAAI,CAAC,eAAe;QACrC,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,aAAa;QACb,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,MAAM;QACN,OAAO;KACR,CAAC,CACL,CAAC;IAEF,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,YAAY,CAAC;IACnD,MAAM,SAAS,GAAG,qBAAqB,CAAC;QACtC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI;QACvB,QAAQ;QACR,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI;KACxB,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,MAAM,sBAAsB,CAAC;QAC3C,QAAQ;QACR,QAAQ;QACR,QAAQ;QACR,eAAe,EAAE,IAAI,CAAC,eAAe;QACrC,SAAS;QACT,SAAS;QACT,aAAa,EAAE,KAAK;QACpB,mBAAmB,EAAE,IAAI;QACzB,kBAAkB,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI;QACrC,eAAe,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI;QAClC,UAAU,EAAE,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC;QACvC,QAAQ,EAAE,OAAO,IAAI,CAAC;QACtB,OAAO,EAAE,EAAE,SAAS,EAAE;QACtB,YAAY;QACZ,aAAa,EAAE;YACb,QAAQ;YACR,QAAQ;YACR,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAChC;QACD,sBAAsB,EAAE,IAAI,CAAC,UAAU,CAAC,sBAAsB,IAAI,IAAI;QACtE,aAAa;QACb,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,eAAe,EAAE,QAAQ;KAC1B,CAAC,CAAC;IAEH,OAAO;QACL,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,eAAe,EAAE,OAAO,CAAC,eAAe;QACxC,cAAc,EAAE,QAAQ;KACzB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAmB;IACnD,MAAM,yBAAyB,EAAE,CAAC;IAElC,MAAM,OAAO,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IACzC,IAAI,OAAO,EAAE,CAAC;QACZ,gFAAgF;QAChF,OAAO,qBAAqB,CAC1B;YACE,GAAG,IAAI;YACP,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;SAChF,EACD,OAAO,CACR,CAAC;IACJ,CAAC;IAED,MAAM,YAAY,GAAG,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,MAAM,KAAK,GAAG,MAAM,qBAAqB,CAAC,IAAI,CAAC,CAAC;IAEhD,MAAM,SAAS,GAAG,qBAAqB,CAAC;QACtC,IAAI,EAAE,KAAK,CAAC,eAAe;QAC3B,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI;KACxB,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,eAAe,CAAC,QAAQ,CAAC;IAC/D,MAAM,iBAAiB,GAAG,oBAAoB,CAAC,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;IAC3E,MAAM,aAAa,GAAG,mBAAmB,CAAC;QACxC,SAAS;QACT,eAAe,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ;QACtC,QAAQ;QACR,iBAAiB;KAClB,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC9C,MAAM,YAAY,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;IACvC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,kBAAkB,CAAC,KAAK,CAAC,GAAG,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IAC7F,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,YAAY,CAAC;IAEnD,MAAM,OAAO,GAAG,gBAAgB,CAAC,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,IAAI,SAAS,CAAC;IAC1E,MAAM,aAAa,GAAG;QACpB,QAAQ;QACR,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAChC,CAAC;IAEF,MAAM,aAAa,GAAG,2BAA2B,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACxE,MAAM,OAAO,GAAG,MAAM,sBAAsB,CAAC;QAC3C,QAAQ;QACR,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,QAAQ;QACR,eAAe,EAAE,IAAI,CAAC,eAAe;QACrC,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,SAAS;QACT,aAAa;QACb,2FAA2F;QAC3F,kBAAkB,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI;QACrC,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,UAAU,EAAE,KAAK,CAAC,GAAG;QACrB,QAAQ,EAAE,OAAO,IAAI,CAAC;QACtB,OAAO,EAAE,EAAE,SAAS,EAAE;QACtB,YAAY;QACZ,aAAa;QACb,sBAAsB,EAAE,IAAI,CAAC,UAAU,CAAC,sBAAsB,IAAI,IAAI;QACtE,aAAa;QACb,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,eAAe,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ;KACvC,CAAC,CAAC;IAEH,IAAI,aAAa,GAAG,OAAO,CAAC,QAAQ,CAAC;IAErC,IAAI,KAAK,CAAC,wBAAwB,EAAE,CAAC;QACnC,MAAM,cAAc,GAAG,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC7D,IAAI,cAAc,EAAE,CAAC;YACnB,IAAI,SAAS,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBACjD,aAAa,GAAG,sBAAsB,CAAC,OAAO,CAAC,QAAQ,EAAE,cAAc,EAAE,YAAsB,EAAE;oBAC/F,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW;iBACxC,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,aAAa,GAAG,MAAM,yBAAyB,CAAC,OAAO,CAAC,QAAQ,EAAE,cAAc,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC;YAC5G,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,aAAa;QACvB,eAAe,EAAE,OAAO,CAAC,eAAe;QACxC,cAAc,EAAE,KAAK,CAAC,QAAQ;KAC/B,CAAC;AACJ,CAAC"}

package/dist/services/handleProviderResponse.d.ts

@@ -0,0 +1,42 @@
+import type { Endpoint } from '../providers/types.js';
+import type { ProviderCallConfig, ProviderOptions, SdkExecutionConfig, SdkRequestBody } from '../types/contracts.js';
+import type { ExecutionModelMetadata, ExecutionReport, ExecutionTimings } from '../types/executionReport.js';
+import type { ProviderHeaderOptions } from '../types/options.js';
+export interface HandleProviderResponseInput {
+    response: Response;
+    endpoint: Endpoint;
+    provider: string;
+    providerOptions: ProviderOptions;
+    execution: SdkExecutionConfig;
+    streaming: boolean;
+    yieldRawBytes: boolean;
+    /** Inbound request body (pre-adapter) for ExecutionReport billed helpers. */
+    gatewayRequestBody: SdkRequestBody;
+    /** Post-adapter, pre-provider-rewrite body for getConfig + response/stream transforms. */
+    postAdapterBody: SdkRequestBody;
+    requestUrl: string;
+    attempts: number;
+    timings: ExecutionTimings;
+    /** `performance.now()` at fetch start — used for TTFT. */
+    fetchStartMs: number;
+    modelMetadata: ExecutionModelMetadata;
+    strictOpenAiCompliance: boolean;
+    /** Request-path header slices; required for Bedrock getConfig. Execute always supplies this. */
+    headerOptions: ProviderHeaderOptions;
+    callConfig?: ProviderCallConfig;
+    /** Inbound endpoint before adapter translate (live ADAPTER_ORIGINAL_ENDPOINT). */
+    inboundEndpoint?: Endpoint;
+    /**
+     * requestHandler responses (file bytes, JSONL batch output) must not be
+     * parsed and re-wrapped as application/json. JSON content types still transform.
+     */
+    preserveNonJsonBody?: boolean;
+}
+export interface HandleProviderResponseResult {
+    response: Response;
+    executionReport: Promise<ExecutionReport>;
+}
+/**
+ * Transform a provider Response into the client-facing Response + deferred report.
+ */
+export declare function handleProviderResponse(input: HandleProviderResponseInput): Promise<HandleProviderResponseResult>;