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

package/dist/providers/types.d.ts

@@ -0,0 +1,459 @@
+/**
+ * ================================
+ * Inherited upstream file
+ * But needs some custom changes for TFY
+ * 1. Provider is optional in the ErrorResponse interface
+ * 2. Rerank response to be present, as it is not present upstream
+ * 3. Export the Batch interface
+ * 4. Add removeFromParams to the ParameterConfig interface, required can be a function
+ * ================================
+ */
+import type { ProviderCallConfig, ProviderOptions, SdkExecutionConfig, SdkRequest, SdkRequestBody, SessionContext } from '../types/contracts.js';
+import type { ProviderHeaderOptions } from '../types/options.js';
+import { Message, Params } from '../types/requestBody.js';
+import { ANTHROPIC_STOP_REASON } from './anthropic/types.js';
+import { BEDROCK_CONVERSE_STOP_REASON, TITAN_STOP_REASON } from './bedrock/types.js';
+import { COHERE_STOP_REASON } from './cohere/types.js';
+import { VERTEX_GEMINI_GENERATE_CONTENT_FINISH_REASON } from './google-vertex-ai/types.js';
+import { GOOGLE_GENERATE_CONTENT_FINISH_REASON } from './google/types.js';
+import { MISTRAL_AI_FINISH_REASON } from './mistral-ai/types.js';
+import { TOGETHER_AI_FINISH_REASON } from './together-ai/types.js';
+/**
+ * Configuration for a parameter.
+ * @interface
+ */
+/**
+ * ================================
+ * NOTE: Add removeFromParams to the ParameterConfig interface, required can be a function
+ * ================================
+ */
+export interface ParameterConfig {
+    /** The name of the parameter. */
+    param: string | ((params: any) => string);
+    /** The default value of the parameter, if not provided in the request. */
+    default?: any;
+    /** The minimum value of the parameter. */
+    min?: number;
+    /** The maximum value of the parameter. */
+    max?: number;
+    /** Whether the parameter is required. */
+    required?: boolean | Function;
+    /** A function to transform the value of the parameter. */
+    transform?: Function;
+    /** Whether the parameter should be removed from the request body. Can be a boolean or a function that returns boolean. */
+    removeFromParams?: boolean | Function;
+}
+/**
+ * Configuration for an AI provider.
+ * @interface
+ */
+export interface ProviderConfig {
+    /** The configuration for each parameter, indexed by parameter name. */
+    [key: string]: ParameterConfig | ParameterConfig[];
+}
+/**
+ * Shared by getBaseURL / getEndpoint / getProxyEndpoint.
+ * Each api.ts narrows providerOptions.model / providerAccount manifests locally.
+ * Original OpenAI-shaped body: request.body. Inbound URL: request.path + request.search.
+ */
+export interface ProviderApiBaseArgs {
+    request: SdkRequest;
+    providerOptions: ProviderOptions;
+    callConfig: ProviderCallConfig;
+    headerOptions: ProviderHeaderOptions;
+    session: SessionContext;
+    execution?: SdkExecutionConfig;
+    endpoint: Endpoint;
+}
+/**
+ * Mid-pipeline values produced after transform + URL assembly inside execute/dispatch.
+ * NOT on SdkCallInputs. Only headers (SigV4 / body-signing) needs them.
+ */
+export interface ProviderApiHeadersArgs extends ProviderApiBaseArgs {
+    transformedRequestBody?: Record<string, any> | string;
+    transformedRequestUrl?: string;
+}
+/**
+ * SDK ProviderAPIConfig (P4 target). No Hono Context, no flattened Options bag,
+ * no derivable gatewayRequestBody / params / gatewayRequestURL fields.
+ */
+export interface ProviderAPIConfig {
+    headers: (args: ProviderApiHeadersArgs) => Promise<Record<string, any>> | Record<string, any>;
+    getBaseURL: (args: ProviderApiBaseArgs) => Promise<string> | string;
+    getEndpoint: (args: ProviderApiBaseArgs) => string;
+    transformToFormData?: (args: Pick<ProviderApiBaseArgs, 'request'>) => boolean;
+    getProxyEndpoint?: (args: ProviderApiBaseArgs) => string;
+}
+/**
+ * ================================
+ * NOTE: Add TFY specfic endpoint in this, image-edit, createModeration
+ * ================================
+ */
+export type Endpoint = 'complete' | 'chatComplete' | 'embed' | 'rerank' | 'moderate' | 'decision' | 'stream-complete' | 'stream-chatComplete' | 'stream-messages' | 'proxy' | 'tts-proxy' | 'stt-proxy' | 'video-proxy' | 'imageGenerate' | 'imageEdit' | 'imageVariation' | 'createSpeech' | 'createTranscription' | 'createTranslation' | 'realtime' | 'uploadFile' | 'listFiles' | 'retrieveFile' | 'deleteFile' | 'retrieveFileContent' | 'createBatch' | 'retrieveBatch' | 'cancelBatch' | 'listBatches' | 'getBatchOutput' | 'listFinetunes' | 'createFinetune' | 'retrieveFinetune' | 'cancelFinetune' | 'createModelResponse' | 'createModelResponseCompact' | 'getModelResponse' | 'deleteModelResponse' | 'listResponseInputItems' | 'messages' | 'messagesCountTokens' | 'createModeration' | 'generateContent' | 'stream-generateContent' | 'bedrockConverse' | 'stream-bedrockConverse'
+/** Bedrock S3 multipart step used by uploadFile RequestHandlers (not a public HTTP route). */
+ | 'initiateMultipartUpload';
+/**
+ * A collection of API configurations for multiple AI providers.
+ * @interface
+ */
+export interface ProviderAPIConfigs {
+    /** The API configuration for each provider, indexed by provider name. */
+    [key: string]: ProviderAPIConfig;
+}
+/**
+ * Context-free requestHandler args (GATEWAY-3351).
+ * Replaces Hono `Context` + flattened `Options`. `signal` is the merged
+ * timeout / client-cancel abort from retry (GATEWAY-3349 SDK half).
+ */
+export interface RequestHandlerArgs<T = SdkRequestBody> {
+    request: Omit<SdkRequest, 'body'> & {
+        body: T;
+    };
+    providerOptions: ProviderOptions;
+    callConfig: ProviderCallConfig;
+    headerOptions: ProviderHeaderOptions;
+    session: SessionContext;
+    signal: AbortSignal;
+    /** Actual provider model id (`getActualModelId`). */
+    modelId: string;
+}
+export type RequestHandler<T = SdkRequestBody> = (args: RequestHandlerArgs<T>) => Promise<Response>;
+export type RequestHandlers = Partial<Record<Endpoint, RequestHandler<any>>>;
+/**
+ * Second arg for param-map `transform` / `default` via `getValue` /
+ * `transformUsingProviderConfig`. Bundles callConfig + headerOptions +
+ * providerOptions because the engine has one callback slot and different maps
+ * need different slices (e.g. isCursorEndpoint, awsRegion, model.manifest) —
+ * not a projected Options bag; each callback reads fields directly.
+ */
+export interface ParamMapTransformInput {
+    callConfig: ProviderCallConfig;
+    headerOptions: ProviderHeaderOptions;
+    providerOptions?: ProviderOptions;
+}
+/** Args for provider `getConfig` after P4.3 — explicit SDK inputs, not flattened Options. */
+export interface ProviderGetConfigArgs {
+    params: Params;
+    providerOptions: ProviderOptions;
+    callConfig: ProviderCallConfig;
+    headerOptions: ProviderHeaderOptions;
+    execution?: SdkExecutionConfig;
+}
+/**
+ * A collection of configurations for multiple AI providers.
+ * @interface
+ */
+export interface ProviderConfigs {
+    /** The configuration for each provider, indexed by provider name. */
+    [key: string]: any;
+    acceptsMidConversationSystemMessages?: boolean;
+    requestHandlers?: RequestHandlers;
+    getConfig?: (args: ProviderGetConfigArgs) => any;
+}
+export interface BaseResponse {
+    object: string;
+    model: string;
+}
+/**
+ * The basic structure of a completion response.
+ * @interface
+ */
+export interface CResponse extends BaseResponse {
+    id: string;
+    created: number;
+    usage?: {
+        prompt_tokens: number;
+        completion_tokens: number;
+        total_tokens: number;
+        completion_tokens_details?: {
+            accepted_prediction_tokens?: number;
+            audio_tokens?: number;
+            reasoning_tokens?: number;
+            rejected_prediction_tokens?: number;
+        };
+        prompt_tokens_details?: {
+            audio_tokens?: number;
+            cached_tokens?: number;
+        };
+        cache_read_input_tokens?: number;
+        cache_creation_input_tokens?: number;
+        cache_creation?: {
+            ephemeral_5m_input_tokens?: number;
+            ephemeral_1h_input_tokens?: number;
+        };
+        num_search_queries?: number;
+        /** Gateway-computed request cost in USD */
+        costInUSD?: number;
+    };
+}
+/**
+ * The structure of a completion response for the 'complete' function.
+ * @interface
+ */
+export interface CompletionResponse extends CResponse {
+    choices: {
+        text: string;
+        index: number;
+        logprobs: null;
+        finish_reason: string;
+    }[];
+}
+export interface GroundingMetadata {
+    webSearchQueries?: string[];
+    searchEntryPoint?: {
+        renderedContent: string;
+    };
+    groundingSupports?: Array<{
+        segment: {
+            startIndex: number;
+            endIndex: number;
+            text: string;
+        };
+        groundingChunkIndices: number[];
+        confidenceScores: number[];
+    }>;
+    retrievalMetadata?: {
+        webDynamicRetrievalScore: number;
+    };
+}
+/**
+ * The structure of a choice in a chat completion response.
+ * @interface
+ */
+export interface ChatChoice {
+    index: number;
+    message: Message;
+    finish_reason: string;
+    logprobs?: object | null;
+    groundingMetadata?: GroundingMetadata;
+}
+export interface Logprobs {
+    token: string;
+    logprob: number;
+    bytes: number[];
+    top_logprobs?: {
+        token: string;
+        logprob: number;
+        bytes: number[];
+    }[];
+}
+/**
+ * The structure of a completion response for the 'chatComplete' function.
+ * @interface
+ */
+export interface ChatCompletionResponse extends CResponse {
+    choices: ChatChoice[];
+    provider?: string;
+    citations?: string[];
+    service_tier?: string;
+}
+/**
+ * The structure of a error response for all functions
+ * @interface
+ */
+/**
+ * ================================
+ * NOTE: Provider is optional in the ErrorResponse interface
+ * ================================
+ */
+export interface ErrorResponse {
+    error: {
+        message: string;
+        type: string | null;
+        code: string | null;
+        param?: string;
+    };
+    guardrail_checks?: any;
+}
+export interface SageMakerErrorResponse {
+    provider?: string;
+    ErrorCode?: string;
+    OriginalMessage?: string;
+    OriginalStatusCode?: number;
+    Message?: string;
+}
+/**
+ * The structure of a image generation response
+ * @interface
+ */
+export interface ImageGenerateResponse {
+    created: number;
+    data: object[];
+    provider: string;
+    /** Multi-turn image edit (incl. thought signatures for gemini-3-pro-image-preview): Content to send as previous_messages. */
+    content_for_next_turn?: Record<string, unknown>;
+}
+/**
+ * The response body for uploading a file.
+ * @interface
+ */
+export interface UploadFileResponse extends File {
+}
+/**
+ * The response body for getting a file.
+ * @interface
+ */
+export interface GetFileResponse extends File {
+}
+/**
+ * The response body for getting a list of files.
+ * @interface
+ */
+export interface GetFilesResponse {
+    data: File[];
+    object: 'list';
+}
+export interface RerankObject {
+    index: number;
+    relevance_score: number;
+    document?: {
+        text: string;
+    };
+}
+/**
+ * ================================
+ * NOTE: Rerank response to be present, as it is not present upstream
+ * ================================
+ */
+export interface RerankResponse {
+    id: string;
+    model?: string;
+    results: RerankObject[];
+    usage?: {
+        prompt_tokens?: number;
+        total_tokens: number;
+        completion_tokens: number;
+    };
+}
+/**
+ * File object
+ * @interface
+ */
+export interface File {
+    id: string;
+    object: string;
+    bytes?: number;
+    created_at: number;
+    filename: string;
+    purpose: string | 'assistants' | 'assistants_output' | 'batch' | 'batch_output' | 'fine-tune' | 'fine-tune-results' | 'vision';
+    status?: string | 'uploaded' | 'processed' | 'error';
+    status_details?: string;
+}
+/**
+ * The response body for deleting a file.
+ * @interface
+ */
+export interface DeleteFileResponse {
+    object: string;
+    deleted: boolean;
+    id: string;
+}
+/**
+ * ================================
+ * NOTE: Export the Batch interface
+ * ================================
+ */
+export interface Batch {
+    id: string;
+    object: string;
+    endpoint?: string | 'batch';
+    errors?: {
+        object: string | 'list';
+        data: {
+            code: string;
+            message: string;
+            param?: string;
+            line?: number;
+        }[];
+    };
+    input_file_id?: string;
+    completion_window?: string;
+    status?: string;
+    output_file_id?: string;
+    error_file_id?: string;
+    created_at?: number;
+    in_progress_at?: number;
+    expires_at?: number;
+    finalizing_at?: number;
+    completed_at?: number;
+    failed_at?: number;
+    expired_at?: number;
+    cancelling_at?: number;
+    cancelled_at?: number;
+    request_counts?: {
+        total: number;
+        completed: number;
+        failed: number;
+    };
+    metadata?: Record<string, any>;
+    output_blob?: string;
+    error_blob?: string;
+}
+export interface CreateBatchResponse extends Batch {
+}
+export interface RetrieveBatchResponse extends Batch {
+}
+export interface CancelBatchResponse extends Batch {
+}
+export interface ListBatchesResponse {
+    object: string | 'list';
+    data: Batch[];
+}
+export interface FinetuneProviderOptions {
+    model: string;
+    training_type: 'chat' | 'text';
+    [key: string]: any;
+}
+export interface FinetuneRequest {
+    model: string;
+    suffix: string;
+    provider_options: FinetuneProviderOptions;
+    training_file: string;
+    validation_file?: string;
+    model_type?: string;
+    hyperparameters?: {
+        n_epochs?: number;
+        learning_rate_multiplier?: number;
+        batch_size?: number;
+    };
+    method?: {
+        type: 'supervised' | 'dpo';
+        supervised?: {
+            hyperparameters: {
+                n_epochs?: number;
+                learning_rate_multiplier?: number;
+                batch_size?: number;
+            };
+        };
+        dpo?: {
+            hyperparameters: {
+                beta?: string | number;
+                n_epochs?: number;
+                learning_rate_multiplier?: number;
+                batch_size?: number;
+            };
+        };
+    };
+}
+export interface CreateBatchRequest {
+    input_file_id: string;
+    endpoint: string;
+    completion_window: string;
+}
+export interface StreamContentBlock {
+    index: number;
+    delta: {
+        text?: string;
+        thinking?: string;
+        signature?: string;
+        data?: string;
+    };
+}
+export declare enum FINISH_REASON {
+    stop = "stop",
+    length = "length",
+    tool_calls = "tool_calls",
+    content_filter = "content_filter",
+    function_call = "function_call"
+}
+export type PROVIDER_FINISH_REASON = ANTHROPIC_STOP_REASON | BEDROCK_CONVERSE_STOP_REASON | VERTEX_GEMINI_GENERATE_CONTENT_FINISH_REASON | GOOGLE_GENERATE_CONTENT_FINISH_REASON | TITAN_STOP_REASON | MISTRAL_AI_FINISH_REASON | TOGETHER_AI_FINISH_REASON | COHERE_STOP_REASON;

package/dist/providers/types.js

@@ -0,0 +1,9 @@
+export var FINISH_REASON;
+(function (FINISH_REASON) {
+    FINISH_REASON["stop"] = "stop";
+    FINISH_REASON["length"] = "length";
+    FINISH_REASON["tool_calls"] = "tool_calls";
+    FINISH_REASON["content_filter"] = "content_filter";
+    FINISH_REASON["function_call"] = "function_call";
+})(FINISH_REASON || (FINISH_REASON = {}));
+//# sourceMappingURL=types.js.map

package/dist/providers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/providers/types.ts"],"names":[],"mappings":"AAiiBA,MAAM,CAAN,IAAY,aAMX;AAND,WAAY,aAAa;IACvB,8BAAa,CAAA;IACb,kCAAiB,CAAA;IACjB,0CAAyB,CAAA;IACzB,kDAAiC,CAAA;IACjC,gDAA+B,CAAA;AACjC,CAAC,EANW,aAAa,KAAb,aAAa,QAMxB"}

package/dist/providers/typesafe/api.d.ts

@@ -0,0 +1,5 @@
+import type { ProviderAPIConfig } from '../types.js';
+export declare const TYPESAFE_DEFAULT_BASE_URL = "https://api.typesafe.ai";
+export declare const isCloudflareBaseUrl: (url?: string) => boolean;
+export declare const typesafeAPIConfig: ProviderAPIConfig;
+export default typesafeAPIConfig;

package/dist/providers/typesafe/api.js

@@ -0,0 +1,55 @@
+export const TYPESAFE_DEFAULT_BASE_URL = 'https://api.typesafe.ai';
+/**
+ * System One models are also served by Cloudflare Workers AI, e.g. TypeSafe Jev
+ * (`typesafe/jev`) and Cloudflare Clef (`@cf/cloudflare/clef`, `@cf/cloudflare/clef-flash`).
+ * They are called through Workers AI's unified run endpoint, the REST form of
+ * `env.AI.run(model, inputs)`:
+ *
+ *   base_url: https://api.cloudflare.com/client/v4/accounts/<account_id>
+ *   model_id: typesafe/jev | @cf/cloudflare/clef | @cf/cloudflare/clef-flash
+ *   request:  POST {base_url}/ai/run  { model, input: { state, questions, images? } }
+ *   response: { success, result, errors, messages }, where `result` is the System One
+ *             response, or `{ state: 'Completed', result }` wrapping it (Jev).
+ *
+ * See https://developers.cloudflare.com/workers-ai/models/clef/
+ */
+const CLOUDFLARE_API_HOST = 'api.cloudflare.com';
+export const isCloudflareBaseUrl = (url) => {
+    if (!url)
+        return false;
+    try {
+        return new URL(url).hostname === CLOUDFLARE_API_HOST;
+    }
+    catch {
+        return false;
+    }
+};
+export const typesafeAPIConfig = {
+    getBaseURL: ({ providerOptions }) => {
+        const account = providerOptions.providerAccount.manifest;
+        return (account.base_url || TYPESAFE_DEFAULT_BASE_URL).replace(/\/+$/, '');
+    },
+    headers: ({ providerOptions }) => {
+        const account = providerOptions.providerAccount.manifest;
+        return {
+            Authorization: `Bearer ${account.auth_data.api_key}`,
+        };
+    },
+    getEndpoint: ({ endpoint, providerOptions }) => {
+        switch (endpoint) {
+            case 'decision': {
+                const account = providerOptions.providerAccount.manifest;
+                if (isCloudflareBaseUrl(account.base_url)) {
+                    // Accept a base URL that stops at the account as well as one ending in /ai/run.
+                    const basePath = new URL(account.base_url).pathname.replace(/\/+$/, '');
+                    return basePath.endsWith('/ai/run') ? '' : '/ai/run';
+                }
+                return '/v1/systemone';
+            }
+            default:
+                return '';
+        }
+    },
+};
+export default typesafeAPIConfig;
+//# sourceMappingURL=api.js.map

package/dist/providers/typesafe/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../../src/providers/typesafe/api.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,yBAAyB,GAAG,yBAAyB,CAAC;AAEnE;;;;;;;;;;;;;GAaG;AACH,MAAM,mBAAmB,GAAG,oBAAoB,CAAC;AAEjD,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,GAAY,EAAW,EAAE;IAC3D,IAAI,CAAC,GAAG;QAAE,OAAO,KAAK,CAAC;IACvB,IAAI,CAAC;QACH,OAAO,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,KAAK,mBAAmB,CAAC;IACvD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAsB;IAClD,UAAU,EAAE,CAAC,EAAE,eAAe,EAAE,EAAE,EAAE;QAClC,MAAM,OAAO,GAAG,eAAe,CAAC,eAAe,CAAC,QAAmC,CAAC;QACpF,OAAO,CAAC,OAAO,CAAC,QAAQ,IAAI,yBAAyB,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC7E,CAAC;IACD,OAAO,EAAE,CAAC,EAAE,eAAe,EAAE,EAAE,EAAE;QAC/B,MAAM,OAAO,GAAG,eAAe,CAAC,eAAe,CAAC,QAAmC,CAAC;QACpF,OAAO;YACL,aAAa,EAAE,UAAU,OAAO,CAAC,SAAS,CAAC,OAAO,EAAE;SACrD,CAAC;IACJ,CAAC;IACD,WAAW,EAAE,CAAC,EAAE,QAAQ,EAAE,eAAe,EAAE,EAAE,EAAE;QAC7C,QAAQ,QAAQ,EAAE,CAAC;YACjB,KAAK,UAAU,CAAC,CAAC,CAAC;gBAChB,MAAM,OAAO,GAAG,eAAe,CAAC,eAAe,CAAC,QAAmC,CAAC;gBACpF,IAAI,mBAAmB,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;oBAC1C,gFAAgF;oBAChF,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,QAAkB,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;oBAClF,OAAO,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;gBACvD,CAAC;gBACD,OAAO,eAAe,CAAC;YACzB,CAAC;YACD;gBACE,OAAO,EAAE,CAAC;QACd,CAAC;IACH,CAAC;CACF,CAAC;AAEF,eAAe,iBAAiB,CAAC"}

package/dist/providers/typesafe/decision.d.ts

@@ -0,0 +1,44 @@
+import { ErrorResponse, ProviderConfig } from '../types.js';
+export declare const TypeSafeDecisionConfig: ProviderConfig;
+/**
+ * Cloudflare Workers AI unified run (`POST /ai/run`): the model goes at the top level and the
+ * System One body under `input`. `images` is Clef's extension to System One.
+ */
+export declare const TypeSafeCloudflareDecisionConfig: ProviderConfig;
+interface TypeSafeUsage {
+    input_tokens?: number;
+    output_tokens?: number;
+}
+export interface TypeSafeDecisionResponse {
+    model?: string;
+    answers?: Record<string, unknown>;
+    usage?: TypeSafeUsage;
+}
+interface TypeSafeErrorResponse {
+    error?: {
+        message?: string;
+        type?: string;
+        code?: string;
+    };
+    message?: string;
+    detail?: unknown;
+}
+export interface DecisionResponse extends TypeSafeDecisionResponse {
+    usage?: TypeSafeUsage & {
+        prompt_tokens?: number;
+        completion_tokens?: number;
+        total_tokens?: number;
+    };
+}
+/** Cloudflare Workers AI response envelope. */
+interface CloudflareEnvelope {
+    success: boolean;
+    result?: unknown;
+    errors?: {
+        message?: string;
+        code?: number | string;
+    }[];
+    messages?: unknown[];
+}
+export declare const TypeSafeDecisionResponseTransform: (response: TypeSafeDecisionResponse | TypeSafeErrorResponse | CloudflareEnvelope, responseStatus: number) => DecisionResponse | ErrorResponse;
+export {};

package/dist/providers/typesafe/decision.js

@@ -0,0 +1,105 @@
+import { TYPESAFE } from '../../globals.js';
+import { generateErrorResponse, generateInvalidProviderResponseError } from '../utils.js';
+export const TypeSafeDecisionConfig = {
+    model: {
+        param: 'model',
+        required: true,
+    },
+    state: {
+        param: 'state',
+        required: true,
+    },
+    questions: {
+        param: 'questions',
+        required: true,
+    },
+};
+/**
+ * Cloudflare Workers AI unified run (`POST /ai/run`): the model goes at the top level and the
+ * System One body under `input`. `images` is Clef's extension to System One.
+ */
+export const TypeSafeCloudflareDecisionConfig = {
+    model: {
+        param: 'model',
+        required: true,
+    },
+    state: {
+        param: 'input.state',
+        required: true,
+    },
+    questions: {
+        param: 'input.questions',
+        required: true,
+    },
+    images: {
+        param: 'input.images',
+    },
+};
+const isCloudflareEnvelope = (response) => typeof response === 'object' &&
+    response !== null &&
+    typeof response.success === 'boolean' &&
+    'result' in response;
+const cloudflareError = (envelope, responseStatus) => {
+    // `code` becomes the HTTP status downstream, so use the upstream status (502 for a 200 that
+    // reports failure); Cloudflare's own error codes (e.g. 7003) stay in the message.
+    const message = (envelope.errors ?? [])
+        .map(e => (e.code != null ? `${e.message} (code ${e.code})` : e.message))
+        .filter(Boolean)
+        .join('; ') || 'Cloudflare request failed';
+    return generateErrorResponse({ message, type: null, code: String(responseStatus !== 200 ? responseStatus : 502) }, TYPESAFE);
+};
+/**
+ * Unwrap a Cloudflare envelope to the System One body. Clef returns it directly in `result`;
+ * Jev wraps it once more as `{ state: 'Completed', result }`.
+ */
+const unwrapCloudflare = (envelope, responseStatus) => {
+    if (responseStatus !== 200 || !envelope.success)
+        return cloudflareError(envelope, responseStatus);
+    const result = (envelope.result ?? {});
+    if (typeof result.state === 'string' && 'result' in result) {
+        if (result.state !== 'Completed') {
+            return generateErrorResponse({ message: `Cloudflare run did not complete (state: ${result.state})`, type: null, code: '502' }, TYPESAFE);
+        }
+        return (result.result ?? {});
+    }
+    return result;
+};
+export const TypeSafeDecisionResponseTransform = (response, responseStatus) => {
+    // System One models on Cloudflare Workers AI come back enveloped; unwrap so callers get the
+    // same body as from TypeSafe.
+    if (isCloudflareEnvelope(response)) {
+        const unwrapped = unwrapCloudflare(response, responseStatus);
+        if ('error' in unwrapped)
+            return unwrapped;
+        response = unwrapped;
+        responseStatus = 200;
+    }
+    if (responseStatus !== 200) {
+        const errorResponse = response;
+        const message = errorResponse.error?.message ??
+            errorResponse.message ??
+            (typeof errorResponse.detail === 'string' ? errorResponse.detail : undefined) ??
+            'TypeSafe request failed';
+        return generateErrorResponse({
+            message,
+            type: errorResponse.error?.type ?? null,
+            code: errorResponse.error?.code ?? String(responseStatus),
+        }, TYPESAFE);
+    }
+    const decisionResponse = response;
+    if (!decisionResponse.answers) {
+        return generateInvalidProviderResponseError(response, TYPESAFE);
+    }
+    const inputTokens = decisionResponse.usage?.input_tokens ?? 0;
+    const outputTokens = decisionResponse.usage?.output_tokens ?? 0;
+    return {
+        ...decisionResponse,
+        usage: {
+            ...decisionResponse.usage,
+            prompt_tokens: inputTokens,
+            completion_tokens: outputTokens,
+            total_tokens: inputTokens + outputTokens,
+        },
+    };
+};
+//# sourceMappingURL=decision.js.map