fg-tracker-sdk 0.10.0 → 0.13.0

package/dist/genai/call.js

@@ -0,0 +1,260 @@
+import { performance } from 'node:perf_hooks';
+import { FG_GEN_AI, GEN_AI, GEN_AI_SEMCONV_VERSION } from './semconv.js';
+/** Inteiro ≥ 0 informado pelo provedor; qualquer outra coisa conta como "não informado". */
+export function tokenCount(value) {
+    return typeof value === 'number' && Number.isSafeInteger(value) && value >= 0 ? value : undefined;
+}
+/** Identificador de erro de baixa cardinalidade (`rate_limit_error`, `429`); texto livre fica de fora. */
+export function errorTypeOf(value) {
+    if (typeof value === 'number' && Number.isInteger(value))
+        return String(value);
+    return typeof value === 'string' && /^[A-Za-z0-9_.:-]{1,64}$/.test(value) ? value : undefined;
+}
+/** `gen_ai.request.model`/`response.model`: nome de modelo, sem aceitar texto arbitrário enorme. */
+export function modelName(value) {
+    return typeof value === 'string' && value.length > 0 && value.length <= 256 ? value : undefined;
+}
+function finiteNumber(value) {
+    return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
+}
+function priceFor(pricing, provider, models) {
+    for (const model of models) {
+        if (!model)
+            continue;
+        const candidates = pricing.models.filter((entry) => entry.model === model && (entry.provider === undefined || entry.provider === provider));
+        // Entrada do provedor vence a genérica para o mesmo nome.
+        const best = candidates.find((entry) => entry.provider === provider) ?? candidates[0];
+        if (best)
+            return best;
+    }
+    return undefined;
+}
+/**
+ * Custo estimado pela tabela, ou `undefined` quando faltar qualquer dado: uso parcial ou ausente,
+ * classe de token sem preço, modelo fora da tabela. Nunca completa o que o provedor não informou.
+ */
+export function estimateCost(pricing, provider, operation, models, usage) {
+    const price = priceFor(pricing, provider, models);
+    if (!price || usage.input === undefined)
+        return undefined;
+    const cacheRead = usage.cacheRead ?? 0;
+    const cacheCreation = usage.cacheCreation ?? 0;
+    const uncached = usage.input - cacheRead - cacheCreation;
+    if (uncached < 0)
+        return undefined;
+    if (cacheRead > 0 && price.cacheReadPerMillion === undefined)
+        return undefined;
+    if (cacheCreation > 0 && price.cacheCreationPerMillion === undefined)
+        return undefined;
+    let output = 0;
+    if (operation !== 'embeddings') {
+        if (usage.output === undefined || price.outputPerMillion === undefined)
+            return undefined;
+        output = usage.output * price.outputPerMillion;
+    }
+    else if (usage.output !== undefined && usage.output > 0) {
+        if (price.outputPerMillion === undefined)
+            return undefined;
+        output = usage.output * price.outputPerMillion;
+    }
+    const total = uncached * price.inputPerMillion + cacheRead * (price.cacheReadPerMillion ?? 0) + cacheCreation * (price.cacheCreationPerMillion ?? 0) + output;
+    return Math.round((total / 1_000_000) * 1e12) / 1e12;
+}
+/**
+ * Estado de uma chamada de IA presa a um span já existente (o `http.client` do `fetch` ou o span da
+ * chamada AWS). Não cria span: só acrescenta atributos `gen_ai.*`/`fg.gen_ai.*` e encerra o span
+ * uma única vez, quando a resposta termina (no stream, quando o corpo acaba ou é cancelado).
+ */
+export class GenAiCall {
+    span;
+    config;
+    provider;
+    operation;
+    startedPerf;
+    requestModel;
+    usage = {};
+    /** O stream terminou antes do uso final: o que há de uso é parcial (ex.: só a entrada). */
+    usagePartial = false;
+    /**
+     * Escolhas pedidas (`n` do Chat Completions; 1 sem o parâmetro). Um stream que acaba sem o marcador
+     * final só é `completed` se todas elas trouxeram motivo de parada.
+     */
+    expectedChoices = 1;
+    /**
+     * A resposta já chegou com HTTP ≥ 400: o desfecho é `error` de qualquer jeito. Prazo sem leitura,
+     * abort ou cancelamento do corpo depois dos headers não o trocam por `unobserved`/`cancelled`.
+     */
+    failed = false;
+    reportedCost;
+    responseId;
+    responseModel;
+    /** Motivo de parada por índice de escolha. */
+    finishReasons = [];
+    errorType;
+    firstChunkPerf;
+    finished = false;
+    cleanups = [];
+    watchdog;
+    /** Última leitura do corpo (`performance.now()`): o prazo de observação conta a partir dela. */
+    lastActivity = 0;
+    constructor(span, config, provider, operation, startedPerf, requestModel) {
+        this.span = span;
+        this.config = config;
+        this.provider = provider;
+        this.operation = operation;
+        this.startedPerf = startedPerf;
+        this.requestModel = requestModel;
+        span.setAttribute(GEN_AI.operation, operation);
+        span.setAttribute(GEN_AI.provider, provider);
+        span.setAttribute(FG_GEN_AI.semconvVersion, GEN_AI_SEMCONV_VERSION);
+        if (requestModel)
+            span.setAttribute(GEN_AI.requestModel, requestModel);
+    }
+    get done() {
+        return this.finished;
+    }
+    /** Atributo do pedido (só valores numéricos/booleanos/enumerados; nunca conteúdo). */
+    setRequest(key, value) {
+        if (value === undefined || value === null)
+            return;
+        this.span.setAttribute(key, value);
+    }
+    /** Primeiro evento do stream (`gen_ai.response.time_to_first_chunk`). */
+    markFirstChunk() {
+        if (this.firstChunkPerf === undefined)
+            this.firstChunkPerf = performance.now();
+    }
+    setFinishReason(index, reason) {
+        if (typeof reason !== 'string' || !reason || reason.length > 64)
+            return;
+        if (!Number.isInteger(index) || index < 0 || index > 127)
+            return;
+        this.finishReasons[index] = reason;
+    }
+    setResponseId(value) {
+        if (this.responseId === undefined && typeof value === 'string' && value.length > 0 && value.length <= 256)
+            this.responseId = value;
+    }
+    setResponseModel(value) {
+        const model = modelName(value);
+        if (model)
+            this.responseModel = model;
+    }
+    /**
+     * Fecha a observação depois de `observationIdleMs` sem leitura do corpo (resposta abandonada): o
+     * span sai com o que foi visto. Um stream longo que continua sendo lido não é cortado.
+     */
+    armWatchdog() {
+        if (this.finished || this.watchdog)
+            return;
+        this.lastActivity = performance.now();
+        this.schedule(this.config.observationIdleMs);
+    }
+    /** Houve leitura do corpo: adia o prazo sem custo de timer por pedaço. */
+    markActivity() {
+        this.lastActivity = performance.now();
+    }
+    schedule(ms) {
+        this.watchdog = setTimeout(() => {
+            const idle = performance.now() - this.lastActivity;
+            if (idle >= this.config.observationIdleMs)
+                this.finish('unobserved');
+            else
+                this.schedule(this.config.observationIdleMs - idle);
+        }, Math.max(1, Math.ceil(ms)));
+        if (typeof this.watchdog === 'object' && this.watchdog && 'unref' in this.watchdog)
+            this.watchdog.unref();
+    }
+    onFinish(cleanup) {
+        if (this.finished)
+            cleanup();
+        else
+            this.cleanups.push(cleanup);
+    }
+    /**
+     * Encerra a chamada. `error` só vira `span.error` quando informado (falha de rede, erro do provedor
+     * no corpo); HTTP 4xx fica em `error.type` sem virar issue, como no resto do `http.client`.
+     */
+    finish(outcome, error) {
+        if (this.finished)
+            return;
+        this.finished = true;
+        if (this.failed)
+            outcome = 'error';
+        if (this.watchdog)
+            clearTimeout(this.watchdog);
+        for (const cleanup of this.cleanups.splice(0)) {
+            try {
+                cleanup();
+            }
+            catch {
+                /* limpeza nunca quebra a aplicação */
+            }
+        }
+        try {
+            this.applyAttributes(outcome);
+            if (error !== undefined && !this.span.error)
+                this.span.setError(error);
+        }
+        finally {
+            this.span.end();
+        }
+    }
+    applyAttributes(outcome) {
+        const span = this.span;
+        span.setAttribute(FG_GEN_AI.outcome, outcome);
+        if (this.responseId)
+            span.setAttribute(GEN_AI.responseId, this.responseId);
+        if (this.responseModel)
+            span.setAttribute(GEN_AI.responseModel, this.responseModel);
+        const reasons = this.finishReasons.filter((reason) => typeof reason === 'string');
+        if (reasons.length > 0)
+            span.setAttribute(GEN_AI.responseFinishReasons, reasons);
+        if (this.errorType)
+            span.setAttribute(GEN_AI.errorType, this.errorType);
+        if (this.firstChunkPerf !== undefined) {
+            span.setAttribute(GEN_AI.timeToFirstChunk, Math.max(0, Math.round(this.firstChunkPerf - this.startedPerf)) / 1000);
+        }
+        const usage = this.usage;
+        const has = (value) => value !== undefined;
+        if (has(usage.input))
+            span.setAttribute(GEN_AI.inputTokens, usage.input);
+        if (has(usage.output))
+            span.setAttribute(GEN_AI.outputTokens, usage.output);
+        if (has(usage.cacheRead))
+            span.setAttribute(GEN_AI.cacheReadInputTokens, usage.cacheRead);
+        if (has(usage.cacheCreation))
+            span.setAttribute(GEN_AI.cacheCreationInputTokens, usage.cacheCreation);
+        if (has(usage.reasoning))
+            span.setAttribute(GEN_AI.reasoningOutputTokens, usage.reasoning);
+        const anyUsage = has(usage.input) || has(usage.output);
+        if (anyUsage && this.usagePartial)
+            span.setAttribute(FG_GEN_AI.usagePartial, true);
+        if (this.reportedCost) {
+            span.setAttribute(FG_GEN_AI.costAmount, this.reportedCost.amount);
+            span.setAttribute(FG_GEN_AI.costCurrency, this.reportedCost.currency);
+            span.setAttribute(FG_GEN_AI.costEstimated, false);
+            span.setAttribute(FG_GEN_AI.costSource, this.reportedCost.source);
+            return;
+        }
+        const pricing = this.config.pricing;
+        if (!pricing || !anyUsage || this.usagePartial)
+            return;
+        const amount = estimateCost(pricing, this.provider, this.operation, [this.requestModel, this.responseModel], usage);
+        if (amount === undefined)
+            return;
+        span.setAttribute(FG_GEN_AI.costAmount, amount);
+        span.setAttribute(FG_GEN_AI.costCurrency, pricing.currency);
+        span.setAttribute(FG_GEN_AI.costEstimated, true);
+        span.setAttribute(FG_GEN_AI.costSource, pricing.source);
+        span.setAttribute(FG_GEN_AI.costPricingVersion, pricing.version);
+    }
+}
+/** Custo informado pelo provedor no corpo (`usage.cost` do OpenRouter, em créditos = USD). */
+export function reportedCost(provider, usage) {
+    if (provider !== 'openrouter')
+        return undefined;
+    const amount = finiteNumber(usage.cost);
+    return amount !== undefined && amount >= 0 ? { amount, currency: 'USD', source: 'openrouter:usage.cost' } : undefined;
+}
+//# sourceMappingURL=call.js.map

package/dist/genai/call.js.map

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

package/dist/genai/config.d.ts

@@ -0,0 +1,71 @@
+import type { GenAiOperation } from './semconv.js';
+/** Formato de API reconhecido: Chat Completions/Embeddings (`openai`) ou Messages (`anthropic`). */
+export type GenAiApiFormat = 'openai' | 'anthropic';
+/** Endpoint de IA além dos embutidos (gateway OpenAI-compatível, servidor próprio). */
+export interface GenAiEndpoint {
+    /**
+     * Prefixo de `origem + caminho` (`https://llm.interno:8443/v1`) ou RegExp testada contra
+     * `origem + caminho` (sem query). Só requisições `POST` nos caminhos do formato contam.
+     */
+    baseUrl: string | RegExp;
+    /** Valor de `gen_ai.provider.name` (ex.: `azure.ai.openai`, `vllm`). */
+    provider: string;
+    /** `openai`: `…/chat/completions` e `…/embeddings`. `anthropic`: `…/messages`. */
+    api: GenAiApiFormat;
+}
+/** Preço de um modelo, por 1 milhão de tokens, na moeda da tabela. */
+export interface GenAiModelPrice {
+    /** Restringe a entrada a um `gen_ai.provider.name`; sem ele, vale para qualquer provedor. */
+    provider?: string;
+    /** Nome exato do modelo, comparado com o pedido e, sem entrada para ele, com o devolvido. */
+    model: string;
+    inputPerMillion: number;
+    /** Obrigatório para estimar `chat`; dispensável em `embeddings`. */
+    outputPerMillion?: number;
+    /** Sem ele, chamada com tokens lidos do cache fica sem estimativa. */
+    cacheReadPerMillion?: number;
+    /** Sem ele, chamada com tokens gravados no cache fica sem estimativa. */
+    cacheCreationPerMillion?: number;
+}
+/**
+ * Tabela de preços para o custo estimado. O SDK não traz preços embutidos: sem tabela, só aparece
+ * o custo que o provedor informa (OpenRouter). Toda estimativa leva fonte, versão e moeda.
+ */
+export interface GenAiPricing {
+    /** De onde vieram os preços (URL da página de preços, contrato). Vai em `fg.gen_ai.cost.source`. */
+    source: string;
+    /** Versão ou data da tabela (`2026-10-01`). Vai em `fg.gen_ai.cost.pricing_version`. */
+    version: string;
+    /** Moeda ISO 4217 (`USD`, `BRL`). */
+    currency: string;
+    models: GenAiModelPrice[];
+}
+export interface GenAiOptions {
+    /** Endpoints além de `api.openai.com`, `openrouter.ai/api` e `api.anthropic.com`; vencem os embutidos. */
+    endpoints?: GenAiEndpoint[];
+    /** Tabela para o custo estimado (`fg.gen_ai.cost.estimated = true`). Inválida = ignorada com aviso. */
+    pricing?: GenAiPricing;
+    /**
+     * Prazo sem leitura do corpo de uma resposta (stream abandonado, resposta que ninguém lê) para
+     * encerrar a observação: o span fecha com `fg.gen_ai.outcome = 'unobserved'`. Conta a partir da
+     * última leitura; um stream longo que continua sendo lido não é cortado. Default 15 min.
+     */
+    observationIdleMs?: number;
+}
+export interface ResolvedGenAi {
+    endpoints: GenAiEndpoint[];
+    pricing: GenAiPricing | null;
+    observationIdleMs: number;
+}
+/** Endpoint reconhecido para uma requisição. */
+export interface GenAiTarget {
+    provider: string;
+    api: GenAiApiFormat;
+    operation: GenAiOperation;
+}
+/** Tabela válida ou o motivo da recusa. Uma entrada ruim invalida a tabela inteira: nada de estimativa com dado duvidoso. */
+export declare function validatePricing(pricing: GenAiPricing): string | null;
+export declare function resolveGenAi(options: GenAiOptions | false | undefined, warn: (message: string) => void): ResolvedGenAi | null;
+/** Endpoint de IA de uma requisição, ou `null` (método diferente de POST, host ou caminho desconhecido). */
+export declare function matchGenAiTarget(config: ResolvedGenAi, method: string, url: URL): GenAiTarget | null;
+//# sourceMappingURL=config.d.ts.map

package/dist/genai/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/genai/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,oGAAoG;AACpG,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,WAAW,CAAC;AAEpD,uFAAuF;AACvF,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,wEAAwE;IACxE,QAAQ,EAAE,MAAM,CAAC;IACjB,kFAAkF;IAClF,GAAG,EAAE,cAAc,CAAC;CACrB;AAED,sEAAsE;AACtE,MAAM,WAAW,eAAe;IAC9B,6FAA6F;IAC7F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6FAA6F;IAC7F,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,CAAC;IACxB,oEAAoE;IACpE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,sEAAsE;IACtE,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,yEAAyE;IACzE,uBAAuB,CAAC,EAAE,MAAM,CAAC;CAClC;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,oGAAoG;IACpG,MAAM,EAAE,MAAM,CAAC;IACf,wFAAwF;IACxF,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,YAAY;IAC3B,0GAA0G;IAC1G,SAAS,CAAC,EAAE,aAAa,EAAE,CAAC;IAC5B,uGAAuG;IACvG,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAC7B,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,gDAAgD;AAChD,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,cAAc,CAAC;IACpB,SAAS,EAAE,cAAc,CAAC;CAC3B;AAmBD,6HAA6H;AAC7H,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,GAAG,IAAI,CAepE;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,KAAK,GAAG,SAAS,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,aAAa,GAAG,IAAI,CAuB7H;AA4BD,4GAA4G;AAC5G,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,WAAW,GAAG,IAAI,CAUpG"}

package/dist/genai/config.js

@@ -0,0 +1,110 @@
+const DEFAULT_OBSERVATION_IDLE_MS = 15 * 60_000;
+/** Ordem importa: os do usuário vêm antes e vencem. */
+const BUILT_IN_ENDPOINTS = [
+    { baseUrl: 'https://api.openai.com/', provider: 'openai', api: 'openai' },
+    { baseUrl: 'https://openrouter.ai/api/', provider: 'openrouter', api: 'openai' },
+    { baseUrl: 'https://api.anthropic.com/', provider: 'anthropic', api: 'anthropic' },
+];
+const NAME_RE = /^[A-Za-z0-9][A-Za-z0-9_.:/-]{0,127}$/;
+const CURRENCY_RE = /^[A-Z]{3}$/;
+function validPrice(value, required) {
+    if (value === undefined)
+        return !required;
+    return typeof value === 'number' && Number.isFinite(value) && value >= 0;
+}
+/** Tabela válida ou o motivo da recusa. Uma entrada ruim invalida a tabela inteira: nada de estimativa com dado duvidoso. */
+export function validatePricing(pricing) {
+    if (!pricing || typeof pricing !== 'object')
+        return 'tabela ausente';
+    if (typeof pricing.source !== 'string' || !pricing.source.trim() || pricing.source.length > 300)
+        return '`source` obrigatório (até 300 caracteres)';
+    if (typeof pricing.version !== 'string' || !pricing.version.trim() || pricing.version.length > 100)
+        return '`version` obrigatório (até 100 caracteres)';
+    if (typeof pricing.currency !== 'string' || !CURRENCY_RE.test(pricing.currency))
+        return '`currency` precisa ser um código ISO 4217 em maiúsculas (ex.: USD)';
+    if (!Array.isArray(pricing.models) || pricing.models.length === 0)
+        return '`models` vazio';
+    for (const [index, entry] of pricing.models.entries()) {
+        if (!entry || typeof entry.model !== 'string' || !entry.model.trim())
+            return `models[${index}]: \`model\` obrigatório`;
+        if (entry.provider !== undefined && (typeof entry.provider !== 'string' || !entry.provider.trim()))
+            return `models[${index}]: \`provider\` inválido`;
+        if (!validPrice(entry.inputPerMillion, true))
+            return `models[${index}]: \`inputPerMillion\` precisa ser um número ≥ 0`;
+        for (const key of ['outputPerMillion', 'cacheReadPerMillion', 'cacheCreationPerMillion']) {
+            if (!validPrice(entry[key], false))
+                return `models[${index}]: \`${key}\` precisa ser um número ≥ 0`;
+        }
+    }
+    return null;
+}
+export function resolveGenAi(options, warn) {
+    if (options === false)
+        return null;
+    const endpoints = [];
+    for (const endpoint of options?.endpoints ?? []) {
+        const validBase = endpoint && (endpoint.baseUrl instanceof RegExp || (typeof endpoint.baseUrl === 'string' && /^https?:\/\/./.test(endpoint.baseUrl)));
+        if (!validBase || typeof endpoint.provider !== 'string' || !NAME_RE.test(endpoint.provider) || (endpoint.api !== 'openai' && endpoint.api !== 'anthropic')) {
+            warn('genAi.endpoints: entrada ignorada (precisa de baseUrl http(s) ou RegExp, provider e api `openai`|`anthropic`)');
+            continue;
+        }
+        endpoints.push(endpoint);
+    }
+    let pricing = null;
+    if (options?.pricing !== undefined) {
+        const problem = validatePricing(options.pricing);
+        if (problem)
+            warn(`genAi.pricing ignorada, custo não será estimado: ${problem}`);
+        else
+            pricing = options.pricing;
+    }
+    const idle = options?.observationIdleMs;
+    return {
+        endpoints: [...endpoints, ...BUILT_IN_ENDPOINTS],
+        pricing,
+        observationIdleMs: typeof idle === 'number' && Number.isFinite(idle) && idle > 0 ? idle : DEFAULT_OBSERVATION_IDLE_MS,
+    };
+}
+function operationFor(api, pathname) {
+    const path = pathname.replace(/\/+$/, '');
+    if (api === 'openai') {
+        if (path.endsWith('/chat/completions'))
+            return 'chat';
+        if (path.endsWith('/embeddings'))
+            return 'embeddings';
+        return null;
+    }
+    // `/v1/messages/count_tokens` e `/v1/messages/batches` não são geração.
+    return path.endsWith('/messages') ? 'chat' : null;
+}
+function matchesBase(base, target) {
+    if (base instanceof RegExp) {
+        if (!base.global && !base.sticky)
+            return base.test(target);
+        const previous = base.lastIndex;
+        base.lastIndex = 0;
+        try {
+            return base.test(target);
+        }
+        finally {
+            base.lastIndex = previous;
+        }
+    }
+    const prefix = base.replace(/\/+$/, '');
+    return target === prefix || target.startsWith(`${prefix}/`);
+}
+/** Endpoint de IA de uma requisição, ou `null` (método diferente de POST, host ou caminho desconhecido). */
+export function matchGenAiTarget(config, method, url) {
+    if (method !== 'POST')
+        return null;
+    const target = `${url.origin}${url.pathname}`;
+    for (const endpoint of config.endpoints) {
+        if (!matchesBase(endpoint.baseUrl, target))
+            continue;
+        const operation = operationFor(endpoint.api, url.pathname);
+        // O primeiro endpoint que casa decide: um gateway do usuário não cai num embutido.
+        return operation ? { provider: endpoint.provider, api: endpoint.api, operation } : null;
+    }
+    return null;
+}
+//# sourceMappingURL=config.js.map

package/dist/genai/config.js.map

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

package/dist/genai/http.d.ts

@@ -0,0 +1,49 @@
+import type { ActiveSpan } from '../types.js';
+import { GenAiCall } from './call.js';
+import type { GenAiApiFormat, GenAiTarget, ResolvedGenAi } from './config.js';
+export declare function isAbortError(err: unknown): boolean;
+/**
+ * Prende o estado GenAI ao span `http.client` de uma requisição reconhecida. Lê só o corpo em
+ * texto/bytes já em memória (o SDK da OpenAI e o da Anthropic mandam string); `Request` com corpo
+ * em stream não é lido, e o modelo sai da resposta.
+ */
+export declare function startHttpGenAiCall(config: ResolvedGenAi, span: ActiveSpan, target: GenAiTarget, input: string | URL | Request, init: RequestInit | undefined, startedPerf?: number): GenAiCall;
+/**
+ * A requisição falhou antes da resposta (rede, abort). Cancelamento não é erro: vale o `AbortError` e
+ * também o `signal` abortado com motivo próprio (`controller.abort(new Error(...))`), com que o
+ * `fetch` rejeita no lugar do `AbortError`.
+ */
+export declare function failHttpGenAiCall(call: GenAiCall, err: unknown, signal?: AbortSignal | null): void;
+/**
+ * Pares chave → valor da **raiz** de um objeto JSON lidos de trás para frente a partir do fim do
+ * texto (o fim do corpo), sem precisar do começo. Lendo de trás para frente a partir do `}` final,
+ * sempre se sabe se a posição está dentro de uma string (cada `"` não escapado alterna) e a que
+ * profundidade: só pares na profundidade 1 entram. A leitura para no primeiro ponto que o corte do
+ * trecho deixa ambíguo; o que começa antes dele é ignorado.
+ */
+export declare function rootEntriesFromEnd(text: string): Record<string, unknown>;
+/**
+ * Estrutura de um corpo JSON acompanhada byte a byte desde o início, sem guardar o corpo: profundidade
+ * de `{`/`[` fora de strings (cada `"` não escapado alterna; `\` escapa o byte seguinte). Os bytes que
+ * importam (`"`, `\`, chaves e colchetes) são ASCII e nunca aparecem dentro de um caractere UTF-8 de
+ * vários bytes, então os pedaços podem ser lidos como chegam, partidos em qualquer ponto.
+ * `complete` = o corpo é um objeto (`{` como primeiro byte não branco) cuja raiz fecha uma vez, no
+ * fim, com no máximo espaço em branco depois.
+ */
+export declare class JsonShape {
+    private depth;
+    private inString;
+    private escaped;
+    private started;
+    private closed;
+    private broken;
+    push(bytes: Uint8Array): void;
+    get complete(): boolean;
+}
+/**
+ * Observa a resposta e devolve a que vai para quem chamou: uma equivalente cujo corpo é repassado
+ * sob demanda e observado no caminho (JSON e stream SSE, sem leitura adiantada; erro HTTP numa cópia
+ * limitada), ou a própria quando não dá para observar. O span fecha quando a observação termina.
+ */
+export declare function observeHttpGenAiResponse(call: GenAiCall, res: Response, api: GenAiApiFormat, signal: AbortSignal | null | undefined): Response;
+//# sourceMappingURL=http.d.ts.map

package/dist/genai/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/genai/http.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAe,SAAS,EAAwD,MAAM,WAAW,CAAC;AACzG,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAyC9E,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAGlD;AAuDD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,EAC7B,IAAI,EAAE,WAAW,GAAG,SAAS,EAC7B,WAAW,GAAE,MAA0B,GACtC,SAAS,CASX;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI,GAAG,IAAI,CASlG;AA2HD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAwCxE;AAqTD;;;;;;;GAOG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAS;IAEvB,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IA0B7B,IAAI,QAAQ,IAAI,OAAO,CAEtB;CACF;AAiGD;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,cAAc,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,GAAG,SAAS,GAAG,QAAQ,CAqC9I"}