@truefoundry/ai-gateway-sdk 0.0.4 → 0.0.6

package/dist/providers/shared/decisionDialect.js

@@ -0,0 +1,343 @@
+/**
+ * ================================
+ * TFY Managed File - Decision dialect translation
+ * ================================
+ *
+ * Two wire formats answer typed questions, and the gateway serves both on fn `decision`:
+ *
+ *   System One  `{state, questions: {name: {type: noul|choice|score, criteria}}}`
+ *               -> `{answers: {name: {...}}}`      (every provider except OpenAI)
+ *   OpenAI      `{input, questions: [{type: predicate|choice|score, name, choices|levels}]}`
+ *               -> `{answers: [{name, ...}]}`      (OpenAI only)
+ *
+ * A virtual model can mix the two, and the caller cannot know which target will serve the
+ * request, so the body has to be translated per target. This module does that translation; the
+ * caller always gets answers back in the dialect of the route it called.
+ *
+ * Only `answers`, `questions` and the evidence field are reshaped. `usage` is left exactly as
+ * the provider's response transform produced it, because the gateway's token names on it are
+ * what the costing path reads.
+ *
+ * ── Request: System One -> OpenAI ────────────────────────────────────────────────────────────
+ *
+ *   { state: { ticket: 4411, text: "Charged twice" },      ->  { input: '{"ticket":4411,...}',
+ *     questions: {                                               questions: [
+ *       damaged:  { type: "noul", instructions: "Damaged?",        { type: "predicate", name: "damaged",
+ *                   criteria: { true: "Visible damage" } },          instructions: "Damaged?\n\nAnswer true when: Visible damage" },
+ *       team:     { type: "choice", instructions: "Which?",        { type: "choice", name: "team", instructions: "Which?",
+ *                   criteria: { billing: "Payments",                 choices: [{ value: "billing", description: "Payments" },
+ *                               eng: null } },                                  { value: "eng" }] },
+ *       severity: { type: "score", instructions: "How bad?",       { type: "score", name: "severity", instructions: "How bad?",
+ *                   criteria: ["minor", "major"] } } }               levels: [{ label: "minor" }, { label: "major" }] }] }
+ *
+ * The map key becomes `name`. A noul's `criteria` have no OpenAI field, so they are folded into
+ * the instructions text. A structured `state` is serialized, since `input` is text.
+ *
+ * ── Request: OpenAI -> System One ────────────────────────────────────────────────────────────
+ *
+ *   { input: [{ type: "message", role: "user",             ->  { state: "Charged twice\nRefund please",
+ *               content: [{ type: "input_text",                  questions: {
+ *                           text: "Charged twice" },               is_dup: { type: "noul", instructions: "Duplicate?" } } }
+ *                         { type: "input_text",
+ *                           text: "Refund please" }] }],
+ *     questions: [{ type: "predicate", name: "is_dup",
+ *                   instructions: "Duplicate?" }],
+ *     safety_identifier: "user-1234" }
+ *
+ * Text parts are joined into `state`; message roles and `safety_identifier` are dropped. An
+ * unnamed question is keyed `question_<index>` so its answer can be matched back. Only `type`,
+ * `instructions` and `criteria` are emitted — System One servers 400 on other question fields.
+ *
+ * ── Response: System One -> OpenAI ───────────────────────────────────────────────────────────
+ *
+ *   { answers: {                                           ->  { answers: [
+ *       damaged:  { type: "noul", noul: 0.98 },                   { type: "predicate", name: "damaged", probability: 0.98 },
+ *       team:     { type: "choice", choice: "eng",                { type: "choice", name: "team", choice: "eng",
+ *                   confidence: 0.9,                                confidence: 0.9,
+ *                   probabilities: { billing: 0.1,                  probabilities: [{ value: "billing", probability: 0.1 },
+ *                                    eng: 0.9 } },                                  { value: "eng", probability: 0.9 }] },
+ *       severity: { type: "score", score: 1.2,                    { type: "score", name: "severity", score: 1.2,
+ *                   confidence: 0.8,                                confidence: 0.8,
+ *                   legend: { 0: "minor", 1: "major" },             probabilities: [{ value: 0, label: "minor", probability: 0.3 },
+ *                   probabilities: { 0: 0.3, 1: 0.7 } } } }                         { value: 1, label: "major", probability: 0.7 }] }] }
+ *
+ * Order and names come from the caller's own question list, since a map has none. `legend` and
+ * `probabilities` merge into one array. The reverse direction splits them apart again.
+ */
+import { DecisionTranslationUnsupportedError, ValidationError } from '../../errors.js';
+/**
+ * Derived from the provider's own decision config rather than a separate list of providers:
+ * System One configs declare a `state` param, OpenAI's declares `input`. Holds for TypeSafe's
+ * Cloudflare variant too, which remaps `state` to `input.state` but still keys on `state`.
+ */
+export const getProviderDecisionDialect = (decisionConfig) => decisionConfig && 'state' in decisionConfig ? 'systemOne' : 'openai';
+/** OpenAI requires instructions on every question; System One does not. */
+const GENERIC_INSTRUCTIONS = {
+    noul: 'Is this true of the input?',
+    choice: 'Which choice best fits the input?',
+    score: 'Which level best fits the input?',
+};
+const unsupported = (reason) => {
+    throw new DecisionTranslationUnsupportedError(reason);
+};
+/** Stable key for an OpenAI question that carries no `name`, so answers can be matched back. */
+const questionKey = (question, index) => question.name ?? `question_${index}`;
+/** System One accepts a string, JSON object or array wherever OpenAI needs plain text. */
+const decisionsText = (value) => (typeof value === 'string' ? value : JSON.stringify(value));
+/** The generic is a fallback for a missing instruction only; a structured one is serialized. */
+const asInstructions = (instructions, type) => instructions == null ? GENERIC_INSTRUCTIONS[type] : decisionsText(instructions);
+/* ------------------------------------------------------------------ *
+ * System One  ->  OpenAI
+ * ------------------------------------------------------------------ */
+/**
+ * A noul's criteria have no OpenAI field, so each non-null rule becomes an `Answer <key> when:`
+ * line after the instructions. The generic instruction applies only when that leaves nothing at
+ * all, so criteria-only questions keep their own wording.
+ */
+const predicateInstructions = (question) => {
+    const parts = question.instructions == null ? [] : [decisionsText(question.instructions)];
+    const criteria = question.criteria;
+    if (criteria && typeof criteria === 'object' && !Array.isArray(criteria)) {
+        for (const [answer, rule] of Object.entries(criteria)) {
+            if (rule != null)
+                parts.push(`Answer ${answer} when: ${decisionsText(rule)}`);
+        }
+    }
+    return parts.join('\n\n') || GENERIC_INSTRUCTIONS.noul;
+};
+const systemOneQuestionToOpenAI = (name, question) => {
+    if (question.type === 'noul') {
+        return { type: 'predicate', name, instructions: predicateInstructions(question) };
+    }
+    const instructions = asInstructions(question.instructions, question.type);
+    if (question.type === 'choice') {
+        const criteria = (question.criteria ?? {});
+        const choices = Object.entries(criteria).map(([value, description]) => ({
+            value,
+            ...(typeof description === 'string' && description ? { description } : {}),
+        }));
+        // OpenAI requires at least two choices; a single-option choice has no equivalent.
+        if (choices.length < 2) {
+            unsupported(`choice question '${name}' needs at least 2 criteria to be served by an OpenAI decision model`);
+        }
+        return { type: 'choice', name, instructions, choices };
+    }
+    const criteria = question.criteria;
+    if (!Array.isArray(criteria) || criteria.length < 2) {
+        unsupported(`score question '${name}' needs at least 2 ordered criteria to be served by an OpenAI decision model`);
+    }
+    const levels = criteria.map(level => typeof level === 'string' ? { label: level } : level);
+    return { type: 'score', name, instructions, levels };
+};
+const systemOneRequestToOpenAI = (params) => {
+    const { state, questions, images, ...rest } = params;
+    if (images != null) {
+        throw new ValidationError('images is a Clef System One extension and is not accepted by OpenAI decision models');
+    }
+    const questionMap = (questions ?? {});
+    return {
+        ...rest,
+        // OpenAI's `input` is text; a structured state is serialized rather than dropped. A missing
+        // state stays missing — substituting empty text would have the model decide on no evidence.
+        input: typeof state === 'string' ? state : JSON.stringify(state),
+        questions: Object.entries(questionMap).map(([name, question]) => systemOneQuestionToOpenAI(name, question)),
+    };
+};
+/* ------------------------------------------------------------------ *
+ * OpenAI  ->  System One
+ * ------------------------------------------------------------------ */
+/**
+ * Flattens OpenAI's string-or-messages `input` into System One's `state`. A missing input stays
+ * missing — substituting empty text would have the model decide on no evidence.
+ */
+const openAIInputToState = (input) => {
+    if (typeof input === 'string')
+        return input;
+    if (!Array.isArray(input))
+        return JSON.stringify(input);
+    const texts = [];
+    for (const message of input) {
+        const content = message?.content;
+        if (typeof content === 'string') {
+            texts.push(content);
+            continue;
+        }
+        for (const part of Array.isArray(content) ? content : []) {
+            const { type, text } = (part ?? {});
+            // System One providers are text-only, so an image cannot be silently dropped.
+            if (type === 'input_image') {
+                unsupported('input_image parts are not supported: System One decision models accept text input only');
+            }
+            if (type === 'input_text' && typeof text === 'string')
+                texts.push(text);
+        }
+    }
+    return texts.join('\n');
+};
+/**
+ * Only `type`, `instructions` and `criteria` are emitted. System One servers reject a question
+ * carrying any other field with a 400 — vLLM and the Decision 1.0 reference implementation both
+ * do — so OpenAI-only fields must be dropped rather than passed through.
+ * https://docs.vllm.ai/en/latest/serving/online_serving/structured_decisions.html
+ */
+const openAIQuestionToSystemOne = (question) => {
+    const { type, name, instructions, choices, levels } = question;
+    if (type === 'predicate') {
+        return { type: 'noul', instructions };
+    }
+    if (type === 'choice') {
+        const criteria = {};
+        for (const choice of choices ?? []) {
+            const key = String(choice.value);
+            // System One keys choices by their text, so `true` and "true" would collide.
+            if (key in criteria) {
+                unsupported(`choice question '${name ?? key}' has two options that are both '${key}' as text, which a System One ` +
+                    'decision model cannot represent');
+            }
+            criteria[key] = choice.description ?? null;
+        }
+        return { type: 'choice', instructions, criteria };
+    }
+    // System One score criteria are ordered label strings; OpenAI's per-level descriptions have
+    // no equivalent field and are dropped.
+    return { type: 'score', instructions, criteria: (levels ?? []).map(level => level.label) };
+};
+const openAIRequestToSystemOne = (params) => {
+    // `safety_identifier` is dropped: OpenAI is the only dialect that accepts it.
+    const { input, questions, safety_identifier: _safetyIdentifier, ...rest } = params;
+    const questionList = (Array.isArray(questions) ? questions : []);
+    const named = new Set();
+    const entries = questionList.map((question, index) => {
+        const key = questionKey(question, index);
+        // System One keys answers by question name, so two questions sharing one would collide and
+        // the caller would silently get back fewer answers than it asked for.
+        if (named.has(key)) {
+            unsupported(`two questions are both named '${key}', which a System One decision model cannot answer separately`);
+        }
+        named.add(key);
+        return [key, openAIQuestionToSystemOne(question)];
+    });
+    return {
+        ...rest,
+        state: openAIInputToState(input),
+        questions: Object.fromEntries(entries),
+    };
+};
+/* ------------------------------------------------------------------ *
+ * Responses
+ * ------------------------------------------------------------------ */
+const openAIAnswerToSystemOne = (answer) => {
+    const { type, name: _name, ...rest } = answer;
+    if (type === 'predicate') {
+        const { probability, ...others } = rest;
+        return { ...others, type: 'noul', noul: probability };
+    }
+    if (type === 'choice') {
+        const { probabilities, ...others } = rest;
+        const entries = (Array.isArray(probabilities) ? probabilities : []);
+        return {
+            ...others,
+            type: 'choice',
+            probabilities: Object.fromEntries(entries.map(entry => [String(entry.value), entry.probability])),
+        };
+    }
+    if (type === 'score') {
+        const { probabilities, ...others } = rest;
+        const entries = (Array.isArray(probabilities) ? probabilities : []);
+        return {
+            ...others,
+            type: 'score',
+            legend: Object.fromEntries(entries.map(entry => [String(entry.value), entry.label])),
+            probabilities: Object.fromEntries(entries.map(entry => [String(entry.value), entry.probability])),
+        };
+    }
+    // `refusal` has no System One equivalent; pass it through so callers can branch on it.
+    return answer;
+};
+const openAIResponseToSystemOne = (body) => {
+    const answers = (Array.isArray(body.answers) ? body.answers : []);
+    return {
+        ...body,
+        answers: Object.fromEntries(answers.map((answer, index) => [answer.name ?? `question_${index}`, openAIAnswerToSystemOne(answer)])),
+    };
+};
+/** OpenAI echoes only the names it was given, so an unnamed question gets no `name` back. */
+const withName = (name) => (name === undefined ? {} : { name });
+/** System One keys score levels by their index, but fall back to the raw key if it is not one. */
+const scoreLevelValue = (key) => (Number.isNaN(Number(key)) ? key : Number(key));
+/** Look up the caller's original OpenAI choice value; System One only ever returns the string key. */
+const restoreChoiceValue = (key, choices) => {
+    const match = choices?.find(choice => String(choice.value) === key);
+    return match ? match.value : key;
+};
+const systemOneAnswerToOpenAI = (name, answer, originalQuestion) => {
+    const { type, ...rest } = answer;
+    if (type === 'noul') {
+        const { noul, ...others } = rest;
+        return { ...others, type: 'predicate', ...withName(name), probability: noul };
+    }
+    if (type === 'choice') {
+        const { probabilities, choice, ...others } = rest;
+        const originalChoices = originalQuestion?.choices;
+        const probabilityMap = (probabilities ?? {});
+        return {
+            ...others,
+            type: 'choice',
+            ...withName(name),
+            ...(choice !== undefined ? { choice: restoreChoiceValue(String(choice), originalChoices) } : {}),
+            probabilities: originalChoices?.length
+                ? originalChoices.map(option => ({
+                    value: option.value,
+                    probability: probabilityMap[String(option.value)] ?? 0,
+                }))
+                : Object.entries(probabilityMap).map(([value, probability]) => ({ value, probability })),
+        };
+    }
+    if (type === 'score') {
+        const { probabilities, legend, ...others } = rest;
+        const levels = (legend ?? {});
+        const entries = Object.entries((probabilities ?? {}));
+        return {
+            ...others,
+            type: 'score',
+            ...withName(name),
+            probabilities: entries.map(([value, probability]) => ({
+                value: scoreLevelValue(value),
+                ...(levels[value] !== undefined ? { label: levels[value] } : {}),
+                probability,
+            })),
+        };
+    }
+    return { ...answer, ...withName(name) };
+};
+/**
+ * System One answers are keyed by question name; OpenAI returns them as an array in the order the
+ * caller asked, so the original request supplies both the order and each question's name.
+ */
+const systemOneResponseToOpenAI = (body, callerRequest) => {
+    const answers = (body.answers ?? {});
+    const callerQuestions = (Array.isArray(callerRequest?.questions) ? callerRequest.questions : []);
+    // The lookup key is how the question was sent upstream; the echoed name is the one the caller
+    // actually supplied, which is absent for a question it left unnamed.
+    const lookups = callerQuestions.length
+        ? callerQuestions.map((question, index) => ({
+            key: questionKey(question, index),
+            name: question.name,
+            question,
+        }))
+        : Object.keys(answers).map(key => ({ key, name: key, question: undefined }));
+    return {
+        ...body,
+        answers: lookups
+            .filter(({ key }) => answers[key] !== undefined)
+            .map(({ key, name, question }) => systemOneAnswerToOpenAI(name, answers[key], question)),
+    };
+};
+/* ------------------------------------------------------------------ *
+ * Entry points
+ * ------------------------------------------------------------------ */
+/** `to` is the serving provider's dialect. */
+export const translateDecisionRequest = (params, to) => to === 'openai' ? systemOneRequestToOpenAI(params) : openAIRequestToSystemOne(params);
+/** `to` is the caller's dialect: responses are translated back to the route that was called. */
+export const translateDecisionResponse = (body, to, callerRequest) => to === 'systemOne' ? openAIResponseToSystemOne(body) : systemOneResponseToOpenAI(body, callerRequest);
+//# sourceMappingURL=decisionDialect.js.map

package/dist/providers/shared/decisionDialect.js.map

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

package/dist/providers/shared/systemOneDecision.d.ts

@@ -0,0 +1,69 @@
+/**
+ * ================================
+ * TFY Managed File - System One decision wire format
+ * ================================
+ *
+ * System One is `{model, state, questions}` in, `{model, answers, usage}` out, where `questions`
+ * is a map keyed by caller-chosen names and `answers` comes back keyed the same way. TypeSafe
+ * publishes the format and every non-OpenAI decision provider serves it, so they differ only in
+ * URL and auth (see each provider's `api.ts`):
+ *
+ *   TypeSafe           POST {base}/v1/systemone
+ *   OpenRouter         POST https://openrouter.ai/api/v1/systemone
+ *   Perplexity         POST https://api.perplexity.ai/v1/decisions
+ *   Databricks         POST {workspace}/serving-endpoints/{endpoint}/invocations
+ *   Microsoft Foundry  POST {resource}/providers/microsoft/v1/systemone
+ *   vLLM (self-hosted) POST {server}/v1/systemone
+ *
+ * OpenAI's Decisions API is the other dialect — `input` plus a questions array — and lives in
+ * `providers/openai/decisions.ts`. Both arrive as fn `decision`; `shared/decisionDialect.ts`
+ * translates when the caller's dialect and the serving provider's differ.
+ */
+import { ErrorResponse, ProviderConfig } from '../types.js';
+/**
+ * Params this config does not list pass through untouched (`transformUsingProviderConfig`),
+ * which is what System One expects: extra fields on a question are the provider's to interpret.
+ */
+export declare const SystemOneDecisionConfig: ProviderConfig;
+interface SystemOneUsage {
+    input_tokens?: number;
+    output_tokens?: number;
+}
+export interface SystemOneDecisionResponse {
+    model?: string;
+    answers?: Record<string, unknown>;
+    usage?: SystemOneUsage;
+}
+/**
+ * Failure shapes in use; `message`/`detail` cover servers that skip `error`. Databricks answers a
+ * validation failure with HTTP 422 and `detail` as an array of problems, so `detail` is not
+ * always a string.
+ */
+export interface SystemOneErrorResponse {
+    error?: {
+        message?: string;
+        type?: string;
+        code?: string | number | null;
+    };
+    message?: string;
+    detail?: unknown;
+}
+export interface SystemOneDecisionGatewayResponse extends SystemOneDecisionResponse {
+    usage?: SystemOneUsage & {
+        prompt_tokens?: number;
+        completion_tokens?: number;
+        total_tokens?: number;
+    };
+}
+/**
+ * Mirrors the provider's token counts onto the gateway's usage names. `logDecisionResponse` falls
+ * back to the provider names, but `resolveCostInUsdFromUsage` reads only `prompt_tokens` /
+ * `completion_tokens`, so without this the response carries no `costInUSD`.
+ */
+export declare const normalizeSystemOneDecisionUsage: (response: SystemOneDecisionResponse) => SystemOneDecisionGatewayResponse;
+/**
+ * Builds the `decision` response transform for a provider that serves System One natively.
+ * `fallbackMessage` is used only when the provider reports a failure with no message at all.
+ */
+export declare const createSystemOneDecisionResponseTransform: (provider: string, fallbackMessage: string) => (response: SystemOneDecisionResponse | SystemOneErrorResponse, responseStatus: number) => SystemOneDecisionGatewayResponse | ErrorResponse;
+export {};

package/dist/providers/shared/systemOneDecision.js

@@ -0,0 +1,71 @@
+import { generateErrorResponse, generateInvalidProviderResponseError } from '../utils.js';
+/**
+ * Params this config does not list pass through untouched (`transformUsingProviderConfig`),
+ * which is what System One expects: extra fields on a question are the provider's to interpret.
+ */
+export const SystemOneDecisionConfig = {
+    model: {
+        param: 'model',
+        required: true,
+    },
+    state: {
+        param: 'state',
+        required: true,
+    },
+    questions: {
+        param: 'questions',
+        required: true,
+    },
+};
+/**
+ * Mirrors the provider's token counts onto the gateway's usage names. `logDecisionResponse` falls
+ * back to the provider names, but `resolveCostInUsdFromUsage` reads only `prompt_tokens` /
+ * `completion_tokens`, so without this the response carries no `costInUSD`.
+ */
+export const normalizeSystemOneDecisionUsage = (response) => {
+    const inputTokens = response.usage?.input_tokens ?? 0;
+    const outputTokens = response.usage?.output_tokens ?? 0;
+    return {
+        ...response,
+        usage: {
+            ...response.usage,
+            prompt_tokens: inputTokens,
+            completion_tokens: outputTokens,
+            total_tokens: inputTokens + outputTokens,
+        },
+    };
+};
+/** Keeps a 422 `detail` readable whether the server sends a string or a list of problems. */
+const describeDetail = (detail) => {
+    if (typeof detail === 'string')
+        return detail;
+    if (detail == null)
+        return undefined;
+    return JSON.stringify(detail);
+};
+const systemOneDecisionErrorResponse = (response, responseStatus, provider, fallbackMessage) => {
+    const message = response.error?.message ?? response.message ?? describeDetail(response.detail) ?? fallbackMessage;
+    const code = response.error?.code;
+    return generateErrorResponse({
+        message,
+        type: response.error?.type ?? null,
+        // `code` becomes the HTTP status downstream, so fall back to the upstream status.
+        code: code != null ? String(code) : String(responseStatus),
+    }, provider);
+};
+/**
+ * Builds the `decision` response transform for a provider that serves System One natively.
+ * `fallbackMessage` is used only when the provider reports a failure with no message at all.
+ */
+export const createSystemOneDecisionResponseTransform = (provider, fallbackMessage) => (response, responseStatus) => {
+    if (responseStatus !== 200) {
+        return systemOneDecisionErrorResponse(response, responseStatus, provider, fallbackMessage);
+    }
+    const decisionResponse = response;
+    // A 200 with no `answers` is not a decision; surface it rather than billing an empty result.
+    if (!decisionResponse.answers) {
+        return generateInvalidProviderResponseError(response, provider);
+    }
+    return normalizeSystemOneDecisionUsage(decisionResponse);
+};
+//# sourceMappingURL=systemOneDecision.js.map

package/dist/providers/shared/systemOneDecision.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"systemOneDecision.js","sourceRoot":"","sources":["../../../src/providers/shared/systemOneDecision.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,qBAAqB,EAAE,oCAAoC,EAAE,MAAM,UAAU,CAAC;AAEvF;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAmB;IACrD,KAAK,EAAE;QACL,KAAK,EAAE,OAAO;QACd,QAAQ,EAAE,IAAI;KACf;IACD,KAAK,EAAE;QACL,KAAK,EAAE,OAAO;QACd,QAAQ,EAAE,IAAI;KACf;IACD,SAAS,EAAE;QACT,KAAK,EAAE,WAAW;QAClB,QAAQ,EAAE,IAAI;KACf;CACF,CAAC;AAkCF;;;;GAIG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAC7C,QAAmC,EACD,EAAE;IACpC,MAAM,WAAW,GAAG,QAAQ,CAAC,KAAK,EAAE,YAAY,IAAI,CAAC,CAAC;IACtD,MAAM,YAAY,GAAG,QAAQ,CAAC,KAAK,EAAE,aAAa,IAAI,CAAC,CAAC;IAExD,OAAO;QACL,GAAG,QAAQ;QACX,KAAK,EAAE;YACL,GAAG,QAAQ,CAAC,KAAK;YACjB,aAAa,EAAE,WAAW;YAC1B,iBAAiB,EAAE,YAAY;YAC/B,YAAY,EAAE,WAAW,GAAG,YAAY;SACzC;KACF,CAAC;AACJ,CAAC,CAAC;AAEF,6FAA6F;AAC7F,MAAM,cAAc,GAAG,CAAC,MAAe,EAAsB,EAAE;IAC7D,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC;IAC9C,IAAI,MAAM,IAAI,IAAI;QAAE,OAAO,SAAS,CAAC;IACrC,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;AAChC,CAAC,CAAC;AAEF,MAAM,8BAA8B,GAAG,CACrC,QAAgC,EAChC,cAAsB,EACtB,QAAgB,EAChB,eAAuB,EACR,EAAE;IACjB,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,EAAE,OAAO,IAAI,QAAQ,CAAC,OAAO,IAAI,cAAc,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,eAAe,CAAC;IAClH,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC;IAElC,OAAO,qBAAqB,CAC1B;QACE,OAAO;QACP,IAAI,EAAE,QAAQ,CAAC,KAAK,EAAE,IAAI,IAAI,IAAI;QAClC,kFAAkF;QAClF,IAAI,EAAE,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC;KAC3D,EACD,QAAQ,CACT,CAAC;AACJ,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,wCAAwC,GACnD,CAAC,QAAgB,EAAE,eAAuB,EAAE,EAAE,CAC9C,CACE,QAA4D,EAC5D,cAAsB,EAC4B,EAAE;IACpD,IAAI,cAAc,KAAK,GAAG,EAAE,CAAC;QAC3B,OAAO,8BAA8B,CACnC,QAAkC,EAClC,cAAc,EACd,QAAQ,EACR,eAAe,CAChB,CAAC;IACJ,CAAC;IAED,MAAM,gBAAgB,GAAG,QAAqC,CAAC;IAC/D,6FAA6F;IAC7F,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC;QAC9B,OAAO,oCAAoC,CAAC,QAAmC,EAAE,QAAQ,CAAC,CAAC;IAC7F,CAAC;IAED,OAAO,+BAA+B,CAAC,gBAAgB,CAAC,CAAC;AAC3D,CAAC,CAAC"}

package/dist/providers/truefoundry-managed/api.d.ts

@@ -0,0 +1,3 @@
+import { ProviderAPIConfig } from '../types.js';
+declare const TrueFoundryManagedAPIConfig: ProviderAPIConfig;
+export default TrueFoundryManagedAPIConfig;

package/dist/providers/{truefoundry-models → truefoundry-managed}/api.js

@@ -1,5 +1,5 @@
 const TRAILING_SLASHES_REGEX = /\/+$/;
-const TrueFoundryModelsAPIConfig = {
+const TrueFoundryManagedAPIConfig = {
     getBaseURL: ({ providerOptions }) => {
         const manifest = providerOptions.providerAccount.manifest;
         return (manifest.base_url ?? '').replace(TRAILING_SLASHES_REGEX, '');
@@ -25,5 +25,5 @@ const TrueFoundryModelsAPIConfig = {
         }
     },
 };
-export default TrueFoundryModelsAPIConfig;
+export default TrueFoundryManagedAPIConfig;
 //# sourceMappingURL=api.js.map

package/dist/providers/truefoundry-managed/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../../src/providers/truefoundry-managed/api.ts"],"names":[],"mappings":"AAUA,MAAM,sBAAsB,GAAG,MAAM,CAAC;AAEtC,MAAM,2BAA2B,GAAsB;IACrD,UAAU,EAAE,CAAC,EAAE,eAAe,EAAE,EAAE,EAAE;QAClC,MAAM,QAAQ,GAAG,eAAe,CAAC,eAAe,CAAC,QAA6C,CAAC;QAC/F,OAAO,CAAC,QAAQ,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,sBAAsB,EAAE,EAAE,CAAC,CAAC;IACvE,CAAC;IACD,OAAO,EAAE,CAAC,EAAE,eAAe,EAAE,EAAE,EAAE;QAC/B,MAAM,QAAQ,GAAG,eAAe,CAAC,eAAe,CAAC,QAA6C,CAAC;QAC/F,OAAO;YACL,aAAa,EAAE,UAAU,QAAQ,CAAC,SAAS,EAAE,OAAO,EAAE;SACvD,CAAC;IACJ,CAAC;IACD,WAAW,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE;QAC5B,QAAQ,QAAQ,EAAE,CAAC;YACjB,KAAK,cAAc;gBACjB,OAAO,mBAAmB,CAAC;YAC7B,KAAK,UAAU;gBACb,OAAO,cAAc,CAAC;YACxB,KAAK,OAAO;gBACV,OAAO,aAAa,CAAC;YACvB,KAAK,qBAAqB;gBACxB,OAAO,YAAY,CAAC;YACtB;gBACE,OAAO,EAAE,CAAC;QACd,CAAC;IACH,CAAC;CACF,CAAC;AAEF,eAAe,2BAA2B,CAAC"}

package/dist/providers/truefoundry-managed/index.d.ts

@@ -0,0 +1,3 @@
+import { ProviderConfigs } from '../types.js';
+declare const TrueFoundryManagedConfig: ProviderConfigs;
+export default TrueFoundryManagedConfig;

package/dist/providers/{truefoundry-models → truefoundry-managed}/index.js

@@ -1,27 +1,27 @@
 /**
  * ================================
  * TFY Managed File
- * TrueFoundry Models provider config
+ * TrueFoundry Managed provider config
  * ================================
  */
-import { TRUEFOUNDRY_MODELS } from '../../globals.js';
+import { TRUEFOUNDRY_MANAGED } from '../../globals.js';
 import { chatCompleteParams, completeParams, createModelResponseParams, embedParams, OpenAICreateModelResponseTransformer, responseTransformers, } from '../open-ai-base/index.js';
 import { OpenAILikeChatCompleteResponseTransform, OpenAILikeChatCompleteStreamChunkTransform, } from '../openai-like/chatComplete.js';
 import { OpenAILikeEmbedResponseTransform } from '../openai-like/embed.js';
-import TrueFoundryModelsAPIConfig from './api.js';
-const TrueFoundryModelsConfig = {
+import TrueFoundryManagedAPIConfig from './api.js';
+const TrueFoundryManagedConfig = {
     chatComplete: chatCompleteParams([]),
     complete: completeParams([]),
     createModelResponse: createModelResponseParams([]),
     embed: embedParams([]),
-    api: TrueFoundryModelsAPIConfig,
+    api: TrueFoundryManagedAPIConfig,
     responseTransforms: {
-        ...responseTransformers(TRUEFOUNDRY_MODELS, { complete: true }),
-        chatComplete: OpenAILikeChatCompleteResponseTransform(TRUEFOUNDRY_MODELS),
-        embed: OpenAILikeEmbedResponseTransform(TRUEFOUNDRY_MODELS),
-        createModelResponse: OpenAICreateModelResponseTransformer(TRUEFOUNDRY_MODELS),
-        'stream-chatComplete': OpenAILikeChatCompleteStreamChunkTransform(TRUEFOUNDRY_MODELS),
+        ...responseTransformers(TRUEFOUNDRY_MANAGED, { complete: true }),
+        chatComplete: OpenAILikeChatCompleteResponseTransform(TRUEFOUNDRY_MANAGED),
+        embed: OpenAILikeEmbedResponseTransform(TRUEFOUNDRY_MANAGED),
+        createModelResponse: OpenAICreateModelResponseTransformer(TRUEFOUNDRY_MANAGED),
+        'stream-chatComplete': OpenAILikeChatCompleteStreamChunkTransform(TRUEFOUNDRY_MANAGED),
     },
 };
-export default TrueFoundryModelsConfig;
+export default TrueFoundryManagedConfig;
 //# sourceMappingURL=index.js.map

package/dist/providers/truefoundry-managed/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/providers/truefoundry-managed/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,yBAAyB,EACzB,WAAW,EACX,oCAAoC,EACpC,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,uCAAuC,EACvC,0CAA0C,GAC3C,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,gCAAgC,EAAE,MAAM,sBAAsB,CAAC;AAExE,OAAO,2BAA2B,MAAM,OAAO,CAAC;AAEhD,MAAM,wBAAwB,GAAoB;IAChD,YAAY,EAAE,kBAAkB,CAAC,EAAE,CAAC;IACpC,QAAQ,EAAE,cAAc,CAAC,EAAE,CAAC;IAC5B,mBAAmB,EAAE,yBAAyB,CAAC,EAAE,CAAC;IAClD,KAAK,EAAE,WAAW,CAAC,EAAE,CAAC;IACtB,GAAG,EAAE,2BAA2B;IAChC,kBAAkB,EAAE;QAClB,GAAG,oBAAoB,CAAC,mBAAmB,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QAChE,YAAY,EAAE,uCAAuC,CAAC,mBAAmB,CAAC;QAC1E,KAAK,EAAE,gCAAgC,CAAC,mBAAmB,CAAC;QAC5D,mBAAmB,EAAE,oCAAoC,CAAC,mBAAmB,CAAC;QAC9E,qBAAqB,EAAE,0CAA0C,CAAC,mBAAmB,CAAC;KACvF;CACF,CAAC;AAEF,eAAe,wBAAwB,CAAC"}

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

@@ -1,3 +1,4 @@
+import { SystemOneDecisionGatewayResponse, SystemOneDecisionResponse, SystemOneErrorResponse } from '../shared/systemOneDecision.js';
 import { ErrorResponse, ProviderConfig } from '../types.js';
 export declare const TypeSafeDecisionConfig: ProviderConfig;
 /**
@@ -5,31 +6,8 @@ export declare const TypeSafeDecisionConfig: ProviderConfig;
  * 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;
-    };
-}
+export type TypeSafeDecisionResponse = SystemOneDecisionResponse;
+export type DecisionResponse = SystemOneDecisionGatewayResponse;
 /** Cloudflare Workers AI response envelope. */
 interface CloudflareEnvelope {
     success: boolean;
@@ -40,5 +18,5 @@ interface CloudflareEnvelope {
     }[];
     messages?: unknown[];
 }
-export declare const TypeSafeDecisionResponseTransform: (response: TypeSafeDecisionResponse | TypeSafeErrorResponse | CloudflareEnvelope, responseStatus: number) => DecisionResponse | ErrorResponse;
+export declare const TypeSafeDecisionResponseTransform: (response: TypeSafeDecisionResponse | SystemOneErrorResponse | CloudflareEnvelope, responseStatus: number) => DecisionResponse | ErrorResponse;
 export {};