@node-llm/core 1.9.0 → 1.11.0

package/dist/providers/BaseProvider.d.ts

@@ -13,7 +13,12 @@ export declare abstract class BaseProvider implements Provider {
     defaultModel(_feature?: string): string;
     protected throwUnsupportedError(feature: string): never;
     abstract chat(request: ChatRequest): Promise<ChatResponse>;
-    abstract capabilities?: ProviderCapabilities;
+    capabilities?: ProviderCapabilities;
+    /**
+     * Provides a set of default capabilities where everything is disabled.
+     * Useful for custom providers to start with a safe baseline.
+     */
+    protected defaultCapabilities(): ProviderCapabilities;
     stream?(_request: ChatRequest): AsyncIterable<ChatChunk>;
     listModels?(): Promise<ModelInfo[]>;
     paint?(_request: ImageRequest): Promise<ImageResponse>;

package/dist/providers/BaseProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BaseProvider.d.ts","sourceRoot":"","sources":["../../src/providers/BaseProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7C,OAAO,EACL,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,SAAS,EACT,SAAS,EACT,YAAY,EACZ,aAAa,EACb,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACrB,MAAM,eAAe,CAAC;AAEvB;;;;GAIG;AACH,8BAAsB,YAAa,YAAW,QAAQ;aACpC,OAAO,IAAI,MAAM;aACjB,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IACjD,SAAS,CAAC,QAAQ,CAAC,YAAY,IAAI,MAAM;IAEzC,IAAI,EAAE,IAAI,MAAM,CAEf;IAEM,YAAY,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM;IAI9C,SAAS,CAAC,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK;IAIvD,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAC1D,QAAQ,CAAC,YAAY,CAAC,EAAE,oBAAoB,CAAC;IAEtC,MAAM,CAAC,CAAC,QAAQ,EAAE,WAAW,GAAG,aAAa,CAAC,SAAS,CAAC;IAKzD,UAAU,CAAC,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAInC,KAAK,CAAC,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IAItD,UAAU,CAAC,CAAC,QAAQ,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAI3E,QAAQ,CAAC,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAInE,KAAK,CAAC,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAIpE,uBAAuB,CACrB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAC9B,OAAO;CAQX"}
+{"version":3,"file":"BaseProvider.d.ts","sourceRoot":"","sources":["../../src/providers/BaseProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7C,OAAO,EACL,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,SAAS,EACT,SAAS,EACT,YAAY,EACZ,aAAa,EACb,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACrB,MAAM,eAAe,CAAC;AAEvB;;;;GAIG;AACH,8BAAsB,YAAa,YAAW,QAAQ;aACpC,OAAO,IAAI,MAAM;aACjB,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IACjD,SAAS,CAAC,QAAQ,CAAC,YAAY,IAAI,MAAM;IAEzC,IAAI,EAAE,IAAI,MAAM,CAEf;IAEM,YAAY,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM;IAI9C,SAAS,CAAC,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK;aAIvC,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAC1D,YAAY,CAAC,EAAE,oBAAoB,CAAC;IAE3C;;;OAGG;IACH,SAAS,CAAC,mBAAmB,IAAI,oBAAoB;IAe9C,MAAM,CAAC,CAAC,QAAQ,EAAE,WAAW,GAAG,aAAa,CAAC,SAAS,CAAC;IAKzD,UAAU,CAAC,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAInC,KAAK,CAAC,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IAItD,UAAU,CAAC,CAAC,QAAQ,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAI3E,QAAQ,CAAC,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAInE,KAAK,CAAC,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAIpE,uBAAuB,CACrB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAC9B,OAAO;CAQX"}

package/dist/providers/BaseProvider.js

@@ -14,6 +14,25 @@ export class BaseProvider {
     throwUnsupportedError(feature) {
         throw new UnsupportedFeatureError(this.providerName(), feature);
     }
+    capabilities;
+    /**
+     * Provides a set of default capabilities where everything is disabled.
+     * Useful for custom providers to start with a safe baseline.
+     */
+    defaultCapabilities() {
+        return {
+            supportsVision: () => false,
+            supportsTools: () => false,
+            supportsStructuredOutput: () => false,
+            supportsEmbeddings: () => false,
+            supportsImageGeneration: () => false,
+            supportsTranscription: () => false,
+            supportsModeration: () => false,
+            supportsReasoning: () => false,
+            supportsDeveloperRole: () => false,
+            getContextWindow: () => null
+        };
+    }
     async *stream(_request) {
         this.throwUnsupportedError("stream");
         yield* [];

package/dist/providers/openai/OpenAIProvider.d.ts

@@ -37,7 +37,7 @@ export declare class OpenAIProvider extends BaseProvider implements Provider {
     apiBase(): string;
     headers(): Record<string, string>;
     protected providerName(): string;
-    defaultModel(_feature?: string): string;
+    defaultModel(feature?: string): string;
     chat(request: ChatRequest): Promise<ChatResponse>;
     stream(request: ChatRequest): AsyncGenerator<ChatChunk>;
     listModels(): Promise<ModelInfo[]>;

package/dist/providers/openai/OpenAIProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OpenAIProvider.d.ts","sourceRoot":"","sources":["../../../src/providers/openai/OpenAIProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,SAAS,EACT,SAAS,EACT,YAAY,EACZ,aAAa,EACb,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,cAAe,SAAQ,YAAa,YAAW,QAAQ;IAwBtD,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,qBAAqB;IAvB7D,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,WAAW,EAAE,UAAU,CAAC;IAClC,SAAS,CAAC,gBAAgB,EAAE,eAAe,CAAC;IAC5C,SAAS,CAAC,aAAa,EAAE,YAAY,CAAC;IACtC,SAAS,CAAC,YAAY,EAAE,WAAW,CAAC;IACpC,SAAS,CAAC,oBAAoB,EAAE,mBAAmB,CAAC;IACpD,SAAS,CAAC,iBAAiB,EAAE,gBAAgB,CAAC;IAC9C,SAAS,CAAC,gBAAgB,EAAE,eAAe,CAAC;IAErC,YAAY;gCACO,MAAM;+BACP,MAAM;0CACK,MAAM;oCACZ,MAAM;yCACD,MAAM;uCACR,MAAM;oCACT,MAAM;mCACP,MAAM;yCACA,MAAM;kCAEb,MAAM;MAChC;gBAE6B,OAAO,EAAE,qBAAqB;IAYtD,OAAO,IAAI,MAAM;IAIjB,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAOxC,SAAS,CAAC,YAAY,IAAI,MAAM;IAIhB,YAAY,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM;IAIjD,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAIhD,MAAM,CAAC,OAAO,EAAE,WAAW,GAAG,cAAc,CAAC,SAAS,CAAC;IAIxD,UAAU,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAIlC,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IAIpD,UAAU,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAIzE,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAIjE,KAAK,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAGnE"}
+{"version":3,"file":"OpenAIProvider.d.ts","sourceRoot":"","sources":["../../../src/providers/openai/OpenAIProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,SAAS,EACT,SAAS,EACT,YAAY,EACZ,aAAa,EACb,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,cAAe,SAAQ,YAAa,YAAW,QAAQ;IAwBtD,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,qBAAqB;IAvB7D,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,WAAW,EAAE,UAAU,CAAC;IAClC,SAAS,CAAC,gBAAgB,EAAE,eAAe,CAAC;IAC5C,SAAS,CAAC,aAAa,EAAE,YAAY,CAAC;IACtC,SAAS,CAAC,YAAY,EAAE,WAAW,CAAC;IACpC,SAAS,CAAC,oBAAoB,EAAE,mBAAmB,CAAC;IACpD,SAAS,CAAC,iBAAiB,EAAE,gBAAgB,CAAC;IAC9C,SAAS,CAAC,gBAAgB,EAAE,eAAe,CAAC;IAErC,YAAY;gCACO,MAAM;+BACP,MAAM;0CACK,MAAM;oCACZ,MAAM;yCACD,MAAM;uCACR,MAAM;oCACT,MAAM;mCACP,MAAM;yCACA,MAAM;kCAEb,MAAM;MAChC;gBAE6B,OAAO,EAAE,qBAAqB;IAYtD,OAAO,IAAI,MAAM;IAIjB,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAOxC,SAAS,CAAC,YAAY,IAAI,MAAM;IAIhB,YAAY,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM;IAehD,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAIhD,MAAM,CAAC,OAAO,EAAE,WAAW,GAAG,cAAc,CAAC,SAAS,CAAC;IAIxD,UAAU,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAIlC,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IAIpD,UAAU,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAIzE,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAIjE,KAAK,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAGnE"}

package/dist/providers/openai/OpenAIProvider.js

@@ -54,8 +54,19 @@ export class OpenAIProvider extends BaseProvider {
     providerName() {
         return "OpenAI";
     }
-    defaultModel(_feature) {
-        return "gpt-4o";
+    defaultModel(feature) {
+        switch (feature) {
+            case "embedding":
+                return "text-embedding-3-small";
+            case "transcription":
+                return "whisper-1";
+            case "moderation":
+                return "omni-moderation-latest";
+            case "image":
+                return "dall-e-3";
+            default:
+                return "gpt-4o";
+        }
     }
     async chat(request) {
         return this.chatHandler.execute(request);

package/dist/types/Middleware.d.ts

@@ -0,0 +1,106 @@
+import { Message } from "../chat/Message.js";
+import { ChatOptions } from "../chat/ChatOptions.js";
+import { ChatResponseString } from "../chat/ChatResponse.js";
+import { ToolCall } from "../chat/Tool.js";
+import { GeneratedImage } from "../image/GeneratedImage.js";
+import { Transcription } from "../transcription/Transcription.js";
+import { Moderation } from "../moderation/Moderation.js";
+import { Embedding } from "../embedding/Embedding.js";
+/**
+ * All possible response types that can be returned by NodeLLM.
+ */
+export type NodeLLMResponse = ChatResponseString | GeneratedImage | Transcription | Moderation | Embedding;
+/**
+ * Context passed to all middleware hooks.
+ * This object is shared across the lifecycle of a single request.
+ */
+export interface MiddlewareContext {
+    /**
+     * Unique ID for tracing the request across the system.
+     */
+    requestId: string;
+    /**
+     * The provider being used (e.g., "openai", "anthropic").
+     */
+    provider: string;
+    /**
+     * The model identifier being used.
+     */
+    model: string;
+    /**
+     * The messages sent to the model (Chat only).
+     * Mutating this array in `onRequest` affects the actual call.
+     */
+    messages?: Message[];
+    /**
+     * Configuration options for the chat request (Chat only).
+     * Mutating this object in `onRequest` affects the actual call.
+     */
+    options?: ChatOptions;
+    /**
+     * Input text(s) for embeddings (Embedding only).
+     */
+    input?: string | string[];
+    /**
+     * Options passed to the embedding request (Embedding only).
+     */
+    embeddingOptions?: Record<string, unknown>;
+    /**
+     * Options passed to the transcription request (Transcription only).
+     */
+    transcriptionOptions?: Record<string, unknown>;
+    /**
+     * Options passed to the moderation request (Moderation only).
+     */
+    moderationOptions?: Record<string, unknown>;
+    /**
+     * Options passed to the image generation request (Paint only).
+     */
+    imageOptions?: Record<string, unknown>;
+    /**
+     * Shared state storage for passing data between middleware hooks.
+     * Example: Storing start time in `onRequest` and reading it in `onResponse`.
+     */
+    state: Record<string, unknown>;
+}
+/**
+ * Directives for handling tool execution errors.
+ */
+export type ToolErrorDirective = "STOP" | "CONTINUE" | "RETRY" | void;
+/**
+ * Middleware interface for hooking into the LLM execution lifecycle.
+ */
+export interface Middleware {
+    /**
+     * Name of the middleware (useful for debugging).
+     */
+    name: string;
+    /**
+     * Called before the request is sent to the provider.
+     * Can allow modifying messages or options.
+     */
+    onRequest?(ctx: MiddlewareContext): Promise<void>;
+    /**
+     * Called after a successful response from the provider.
+     */
+    onResponse?(ctx: MiddlewareContext, result: NodeLLMResponse): Promise<void>;
+    /**
+     * Called if an error occurs during execution.
+     */
+    onError?(ctx: MiddlewareContext, error: Error): Promise<void>;
+    /**
+     * Called before a tool is executed.
+     * Throwing here will prevent the tool from running.
+     */
+    onToolCallStart?(ctx: MiddlewareContext, tool: ToolCall): Promise<void>;
+    /**
+     * Called after a tool completes successfully.
+     */
+    onToolCallEnd?(ctx: MiddlewareContext, tool: ToolCall, result: unknown): Promise<void>;
+    /**
+     * Called if a tool execution fails.
+     * Can return a directive to tell the engine how to proceed.
+     */
+    onToolCallError?(ctx: MiddlewareContext, tool: ToolCall, error: Error): Promise<ToolErrorDirective>;
+}
+//# sourceMappingURL=Middleware.d.ts.map

package/dist/types/Middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Middleware.d.ts","sourceRoot":"","sources":["../../src/types/Middleware.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAClE,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAEtD;;GAEG;AACH,MAAM,MAAM,eAAe,GACvB,kBAAkB,GAClB,cAAc,GACd,aAAa,GACb,UAAU,GACV,SAAS,CAAC;AAEd;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IAErB;;;OAGG;IACH,OAAO,CAAC,EAAE,WAAW,CAAC;IAEtB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAE1B;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE3C;;OAEG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE/C;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE5C;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEvC;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,UAAU,GAAG,OAAO,GAAG,IAAI,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,SAAS,CAAC,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElD;;OAEG;IACH,UAAU,CAAC,CAAC,GAAG,EAAE,iBAAiB,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5E;;OAEG;IACH,OAAO,CAAC,CAAC,GAAG,EAAE,iBAAiB,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9D;;;OAGG;IACH,eAAe,CAAC,CAAC,GAAG,EAAE,iBAAiB,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExE;;OAEG;IACH,aAAa,CAAC,CAAC,GAAG,EAAE,iBAAiB,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvF;;;OAGG;IACH,eAAe,CAAC,CACd,GAAG,EAAE,iBAAiB,EACtB,IAAI,EAAE,QAAQ,EACd,KAAK,EAAE,KAAK,GACX,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAChC"}

package/dist/types/Middleware.js

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

package/dist/utils/middleware-runner.d.ts

@@ -0,0 +1,7 @@
+import { Middleware, MiddlewareContext } from "../types/Middleware.js";
+/**
+ * Helper to execute middleware chains in order.
+ * @internal
+ */
+export declare function runMiddleware<T = void>(middlewares: Middleware[], hookName: keyof Middleware, context: MiddlewareContext, ...args: any[]): Promise<T | undefined>;
+//# sourceMappingURL=middleware-runner.d.ts.map

package/dist/utils/middleware-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware-runner.d.ts","sourceRoot":"","sources":["../../src/utils/middleware-runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEvE;;;GAGG;AACH,wBAAsB,aAAa,CAAC,CAAC,GAAG,IAAI,EAC1C,WAAW,EAAE,UAAU,EAAE,EACzB,QAAQ,EAAE,MAAM,UAAU,EAC1B,OAAO,EAAE,iBAAiB,EAC1B,GAAG,IAAI,EAAE,GAAG,EAAE,GACb,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAuBxB"}

package/dist/utils/middleware-runner.js

@@ -0,0 +1,23 @@
+/**
+ * Helper to execute middleware chains in order.
+ * @internal
+ */
+export async function runMiddleware(middlewares, hookName, context, ...args) {
+    if (!middlewares || middlewares.length === 0)
+        return undefined;
+    // Response and error hooks run in reverse order (stack model)
+    const isReverse = ["onResponse", "onError", "onToolCallEnd", "onToolCallError"].includes(hookName);
+    const chain = isReverse ? [...middlewares].reverse() : middlewares;
+    let finalResult;
+    for (const middleware of chain) {
+        if (typeof middleware[hookName] === "function") {
+            // @ts-ignore
+            const result = await middleware[hookName](context, ...args);
+            // Capture the first non-void result (for directives)
+            if (result !== undefined && finalResult === undefined) {
+                finalResult = result;
+            }
+        }
+    }
+    return finalResult;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@node-llm/core",
-  "version": "1.9.0",
+  "version": "1.11.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -11,6 +11,9 @@
     }
   },
   "description": "A provider-agnostic LLM core for Node.js, inspired by ruby-llm.",
+  "publishConfig": {
+    "access": "public"
+  },
   "keywords": [
     "llm",
     "large-language-models",
@@ -40,7 +43,7 @@
     "url": "https://github.com/node-llm/node-llm",
     "directory": "packages/core"
   },
-  "homepage": "https://node-llm.eshaiju.com",
+  "homepage": "https://nodellm.dev",
   "bugs": {
     "url": "https://github.com/node-llm/node-llm/issues"
   },
@@ -67,6 +70,7 @@
     "dev": "tsc -w",
     "lint": "tsc --noEmit",
     "test": "vitest run",
+    "test:docs": "vitest run test/docs",
     "test:watch": "vitest"
   }
 }