@nebulaos/llm-gateway 0.1.1 → 0.1.3

package/dist/index.d.mts

@@ -76,6 +76,11 @@ declare class LLMGateway implements IModel {
     private extractErrorSource;
     private extractExtraOptions;
     private buildGatewayHeaders;
+    /**
+     * Extracts enrichment data from backend HTTP headers.
+     * Backend returns this data so SDK can enrich its own span (avoiding duplicate spans).
+     */
+    private extractEnrichmentFromHeaders;
     protected convertMessages(messages: Message[]): OpenAIClient.Chat.ChatCompletionMessageParam[];
     private convertTools;
     private mapUsage;

package/dist/index.d.ts

@@ -76,6 +76,11 @@ declare class LLMGateway implements IModel {
     private extractErrorSource;
     private extractExtraOptions;
     private buildGatewayHeaders;
+    /**
+     * Extracts enrichment data from backend HTTP headers.
+     * Backend returns this data so SDK can enrich its own span (avoiding duplicate spans).
+     */
+    private extractEnrichmentFromHeaders;
     protected convertMessages(messages: Message[]): OpenAIClient.Chat.ChatCompletionMessageParam[];
     private convertTools;
     private mapUsage;

package/dist/index.js

@@ -37,6 +37,7 @@ module.exports = __toCommonJS(index_exports);
 var import_openai = __toESM(require("openai"));
 var import_node_crypto = require("crypto");
 var import_core = require("@nebulaos/core");
+var import_types = require("@nebulaos/types");
 var LLMGatewayError = class extends Error {
   constructor(message, code, status, cause) {
     super(message);
@@ -82,19 +83,22 @@ var LLMGateway = class {
       name: t.function.name,
       description: t.function.description?.slice(0, 200)
     }));
+    const { responseFormat, ...llmConfig } = mergedOptions ?? {};
+    const startData = {
+      provider: this.providerName,
+      model: this.modelName,
+      messagesCount: messages.length,
+      toolsCount: tools?.length ?? 0,
+      llmConfig: Object.keys(llmConfig).length > 0 ? llmConfig : void 0,
+      responseFormat,
+      messages: messagesPreview,
+      tools: toolsPreview
+    };
     return import_core.Tracing.withSpan(
       {
-        kind: "llm",
+        kind: import_types.SpanType.llm,
         name: `llm:${this.modelName}`,
-        data: {
-          provider: this.providerName,
-          model: this.modelName,
-          messagesCount: messages.length,
-          toolsCount: tools?.length ?? 0,
-          responseFormat: mergedOptions?.responseFormat,
-          messages: messagesPreview,
-          tools: toolsPreview
-        }
+        data: startData
       },
       async (llmSpan) => {
         const headers = this.buildGatewayHeaders();
@@ -106,7 +110,7 @@ var LLMGateway = class {
           toolCount: tools?.length ?? 0
         });
         try {
-          const response = await this.client.chat.completions.create(
+          const { data: response, response: httpResponse } = await this.client.chat.completions.create(
             {
               model,
               messages: this.convertMessages(messages),
@@ -118,7 +122,7 @@ var LLMGateway = class {
               ...this.extractExtraOptions(mergedOptions)
             },
             { headers }
-          );
+          ).withResponse();
           this.logger.debug("LLM Gateway response", {
             model,
             finishReason: response.choices?.[0]?.finish_reason,
@@ -128,14 +132,19 @@ var LLMGateway = class {
           const message = choice.message;
           const usage = this.mapUsage(response.usage);
           const finishReason = this.mapFinishReason(choice.finish_reason);
+          const enrichment = this.extractEnrichmentFromHeaders(httpResponse.headers);
+          const endData = {
+            usage: enrichment.usage ?? usage ?? { promptTokens: 0, completionTokens: 0, totalTokens: 0 },
+            finishReason: finishReason ?? "stop",
+            toolCallsCount: message.tool_calls?.length ?? 0,
+            choices: response.choices,
+            model: enrichment.modelActual,
+            fallbackUsed: enrichment.fallbackUsed,
+            cost: enrichment.cost ? parseFloat(enrichment.cost.amountUsd) : void 0
+          };
           await llmSpan.end({
             status: "success",
-            data: {
-              usage,
-              finishReason,
-              toolCallsCount: message.tool_calls?.length ?? 0,
-              outputPreview: message.content?.slice(0, 200)
-            }
+            data: endData
           });
           return {
             content: message.content || "",
@@ -148,20 +157,21 @@ var LLMGateway = class {
               }
             })),
             finishReason,
-            usage
+            usage: enrichment.usage ?? usage
           };
         } catch (error) {
           this.logger.error("LLM Gateway request failed", error, void 0, void 0);
           const gatewayError = this.handleError(error);
+          const errorEndData = {
+            error: {
+              message: gatewayError.message,
+              code: gatewayError.code,
+              status: gatewayError.status
+            }
+          };
           await llmSpan.end({
             status: "error",
-            data: {
-              error: {
-                message: gatewayError.message,
-                code: gatewayError.code,
-                status: gatewayError.status
-              }
-            }
+            data: errorEndData
           });
           throw gatewayError;
         }
@@ -179,18 +189,21 @@ var LLMGateway = class {
       name: t.function.name,
       description: t.function.description?.slice(0, 200)
     }));
+    const { responseFormat, ...llmConfig } = mergedOptions ?? {};
+    const startData = {
+      provider: this.providerName,
+      model: this.modelName,
+      messagesCount: messages.length,
+      toolsCount: tools?.length ?? 0,
+      llmConfig: Object.keys(llmConfig).length > 0 ? llmConfig : void 0,
+      responseFormat,
+      messages: messagesPreview,
+      tools: toolsPreview
+    };
     const llmSpan = await import_core.Tracing.startSpan({
-      kind: "llm",
+      kind: import_types.SpanType.llm,
       name: `llm:${this.modelName}`,
-      data: {
-        provider: this.providerName,
-        model: this.modelName,
-        messagesCount: messages.length,
-        toolsCount: tools?.length ?? 0,
-        responseFormat: mergedOptions?.responseFormat,
-        messages: messagesPreview,
-        tools: toolsPreview
-      }
+      data: startData
     });
     const headers = this.buildGatewayHeaders();
     this.logger.debug("LLM Gateway stream request", {
@@ -221,15 +234,16 @@ var LLMGateway = class {
       this.logger.error("LLM Gateway stream request failed", error, void 0, void 0);
       const gatewayError = this.handleError(error);
       if (llmSpan) {
+        const errorEndData = {
+          error: {
+            message: gatewayError.message,
+            code: gatewayError.code,
+            status: gatewayError.status
+          }
+        };
         await llmSpan.end({
           status: "error",
-          data: {
-            error: {
-              message: gatewayError.message,
-              code: gatewayError.code,
-              status: gatewayError.status
-            }
-          }
+          data: errorEndData
         });
       }
       throw gatewayError;
@@ -238,6 +252,8 @@ var LLMGateway = class {
     let finalFinishReason;
     let toolCallsCount = 0;
     let outputPreview = "";
+    let finalContent = "";
+    const toolCallsAccumulator = /* @__PURE__ */ new Map();
     try {
       for await (const chunk of stream) {
         if (chunk.usage) {
@@ -260,6 +276,7 @@ var LLMGateway = class {
         const delta = choice.delta;
         if (!delta) continue;
         if (delta.content) {
+          finalContent += delta.content;
           if (outputPreview.length < 200) {
             outputPreview += delta.content.slice(0, 200 - outputPreview.length);
           }
@@ -267,49 +284,72 @@ var LLMGateway = class {
         }
         if (delta.tool_calls) {
           for (const tc of delta.tool_calls) {
+            const idx = tc.index;
             if (tc.id && tc.function?.name) {
               toolCallsCount++;
+              toolCallsAccumulator.set(idx, { id: tc.id, name: tc.function.name, arguments: "" });
               yield {
                 type: "tool_call_start",
-                index: tc.index,
+                index: idx,
                 id: tc.id,
                 name: tc.function.name
               };
             }
             if (tc.function?.arguments) {
+              const existing = toolCallsAccumulator.get(idx);
+              if (existing) {
+                existing.arguments += tc.function.arguments;
+              }
               yield {
                 type: "tool_call_delta",
-                index: tc.index,
+                index: idx,
                 args: tc.function.arguments
               };
             }
           }
         }
       }
+      const toolCalls = Array.from(toolCallsAccumulator.values()).map((tc) => ({
+        id: tc.id,
+        type: "function",
+        function: { name: tc.name, arguments: tc.arguments }
+      }));
+      const choices = [{
+        index: 0,
+        message: {
+          role: "assistant",
+          content: finalContent || null,
+          tool_calls: toolCalls.length > 0 ? toolCalls : void 0
+        },
+        finish_reason: finalFinishReason
+      }];
       if (llmSpan) {
+        const endData = {
+          usage: finalUsage ?? { promptTokens: 0, completionTokens: 0, totalTokens: 0 },
+          finishReason: finalFinishReason ?? "stop",
+          toolCallsCount,
+          outputPreview,
+          choices
+        };
         await llmSpan.end({
           status: "success",
-          data: {
-            usage: finalUsage,
-            finishReason: finalFinishReason,
-            toolCallsCount,
-            outputPreview
-          }
+          data: endData
         });
       }
     } catch (error) {
       this.logger.error("LLM Gateway stream failed", error, void 0, void 0);
       const gatewayError = this.handleError(error);
       if (llmSpan) {
+        const errorEndData = {
+          error: {
+            message: gatewayError.message,
+            code: gatewayError.code,
+            status: gatewayError.status
+          }
+        };
         await llmSpan.end({
           status: "error",
-          data: {
-            error: {
-              message: gatewayError.message,
-              code: gatewayError.code,
-              status: gatewayError.status
-            }
-          }
+          data: errorEndData
         });
       }
       throw gatewayError;
@@ -506,6 +546,46 @@ var LLMGateway = class {
     }
     return headers;
   }
+  /**
+   * Extracts enrichment data from backend HTTP headers.
+   * Backend returns this data so SDK can enrich its own span (avoiding duplicate spans).
+   */
+  extractEnrichmentFromHeaders(headers) {
+    const result = {};
+    const modelActual = headers.get("x-llm-model-actual");
+    if (modelActual) {
+      result.modelActual = modelActual;
+    }
+    const fallbackUsed = headers.get("x-llm-fallback-used");
+    if (fallbackUsed) {
+      result.fallbackUsed = fallbackUsed === "true";
+    }
+    const usageRaw = headers.get("x-llm-usage");
+    if (usageRaw) {
+      try {
+        const usage = JSON.parse(usageRaw);
+        result.usage = {
+          promptTokens: usage.prompt_tokens,
+          completionTokens: usage.completion_tokens,
+          totalTokens: usage.total_tokens,
+          reasoningTokens: usage.completion_tokens_details?.reasoning_tokens,
+          // Preserve any additional token fields from provider
+          ...usage
+        };
+      } catch {
+        this.logger.warn("Failed to parse x-llm-usage header", { usageRaw });
+      }
+    }
+    const cost = headers.get("x-llm-cost");
+    const costAvailable = headers.get("x-llm-cost-available");
+    if (cost) {
+      result.cost = {
+        amountUsd: cost,
+        available: costAvailable === "true"
+      };
+    }
+    return result;
+  }
   convertMessages(messages) {
     const allowedToolCallIds = /* @__PURE__ */ new Set();
     return messages.flatMap((m) => {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import OpenAIClient, { APIError, ClientOptions } from \"openai\";\nimport { randomBytes, randomUUID } from \"node:crypto\";\nimport {\n  IModel,\n  Message,\n  ProviderResponse,\n  StreamChunk,\n  ToolDefinitionForLLM,\n  GenerateOptions,\n  TokenUsage,\n  ContentPart,\n  ConsoleLogger,\n  type LogLevel,\n  ExecutionContext,\n  Tracing,\n} from \"@nebulaos/core\";\n\n/**\n * Custom error class for LLM Gateway errors.\n * Provides clear, actionable error messages for developers.\n */\nexport class LLMGatewayError extends Error {\n  constructor(\n    message: string,\n    public readonly code: string,\n    public readonly status?: number,\n    public readonly cause?: unknown,\n  ) {\n    super(message);\n    this.name = \"LLMGatewayError\";\n  }\n}\n\n/**\n * LLM Gateway Provider Configuration\n */\nexport interface LLMGatewayConfig {\n  /** API Key from NebulaOS */\n  apiKey: string;\n  /** Base URL of the NebulaOS LLM Gateway */\n  baseUrl?: string;\n  /** Route alias (e.g., \"assistente\", \"code-review\") */\n  model: string;\n  /** Logger verbosity for gateway calls */\n  logLevel?: LogLevel;\n  /** Optional OpenAI client options */\n  clientOptions?: ClientOptions;\n  /**\n   * Default model options passed to every generate() call.\n   * Supports provider-specific params like reasoning_effort, temperature, topK, etc.\n   * These can be overridden by options passed directly to generate().\n   */\n  options?: Omit<GenerateOptions, \"responseFormat\">;\n}\n\n/**\n * NebulaOS LLM Gateway Provider\n *\n * Provides access to NebulaOS LLM Gateway routes through an OpenAI-compatible interface.\n * Routes are pre-configured in NebulaOS and provide automatic fallback, cost tracking,\n * and access control.\n */\nexport class LLMGateway implements IModel {\n  providerName = \"llm-gateway\";\n  modelName: string;\n  private client: OpenAIClient;\n  private baseUrl: string;\n  private logger: ConsoleLogger;\n  private options?: Omit<GenerateOptions, \"responseFormat\">;\n\n  capabilities = {\n    inputFiles: {\n      mimeTypes: [\"image/*\"],\n      sources: [\"url\", \"base64\"] as const,\n    },\n  } as const;\n\n  constructor(config: LLMGatewayConfig) {\n    this.modelName = config.model;\n\n    this.baseUrl = config.baseUrl || \"http://localhost:4100\";\n    const baseURL = this.baseUrl.endsWith(\"/v1\") ? this.baseUrl : `${this.baseUrl}/v1`;\n    this.logger = new ConsoleLogger(config.logLevel || \"info\", \"nebulaos/llm-gateway\");\n\n    this.client = new OpenAIClient({\n      apiKey: config.apiKey,\n      baseURL,\n      ...config.clientOptions,\n    });\n    this.options = config.options;\n  }\n\n  async generate(\n    messages: Message[],\n    tools?: ToolDefinitionForLLM[],\n    options?: GenerateOptions,\n  ): Promise<ProviderResponse> {\n    const mergedOptions = { ...this.options, ...options };\n    const model = `route:${this.modelName}`;\n\n    // Prepare context data for tracing (useful for debugging, especially on errors)\n    const messagesPreview = messages.map((m) => ({\n      role: m.role,\n      content: typeof m.content === \"string\"\n        ? m.content.length > 500 ? m.content.slice(0, 500) + \"...\" : m.content\n        : Array.isArray(m.content) ? `[${m.content.length} parts]` : String(m.content),\n    }));\n    const toolsPreview = tools?.map((t) => ({\n      name: t.function.name,\n      description: t.function.description?.slice(0, 200),\n    }));\n\n    return Tracing.withSpan(\n      {\n        kind: \"llm\",\n        name: `llm:${this.modelName}`,\n        data: {\n          provider: this.providerName,\n          model: this.modelName,\n          messagesCount: messages.length,\n          toolsCount: tools?.length ?? 0,\n          responseFormat: mergedOptions?.responseFormat,\n          messages: messagesPreview,\n          tools: toolsPreview,\n        },\n      },\n      async (llmSpan) => {\n        const headers = this.buildGatewayHeaders();\n        this.logger.debug(\"LLM Gateway request\", {\n          model,\n          baseUrl: this.baseUrl,\n          stream: false,\n          messageCount: messages.length,\n          toolCount: tools?.length ?? 0,\n        });\n\n        try {\n          const response = await this.client.chat.completions.create(\n            {\n              model,\n              messages: this.convertMessages(messages),\n              tools: this.convertTools(tools),\n              response_format:\n                mergedOptions?.responseFormat?.type === \"json\"\n                  ? mergedOptions.responseFormat.schema\n                    ? {\n                        type: \"json_schema\",\n                        json_schema: { name: \"response\", schema: mergedOptions.responseFormat.schema as any },\n                      }\n                    : { type: \"json_object\" }\n                  : undefined,\n              ...this.extractExtraOptions(mergedOptions),\n            },\n            { headers },\n          );\n\n          this.logger.debug(\"LLM Gateway response\", {\n            model,\n            finishReason: response.choices?.[0]?.finish_reason,\n            hasUsage: Boolean(response.usage),\n          });\n\n          const choice = response.choices[0];\n          const message = choice.message;\n          const usage = this.mapUsage(response.usage);\n          const finishReason = this.mapFinishReason(choice.finish_reason);\n\n          await llmSpan.end({\n            status: \"success\",\n            data: {\n              usage,\n              finishReason,\n              toolCallsCount: message.tool_calls?.length ?? 0,\n              outputPreview: message.content?.slice(0, 200),\n            },\n          });\n\n          return {\n            content: message.content || \"\",\n            toolCalls: message.tool_calls?.map((tc) => ({\n              id: tc.id,\n              type: \"function\",\n              function: {\n                name: tc.function.name,\n                arguments: tc.function.arguments,\n              },\n            })),\n            finishReason,\n            usage,\n          };\n        } catch (error) {\n          this.logger.error(\"LLM Gateway request failed\", error, undefined, undefined);\n          const gatewayError = this.handleError(error);\n\n          await llmSpan.end({\n            status: \"error\",\n            data: {\n              error: {\n                message: gatewayError.message,\n                code: gatewayError.code,\n                status: gatewayError.status,\n              },\n            },\n          });\n\n          throw gatewayError;\n        }\n      },\n    );\n  }\n\n  async *generateStream(\n    messages: Message[],\n    tools?: ToolDefinitionForLLM[],\n    options?: GenerateOptions,\n  ): AsyncGenerator<StreamChunk> {\n    const mergedOptions = { ...this.options, ...options };\n    const model = `route:${this.modelName}`;\n\n    // Prepare context data for tracing (useful for debugging, especially on errors)\n    const messagesPreview = messages.map((m) => ({\n      role: m.role,\n      content: typeof m.content === \"string\"\n        ? m.content.length > 500 ? m.content.slice(0, 500) + \"...\" : m.content\n        : Array.isArray(m.content) ? `[${m.content.length} parts]` : String(m.content),\n    }));\n    const toolsPreview = tools?.map((t) => ({\n      name: t.function.name,\n      description: t.function.description?.slice(0, 200),\n    }));\n\n    // Start span manually for streaming (async generators can't use withSpan directly)\n    const llmSpan = await Tracing.startSpan({\n      kind: \"llm\",\n      name: `llm:${this.modelName}`,\n      data: {\n        provider: this.providerName,\n        model: this.modelName,\n        messagesCount: messages.length,\n        toolsCount: tools?.length ?? 0,\n        responseFormat: mergedOptions?.responseFormat,\n        messages: messagesPreview,\n        tools: toolsPreview,\n      },\n    });\n\n    const headers = this.buildGatewayHeaders();\n    this.logger.debug(\"LLM Gateway stream request\", {\n      model,\n      baseUrl: this.baseUrl,\n      stream: true,\n      messageCount: messages.length,\n      toolCount: tools?.length ?? 0,\n    });\n\n    let stream;\n    try {\n      stream = await this.client.chat.completions.create(\n        {\n          model,\n          messages: this.convertMessages(messages),\n          tools: this.convertTools(tools),\n          stream: true,\n          stream_options: { include_usage: true },\n          response_format:\n            mergedOptions?.responseFormat?.type === \"json\"\n              ? mergedOptions.responseFormat.schema\n                ? {\n                    type: \"json_schema\",\n                    json_schema: { name: \"response\", schema: mergedOptions.responseFormat.schema as any },\n                  }\n                : { type: \"json_object\" }\n              : undefined,\n          ...this.extractExtraOptions(mergedOptions),\n        },\n        { headers },\n      );\n    } catch (error) {\n      this.logger.error(\"LLM Gateway stream request failed\", error, undefined, undefined);\n      const gatewayError = this.handleError(error);\n\n      if (llmSpan) {\n        await llmSpan.end({\n          status: \"error\",\n          data: {\n            error: {\n              message: gatewayError.message,\n              code: gatewayError.code,\n              status: gatewayError.status,\n            },\n          },\n        });\n      }\n\n      throw gatewayError;\n    }\n\n    let finalUsage: TokenUsage | undefined;\n    let finalFinishReason: ProviderResponse[\"finishReason\"];\n    let toolCallsCount = 0;\n    let outputPreview = \"\";\n\n    try {\n      for await (const chunk of stream) {\n        if (chunk.usage) {\n          finalUsage = this.mapUsage(chunk.usage);\n          yield {\n            type: \"finish\",\n            reason: \"stop\",\n            usage: finalUsage,\n          };\n        }\n\n        const choice = chunk.choices?.[0];\n        if (!choice) continue;\n\n        if (choice.finish_reason) {\n          finalFinishReason = this.mapFinishReason(choice.finish_reason);\n          yield {\n            type: \"finish\",\n            reason: finalFinishReason,\n          };\n        }\n\n        const delta = choice.delta;\n        if (!delta) continue;\n\n        if (delta.content) {\n          if (outputPreview.length < 200) {\n            outputPreview += delta.content.slice(0, 200 - outputPreview.length);\n          }\n          yield { type: \"content_delta\", delta: delta.content };\n        }\n\n        if (delta.tool_calls) {\n          for (const tc of delta.tool_calls) {\n            if (tc.id && tc.function?.name) {\n              toolCallsCount++;\n              yield {\n                type: \"tool_call_start\",\n                index: tc.index,\n                id: tc.id,\n                name: tc.function.name,\n              };\n            }\n\n            if (tc.function?.arguments) {\n              yield {\n                type: \"tool_call_delta\",\n                index: tc.index,\n                args: tc.function.arguments,\n              };\n            }\n          }\n        }\n      }\n\n      // End span with success\n      if (llmSpan) {\n        await llmSpan.end({\n          status: \"success\",\n          data: {\n            usage: finalUsage,\n            finishReason: finalFinishReason,\n            toolCallsCount,\n            outputPreview,\n          },\n        });\n      }\n    } catch (error) {\n      this.logger.error(\"LLM Gateway stream failed\", error, undefined, undefined);\n      const gatewayError = this.handleError(error);\n\n      if (llmSpan) {\n        await llmSpan.end({\n          status: \"error\",\n          data: {\n            error: {\n              message: gatewayError.message,\n              code: gatewayError.code,\n              status: gatewayError.status,\n            },\n          },\n        });\n      }\n\n      throw gatewayError;\n    }\n  }\n\n  // ==========================================================================\n  // Error Handling\n  // ==========================================================================\n\n  /**\n   * Transforms raw errors into actionable LLMGatewayError with clear messages.\n   * This ensures developers get specific guidance on how to resolve issues.\n   *\n   * Differentiates between:\n   * - Gateway errors: LLM Gateway API key issues (check NEBULAOS_API_KEY env var)\n   * - Provider errors: LLM provider API key issues (check route config in dashboard)\n   */\n  private handleError(error: unknown): LLMGatewayError {\n    // Handle OpenAI SDK APIError (includes status, message, code)\n    if (error instanceof APIError) {\n      const status = error.status;\n      const originalMessage = error.message;\n\n      // Check X-Error-Source header to differentiate gateway vs provider errors\n      const errorSource = this.extractErrorSource(error);\n\n      // Authentication errors (401)\n      if (status === 401) {\n        if (errorSource === \"gateway\") {\n          return new LLMGatewayError(\n            `LLM Gateway authentication failed: Your LLM Gateway API key is invalid or expired. ` +\n              `Please verify your NEBULAOS_API_KEY environment variable or check your LLM Gateway API key in the NebulaOS dashboard. ` +\n              `Original error: ${originalMessage}`,\n            \"GATEWAY_AUTH_ERROR\",\n            status,\n            error,\n          );\n        } else {\n          // Provider error (default for 401 without explicit gateway source)\n          return new LLMGatewayError(\n            `LLM Provider authentication failed: The API key configured for your LLM provider (OpenAI, Azure, etc.) is invalid or expired. ` +\n              `Please verify the provider API key in your route configuration in the NebulaOS dashboard. ` +\n              `Original error: ${originalMessage}`,\n            \"PROVIDER_AUTH_ERROR\",\n            status,\n            error,\n          );\n        }\n      }\n\n      // Permission denied (403)\n      if (status === 403) {\n        if (errorSource === \"gateway\") {\n          return new LLMGatewayError(\n            `LLM Gateway access denied: Your LLM Gateway API key does not have permission to access this route. ` +\n              `Please verify the route is allowed for your LLM Gateway API key in the NebulaOS dashboard. ` +\n              `Original error: ${originalMessage}`,\n            \"GATEWAY_FORBIDDEN\",\n            status,\n            error,\n          );\n        } else {\n          return new LLMGatewayError(\n            `LLM Provider access denied: The provider API key does not have permission for this operation. ` +\n              `Please verify the provider API key permissions in the NebulaOS dashboard. ` +\n              `Original error: ${originalMessage}`,\n            \"PROVIDER_FORBIDDEN\",\n            status,\n            error,\n          );\n        }\n      }\n\n      // Rate limit (429)\n      if (status === 429) {\n        return new LLMGatewayError(\n          `LLM Gateway rate limit exceeded: Too many requests to the LLM provider. ` +\n            `Please wait before retrying or check your rate limit configuration. ` +\n            `Original error: ${originalMessage}`,\n          \"LLM_GATEWAY_RATE_LIMIT\",\n          status,\n          error,\n        );\n      }\n\n      // Bad request (400)\n      if (status === 400) {\n        return new LLMGatewayError(\n          `LLM Gateway request error: Invalid request parameters. ` +\n            `Please check your request configuration (model, messages, tools). ` +\n            `Original error: ${originalMessage}`,\n          \"LLM_GATEWAY_BAD_REQUEST\",\n          status,\n          error,\n        );\n      }\n\n      // Not found (404)\n      if (status === 404) {\n        return new LLMGatewayError(\n          `LLM Gateway route not found: The specified model or route does not exist. ` +\n            `Please verify the route alias '${this.modelName}' is correct and provisioned. ` +\n            `Original error: ${originalMessage}`,\n          \"LLM_GATEWAY_NOT_FOUND\",\n          status,\n          error,\n        );\n      }\n\n      // Timeout (408, 504)\n      if (status === 408 || status === 504) {\n        return new LLMGatewayError(\n          `LLM Gateway timeout: The request took too long to complete. ` +\n            `This may be due to high load or a complex request. Please try again. ` +\n            `Original error: ${originalMessage}`,\n          \"LLM_GATEWAY_TIMEOUT\",\n          status,\n          error,\n        );\n      }\n\n      // Server errors (5xx)\n      if (status && status >= 500) {\n        return new LLMGatewayError(\n          `LLM Gateway server error: The LLM provider returned an error (${status}). ` +\n            `This is typically a temporary issue. Please try again later. ` +\n            `Original error: ${originalMessage}`,\n          \"LLM_GATEWAY_SERVER_ERROR\",\n          status,\n          error,\n        );\n      }\n\n      // Other API errors\n      return new LLMGatewayError(\n        `LLM Gateway error (${status}): ${originalMessage}`,\n        \"LLM_GATEWAY_ERROR\",\n        status,\n        error,\n      );\n    }\n\n    // Handle standard Error objects\n    if (error instanceof Error) {\n      const msg = error.message.toLowerCase();\n\n      // Connection errors\n      if (msg.includes(\"econnrefused\") || msg.includes(\"enotfound\") || msg.includes(\"network\")) {\n        return new LLMGatewayError(\n          `LLM Gateway connection failed: Unable to connect to the LLM Gateway at ${this.baseUrl}. ` +\n            `Please verify the gateway is running and accessible. ` +\n            `Original error: ${error.message}`,\n          \"LLM_GATEWAY_CONNECTION_ERROR\",\n          undefined,\n          error,\n        );\n      }\n\n      // Timeout errors\n      if (msg.includes(\"timeout\") || msg.includes(\"timed out\") || msg.includes(\"etimedout\")) {\n        return new LLMGatewayError(\n          `LLM Gateway timeout: The connection timed out. ` +\n            `Please check network connectivity and try again. ` +\n            `Original error: ${error.message}`,\n          \"LLM_GATEWAY_TIMEOUT\",\n          undefined,\n          error,\n        );\n      }\n\n      // Generic Error - preserve original message with context\n      return new LLMGatewayError(\n        `LLM Gateway error: ${error.message}`,\n        \"LLM_GATEWAY_ERROR\",\n        undefined,\n        error,\n      );\n    }\n\n    // Unknown error type\n    return new LLMGatewayError(\n      `LLM Gateway error: An unexpected error occurred. Details: ${String(error)}`,\n      \"LLM_GATEWAY_UNKNOWN_ERROR\",\n      undefined,\n      error,\n    );\n  }\n\n  /**\n   * Extracts the error source from an APIError.\n   * The backend sets X-Error-Source header or includes source in the error body\n   * to differentiate between gateway errors (LLM Gateway API key) and provider errors.\n   *\n   * @returns \"gateway\" if the error is from LLM Gateway authentication,\n   *          \"provider\" if the error is from the upstream LLM provider,\n   *          undefined if the source cannot be determined.\n   */\n  private extractErrorSource(error: APIError): \"gateway\" | \"provider\" | undefined {\n    // Try to get source from response headers\n    const headers = error.headers;\n    if (headers) {\n      const errorSource = headers[\"x-error-source\"] || headers[\"X-Error-Source\"];\n      if (errorSource === \"gateway\" || errorSource === \"provider\") {\n        return errorSource;\n      }\n    }\n\n    // Try to get source from error body\n    // The backend may include { error: { source: \"gateway\" | \"provider\", ... } }\n    const errorBody = error.error as Record<string, unknown> | undefined;\n    if (errorBody && typeof errorBody === \"object\") {\n      // Check for nested error object (OpenAI style)\n      const nestedError = errorBody.error as Record<string, unknown> | undefined;\n      if (nestedError && typeof nestedError === \"object\" && nestedError.source) {\n        const source = nestedError.source;\n        if (source === \"gateway\" || source === \"provider\") {\n          return source;\n        }\n      }\n      // Check for direct source field\n      if (errorBody.source === \"gateway\" || errorBody.source === \"provider\") {\n        return errorBody.source;\n      }\n    }\n\n    // Check error message for gateway-specific patterns\n    const msg = error.message.toLowerCase();\n    if (msg.includes(\"llm gateway api key\") || msg.includes(\"llm gateway\")) {\n      return \"gateway\";\n    }\n\n    return undefined;\n  }\n\n  // ==========================================================================\n  // Helpers (copied from OpenAI provider)\n  // ==========================================================================\n\n  private extractExtraOptions(options?: GenerateOptions): Record<string, any> {\n    if (!options) return {};\n    const { responseFormat, ...rest } = options;\n    return rest;\n  }\n\n  private buildGatewayHeaders(): Record<string, string> {\n    const headers: Record<string, string> = {\n      \"x-request-id\": randomUUID(),\n    };\n\n    const exec = ExecutionContext.getOrUndefined();\n    if (exec?.executionId) {\n      headers[\"x-execution-id\"] = exec.executionId;\n    }\n\n    const ctx = Tracing.getContext();\n    if (ctx) {\n      // IDs já estão em formato W3C (hex)\n      headers.traceparent = `00-${ctx.traceId}-${ctx.spanId}-01`;\n    } else {\n      // Still emit a root trace context so the gateway can correlate requests by traceId.\n      const traceId = randomBytes(16).toString(\"hex\");\n      const spanId = randomBytes(8).toString(\"hex\");\n      headers.traceparent = `00-${traceId}-${spanId}-01`;\n    }\n\n    return headers;\n  }\n\n  protected convertMessages(messages: Message[]): OpenAIClient.Chat.ChatCompletionMessageParam[] {\n    // Ensure tools have a preceding assistant message with tool_calls\n    const allowedToolCallIds = new Set<string>();\n\n    return messages.flatMap((m) => {\n      if (m.role === \"tool\") {\n        // Skip orphan tool messages (no preceding tool_calls)\n        if (!m.tool_call_id || !allowedToolCallIds.has(m.tool_call_id)) {\n          return [];\n        }\n\n        return {\n          role: \"tool\",\n          tool_call_id: m.tool_call_id!,\n          content: typeof m.content === \"string\" ? m.content : JSON.stringify(m.content), // Tool output usually string\n        };\n      }\n\n      if (m.role === \"assistant\") {\n        // OpenAI rules:\n        // - content is required (string | null)\n        // - if tool_calls is present, content can be null\n        // - if tool_calls is NOT present, content must be string (cannot be null/empty if strict, but usually empty string is fine)\n\n        let assistantContent: string | null = null;\n\n        if (typeof m.content === \"string\") {\n          assistantContent = m.content;\n        }\n\n        // If content is null/empty AND no tool_calls, force empty string to avoid API error\n        if (!assistantContent && (!m.tool_calls || m.tool_calls.length === 0)) {\n          assistantContent = \"\";\n        }\n\n        if (m.tool_calls) {\n          m.tool_calls.forEach((tc) => allowedToolCallIds.add(tc.id));\n        }\n\n        return {\n          role: \"assistant\",\n          content: assistantContent,\n          tool_calls: m.tool_calls?.map((tc) => ({\n            id: tc.id,\n            type: \"function\",\n            function: {\n              name: tc.function.name,\n              arguments: tc.function.arguments,\n            },\n          })),\n        };\n      }\n\n      // User / System with potential multimodal content\n      const content: OpenAIClient.Chat.ChatCompletionContentPart[] | string = Array.isArray(\n        m.content,\n      )\n        ? m.content.map((part) => this.convertContentPart(part))\n        : m.content || \"\";\n\n      return {\n        role: m.role as \"system\" | \"user\",\n        content,\n        name: m.name,\n      } as any;\n    });\n  }\n\n  private convertTools(\n    tools?: ToolDefinitionForLLM[],\n  ): OpenAIClient.Chat.ChatCompletionTool[] | undefined {\n    if (!tools || tools.length === 0) return undefined;\n    return tools.map((t) => ({\n      type: \"function\",\n      function: {\n        name: t.function.name,\n        description: t.function.description,\n        parameters: t.function.parameters,\n      },\n    }));\n  }\n\n  private mapUsage(usage?: OpenAIClient.CompletionUsage): TokenUsage | undefined {\n    if (!usage) return undefined;\n    return {\n      promptTokens: usage.prompt_tokens,\n      completionTokens: usage.completion_tokens,\n      totalTokens: usage.total_tokens,\n      reasoningTokens: (usage as any).completion_tokens_details?.reasoning_tokens,\n    };\n  }\n\n  private mapFinishReason(reason: string | null): ProviderResponse[\"finishReason\"] {\n    switch (reason) {\n      case \"stop\":\n        return \"stop\";\n      case \"length\":\n        return \"length\";\n      case \"tool_calls\":\n        return \"tool_calls\";\n      case \"content_filter\":\n        return \"content_filter\";\n      default:\n        return undefined;\n    }\n  }\n\n  private convertContentPart(part: ContentPart): OpenAIClient.Chat.ChatCompletionContentPart {\n    if (part.type === \"text\") return { type: \"text\", text: part.text };\n\n    if (part.type === \"file\") {\n      const { mimeType, source } = part.file;\n      if (!mimeType.startsWith(\"image/\")) {\n        throw new Error(`LLM Gateway: file mimeType '${mimeType}' is not supported yet`);\n      }\n\n      const url = source.type === \"url\" ? source.url : `data:${mimeType};base64,${source.base64}`;\n\n      return { type: \"image_url\", image_url: { url } };\n    }\n\n    if (part.type === \"image_url\") {\n      return { type: \"image_url\", image_url: { url: part.image_url.url } };\n    }\n\n    // Exhaustive check - should never reach here with proper ContentPart\n    const _exhaustive: never = part;\n    throw new Error(`Unsupported content type: ${(_exhaustive as any).type}`);\n  }\n}\n"],"mappings":"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","names":["OpenAIClient"]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import OpenAIClient, { APIError, ClientOptions } from \"openai\";\nimport { randomBytes, randomUUID } from \"node:crypto\";\nimport {\n  IModel,\n  Message,\n  ProviderResponse,\n  StreamChunk,\n  ToolDefinitionForLLM,\n  GenerateOptions,\n  TokenUsage,\n  ContentPart,\n  ConsoleLogger,\n  type LogLevel,\n  ExecutionContext,\n  Tracing,\n} from \"@nebulaos/core\";\nimport { SpanType, type LLMSpanStartData, type LLMSpanEndData } from \"@nebulaos/types\";\n\n/**\n * Custom error class for LLM Gateway errors.\n * Provides clear, actionable error messages for developers.\n */\nexport class LLMGatewayError extends Error {\n  constructor(\n    message: string,\n    public readonly code: string,\n    public readonly status?: number,\n    public readonly cause?: unknown,\n  ) {\n    super(message);\n    this.name = \"LLMGatewayError\";\n  }\n}\n\n/**\n * LLM Gateway Provider Configuration\n */\nexport interface LLMGatewayConfig {\n  /** API Key from NebulaOS */\n  apiKey: string;\n  /** Base URL of the NebulaOS LLM Gateway */\n  baseUrl?: string;\n  /** Route alias (e.g., \"assistente\", \"code-review\") */\n  model: string;\n  /** Logger verbosity for gateway calls */\n  logLevel?: LogLevel;\n  /** Optional OpenAI client options */\n  clientOptions?: ClientOptions;\n  /**\n   * Default model options passed to every generate() call.\n   * Supports provider-specific params like reasoning_effort, temperature, topK, etc.\n   * These can be overridden by options passed directly to generate().\n   */\n  options?: Omit<GenerateOptions, \"responseFormat\">;\n}\n\n/**\n * NebulaOS LLM Gateway Provider\n *\n * Provides access to NebulaOS LLM Gateway routes through an OpenAI-compatible interface.\n * Routes are pre-configured in NebulaOS and provide automatic fallback, cost tracking,\n * and access control.\n */\nexport class LLMGateway implements IModel {\n  providerName = \"llm-gateway\";\n  modelName: string;\n  private client: OpenAIClient;\n  private baseUrl: string;\n  private logger: ConsoleLogger;\n  private options?: Omit<GenerateOptions, \"responseFormat\">;\n\n  capabilities = {\n    inputFiles: {\n      mimeTypes: [\"image/*\"],\n      sources: [\"url\", \"base64\"] as const,\n    },\n  } as const;\n\n  constructor(config: LLMGatewayConfig) {\n    this.modelName = config.model;\n\n    this.baseUrl = config.baseUrl || \"http://localhost:4100\";\n    const baseURL = this.baseUrl.endsWith(\"/v1\") ? this.baseUrl : `${this.baseUrl}/v1`;\n    this.logger = new ConsoleLogger(config.logLevel || \"info\", \"nebulaos/llm-gateway\");\n\n    this.client = new OpenAIClient({\n      apiKey: config.apiKey,\n      baseURL,\n      ...config.clientOptions,\n    });\n    this.options = config.options;\n  }\n\n  async generate(\n    messages: Message[],\n    tools?: ToolDefinitionForLLM[],\n    options?: GenerateOptions,\n  ): Promise<ProviderResponse> {\n    const mergedOptions = { ...this.options, ...options };\n    const model = `route:${this.modelName}`;\n\n    // Prepare context data for tracing (useful for debugging, especially on errors)\n    const messagesPreview = messages.map((m) => ({\n      role: m.role,\n      content: typeof m.content === \"string\"\n        ? m.content.length > 500 ? m.content.slice(0, 500) + \"...\" : m.content\n        : Array.isArray(m.content) ? `[${m.content.length} parts]` : String(m.content),\n    }));\n    const toolsPreview = tools?.map((t) => ({\n      name: t.function.name,\n      description: t.function.description?.slice(0, 200),\n    }));\n\n    // Extract LLM config params (temperature, thinkingLevel, topP, maxTokens, etc)\n    const { responseFormat, ...llmConfig } = mergedOptions ?? {};\n\n    // Typed span start data for LLM calls\n    const startData: LLMSpanStartData = {\n      provider: this.providerName,\n      model: this.modelName,\n      messagesCount: messages.length,\n      toolsCount: tools?.length ?? 0,\n      llmConfig: Object.keys(llmConfig).length > 0 ? llmConfig : undefined,\n      responseFormat,\n      messages: messagesPreview,\n      tools: toolsPreview,\n    };\n\n    return Tracing.withSpan(\n      {\n        kind: SpanType.llm,\n        name: `llm:${this.modelName}`,\n        data: startData,\n      },\n      async (llmSpan) => {\n        const headers = this.buildGatewayHeaders();\n        this.logger.debug(\"LLM Gateway request\", {\n          model,\n          baseUrl: this.baseUrl,\n          stream: false,\n          messageCount: messages.length,\n          toolCount: tools?.length ?? 0,\n        });\n\n        try {\n          // Use .withResponse() to access HTTP headers for backend enrichment data\n          const { data: response, response: httpResponse } = await this.client.chat.completions\n            .create(\n              {\n                model,\n                messages: this.convertMessages(messages),\n                tools: this.convertTools(tools),\n                response_format:\n                  mergedOptions?.responseFormat?.type === \"json\"\n                    ? mergedOptions.responseFormat.schema\n                      ? {\n                          type: \"json_schema\",\n                          json_schema: { name: \"response\", schema: mergedOptions.responseFormat.schema as any },\n                        }\n                      : { type: \"json_object\" }\n                    : undefined,\n                ...this.extractExtraOptions(mergedOptions),\n              },\n              { headers },\n            )\n            .withResponse();\n\n          this.logger.debug(\"LLM Gateway response\", {\n            model,\n            finishReason: response.choices?.[0]?.finish_reason,\n            hasUsage: Boolean(response.usage),\n          });\n\n          const choice = response.choices[0];\n          const message = choice.message;\n          const usage = this.mapUsage(response.usage);\n          const finishReason = this.mapFinishReason(choice.finish_reason);\n\n          // Read enrichment headers from backend (model actual, cost, usage, fallback)\n          const enrichment = this.extractEnrichmentFromHeaders(httpResponse.headers);\n\n          // Typed span end data for LLM calls\n          const endData: LLMSpanEndData = {\n            usage: enrichment.usage ?? usage ?? { promptTokens: 0, completionTokens: 0, totalTokens: 0 },\n            finishReason: finishReason ?? \"stop\",\n            toolCallsCount: message.tool_calls?.length ?? 0,\n            choices: response.choices,\n            model: enrichment.modelActual,\n            fallbackUsed: enrichment.fallbackUsed,\n            cost: enrichment.cost ? parseFloat(enrichment.cost.amountUsd) : undefined,\n          };\n\n          await llmSpan.end({\n            status: \"success\",\n            data: endData,\n          });\n\n          return {\n            content: message.content || \"\",\n            toolCalls: message.tool_calls?.map((tc) => ({\n              id: tc.id,\n              type: \"function\",\n              function: {\n                name: tc.function.name,\n                arguments: tc.function.arguments,\n              },\n            })),\n            finishReason,\n            usage: enrichment.usage ?? usage,\n          };\n        } catch (error) {\n          this.logger.error(\"LLM Gateway request failed\", error, undefined, undefined);\n          const gatewayError = this.handleError(error);\n\n          // Typed span end data for error case\n          const errorEndData: LLMSpanEndData = {\n            error: {\n              message: gatewayError.message,\n              code: gatewayError.code,\n              status: gatewayError.status,\n            },\n          };\n\n          await llmSpan.end({\n            status: \"error\",\n            data: errorEndData,\n          });\n\n          throw gatewayError;\n        }\n      },\n    );\n  }\n\n  async *generateStream(\n    messages: Message[],\n    tools?: ToolDefinitionForLLM[],\n    options?: GenerateOptions,\n  ): AsyncGenerator<StreamChunk> {\n    const mergedOptions = { ...this.options, ...options };\n    const model = `route:${this.modelName}`;\n\n    // Prepare context data for tracing (useful for debugging, especially on errors)\n    const messagesPreview = messages.map((m) => ({\n      role: m.role,\n      content: typeof m.content === \"string\"\n        ? m.content.length > 500 ? m.content.slice(0, 500) + \"...\" : m.content\n        : Array.isArray(m.content) ? `[${m.content.length} parts]` : String(m.content),\n    }));\n    const toolsPreview = tools?.map((t) => ({\n      name: t.function.name,\n      description: t.function.description?.slice(0, 200),\n    }));\n\n    // Extract LLM config params (temperature, thinkingLevel, topP, maxTokens, etc)\n    const { responseFormat, ...llmConfig } = mergedOptions ?? {};\n\n    // Typed span start data for LLM calls\n    const startData: LLMSpanStartData = {\n      provider: this.providerName,\n      model: this.modelName,\n      messagesCount: messages.length,\n      toolsCount: tools?.length ?? 0,\n      llmConfig: Object.keys(llmConfig).length > 0 ? llmConfig : undefined,\n      responseFormat,\n      messages: messagesPreview,\n      tools: toolsPreview,\n    };\n\n    // Start span manually for streaming (async generators can't use withSpan directly)\n    const llmSpan = await Tracing.startSpan({\n      kind: SpanType.llm,\n      name: `llm:${this.modelName}`,\n      data: startData,\n    });\n\n    const headers = this.buildGatewayHeaders();\n    this.logger.debug(\"LLM Gateway stream request\", {\n      model,\n      baseUrl: this.baseUrl,\n      stream: true,\n      messageCount: messages.length,\n      toolCount: tools?.length ?? 0,\n    });\n\n    let stream;\n    try {\n      stream = await this.client.chat.completions.create(\n        {\n          model,\n          messages: this.convertMessages(messages),\n          tools: this.convertTools(tools),\n          stream: true,\n          stream_options: { include_usage: true },\n          response_format:\n            mergedOptions?.responseFormat?.type === \"json\"\n              ? mergedOptions.responseFormat.schema\n                ? {\n                    type: \"json_schema\",\n                    json_schema: { name: \"response\", schema: mergedOptions.responseFormat.schema as any },\n                  }\n                : { type: \"json_object\" }\n              : undefined,\n          ...this.extractExtraOptions(mergedOptions),\n        },\n        { headers },\n      );\n    } catch (error) {\n      this.logger.error(\"LLM Gateway stream request failed\", error, undefined, undefined);\n      const gatewayError = this.handleError(error);\n\n      if (llmSpan) {\n        // Typed span end data for error case\n        const errorEndData: LLMSpanEndData = {\n          error: {\n            message: gatewayError.message,\n            code: gatewayError.code,\n            status: gatewayError.status,\n          },\n        };\n\n        await llmSpan.end({\n          status: \"error\",\n          data: errorEndData,\n        });\n      }\n\n      throw gatewayError;\n    }\n\n    let finalUsage: TokenUsage | undefined;\n    let finalFinishReason: ProviderResponse[\"finishReason\"];\n    let toolCallsCount = 0;\n    let outputPreview = \"\";\n    let finalContent = \"\";\n    const toolCallsAccumulator: Map<number, { id: string; name: string; arguments: string }> = new Map();\n\n    try {\n      for await (const chunk of stream) {\n        if (chunk.usage) {\n          finalUsage = this.mapUsage(chunk.usage);\n          yield {\n            type: \"finish\",\n            reason: \"stop\",\n            usage: finalUsage,\n          };\n        }\n\n        const choice = chunk.choices?.[0];\n        if (!choice) continue;\n\n        if (choice.finish_reason) {\n          finalFinishReason = this.mapFinishReason(choice.finish_reason);\n          yield {\n            type: \"finish\",\n            reason: finalFinishReason,\n          };\n        }\n\n        const delta = choice.delta;\n        if (!delta) continue;\n\n        if (delta.content) {\n          finalContent += delta.content;\n          if (outputPreview.length < 200) {\n            outputPreview += delta.content.slice(0, 200 - outputPreview.length);\n          }\n          yield { type: \"content_delta\", delta: delta.content };\n        }\n\n        if (delta.tool_calls) {\n          for (const tc of delta.tool_calls) {\n            const idx = tc.index;\n            if (tc.id && tc.function?.name) {\n              toolCallsCount++;\n              toolCallsAccumulator.set(idx, { id: tc.id, name: tc.function.name, arguments: \"\" });\n              yield {\n                type: \"tool_call_start\",\n                index: idx,\n                id: tc.id,\n                name: tc.function.name,\n              };\n            }\n\n            if (tc.function?.arguments) {\n              const existing = toolCallsAccumulator.get(idx);\n              if (existing) {\n                existing.arguments += tc.function.arguments;\n              }\n              yield {\n                type: \"tool_call_delta\",\n                index: idx,\n                args: tc.function.arguments,\n              };\n            }\n          }\n        }\n      }\n\n      // Build choices for observability\n      const toolCalls = Array.from(toolCallsAccumulator.values()).map((tc) => ({\n        id: tc.id,\n        type: \"function\" as const,\n        function: { name: tc.name, arguments: tc.arguments },\n      }));\n\n      const choices = [{\n        index: 0,\n        message: {\n          role: \"assistant\" as const,\n          content: finalContent || null,\n          tool_calls: toolCalls.length > 0 ? toolCalls : undefined,\n        },\n        finish_reason: finalFinishReason,\n      }];\n\n      // Typed span end data for success case\n      if (llmSpan) {\n        const endData: LLMSpanEndData = {\n          usage: finalUsage ?? { promptTokens: 0, completionTokens: 0, totalTokens: 0 },\n          finishReason: finalFinishReason ?? \"stop\",\n          toolCallsCount,\n          outputPreview,\n          choices,\n        };\n\n        await llmSpan.end({\n          status: \"success\",\n          data: endData,\n        });\n      }\n    } catch (error) {\n      this.logger.error(\"LLM Gateway stream failed\", error, undefined, undefined);\n      const gatewayError = this.handleError(error);\n\n      if (llmSpan) {\n        // Typed span end data for error case\n        const errorEndData: LLMSpanEndData = {\n          error: {\n            message: gatewayError.message,\n            code: gatewayError.code,\n            status: gatewayError.status,\n          },\n        };\n\n        await llmSpan.end({\n          status: \"error\",\n          data: errorEndData,\n        });\n      }\n\n      throw gatewayError;\n    }\n  }\n\n  // ==========================================================================\n  // Error Handling\n  // ==========================================================================\n\n  /**\n   * Transforms raw errors into actionable LLMGatewayError with clear messages.\n   * This ensures developers get specific guidance on how to resolve issues.\n   *\n   * Differentiates between:\n   * - Gateway errors: LLM Gateway API key issues (check NEBULAOS_API_KEY env var)\n   * - Provider errors: LLM provider API key issues (check route config in dashboard)\n   */\n  private handleError(error: unknown): LLMGatewayError {\n    // Handle OpenAI SDK APIError (includes status, message, code)\n    if (error instanceof APIError) {\n      const status = error.status;\n      const originalMessage = error.message;\n\n      // Check X-Error-Source header to differentiate gateway vs provider errors\n      const errorSource = this.extractErrorSource(error);\n\n      // Authentication errors (401)\n      if (status === 401) {\n        if (errorSource === \"gateway\") {\n          return new LLMGatewayError(\n            `LLM Gateway authentication failed: Your LLM Gateway API key is invalid or expired. ` +\n              `Please verify your NEBULAOS_API_KEY environment variable or check your LLM Gateway API key in the NebulaOS dashboard. ` +\n              `Original error: ${originalMessage}`,\n            \"GATEWAY_AUTH_ERROR\",\n            status,\n            error,\n          );\n        } else {\n          // Provider error (default for 401 without explicit gateway source)\n          return new LLMGatewayError(\n            `LLM Provider authentication failed: The API key configured for your LLM provider (OpenAI, Azure, etc.) is invalid or expired. ` +\n              `Please verify the provider API key in your route configuration in the NebulaOS dashboard. ` +\n              `Original error: ${originalMessage}`,\n            \"PROVIDER_AUTH_ERROR\",\n            status,\n            error,\n          );\n        }\n      }\n\n      // Permission denied (403)\n      if (status === 403) {\n        if (errorSource === \"gateway\") {\n          return new LLMGatewayError(\n            `LLM Gateway access denied: Your LLM Gateway API key does not have permission to access this route. ` +\n              `Please verify the route is allowed for your LLM Gateway API key in the NebulaOS dashboard. ` +\n              `Original error: ${originalMessage}`,\n            \"GATEWAY_FORBIDDEN\",\n            status,\n            error,\n          );\n        } else {\n          return new LLMGatewayError(\n            `LLM Provider access denied: The provider API key does not have permission for this operation. ` +\n              `Please verify the provider API key permissions in the NebulaOS dashboard. ` +\n              `Original error: ${originalMessage}`,\n            \"PROVIDER_FORBIDDEN\",\n            status,\n            error,\n          );\n        }\n      }\n\n      // Rate limit (429)\n      if (status === 429) {\n        return new LLMGatewayError(\n          `LLM Gateway rate limit exceeded: Too many requests to the LLM provider. ` +\n            `Please wait before retrying or check your rate limit configuration. ` +\n            `Original error: ${originalMessage}`,\n          \"LLM_GATEWAY_RATE_LIMIT\",\n          status,\n          error,\n        );\n      }\n\n      // Bad request (400)\n      if (status === 400) {\n        return new LLMGatewayError(\n          `LLM Gateway request error: Invalid request parameters. ` +\n            `Please check your request configuration (model, messages, tools). ` +\n            `Original error: ${originalMessage}`,\n          \"LLM_GATEWAY_BAD_REQUEST\",\n          status,\n          error,\n        );\n      }\n\n      // Not found (404)\n      if (status === 404) {\n        return new LLMGatewayError(\n          `LLM Gateway route not found: The specified model or route does not exist. ` +\n            `Please verify the route alias '${this.modelName}' is correct and provisioned. ` +\n            `Original error: ${originalMessage}`,\n          \"LLM_GATEWAY_NOT_FOUND\",\n          status,\n          error,\n        );\n      }\n\n      // Timeout (408, 504)\n      if (status === 408 || status === 504) {\n        return new LLMGatewayError(\n          `LLM Gateway timeout: The request took too long to complete. ` +\n            `This may be due to high load or a complex request. Please try again. ` +\n            `Original error: ${originalMessage}`,\n          \"LLM_GATEWAY_TIMEOUT\",\n          status,\n          error,\n        );\n      }\n\n      // Server errors (5xx)\n      if (status && status >= 500) {\n        return new LLMGatewayError(\n          `LLM Gateway server error: The LLM provider returned an error (${status}). ` +\n            `This is typically a temporary issue. Please try again later. ` +\n            `Original error: ${originalMessage}`,\n          \"LLM_GATEWAY_SERVER_ERROR\",\n          status,\n          error,\n        );\n      }\n\n      // Other API errors\n      return new LLMGatewayError(\n        `LLM Gateway error (${status}): ${originalMessage}`,\n        \"LLM_GATEWAY_ERROR\",\n        status,\n        error,\n      );\n    }\n\n    // Handle standard Error objects\n    if (error instanceof Error) {\n      const msg = error.message.toLowerCase();\n\n      // Connection errors\n      if (msg.includes(\"econnrefused\") || msg.includes(\"enotfound\") || msg.includes(\"network\")) {\n        return new LLMGatewayError(\n          `LLM Gateway connection failed: Unable to connect to the LLM Gateway at ${this.baseUrl}. ` +\n            `Please verify the gateway is running and accessible. ` +\n            `Original error: ${error.message}`,\n          \"LLM_GATEWAY_CONNECTION_ERROR\",\n          undefined,\n          error,\n        );\n      }\n\n      // Timeout errors\n      if (msg.includes(\"timeout\") || msg.includes(\"timed out\") || msg.includes(\"etimedout\")) {\n        return new LLMGatewayError(\n          `LLM Gateway timeout: The connection timed out. ` +\n            `Please check network connectivity and try again. ` +\n            `Original error: ${error.message}`,\n          \"LLM_GATEWAY_TIMEOUT\",\n          undefined,\n          error,\n        );\n      }\n\n      // Generic Error - preserve original message with context\n      return new LLMGatewayError(\n        `LLM Gateway error: ${error.message}`,\n        \"LLM_GATEWAY_ERROR\",\n        undefined,\n        error,\n      );\n    }\n\n    // Unknown error type\n    return new LLMGatewayError(\n      `LLM Gateway error: An unexpected error occurred. Details: ${String(error)}`,\n      \"LLM_GATEWAY_UNKNOWN_ERROR\",\n      undefined,\n      error,\n    );\n  }\n\n  /**\n   * Extracts the error source from an APIError.\n   * The backend sets X-Error-Source header or includes source in the error body\n   * to differentiate between gateway errors (LLM Gateway API key) and provider errors.\n   *\n   * @returns \"gateway\" if the error is from LLM Gateway authentication,\n   *          \"provider\" if the error is from the upstream LLM provider,\n   *          undefined if the source cannot be determined.\n   */\n  private extractErrorSource(error: APIError): \"gateway\" | \"provider\" | undefined {\n    // Try to get source from response headers\n    const headers = error.headers;\n    if (headers) {\n      const errorSource = headers[\"x-error-source\"] || headers[\"X-Error-Source\"];\n      if (errorSource === \"gateway\" || errorSource === \"provider\") {\n        return errorSource;\n      }\n    }\n\n    // Try to get source from error body\n    // The backend may include { error: { source: \"gateway\" | \"provider\", ... } }\n    const errorBody = error.error as Record<string, unknown> | undefined;\n    if (errorBody && typeof errorBody === \"object\") {\n      // Check for nested error object (OpenAI style)\n      const nestedError = errorBody.error as Record<string, unknown> | undefined;\n      if (nestedError && typeof nestedError === \"object\" && nestedError.source) {\n        const source = nestedError.source;\n        if (source === \"gateway\" || source === \"provider\") {\n          return source;\n        }\n      }\n      // Check for direct source field\n      if (errorBody.source === \"gateway\" || errorBody.source === \"provider\") {\n        return errorBody.source;\n      }\n    }\n\n    // Check error message for gateway-specific patterns\n    const msg = error.message.toLowerCase();\n    if (msg.includes(\"llm gateway api key\") || msg.includes(\"llm gateway\")) {\n      return \"gateway\";\n    }\n\n    return undefined;\n  }\n\n  // ==========================================================================\n  // Helpers (copied from OpenAI provider)\n  // ==========================================================================\n\n  private extractExtraOptions(options?: GenerateOptions): Record<string, any> {\n    if (!options) return {};\n    const { responseFormat, ...rest } = options;\n    return rest;\n  }\n\n  private buildGatewayHeaders(): Record<string, string> {\n    const headers: Record<string, string> = {\n      \"x-request-id\": randomUUID(),\n    };\n\n    const exec = ExecutionContext.getOrUndefined();\n    if (exec?.executionId) {\n      headers[\"x-execution-id\"] = exec.executionId;\n    }\n\n    const ctx = Tracing.getContext();\n    if (ctx) {\n      // IDs já estão em formato W3C (hex)\n      headers.traceparent = `00-${ctx.traceId}-${ctx.spanId}-01`;\n    } else {\n      // Still emit a root trace context so the gateway can correlate requests by traceId.\n      const traceId = randomBytes(16).toString(\"hex\");\n      const spanId = randomBytes(8).toString(\"hex\");\n      headers.traceparent = `00-${traceId}-${spanId}-01`;\n    }\n\n    return headers;\n  }\n\n  /**\n   * Extracts enrichment data from backend HTTP headers.\n   * Backend returns this data so SDK can enrich its own span (avoiding duplicate spans).\n   */\n  private extractEnrichmentFromHeaders(headers: Headers): {\n    modelActual?: string;\n    fallbackUsed?: boolean;\n    usage?: TokenUsage;\n    cost?: { amountUsd: string; available: boolean };\n  } {\n    const result: ReturnType<typeof this.extractEnrichmentFromHeaders> = {};\n\n    const modelActual = headers.get(\"x-llm-model-actual\");\n    if (modelActual) {\n      result.modelActual = modelActual;\n    }\n\n    const fallbackUsed = headers.get(\"x-llm-fallback-used\");\n    if (fallbackUsed) {\n      result.fallbackUsed = fallbackUsed === \"true\";\n    }\n\n    const usageRaw = headers.get(\"x-llm-usage\");\n    if (usageRaw) {\n      try {\n        const usage = JSON.parse(usageRaw);\n        result.usage = {\n          promptTokens: usage.prompt_tokens,\n          completionTokens: usage.completion_tokens,\n          totalTokens: usage.total_tokens,\n          reasoningTokens: usage.completion_tokens_details?.reasoning_tokens,\n          // Preserve any additional token fields from provider\n          ...usage,\n        };\n      } catch {\n        this.logger.warn(\"Failed to parse x-llm-usage header\", { usageRaw });\n      }\n    }\n\n    const cost = headers.get(\"x-llm-cost\");\n    const costAvailable = headers.get(\"x-llm-cost-available\");\n    if (cost) {\n      result.cost = {\n        amountUsd: cost,\n        available: costAvailable === \"true\",\n      };\n    }\n\n    return result;\n  }\n\n  protected convertMessages(messages: Message[]): OpenAIClient.Chat.ChatCompletionMessageParam[] {\n    // Ensure tools have a preceding assistant message with tool_calls\n    const allowedToolCallIds = new Set<string>();\n\n    return messages.flatMap((m) => {\n      if (m.role === \"tool\") {\n        // Skip orphan tool messages (no preceding tool_calls)\n        if (!m.tool_call_id || !allowedToolCallIds.has(m.tool_call_id)) {\n          return [];\n        }\n\n        return {\n          role: \"tool\",\n          tool_call_id: m.tool_call_id!,\n          content: typeof m.content === \"string\" ? m.content : JSON.stringify(m.content), // Tool output usually string\n        };\n      }\n\n      if (m.role === \"assistant\") {\n        // OpenAI rules:\n        // - content is required (string | null)\n        // - if tool_calls is present, content can be null\n        // - if tool_calls is NOT present, content must be string (cannot be null/empty if strict, but usually empty string is fine)\n\n        let assistantContent: string | null = null;\n\n        if (typeof m.content === \"string\") {\n          assistantContent = m.content;\n        }\n\n        // If content is null/empty AND no tool_calls, force empty string to avoid API error\n        if (!assistantContent && (!m.tool_calls || m.tool_calls.length === 0)) {\n          assistantContent = \"\";\n        }\n\n        if (m.tool_calls) {\n          m.tool_calls.forEach((tc) => allowedToolCallIds.add(tc.id));\n        }\n\n        return {\n          role: \"assistant\",\n          content: assistantContent,\n          tool_calls: m.tool_calls?.map((tc) => ({\n            id: tc.id,\n            type: \"function\",\n            function: {\n              name: tc.function.name,\n              arguments: tc.function.arguments,\n            },\n          })),\n        };\n      }\n\n      // User / System with potential multimodal content\n      const content: OpenAIClient.Chat.ChatCompletionContentPart[] | string = Array.isArray(\n        m.content,\n      )\n        ? m.content.map((part) => this.convertContentPart(part))\n        : m.content || \"\";\n\n      return {\n        role: m.role as \"system\" | \"user\",\n        content,\n        name: m.name,\n      } as any;\n    });\n  }\n\n  private convertTools(\n    tools?: ToolDefinitionForLLM[],\n  ): OpenAIClient.Chat.ChatCompletionTool[] | undefined {\n    if (!tools || tools.length === 0) return undefined;\n    return tools.map((t) => ({\n      type: \"function\",\n      function: {\n        name: t.function.name,\n        description: t.function.description,\n        parameters: t.function.parameters,\n      },\n    }));\n  }\n\n  private mapUsage(usage?: OpenAIClient.CompletionUsage): TokenUsage | undefined {\n    if (!usage) return undefined;\n    return {\n      promptTokens: usage.prompt_tokens,\n      completionTokens: usage.completion_tokens,\n      totalTokens: usage.total_tokens,\n      reasoningTokens: (usage as any).completion_tokens_details?.reasoning_tokens,\n    };\n  }\n\n  private mapFinishReason(reason: string | null): ProviderResponse[\"finishReason\"] {\n    switch (reason) {\n      case \"stop\":\n        return \"stop\";\n      case \"length\":\n        return \"length\";\n      case \"tool_calls\":\n        return \"tool_calls\";\n      case \"content_filter\":\n        return \"content_filter\";\n      default:\n        return undefined;\n    }\n  }\n\n  private convertContentPart(part: ContentPart): OpenAIClient.Chat.ChatCompletionContentPart {\n    if (part.type === \"text\") return { type: \"text\", text: part.text };\n\n    if (part.type === \"file\") {\n      const { mimeType, source } = part.file;\n      if (!mimeType.startsWith(\"image/\")) {\n        throw new Error(`LLM Gateway: file mimeType '${mimeType}' is not supported yet`);\n      }\n\n      const url = source.type === \"url\" ? source.url : `data:${mimeType};base64,${source.base64}`;\n\n      return { type: \"image_url\", image_url: { url } };\n    }\n\n    if (part.type === \"image_url\") {\n      return { type: \"image_url\", image_url: { url: part.image_url.url } };\n    }\n\n    // Exhaustive check - should never reach here with proper ContentPart\n    const _exhaustive: never = part;\n    throw new Error(`Unsupported content type: ${(_exhaustive as any).type}`);\n  }\n}\n"],"mappings":"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","names":["OpenAIClient"]}

package/dist/index.mjs

@@ -6,6 +6,7 @@ import {
   ExecutionContext,
   Tracing
 } from "@nebulaos/core";
+import { SpanType } from "@nebulaos/types";
 var LLMGatewayError = class extends Error {
   constructor(message, code, status, cause) {
     super(message);
@@ -51,19 +52,22 @@ var LLMGateway = class {
       name: t.function.name,
       description: t.function.description?.slice(0, 200)
     }));
+    const { responseFormat, ...llmConfig } = mergedOptions ?? {};
+    const startData = {
+      provider: this.providerName,
+      model: this.modelName,
+      messagesCount: messages.length,
+      toolsCount: tools?.length ?? 0,
+      llmConfig: Object.keys(llmConfig).length > 0 ? llmConfig : void 0,
+      responseFormat,
+      messages: messagesPreview,
+      tools: toolsPreview
+    };
     return Tracing.withSpan(
       {
-        kind: "llm",
+        kind: SpanType.llm,
         name: `llm:${this.modelName}`,
-        data: {
-          provider: this.providerName,
-          model: this.modelName,
-          messagesCount: messages.length,
-          toolsCount: tools?.length ?? 0,
-          responseFormat: mergedOptions?.responseFormat,
-          messages: messagesPreview,
-          tools: toolsPreview
-        }
+        data: startData
       },
       async (llmSpan) => {
         const headers = this.buildGatewayHeaders();
@@ -75,7 +79,7 @@ var LLMGateway = class {
           toolCount: tools?.length ?? 0
         });
         try {
-          const response = await this.client.chat.completions.create(
+          const { data: response, response: httpResponse } = await this.client.chat.completions.create(
             {
               model,
               messages: this.convertMessages(messages),
@@ -87,7 +91,7 @@ var LLMGateway = class {
               ...this.extractExtraOptions(mergedOptions)
             },
             { headers }
-          );
+          ).withResponse();
           this.logger.debug("LLM Gateway response", {
             model,
             finishReason: response.choices?.[0]?.finish_reason,
@@ -97,14 +101,19 @@ var LLMGateway = class {
           const message = choice.message;
           const usage = this.mapUsage(response.usage);
           const finishReason = this.mapFinishReason(choice.finish_reason);
+          const enrichment = this.extractEnrichmentFromHeaders(httpResponse.headers);
+          const endData = {
+            usage: enrichment.usage ?? usage ?? { promptTokens: 0, completionTokens: 0, totalTokens: 0 },
+            finishReason: finishReason ?? "stop",
+            toolCallsCount: message.tool_calls?.length ?? 0,
+            choices: response.choices,
+            model: enrichment.modelActual,
+            fallbackUsed: enrichment.fallbackUsed,
+            cost: enrichment.cost ? parseFloat(enrichment.cost.amountUsd) : void 0
+          };
           await llmSpan.end({
             status: "success",
-            data: {
-              usage,
-              finishReason,
-              toolCallsCount: message.tool_calls?.length ?? 0,
-              outputPreview: message.content?.slice(0, 200)
-            }
+            data: endData
           });
           return {
             content: message.content || "",
@@ -117,20 +126,21 @@ var LLMGateway = class {
               }
             })),
             finishReason,
-            usage
+            usage: enrichment.usage ?? usage
           };
         } catch (error) {
           this.logger.error("LLM Gateway request failed", error, void 0, void 0);
           const gatewayError = this.handleError(error);
+          const errorEndData = {
+            error: {
+              message: gatewayError.message,
+              code: gatewayError.code,
+              status: gatewayError.status
+            }
+          };
           await llmSpan.end({
             status: "error",
-            data: {
-              error: {
-                message: gatewayError.message,
-                code: gatewayError.code,
-                status: gatewayError.status
-              }
-            }
+            data: errorEndData
           });
           throw gatewayError;
         }
@@ -148,18 +158,21 @@ var LLMGateway = class {
       name: t.function.name,
       description: t.function.description?.slice(0, 200)
     }));
+    const { responseFormat, ...llmConfig } = mergedOptions ?? {};
+    const startData = {
+      provider: this.providerName,
+      model: this.modelName,
+      messagesCount: messages.length,
+      toolsCount: tools?.length ?? 0,
+      llmConfig: Object.keys(llmConfig).length > 0 ? llmConfig : void 0,
+      responseFormat,
+      messages: messagesPreview,
+      tools: toolsPreview
+    };
     const llmSpan = await Tracing.startSpan({
-      kind: "llm",
+      kind: SpanType.llm,
       name: `llm:${this.modelName}`,
-      data: {
-        provider: this.providerName,
-        model: this.modelName,
-        messagesCount: messages.length,
-        toolsCount: tools?.length ?? 0,
-        responseFormat: mergedOptions?.responseFormat,
-        messages: messagesPreview,
-        tools: toolsPreview
-      }
+      data: startData
     });
     const headers = this.buildGatewayHeaders();
     this.logger.debug("LLM Gateway stream request", {
@@ -190,15 +203,16 @@ var LLMGateway = class {
       this.logger.error("LLM Gateway stream request failed", error, void 0, void 0);
       const gatewayError = this.handleError(error);
       if (llmSpan) {
+        const errorEndData = {
+          error: {
+            message: gatewayError.message,
+            code: gatewayError.code,
+            status: gatewayError.status
+          }
+        };
         await llmSpan.end({
           status: "error",
-          data: {
-            error: {
-              message: gatewayError.message,
-              code: gatewayError.code,
-              status: gatewayError.status
-            }
-          }
+          data: errorEndData
         });
       }
       throw gatewayError;
@@ -207,6 +221,8 @@ var LLMGateway = class {
     let finalFinishReason;
     let toolCallsCount = 0;
     let outputPreview = "";
+    let finalContent = "";
+    const toolCallsAccumulator = /* @__PURE__ */ new Map();
     try {
       for await (const chunk of stream) {
         if (chunk.usage) {
@@ -229,6 +245,7 @@ var LLMGateway = class {
         const delta = choice.delta;
         if (!delta) continue;
         if (delta.content) {
+          finalContent += delta.content;
           if (outputPreview.length < 200) {
             outputPreview += delta.content.slice(0, 200 - outputPreview.length);
           }
@@ -236,49 +253,72 @@ var LLMGateway = class {
         }
         if (delta.tool_calls) {
           for (const tc of delta.tool_calls) {
+            const idx = tc.index;
             if (tc.id && tc.function?.name) {
               toolCallsCount++;
+              toolCallsAccumulator.set(idx, { id: tc.id, name: tc.function.name, arguments: "" });
               yield {
                 type: "tool_call_start",
-                index: tc.index,
+                index: idx,
                 id: tc.id,
                 name: tc.function.name
               };
             }
             if (tc.function?.arguments) {
+              const existing = toolCallsAccumulator.get(idx);
+              if (existing) {
+                existing.arguments += tc.function.arguments;
+              }
               yield {
                 type: "tool_call_delta",
-                index: tc.index,
+                index: idx,
                 args: tc.function.arguments
               };
             }
           }
         }
       }
+      const toolCalls = Array.from(toolCallsAccumulator.values()).map((tc) => ({
+        id: tc.id,
+        type: "function",
+        function: { name: tc.name, arguments: tc.arguments }
+      }));
+      const choices = [{
+        index: 0,
+        message: {
+          role: "assistant",
+          content: finalContent || null,
+          tool_calls: toolCalls.length > 0 ? toolCalls : void 0
+        },
+        finish_reason: finalFinishReason
+      }];
       if (llmSpan) {
+        const endData = {
+          usage: finalUsage ?? { promptTokens: 0, completionTokens: 0, totalTokens: 0 },
+          finishReason: finalFinishReason ?? "stop",
+          toolCallsCount,
+          outputPreview,
+          choices
+        };
         await llmSpan.end({
           status: "success",
-          data: {
-            usage: finalUsage,
-            finishReason: finalFinishReason,
-            toolCallsCount,
-            outputPreview
-          }
+          data: endData
         });
       }
     } catch (error) {
       this.logger.error("LLM Gateway stream failed", error, void 0, void 0);
       const gatewayError = this.handleError(error);
       if (llmSpan) {
+        const errorEndData = {
+          error: {
+            message: gatewayError.message,
+            code: gatewayError.code,
+            status: gatewayError.status
+          }
+        };
         await llmSpan.end({
           status: "error",
-          data: {
-            error: {
-              message: gatewayError.message,
-              code: gatewayError.code,
-              status: gatewayError.status
-            }
-          }
+          data: errorEndData
         });
       }
       throw gatewayError;
@@ -475,6 +515,46 @@ var LLMGateway = class {
     }
     return headers;
   }
+  /**
+   * Extracts enrichment data from backend HTTP headers.
+   * Backend returns this data so SDK can enrich its own span (avoiding duplicate spans).
+   */
+  extractEnrichmentFromHeaders(headers) {
+    const result = {};
+    const modelActual = headers.get("x-llm-model-actual");
+    if (modelActual) {
+      result.modelActual = modelActual;
+    }
+    const fallbackUsed = headers.get("x-llm-fallback-used");
+    if (fallbackUsed) {
+      result.fallbackUsed = fallbackUsed === "true";
+    }
+    const usageRaw = headers.get("x-llm-usage");
+    if (usageRaw) {
+      try {
+        const usage = JSON.parse(usageRaw);
+        result.usage = {
+          promptTokens: usage.prompt_tokens,
+          completionTokens: usage.completion_tokens,
+          totalTokens: usage.total_tokens,
+          reasoningTokens: usage.completion_tokens_details?.reasoning_tokens,
+          // Preserve any additional token fields from provider
+          ...usage
+        };
+      } catch {
+        this.logger.warn("Failed to parse x-llm-usage header", { usageRaw });
+      }
+    }
+    const cost = headers.get("x-llm-cost");
+    const costAvailable = headers.get("x-llm-cost-available");
+    if (cost) {
+      result.cost = {
+        amountUsd: cost,
+        available: costAvailable === "true"
+      };
+    }
+    return result;
+  }
   convertMessages(messages) {
     const allowedToolCallIds = /* @__PURE__ */ new Set();
     return messages.flatMap((m) => {

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import OpenAIClient, { APIError, ClientOptions } from \"openai\";\nimport { randomBytes, randomUUID } from \"node:crypto\";\nimport {\n  IModel,\n  Message,\n  ProviderResponse,\n  StreamChunk,\n  ToolDefinitionForLLM,\n  GenerateOptions,\n  TokenUsage,\n  ContentPart,\n  ConsoleLogger,\n  type LogLevel,\n  ExecutionContext,\n  Tracing,\n} from \"@nebulaos/core\";\n\n/**\n * Custom error class for LLM Gateway errors.\n * Provides clear, actionable error messages for developers.\n */\nexport class LLMGatewayError extends Error {\n  constructor(\n    message: string,\n    public readonly code: string,\n    public readonly status?: number,\n    public readonly cause?: unknown,\n  ) {\n    super(message);\n    this.name = \"LLMGatewayError\";\n  }\n}\n\n/**\n * LLM Gateway Provider Configuration\n */\nexport interface LLMGatewayConfig {\n  /** API Key from NebulaOS */\n  apiKey: string;\n  /** Base URL of the NebulaOS LLM Gateway */\n  baseUrl?: string;\n  /** Route alias (e.g., \"assistente\", \"code-review\") */\n  model: string;\n  /** Logger verbosity for gateway calls */\n  logLevel?: LogLevel;\n  /** Optional OpenAI client options */\n  clientOptions?: ClientOptions;\n  /**\n   * Default model options passed to every generate() call.\n   * Supports provider-specific params like reasoning_effort, temperature, topK, etc.\n   * These can be overridden by options passed directly to generate().\n   */\n  options?: Omit<GenerateOptions, \"responseFormat\">;\n}\n\n/**\n * NebulaOS LLM Gateway Provider\n *\n * Provides access to NebulaOS LLM Gateway routes through an OpenAI-compatible interface.\n * Routes are pre-configured in NebulaOS and provide automatic fallback, cost tracking,\n * and access control.\n */\nexport class LLMGateway implements IModel {\n  providerName = \"llm-gateway\";\n  modelName: string;\n  private client: OpenAIClient;\n  private baseUrl: string;\n  private logger: ConsoleLogger;\n  private options?: Omit<GenerateOptions, \"responseFormat\">;\n\n  capabilities = {\n    inputFiles: {\n      mimeTypes: [\"image/*\"],\n      sources: [\"url\", \"base64\"] as const,\n    },\n  } as const;\n\n  constructor(config: LLMGatewayConfig) {\n    this.modelName = config.model;\n\n    this.baseUrl = config.baseUrl || \"http://localhost:4100\";\n    const baseURL = this.baseUrl.endsWith(\"/v1\") ? this.baseUrl : `${this.baseUrl}/v1`;\n    this.logger = new ConsoleLogger(config.logLevel || \"info\", \"nebulaos/llm-gateway\");\n\n    this.client = new OpenAIClient({\n      apiKey: config.apiKey,\n      baseURL,\n      ...config.clientOptions,\n    });\n    this.options = config.options;\n  }\n\n  async generate(\n    messages: Message[],\n    tools?: ToolDefinitionForLLM[],\n    options?: GenerateOptions,\n  ): Promise<ProviderResponse> {\n    const mergedOptions = { ...this.options, ...options };\n    const model = `route:${this.modelName}`;\n\n    // Prepare context data for tracing (useful for debugging, especially on errors)\n    const messagesPreview = messages.map((m) => ({\n      role: m.role,\n      content: typeof m.content === \"string\"\n        ? m.content.length > 500 ? m.content.slice(0, 500) + \"...\" : m.content\n        : Array.isArray(m.content) ? `[${m.content.length} parts]` : String(m.content),\n    }));\n    const toolsPreview = tools?.map((t) => ({\n      name: t.function.name,\n      description: t.function.description?.slice(0, 200),\n    }));\n\n    return Tracing.withSpan(\n      {\n        kind: \"llm\",\n        name: `llm:${this.modelName}`,\n        data: {\n          provider: this.providerName,\n          model: this.modelName,\n          messagesCount: messages.length,\n          toolsCount: tools?.length ?? 0,\n          responseFormat: mergedOptions?.responseFormat,\n          messages: messagesPreview,\n          tools: toolsPreview,\n        },\n      },\n      async (llmSpan) => {\n        const headers = this.buildGatewayHeaders();\n        this.logger.debug(\"LLM Gateway request\", {\n          model,\n          baseUrl: this.baseUrl,\n          stream: false,\n          messageCount: messages.length,\n          toolCount: tools?.length ?? 0,\n        });\n\n        try {\n          const response = await this.client.chat.completions.create(\n            {\n              model,\n              messages: this.convertMessages(messages),\n              tools: this.convertTools(tools),\n              response_format:\n                mergedOptions?.responseFormat?.type === \"json\"\n                  ? mergedOptions.responseFormat.schema\n                    ? {\n                        type: \"json_schema\",\n                        json_schema: { name: \"response\", schema: mergedOptions.responseFormat.schema as any },\n                      }\n                    : { type: \"json_object\" }\n                  : undefined,\n              ...this.extractExtraOptions(mergedOptions),\n            },\n            { headers },\n          );\n\n          this.logger.debug(\"LLM Gateway response\", {\n            model,\n            finishReason: response.choices?.[0]?.finish_reason,\n            hasUsage: Boolean(response.usage),\n          });\n\n          const choice = response.choices[0];\n          const message = choice.message;\n          const usage = this.mapUsage(response.usage);\n          const finishReason = this.mapFinishReason(choice.finish_reason);\n\n          await llmSpan.end({\n            status: \"success\",\n            data: {\n              usage,\n              finishReason,\n              toolCallsCount: message.tool_calls?.length ?? 0,\n              outputPreview: message.content?.slice(0, 200),\n            },\n          });\n\n          return {\n            content: message.content || \"\",\n            toolCalls: message.tool_calls?.map((tc) => ({\n              id: tc.id,\n              type: \"function\",\n              function: {\n                name: tc.function.name,\n                arguments: tc.function.arguments,\n              },\n            })),\n            finishReason,\n            usage,\n          };\n        } catch (error) {\n          this.logger.error(\"LLM Gateway request failed\", error, undefined, undefined);\n          const gatewayError = this.handleError(error);\n\n          await llmSpan.end({\n            status: \"error\",\n            data: {\n              error: {\n                message: gatewayError.message,\n                code: gatewayError.code,\n                status: gatewayError.status,\n              },\n            },\n          });\n\n          throw gatewayError;\n        }\n      },\n    );\n  }\n\n  async *generateStream(\n    messages: Message[],\n    tools?: ToolDefinitionForLLM[],\n    options?: GenerateOptions,\n  ): AsyncGenerator<StreamChunk> {\n    const mergedOptions = { ...this.options, ...options };\n    const model = `route:${this.modelName}`;\n\n    // Prepare context data for tracing (useful for debugging, especially on errors)\n    const messagesPreview = messages.map((m) => ({\n      role: m.role,\n      content: typeof m.content === \"string\"\n        ? m.content.length > 500 ? m.content.slice(0, 500) + \"...\" : m.content\n        : Array.isArray(m.content) ? `[${m.content.length} parts]` : String(m.content),\n    }));\n    const toolsPreview = tools?.map((t) => ({\n      name: t.function.name,\n      description: t.function.description?.slice(0, 200),\n    }));\n\n    // Start span manually for streaming (async generators can't use withSpan directly)\n    const llmSpan = await Tracing.startSpan({\n      kind: \"llm\",\n      name: `llm:${this.modelName}`,\n      data: {\n        provider: this.providerName,\n        model: this.modelName,\n        messagesCount: messages.length,\n        toolsCount: tools?.length ?? 0,\n        responseFormat: mergedOptions?.responseFormat,\n        messages: messagesPreview,\n        tools: toolsPreview,\n      },\n    });\n\n    const headers = this.buildGatewayHeaders();\n    this.logger.debug(\"LLM Gateway stream request\", {\n      model,\n      baseUrl: this.baseUrl,\n      stream: true,\n      messageCount: messages.length,\n      toolCount: tools?.length ?? 0,\n    });\n\n    let stream;\n    try {\n      stream = await this.client.chat.completions.create(\n        {\n          model,\n          messages: this.convertMessages(messages),\n          tools: this.convertTools(tools),\n          stream: true,\n          stream_options: { include_usage: true },\n          response_format:\n            mergedOptions?.responseFormat?.type === \"json\"\n              ? mergedOptions.responseFormat.schema\n                ? {\n                    type: \"json_schema\",\n                    json_schema: { name: \"response\", schema: mergedOptions.responseFormat.schema as any },\n                  }\n                : { type: \"json_object\" }\n              : undefined,\n          ...this.extractExtraOptions(mergedOptions),\n        },\n        { headers },\n      );\n    } catch (error) {\n      this.logger.error(\"LLM Gateway stream request failed\", error, undefined, undefined);\n      const gatewayError = this.handleError(error);\n\n      if (llmSpan) {\n        await llmSpan.end({\n          status: \"error\",\n          data: {\n            error: {\n              message: gatewayError.message,\n              code: gatewayError.code,\n              status: gatewayError.status,\n            },\n          },\n        });\n      }\n\n      throw gatewayError;\n    }\n\n    let finalUsage: TokenUsage | undefined;\n    let finalFinishReason: ProviderResponse[\"finishReason\"];\n    let toolCallsCount = 0;\n    let outputPreview = \"\";\n\n    try {\n      for await (const chunk of stream) {\n        if (chunk.usage) {\n          finalUsage = this.mapUsage(chunk.usage);\n          yield {\n            type: \"finish\",\n            reason: \"stop\",\n            usage: finalUsage,\n          };\n        }\n\n        const choice = chunk.choices?.[0];\n        if (!choice) continue;\n\n        if (choice.finish_reason) {\n          finalFinishReason = this.mapFinishReason(choice.finish_reason);\n          yield {\n            type: \"finish\",\n            reason: finalFinishReason,\n          };\n        }\n\n        const delta = choice.delta;\n        if (!delta) continue;\n\n        if (delta.content) {\n          if (outputPreview.length < 200) {\n            outputPreview += delta.content.slice(0, 200 - outputPreview.length);\n          }\n          yield { type: \"content_delta\", delta: delta.content };\n        }\n\n        if (delta.tool_calls) {\n          for (const tc of delta.tool_calls) {\n            if (tc.id && tc.function?.name) {\n              toolCallsCount++;\n              yield {\n                type: \"tool_call_start\",\n                index: tc.index,\n                id: tc.id,\n                name: tc.function.name,\n              };\n            }\n\n            if (tc.function?.arguments) {\n              yield {\n                type: \"tool_call_delta\",\n                index: tc.index,\n                args: tc.function.arguments,\n              };\n            }\n          }\n        }\n      }\n\n      // End span with success\n      if (llmSpan) {\n        await llmSpan.end({\n          status: \"success\",\n          data: {\n            usage: finalUsage,\n            finishReason: finalFinishReason,\n            toolCallsCount,\n            outputPreview,\n          },\n        });\n      }\n    } catch (error) {\n      this.logger.error(\"LLM Gateway stream failed\", error, undefined, undefined);\n      const gatewayError = this.handleError(error);\n\n      if (llmSpan) {\n        await llmSpan.end({\n          status: \"error\",\n          data: {\n            error: {\n              message: gatewayError.message,\n              code: gatewayError.code,\n              status: gatewayError.status,\n            },\n          },\n        });\n      }\n\n      throw gatewayError;\n    }\n  }\n\n  // ==========================================================================\n  // Error Handling\n  // ==========================================================================\n\n  /**\n   * Transforms raw errors into actionable LLMGatewayError with clear messages.\n   * This ensures developers get specific guidance on how to resolve issues.\n   *\n   * Differentiates between:\n   * - Gateway errors: LLM Gateway API key issues (check NEBULAOS_API_KEY env var)\n   * - Provider errors: LLM provider API key issues (check route config in dashboard)\n   */\n  private handleError(error: unknown): LLMGatewayError {\n    // Handle OpenAI SDK APIError (includes status, message, code)\n    if (error instanceof APIError) {\n      const status = error.status;\n      const originalMessage = error.message;\n\n      // Check X-Error-Source header to differentiate gateway vs provider errors\n      const errorSource = this.extractErrorSource(error);\n\n      // Authentication errors (401)\n      if (status === 401) {\n        if (errorSource === \"gateway\") {\n          return new LLMGatewayError(\n            `LLM Gateway authentication failed: Your LLM Gateway API key is invalid or expired. ` +\n              `Please verify your NEBULAOS_API_KEY environment variable or check your LLM Gateway API key in the NebulaOS dashboard. ` +\n              `Original error: ${originalMessage}`,\n            \"GATEWAY_AUTH_ERROR\",\n            status,\n            error,\n          );\n        } else {\n          // Provider error (default for 401 without explicit gateway source)\n          return new LLMGatewayError(\n            `LLM Provider authentication failed: The API key configured for your LLM provider (OpenAI, Azure, etc.) is invalid or expired. ` +\n              `Please verify the provider API key in your route configuration in the NebulaOS dashboard. ` +\n              `Original error: ${originalMessage}`,\n            \"PROVIDER_AUTH_ERROR\",\n            status,\n            error,\n          );\n        }\n      }\n\n      // Permission denied (403)\n      if (status === 403) {\n        if (errorSource === \"gateway\") {\n          return new LLMGatewayError(\n            `LLM Gateway access denied: Your LLM Gateway API key does not have permission to access this route. ` +\n              `Please verify the route is allowed for your LLM Gateway API key in the NebulaOS dashboard. ` +\n              `Original error: ${originalMessage}`,\n            \"GATEWAY_FORBIDDEN\",\n            status,\n            error,\n          );\n        } else {\n          return new LLMGatewayError(\n            `LLM Provider access denied: The provider API key does not have permission for this operation. ` +\n              `Please verify the provider API key permissions in the NebulaOS dashboard. ` +\n              `Original error: ${originalMessage}`,\n            \"PROVIDER_FORBIDDEN\",\n            status,\n            error,\n          );\n        }\n      }\n\n      // Rate limit (429)\n      if (status === 429) {\n        return new LLMGatewayError(\n          `LLM Gateway rate limit exceeded: Too many requests to the LLM provider. ` +\n            `Please wait before retrying or check your rate limit configuration. ` +\n            `Original error: ${originalMessage}`,\n          \"LLM_GATEWAY_RATE_LIMIT\",\n          status,\n          error,\n        );\n      }\n\n      // Bad request (400)\n      if (status === 400) {\n        return new LLMGatewayError(\n          `LLM Gateway request error: Invalid request parameters. ` +\n            `Please check your request configuration (model, messages, tools). ` +\n            `Original error: ${originalMessage}`,\n          \"LLM_GATEWAY_BAD_REQUEST\",\n          status,\n          error,\n        );\n      }\n\n      // Not found (404)\n      if (status === 404) {\n        return new LLMGatewayError(\n          `LLM Gateway route not found: The specified model or route does not exist. ` +\n            `Please verify the route alias '${this.modelName}' is correct and provisioned. ` +\n            `Original error: ${originalMessage}`,\n          \"LLM_GATEWAY_NOT_FOUND\",\n          status,\n          error,\n        );\n      }\n\n      // Timeout (408, 504)\n      if (status === 408 || status === 504) {\n        return new LLMGatewayError(\n          `LLM Gateway timeout: The request took too long to complete. ` +\n            `This may be due to high load or a complex request. Please try again. ` +\n            `Original error: ${originalMessage}`,\n          \"LLM_GATEWAY_TIMEOUT\",\n          status,\n          error,\n        );\n      }\n\n      // Server errors (5xx)\n      if (status && status >= 500) {\n        return new LLMGatewayError(\n          `LLM Gateway server error: The LLM provider returned an error (${status}). ` +\n            `This is typically a temporary issue. Please try again later. ` +\n            `Original error: ${originalMessage}`,\n          \"LLM_GATEWAY_SERVER_ERROR\",\n          status,\n          error,\n        );\n      }\n\n      // Other API errors\n      return new LLMGatewayError(\n        `LLM Gateway error (${status}): ${originalMessage}`,\n        \"LLM_GATEWAY_ERROR\",\n        status,\n        error,\n      );\n    }\n\n    // Handle standard Error objects\n    if (error instanceof Error) {\n      const msg = error.message.toLowerCase();\n\n      // Connection errors\n      if (msg.includes(\"econnrefused\") || msg.includes(\"enotfound\") || msg.includes(\"network\")) {\n        return new LLMGatewayError(\n          `LLM Gateway connection failed: Unable to connect to the LLM Gateway at ${this.baseUrl}. ` +\n            `Please verify the gateway is running and accessible. ` +\n            `Original error: ${error.message}`,\n          \"LLM_GATEWAY_CONNECTION_ERROR\",\n          undefined,\n          error,\n        );\n      }\n\n      // Timeout errors\n      if (msg.includes(\"timeout\") || msg.includes(\"timed out\") || msg.includes(\"etimedout\")) {\n        return new LLMGatewayError(\n          `LLM Gateway timeout: The connection timed out. ` +\n            `Please check network connectivity and try again. ` +\n            `Original error: ${error.message}`,\n          \"LLM_GATEWAY_TIMEOUT\",\n          undefined,\n          error,\n        );\n      }\n\n      // Generic Error - preserve original message with context\n      return new LLMGatewayError(\n        `LLM Gateway error: ${error.message}`,\n        \"LLM_GATEWAY_ERROR\",\n        undefined,\n        error,\n      );\n    }\n\n    // Unknown error type\n    return new LLMGatewayError(\n      `LLM Gateway error: An unexpected error occurred. Details: ${String(error)}`,\n      \"LLM_GATEWAY_UNKNOWN_ERROR\",\n      undefined,\n      error,\n    );\n  }\n\n  /**\n   * Extracts the error source from an APIError.\n   * The backend sets X-Error-Source header or includes source in the error body\n   * to differentiate between gateway errors (LLM Gateway API key) and provider errors.\n   *\n   * @returns \"gateway\" if the error is from LLM Gateway authentication,\n   *          \"provider\" if the error is from the upstream LLM provider,\n   *          undefined if the source cannot be determined.\n   */\n  private extractErrorSource(error: APIError): \"gateway\" | \"provider\" | undefined {\n    // Try to get source from response headers\n    const headers = error.headers;\n    if (headers) {\n      const errorSource = headers[\"x-error-source\"] || headers[\"X-Error-Source\"];\n      if (errorSource === \"gateway\" || errorSource === \"provider\") {\n        return errorSource;\n      }\n    }\n\n    // Try to get source from error body\n    // The backend may include { error: { source: \"gateway\" | \"provider\", ... } }\n    const errorBody = error.error as Record<string, unknown> | undefined;\n    if (errorBody && typeof errorBody === \"object\") {\n      // Check for nested error object (OpenAI style)\n      const nestedError = errorBody.error as Record<string, unknown> | undefined;\n      if (nestedError && typeof nestedError === \"object\" && nestedError.source) {\n        const source = nestedError.source;\n        if (source === \"gateway\" || source === \"provider\") {\n          return source;\n        }\n      }\n      // Check for direct source field\n      if (errorBody.source === \"gateway\" || errorBody.source === \"provider\") {\n        return errorBody.source;\n      }\n    }\n\n    // Check error message for gateway-specific patterns\n    const msg = error.message.toLowerCase();\n    if (msg.includes(\"llm gateway api key\") || msg.includes(\"llm gateway\")) {\n      return \"gateway\";\n    }\n\n    return undefined;\n  }\n\n  // ==========================================================================\n  // Helpers (copied from OpenAI provider)\n  // ==========================================================================\n\n  private extractExtraOptions(options?: GenerateOptions): Record<string, any> {\n    if (!options) return {};\n    const { responseFormat, ...rest } = options;\n    return rest;\n  }\n\n  private buildGatewayHeaders(): Record<string, string> {\n    const headers: Record<string, string> = {\n      \"x-request-id\": randomUUID(),\n    };\n\n    const exec = ExecutionContext.getOrUndefined();\n    if (exec?.executionId) {\n      headers[\"x-execution-id\"] = exec.executionId;\n    }\n\n    const ctx = Tracing.getContext();\n    if (ctx) {\n      // IDs já estão em formato W3C (hex)\n      headers.traceparent = `00-${ctx.traceId}-${ctx.spanId}-01`;\n    } else {\n      // Still emit a root trace context so the gateway can correlate requests by traceId.\n      const traceId = randomBytes(16).toString(\"hex\");\n      const spanId = randomBytes(8).toString(\"hex\");\n      headers.traceparent = `00-${traceId}-${spanId}-01`;\n    }\n\n    return headers;\n  }\n\n  protected convertMessages(messages: Message[]): OpenAIClient.Chat.ChatCompletionMessageParam[] {\n    // Ensure tools have a preceding assistant message with tool_calls\n    const allowedToolCallIds = new Set<string>();\n\n    return messages.flatMap((m) => {\n      if (m.role === \"tool\") {\n        // Skip orphan tool messages (no preceding tool_calls)\n        if (!m.tool_call_id || !allowedToolCallIds.has(m.tool_call_id)) {\n          return [];\n        }\n\n        return {\n          role: \"tool\",\n          tool_call_id: m.tool_call_id!,\n          content: typeof m.content === \"string\" ? m.content : JSON.stringify(m.content), // Tool output usually string\n        };\n      }\n\n      if (m.role === \"assistant\") {\n        // OpenAI rules:\n        // - content is required (string | null)\n        // - if tool_calls is present, content can be null\n        // - if tool_calls is NOT present, content must be string (cannot be null/empty if strict, but usually empty string is fine)\n\n        let assistantContent: string | null = null;\n\n        if (typeof m.content === \"string\") {\n          assistantContent = m.content;\n        }\n\n        // If content is null/empty AND no tool_calls, force empty string to avoid API error\n        if (!assistantContent && (!m.tool_calls || m.tool_calls.length === 0)) {\n          assistantContent = \"\";\n        }\n\n        if (m.tool_calls) {\n          m.tool_calls.forEach((tc) => allowedToolCallIds.add(tc.id));\n        }\n\n        return {\n          role: \"assistant\",\n          content: assistantContent,\n          tool_calls: m.tool_calls?.map((tc) => ({\n            id: tc.id,\n            type: \"function\",\n            function: {\n              name: tc.function.name,\n              arguments: tc.function.arguments,\n            },\n          })),\n        };\n      }\n\n      // User / System with potential multimodal content\n      const content: OpenAIClient.Chat.ChatCompletionContentPart[] | string = Array.isArray(\n        m.content,\n      )\n        ? m.content.map((part) => this.convertContentPart(part))\n        : m.content || \"\";\n\n      return {\n        role: m.role as \"system\" | \"user\",\n        content,\n        name: m.name,\n      } as any;\n    });\n  }\n\n  private convertTools(\n    tools?: ToolDefinitionForLLM[],\n  ): OpenAIClient.Chat.ChatCompletionTool[] | undefined {\n    if (!tools || tools.length === 0) return undefined;\n    return tools.map((t) => ({\n      type: \"function\",\n      function: {\n        name: t.function.name,\n        description: t.function.description,\n        parameters: t.function.parameters,\n      },\n    }));\n  }\n\n  private mapUsage(usage?: OpenAIClient.CompletionUsage): TokenUsage | undefined {\n    if (!usage) return undefined;\n    return {\n      promptTokens: usage.prompt_tokens,\n      completionTokens: usage.completion_tokens,\n      totalTokens: usage.total_tokens,\n      reasoningTokens: (usage as any).completion_tokens_details?.reasoning_tokens,\n    };\n  }\n\n  private mapFinishReason(reason: string | null): ProviderResponse[\"finishReason\"] {\n    switch (reason) {\n      case \"stop\":\n        return \"stop\";\n      case \"length\":\n        return \"length\";\n      case \"tool_calls\":\n        return \"tool_calls\";\n      case \"content_filter\":\n        return \"content_filter\";\n      default:\n        return undefined;\n    }\n  }\n\n  private convertContentPart(part: ContentPart): OpenAIClient.Chat.ChatCompletionContentPart {\n    if (part.type === \"text\") return { type: \"text\", text: part.text };\n\n    if (part.type === \"file\") {\n      const { mimeType, source } = part.file;\n      if (!mimeType.startsWith(\"image/\")) {\n        throw new Error(`LLM Gateway: file mimeType '${mimeType}' is not supported yet`);\n      }\n\n      const url = source.type === \"url\" ? source.url : `data:${mimeType};base64,${source.base64}`;\n\n      return { type: \"image_url\", image_url: { url } };\n    }\n\n    if (part.type === \"image_url\") {\n      return { type: \"image_url\", image_url: { url: part.image_url.url } };\n    }\n\n    // Exhaustive check - should never reach here with proper ContentPart\n    const _exhaustive: never = part;\n    throw new Error(`Unsupported content type: ${(_exhaustive as any).type}`);\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import OpenAIClient, { APIError, ClientOptions } from \"openai\";\nimport { randomBytes, randomUUID } from \"node:crypto\";\nimport {\n  IModel,\n  Message,\n  ProviderResponse,\n  StreamChunk,\n  ToolDefinitionForLLM,\n  GenerateOptions,\n  TokenUsage,\n  ContentPart,\n  ConsoleLogger,\n  type LogLevel,\n  ExecutionContext,\n  Tracing,\n} from \"@nebulaos/core\";\nimport { SpanType, type LLMSpanStartData, type LLMSpanEndData } from \"@nebulaos/types\";\n\n/**\n * Custom error class for LLM Gateway errors.\n * Provides clear, actionable error messages for developers.\n */\nexport class LLMGatewayError extends Error {\n  constructor(\n    message: string,\n    public readonly code: string,\n    public readonly status?: number,\n    public readonly cause?: unknown,\n  ) {\n    super(message);\n    this.name = \"LLMGatewayError\";\n  }\n}\n\n/**\n * LLM Gateway Provider Configuration\n */\nexport interface LLMGatewayConfig {\n  /** API Key from NebulaOS */\n  apiKey: string;\n  /** Base URL of the NebulaOS LLM Gateway */\n  baseUrl?: string;\n  /** Route alias (e.g., \"assistente\", \"code-review\") */\n  model: string;\n  /** Logger verbosity for gateway calls */\n  logLevel?: LogLevel;\n  /** Optional OpenAI client options */\n  clientOptions?: ClientOptions;\n  /**\n   * Default model options passed to every generate() call.\n   * Supports provider-specific params like reasoning_effort, temperature, topK, etc.\n   * These can be overridden by options passed directly to generate().\n   */\n  options?: Omit<GenerateOptions, \"responseFormat\">;\n}\n\n/**\n * NebulaOS LLM Gateway Provider\n *\n * Provides access to NebulaOS LLM Gateway routes through an OpenAI-compatible interface.\n * Routes are pre-configured in NebulaOS and provide automatic fallback, cost tracking,\n * and access control.\n */\nexport class LLMGateway implements IModel {\n  providerName = \"llm-gateway\";\n  modelName: string;\n  private client: OpenAIClient;\n  private baseUrl: string;\n  private logger: ConsoleLogger;\n  private options?: Omit<GenerateOptions, \"responseFormat\">;\n\n  capabilities = {\n    inputFiles: {\n      mimeTypes: [\"image/*\"],\n      sources: [\"url\", \"base64\"] as const,\n    },\n  } as const;\n\n  constructor(config: LLMGatewayConfig) {\n    this.modelName = config.model;\n\n    this.baseUrl = config.baseUrl || \"http://localhost:4100\";\n    const baseURL = this.baseUrl.endsWith(\"/v1\") ? this.baseUrl : `${this.baseUrl}/v1`;\n    this.logger = new ConsoleLogger(config.logLevel || \"info\", \"nebulaos/llm-gateway\");\n\n    this.client = new OpenAIClient({\n      apiKey: config.apiKey,\n      baseURL,\n      ...config.clientOptions,\n    });\n    this.options = config.options;\n  }\n\n  async generate(\n    messages: Message[],\n    tools?: ToolDefinitionForLLM[],\n    options?: GenerateOptions,\n  ): Promise<ProviderResponse> {\n    const mergedOptions = { ...this.options, ...options };\n    const model = `route:${this.modelName}`;\n\n    // Prepare context data for tracing (useful for debugging, especially on errors)\n    const messagesPreview = messages.map((m) => ({\n      role: m.role,\n      content: typeof m.content === \"string\"\n        ? m.content.length > 500 ? m.content.slice(0, 500) + \"...\" : m.content\n        : Array.isArray(m.content) ? `[${m.content.length} parts]` : String(m.content),\n    }));\n    const toolsPreview = tools?.map((t) => ({\n      name: t.function.name,\n      description: t.function.description?.slice(0, 200),\n    }));\n\n    // Extract LLM config params (temperature, thinkingLevel, topP, maxTokens, etc)\n    const { responseFormat, ...llmConfig } = mergedOptions ?? {};\n\n    // Typed span start data for LLM calls\n    const startData: LLMSpanStartData = {\n      provider: this.providerName,\n      model: this.modelName,\n      messagesCount: messages.length,\n      toolsCount: tools?.length ?? 0,\n      llmConfig: Object.keys(llmConfig).length > 0 ? llmConfig : undefined,\n      responseFormat,\n      messages: messagesPreview,\n      tools: toolsPreview,\n    };\n\n    return Tracing.withSpan(\n      {\n        kind: SpanType.llm,\n        name: `llm:${this.modelName}`,\n        data: startData,\n      },\n      async (llmSpan) => {\n        const headers = this.buildGatewayHeaders();\n        this.logger.debug(\"LLM Gateway request\", {\n          model,\n          baseUrl: this.baseUrl,\n          stream: false,\n          messageCount: messages.length,\n          toolCount: tools?.length ?? 0,\n        });\n\n        try {\n          // Use .withResponse() to access HTTP headers for backend enrichment data\n          const { data: response, response: httpResponse } = await this.client.chat.completions\n            .create(\n              {\n                model,\n                messages: this.convertMessages(messages),\n                tools: this.convertTools(tools),\n                response_format:\n                  mergedOptions?.responseFormat?.type === \"json\"\n                    ? mergedOptions.responseFormat.schema\n                      ? {\n                          type: \"json_schema\",\n                          json_schema: { name: \"response\", schema: mergedOptions.responseFormat.schema as any },\n                        }\n                      : { type: \"json_object\" }\n                    : undefined,\n                ...this.extractExtraOptions(mergedOptions),\n              },\n              { headers },\n            )\n            .withResponse();\n\n          this.logger.debug(\"LLM Gateway response\", {\n            model,\n            finishReason: response.choices?.[0]?.finish_reason,\n            hasUsage: Boolean(response.usage),\n          });\n\n          const choice = response.choices[0];\n          const message = choice.message;\n          const usage = this.mapUsage(response.usage);\n          const finishReason = this.mapFinishReason(choice.finish_reason);\n\n          // Read enrichment headers from backend (model actual, cost, usage, fallback)\n          const enrichment = this.extractEnrichmentFromHeaders(httpResponse.headers);\n\n          // Typed span end data for LLM calls\n          const endData: LLMSpanEndData = {\n            usage: enrichment.usage ?? usage ?? { promptTokens: 0, completionTokens: 0, totalTokens: 0 },\n            finishReason: finishReason ?? \"stop\",\n            toolCallsCount: message.tool_calls?.length ?? 0,\n            choices: response.choices,\n            model: enrichment.modelActual,\n            fallbackUsed: enrichment.fallbackUsed,\n            cost: enrichment.cost ? parseFloat(enrichment.cost.amountUsd) : undefined,\n          };\n\n          await llmSpan.end({\n            status: \"success\",\n            data: endData,\n          });\n\n          return {\n            content: message.content || \"\",\n            toolCalls: message.tool_calls?.map((tc) => ({\n              id: tc.id,\n              type: \"function\",\n              function: {\n                name: tc.function.name,\n                arguments: tc.function.arguments,\n              },\n            })),\n            finishReason,\n            usage: enrichment.usage ?? usage,\n          };\n        } catch (error) {\n          this.logger.error(\"LLM Gateway request failed\", error, undefined, undefined);\n          const gatewayError = this.handleError(error);\n\n          // Typed span end data for error case\n          const errorEndData: LLMSpanEndData = {\n            error: {\n              message: gatewayError.message,\n              code: gatewayError.code,\n              status: gatewayError.status,\n            },\n          };\n\n          await llmSpan.end({\n            status: \"error\",\n            data: errorEndData,\n          });\n\n          throw gatewayError;\n        }\n      },\n    );\n  }\n\n  async *generateStream(\n    messages: Message[],\n    tools?: ToolDefinitionForLLM[],\n    options?: GenerateOptions,\n  ): AsyncGenerator<StreamChunk> {\n    const mergedOptions = { ...this.options, ...options };\n    const model = `route:${this.modelName}`;\n\n    // Prepare context data for tracing (useful for debugging, especially on errors)\n    const messagesPreview = messages.map((m) => ({\n      role: m.role,\n      content: typeof m.content === \"string\"\n        ? m.content.length > 500 ? m.content.slice(0, 500) + \"...\" : m.content\n        : Array.isArray(m.content) ? `[${m.content.length} parts]` : String(m.content),\n    }));\n    const toolsPreview = tools?.map((t) => ({\n      name: t.function.name,\n      description: t.function.description?.slice(0, 200),\n    }));\n\n    // Extract LLM config params (temperature, thinkingLevel, topP, maxTokens, etc)\n    const { responseFormat, ...llmConfig } = mergedOptions ?? {};\n\n    // Typed span start data for LLM calls\n    const startData: LLMSpanStartData = {\n      provider: this.providerName,\n      model: this.modelName,\n      messagesCount: messages.length,\n      toolsCount: tools?.length ?? 0,\n      llmConfig: Object.keys(llmConfig).length > 0 ? llmConfig : undefined,\n      responseFormat,\n      messages: messagesPreview,\n      tools: toolsPreview,\n    };\n\n    // Start span manually for streaming (async generators can't use withSpan directly)\n    const llmSpan = await Tracing.startSpan({\n      kind: SpanType.llm,\n      name: `llm:${this.modelName}`,\n      data: startData,\n    });\n\n    const headers = this.buildGatewayHeaders();\n    this.logger.debug(\"LLM Gateway stream request\", {\n      model,\n      baseUrl: this.baseUrl,\n      stream: true,\n      messageCount: messages.length,\n      toolCount: tools?.length ?? 0,\n    });\n\n    let stream;\n    try {\n      stream = await this.client.chat.completions.create(\n        {\n          model,\n          messages: this.convertMessages(messages),\n          tools: this.convertTools(tools),\n          stream: true,\n          stream_options: { include_usage: true },\n          response_format:\n            mergedOptions?.responseFormat?.type === \"json\"\n              ? mergedOptions.responseFormat.schema\n                ? {\n                    type: \"json_schema\",\n                    json_schema: { name: \"response\", schema: mergedOptions.responseFormat.schema as any },\n                  }\n                : { type: \"json_object\" }\n              : undefined,\n          ...this.extractExtraOptions(mergedOptions),\n        },\n        { headers },\n      );\n    } catch (error) {\n      this.logger.error(\"LLM Gateway stream request failed\", error, undefined, undefined);\n      const gatewayError = this.handleError(error);\n\n      if (llmSpan) {\n        // Typed span end data for error case\n        const errorEndData: LLMSpanEndData = {\n          error: {\n            message: gatewayError.message,\n            code: gatewayError.code,\n            status: gatewayError.status,\n          },\n        };\n\n        await llmSpan.end({\n          status: \"error\",\n          data: errorEndData,\n        });\n      }\n\n      throw gatewayError;\n    }\n\n    let finalUsage: TokenUsage | undefined;\n    let finalFinishReason: ProviderResponse[\"finishReason\"];\n    let toolCallsCount = 0;\n    let outputPreview = \"\";\n    let finalContent = \"\";\n    const toolCallsAccumulator: Map<number, { id: string; name: string; arguments: string }> = new Map();\n\n    try {\n      for await (const chunk of stream) {\n        if (chunk.usage) {\n          finalUsage = this.mapUsage(chunk.usage);\n          yield {\n            type: \"finish\",\n            reason: \"stop\",\n            usage: finalUsage,\n          };\n        }\n\n        const choice = chunk.choices?.[0];\n        if (!choice) continue;\n\n        if (choice.finish_reason) {\n          finalFinishReason = this.mapFinishReason(choice.finish_reason);\n          yield {\n            type: \"finish\",\n            reason: finalFinishReason,\n          };\n        }\n\n        const delta = choice.delta;\n        if (!delta) continue;\n\n        if (delta.content) {\n          finalContent += delta.content;\n          if (outputPreview.length < 200) {\n            outputPreview += delta.content.slice(0, 200 - outputPreview.length);\n          }\n          yield { type: \"content_delta\", delta: delta.content };\n        }\n\n        if (delta.tool_calls) {\n          for (const tc of delta.tool_calls) {\n            const idx = tc.index;\n            if (tc.id && tc.function?.name) {\n              toolCallsCount++;\n              toolCallsAccumulator.set(idx, { id: tc.id, name: tc.function.name, arguments: \"\" });\n              yield {\n                type: \"tool_call_start\",\n                index: idx,\n                id: tc.id,\n                name: tc.function.name,\n              };\n            }\n\n            if (tc.function?.arguments) {\n              const existing = toolCallsAccumulator.get(idx);\n              if (existing) {\n                existing.arguments += tc.function.arguments;\n              }\n              yield {\n                type: \"tool_call_delta\",\n                index: idx,\n                args: tc.function.arguments,\n              };\n            }\n          }\n        }\n      }\n\n      // Build choices for observability\n      const toolCalls = Array.from(toolCallsAccumulator.values()).map((tc) => ({\n        id: tc.id,\n        type: \"function\" as const,\n        function: { name: tc.name, arguments: tc.arguments },\n      }));\n\n      const choices = [{\n        index: 0,\n        message: {\n          role: \"assistant\" as const,\n          content: finalContent || null,\n          tool_calls: toolCalls.length > 0 ? toolCalls : undefined,\n        },\n        finish_reason: finalFinishReason,\n      }];\n\n      // Typed span end data for success case\n      if (llmSpan) {\n        const endData: LLMSpanEndData = {\n          usage: finalUsage ?? { promptTokens: 0, completionTokens: 0, totalTokens: 0 },\n          finishReason: finalFinishReason ?? \"stop\",\n          toolCallsCount,\n          outputPreview,\n          choices,\n        };\n\n        await llmSpan.end({\n          status: \"success\",\n          data: endData,\n        });\n      }\n    } catch (error) {\n      this.logger.error(\"LLM Gateway stream failed\", error, undefined, undefined);\n      const gatewayError = this.handleError(error);\n\n      if (llmSpan) {\n        // Typed span end data for error case\n        const errorEndData: LLMSpanEndData = {\n          error: {\n            message: gatewayError.message,\n            code: gatewayError.code,\n            status: gatewayError.status,\n          },\n        };\n\n        await llmSpan.end({\n          status: \"error\",\n          data: errorEndData,\n        });\n      }\n\n      throw gatewayError;\n    }\n  }\n\n  // ==========================================================================\n  // Error Handling\n  // ==========================================================================\n\n  /**\n   * Transforms raw errors into actionable LLMGatewayError with clear messages.\n   * This ensures developers get specific guidance on how to resolve issues.\n   *\n   * Differentiates between:\n   * - Gateway errors: LLM Gateway API key issues (check NEBULAOS_API_KEY env var)\n   * - Provider errors: LLM provider API key issues (check route config in dashboard)\n   */\n  private handleError(error: unknown): LLMGatewayError {\n    // Handle OpenAI SDK APIError (includes status, message, code)\n    if (error instanceof APIError) {\n      const status = error.status;\n      const originalMessage = error.message;\n\n      // Check X-Error-Source header to differentiate gateway vs provider errors\n      const errorSource = this.extractErrorSource(error);\n\n      // Authentication errors (401)\n      if (status === 401) {\n        if (errorSource === \"gateway\") {\n          return new LLMGatewayError(\n            `LLM Gateway authentication failed: Your LLM Gateway API key is invalid or expired. ` +\n              `Please verify your NEBULAOS_API_KEY environment variable or check your LLM Gateway API key in the NebulaOS dashboard. ` +\n              `Original error: ${originalMessage}`,\n            \"GATEWAY_AUTH_ERROR\",\n            status,\n            error,\n          );\n        } else {\n          // Provider error (default for 401 without explicit gateway source)\n          return new LLMGatewayError(\n            `LLM Provider authentication failed: The API key configured for your LLM provider (OpenAI, Azure, etc.) is invalid or expired. ` +\n              `Please verify the provider API key in your route configuration in the NebulaOS dashboard. ` +\n              `Original error: ${originalMessage}`,\n            \"PROVIDER_AUTH_ERROR\",\n            status,\n            error,\n          );\n        }\n      }\n\n      // Permission denied (403)\n      if (status === 403) {\n        if (errorSource === \"gateway\") {\n          return new LLMGatewayError(\n            `LLM Gateway access denied: Your LLM Gateway API key does not have permission to access this route. ` +\n              `Please verify the route is allowed for your LLM Gateway API key in the NebulaOS dashboard. ` +\n              `Original error: ${originalMessage}`,\n            \"GATEWAY_FORBIDDEN\",\n            status,\n            error,\n          );\n        } else {\n          return new LLMGatewayError(\n            `LLM Provider access denied: The provider API key does not have permission for this operation. ` +\n              `Please verify the provider API key permissions in the NebulaOS dashboard. ` +\n              `Original error: ${originalMessage}`,\n            \"PROVIDER_FORBIDDEN\",\n            status,\n            error,\n          );\n        }\n      }\n\n      // Rate limit (429)\n      if (status === 429) {\n        return new LLMGatewayError(\n          `LLM Gateway rate limit exceeded: Too many requests to the LLM provider. ` +\n            `Please wait before retrying or check your rate limit configuration. ` +\n            `Original error: ${originalMessage}`,\n          \"LLM_GATEWAY_RATE_LIMIT\",\n          status,\n          error,\n        );\n      }\n\n      // Bad request (400)\n      if (status === 400) {\n        return new LLMGatewayError(\n          `LLM Gateway request error: Invalid request parameters. ` +\n            `Please check your request configuration (model, messages, tools). ` +\n            `Original error: ${originalMessage}`,\n          \"LLM_GATEWAY_BAD_REQUEST\",\n          status,\n          error,\n        );\n      }\n\n      // Not found (404)\n      if (status === 404) {\n        return new LLMGatewayError(\n          `LLM Gateway route not found: The specified model or route does not exist. ` +\n            `Please verify the route alias '${this.modelName}' is correct and provisioned. ` +\n            `Original error: ${originalMessage}`,\n          \"LLM_GATEWAY_NOT_FOUND\",\n          status,\n          error,\n        );\n      }\n\n      // Timeout (408, 504)\n      if (status === 408 || status === 504) {\n        return new LLMGatewayError(\n          `LLM Gateway timeout: The request took too long to complete. ` +\n            `This may be due to high load or a complex request. Please try again. ` +\n            `Original error: ${originalMessage}`,\n          \"LLM_GATEWAY_TIMEOUT\",\n          status,\n          error,\n        );\n      }\n\n      // Server errors (5xx)\n      if (status && status >= 500) {\n        return new LLMGatewayError(\n          `LLM Gateway server error: The LLM provider returned an error (${status}). ` +\n            `This is typically a temporary issue. Please try again later. ` +\n            `Original error: ${originalMessage}`,\n          \"LLM_GATEWAY_SERVER_ERROR\",\n          status,\n          error,\n        );\n      }\n\n      // Other API errors\n      return new LLMGatewayError(\n        `LLM Gateway error (${status}): ${originalMessage}`,\n        \"LLM_GATEWAY_ERROR\",\n        status,\n        error,\n      );\n    }\n\n    // Handle standard Error objects\n    if (error instanceof Error) {\n      const msg = error.message.toLowerCase();\n\n      // Connection errors\n      if (msg.includes(\"econnrefused\") || msg.includes(\"enotfound\") || msg.includes(\"network\")) {\n        return new LLMGatewayError(\n          `LLM Gateway connection failed: Unable to connect to the LLM Gateway at ${this.baseUrl}. ` +\n            `Please verify the gateway is running and accessible. ` +\n            `Original error: ${error.message}`,\n          \"LLM_GATEWAY_CONNECTION_ERROR\",\n          undefined,\n          error,\n        );\n      }\n\n      // Timeout errors\n      if (msg.includes(\"timeout\") || msg.includes(\"timed out\") || msg.includes(\"etimedout\")) {\n        return new LLMGatewayError(\n          `LLM Gateway timeout: The connection timed out. ` +\n            `Please check network connectivity and try again. ` +\n            `Original error: ${error.message}`,\n          \"LLM_GATEWAY_TIMEOUT\",\n          undefined,\n          error,\n        );\n      }\n\n      // Generic Error - preserve original message with context\n      return new LLMGatewayError(\n        `LLM Gateway error: ${error.message}`,\n        \"LLM_GATEWAY_ERROR\",\n        undefined,\n        error,\n      );\n    }\n\n    // Unknown error type\n    return new LLMGatewayError(\n      `LLM Gateway error: An unexpected error occurred. Details: ${String(error)}`,\n      \"LLM_GATEWAY_UNKNOWN_ERROR\",\n      undefined,\n      error,\n    );\n  }\n\n  /**\n   * Extracts the error source from an APIError.\n   * The backend sets X-Error-Source header or includes source in the error body\n   * to differentiate between gateway errors (LLM Gateway API key) and provider errors.\n   *\n   * @returns \"gateway\" if the error is from LLM Gateway authentication,\n   *          \"provider\" if the error is from the upstream LLM provider,\n   *          undefined if the source cannot be determined.\n   */\n  private extractErrorSource(error: APIError): \"gateway\" | \"provider\" | undefined {\n    // Try to get source from response headers\n    const headers = error.headers;\n    if (headers) {\n      const errorSource = headers[\"x-error-source\"] || headers[\"X-Error-Source\"];\n      if (errorSource === \"gateway\" || errorSource === \"provider\") {\n        return errorSource;\n      }\n    }\n\n    // Try to get source from error body\n    // The backend may include { error: { source: \"gateway\" | \"provider\", ... } }\n    const errorBody = error.error as Record<string, unknown> | undefined;\n    if (errorBody && typeof errorBody === \"object\") {\n      // Check for nested error object (OpenAI style)\n      const nestedError = errorBody.error as Record<string, unknown> | undefined;\n      if (nestedError && typeof nestedError === \"object\" && nestedError.source) {\n        const source = nestedError.source;\n        if (source === \"gateway\" || source === \"provider\") {\n          return source;\n        }\n      }\n      // Check for direct source field\n      if (errorBody.source === \"gateway\" || errorBody.source === \"provider\") {\n        return errorBody.source;\n      }\n    }\n\n    // Check error message for gateway-specific patterns\n    const msg = error.message.toLowerCase();\n    if (msg.includes(\"llm gateway api key\") || msg.includes(\"llm gateway\")) {\n      return \"gateway\";\n    }\n\n    return undefined;\n  }\n\n  // ==========================================================================\n  // Helpers (copied from OpenAI provider)\n  // ==========================================================================\n\n  private extractExtraOptions(options?: GenerateOptions): Record<string, any> {\n    if (!options) return {};\n    const { responseFormat, ...rest } = options;\n    return rest;\n  }\n\n  private buildGatewayHeaders(): Record<string, string> {\n    const headers: Record<string, string> = {\n      \"x-request-id\": randomUUID(),\n    };\n\n    const exec = ExecutionContext.getOrUndefined();\n    if (exec?.executionId) {\n      headers[\"x-execution-id\"] = exec.executionId;\n    }\n\n    const ctx = Tracing.getContext();\n    if (ctx) {\n      // IDs já estão em formato W3C (hex)\n      headers.traceparent = `00-${ctx.traceId}-${ctx.spanId}-01`;\n    } else {\n      // Still emit a root trace context so the gateway can correlate requests by traceId.\n      const traceId = randomBytes(16).toString(\"hex\");\n      const spanId = randomBytes(8).toString(\"hex\");\n      headers.traceparent = `00-${traceId}-${spanId}-01`;\n    }\n\n    return headers;\n  }\n\n  /**\n   * Extracts enrichment data from backend HTTP headers.\n   * Backend returns this data so SDK can enrich its own span (avoiding duplicate spans).\n   */\n  private extractEnrichmentFromHeaders(headers: Headers): {\n    modelActual?: string;\n    fallbackUsed?: boolean;\n    usage?: TokenUsage;\n    cost?: { amountUsd: string; available: boolean };\n  } {\n    const result: ReturnType<typeof this.extractEnrichmentFromHeaders> = {};\n\n    const modelActual = headers.get(\"x-llm-model-actual\");\n    if (modelActual) {\n      result.modelActual = modelActual;\n    }\n\n    const fallbackUsed = headers.get(\"x-llm-fallback-used\");\n    if (fallbackUsed) {\n      result.fallbackUsed = fallbackUsed === \"true\";\n    }\n\n    const usageRaw = headers.get(\"x-llm-usage\");\n    if (usageRaw) {\n      try {\n        const usage = JSON.parse(usageRaw);\n        result.usage = {\n          promptTokens: usage.prompt_tokens,\n          completionTokens: usage.completion_tokens,\n          totalTokens: usage.total_tokens,\n          reasoningTokens: usage.completion_tokens_details?.reasoning_tokens,\n          // Preserve any additional token fields from provider\n          ...usage,\n        };\n      } catch {\n        this.logger.warn(\"Failed to parse x-llm-usage header\", { usageRaw });\n      }\n    }\n\n    const cost = headers.get(\"x-llm-cost\");\n    const costAvailable = headers.get(\"x-llm-cost-available\");\n    if (cost) {\n      result.cost = {\n        amountUsd: cost,\n        available: costAvailable === \"true\",\n      };\n    }\n\n    return result;\n  }\n\n  protected convertMessages(messages: Message[]): OpenAIClient.Chat.ChatCompletionMessageParam[] {\n    // Ensure tools have a preceding assistant message with tool_calls\n    const allowedToolCallIds = new Set<string>();\n\n    return messages.flatMap((m) => {\n      if (m.role === \"tool\") {\n        // Skip orphan tool messages (no preceding tool_calls)\n        if (!m.tool_call_id || !allowedToolCallIds.has(m.tool_call_id)) {\n          return [];\n        }\n\n        return {\n          role: \"tool\",\n          tool_call_id: m.tool_call_id!,\n          content: typeof m.content === \"string\" ? m.content : JSON.stringify(m.content), // Tool output usually string\n        };\n      }\n\n      if (m.role === \"assistant\") {\n        // OpenAI rules:\n        // - content is required (string | null)\n        // - if tool_calls is present, content can be null\n        // - if tool_calls is NOT present, content must be string (cannot be null/empty if strict, but usually empty string is fine)\n\n        let assistantContent: string | null = null;\n\n        if (typeof m.content === \"string\") {\n          assistantContent = m.content;\n        }\n\n        // If content is null/empty AND no tool_calls, force empty string to avoid API error\n        if (!assistantContent && (!m.tool_calls || m.tool_calls.length === 0)) {\n          assistantContent = \"\";\n        }\n\n        if (m.tool_calls) {\n          m.tool_calls.forEach((tc) => allowedToolCallIds.add(tc.id));\n        }\n\n        return {\n          role: \"assistant\",\n          content: assistantContent,\n          tool_calls: m.tool_calls?.map((tc) => ({\n            id: tc.id,\n            type: \"function\",\n            function: {\n              name: tc.function.name,\n              arguments: tc.function.arguments,\n            },\n          })),\n        };\n      }\n\n      // User / System with potential multimodal content\n      const content: OpenAIClient.Chat.ChatCompletionContentPart[] | string = Array.isArray(\n        m.content,\n      )\n        ? m.content.map((part) => this.convertContentPart(part))\n        : m.content || \"\";\n\n      return {\n        role: m.role as \"system\" | \"user\",\n        content,\n        name: m.name,\n      } as any;\n    });\n  }\n\n  private convertTools(\n    tools?: ToolDefinitionForLLM[],\n  ): OpenAIClient.Chat.ChatCompletionTool[] | undefined {\n    if (!tools || tools.length === 0) return undefined;\n    return tools.map((t) => ({\n      type: \"function\",\n      function: {\n        name: t.function.name,\n        description: t.function.description,\n        parameters: t.function.parameters,\n      },\n    }));\n  }\n\n  private mapUsage(usage?: OpenAIClient.CompletionUsage): TokenUsage | undefined {\n    if (!usage) return undefined;\n    return {\n      promptTokens: usage.prompt_tokens,\n      completionTokens: usage.completion_tokens,\n      totalTokens: usage.total_tokens,\n      reasoningTokens: (usage as any).completion_tokens_details?.reasoning_tokens,\n    };\n  }\n\n  private mapFinishReason(reason: string | null): ProviderResponse[\"finishReason\"] {\n    switch (reason) {\n      case \"stop\":\n        return \"stop\";\n      case \"length\":\n        return \"length\";\n      case \"tool_calls\":\n        return \"tool_calls\";\n      case \"content_filter\":\n        return \"content_filter\";\n      default:\n        return undefined;\n    }\n  }\n\n  private convertContentPart(part: ContentPart): OpenAIClient.Chat.ChatCompletionContentPart {\n    if (part.type === \"text\") return { type: \"text\", text: part.text };\n\n    if (part.type === \"file\") {\n      const { mimeType, source } = part.file;\n      if (!mimeType.startsWith(\"image/\")) {\n        throw new Error(`LLM Gateway: file mimeType '${mimeType}' is not supported yet`);\n      }\n\n      const url = source.type === \"url\" ? source.url : `data:${mimeType};base64,${source.base64}`;\n\n      return { type: \"image_url\", image_url: { url } };\n    }\n\n    if (part.type === \"image_url\") {\n      return { type: \"image_url\", image_url: { url: part.image_url.url } };\n    }\n\n    // Exhaustive check - should never reach here with proper ContentPart\n    const _exhaustive: never = part;\n    throw new Error(`Unsupported content type: ${(_exhaustive as any).type}`);\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nebulaos/llm-gateway",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "NebulaOS LLM Gateway provider - OpenAI-compatible chat completions",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -27,7 +27,8 @@
   },
   "dependencies": {
     "openai": "^4.52.7",
-    "@nebulaos/core": "^0.2.4"
+    "@nebulaos/core": "^0.2.5",
+    "@nebulaos/types": "^0.1.4"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",