@easynet/agent-llm 1.0.15 → 1.0.25

package/dist/extensions/npm-protocol.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"npm-protocol.d.ts","sourceRoot":"","sources":["../../src/extensions/npm-protocol.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,OAAO,KAAK,EAAE,mCAAmC,EAAE,MAAM,yBAAyB,CAAC;AACnF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC;AAEjF,eAAO,MAAM,mBAAmB,SAAS,CAAC;AAK1C;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GAC7B,OAAO,CAAC,MAAM,CAAC,CAejB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,MAAM,GAAG,IAAI,CAUtG;AAED,4FAA4F;AAC5F,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAYtH;AAED,MAAM,WAAW,gCAAgC;IAC/C,4KAA4K;IAC5K,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,MAAM,CAE/D;AA6BD;;;;GAIG;AACH,wBAAsB,yBAAyB,CAC7C,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,gCAAqC,GAC7C,OAAO,CAAC,IAAI,CAAC,CA8Cf;AAED,MAAM,WAAW,yBAAyB;IACxC,kFAAkF;IAClF,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,gEAAgE;IAChE,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAkBD,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,yBAA8B,GACtC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAwDxB;AAED,MAAM,WAAW,+BAAgC,SAAQ,yBAAyB;CAAG;AAErF;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,UAAU,EAAE,OAAO,EACnB,OAAO,GAAE,+BAAoC,GAC5C,OAAO,CAAC,OAAO,CAAC,CAkClB;AAED,MAAM,WAAW,0CACf,SAAQ,mCAAmC,EACzC,yBAAyB;CAAG;AAEhC;;;;GAIG;AACH,wBAAsB,mCAAmC,CACvD,OAAO,EAAE,0CAA0C,GAClD,OAAO,CAAC,aAAa,CAAC,CAcxB"}
+{"version":3,"file":"npm-protocol.d.ts","sourceRoot":"","sources":["../../src/extensions/npm-protocol.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC;AAIjF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAEpE,eAAO,MAAM,mBAAmB,SAAS,CAAC;AAG1C,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GAC7B,OAAO,CAAC,MAAM,CAAC,CAejB;AAED,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,MAAM,GAAG,IAAI,CAUtG;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAWtH;AAED,MAAM,WAAW,gCAAgC;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,MAAM,CAE/D;AAiCD;;;;GAIG;AACH,wBAAsB,yBAAyB,CAC7C,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,gCAAqC,GAC7C,OAAO,CAAC,IAAI,CAAC,CAsBf;AAED,MAAM,WAAW,yBAAyB;IACxC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAOD,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,yBAA8B,GACtC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAsDxB;AAED,MAAM,WAAW,+BAAgC,SAAQ,yBAAyB;CAAG;AAErF,wBAAsB,wBAAwB,CAC5C,UAAU,EAAE,OAAO,EACnB,OAAO,GAAE,+BAAoC,GAC5C,OAAO,CAAC,OAAO,CAAC,CAkClB;AAED,MAAM,WAAW,6BACf,SAAQ,sBAAsB,EAC5B,yBAAyB;CAAG;AAEhC,wBAAsB,sBAAsB,CAC1C,OAAO,GAAE,6BAAkC,GAC1C,OAAO,CAAC,aAAa,CAAC,CAcxB"}

package/dist/index.d.ts

@@ -1,25 +1,30 @@
 /**
- * @easynet/agent-llm: multi-provider, multi-model LLM with id and type.
- * Consumes agent.yaml llm section; provides simple chat/image API.
- * Extensions register via registerProvider/registerChatModelProvider; call loadLLMExtensions() before using them.
+ * @easynet/agent-llm: Simple LangChain ChatModel from llm.yaml.
+ * Multi-provider support via extensions; default is ChatOpenAI from @langchain/openai.
  */
 export { parseLlmSection } from "./config/parser.js";
 export { loadLlmConfig, parseLlmYaml, substituteEnv } from "./config/loader.js";
+export { loadYamlConfig } from "./config/yaml.js";
 export type { LoadLlmConfigOptions } from "./config/loader.js";
-export { createLLMRegistry } from "./registry/client.js";
-export type { CreateLLMRegistryOptions } from "./registry/client.js";
+export { deepMerge } from "./utils/deep-merge.js";
+export { createChatOpenAI } from "./langchain/openai-compatible.js";
+export type { CreateChatOpenAIOptions } from "./langchain/openai-compatible.js";
+export { createChatModelFromLlmConfig } from "./langchain/index.js";
+export type { CreateChatModelOptions } from "./langchain/index.js";
 export { registerChatModelProvider, getChatModelFactory } from "./registry/chat-model.js";
-export { createClient, registerProvider } from "./providers/index.js";
-export { createOpenAIClient, createOpenAIChatClient, createOpenAIImageClient } from "./providers/openai.js";
-export { createChatModelFromLlmConfig } from "./langchain/adapter.js";
-export type { CreateChatModelFromLlmConfigOptions } from "./langchain/adapter.js";
-export { NPM_PROTOCOL_PREFIX, parseNpmProviderSpec, isNpmProviderSpec, getLatestVersion, getInstalledVersion, ensureNpmPackageInstalled, resolveNpmProvider, resolveLlmSectionWithNpm, createChatModelFromLlmConfigWithNpm, } from "./extensions/npm-protocol.js";
-export type { EnsureNpmPackageInstalledOptions, ResolveNpmProviderOptions, ResolveLlmSectionWithNpmOptions, CreateChatModelFromLlmConfigWithNpmOptions, } from "./extensions/npm-protocol.js";
-export { loadLLMExtensions, resolveLLMExtensionPackages, discoverLLMExtensions, loadDiscoveredExtensions } from "./extensions/loader.js";
+export type { ChatModelFactory } from "./registry/chat-model.js";
+export { NPM_PROTOCOL_PREFIX, parseNpmProviderSpec, isNpmProviderSpec, getLatestVersion, getInstalledVersion, ensureNpmPackageInstalled, resolveNpmProvider, resolveLlmSectionWithNpm, createChatModelWithNpm, } from "./extensions/npm-protocol.js";
+export type { EnsureNpmPackageInstalledOptions, ResolveNpmProviderOptions, ResolveLlmSectionWithNpmOptions, CreateChatModelWithNpmOptions, } from "./extensions/npm-protocol.js";
+export { loadLLMExtensions, resolveLLMExtensionPackages, discoverLLMExtensions, loadDiscoveredExtensions, } from "./extensions/loader.js";
+export type { LoadLLMExtensionsOptions } from "./extensions/loader.js";
 export { createAgentLlM } from "./api/create-agent-llm.js";
 export type { CreateAgentLlMOptions } from "./api/create-agent-llm.js";
+export { getDefaultLlmConfig } from "./api/get-default-llm-config.js";
+export type { GetDefaultLlmConfigOptions } from "./api/get-default-llm-config.js";
+export { messageContentToString, exitWithError } from "./cli/utils.js";
 export { checkEndpointConnectivity, buildUnreachableError, CIS_UNREACHABLE_REMINDER, } from "./connectivity/check.js";
+export type { EndpointConnectivityOptions } from "./connectivity/check.js";
 export type { ConnectionStatus, ConnectionPhase, CheckConnectivityResult, } from "./connectivity/types.js";
-export type { LLMType, LLMConfig, AgentConfigLlmSection, ChatMessage, ChatResult, ChatStreamChunk, ImageResult, ToolDefinition, ChatWithToolsMessage, ChatWithToolsResult, ChatWithToolsStreamChunk, ILLMClient, ILLMRegistry, ILLMExtension, } from "./types.js";
+export type { LLMType, LLMConfig, AgentConfigLlmSection, ILLMExtension, } from "./types.js";
 export { AGENT_LLM_PROVIDER_FIELD } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAChF,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAG/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,YAAY,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAG1F,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAG5G,OAAO,EAAE,4BAA4B,EAAE,MAAM,wBAAwB,CAAC;AACtE,YAAY,EAAE,mCAAmC,EAAE,MAAM,wBAAwB,CAAC;AAGlF,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,yBAAyB,EACzB,kBAAkB,EAClB,wBAAwB,EACxB,mCAAmC,GACpC,MAAM,8BAA8B,CAAC;AACtC,YAAY,EACV,gCAAgC,EAChC,yBAAyB,EACzB,+BAA+B,EAC/B,0CAA0C,GAC3C,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,iBAAiB,EAAE,2BAA2B,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAGzI,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,YAAY,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAGvE,OAAO,EACL,yBAAyB,EACzB,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,uBAAuB,GACxB,MAAM,yBAAyB,CAAC;AAGjC,YAAY,EACV,OAAO,EACP,SAAS,EACT,qBAAqB,EACrB,WAAW,EACX,UAAU,EACV,eAAe,EACf,WAAW,EACX,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,wBAAwB,EACxB,UAAU,EACV,YAAY,EACZ,aAAa,GACd,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAChF,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAG/D,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAGlD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,YAAY,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAChF,OAAO,EAAE,4BAA4B,EAAE,MAAM,sBAAsB,CAAC;AACpE,YAAY,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAGnE,OAAO,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC1F,YAAY,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAGjE,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,yBAAyB,EACzB,kBAAkB,EAClB,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,8BAA8B,CAAC;AACtC,YAAY,EACV,gCAAgC,EAChC,yBAAyB,EACzB,+BAA+B,EAC/B,6BAA6B,GAC9B,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EACL,iBAAiB,EACjB,2BAA2B,EAC3B,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAGvE,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,YAAY,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AACtE,YAAY,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAGlF,OAAO,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAGvE,OAAO,EACL,yBAAyB,EACzB,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAC3E,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,uBAAuB,GACxB,MAAM,yBAAyB,CAAC;AAGjC,YAAY,EACV,OAAO,EACP,SAAS,EACT,qBAAqB,EACrB,aAAa,GACd,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,17 +1,16 @@
 import {
+  AGENT_LLM_PROVIDER_FIELD,
   CIS_UNREACHABLE_REMINDER,
   NPM_PROTOCOL_PREFIX,
   buildUnreachableError,
   checkEndpointConnectivity,
   createAgentLlM,
   createChatModelFromLlmConfig,
-  createChatModelFromLlmConfigWithNpm,
-  createClient,
-  createOpenAIChatClient,
-  createOpenAIClient,
-  createOpenAIImageClient,
+  createChatModelWithNpm,
+  createChatOpenAI,
   discoverLLMExtensions,
   ensureNpmPackageInstalled,
+  exitWithError,
   getChatModelFactory,
   getInstalledVersion,
   getLatestVersion,
@@ -19,45 +18,64 @@ import {
   loadDiscoveredExtensions,
   loadLLMExtensions,
   loadLlmConfig,
+  messageContentToString,
   parseLlmSection,
   parseLlmYaml,
   parseNpmProviderSpec,
   registerChatModelProvider,
-  registerProvider,
   resolveLLMExtensionPackages,
   resolveLlmSectionWithNpm,
   resolveNpmProvider,
   substituteEnv
-} from "./chunk-AZDHRCIM.js";
+} from "./chunk-H4UQIDGT.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)}`);
-    }
+// src/config/yaml.ts
+import { readFileSync, existsSync } from "fs";
+import { parse as parseYaml } from "yaml";
+function loadYamlConfig(filePath) {
+  if (!existsSync(filePath)) return {};
+  try {
+    const content = readFileSync(filePath, "utf8");
+    const parsed = parseYaml(content);
+    return parsed || {};
+  } catch (e) {
+    const msg = e instanceof Error ? e.message : String(e);
+    throw new Error(`Failed to load YAML config from ${filePath}: ${msg}`, { cause: e });
   }
-  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/utils/deep-merge.ts
+function deepMerge(target, ...sources) {
+  for (const src of sources) {
+    if (!src || typeof src !== "object") continue;
+    for (const k of Object.keys(src)) {
+      const v = src[k];
+      if (v === void 0) continue;
+      const t = target[k];
+      if (v !== null && typeof v === "object" && !Array.isArray(v) && t !== null && typeof t === "object" && !Array.isArray(t)) {
+        deepMerge(t, v);
+      } else {
+        target[k] = v;
+      }
     }
-  };
+  }
+  return target;
 }
 
-// src/types.ts
-var AGENT_LLM_PROVIDER_FIELD = "agentLlmProvider";
+// src/api/get-default-llm-config.ts
+import { join } from "path";
+async function getDefaultLlmConfig(options = {}) {
+  const configPath = options.configPath ?? join(process.cwd(), "llm.yaml");
+  const llmSection = loadLlmConfig(configPath);
+  if (llmSection == null) return null;
+  const resolved = await resolveLlmSectionWithNpm(llmSection, {
+    installNpmIfMissing: options.installNpmIfMissing !== false,
+    cwd: process.cwd()
+  });
+  const { defaultId, configs } = parseLlmSection(resolved);
+  const defaultConfig = configs.find((c) => c.id === defaultId) ?? configs[0] ?? null;
+  return defaultConfig;
+}
 export {
   AGENT_LLM_PROVIDER_FIELD,
   CIS_UNREACHABLE_REMINDER,
@@ -66,26 +84,26 @@ export {
   checkEndpointConnectivity,
   createAgentLlM,
   createChatModelFromLlmConfig,
-  createChatModelFromLlmConfigWithNpm,
-  createClient,
-  createLLMRegistry,
-  createOpenAIChatClient,
-  createOpenAIClient,
-  createOpenAIImageClient,
+  createChatModelWithNpm,
+  createChatOpenAI,
+  deepMerge,
   discoverLLMExtensions,
   ensureNpmPackageInstalled,
+  exitWithError,
   getChatModelFactory,
+  getDefaultLlmConfig,
   getInstalledVersion,
   getLatestVersion,
   isNpmProviderSpec,
   loadDiscoveredExtensions,
   loadLLMExtensions,
   loadLlmConfig,
+  loadYamlConfig,
+  messageContentToString,
   parseLlmSection,
   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":["../src/config/yaml.ts","../src/utils/deep-merge.ts","../src/api/get-default-llm-config.ts"],"sourcesContent":["/**\n * Generic YAML file loader utility.\n */\n\nimport { readFileSync, existsSync } from \"node:fs\";\nimport { parse as parseYaml } from \"yaml\";\n\n/**\n * Load and parse a YAML file into a typed object.\n * Returns empty object if file doesn't exist.\n */\nexport function loadYamlConfig<T = Record<string, unknown>>(filePath: string): T {\n  if (!existsSync(filePath)) return {} as T;\n\n  try {\n    const content = readFileSync(filePath, \"utf8\");\n    const parsed = parseYaml(content);\n    return (parsed || {}) as T;\n  } catch (e) {\n    const msg = e instanceof Error ? e.message : String(e);\n    throw new Error(`Failed to load YAML config from ${filePath}: ${msg}`, { cause: e });\n  }\n}\n","/**\n * Deep merge: overwrite target with each source (only defined values). Nested objects merged recursively.\n */\n\nexport function deepMerge<T extends object>(target: T, ...sources: Partial<T>[]): T {\n  for (const src of sources) {\n    if (!src || typeof src !== \"object\") continue;\n    for (const k of Object.keys(src) as (keyof T)[]) {\n      const v = src[k];\n      if (v === undefined) continue;\n      const t = (target as Record<keyof T, unknown>)[k];\n      if (\n        v !== null &&\n        typeof v === \"object\" &&\n        !Array.isArray(v) &&\n        t !== null &&\n        typeof t === \"object\" &&\n        !Array.isArray(t)\n      ) {\n        deepMerge(t as object, v as object);\n      } else {\n        (target as Record<keyof T, unknown>)[k] = v;\n      }\n    }\n  }\n  return target;\n}\n","/**\n * Load llm.yaml, resolve npm providers, and return the default LLMConfig.\n * For use by CLIs (e.g. wallee-llm) that need config without creating a model.\n */\n\nimport { join } from \"node:path\";\nimport { loadLlmConfig } from \"../config/loader.js\";\nimport { parseLlmSection } from \"../config/parser.js\";\nimport { resolveLlmSectionWithNpm } from \"../extensions/npm-protocol.js\";\nimport type { LLMConfig } from \"../types.js\";\n\nexport interface GetDefaultLlmConfigOptions {\n  /** Path to llm.yaml. Default: process.cwd() + \"/llm.yaml\" */\n  configPath?: string;\n  /** Install npm provider packages if missing. Default true. */\n  installNpmIfMissing?: boolean;\n}\n\n/**\n * Returns the default LLM config from llm.yaml (after resolving npm: providers), or null if no config file.\n */\nexport async function getDefaultLlmConfig(\n  options: GetDefaultLlmConfigOptions = {}\n): Promise<LLMConfig | null> {\n  const configPath = options.configPath ?? join(process.cwd(), \"llm.yaml\");\n  const llmSection = loadLlmConfig(configPath);\n  if (llmSection == null) return null;\n\n  const resolved = await resolveLlmSectionWithNpm(llmSection, {\n    installNpmIfMissing: options.installNpmIfMissing !== false,\n    cwd: process.cwd(),\n  });\n\n  const { defaultId, configs } = parseLlmSection(resolved);\n  const defaultConfig = configs.find((c) => c.id === defaultId) ?? configs[0] ?? null;\n  return defaultConfig;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAIA,SAAS,cAAc,kBAAkB;AACzC,SAAS,SAAS,iBAAiB;AAM5B,SAAS,eAA4C,UAAqB;AAC/E,MAAI,CAAC,WAAW,QAAQ,EAAG,QAAO,CAAC;AAEnC,MAAI;AACF,UAAM,UAAU,aAAa,UAAU,MAAM;AAC7C,UAAM,SAAS,UAAU,OAAO;AAChC,WAAQ,UAAU,CAAC;AAAA,EACrB,SAAS,GAAG;AACV,UAAM,MAAM,aAAa,QAAQ,EAAE,UAAU,OAAO,CAAC;AACrD,UAAM,IAAI,MAAM,mCAAmC,QAAQ,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,CAAC;AAAA,EACrF;AACF;;;AClBO,SAAS,UAA4B,WAAc,SAA0B;AAClF,aAAW,OAAO,SAAS;AACzB,QAAI,CAAC,OAAO,OAAO,QAAQ,SAAU;AACrC,eAAW,KAAK,OAAO,KAAK,GAAG,GAAkB;AAC/C,YAAM,IAAI,IAAI,CAAC;AACf,UAAI,MAAM,OAAW;AACrB,YAAM,IAAK,OAAoC,CAAC;AAChD,UACE,MAAM,QACN,OAAO,MAAM,YACb,CAAC,MAAM,QAAQ,CAAC,KAChB,MAAM,QACN,OAAO,MAAM,YACb,CAAC,MAAM,QAAQ,CAAC,GAChB;AACA,kBAAU,GAAa,CAAW;AAAA,MACpC,OAAO;AACL,QAAC,OAAoC,CAAC,IAAI;AAAA,MAC5C;AAAA,IACF;AAAA,EACF;AACA,SAAO;AACT;;;ACrBA,SAAS,YAAY;AAgBrB,eAAsB,oBACpB,UAAsC,CAAC,GACZ;AAC3B,QAAM,aAAa,QAAQ,cAAc,KAAK,QAAQ,IAAI,GAAG,UAAU;AACvE,QAAM,aAAa,cAAc,UAAU;AAC3C,MAAI,cAAc,KAAM,QAAO;AAE/B,QAAM,WAAW,MAAM,yBAAyB,YAAY;AAAA,IAC1D,qBAAqB,QAAQ,wBAAwB;AAAA,IACrD,KAAK,QAAQ,IAAI;AAAA,EACnB,CAAC;AAED,QAAM,EAAE,WAAW,QAAQ,IAAI,gBAAgB,QAAQ;AACvD,QAAM,gBAAgB,QAAQ,KAAK,CAAC,MAAM,EAAE,OAAO,SAAS,KAAK,QAAQ,CAAC,KAAK;AAC/E,SAAO;AACT;","names":[]}

package/dist/langchain/index.d.ts

@@ -1,6 +1,16 @@
 /**
- * LangChain module: adapter for creating LangChain ChatModels from config.
+ * Simple LangChain module: create ChatOpenAI from llm config.
+ * Extensions can register custom ChatModel factories via the registry.
  */
-export { createChatModelFromLlmConfig } from "./adapter.js";
-export type { CreateChatModelFromLlmConfigOptions } from "./adapter.js";
+import type { BaseChatModel } from "@langchain/core/language_models/chat_models";
+export interface CreateChatModelOptions {
+    llmSection?: unknown;
+    modelEnv?: string;
+    apiKeyEnv?: string;
+}
+/**
+ * Create a LangChain ChatModel from agent config llm section.
+ * Uses extension-registered factory when available; otherwise creates ChatOpenAI.
+ */
+export declare function createChatModelFromLlmConfig(options?: CreateChatModelOptions): 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;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC;AASjF,MAAM,WAAW,sBAAsB;IACrC,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,GAAE,sBAA2B,GACnC,aAAa,CA4Ef"}

package/dist/langchain/openai-compatible.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Create ChatOpenAI from config - works with any OpenAI-compatible provider.
+ * This is the ONLY place we create ChatOpenAI instances.
+ */
+import type { BaseChatModel } from "@langchain/core/language_models/chat_models";
+import type { Agent } from "node:http";
+export interface CreateChatOpenAIOptions {
+    baseURL?: string;
+    model: string;
+    temperature?: number;
+    apiKey?: string;
+    defaultHeaders?: Record<string, string>;
+    defaultQuery?: Record<string, string>;
+    httpAgent?: Agent;
+}
+/**
+ * Create ChatOpenAI from options.
+ * Works with OpenAI and any OpenAI-compatible endpoint (CIS, Ollama, etc.).
+ */
+export declare function createChatOpenAI(options: CreateChatOpenAIOptions): BaseChatModel;
+//# sourceMappingURL=openai-compatible.d.ts.map

package/dist/langchain/openai-compatible.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-compatible.d.ts","sourceRoot":"","sources":["../../src/langchain/openai-compatible.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC;AACjF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAEvC,MAAM,WAAW,uBAAuB;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,SAAS,CAAC,EAAE,KAAK,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,aAAa,CA6BhF"}

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,24 @@
 /**
- * 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.
+ * Returns LangChain BaseChatModel instances.
  */
-/** LLM type: chat = conversation, image = image generation (OpenAI-compatible format) */
+import type { BaseChatModel } from "@langchain/core/language_models/chat_models";
 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) */
+    options?: Record<string, unknown>;
     [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 +26,20 @@ export interface AgentConfigLlmSection {
     apiKey?: string;
     baseURL?: string;
     base_url?: string;
-    /** Flat: strong/medium/fast etc. name → config (provider, base_url, name, options) */
+    options?: Record<string, unknown>;
     [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). */
-    readonly createChatModel?: (config: LLMConfig) => unknown;
-    /** Legacy: if extension provides register(), framework calls it. Prefer createClient + createChatModel so framework registers. */
+    /** ChatModel factory. Framework calls registerChatModelProvider(providerName, createChatModel). */
+    readonly createChatModel?: (config: LLMConfig) => BaseChatModel;
+    /** 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,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC;AAEjF,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,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,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,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,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,mGAAmG;IACnG,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,aAAa,CAAC;IAChE,oEAAoE;IACpE,QAAQ,CAAC,IAAI,IAAI,CAAC;CACnB"}

package/dist/utils/deep-merge.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Deep merge: overwrite target with each source (only defined values). Nested objects merged recursively.
+ */
+export declare function deepMerge<T extends object>(target: T, ...sources: Partial<T>[]): T;
+//# sourceMappingURL=deep-merge.d.ts.map

package/dist/utils/deep-merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep-merge.d.ts","sourceRoot":"","sources":["../../src/utils/deep-merge.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAsBlF"}