@node-llm/core 1.16.2 → 1.17.0

package/dist/providers/bedrock/BedrockProvider.js

@@ -65,7 +65,7 @@ export class BedrockProvider extends BaseProvider {
         this.moderationHandler = new BedrockModeration(config);
     }
     apiBase() {
-        return getBedrockEndpoint(this.config.region);
+        return getBedrockEndpoint(this.config.region, this.config.apiBase);
     }
     headers() {
         // Headers are built dynamically based on auth mode

package/dist/providers/bedrock/Chat.js

@@ -20,7 +20,7 @@ export class BedrockChat {
     constructor(config) {
         this.config = config;
         this.authMode = validateBedrockConfig(config);
-        this.baseUrl = getBedrockEndpoint(config.region);
+        this.baseUrl = getBedrockEndpoint(config.region, config.apiBase);
     }
     /**
      * Execute a chat request against Bedrock Converse API.

package/dist/providers/bedrock/Embeddings.js

@@ -17,7 +17,7 @@ export class BedrockEmbeddings {
     constructor(config) {
         this.config = config;
         this.authMode = validateBedrockConfig(config);
-        this.baseUrl = getBedrockEndpoint(config.region);
+        this.baseUrl = getBedrockEndpoint(config.region, config.apiBase);
     }
     /**
      * Execute an embedding request against Bedrock InvokeModel API.

package/dist/providers/bedrock/Image.js

@@ -12,7 +12,7 @@ export class BedrockImage {
     baseUrl;
     constructor(config) {
         this.config = config;
-        this.baseUrl = getBedrockEndpoint(config.region);
+        this.baseUrl = getBedrockEndpoint(config.region, config.apiBase);
     }
     /**
      * Execute an image generation request.

package/dist/providers/bedrock/Moderation.js

@@ -15,7 +15,7 @@ export class BedrockModeration {
     constructor(config) {
         this.config = config;
         this.authMode = validateBedrockConfig(config);
-        this.baseUrl = getBedrockEndpoint(config.region);
+        this.baseUrl = getBedrockEndpoint(config.region, config.apiBase);
     }
     /**
      * Execute a moderation request against Bedrock Guardrails.

package/dist/providers/bedrock/Streaming.js

@@ -18,7 +18,7 @@ export class BedrockStreaming {
     constructor(config) {
         this.config = config;
         this.authMode = validateBedrockConfig(config);
-        this.baseUrl = getBedrockEndpoint(config.region);
+        this.baseUrl = getBedrockEndpoint(config.region, config.apiBase);
     }
     async *execute(request, controller) {
         const internalController = new AbortController();

package/dist/providers/bedrock/config.d.ts

@@ -37,6 +37,12 @@ export interface BedrockConfig {
      * Default: 120000 (2 minutes)
      */
     requestTimeout?: number;
+    /**
+     * Custom Bedrock Runtime endpoint override (e.g. for routing traffic
+     * through a proxy or private gateway). Defaults to the standard
+     * `https://bedrock-runtime.{region}.amazonaws.com` endpoint when unset.
+     */
+    apiBase?: string;
     /**
      * Default Bedrock Guardrail identifier (ID or ARN).
      */
@@ -52,6 +58,8 @@ export interface BedrockConfig {
 export declare function validateBedrockConfig(config: BedrockConfig): "apiKey" | "sigv4";
 /**
  * Build the Bedrock Runtime endpoint URL for a given region.
+ * Pass `apiBase` to route through a custom endpoint (e.g. a proxy/gateway)
+ * instead of the standard AWS Bedrock Runtime URL.
  */
-export declare function getBedrockEndpoint(region: string): string;
+export declare function getBedrockEndpoint(region: string, apiBase?: string): string;
 //# sourceMappingURL=config.d.ts.map

package/dist/providers/bedrock/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/providers/bedrock/config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IAKf;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAKhB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAKtB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAE7B;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,aAAa,GAAG,QAAQ,GAAG,OAAO,CAuB/E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEzD"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/providers/bedrock/config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IAKf;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAKhB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAKtB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAE7B;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,aAAa,GAAG,QAAQ,GAAG,OAAO,CAuB/E;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAE3E"}

package/dist/providers/bedrock/config.js

@@ -27,7 +27,9 @@ export function validateBedrockConfig(config) {
 }
 /**
  * Build the Bedrock Runtime endpoint URL for a given region.
+ * Pass `apiBase` to route through a custom endpoint (e.g. a proxy/gateway)
+ * instead of the standard AWS Bedrock Runtime URL.
  */
-export function getBedrockEndpoint(region) {
-    return `https://bedrock-runtime.${region}.amazonaws.com`;
+export function getBedrockEndpoint(region, apiBase) {
+    return apiBase || `https://bedrock-runtime.${region}.amazonaws.com`;
 }

package/dist/providers/bedrock/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/bedrock/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,wBAAgB,uBAAuB,SAuBtC;AAED,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/bedrock/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,wBAAgB,uBAAuB,SAwBtC;AAED,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,cAAc,YAAY,CAAC"}

package/dist/providers/bedrock/index.js

@@ -19,6 +19,7 @@ export function registerBedrockProvider() {
             accessKeyId: cfg.bedrockAccessKeyId,
             secretAccessKey: cfg.bedrockSecretAccessKey,
             sessionToken: cfg.bedrockSessionToken,
+            apiBase: cfg.bedrockApiBase,
             guardrailIdentifier: cfg.bedrockGuardrailIdentifier,
             guardrailVersion: cfg.bedrockGuardrailVersion
         };

package/dist/utils/handler-stacking.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Combines a single "constructor-provided" handler with a list of handlers
+ * appended later (e.g. via fluent on*() calls), preserving registration order.
+ */
+export declare function collectHandlers<T>(single: T | undefined, list: T[] | undefined): T[];
+/**
+ * Runs every handler with the given args, awaiting each in order. Use for
+ * pure observers (onNewMessage, onEndMessage, onToolCallStart, onToolCallEnd)
+ * where every registered handler should fire and none of them return a value.
+ */
+export declare function runAllHandlers<Args extends unknown[]>(handlers: Array<(...args: Args) => unknown>, ...args: Args): Promise<void>;
+/**
+ * Runs every handler in order and returns the first defined (non-void)
+ * result, but still calls the remaining handlers so every one of them gets a
+ * chance to observe/react (mirrors the middleware-runner directive pattern).
+ * Use for onToolCallError, where the first STOP/RETRY/CONTINUE wins.
+ */
+export declare function runDirectiveHandlers<Args extends unknown[], R>(handlers: Array<(...args: Args) => R | void | Promise<R | void>>, ...args: Args): Promise<R | undefined>;
+/**
+ * Runs every handler in order, AND-ing boolean results together. Used for
+ * onConfirmToolCall: every registered handler must approve for the call to
+ * proceed. Short-circuits once a handler declines.
+ */
+export declare function runConfirmHandlers<Args extends unknown[]>(handlers: Array<(...args: Args) => Promise<boolean> | boolean>, ...args: Args): Promise<boolean>;
+/**
+ * Runs every handler in order, feeding each handler's (possibly transformed)
+ * output into the next as its input. Used for onBeforeRequest/onAfterResponse,
+ * where each handler may rewrite the value for downstream handlers.
+ */
+export declare function runChainHandlers<T>(handlers: Array<(value: T) => Promise<T | void> | T | void>, initial: T): Promise<T>;
+//# sourceMappingURL=handler-stacking.d.ts.map

package/dist/utils/handler-stacking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler-stacking.d.ts","sourceRoot":"","sources":["../../src/utils/handler-stacking.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,SAAS,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,SAAS,GAAG,CAAC,EAAE,CAKpF;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,IAAI,SAAS,OAAO,EAAE,EACzD,QAAQ,EAAE,KAAK,CAAC,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,EAC3C,GAAG,IAAI,EAAE,IAAI,GACZ,OAAO,CAAC,IAAI,CAAC,CAIf;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,SAAS,OAAO,EAAE,EAAE,CAAC,EAClE,QAAQ,EAAE,KAAK,CAAC,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,CAAC,GAAG,IAAI,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,EAChE,GAAG,IAAI,EAAE,IAAI,GACZ,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CASxB;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,SAAS,OAAO,EAAE,EAC7D,QAAQ,EAAE,KAAK,CAAC,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,EAC9D,GAAG,IAAI,EAAE,IAAI,GACZ,OAAO,CAAC,OAAO,CAAC,CAMlB;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,EACtC,QAAQ,EAAE,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,EAC3D,OAAO,EAAE,CAAC,GACT,OAAO,CAAC,CAAC,CAAC,CASZ"}

package/dist/utils/handler-stacking.js

@@ -0,0 +1,66 @@
+/**
+ * Combines a single "constructor-provided" handler with a list of handlers
+ * appended later (e.g. via fluent on*() calls), preserving registration order.
+ */
+export function collectHandlers(single, list) {
+    const handlers = [];
+    if (single)
+        handlers.push(single);
+    if (list)
+        handlers.push(...list);
+    return handlers;
+}
+/**
+ * Runs every handler with the given args, awaiting each in order. Use for
+ * pure observers (onNewMessage, onEndMessage, onToolCallStart, onToolCallEnd)
+ * where every registered handler should fire and none of them return a value.
+ */
+export async function runAllHandlers(handlers, ...args) {
+    for (const handler of handlers) {
+        await handler(...args);
+    }
+}
+/**
+ * Runs every handler in order and returns the first defined (non-void)
+ * result, but still calls the remaining handlers so every one of them gets a
+ * chance to observe/react (mirrors the middleware-runner directive pattern).
+ * Use for onToolCallError, where the first STOP/RETRY/CONTINUE wins.
+ */
+export async function runDirectiveHandlers(handlers, ...args) {
+    let result;
+    for (const handler of handlers) {
+        const value = await handler(...args);
+        if (value !== undefined && result === undefined) {
+            result = value;
+        }
+    }
+    return result;
+}
+/**
+ * Runs every handler in order, AND-ing boolean results together. Used for
+ * onConfirmToolCall: every registered handler must approve for the call to
+ * proceed. Short-circuits once a handler declines.
+ */
+export async function runConfirmHandlers(handlers, ...args) {
+    for (const handler of handlers) {
+        const approved = await handler(...args);
+        if (approved === false)
+            return false;
+    }
+    return true;
+}
+/**
+ * Runs every handler in order, feeding each handler's (possibly transformed)
+ * output into the next as its input. Used for onBeforeRequest/onAfterResponse,
+ * where each handler may rewrite the value for downstream handlers.
+ */
+export async function runChainHandlers(handlers, initial) {
+    let value = initial;
+    for (const handler of handlers) {
+        const result = await handler(value);
+        if (result !== undefined) {
+            value = result;
+        }
+    }
+    return value;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@node-llm/core",
-  "version": "1.16.2",
+  "version": "1.17.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -55,6 +55,17 @@
     "README.md",
     "LICENSE"
   ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsc -w",
+    "lint": "tsc --noEmit",
+    "test": "vitest run",
+    "test:docs": "vitest run test/docs",
+    "test:watch": "vitest",
+    "prepack": "npm run build && cp ../../CHANGELOG.md ./CHANGELOG.md",
+    "postpack": "rm ./CHANGELOG.md",
+    "prepublishOnly": "npm run build && npm run test:docs"
+  },
   "dependencies": {
     "zod": "^3.23.8",
     "zod-to-json-schema": "^3.25.1"
@@ -64,13 +75,5 @@
     "@pollyjs/adapter-node-http": "^6.0.6",
     "@pollyjs/core": "^6.0.6",
     "@pollyjs/persister-fs": "^6.0.6"
-  },
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "dev": "tsc -w",
-    "lint": "tsc --noEmit",
-    "test": "vitest run",
-    "test:docs": "vitest run test/docs",
-    "test:watch": "vitest"
   }
-}
+}