@easynet/agent-llm 1.0.15 → 1.0.16

package/dist/index.js

@@ -1,4 +1,5 @@
 import {
+  AGENT_LLM_PROVIDER_FIELD,
   CIS_UNREACHABLE_REMINDER,
   NPM_PROTOCOL_PREFIX,
   buildUnreachableError,
@@ -6,10 +7,6 @@ import {
   createAgentLlM,
   createChatModelFromLlmConfig,
   createChatModelFromLlmConfigWithNpm,
-  createClient,
-  createOpenAIChatClient,
-  createOpenAIClient,
-  createOpenAIImageClient,
   discoverLLMExtensions,
   ensureNpmPackageInstalled,
   getChatModelFactory,
@@ -23,41 +20,11 @@ import {
   parseLlmYaml,
   parseNpmProviderSpec,
   registerChatModelProvider,
-  registerProvider,
   resolveLLMExtensionPackages,
   resolveLlmSectionWithNpm,
   resolveNpmProvider,
   substituteEnv
-} from "./chunk-AZDHRCIM.js";
-
-// src/registry/client.ts
-function createLLMRegistry(options) {
-  const { defaultId, configs } = parseLlmSection(options.llmSection);
-  const map = /* @__PURE__ */ new Map();
-  for (const config of configs) {
-    try {
-      const client = createClient(config);
-      map.set(config.id, client);
-    } catch (err) {
-      console.warn(`[agent-llm] Skip LLM "${config.id}": ${err instanceof Error ? err.message : String(err)}`);
-    }
-  }
-  return {
-    get(id) {
-      return map.get(id);
-    },
-    defaultId() {
-      if (map.has(defaultId)) return defaultId;
-      return map.size > 0 ? [...map.keys()][0] : void 0;
-    },
-    ids() {
-      return [...map.keys()];
-    }
-  };
-}
-
-// src/types.ts
-var AGENT_LLM_PROVIDER_FIELD = "agentLlmProvider";
+} from "./chunk-CWU7GNFB.js";
 export {
   AGENT_LLM_PROVIDER_FIELD,
   CIS_UNREACHABLE_REMINDER,
@@ -67,11 +34,6 @@ export {
   createAgentLlM,
   createChatModelFromLlmConfig,
   createChatModelFromLlmConfigWithNpm,
-  createClient,
-  createLLMRegistry,
-  createOpenAIChatClient,
-  createOpenAIClient,
-  createOpenAIImageClient,
   discoverLLMExtensions,
   ensureNpmPackageInstalled,
   getChatModelFactory,
@@ -85,7 +47,6 @@ export {
   parseLlmYaml,
   parseNpmProviderSpec,
   registerChatModelProvider,
-  registerProvider,
   resolveLLMExtensionPackages,
   resolveLlmSectionWithNpm,
   resolveNpmProvider,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/registry/client.ts","../src/types.ts"],"sourcesContent":["/**\n * Create LLM registry from agent.yaml llm section.\n */\n\nimport { parseLlmSection } from \"../config/parser.js\";\nimport { createClient } from \"../providers/index.js\";\nimport type { AgentConfigLlmSection, ILLMClient, ILLMRegistry } from \"../types.js\";\n\nexport interface CreateLLMRegistryOptions {\n  /** Parsed llm section (e.g. from loadAgentConfig's config.llm) */\n  llmSection: AgentConfigLlmSection | null | undefined;\n}\n\n/**\n * Create LLM registry from agent config llm section; supports multiple providers/models, each LLM has id and type.\n */\nexport function createLLMRegistry(options: CreateLLMRegistryOptions): ILLMRegistry {\n  const { defaultId, configs } = parseLlmSection(options.llmSection);\n  const map = new Map<string, ILLMClient>();\n\n  for (const config of configs) {\n    try {\n      const client = createClient(config);\n      map.set(config.id, client);\n    } catch (err) {\n      console.warn(`[agent-llm] Skip LLM \"${config.id}\": ${err instanceof Error ? err.message : String(err)}`);\n    }\n  }\n\n  return {\n    get(id: string): ILLMClient | undefined {\n      return map.get(id);\n    },\n    defaultId(): string | undefined {\n      if (map.has(defaultId)) return defaultId;\n      return map.size > 0 ? [...map.keys()][0] : undefined;\n    },\n    ids(): string[] {\n      return [...map.keys()];\n    },\n  };\n}\n","/**\n * Agent LLM: OpenAI-compatible format only (/v1/chat/completions etc.).\n * Multi-instance: each LLM has id and type; optional baseURL for other compatible endpoints.\n */\n\n/** LLM type: chat = conversation, image = image generation (OpenAI-compatible format) */\nexport type LLMType = \"chat\" | \"image\";\n\n/** Single LLM config: id, type, model; OpenAI-compatible API only */\nexport interface LLMConfig {\n  /** Unique id for fetching the instance from the registry */\n  id: string;\n  /** chat | image */\n  type: LLMType;\n  /** Must be openai or openai-compatible; only this format is supported */\n  provider: string;\n  /** Model name, e.g. gpt-4o-mini, dall-e-3 */\n  model?: string;\n  /** Temperature etc.; commonly used for chat */\n  temperature?: number;\n  /** API key; can also be set via env */\n  apiKey?: string;\n  /** OpenAI-compatible endpoint baseURL (e.g. Azure, local proxy, other /v1-compatible vendors) */\n  baseURL?: string;\n  /** Other options (passed through) */\n  [key: string]: unknown;\n}\n\n/** agent.yaml llm section: flat (each model keyed by name), default+instances, or single object */\nexport interface AgentConfigLlmSection {\n  /** Default model name (id) to use */\n  default?: string;\n  /** npm package name or array for dynamic load; e.g. \"wallee-llm\" or [\"wallee-llm\"] */\n  type?: string | string[];\n  /** Array of LLM configs */\n  instances?: LLMConfig[];\n  /** Single-object form: provider, model etc., parsed as id=default chat */\n  provider?: string;\n  model?: string;\n  name?: string;\n  temperature?: number;\n  apiKey?: string;\n  baseURL?: string;\n  base_url?: string;\n  /** Flat: strong/medium/fast etc. name → config (provider, base_url, name, options) */\n  [key: string]: unknown;\n}\n\n/** Single chat message */\nexport interface ChatMessage {\n  role: \"system\" | \"user\" | \"assistant\";\n  content: string;\n}\n\n/** Minimal chat result */\nexport interface ChatResult {\n  content: string;\n  usage?: { promptTokens?: number; completionTokens?: number };\n}\n\n/** Stream chunk for chat responses */\nexport interface ChatStreamChunk {\n  content: string;\n  done: boolean;\n  usage?: { promptTokens?: number; completionTokens?: number };\n}\n\n/** OpenAI-compatible tool definition (function) */\nexport interface ToolDefinition {\n  type: \"function\";\n  function: {\n    name: string;\n    description?: string;\n    parameters?: object;\n  };\n}\n\n/** Message with tool calls (assistant may include tool_calls; tool = tool result) */\nexport type ChatWithToolsMessage =\n  | ChatMessage\n  | { role: \"tool\"; content: string; tool_call_id: string }\n  | {\n      role: \"assistant\";\n      content?: string | null;\n      tool_calls?: Array<{\n        id: string;\n        type: \"function\";\n        function: { name: string; arguments: string };\n      }>;\n    };\n\n/** Chat result with tool calls */\nexport interface ChatWithToolsResult {\n  message: {\n    role: \"assistant\";\n    content?: string | null;\n    tool_calls?: Array<{\n      id: string;\n      type: \"function\";\n      function: { name: string; arguments: string };\n    }>;\n  };\n  usage?: { promptTokens?: number; completionTokens?: number };\n}\n\n/** Stream chunk for chat with tools responses */\nexport interface ChatWithToolsStreamChunk {\n  delta: {\n    role?: \"assistant\";\n    content?: string | null;\n    tool_calls?: Array<{\n      index: number;\n      id?: string;\n      type?: \"function\";\n      function?: { name?: string; arguments?: string };\n    }>;\n  };\n  done: boolean;\n  usage?: { promptTokens?: number; completionTokens?: number };\n}\n\n/** Image generation result */\nexport interface ImageResult {\n  url?: string;\n  b64?: string;\n}\n\n/**\n * Minimal interface for a single LLM instance.\n * type=chat provides chat; type=image provides generateImage.\n * chat type may optionally provide chatWithTools for ReAct/Agent tool calling.\n */\nexport interface ILLMClient {\n  readonly id: string;\n  readonly type: LLMType;\n  /** Chat (available when type=chat) */\n  chat(messages: ChatMessage[]): Promise<ChatResult>;\n  /**\n   * Chat with streaming (optional when type=chat).\n   * Returns an async generator that yields chunks as they arrive.\n   */\n  chatStream?(messages: ChatMessage[]): AsyncGenerator<ChatStreamChunk, void, unknown>;\n  /**\n   * Chat with tools (optional when type=chat; for ReAct/Agent).\n   * If not implemented, caller may poll with chat or use another client.\n   */\n  chatWithTools?(\n    messages: ChatWithToolsMessage[],\n    tools: ToolDefinition[],\n    options?: { timeoutMs?: number }\n  ): Promise<ChatWithToolsResult>;\n  /**\n   * Chat with tools and streaming (optional when type=chat).\n   * Returns an async generator that yields chunks as they arrive.\n   */\n  chatWithToolsStream?(\n    messages: ChatWithToolsMessage[],\n    tools: ToolDefinition[],\n    options?: { timeoutMs?: number }\n  ): AsyncGenerator<ChatWithToolsStreamChunk, void, unknown>;\n  /** Image generation (when type=image); otherwise may throw or be ignored */\n  generateImage?(options: { prompt: string; size?: string; n?: number }): Promise<ImageResult>;\n}\n\n/**\n * LLM registry created from llm section: get instance by id.\n */\nexport interface ILLMRegistry {\n  get(id: string): ILLMClient | undefined;\n  defaultId(): string | undefined;\n  ids(): string[];\n}\n\n/**\n * Generic interface for an LLM provider extension (npm package).\n * Implement getLLMExtension() returning this; framework will register the provider when loading.\n * Prefer createClient + createChatModel so the framework does registration (extension need not call register).\n */\nexport interface ILLMExtension {\n  /** Provider name (e.g. \"openai\" or extension-specific name). Framework registers under this name. */\n  readonly providerName: string;\n  /** ILLMClient factory. If present with createChatModel, framework calls registerProvider(providerName, createClient). */\n  readonly createClient?: (config: LLMConfig) => ILLMClient;\n  /** LangChain ChatModel factory. If present with createClient, framework calls registerChatModelProvider(providerName, createChatModel). */\n  readonly createChatModel?: (config: LLMConfig) => unknown;\n  /** Legacy: if extension provides register(), framework calls it. Prefer createClient + createChatModel so framework registers. */\n  register?(): void;\n}\n\n/** package.json field: when true, the package is an agent-llm provider (for discovery). */\nexport const AGENT_LLM_PROVIDER_FIELD = \"agentLlmProvider\";\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgBO,SAAS,kBAAkB,SAAiD;AACjF,QAAM,EAAE,WAAW,QAAQ,IAAI,gBAAgB,QAAQ,UAAU;AACjE,QAAM,MAAM,oBAAI,IAAwB;AAExC,aAAW,UAAU,SAAS;AAC5B,QAAI;AACF,YAAM,SAAS,aAAa,MAAM;AAClC,UAAI,IAAI,OAAO,IAAI,MAAM;AAAA,IAC3B,SAAS,KAAK;AACZ,cAAQ,KAAK,yBAAyB,OAAO,EAAE,MAAM,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG,CAAC,EAAE;AAAA,IACzG;AAAA,EACF;AAEA,SAAO;AAAA,IACL,IAAI,IAAoC;AACtC,aAAO,IAAI,IAAI,EAAE;AAAA,IACnB;AAAA,IACA,YAAgC;AAC9B,UAAI,IAAI,IAAI,SAAS,EAAG,QAAO;AAC/B,aAAO,IAAI,OAAO,IAAI,CAAC,GAAG,IAAI,KAAK,CAAC,EAAE,CAAC,IAAI;AAAA,IAC7C;AAAA,IACA,MAAgB;AACd,aAAO,CAAC,GAAG,IAAI,KAAK,CAAC;AAAA,IACvB;AAAA,EACF;AACF;;;ACqJO,IAAM,2BAA2B;","names":[]}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/langchain/index.d.ts

@@ -1,6 +1,16 @@
 /**
- * LangChain module: adapter for creating LangChain ChatModels from config.
+ * LangChain module: create ChatOpenAI from llm config.
+ * Uses @langchain/openai only; extensions can register custom ChatModel factories.
  */
-export { createChatModelFromLlmConfig } from "./adapter.js";
-export type { CreateChatModelFromLlmConfigOptions } from "./adapter.js";
+import type { BaseChatModel } from "@langchain/core/language_models/chat_models";
+export interface CreateChatModelFromLlmConfigOptions {
+    llmSection?: unknown;
+    modelEnv?: string;
+    apiKeyEnv?: string;
+}
+/**
+ * Create a LangChain ChatModel from agent config llm section.
+ * Uses extension-registered factory when available; otherwise ChatOpenAI from @langchain/openai.
+ */
+export declare function createChatModelFromLlmConfig(options: CreateChatModelFromLlmConfigOptions): BaseChatModel;
 //# sourceMappingURL=index.d.ts.map

package/dist/langchain/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/langchain/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,4BAA4B,EAAE,MAAM,cAAc,CAAC;AAC5D,YAAY,EAAE,mCAAmC,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/langchain/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC;AAMjF,MAAM,WAAW,mCAAmC;IAClD,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAOD;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,mCAAmC,GAC3C,aAAa,CA0Ef"}

package/dist/registry/chat-model.d.ts

@@ -1,17 +1,10 @@
 /**
  * Registry for LangChain ChatModel by provider name.
- * Extensions register via registerChatModelProvider; llmAdapter uses getChatModelFactory.
+ * Extensions register via registerChatModelProvider.
  */
 import type { BaseChatModel } from "@langchain/core/language_models/chat_models";
 import type { LLMConfig } from "../types.js";
 export type ChatModelFactory = (config: LLMConfig) => BaseChatModel;
-/**
- * Register a ChatModel factory for a provider name.
- * Called by extensions (e.g. wallee-llm) on load.
- */
 export declare function registerChatModelProvider(providerName: string, factory: ChatModelFactory): void;
-/**
- * Get the ChatModel factory for a provider name, if registered.
- */
 export declare function getChatModelFactory(providerName: string): ChatModelFactory | undefined;
 //# sourceMappingURL=chat-model.d.ts.map

package/dist/registry/chat-model.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chat-model.d.ts","sourceRoot":"","sources":["../../src/registry/chat-model.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC;AACjF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,SAAS,KAAK,aAAa,CAAC;AAIpE;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAE/F;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAEtF"}
+{"version":3,"file":"chat-model.d.ts","sourceRoot":"","sources":["../../src/registry/chat-model.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC;AACjF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,SAAS,KAAK,aAAa,CAAC;AAIpE,wBAAgB,yBAAyB,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAE/F;AAED,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAEtF"}

package/dist/registry/index.d.ts

@@ -1,8 +1,3 @@
-/**
- * Registry module: manage LLM client and ChatModel registries.
- */
-export { createLLMRegistry } from "./client.js";
-export type { CreateLLMRegistryOptions } from "./client.js";
 export { registerChatModelProvider, getChatModelFactory } from "./chat-model.js";
 export type { ChatModelFactory } from "./chat-model.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/registry/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,YAAY,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACjF,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACjF,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/types.d.ts

@@ -1,37 +1,22 @@
 /**
- * Agent LLM: OpenAI-compatible format only (/v1/chat/completions etc.).
- * Multi-instance: each LLM has id and type; optional baseURL for other compatible endpoints.
+ * Agent LLM: OpenAI-compatible config only. No custom client types.
+ * LangChain ChatOpenAI is the single implementation.
  */
-/** LLM type: chat = conversation, image = image generation (OpenAI-compatible format) */
 export type LLMType = "chat" | "image";
-/** Single LLM config: id, type, model; OpenAI-compatible API only */
 export interface LLMConfig {
-    /** Unique id for fetching the instance from the registry */
     id: string;
-    /** chat | image */
     type: LLMType;
-    /** Must be openai or openai-compatible; only this format is supported */
     provider: string;
-    /** Model name, e.g. gpt-4o-mini, dall-e-3 */
     model?: string;
-    /** Temperature etc.; commonly used for chat */
     temperature?: number;
-    /** API key; can also be set via env */
     apiKey?: string;
-    /** OpenAI-compatible endpoint baseURL (e.g. Azure, local proxy, other /v1-compatible vendors) */
     baseURL?: string;
-    /** Other options (passed through) */
     [key: string]: unknown;
 }
-/** agent.yaml llm section: flat (each model keyed by name), default+instances, or single object */
 export interface AgentConfigLlmSection {
-    /** Default model name (id) to use */
     default?: string;
-    /** npm package name or array for dynamic load; e.g. "wallee-llm" or ["wallee-llm"] */
     type?: string | string[];
-    /** Array of LLM configs */
     instances?: LLMConfig[];
-    /** Single-object form: provider, model etc., parsed as id=default chat */
     provider?: string;
     model?: string;
     name?: string;
@@ -39,161 +24,19 @@ export interface AgentConfigLlmSection {
     apiKey?: string;
     baseURL?: string;
     base_url?: string;
-    /** Flat: strong/medium/fast etc. name → config (provider, base_url, name, options) */
     [key: string]: unknown;
 }
-/** Single chat message */
-export interface ChatMessage {
-    role: "system" | "user" | "assistant";
-    content: string;
-}
-/** Minimal chat result */
-export interface ChatResult {
-    content: string;
-    usage?: {
-        promptTokens?: number;
-        completionTokens?: number;
-    };
-}
-/** Stream chunk for chat responses */
-export interface ChatStreamChunk {
-    content: string;
-    done: boolean;
-    usage?: {
-        promptTokens?: number;
-        completionTokens?: number;
-    };
-}
-/** OpenAI-compatible tool definition (function) */
-export interface ToolDefinition {
-    type: "function";
-    function: {
-        name: string;
-        description?: string;
-        parameters?: object;
-    };
-}
-/** Message with tool calls (assistant may include tool_calls; tool = tool result) */
-export type ChatWithToolsMessage = ChatMessage | {
-    role: "tool";
-    content: string;
-    tool_call_id: string;
-} | {
-    role: "assistant";
-    content?: string | null;
-    tool_calls?: Array<{
-        id: string;
-        type: "function";
-        function: {
-            name: string;
-            arguments: string;
-        };
-    }>;
-};
-/** Chat result with tool calls */
-export interface ChatWithToolsResult {
-    message: {
-        role: "assistant";
-        content?: string | null;
-        tool_calls?: Array<{
-            id: string;
-            type: "function";
-            function: {
-                name: string;
-                arguments: string;
-            };
-        }>;
-    };
-    usage?: {
-        promptTokens?: number;
-        completionTokens?: number;
-    };
-}
-/** Stream chunk for chat with tools responses */
-export interface ChatWithToolsStreamChunk {
-    delta: {
-        role?: "assistant";
-        content?: string | null;
-        tool_calls?: Array<{
-            index: number;
-            id?: string;
-            type?: "function";
-            function?: {
-                name?: string;
-                arguments?: string;
-            };
-        }>;
-    };
-    done: boolean;
-    usage?: {
-        promptTokens?: number;
-        completionTokens?: number;
-    };
-}
-/** Image generation result */
-export interface ImageResult {
-    url?: string;
-    b64?: string;
-}
-/**
- * Minimal interface for a single LLM instance.
- * type=chat provides chat; type=image provides generateImage.
- * chat type may optionally provide chatWithTools for ReAct/Agent tool calling.
- */
-export interface ILLMClient {
-    readonly id: string;
-    readonly type: LLMType;
-    /** Chat (available when type=chat) */
-    chat(messages: ChatMessage[]): Promise<ChatResult>;
-    /**
-     * Chat with streaming (optional when type=chat).
-     * Returns an async generator that yields chunks as they arrive.
-     */
-    chatStream?(messages: ChatMessage[]): AsyncGenerator<ChatStreamChunk, void, unknown>;
-    /**
-     * Chat with tools (optional when type=chat; for ReAct/Agent).
-     * If not implemented, caller may poll with chat or use another client.
-     */
-    chatWithTools?(messages: ChatWithToolsMessage[], tools: ToolDefinition[], options?: {
-        timeoutMs?: number;
-    }): Promise<ChatWithToolsResult>;
-    /**
-     * Chat with tools and streaming (optional when type=chat).
-     * Returns an async generator that yields chunks as they arrive.
-     */
-    chatWithToolsStream?(messages: ChatWithToolsMessage[], tools: ToolDefinition[], options?: {
-        timeoutMs?: number;
-    }): AsyncGenerator<ChatWithToolsStreamChunk, void, unknown>;
-    /** Image generation (when type=image); otherwise may throw or be ignored */
-    generateImage?(options: {
-        prompt: string;
-        size?: string;
-        n?: number;
-    }): Promise<ImageResult>;
-}
-/**
- * LLM registry created from llm section: get instance by id.
- */
-export interface ILLMRegistry {
-    get(id: string): ILLMClient | undefined;
-    defaultId(): string | undefined;
-    ids(): string[];
-}
+/** package.json field: when true, the package is an agent-llm provider (for discovery). */
+export declare const AGENT_LLM_PROVIDER_FIELD = "agentLlmProvider";
 /**
- * Generic interface for an LLM provider extension (npm package).
- * Implement getLLMExtension() returning this; framework will register the provider when loading.
- * Prefer createClient + createChatModel so the framework does registration (extension need not call register).
+ * Extension interface: register a ChatModel factory by provider name.
+ * Extensions implement getLLMExtension(); framework registers the factory when loading.
  */
 export interface ILLMExtension {
-    /** Provider name (e.g. "openai" or extension-specific name). Framework registers under this name. */
     readonly providerName: string;
-    /** ILLMClient factory. If present with createChatModel, framework calls registerProvider(providerName, createClient). */
-    readonly createClient?: (config: LLMConfig) => ILLMClient;
-    /** LangChain ChatModel factory. If present with createClient, framework calls registerChatModelProvider(providerName, createChatModel). */
+    /** LangChain ChatModel factory. Framework calls registerChatModelProvider(providerName, createChatModel). */
     readonly createChatModel?: (config: LLMConfig) => unknown;
-    /** Legacy: if extension provides register(), framework calls it. Prefer createClient + createChatModel so framework registers. */
+    /** Legacy: if extension provides register(), framework calls it. */
     register?(): void;
 }
-/** package.json field: when true, the package is an agent-llm provider (for discovery). */
-export declare const AGENT_LLM_PROVIDER_FIELD = "agentLlmProvider";
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;AAEvC,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACzB,SAAS,CAAC,EAAE,SAAS,EAAE,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,2FAA2F;AAC3F,eAAO,MAAM,wBAAwB,qBAAqB,CAAC;AAE3D;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,6GAA6G;IAC7G,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,OAAO,CAAC;IAC1D,oEAAoE;IACpE,QAAQ,CAAC,IAAI,IAAI,CAAC;CACnB"}

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@easynet/agent-llm",
-  "version": "1.0.15",
+  "version": "1.0.16",
   "description": "Agent LLM: multi-provider, multi-model, simple chat/image API. Consumes agent.yaml llm section.",
   "type": "module",
   "bin": {
-    "agent-llm": "./dist/cli.js",
-    "@easynet/agent-llm": "./dist/cli.js"
+    "agent-llm": "./dist/cli/index.js",
+    "@easynet/agent-llm": "./dist/cli/index.js"
   },
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -14,8 +14,9 @@
     "dev": "tsup --watch",
     "test": "vitest run",
     "test:watch": "vitest",
-    "test:llm-live": "vitest run llm-live.test.ts",
-    "test:link": "vitest run -t 'invokes OpenAI-compatible API'",
+    "test:unit": "vitest run test/unit",
+    "test:integration": "vitest run test/integration",
+    "test:live": "vitest run test/integration/llm-live.test.ts",
     "example:agent": "cd examples && npm run start",
     "typecheck": "tsc --noEmit"
   },