@antipopp/agno-client 0.6.1 → 0.7.0

package/dist/index.js

@@ -238,6 +238,18 @@ var ConfigManager = class {
   setUserId(userId) {
     this.updateField("userId", userId);
   }
+  /**
+   * Get custom headers
+   */
+  getHeaders() {
+    return this.config.headers;
+  }
+  /**
+   * Set custom headers
+   */
+  setHeaders(headers) {
+    this.updateField("headers", headers);
+  }
   /**
    * Get current entity ID (agent or team based on mode)
    */
@@ -260,6 +272,31 @@ var ConfigManager = class {
       return `${endpoint}/agents/${encodedEntityId}/runs`;
     }
   }
+  /**
+   * Build request headers by merging global headers, per-request headers, and auth token.
+   * Merge order (lowest to highest precedence):
+   * 1. Global headers from config
+   * 2. Per-request headers (overrides global)
+   * 3. Authorization header from authToken (overrides all)
+   *
+   * @param perRequestHeaders - Optional headers for this specific request
+   * @returns Merged headers object ready for fetch
+   */
+  buildRequestHeaders(perRequestHeaders) {
+    const headers = {};
+    const globalHeaders = this.getHeaders();
+    if (globalHeaders) {
+      Object.assign(headers, globalHeaders);
+    }
+    if (perRequestHeaders) {
+      Object.assign(headers, perRequestHeaders);
+    }
+    const authToken = this.getAuthToken();
+    if (authToken) {
+      headers["Authorization"] = `Bearer ${authToken}`;
+    }
+    return headers;
+  }
 };
 
 // src/managers/session-manager.ts
@@ -267,15 +304,11 @@ var SessionManager = class {
   /**
    * Fetch all sessions for an entity
    */
-  async fetchSessions(endpoint, entityType, entityId, dbId, authToken) {
+  async fetchSessions(endpoint, entityType, entityId, dbId, headers) {
     const url = new URL(`${endpoint}/sessions`);
     url.searchParams.set("type", entityType);
     url.searchParams.set("component_id", entityId);
     url.searchParams.set("db_id", dbId);
-    const headers = {};
-    if (authToken) {
-      headers["Authorization"] = `Bearer ${authToken}`;
-    }
     const response = await fetch(url.toString(), { headers });
     if (!response.ok) {
       if (response.status === 404) {
@@ -290,16 +323,12 @@ var SessionManager = class {
    * Fetch a specific session's runs
    * Returns an array of RunSchema directly (not wrapped in { data, meta })
    */
-  async fetchSession(endpoint, entityType, sessionId, dbId, authToken) {
+  async fetchSession(endpoint, entityType, sessionId, dbId, headers) {
     const url = new URL(`${endpoint}/sessions/${sessionId}/runs`);
     url.searchParams.set("type", entityType);
     if (dbId) {
       url.searchParams.set("db_id", dbId);
     }
-    const headers = {};
-    if (authToken) {
-      headers["Authorization"] = `Bearer ${authToken}`;
-    }
     const response = await fetch(url.toString(), { headers });
     if (!response.ok) {
       throw new Error(`Failed to fetch session: ${response.statusText}`);
@@ -309,15 +338,11 @@ var SessionManager = class {
   /**
    * Delete a session
    */
-  async deleteSession(endpoint, sessionId, dbId, authToken) {
+  async deleteSession(endpoint, sessionId, dbId, headers) {
     const url = new URL(`${endpoint}/sessions/${sessionId}`);
     if (dbId) {
       url.searchParams.set("db_id", dbId);
     }
-    const headers = {};
-    if (authToken) {
-      headers["Authorization"] = `Bearer ${authToken}`;
-    }
     const response = await fetch(url.toString(), {
       method: "DELETE",
       headers
@@ -928,11 +953,7 @@ var AgnoClient = class extends import_eventemitter3.default {
       if (userId) {
         formData.append("user_id", userId);
       }
-      const headers = { ...options?.headers };
-      const authToken = this.configManager.getAuthToken();
-      if (authToken) {
-        headers["Authorization"] = `Bearer ${authToken}`;
-      }
+      const headers = this.configManager.buildRequestHeaders(options?.headers);
       await streamResponse({
         apiUrl: runUrl,
         headers,
@@ -1047,12 +1068,13 @@ var AgnoClient = class extends import_eventemitter3.default {
     const entityType = this.configManager.getMode();
     const dbId = this.configManager.getDbId() || "";
     Logger.debug("[AgnoClient] Loading session with:", { entityType, dbId });
+    const headers = this.configManager.buildRequestHeaders();
     const response = await this.sessionManager.fetchSession(
       config.endpoint,
       entityType,
       sessionId,
       dbId,
-      config.authToken
+      headers
     );
     const messages = this.sessionManager.convertSessionToMessages(response);
     Logger.debug("[AgnoClient] Setting messages to store:", `${messages.length} messages`);
@@ -1076,12 +1098,13 @@ var AgnoClient = class extends import_eventemitter3.default {
     if (!entityId) {
       throw new Error("Entity ID must be configured");
     }
+    const headers = this.configManager.buildRequestHeaders();
     const sessions = await this.sessionManager.fetchSessions(
       config.endpoint,
       entityType,
       entityId,
       dbId,
-      config.authToken
+      headers
     );
     this.state.sessions = sessions;
     this.emit("state:change", this.getState());
@@ -1093,11 +1116,12 @@ var AgnoClient = class extends import_eventemitter3.default {
   async deleteSession(sessionId) {
     const config = this.configManager.getConfig();
     const dbId = this.configManager.getDbId() || "";
+    const headers = this.configManager.buildRequestHeaders();
     await this.sessionManager.deleteSession(
       config.endpoint,
       sessionId,
       dbId,
-      config.authToken
+      headers
     );
     this.state.sessions = this.state.sessions.filter(
       (s) => s.session_id !== sessionId
@@ -1248,11 +1272,7 @@ var AgnoClient = class extends import_eventemitter3.default {
     if (userId) {
       formData.append("user_id", userId);
     }
-    const headers = { ...options?.headers };
-    const authToken = this.configManager.getAuthToken();
-    if (authToken) {
-      headers["Authorization"] = `Bearer ${authToken}`;
-    }
+    const headers = this.configManager.buildRequestHeaders(options?.headers);
     try {
       await streamResponse({
         apiUrl: continueUrl,
@@ -1285,7 +1305,8 @@ var AgnoClient = class extends import_eventemitter3.default {
    */
   async checkStatus() {
     try {
-      const response = await fetch(`${this.configManager.getEndpoint()}/health`);
+      const headers = this.configManager.buildRequestHeaders();
+      const response = await fetch(`${this.configManager.getEndpoint()}/health`, { headers });
       const isActive = response.ok;
       this.state.isEndpointActive = isActive;
       this.emit("state:change", this.getState());
@@ -1300,12 +1321,8 @@ var AgnoClient = class extends import_eventemitter3.default {
    * Fetch agents from endpoint
    */
   async fetchAgents() {
-    const config = this.configManager.getConfig();
-    const headers = {};
-    if (config.authToken) {
-      headers["Authorization"] = `Bearer ${config.authToken}`;
-    }
-    const response = await fetch(`${config.endpoint}/agents`, { headers });
+    const headers = this.configManager.buildRequestHeaders();
+    const response = await fetch(`${this.configManager.getEndpoint()}/agents`, { headers });
     if (!response.ok) {
       throw new Error("Failed to fetch agents");
     }
@@ -1318,12 +1335,8 @@ var AgnoClient = class extends import_eventemitter3.default {
    * Fetch teams from endpoint
    */
   async fetchTeams() {
-    const config = this.configManager.getConfig();
-    const headers = {};
-    if (config.authToken) {
-      headers["Authorization"] = `Bearer ${config.authToken}`;
-    }
-    const response = await fetch(`${config.endpoint}/teams`, { headers });
+    const headers = this.configManager.buildRequestHeaders();
+    const response = await fetch(`${this.configManager.getEndpoint()}/teams`, { headers });
     if (!response.ok) {
       throw new Error("Failed to fetch teams");
     }

package/dist/index.mjs

@@ -200,6 +200,18 @@ var ConfigManager = class {
   setUserId(userId) {
     this.updateField("userId", userId);
   }
+  /**
+   * Get custom headers
+   */
+  getHeaders() {
+    return this.config.headers;
+  }
+  /**
+   * Set custom headers
+   */
+  setHeaders(headers) {
+    this.updateField("headers", headers);
+  }
   /**
    * Get current entity ID (agent or team based on mode)
    */
@@ -222,6 +234,31 @@ var ConfigManager = class {
       return `${endpoint}/agents/${encodedEntityId}/runs`;
     }
   }
+  /**
+   * Build request headers by merging global headers, per-request headers, and auth token.
+   * Merge order (lowest to highest precedence):
+   * 1. Global headers from config
+   * 2. Per-request headers (overrides global)
+   * 3. Authorization header from authToken (overrides all)
+   *
+   * @param perRequestHeaders - Optional headers for this specific request
+   * @returns Merged headers object ready for fetch
+   */
+  buildRequestHeaders(perRequestHeaders) {
+    const headers = {};
+    const globalHeaders = this.getHeaders();
+    if (globalHeaders) {
+      Object.assign(headers, globalHeaders);
+    }
+    if (perRequestHeaders) {
+      Object.assign(headers, perRequestHeaders);
+    }
+    const authToken = this.getAuthToken();
+    if (authToken) {
+      headers["Authorization"] = `Bearer ${authToken}`;
+    }
+    return headers;
+  }
 };
 
 // src/managers/session-manager.ts
@@ -229,15 +266,11 @@ var SessionManager = class {
   /**
    * Fetch all sessions for an entity
    */
-  async fetchSessions(endpoint, entityType, entityId, dbId, authToken) {
+  async fetchSessions(endpoint, entityType, entityId, dbId, headers) {
     const url = new URL(`${endpoint}/sessions`);
     url.searchParams.set("type", entityType);
     url.searchParams.set("component_id", entityId);
     url.searchParams.set("db_id", dbId);
-    const headers = {};
-    if (authToken) {
-      headers["Authorization"] = `Bearer ${authToken}`;
-    }
     const response = await fetch(url.toString(), { headers });
     if (!response.ok) {
       if (response.status === 404) {
@@ -252,16 +285,12 @@ var SessionManager = class {
    * Fetch a specific session's runs
    * Returns an array of RunSchema directly (not wrapped in { data, meta })
    */
-  async fetchSession(endpoint, entityType, sessionId, dbId, authToken) {
+  async fetchSession(endpoint, entityType, sessionId, dbId, headers) {
     const url = new URL(`${endpoint}/sessions/${sessionId}/runs`);
     url.searchParams.set("type", entityType);
     if (dbId) {
       url.searchParams.set("db_id", dbId);
     }
-    const headers = {};
-    if (authToken) {
-      headers["Authorization"] = `Bearer ${authToken}`;
-    }
     const response = await fetch(url.toString(), { headers });
     if (!response.ok) {
       throw new Error(`Failed to fetch session: ${response.statusText}`);
@@ -271,15 +300,11 @@ var SessionManager = class {
   /**
    * Delete a session
    */
-  async deleteSession(endpoint, sessionId, dbId, authToken) {
+  async deleteSession(endpoint, sessionId, dbId, headers) {
     const url = new URL(`${endpoint}/sessions/${sessionId}`);
     if (dbId) {
       url.searchParams.set("db_id", dbId);
     }
-    const headers = {};
-    if (authToken) {
-      headers["Authorization"] = `Bearer ${authToken}`;
-    }
     const response = await fetch(url.toString(), {
       method: "DELETE",
       headers
@@ -890,11 +915,7 @@ var AgnoClient = class extends EventEmitter {
       if (userId) {
         formData.append("user_id", userId);
       }
-      const headers = { ...options?.headers };
-      const authToken = this.configManager.getAuthToken();
-      if (authToken) {
-        headers["Authorization"] = `Bearer ${authToken}`;
-      }
+      const headers = this.configManager.buildRequestHeaders(options?.headers);
       await streamResponse({
         apiUrl: runUrl,
         headers,
@@ -1009,12 +1030,13 @@ var AgnoClient = class extends EventEmitter {
     const entityType = this.configManager.getMode();
     const dbId = this.configManager.getDbId() || "";
     Logger.debug("[AgnoClient] Loading session with:", { entityType, dbId });
+    const headers = this.configManager.buildRequestHeaders();
     const response = await this.sessionManager.fetchSession(
       config.endpoint,
       entityType,
       sessionId,
       dbId,
-      config.authToken
+      headers
     );
     const messages = this.sessionManager.convertSessionToMessages(response);
     Logger.debug("[AgnoClient] Setting messages to store:", `${messages.length} messages`);
@@ -1038,12 +1060,13 @@ var AgnoClient = class extends EventEmitter {
     if (!entityId) {
       throw new Error("Entity ID must be configured");
     }
+    const headers = this.configManager.buildRequestHeaders();
     const sessions = await this.sessionManager.fetchSessions(
       config.endpoint,
       entityType,
       entityId,
       dbId,
-      config.authToken
+      headers
     );
     this.state.sessions = sessions;
     this.emit("state:change", this.getState());
@@ -1055,11 +1078,12 @@ var AgnoClient = class extends EventEmitter {
   async deleteSession(sessionId) {
     const config = this.configManager.getConfig();
     const dbId = this.configManager.getDbId() || "";
+    const headers = this.configManager.buildRequestHeaders();
     await this.sessionManager.deleteSession(
       config.endpoint,
       sessionId,
       dbId,
-      config.authToken
+      headers
     );
     this.state.sessions = this.state.sessions.filter(
       (s) => s.session_id !== sessionId
@@ -1210,11 +1234,7 @@ var AgnoClient = class extends EventEmitter {
     if (userId) {
       formData.append("user_id", userId);
     }
-    const headers = { ...options?.headers };
-    const authToken = this.configManager.getAuthToken();
-    if (authToken) {
-      headers["Authorization"] = `Bearer ${authToken}`;
-    }
+    const headers = this.configManager.buildRequestHeaders(options?.headers);
     try {
       await streamResponse({
         apiUrl: continueUrl,
@@ -1247,7 +1267,8 @@ var AgnoClient = class extends EventEmitter {
    */
   async checkStatus() {
     try {
-      const response = await fetch(`${this.configManager.getEndpoint()}/health`);
+      const headers = this.configManager.buildRequestHeaders();
+      const response = await fetch(`${this.configManager.getEndpoint()}/health`, { headers });
       const isActive = response.ok;
       this.state.isEndpointActive = isActive;
       this.emit("state:change", this.getState());
@@ -1262,12 +1283,8 @@ var AgnoClient = class extends EventEmitter {
    * Fetch agents from endpoint
    */
   async fetchAgents() {
-    const config = this.configManager.getConfig();
-    const headers = {};
-    if (config.authToken) {
-      headers["Authorization"] = `Bearer ${config.authToken}`;
-    }
-    const response = await fetch(`${config.endpoint}/agents`, { headers });
+    const headers = this.configManager.buildRequestHeaders();
+    const response = await fetch(`${this.configManager.getEndpoint()}/agents`, { headers });
     if (!response.ok) {
       throw new Error("Failed to fetch agents");
     }
@@ -1280,12 +1297,8 @@ var AgnoClient = class extends EventEmitter {
    * Fetch teams from endpoint
    */
   async fetchTeams() {
-    const config = this.configManager.getConfig();
-    const headers = {};
-    if (config.authToken) {
-      headers["Authorization"] = `Bearer ${config.authToken}`;
-    }
-    const response = await fetch(`${config.endpoint}/teams`, { headers });
+    const headers = this.configManager.buildRequestHeaders();
+    const response = await fetch(`${this.configManager.getEndpoint()}/teams`, { headers });
     if (!response.ok) {
       throw new Error("Failed to fetch teams");
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@antipopp/agno-client",
-  "version": "0.6.1",
+  "version": "0.7.0",
   "description": "Core client library for Agno agents with streaming support and HITL frontend tool execution",
   "author": "antipopp",
   "license": "MIT",
@@ -34,7 +34,7 @@
   ],
   "dependencies": {
     "eventemitter3": "^5.0.1",
-    "@antipopp/agno-types": "0.6.1"
+    "@antipopp/agno-types": "0.7.0"
   },
   "devDependencies": {
     "tsup": "^8.0.1",