fg-tracker-sdk 0.11.0 → 0.14.0

package/dist/fetch.js

@@ -1,4 +1,7 @@
+import { performance } from 'node:perf_hooks';
 import { TRACEPARENT_HEADER, TRACESTATE_HEADER, traceContextHeaders } from './context.js';
+import { matchGenAiTarget } from './genai/config.js';
+import { failHttpGenAiCall, observeHttpGenAiResponse, startHttpGenAiCall } from './genai/http.js';
 import { httpClientSemconv, normalizePath } from './normalize.js';
 import { shouldPropagate } from './tracker.js';
 function describe(input, init) {
@@ -59,27 +62,53 @@ export function createInstrumentedFetch(core, fetchImpl = globalThis.fetch) {
         if (!url || raw.startsWith(ownEndpoint))
             return base(input, init);
         const name = `${method} ${url.origin}${normalizePath(url.pathname)}`;
+        const startedPerf = performance.now();
         const span = core.startSpan('http.client', name, { url: url.origin + url.pathname + url.search, host: url.host, ...httpClientSemconv(url) });
         span.method = method;
         span.route = normalizePath(url.pathname);
+        // Chamada de IA reconhecida: atributos `gen_ai.*` neste mesmo span, que fecha no fim da resposta (§30).
+        const genAiConfig = core.genAiFor(span);
+        const target = genAiConfig ? matchGenAiTarget(genAiConfig, method, url) : null;
+        let genAi = null;
+        if (genAiConfig && target) {
+            try {
+                genAi = startHttpGenAiCall(genAiConfig, span, target, input, init, startedPerf);
+            }
+            catch {
+                genAi = null;
+            }
+        }
         let request = { input, init };
         if (shouldPropagate(core.options.propagateTraceTo, url)) {
             request = withTraceContext(input, init, traceContextHeaders(span.context()));
             span.setAttribute('propagated', true);
         }
+        let handedOff = false;
+        const signal = init?.signal ?? (input instanceof Request ? input.signal : undefined);
         try {
             const res = await core.runInSpan(span, () => base(request.input, request.init));
             span.statusCode = res.status;
             if (res.status >= 500)
                 span.error = { name: 'HttpError', message: `HTTP ${res.status}` };
+            if (genAi && target) {
+                handedOff = true;
+                return observeHttpGenAiResponse(genAi, res, target.api, signal);
+            }
             return res;
         }
         catch (err) {
-            span.setError(err);
+            if (genAi && !handedOff) {
+                handedOff = true;
+                failHttpGenAiCall(genAi, err, signal);
+            }
+            else {
+                span.setError(err);
+            }
             throw err;
         }
         finally {
-            span.end();
+            if (!handedOff)
+                span.end();
         }
     };
 }

package/dist/fetch.js.map

@@ -1 +1 @@
-{"version":3,"file":"fetch.js","sourceRoot":"","sources":["../src/fetch.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"fetch.js","sourceRoot":"","sources":["../src/fetch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAE1F,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAClG,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,EAAE,eAAe,EAAoB,MAAM,cAAc,CAAC;AAEjE,SAAS,QAAQ,CAAC,KAA6B,EAAE,IAAkB;IACjE,IAAI,GAAW,CAAC;IAChB,IAAI,MAAM,GAAG,IAAI,EAAE,MAAM,CAAC;IAC1B,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,GAAG,GAAG,KAAK,CAAC;SACtC,IAAI,KAAK,YAAY,GAAG;QAAE,GAAG,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;SACjD,CAAC;QACJ,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC;QAChB,MAAM,GAAG,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC;IAClC,CAAC;IACD,IAAI,GAAG,GAAe,IAAI,CAAC;IAC3B,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;IAAC,MAAM,CAAC;QACP,GAAG,GAAG,IAAI,CAAC;IACb,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,WAAW,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;AAC/D,CAAC;AAED;;;GAGG;AACH,SAAS,gBAAgB,CAAC,KAA6B,EAAE,IAA6B,EAAE,MAA8B;IACpH,MAAM,KAAK,GAAG,CAAC,OAAgB,EAAE,EAAE;QACjC,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,MAAM,CAAC,kBAAkB,CAAE,CAAC,CAAC;QAC7D,IAAI,MAAM,CAAC,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;YAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC;IAC9H,CAAC,CAAC;IACF,IAAI,KAAK,YAAY,OAAO,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC;QAC/C,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;YAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QAClE,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC3C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,OAAO,EAAE,KAAK,EAAE,IAAI,OAAO,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC;IAC1D,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,IAAI,EAAE,OAAO,IAAI,CAAC,KAAK,YAAY,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IACrG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;QAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IACrD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC;AAC/C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAAiB,EAAE,YAAqC,UAAU,CAAC,KAAK;IAC9G,MAAM,IAAI,GAAG,SAAS,CAAC;IACvB,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;IAC1C,OAAO,KAAK,UAAU,cAAc,CAAC,KAA6B,EAAE,IAAkB;QACpF,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE;YAAE,OAAO,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACtE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACnD,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,WAAW,CAAC;YAAE,OAAO,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAElE,MAAM,IAAI,GAAG,GAAG,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;QACrE,MAAM,WAAW,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,aAAa,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,iBAAiB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC7I,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACzC,wGAAwG;QACxG,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACxC,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC/E,IAAI,KAAK,GAAqB,IAAI,CAAC;QACnC,IAAI,WAAW,IAAI,MAAM,EAAE,CAAC;YAC1B,IAAI,CAAC;gBACH,KAAK,GAAG,kBAAkB,CAAC,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;YAClF,CAAC;YAAC,MAAM,CAAC;gBACP,KAAK,GAAG,IAAI,CAAC;YACf,CAAC;QACH,CAAC;QACD,IAAI,OAAO,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QAC9B,IAAI,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC,EAAE,CAAC;YACxD,OAAO,GAAG,gBAAgB,CAAC,KAAK,EAAE,IAAI,EAAE,mBAAmB,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YAC7E,IAAI,CAAC,YAAY,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;QACxC,CAAC;QACD,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,MAAM,MAAM,GAAG,IAAI,EAAE,MAAM,IAAI,CAAC,KAAK,YAAY,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QACrF,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;YAChF,IAAI,CAAC,UAAU,GAAG,GAAG,CAAC,MAAM,CAAC;YAC7B,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG;gBAAE,IAAI,CAAC,KAAK,GAAG,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC;YACzF,IAAI,KAAK,IAAI,MAAM,EAAE,CAAC;gBACpB,SAAS,GAAG,IAAI,CAAC;gBACjB,OAAO,wBAAwB,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YAClE,CAAC;YACD,OAAO,GAAG,CAAC;QACb,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,KAAK,IAAI,CAAC,SAAS,EAAE,CAAC;gBACxB,SAAS,GAAG,IAAI,CAAC;gBACjB,iBAAiB,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;YACxC,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;YACrB,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,SAAS;gBAAE,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/genai/bedrock.d.ts

@@ -0,0 +1,22 @@
+import type { ActiveSpan } from '../types.js';
+import { type GenAiUsage } from './call.js';
+import type { ResolvedGenAi } from './config.js';
+/**
+ * Ganchos que o middleware AWS chama em volta de `next()`. Com observador, o fim do span é dele:
+ * na hora (`Converse`, erro) ou quando o stream de eventos termina (`ConverseStream`).
+ */
+export interface AwsGenAiObserver {
+    output(result: {
+        output?: unknown;
+    } | undefined): void;
+    /** Cancelamento fecha sem `span.error`; o resto, com o erro. */
+    error(err: unknown): void;
+}
+export declare function isBedrockRuntime(label: string): boolean;
+/**
+ * `usage` do Converse. A AWS documenta `inputTokens` sem o cache (`totalTokens` = entrada + saída +
+ * cache); se o próprio `totalTokens` mostrar que o cache já está dentro, não soma de novo.
+ */
+export declare function bedrockUsage(raw: unknown): GenAiUsage;
+export declare function startBedrockCall(config: ResolvedGenAi, span: ActiveSpan, operation: string, input: unknown, startedPerf?: number): AwsGenAiObserver | null;
+//# sourceMappingURL=bedrock.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bedrock.d.ts","sourceRoot":"","sources":["../../src/genai/bedrock.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAiD,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AAC3F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAgBjD;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,MAAM,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,SAAS,GAAG,IAAI,CAAC;IACvD,gEAAgE;IAChE,KAAK,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAAC;CAC3B;AAID,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,CAerD;AAeD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,GAAE,MAA0B,GAAG,gBAAgB,GAAG,IAAI,CA+C7K"}

package/dist/genai/bedrock.js

@@ -0,0 +1,161 @@
+import { performance } from 'node:perf_hooks';
+import { errorTypeOf, GenAiCall, modelName, tokenCount } from './call.js';
+import { isAbortError } from './http.js';
+import { GEN_AI } from './semconv.js';
+function obj(value) {
+    return value && typeof value === 'object' && !Array.isArray(value) ? value : {};
+}
+const OPERATIONS = new Set(['Converse', 'ConverseStream']);
+export function isBedrockRuntime(label) {
+    return label.toLowerCase().replace(/[^a-z0-9]/g, '') === 'bedrockruntime';
+}
+/**
+ * `usage` do Converse. A AWS documenta `inputTokens` sem o cache (`totalTokens` = entrada + saída +
+ * cache); se o próprio `totalTokens` mostrar que o cache já está dentro, não soma de novo.
+ */
+export function bedrockUsage(raw) {
+    const usage = obj(raw);
+    const input = tokenCount(usage.inputTokens);
+    const output = tokenCount(usage.outputTokens);
+    const total = tokenCount(usage.totalTokens);
+    const cacheRead = tokenCount(usage.cacheReadInputTokens);
+    const cacheCreation = tokenCount(usage.cacheWriteInputTokens);
+    const cache = (cacheRead ?? 0) + (cacheCreation ?? 0);
+    const alreadyIncluded = cache > 0 && input !== undefined && output !== undefined && total === input + output;
+    return {
+        input: input === undefined ? undefined : alreadyIncluded ? input : input + cache,
+        output,
+        cacheRead,
+        cacheCreation,
+    };
+}
+function bedrockErrorType(err) {
+    const named = err;
+    return errorTypeOf(named?.name) ?? errorTypeOf(named?.$metadata?.httpStatusCode) ?? '_OTHER';
+}
+/**
+ * Erro da chamada sem a mensagem do serviço: num `ValidationException` ou erro do modelo ela pode
+ * repetir trechos do pedido. Fica o tipo (que também agrupa as issues).
+ */
+function sanitizedError(type) {
+    return { name: type, message: `aws.bedrock: ${type}` };
+}
+export function startBedrockCall(config, span, operation, input, startedPerf = performance.now()) {
+    if (!OPERATIONS.has(operation))
+        return null;
+    const request = obj(input);
+    const call = new GenAiCall(span, config, 'aws.bedrock', 'chat', startedPerf, modelName(request.modelId));
+    const stream = operation === 'ConverseStream';
+    if (stream)
+        call.setRequest(GEN_AI.requestStream, true);
+    const inference = obj(request.inferenceConfig);
+    const maxTokens = inference.maxTokens;
+    if (typeof maxTokens === 'number' && Number.isSafeInteger(maxTokens))
+        call.setRequest(GEN_AI.requestMaxTokens, maxTokens);
+    for (const [key, attribute] of [
+        ['temperature', GEN_AI.requestTemperature],
+        ['topP', GEN_AI.requestTopP],
+    ]) {
+        const value = inference[key];
+        if (typeof value === 'number' && Number.isFinite(value))
+            call.setRequest(attribute, value);
+    }
+    return {
+        output(result) {
+            const output = obj(result?.output);
+            try {
+                if (!stream) {
+                    call.setFinishReason(0, output.stopReason);
+                    call.usage = bedrockUsage(output.usage);
+                    call.finish('completed');
+                    return;
+                }
+                const events = output.stream;
+                if (!events || typeof events[Symbol.asyncIterator] !== 'function') {
+                    call.finish('unobserved');
+                    return;
+                }
+                call.armWatchdog();
+                output.stream = observeEvents(call, events);
+            }
+            catch {
+                call.finish('unobserved');
+            }
+        },
+        error(err) {
+            if (isAbortError(err)) {
+                call.finish('cancelled');
+                return;
+            }
+            call.errorType = bedrockErrorType(err);
+            call.finish('error', sanitizedError(call.errorType));
+        },
+    };
+}
+/** Eventos do `ConverseStream` passam intactos; `metadata` traz o uso, `messageStop` o motivo. */
+function observeEvents(call, events) {
+    let finalUsage = false;
+    let stopped = false;
+    const observe = (event) => {
+        if (call.done)
+            return;
+        try {
+            call.markActivity();
+            call.markFirstChunk();
+            const item = obj(event);
+            if (item.messageStop) {
+                stopped = true;
+                call.setFinishReason(0, obj(item.messageStop).stopReason);
+            }
+            if (item.metadata) {
+                call.usage = bedrockUsage(obj(item.metadata).usage);
+                finalUsage = call.usage.input !== undefined || call.usage.output !== undefined;
+            }
+        }
+        catch {
+            call.finish('unobserved');
+        }
+    };
+    const outcome = () => (finalUsage || stopped ? 'completed' : 'incomplete');
+    return {
+        [Symbol.asyncIterator]() {
+            const iterator = events[Symbol.asyncIterator]();
+            return {
+                async next(...args) {
+                    let result;
+                    try {
+                        result = await iterator.next(...args);
+                    }
+                    catch (err) {
+                        if (isAbortError(err))
+                            call.finish('cancelled');
+                        else {
+                            call.errorType = bedrockErrorType(err);
+                            call.finish('error', sanitizedError(call.errorType));
+                        }
+                        throw err;
+                    }
+                    if (result.done)
+                        call.finish(outcome());
+                    else
+                        observe(result.value);
+                    return result;
+                },
+                async return(value) {
+                    // `break` no `for await`: quem consumia desistiu; o SDK fecha a conexão.
+                    if (!call.done)
+                        call.finish(finalUsage ? 'completed' : 'cancelled');
+                    return iterator.return ? iterator.return(value) : { done: true, value };
+                },
+                async throw(err) {
+                    if (!call.done)
+                        call.finish('cancelled');
+                    if (iterator.throw)
+                        return iterator.throw(err);
+                    throw err;
+                },
+            };
+        },
+    };
+}
+//# sourceMappingURL=bedrock.js.map

package/dist/genai/bedrock.js.map

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

package/dist/genai/call.d.ts

@@ -0,0 +1,96 @@
+import type { ActiveSpan } from '../types.js';
+import type { GenAiPricing, ResolvedGenAi } from './config.js';
+import { type GenAiOperation, type GenAiOutcome } from './semconv.js';
+/**
+ * Uso informado pelo provedor, já na semântica do OpenTelemetry: `input` inclui os tokens de cache
+ * (lidos e gravados) e `output` inclui os de raciocínio. Campo ausente = o provedor não informou.
+ */
+export interface GenAiUsage {
+    input?: number;
+    output?: number;
+    cacheRead?: number;
+    cacheCreation?: number;
+    reasoning?: number;
+}
+/** Custo informado pelo próprio provedor (nunca estimado). */
+export interface ReportedCost {
+    amount: number;
+    currency: string;
+    source: string;
+}
+/** Inteiro ≥ 0 informado pelo provedor; qualquer outra coisa conta como "não informado". */
+export declare function tokenCount(value: unknown): number | undefined;
+/** Identificador de erro de baixa cardinalidade (`rate_limit_error`, `429`); texto livre fica de fora. */
+export declare function errorTypeOf(value: unknown): string | undefined;
+/** `gen_ai.request.model`/`response.model`: nome de modelo, sem aceitar texto arbitrário enorme. */
+export declare function modelName(value: unknown): string | 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 declare function estimateCost(pricing: GenAiPricing, provider: string, operation: string, models: (string | undefined)[], usage: GenAiUsage): number | undefined;
+/**
+ * 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 declare class GenAiCall {
+    readonly span: ActiveSpan;
+    private readonly config;
+    readonly provider: string;
+    readonly operation: GenAiOperation;
+    private readonly startedPerf;
+    readonly requestModel: string | undefined;
+    usage: GenAiUsage;
+    /** O stream terminou antes do uso final: o que há de uso é parcial (ex.: só a entrada). */
+    usagePartial: boolean;
+    /**
+     * 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: number;
+    /**
+     * 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: boolean;
+    reportedCost: ReportedCost | undefined;
+    responseId: string | undefined;
+    responseModel: string | undefined;
+    /** Motivo de parada por índice de escolha. */
+    readonly finishReasons: (string | undefined)[];
+    errorType: string | undefined;
+    private firstChunkPerf;
+    private finished;
+    private readonly cleanups;
+    private watchdog;
+    /** Última leitura do corpo (`performance.now()`): o prazo de observação conta a partir dela. */
+    private lastActivity;
+    constructor(span: ActiveSpan, config: ResolvedGenAi, provider: string, operation: GenAiOperation, startedPerf: number, requestModel: string | undefined);
+    get done(): boolean;
+    /** Atributo do pedido (só valores numéricos/booleanos/enumerados; nunca conteúdo). */
+    setRequest(key: string, value: unknown): void;
+    /** Primeiro evento do stream (`gen_ai.response.time_to_first_chunk`). */
+    markFirstChunk(): void;
+    setFinishReason(index: number, reason: unknown): void;
+    setResponseId(value: unknown): void;
+    setResponseModel(value: unknown): void;
+    /**
+     * 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(): void;
+    /** Houve leitura do corpo: adia o prazo sem custo de timer por pedaço. */
+    markActivity(): void;
+    private schedule;
+    onFinish(cleanup: () => void): void;
+    /**
+     * 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: GenAiOutcome, error?: unknown): void;
+    private applyAttributes;
+}
+/** Custo informado pelo provedor no corpo (`usage.cost` do OpenRouter, em créditos = USD). */
+export declare function reportedCost(provider: string, usage: Record<string, unknown>): ReportedCost | undefined;
+//# sourceMappingURL=call.d.ts.map

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

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

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