@node-llm/core 1.16.0 → 1.16.1

package/dist/aliases.json

@@ -0,0 +1,132 @@
+{
+    "chatgpt-4o": {
+        "openai": "chatgpt-4o-latest",
+        "openrouter": "openai/chatgpt-4o-latest"
+    },
+    "claude-3-5-haiku": {
+        "anthropic": "claude-3-5-haiku-20241022",
+        "openrouter": "anthropic/claude-3.5-haiku",
+        "bedrock": "anthropic.claude-3-5-haiku-20241022-v1:0"
+    },
+    "claude-3-5-sonnet": {
+        "anthropic": "claude-3-5-sonnet-20240620",
+        "openrouter": "anthropic/claude-3.5-sonnet",
+        "bedrock": "anthropic.claude-3-5-sonnet-20240620-v1:0"
+    },
+    "claude-sonnet-4-5": {
+        "anthropic": "claude-sonnet-4-5-20250929"
+    },
+    "claude-sonnet-4": {
+        "anthropic": "claude-sonnet-4-20250514"
+    },
+    "claude-3-7-sonnet": {
+        "anthropic": "claude-3-7-sonnet-20250219",
+        "openrouter": "anthropic/claude-3.7-sonnet",
+        "bedrock": "us.anthropic.claude-3-7-sonnet-20250219-v1:0"
+    },
+    "claude-3-haiku": {
+        "anthropic": "claude-3-haiku-20240307",
+        "openrouter": "anthropic/claude-3-haiku",
+        "bedrock": "anthropic.claude-3-haiku-20240307-v1:0:200k"
+    },
+    "claude-3-opus": {
+        "anthropic": "claude-3-opus-20240229",
+        "openrouter": "anthropic/claude-3-opus",
+        "bedrock": "anthropic.claude-3-opus-20240229-v1:0:200k"
+    },
+    "claude-3-sonnet": {
+        "bedrock": "anthropic.claude-3-sonnet-20240229-v1:0"
+    },
+    "deepseek-chat": {
+        "deepseek": "deepseek-chat",
+        "openrouter": "deepseek/deepseek-chat"
+    },
+    "gemini-flash": {
+        "gemini": "gemini-flash-latest",
+        "vertexai": "gemini-flash-latest",
+        "openrouter": "google/gemini-flash-latest"
+    },
+    "gemini-pro": {
+        "gemini": "gemini-1.5-pro-001",
+        "vertexai": "gemini-1.5-pro-001",
+        "openrouter": "google/gemini-1.5-pro-001"
+    },
+    "gemini-1.5-flash": {
+        "gemini": "gemini-1.5-flash-001",
+        "vertexai": "gemini-1.5-flash-001",
+        "openrouter": "google/gemini-1.5-flash-001"
+    },
+    "gemini-1.5-pro": {
+        "gemini": "gemini-1.5-pro-001",
+        "vertexai": "gemini-1.5-pro-001",
+        "openrouter": "google/gemini-1.5-pro-001"
+    },
+    "gemini-2.0-flash": {
+        "gemini": "gemini-2.0-flash",
+        "vertexai": "gemini-2.0-flash"
+    },
+    "gemini-2.0-flash-001": {
+        "gemini": "gemini-2.0-flash-001",
+        "openrouter": "google/gemini-2.0-flash-001",
+        "vertexai": "gemini-2.0-flash-001"
+    },
+    "gpt-3.5-turbo": {
+        "openai": "gpt-3.5-turbo",
+        "openrouter": "openai/gpt-3.5-turbo"
+    },
+    "gpt-4": {
+        "openai": "gpt-4",
+        "openrouter": "openai/gpt-4"
+    },
+    "gpt-4-turbo": {
+        "openai": "gpt-4-turbo",
+        "openrouter": "openai/gpt-4-turbo"
+    },
+    "gpt-4o": {
+        "openai": "gpt-4o",
+        "openrouter": "openai/gpt-4o"
+    },
+    "gpt-4o-mini": {
+        "openai": "gpt-4o-mini",
+        "openrouter": "openai/gpt-4o-mini"
+    },
+    "llama-3-1-405b": {
+        "openrouter": "meta-llama/llama-3.1-405b"
+    },
+    "llama-3-1-405b-instruct": {
+        "openrouter": "meta-llama/llama-3.1-405b-instruct"
+    },
+    "llama-3-1-70b": {
+        "openrouter": "meta-llama/llama-3.1-70b"
+    },
+    "llama-3-1-70b-instruct": {
+        "openrouter": "meta-llama/llama-3.1-70b-instruct"
+    },
+    "llama-3-1-8b": {
+        "openrouter": "meta-llama/llama-3.1-8b"
+    },
+    "llama-3-1-8b-instruct": {
+        "openrouter": "meta-llama/llama-3.1-8b-instruct"
+    },
+    "llama-3-2-1b-instruct": {
+        "openrouter": "meta-llama/llama-3.2-1b-instruct"
+    },
+    "llama-3-2-3b-instruct": {
+        "openrouter": "meta-llama/llama-3.2-3b-instruct"
+    },
+    "llama-3-3-70b-instruct": {
+        "openrouter": "meta-llama/llama-3.3-70b-instruct"
+    },
+    "mistral-large": {
+        "mistral": "mistral-large-latest",
+        "openrouter": "mistralai/mistral-large"
+    },
+    "mistral-medium": {
+        "mistral": "mistral-medium-latest",
+        "openrouter": "mistralai/mistral-medium"
+    },
+    "mistral-small": {
+        "mistral": "mistral-small-latest",
+        "openrouter": "mistralai/mistral-small"
+    }
+}

package/dist/interceptors/InterceptorChain.d.ts

@@ -0,0 +1,47 @@
+import { Message } from "../chat/Message.js";
+import { ChatResponseString } from "../chat/ChatResponse.js";
+/**
+ * Interceptor for processing messages before they are sent to the LLM.
+ * Return modified messages or void to keep original.
+ */
+export type RequestInterceptor = (messages: Message[]) => Promise<Message[] | void> | Message[] | void;
+/**
+ * Interceptor for processing LLM responses before they are returned to the user.
+ * Return modified response or void to keep original.
+ */
+export type ResponseInterceptor = (response: ChatResponseString) => Promise<ChatResponseString | void> | ChatResponseString | void;
+/**
+ * Manages a chain of interceptors that can modify requests and responses.
+ */
+export declare class InterceptorChain {
+    private requestInterceptors;
+    private responseInterceptors;
+    /**
+     * Add a request interceptor to the chain.
+     */
+    addRequestInterceptor(interceptor: RequestInterceptor): this;
+    /**
+     * Add a response interceptor to the chain.
+     */
+    addResponseInterceptor(interceptor: ResponseInterceptor): this;
+    /**
+     * Execute all request interceptors in order.
+     */
+    executeRequestInterceptors(messages: Message[]): Promise<Message[]>;
+    /**
+     * Execute all response interceptors in order.
+     */
+    executeResponseInterceptors(response: ChatResponseString): Promise<ChatResponseString>;
+    /**
+     * Clear all interceptors.
+     */
+    clear(): void;
+    /**
+     * Get the number of registered interceptors.
+     */
+    get size(): {
+        request: number;
+        response: number;
+    };
+}
+//# sourceMappingURL=InterceptorChain.d.ts.map

package/dist/interceptors/InterceptorChain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InterceptorChain.d.ts","sourceRoot":"","sources":["../../src/interceptors/InterceptorChain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,OAAO,EAAE,GAAG,IAAI,CAAC;AAEvG;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,QAAQ,EAAE,kBAAkB,KAAK,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,GAAG,kBAAkB,GAAG,IAAI,CAAC;AAEnI;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,mBAAmB,CAA4B;IACvD,OAAO,CAAC,oBAAoB,CAA6B;IAEzD;;OAEG;IACH,qBAAqB,CAAC,WAAW,EAAE,kBAAkB,GAAG,IAAI;IAK5D;;OAEG;IACH,sBAAsB,CAAC,WAAW,EAAE,mBAAmB,GAAG,IAAI;IAK9D;;OAEG;IACG,0BAA0B,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAazE;;OAEG;IACG,2BAA2B,CAAC,QAAQ,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAa5F;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,IAAI,IAAI,IAAI;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAKhD;CACF"}

package/dist/interceptors/InterceptorChain.js

@@ -0,0 +1,63 @@
+/**
+ * Manages a chain of interceptors that can modify requests and responses.
+ */
+export class InterceptorChain {
+    requestInterceptors = [];
+    responseInterceptors = [];
+    /**
+     * Add a request interceptor to the chain.
+     */
+    addRequestInterceptor(interceptor) {
+        this.requestInterceptors.push(interceptor);
+        return this;
+    }
+    /**
+     * Add a response interceptor to the chain.
+     */
+    addResponseInterceptor(interceptor) {
+        this.responseInterceptors.push(interceptor);
+        return this;
+    }
+    /**
+     * Execute all request interceptors in order.
+     */
+    async executeRequestInterceptors(messages) {
+        let current = messages;
+        for (const interceptor of this.requestInterceptors) {
+            const result = await interceptor(current);
+            if (result) {
+                current = result;
+            }
+        }
+        return current;
+    }
+    /**
+     * Execute all response interceptors in order.
+     */
+    async executeResponseInterceptors(response) {
+        let current = response;
+        for (const interceptor of this.responseInterceptors) {
+            const result = await interceptor(current);
+            if (result) {
+                current = result;
+            }
+        }
+        return current;
+    }
+    /**
+     * Clear all interceptors.
+     */
+    clear() {
+        this.requestInterceptors = [];
+        this.responseInterceptors = [];
+    }
+    /**
+     * Get the number of registered interceptors.
+     */
+    get size() {
+        return {
+            request: this.requestInterceptors.length,
+            response: this.responseInterceptors.length
+        };
+    }
+}

package/dist/interceptors/examples.d.ts

@@ -0,0 +1,19 @@
+import { Message } from "../chat/Message.js";
+import { ChatResponseString } from "../chat/ChatResponse.js";
+/**
+ * Example: Redact PII (emails, phone numbers) from messages before sending to LLM.
+ */
+export declare function piiRedactionInterceptor(messages: Message[]): Message[];
+/**
+ * Example: Log all requests for debugging/auditing.
+ */
+export declare function requestLoggerInterceptor(messages: Message[]): void;
+/**
+ * Example: Log all responses for debugging/auditing.
+ */
+export declare function responseLoggerInterceptor(response: ChatResponseString): void;
+/**
+ * Example: Add a custom header/footer to all responses.
+ */
+export declare function responseWrapperInterceptor(response: ChatResponseString): ChatResponseString;
+//# sourceMappingURL=examples.d.ts.map

package/dist/interceptors/examples.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"examples.d.ts","sourceRoot":"","sources":["../../src/interceptors/examples.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,CAYtE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI,CAElE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI,CAK5E;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,kBAAkB,GAAG,kBAAkB,CAS3F"}

package/dist/interceptors/examples.js

@@ -0,0 +1,38 @@
+import { ChatResponseString } from "../chat/ChatResponse.js.js";
+/**
+ * Example: Redact PII (emails, phone numbers) from messages before sending to LLM.
+ */
+export function piiRedactionInterceptor(messages) {
+    const emailRegex = /\b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Z|a-z]{2,}\b/g;
+    const phoneRegex = /\b\d{3}[-.]?\d{3}[-.]?\d{4}\b/g;
+    return messages.map(msg => ({
+        ...msg,
+        content: typeof msg.content === 'string'
+            ? msg.content
+                .replace(emailRegex, '[EMAIL_REDACTED]')
+                .replace(phoneRegex, '[PHONE_REDACTED]')
+            : msg.content
+    }));
+}
+/**
+ * Example: Log all requests for debugging/auditing.
+ */
+export function requestLoggerInterceptor(messages) {
+    console.log('[Request Interceptor] Sending messages:', JSON.stringify(messages, null, 2));
+}
+/**
+ * Example: Log all responses for debugging/auditing.
+ */
+export function responseLoggerInterceptor(response) {
+    console.log('[Response Interceptor] Received response:', {
+        content: response.toString().substring(0, 100) + '...',
+        usage: response.usage
+    });
+}
+/**
+ * Example: Add a custom header/footer to all responses.
+ */
+export function responseWrapperInterceptor(response) {
+    const wrapped = `--- AI Response ---\n${response.toString()}\n--- End Response ---`;
+    return new ChatResponseString(wrapped, response.usage, response.model, response.provider, response.reasoning);
+}