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

package/dist/utils/providerConfigTransform.d.ts

@@ -0,0 +1,24 @@
+import { ParamMapTransformInput, ProviderConfig } from '../providers/types.js';
+import type { ProviderOptions } from '../types/contracts.js';
+import { Params } from '../types/requestBody.js';
+export declare function setNestedProperty(obj: any, path: string, value: any): void;
+/**
+ * Resolves the model name to use for model config lookups and name-pattern rules.
+ * Azure/Foundry deployment names are arbitrary, so they miss the catalogue and match
+ * the wrong patterns; the foundation model on the selected Model manifest is the real model.
+ */
+export declare function resolveEffectiveModelName(params: Params, providerOptions?: ProviderOptions | null): string | undefined;
+/**
+ * Params to strip before sending to the provider because the model would reject them.
+ *
+ * Matched on model name only, so a non-OpenAI provider serving a model whose name contains
+ * "gpt-5" (e.g. `databricks-gpt-5`, whose catalogue entry is `removeParams: []`) is subject to
+ * these rules too. Left as-is deliberately: gating on provider here would be a second
+ * hardcoded table to keep current, and per-provider param support is what the model catalogue
+ * is for. Tracked with the TODO on the rules themselves.
+ */
+export declare function getModelSpecificParamsToExclude(modelName: string): string[];
+export declare const getValue: (configParam: string, params: Params, paramConfig: any, transformInput?: ParamMapTransformInput) => any;
+export declare const transformUsingProviderConfig: (providerConfig: ProviderConfig, params: Params, transformInput?: ParamMapTransformInput) => {
+    [key: string]: any;
+};

package/dist/utils/providerConfigTransform.js

@@ -0,0 +1,111 @@
+/**
+ * Lightweight utility for transforming request params using a ProviderConfig.
+ *
+ * Extracted from services/transformToProviderRequest.ts to avoid circular
+ * dependencies when adapters import both a ProviderConfig and the transform
+ * function. The original file pulls in ALL providers via providers/index.ts,
+ * which creates cycles back to provider-specific files.
+ */
+import { GPT5_UNSUPPORTED_SAMPLING_PARAMS, isBaseGpt5ReasoningModel } from '../globals.js';
+export function setNestedProperty(obj, path, value) {
+    const parts = path.split('.');
+    let current = obj;
+    for (let i = 0; i < parts.length - 1; i++) {
+        if (!current[parts[i]]) {
+            current[parts[i]] = {};
+        }
+        current = current[parts[i]];
+    }
+    current[parts[parts.length - 1]] = value;
+}
+/**
+ * Resolves the model name to use for model config lookups and name-pattern rules.
+ * Azure/Foundry deployment names are arbitrary, so they miss the catalogue and match
+ * the wrong patterns; the foundation model on the selected Model manifest is the real model.
+ */
+export function resolveEffectiveModelName(params, providerOptions) {
+    const foundation = providerOptions?.model?.manifest
+        ?.foundation_model;
+    return foundation || params.model;
+}
+/**
+ * Params to strip before sending to the provider because the model would reject them.
+ *
+ * Matched on model name only, so a non-OpenAI provider serving a model whose name contains
+ * "gpt-5" (e.g. `databricks-gpt-5`, whose catalogue entry is `removeParams: []`) is subject to
+ * these rules too. Left as-is deliberately: gating on provider here would be a second
+ * hardcoded table to keep current, and per-provider param support is what the model catalogue
+ * is for. Tracked with the TODO on the rules themselves.
+ */
+export function getModelSpecificParamsToExclude(modelName) {
+    if (!modelName)
+        return [];
+    return isBaseGpt5ReasoningModel(modelName) ? GPT5_UNSUPPORTED_SAMPLING_PARAMS : [];
+}
+export const getValue = (configParam, params, paramConfig, transformInput) => {
+    let value = params[configParam];
+    if (paramConfig.transform) {
+        value = paramConfig.transform(params, transformInput);
+    }
+    if (value === 'tfy-default' && paramConfig && paramConfig.default !== undefined) {
+        value = paramConfig.default;
+    }
+    if (typeof value === 'number' && paramConfig && paramConfig.min !== undefined && value < paramConfig.min) {
+        value = paramConfig.min;
+    }
+    else if (typeof value === 'number' && paramConfig && paramConfig.max !== undefined && value > paramConfig.max) {
+        value = paramConfig.max;
+    }
+    return value;
+};
+export const transformUsingProviderConfig = (providerConfig, params, transformInput) => {
+    const transformedRequest = {};
+    let paramsToExclude = [];
+    const effectiveModelName = resolveEffectiveModelName(params, transformInput?.providerOptions);
+    if (effectiveModelName) {
+        paramsToExclude = getModelSpecificParamsToExclude(effectiveModelName);
+    }
+    for (const configParam in providerConfig) {
+        if (paramsToExclude.includes(configParam)) {
+            continue;
+        }
+        let paramConfigs = providerConfig[configParam];
+        if (!Array.isArray(paramConfigs)) {
+            paramConfigs = [paramConfigs];
+        }
+        for (const paramConfig of paramConfigs) {
+            if (configParam in params) {
+                const shouldRemove = typeof paramConfig.removeFromParams === 'function'
+                    ? paramConfig.removeFromParams(params)
+                    : paramConfig.removeFromParams;
+                if (shouldRemove) {
+                    continue;
+                }
+                const value = getValue(configParam, params, paramConfig, transformInput);
+                const paramName = typeof paramConfig.param === 'function' ? paramConfig.param(params) : paramConfig.param;
+                setNestedProperty(transformedRequest, paramName, value);
+            }
+            else if (paramConfig &&
+                (typeof paramConfig.required === 'function' ? paramConfig.required(params) : paramConfig.required) &&
+                paramConfig.default !== undefined) {
+                let value;
+                if (typeof paramConfig.default === 'function') {
+                    value = paramConfig.default(params, transformInput);
+                }
+                else {
+                    value = paramConfig.default;
+                }
+                const paramName = typeof paramConfig.param === 'function' ? paramConfig.param(params) : paramConfig.param;
+                setNestedProperty(transformedRequest, paramName, value);
+            }
+        }
+    }
+    const SKIP_PASS_THROUGH_PARAMS = ['model', 'stream'];
+    for (const param in params) {
+        if (!(param in providerConfig) && !SKIP_PASS_THROUGH_PARAMS.includes(param) && !paramsToExclude.includes(param)) {
+            transformedRequest[param] = params[param];
+        }
+    }
+    return transformedRequest;
+};
+//# sourceMappingURL=providerConfigTransform.js.map

package/dist/utils/providerConfigTransform.js.map

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

package/dist/utils/providerReportedCost.d.ts

@@ -0,0 +1,2 @@
+/** Provider-metered USD total from `usage.cost.total_cost` (e.g. Perplexity). */
+export declare function providerReportedCostInUsd(usage: unknown): number | undefined;

package/dist/utils/providerReportedCost.js

@@ -0,0 +1,15 @@
+/** Provider-metered USD total from `usage.cost.total_cost` (e.g. Perplexity). */
+export function providerReportedCostInUsd(usage) {
+    if (!usage || typeof usage !== 'object')
+        return undefined;
+    const { cost } = usage;
+    if (!cost || typeof cost !== 'object' || Array.isArray(cost))
+        return undefined;
+    const { total_cost, currency } = cost;
+    if (currency != null && String(currency).toUpperCase() !== 'USD')
+        return undefined;
+    if (typeof total_cost !== 'number' || !Number.isFinite(total_cost) || total_cost < 0)
+        return undefined;
+    return total_cost;
+}
+//# sourceMappingURL=providerReportedCost.js.map

package/dist/utils/providerReportedCost.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"providerReportedCost.js","sourceRoot":"","sources":["../../src/utils/providerReportedCost.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,MAAM,UAAU,yBAAyB,CAAC,KAAc;IACtD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAC1D,MAAM,EAAE,IAAI,EAAE,GAAG,KAA2B,CAAC;IAC7C,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IAC/E,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,IAAoD,CAAC;IACtF,IAAI,QAAQ,IAAI,IAAI,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,KAAK,KAAK;QAAE,OAAO,SAAS,CAAC;IACnF,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,UAAU,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IACvG,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/utils/reasoningUtils.d.ts

@@ -0,0 +1,28 @@
+/**
+ * ================================
+ * TFY Managed File
+ * ================================
+ */
+export declare const REASONING_EFFORT: {
+    readonly NONE: "none";
+    readonly MINIMAL: "minimal";
+    readonly LOW: "low";
+    readonly MEDIUM: "medium";
+    readonly HIGH: "high";
+    readonly XHIGH: "xhigh";
+    readonly MAX: "max";
+    readonly DEFAULT: "default";
+};
+export type ReasoningEffort = (typeof REASONING_EFFORT)[keyof typeof REASONING_EFFORT];
+/**
+ * Reconcile a requested reasoning_effort against a model's supportedValues.
+ * Returns the value to use, or undefined to drop the param.
+ */
+export declare function resolveReasoningEffort(requested: string, supportedValues: ReasoningEffort[]): string | undefined;
+/**
+ * Calculate budget tokens based on reasoning effort and max tokens
+ * @param maxTokens - Maximum tokens for the response
+ * @param reasoningEffort - Reasoning effort level
+ * @returns Budget tokens for reasoning
+ */
+export declare function calculateBudgetTokens(maxTokens?: number, reasoningEffort?: ReasoningEffort): number;

package/dist/utils/reasoningUtils.js

@@ -0,0 +1,148 @@
+/**
+ * ================================
+ * TFY Managed File
+ * ================================
+ */
+import { HTTPException } from 'hono/http-exception';
+// list of supported reasoning effort values from the config
+export const REASONING_EFFORT = {
+    NONE: 'none',
+    MINIMAL: 'minimal',
+    LOW: 'low',
+    MEDIUM: 'medium',
+    HIGH: 'high',
+    XHIGH: 'xhigh',
+    MAX: 'max',
+    DEFAULT: 'default',
+};
+const REASONING_EFFORT_RANK = {
+    [REASONING_EFFORT.NONE]: 0,
+    [REASONING_EFFORT.MINIMAL]: 1,
+    [REASONING_EFFORT.LOW]: 2,
+    [REASONING_EFFORT.MEDIUM]: 3,
+    [REASONING_EFFORT.DEFAULT]: 3, // most providers use medium as default
+    [REASONING_EFFORT.HIGH]: 4,
+    [REASONING_EFFORT.XHIGH]: 5,
+    [REASONING_EFFORT.MAX]: 6,
+};
+// efforts with the same rank are treated as aliases of each other.
+const RANK_TO_REASONING_EFFORTS = {
+    0: [REASONING_EFFORT.NONE],
+    1: [REASONING_EFFORT.MINIMAL],
+    2: [REASONING_EFFORT.LOW],
+    3: [REASONING_EFFORT.MEDIUM, REASONING_EFFORT.DEFAULT],
+    4: [REASONING_EFFORT.HIGH],
+    5: [REASONING_EFFORT.XHIGH],
+    6: [REASONING_EFFORT.MAX],
+};
+function isReasoningEffort(value) {
+    return value in REASONING_EFFORT_RANK;
+}
+function getReasoningEffortRank(value) {
+    return REASONING_EFFORT_RANK[value];
+}
+function findAliasInSupported(requested, supportedValues) {
+    const rank = getReasoningEffortRank(requested);
+    const sameRankEfforts = RANK_TO_REASONING_EFFORTS[rank] ?? [];
+    return sameRankEfforts.find(value => value !== requested && supportedValues.includes(value));
+}
+function findNearestHigherSupported(requestedRank, supportedValues) {
+    let bestValue;
+    let bestRank;
+    for (const value of supportedValues) {
+        const rank = getReasoningEffortRank(value);
+        if (rank <= requestedRank) {
+            continue;
+        }
+        if (bestRank === undefined || rank < bestRank) {
+            bestRank = rank;
+            bestValue = value;
+        }
+    }
+    return bestValue;
+}
+function findHighestSupported(supportedValues) {
+    let bestValue;
+    let bestRank;
+    for (const value of supportedValues) {
+        const rank = getReasoningEffortRank(value);
+        if (bestRank === undefined || rank > bestRank) {
+            bestRank = rank;
+            bestValue = value;
+        }
+    }
+    return bestValue;
+}
+/**
+ * Reconcile a requested reasoning_effort against a model's supportedValues.
+ * Returns the value to use, or undefined to drop the param.
+ */
+export function resolveReasoningEffort(requested, supportedValues) {
+    if (supportedValues.length === 0) {
+        return requested;
+    }
+    if (isReasoningEffort(requested)) {
+        if (supportedValues.includes(requested)) {
+            return requested;
+        }
+        // drop the param, don't remap
+        if (requested === REASONING_EFFORT.NONE) {
+            return undefined;
+        }
+        const alias = findAliasInSupported(requested, supportedValues);
+        if (alias) {
+            return alias;
+        }
+        const requestedRank = getReasoningEffortRank(requested);
+        const nearestHigher = findNearestHigherSupported(requestedRank, supportedValues);
+        if (nearestHigher) {
+            return nearestHigher;
+        }
+    }
+    return findHighestSupported(supportedValues) ?? requested;
+}
+/**
+ * Calculate budget tokens based on reasoning effort and max tokens
+ * @param maxTokens - Maximum tokens for the response
+ * @param reasoningEffort - Reasoning effort level
+ * @returns Budget tokens for reasoning
+ */
+export function calculateBudgetTokens(maxTokens, reasoningEffort) {
+    // Helper function to calculate budget_tokens based on the max_tokens.
+    // Ratio for efforts: None - 0%, Minimal - 10%, Low - 30%, Medium - 60%, High: 90%
+    // Note that The minimum budget_tokens is 1,024 tokens so far.
+    // But it may be changed for different models in the future.
+    if (!maxTokens || !reasoningEffort) {
+        throw new HTTPException(400, {
+            message: 'max_tokens is required when reasoning_effort is provided',
+        });
+    }
+    let ratio;
+    switch (reasoningEffort) {
+        case REASONING_EFFORT.NONE:
+            ratio = 0;
+            break;
+        case REASONING_EFFORT.MINIMAL:
+            ratio = 0.1;
+            break;
+        case REASONING_EFFORT.LOW:
+            ratio = 0.3;
+            break;
+        case REASONING_EFFORT.MEDIUM:
+            ratio = 0.6;
+            break;
+        case REASONING_EFFORT.HIGH:
+            ratio = 0.9;
+            break;
+        case REASONING_EFFORT.XHIGH:
+            ratio = 0.95;
+            break;
+        case REASONING_EFFORT.MAX:
+            ratio = 0.99;
+            break;
+        default:
+            ratio = 0.6; // default to medium
+    }
+    return Math.floor(maxTokens * ratio);
+}
+//# sourceMappingURL=reasoningUtils.js.map

package/dist/utils/reasoningUtils.js.map

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

package/dist/utils/sdkRequestUrl.d.ts

@@ -0,0 +1,7 @@
+import type { SdkRequest } from '../types/contracts.js';
+/**
+ * Reconstruct a URL string from `SdkRequest.path` + `SdkRequest.search` for
+ * providers that still split path segments / query the way they did with
+ * `gatewayRequestURL`. Host is a placeholder and must not be fetched.
+ */
+export declare function sdkRequestUrl(request: Pick<SdkRequest, 'path' | 'search'>): string;

package/dist/utils/sdkRequestUrl.js

@@ -0,0 +1,9 @@
+/**
+ * Reconstruct a URL string from `SdkRequest.path` + `SdkRequest.search` for
+ * providers that still split path segments / query the way they did with
+ * `gatewayRequestURL`. Host is a placeholder and must not be fetched.
+ */
+export function sdkRequestUrl(request) {
+    return new URL(request.path + request.search, 'https://gateway.invalid').toString();
+}
+//# sourceMappingURL=sdkRequestUrl.js.map

package/dist/utils/sdkRequestUrl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdkRequestUrl.js","sourceRoot":"","sources":["../../src/utils/sdkRequestUrl.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,OAA4C;IACxE,OAAO,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAC,QAAQ,EAAE,CAAC;AACtF,CAAC"}

package/dist/utils/sseUtils.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Per the SSE spec, lines beginning with ':' are comments that consumers MUST ignore;
+ * providers emit them as keepalives so idle connections survive intermediary proxies.
+ * Provider stream transforms JSON.parse the frame body, so a comment must never reach them.
+ *
+ * Only ':' lines are removed. Frames are not required to carry a `data:` field, because
+ * several providers (Cohere, Google/Vertex, SageMaker) stream bare JSON; JSON can never
+ * begin with ':', so this stays unambiguous.
+ *
+ * Returns null when the frame carries nothing transformable, i.e. it was comments only or
+ * blank. Otherwise returns the frame with any comment lines removed, preserving the
+ * original line terminators.
+ */
+export declare function stripSseComments(frame: string): string | null;
+/**
+ * Every `data:` value in one frame, in order.
+ *
+ *     'event: x\ndata: {"a":1}'   -> ['{"a":1}']
+ *     'data: {"a":1}\nevent: x'   -> ['{"a":1}']     // label order does not matter
+ *     'data:{"a":1}'              -> ['{"a":1}']     // the space is optional
+ *     'data: one\ndata: two'      -> ['one', 'two']  // a frame may carry several
+ *     'event: ping'               -> []              // no data line at all
+ */
+export declare function getSseDataLines(frame: string): string[];
+/**
+ * The frame's payload as text. A frame may spread one value over several `data:` lines, and the
+ * spec says to join them with a newline, so that is what happens here rather than reading only
+ * the first line.
+ *
+ *     'event: x\ndata: {"a":1}'  -> '{"a":1}'
+ *     'data: one\ndata: two'     -> 'one\ntwo'
+ *     'data: [DONE]'             -> '[DONE]'
+ *     'event: ping'              -> null       // nothing to read
+ */
+export declare function getSseDataPayload(frame: string): string | null;
+/**
+ * The frame's payload parsed as JSON, or undefined when there is nothing to act on.
+ *
+ *     'event: x\ndata: {"a":1}'  -> { a: 1 }
+ *     'data: {"a":1}\nevent: x'  -> { a: 1 }
+ *     'event: ping'              -> undefined  // no data line
+ *     'data: [DONE]'             -> undefined  // end-of-stream marker, not an event
+ *     'data: not json'           -> undefined  // cannot be parsed
+ *
+ * All the undefined cases look alike from here. If you need to tell them apart — to report an
+ * unfamiliar frame shape, say — call getSseDataPayload and parse it yourself.
+ */
+export declare function parseSseDataJson<T = unknown>(frame: string): T | undefined;

package/dist/utils/sseUtils.js

@@ -0,0 +1,152 @@
+/**
+ * The three line endings an SSE producer is allowed to use. Splitting on this drops the line
+ * ending, which is what you want when you only care about the text of each line:
+ *
+ *     'a\r\nb'.split(LINE_TERMINATOR)  ->  ['a', 'b']
+ */
+const LINE_TERMINATOR = /\r\n|\n|\r/;
+/**
+ * The same three, wrapped in a group. JavaScript keeps a group's match in the result, so
+ * splitting on this hands back the line endings too:
+ *
+ *     'a\r\nb'.split(LINE_SPLIT)  ->  ['a', '\r\n', 'b']
+ *
+ * Needed only when the frame has to be put back together with the exact line endings it
+ * arrived with.
+ */
+const LINE_SPLIT = /(\r\n|\n|\r)/;
+/** A ':' optionally preceded by horizontal whitespace, at the start of any line. */
+const HAS_COMMENT_LINE = /^[ \t]*:/m;
+/**
+ * Per the SSE spec, lines beginning with ':' are comments that consumers MUST ignore;
+ * providers emit them as keepalives so idle connections survive intermediary proxies.
+ * Provider stream transforms JSON.parse the frame body, so a comment must never reach them.
+ *
+ * Only ':' lines are removed. Frames are not required to carry a `data:` field, because
+ * several providers (Cohere, Google/Vertex, SageMaker) stream bare JSON; JSON can never
+ * begin with ':', so this stays unambiguous.
+ *
+ * Returns null when the frame carries nothing transformable, i.e. it was comments only or
+ * blank. Otherwise returns the frame with any comment lines removed, preserving the
+ * original line terminators.
+ */
+export function stripSseComments(frame) {
+    if (!frame.trim()) {
+        return null;
+    }
+    if (!HAS_COMMENT_LINE.test(frame)) {
+        return frame;
+    }
+    // Splitting on a capture group interleaves separators with lines, so each kept line can
+    // be rejoined with the terminator it originally had rather than a normalised '\n'.
+    const tokens = frame.split(LINE_SPLIT);
+    let kept = '';
+    for (let i = 0; i < tokens.length; i += 2) {
+        if (tokens[i].trimStart().startsWith(':')) {
+            continue;
+        }
+        kept += tokens[i] + (tokens[i + 1] ?? '');
+    }
+    return kept.trim() ? kept : null;
+}
+/**
+ * Reading an SSE frame
+ * ====================
+ * A frame is a few labelled lines. The useful part is the `data:` line:
+ *
+ *     event: response.output_text.delta
+ *     data: {"type":"response.output_text.delta","delta":"Hi"}
+ *
+ * Use `parseSseDataJson` if you just want the object. Use `getSseDataPayload` if you also need
+ * to say something about a payload you could not parse.
+ *
+ * Both of those read ONE frame. Some provider transforms return several frames concatenated into
+ * a single string — the Anthropic chat-completions transform emits its error chunk together with
+ * the `data: [DONE]` terminator, for instance. Joining those data lines produces two JSON values
+ * and parses as neither. Callers holding a value like that want `getSseDataLines`, so each line
+ * can be read on its own.
+ *
+ * Two rules are easy to get wrong, so they are handled here once instead of at every call site.
+ *
+ * 1. The labels can come in any order.
+ *
+ *    Most providers put `event:` first, but AWS Bedrock Mantle puts `data:` first:
+ *
+ *        data: {"type":"response.output_text.delta","delta":"Hi"}
+ *        event: response.output_text.delta
+ *
+ *    Both are valid. So you cannot say "the payload is everything after `data: `" — on the
+ *    frame above that also swallows the `event:` line and you end up trying to parse:
+ *
+ *        {"type":"response.output_text.delta","delta":"Hi"}
+ *        event: response.output_text.delta
+ *
+ *    which fails with `Unexpected non-whitespace character after JSON ... (line 2 column 1)`.
+ *    Look at each line separately instead.
+ *
+ * 2. The space after `data:` is optional.
+ *
+ *    `data:{"a":1}` and `data: {"a":1}` mean the same thing, so skip the label by its length
+ *    and trim whatever follows.
+ */
+/** Length of `data:` itself. The space that usually follows it is optional, so it is trimmed. */
+const DATA_FIELD_PREFIX_LENGTH = 'data:'.length;
+/** What `data: [DONE]` leaves behind once the label is removed. Marks the end of a stream. */
+const SSE_DONE_PAYLOAD = '[DONE]';
+/**
+ * Every `data:` value in one frame, in order.
+ *
+ *     'event: x\ndata: {"a":1}'   -> ['{"a":1}']
+ *     'data: {"a":1}\nevent: x'   -> ['{"a":1}']     // label order does not matter
+ *     'data:{"a":1}'              -> ['{"a":1}']     // the space is optional
+ *     'data: one\ndata: two'      -> ['one', 'two']  // a frame may carry several
+ *     'event: ping'               -> []              // no data line at all
+ */
+export function getSseDataLines(frame) {
+    const dataLines = [];
+    for (const line of frame.split(LINE_TERMINATOR)) {
+        if (line.startsWith('data:')) {
+            dataLines.push(line.slice(DATA_FIELD_PREFIX_LENGTH).trim());
+        }
+    }
+    return dataLines;
+}
+/**
+ * The frame's payload as text. A frame may spread one value over several `data:` lines, and the
+ * spec says to join them with a newline, so that is what happens here rather than reading only
+ * the first line.
+ *
+ *     'event: x\ndata: {"a":1}'  -> '{"a":1}'
+ *     'data: one\ndata: two'     -> 'one\ntwo'
+ *     'data: [DONE]'             -> '[DONE]'
+ *     'event: ping'              -> null       // nothing to read
+ */
+export function getSseDataPayload(frame) {
+    const dataLines = getSseDataLines(frame);
+    return dataLines.length ? dataLines.join('\n').trim() : null;
+}
+/**
+ * The frame's payload parsed as JSON, or undefined when there is nothing to act on.
+ *
+ *     'event: x\ndata: {"a":1}'  -> { a: 1 }
+ *     'data: {"a":1}\nevent: x'  -> { a: 1 }
+ *     'event: ping'              -> undefined  // no data line
+ *     'data: [DONE]'             -> undefined  // end-of-stream marker, not an event
+ *     'data: not json'           -> undefined  // cannot be parsed
+ *
+ * All the undefined cases look alike from here. If you need to tell them apart — to report an
+ * unfamiliar frame shape, say — call getSseDataPayload and parse it yourself.
+ */
+export function parseSseDataJson(frame) {
+    const payload = getSseDataPayload(frame);
+    if (!payload || payload === SSE_DONE_PAYLOAD) {
+        return undefined;
+    }
+    try {
+        return JSON.parse(payload);
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=sseUtils.js.map

package/dist/utils/sseUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sseUtils.js","sourceRoot":"","sources":["../../src/utils/sseUtils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,eAAe,GAAG,YAAY,CAAC;AAErC;;;;;;;;GAQG;AACH,MAAM,UAAU,GAAG,cAAc,CAAC;AAElC,oFAAoF;AACpF,MAAM,gBAAgB,GAAG,WAAW,CAAC;AAErC;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAClC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,wFAAwF;IACxF,mFAAmF;IACnF,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IACvC,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1C,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1C,SAAS;QACX,CAAC;QACD,IAAI,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;AACnC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAEH,iGAAiG;AACjG,MAAM,wBAAwB,GAAG,OAAO,CAAC,MAAM,CAAC;AAEhD,8FAA8F;AAC9F,MAAM,gBAAgB,GAAG,QAAQ,CAAC;AAElC;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,eAAe,CAAC,EAAE,CAAC;QAChD,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YAC7B,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,MAAM,SAAS,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IACzC,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAC/D,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,gBAAgB,CAAc,KAAa;IACzD,MAAM,OAAO,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;IACzC,IAAI,CAAC,OAAO,IAAI,OAAO,KAAK,gBAAgB,EAAE,CAAC;QAC7C,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAM,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/utils/systemMessageUtils.d.ts

@@ -0,0 +1,7 @@
+/** Marks text that was operator-authored, so a converted turn is not read as the user speaking. */
+export declare const CONVERTED_SYSTEM_NOTE = "Operator note (not from the user): the following was originally a mid-conversation system message.";
+export declare const isSystemRole: (msg: any) => boolean;
+export declare function extractSystemText(content: any): string;
+export declare function asContentBlocks(content: any): any[];
+export declare function countLeadingSystemMessages(messages: any[]): number;
+export declare function reorderSystemRunsAroundToolResults(messages: any[]): any[];