@agentionai/agents 1.3.0 → 1.4.0

package/dist/agents/AgentConfig.d.ts

@@ -16,6 +16,27 @@ export interface CommonAgentConfig {
     description: string;
     /** API key for authenticating with the LLM provider */
     apiKey: string;
+    /**
+     * Extra HTTP headers sent with every request to the provider.
+     *
+     * Useful for gateway and proxy attribution, tracing, or corporate egress
+     * requirements. OpenRouter, for example, uses `HTTP-Referer` and `X-Title`
+     * to attribute traffic to your app:
+     *
+     * ```typescript
+     * defaultHeaders: {
+     *   "HTTP-Referer": "https://myapp.example",
+     *   "X-Title": "My App",
+     * }
+     * ```
+     *
+     * These override headers the agent would otherwise set, including
+     * `Authorization` / `x-api-key`. That follows the Anthropic and OpenAI SDKs'
+     * own `defaultHeaders` behaviour and is deliberate — it lets a gateway swap
+     * in its own auth scheme. The flip side is that setting an auth header here
+     * replaces `apiKey`, so do it only when that is what you mean.
+     */
+    defaultHeaders?: Record<string, string>;
     /** Enable debug logging for troubleshooting (default: false) */
     debug?: boolean;
     /** Maximum number of messages to retain in conversation history */

package/dist/agents/anthropic/ClaudeAgent.js

@@ -40,8 +40,8 @@ class ClaudeAgent extends BaseAgent_1.BaseAgent {
         const authType = config.authType ?? vendorConfig.authType ?? "apiKey";
         const thinkingBudgetTokens = config.thinkingBudgetTokens ?? vendorConfig.thinkingBudgetTokens;
         this.client = new sdk_1.Anthropic(authType === "oauth"
-            ? { authToken: config.apiKey }
-            : { apiKey: config.apiKey });
+            ? { authToken: config.apiKey, defaultHeaders: config.defaultHeaders }
+            : { apiKey: config.apiKey, defaultHeaders: config.defaultHeaders });
         this.config = {
             model: config.model || "claude-haiku-4-5",
             maxTokens: config.maxTokens || 1024,

package/dist/agents/google/GeminiAgent.js

@@ -47,9 +47,7 @@ class GeminiAgent extends BaseAgent_1.BaseAgent {
             responseSchema,
         };
         // Initialize the model
-        this.generativeModel = this.client.getGenerativeModel({
-            model: this.config.model,
-        });
+        this.generativeModel = this.client.getGenerativeModel({ model: this.config.model }, config.defaultHeaders ? { customHeaders: config.defaultHeaders } : undefined);
         // Add system message to history (skips if already exists with same content)
         this.addSystemMessage(this.getSystemMessage());
     }

package/dist/agents/mistral/MistralAgent.d.ts

@@ -26,6 +26,16 @@ type AgentConfig = BaseAgentConfig & {
  * const response = await agent.execute("Hello!");
  * ```
  */
+/**
+ * Build a `beforeRequest` hook that adds custom headers to every request.
+ *
+ * The Mistral SDK has no `defaultHeaders` option like the Anthropic and OpenAI
+ * clients, so headers are injected at the HTTP layer instead. They overwrite
+ * headers the SDK already set, so that `defaultHeaders` means the same thing on
+ * every provider — see `CommonAgentConfig.defaultHeaders`. Verified against the
+ * OpenAI SDK on the wire: its `defaultHeaders` win over the client's own auth.
+ */
+export declare function defaultHeadersHook(headers: Record<string, string>): (request: Request) => void;
 export declare class MistralAgent extends BaseAgent {
     private client;
     protected config: Partial<AgentConfig>;

package/dist/agents/mistral/MistralAgent.js

@@ -1,7 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MistralAgent = void 0;
+exports.defaultHeadersHook = defaultHeadersHook;
 const mistralai_1 = require("@mistralai/mistralai");
+const http_1 = require("@mistralai/mistralai/lib/http");
 const BaseAgent_1 = require("../BaseAgent");
 const AgentEvent_1 = require("../AgentEvent");
 const AgentError_1 = require("../errors/AgentError");
@@ -25,13 +27,34 @@ const VizConfig_1 = require("../../viz/VizConfig");
  * const response = await agent.execute("Hello!");
  * ```
  */
+/**
+ * Build a `beforeRequest` hook that adds custom headers to every request.
+ *
+ * The Mistral SDK has no `defaultHeaders` option like the Anthropic and OpenAI
+ * clients, so headers are injected at the HTTP layer instead. They overwrite
+ * headers the SDK already set, so that `defaultHeaders` means the same thing on
+ * every provider — see `CommonAgentConfig.defaultHeaders`. Verified against the
+ * OpenAI SDK on the wire: its `defaultHeaders` win over the client's own auth.
+ */
+function defaultHeadersHook(headers) {
+    return (request) => {
+        for (const [name, value] of Object.entries(headers)) {
+            request.headers.set(name, value);
+        }
+    };
+}
 class MistralAgent extends BaseAgent_1.BaseAgent {
     constructor(config, history) {
         super({ ...config, vendor: "mistral" }, history);
         /** Count of tool calls in current execution */
         this.currentToolCallCount = 0;
+        const httpClient = new http_1.HTTPClient();
+        if (config.defaultHeaders) {
+            httpClient.addHook("beforeRequest", defaultHeadersHook(config.defaultHeaders));
+        }
         this.client = new mistralai_1.Mistral({
             apiKey: config.apiKey,
+            httpClient,
         });
         // Merge flat config (deprecated) with nested vendorConfig
         // Flat config takes precedence for backward compatibility

package/dist/agents/ollama/OllamaAgent.js

@@ -80,6 +80,7 @@ class OllamaAgent extends BaseAgent_1.BaseAgent {
         this.config = {
             model: config.model || "llama3.2",
             host,
+            defaultHeaders: config.defaultHeaders,
             maxTokens: config.maxTokens,
             temperature: config.temperature,
             topP: config.topP,
@@ -99,7 +100,10 @@ class OllamaAgent extends BaseAgent_1.BaseAgent {
                 if (!OllamaClass) {
                     throw new Error("Could not find Ollama class in ollama package");
                 }
-                this._client = new OllamaClass({ host: this.config.host });
+                this._client = new OllamaClass({
+                    host: this.config.host,
+                    headers: this.config.defaultHeaders,
+                });
             }
             catch (err) {
                 throw new AgentError_1.ExecutionError(`Failed to load 'ollama' package. Install it with: npm install ollama\n${err instanceof Error ? err.message : String(err)}`);

package/dist/agents/openai/OpenAiAgent.js

@@ -58,6 +58,7 @@ class OpenAiAgent extends BaseAgent_1.BaseAgent {
         this.currentToolCallCount = 0;
         this.client = new openai_1.default({
             apiKey: config.apiKey,
+            defaultHeaders: config.defaultHeaders,
         });
         // Merge flat config (deprecated) with nested vendorConfig
         // Flat config takes precedence for backward compatibility

package/dist/agents/openai-compatible/OpenAICompatibleAgent.js

@@ -28,6 +28,7 @@ class OpenAICompatibleAgent extends BaseAgent_1.BaseAgent {
         this.client = new openai_1.default({
             apiKey: config.apiKey || "not-needed",
             baseURL: config.baseURL,
+            defaultHeaders: config.defaultHeaders,
         });
         this.config = {
             model: config.model,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@agentionai/agents",
   "author": "Laurent Zuijdwijk",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "Agent Library",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",