@agent-api/sdk 1.4.0 → 1.4.2

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog — @agent-api/sdk
 
+## 1.4.2
+
+### Added
+
+- Added per-request `apiKeyProvider` support, allowing long-lived applications to supply refreshed bearer tokens without rebuilding clients.
+
+## 1.4.1
+
+### Added
+
+- Added `client.memories.search(...)` for the public `/v1/memories/search` API.
+
 ## 1.4.0
 
 ### Added

package/dist/client.d.ts

@@ -1,5 +1,6 @@
 import { HTTPClient } from "./internal/http.js";
 import { AuthResource } from "./resources/auth.js";
+import { MemoriesResource } from "./resources/memories.js";
 import { ModelsResource } from "./resources/models.js";
 import { PresetsResource } from "./resources/presets.js";
 import { ResponsesResource } from "./resources/responses.js";
@@ -13,6 +14,7 @@ export declare const DEFAULT_STREAM_TIMEOUT_MS = 3600000;
 export declare const DEFAULT_MAX_RETRIES = 2;
 export declare class AgentAPI {
     readonly apiKey?: string;
+    readonly apiKeyProvider?: ClientOptions["apiKeyProvider"];
     readonly baseURL: string;
     readonly timeout: number;
     readonly streamTimeout: number;
@@ -21,6 +23,7 @@ export declare class AgentAPI {
     readonly responses: ResponsesResource;
     readonly agent: ResponsesResource;
     readonly models: ModelsResource;
+    readonly memories: MemoriesResource;
     readonly presets: PresetsResource;
     readonly tools: ToolsResource;
     readonly volumes: VolumesResource;

package/dist/client.js

@@ -2,6 +2,7 @@ import { APIConnectionError } from "./errors.js";
 import { readEnv } from "./internal/env.js";
 import { HTTPClient } from "./internal/http.js";
 import { AuthResource } from "./resources/auth.js";
+import { MemoriesResource } from "./resources/memories.js";
 import { ModelsResource } from "./resources/models.js";
 import { PresetsResource } from "./resources/presets.js";
 import { ResponsesResource } from "./resources/responses.js";
@@ -14,6 +15,7 @@ export const DEFAULT_STREAM_TIMEOUT_MS = 3_600_000;
 export const DEFAULT_MAX_RETRIES = 2;
 export class AgentAPI {
     apiKey;
+    apiKeyProvider;
     baseURL;
     timeout;
     streamTimeout;
@@ -22,6 +24,7 @@ export class AgentAPI {
     responses;
     agent;
     models;
+    memories;
     presets;
     tools;
     volumes;
@@ -30,6 +33,7 @@ export class AgentAPI {
     http;
     constructor(options = {}) {
         this.apiKey = options.apiKey ?? readEnv("AGENT_API_KEY");
+        this.apiKeyProvider = options.apiKeyProvider;
         this.baseURL = (options.baseURL ?? readEnv("AGENT_API_BASE_URL") ?? "https://api.agentsway.dev").replace(/\/+$/, "");
         this.timeout = options.timeout ?? DEFAULT_TIMEOUT_MS;
         this.streamTimeout = options.streamTimeout ?? DEFAULT_STREAM_TIMEOUT_MS;
@@ -42,6 +46,7 @@ export class AgentAPI {
         this.http = new HTTPClient({
             baseURL: this.baseURL,
             apiKey: this.apiKey,
+            apiKeyProvider: this.apiKeyProvider,
             timeout: this.timeout,
             streamTimeout: this.streamTimeout,
             maxRetries: this.maxRetries,
@@ -51,6 +56,7 @@ export class AgentAPI {
         this.responses = new ResponsesResource(this.http, "/v1/responses");
         this.agent = new ResponsesResource(this.http, "/v1/agent");
         this.models = new ModelsResource(this.http);
+        this.memories = new MemoriesResource(this.http);
         this.presets = new PresetsResource(this.http);
         this.tools = new ToolsResource(this.http);
         this.volumes = new VolumesResource(this.http);

package/dist/index.d.ts

@@ -9,3 +9,4 @@ export { mergeTools, publicToolToRequestTool, resolvePresetTools, resolvePresetT
 export { isSupportedVolumeImageContentType, isSupportedVolumeImagePath, normalizeVolumeAssetPath, } from "./volume-assets.js";
 export type { PresetToolCatalogClient, ResolvePresetToolsOptions, ResolvePresetToolsResult, UnknownPresetToolBehavior, } from "./preset-tools.js";
 export { AuthResource, DeviceAuthFlowError, browserAuthSessionExpiresWithin } from "./resources/auth.js";
+export { MemoriesResource } from "./resources/memories.js";

package/dist/index.js

@@ -6,3 +6,4 @@ export { functionCallOutputInput, pendingFunctionCalls, runLocalFunctionHandlers
 export { mergeTools, publicToolToRequestTool, resolvePresetTools, resolvePresetToolsFromCatalog, } from "./preset-tools.js";
 export { isSupportedVolumeImageContentType, isSupportedVolumeImagePath, normalizeVolumeAssetPath, } from "./volume-assets.js";
 export { AuthResource, DeviceAuthFlowError, browserAuthSessionExpiresWithin } from "./resources/auth.js";
+export { MemoriesResource } from "./resources/memories.js";

package/dist/internal/http.d.ts

@@ -2,6 +2,7 @@ import type { RequestOptions } from "../types/common.js";
 export interface HTTPClientOptions {
     baseURL: string;
     apiKey?: string;
+    apiKeyProvider?: () => string | undefined | Promise<string | undefined>;
     timeout: number;
     streamTimeout: number;
     maxRetries: number;

package/dist/internal/http.js

@@ -79,8 +79,10 @@ export class HTTPClient {
             if (body !== undefined && !rawBody) {
                 headers["Content-Type"] = "application/json";
             }
-            if (this.options.apiKey) {
-                headers.Authorization = `Bearer ${this.options.apiKey}`;
+            const providedAPIKey = this.options.apiKeyProvider ? await this.options.apiKeyProvider() : undefined;
+            const apiKey = providedAPIKey ?? this.options.apiKey;
+            if (apiKey) {
+                headers.Authorization = `Bearer ${apiKey}`;
             }
             const response = await this.options.fetchImpl(`${this.options.baseURL}${path}`, {
                 method,

package/dist/resources/memories.d.ts

@@ -0,0 +1,8 @@
+import type { HTTPClient } from "../internal/http.js";
+import type { RequestOptions } from "../types/common.js";
+import type { MemorySearchParams, MemorySearchResponse } from "../types/memories.js";
+export declare class MemoriesResource {
+    private readonly http;
+    constructor(http: HTTPClient);
+    search(params: MemorySearchParams, options?: RequestOptions): Promise<MemorySearchResponse>;
+}

package/dist/resources/memories.js

@@ -0,0 +1,9 @@
+export class MemoriesResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    search(params, options) {
+        return this.http.request("POST", "/v1/memories/search", params, options);
+    }
+}

package/dist/types/common.d.ts

@@ -7,6 +7,7 @@ export type ModelRoutingMode = "auto" | "chain";
 export type ModelRoutingStrategy = "balanced" | "high-quality" | "cost-effective";
 export interface ClientOptions {
     apiKey?: string;
+    apiKeyProvider?: () => string | undefined | Promise<string | undefined>;
     baseURL?: string;
     /** Default request timeout in milliseconds (non-streaming). */
     timeout?: number;

package/dist/types/index.d.ts

@@ -4,6 +4,7 @@ export * from "./tools.js";
 export * from "./responses.js";
 export * from "./streaming.js";
 export * from "./catalog.js";
+export * from "./memories.js";
 export * from "./volumes.js";
 export * from "./skills.js";
 export * from "./auth.js";

package/dist/types/index.js

@@ -4,6 +4,7 @@ export * from "./tools.js";
 export * from "./responses.js";
 export * from "./streaming.js";
 export * from "./catalog.js";
+export * from "./memories.js";
 export * from "./volumes.js";
 export * from "./skills.js";
 export * from "./auth.js";

package/dist/types/memories.d.ts

@@ -0,0 +1,37 @@
+import type { Usage } from "./common.js";
+export interface MemorySearchParams {
+    query: string;
+    limit?: number;
+    previous_response_id?: string;
+    tenant_search?: boolean;
+    lang?: string;
+    semantic_weight?: number;
+}
+export interface MemorySearchHit {
+    id: string;
+    score?: number;
+    thread_id?: string;
+    created_at?: number;
+    fact: string;
+    tenant_id?: string;
+    user_id?: string;
+    response_id?: string;
+    metadata?: unknown;
+    metadata_text?: string;
+}
+export interface MemorySearchModelUsage {
+    source?: string;
+    phase?: string;
+    provider?: string;
+    model?: string;
+    attempt_index?: number;
+    status?: string;
+    usage?: Usage;
+}
+export interface MemorySearchResponse {
+    object: "memory_search_result";
+    data: MemorySearchHit[];
+    total?: number;
+    rewritten_query?: string;
+    model_usage?: MemorySearchModelUsage[];
+}

package/dist/types/memories.js

@@ -0,0 +1 @@
+export {};

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "1.4.0";
-export declare const USER_AGENT = "@agent-api/sdk/1.4.0";
+export declare const VERSION = "1.4.2";
+export declare const USER_AGENT = "@agent-api/sdk/1.4.2";

package/dist/version.js

@@ -1,2 +1,2 @@
-export const VERSION = "1.4.0";
+export const VERSION = "1.4.2";
 export const USER_AGENT = `@agent-api/sdk/${VERSION}`;

package/dist-cjs/client.js

@@ -5,6 +5,7 @@ const errors_js_1 = require("./errors.js");
 const env_js_1 = require("./internal/env.js");
 const http_js_1 = require("./internal/http.js");
 const auth_js_1 = require("./resources/auth.js");
+const memories_js_1 = require("./resources/memories.js");
 const models_js_1 = require("./resources/models.js");
 const presets_js_1 = require("./resources/presets.js");
 const responses_js_1 = require("./resources/responses.js");
@@ -18,6 +19,7 @@ exports.DEFAULT_STREAM_TIMEOUT_MS = 3_600_000;
 exports.DEFAULT_MAX_RETRIES = 2;
 class AgentAPI {
     apiKey;
+    apiKeyProvider;
     baseURL;
     timeout;
     streamTimeout;
@@ -26,6 +28,7 @@ class AgentAPI {
     responses;
     agent;
     models;
+    memories;
     presets;
     tools;
     volumes;
@@ -34,6 +37,7 @@ class AgentAPI {
     http;
     constructor(options = {}) {
         this.apiKey = options.apiKey ?? (0, env_js_1.readEnv)("AGENT_API_KEY");
+        this.apiKeyProvider = options.apiKeyProvider;
         this.baseURL = (options.baseURL ?? (0, env_js_1.readEnv)("AGENT_API_BASE_URL") ?? "https://api.agentsway.dev").replace(/\/+$/, "");
         this.timeout = options.timeout ?? exports.DEFAULT_TIMEOUT_MS;
         this.streamTimeout = options.streamTimeout ?? exports.DEFAULT_STREAM_TIMEOUT_MS;
@@ -46,6 +50,7 @@ class AgentAPI {
         this.http = new http_js_1.HTTPClient({
             baseURL: this.baseURL,
             apiKey: this.apiKey,
+            apiKeyProvider: this.apiKeyProvider,
             timeout: this.timeout,
             streamTimeout: this.streamTimeout,
             maxRetries: this.maxRetries,
@@ -55,6 +60,7 @@ class AgentAPI {
         this.responses = new responses_js_1.ResponsesResource(this.http, "/v1/responses");
         this.agent = new responses_js_1.ResponsesResource(this.http, "/v1/agent");
         this.models = new models_js_1.ModelsResource(this.http);
+        this.memories = new memories_js_1.MemoriesResource(this.http);
         this.presets = new presets_js_1.PresetsResource(this.http);
         this.tools = new tools_js_1.ToolsResource(this.http);
         this.volumes = new volumes_js_1.VolumesResource(this.http);

package/dist-cjs/index.js

@@ -14,7 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.browserAuthSessionExpiresWithin = exports.DeviceAuthFlowError = exports.AuthResource = exports.normalizeVolumeAssetPath = exports.isSupportedVolumeImagePath = exports.isSupportedVolumeImageContentType = exports.resolvePresetToolsFromCatalog = exports.resolvePresetTools = exports.publicToolToRequestTool = exports.mergeTools = exports.runLocalFunctionHandlers = exports.pendingFunctionCalls = exports.functionCallOutputInput = exports.parseResponseError = exports.isRetryableStatus = exports.RateLimitError = exports.PermissionDeniedError = exports.NotFoundError = exports.InternalServerError = exports.BadRequestError = exports.AuthenticationError = exports.APIStatusError = exports.APIConnectionError = exports.APIError = exports.collectPage = exports.Page = exports.VERSION = exports.DEFAULT_TIMEOUT_MS = exports.DEFAULT_STREAM_TIMEOUT_MS = exports.DEFAULT_MAX_RETRIES = exports.AgentAPI = void 0;
+exports.MemoriesResource = exports.browserAuthSessionExpiresWithin = exports.DeviceAuthFlowError = exports.AuthResource = exports.normalizeVolumeAssetPath = exports.isSupportedVolumeImagePath = exports.isSupportedVolumeImageContentType = exports.resolvePresetToolsFromCatalog = exports.resolvePresetTools = exports.publicToolToRequestTool = exports.mergeTools = exports.runLocalFunctionHandlers = exports.pendingFunctionCalls = exports.functionCallOutputInput = exports.parseResponseError = exports.isRetryableStatus = exports.RateLimitError = exports.PermissionDeniedError = exports.NotFoundError = exports.InternalServerError = exports.BadRequestError = exports.AuthenticationError = exports.APIStatusError = exports.APIConnectionError = exports.APIError = exports.collectPage = exports.Page = exports.VERSION = exports.DEFAULT_TIMEOUT_MS = exports.DEFAULT_STREAM_TIMEOUT_MS = exports.DEFAULT_MAX_RETRIES = exports.AgentAPI = void 0;
 var client_js_1 = require("./client.js");
 Object.defineProperty(exports, "AgentAPI", { enumerable: true, get: function () { return client_js_1.AgentAPI; } });
 Object.defineProperty(exports, "DEFAULT_MAX_RETRIES", { enumerable: true, get: function () { return client_js_1.DEFAULT_MAX_RETRIES; } });
@@ -54,3 +54,5 @@ var auth_js_1 = require("./resources/auth.js");
 Object.defineProperty(exports, "AuthResource", { enumerable: true, get: function () { return auth_js_1.AuthResource; } });
 Object.defineProperty(exports, "DeviceAuthFlowError", { enumerable: true, get: function () { return auth_js_1.DeviceAuthFlowError; } });
 Object.defineProperty(exports, "browserAuthSessionExpiresWithin", { enumerable: true, get: function () { return auth_js_1.browserAuthSessionExpiresWithin; } });
+var memories_js_1 = require("./resources/memories.js");
+Object.defineProperty(exports, "MemoriesResource", { enumerable: true, get: function () { return memories_js_1.MemoriesResource; } });

package/dist-cjs/internal/http.js

@@ -82,8 +82,10 @@ class HTTPClient {
             if (body !== undefined && !rawBody) {
                 headers["Content-Type"] = "application/json";
             }
-            if (this.options.apiKey) {
-                headers.Authorization = `Bearer ${this.options.apiKey}`;
+            const providedAPIKey = this.options.apiKeyProvider ? await this.options.apiKeyProvider() : undefined;
+            const apiKey = providedAPIKey ?? this.options.apiKey;
+            if (apiKey) {
+                headers.Authorization = `Bearer ${apiKey}`;
             }
             const response = await this.options.fetchImpl(`${this.options.baseURL}${path}`, {
                 method,

package/dist-cjs/resources/memories.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoriesResource = void 0;
+class MemoriesResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    search(params, options) {
+        return this.http.request("POST", "/v1/memories/search", params, options);
+    }
+}
+exports.MemoriesResource = MemoriesResource;

package/dist-cjs/types/index.js

@@ -20,6 +20,7 @@ __exportStar(require("./tools.js"), exports);
 __exportStar(require("./responses.js"), exports);
 __exportStar(require("./streaming.js"), exports);
 __exportStar(require("./catalog.js"), exports);
+__exportStar(require("./memories.js"), exports);
 __exportStar(require("./volumes.js"), exports);
 __exportStar(require("./skills.js"), exports);
 __exportStar(require("./auth.js"), exports);

package/dist-cjs/types/memories.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist-cjs/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.USER_AGENT = exports.VERSION = void 0;
-exports.VERSION = "1.4.0";
+exports.VERSION = "1.4.2";
 exports.USER_AGENT = `@agent-api/sdk/${exports.VERSION}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-api/sdk",
-  "version": "1.4.0",
+  "version": "1.4.2",
   "description": "Production JavaScript SDK for the Managed Agent API",
   "license": "MIT",
   "repository": {