@easynet/agent-llm 1.0.2 → 1.0.4

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/config.ts","../src/providers/openai.ts","../src/providers/index.ts","../src/factory.ts","../src/chatModelRegistry.ts","../src/llmAdapter.ts","../src/loadLLMExtensions.ts"],"sourcesContent":["/**\n * Parse agent.yaml llm section into normalized LLMConfig[] and default id.\n * Supports: flat (每个模型一个 name 为 key)、instances[]、或单对象。\n */\n\nimport type { LLMConfig } from \"./types.js\";\n\nconst DEFAULT_LLM_ID = \"default\";\n\nconst RESERVED_KEYS = new Set([\n  \"default\",\n  \"instances\",\n  \"catalog\",\n  \"provider\",\n  \"model\",\n  \"temperature\",\n  \"apiKey\",\n  \"baseURL\",\n  \"base_url\",\n  \"type\",\n  \"id\",\n]);\n\n/**\n * 解析 llm section：扁平（每个模型一个 name 为 key）或 default+instances 或单对象。\n */\nexport function parseLlmSection(section: unknown): { defaultId: string; configs: LLMConfig[] } {\n  if (section == null || typeof section !== \"object\") {\n    return { defaultId: DEFAULT_LLM_ID, configs: [] };\n  }\n\n  if (Array.isArray(section)) {\n    const configs = section\n      .filter((i): i is Record<string, unknown> => i != null && typeof i === \"object\")\n      .map((item, i) => normalizeLlmConfig({ ...item, id: item.id ?? item.name ?? String(i) }))\n      .filter((c): c is LLMConfig => c != null);\n    const defaultId = configs.length > 0 ? configs[0]!.id : DEFAULT_LLM_ID;\n    return { defaultId, configs };\n  }\n\n  const s = section as Record<string, unknown>;\n\n  const flatEntries = Object.entries(s).filter(\n    ([k, v]) => !RESERVED_KEYS.has(k) && v != null && typeof v === \"object\" && !Array.isArray(v)\n  );\n  if (flatEntries.length > 0) {\n    const configs: LLMConfig[] = [];\n    for (const [id, entry] of flatEntries) {\n      const c = entryToLlmConfig(id, entry as Record<string, unknown>);\n      if (c) configs.push(c);\n    }\n    const defaultId =\n      typeof s.default === \"string\" && s.default && flatEntries.some(([k]) => k === s.default)\n        ? s.default\n        : configs.length > 0\n          ? configs[0]!.id\n          : DEFAULT_LLM_ID;\n    return { defaultId, configs };\n  }\n\n  if (Array.isArray(s.instances)) {\n    const configs = (s.instances as unknown[])\n      .filter((i): i is Record<string, unknown> => i != null && typeof i === \"object\")\n      .map((i) => normalizeLlmConfig(i))\n      .filter((c): c is LLMConfig => c != null);\n    const defaultId =\n      typeof s.default === \"string\" && s.default\n        ? s.default\n        : configs.length > 0\n          ? configs[0]!.id\n          : DEFAULT_LLM_ID;\n    return { defaultId, configs };\n  }\n\n  if (typeof s.provider === \"string\" || typeof s.model === \"string\" || typeof (s as { name?: string }).name === \"string\") {\n    const one = singleObjectToLlmConfig(s);\n    return { defaultId: one.id, configs: [one] };\n  }\n\n  return { defaultId: DEFAULT_LLM_ID, configs: [] };\n}\n\nconst EXTENSION_OPTION_KEYS = [\"featureKey\", \"tenant\", \"authToken\", \"verifySSL\", \"bypassAuth\", \"host\", \"resolveHost\", \"timeoutMs\", \"options\"];\n\nfunction entryToLlmConfig(id: string, entry: Record<string, unknown>): LLMConfig | null {\n  const opts = entry.options as Record<string, unknown> | undefined;\n  const baseURL =\n    typeof entry.base_url === \"string\"\n      ? entry.base_url\n      : typeof entry.baseURL === \"string\"\n        ? entry.baseURL\n        : undefined;\n  const model = typeof entry.name === \"string\" ? entry.name : typeof entry.model === \"string\" ? entry.model : undefined;\n  const provider = typeof entry.provider === \"string\" && entry.provider ? entry.provider : \"openai\";\n  const config: LLMConfig = {\n    id,\n    type: \"chat\",\n    provider,\n    model,\n    temperature: typeof opts?.temperature === \"number\" ? opts.temperature : typeof entry.temperature === \"number\" ? entry.temperature : undefined,\n    apiKey: typeof opts?.apiKey === \"string\" ? opts.apiKey : typeof entry.apiKey === \"string\" ? entry.apiKey : undefined,\n    baseURL,\n  };\n  if (typeof entry.type === \"string\" && entry.type === \"image\") config.type = \"image\";\n  if (opts && typeof opts === \"object\") (config as Record<string, unknown>).options = opts;\n  for (const k of EXTENSION_OPTION_KEYS) {\n    if (entry[k] !== undefined) (config as Record<string, unknown>)[k] = entry[k];\n    else if (opts && opts[k] !== undefined) (config as Record<string, unknown>)[k] = opts[k];\n  }\n  return config;\n}\n\nfunction singleObjectToLlmConfig(s: Record<string, unknown>): LLMConfig {\n  const one: LLMConfig = {\n    id: DEFAULT_LLM_ID,\n    type: \"chat\",\n    provider: typeof s.provider === \"string\" ? s.provider : \"openai\",\n    model: typeof s.model === \"string\" ? s.model : (typeof (s as { name?: string }).name === \"string\" ? (s as { name: string }).name : undefined),\n    temperature: typeof s.temperature === \"number\" ? s.temperature : undefined,\n    apiKey: typeof s.apiKey === \"string\" ? s.apiKey : undefined,\n    baseURL:\n      typeof s.baseURL === \"string\" ? s.baseURL : typeof s.base_url === \"string\" ? s.base_url : undefined,\n  };\n  Object.keys(s).forEach((k) => {\n    if (![\"id\", \"type\", \"provider\", \"model\", \"name\", \"temperature\", \"apiKey\", \"baseURL\", \"base_url\", \"default\", \"instances\"].includes(k)) {\n      (one as Record<string, unknown>)[k] = s[k];\n    }\n  });\n  return one;\n}\n\nfunction normalizeLlmConfig(o: Record<string, unknown>): LLMConfig | null {\n  const id = typeof o.id === \"string\" && o.id ? o.id : DEFAULT_LLM_ID;\n  const type = o.type === \"image\" ? \"image\" : \"chat\";\n  const provider = typeof o.provider === \"string\" && o.provider ? o.provider : \"openai\";\n  const config: LLMConfig = {\n    id,\n    type,\n    provider,\n    model: typeof o.model === \"string\" ? o.model : (typeof o.name === \"string\" ? o.name : undefined),\n    temperature: typeof o.temperature === \"number\" ? o.temperature : undefined,\n    apiKey: typeof o.apiKey === \"string\" ? o.apiKey : undefined,\n    baseURL: typeof o.baseURL === \"string\" ? o.baseURL : (typeof o.base_url === \"string\" ? o.base_url : undefined),\n  };\n  Object.keys(o).forEach((k) => {\n    if (![\"id\", \"type\", \"provider\", \"model\", \"name\", \"temperature\", \"apiKey\", \"baseURL\", \"base_url\"].includes(k)) {\n      (config as Record<string, unknown>)[k] = o[k];\n    }\n  });\n  return config;\n}\n","/**\n * OpenAI 兼容格式：chat (/v1/chat/completions) 与 image。\n * 支持 baseURL 以对接 Azure、本地代理等兼容端点。\n */\n\nimport OpenAI from \"openai\";\nimport type {\n  LLMConfig,\n  ChatMessage,\n  ChatResult,\n  ImageResult,\n  ILLMClient,\n  ChatWithToolsMessage,\n  ChatWithToolsResult,\n  ToolDefinition,\n} from \"../types.js\";\n\nfunction getApiKey(config: LLMConfig): string {\n  const key = config.apiKey ?? process.env.OPENAI_API_KEY ?? \"\";\n  if (!key) throw new Error(\"OpenAI-compatible apiKey required (config.apiKey or OPENAI_API_KEY)\");\n  return key;\n}\n\nfunction createOpenAIClientOptions(config: LLMConfig): { apiKey: string; baseURL?: string } {\n  const opts: { apiKey: string; baseURL?: string } = { apiKey: getApiKey(config) };\n  if (typeof config.baseURL === \"string\" && config.baseURL) opts.baseURL = config.baseURL;\n  return opts;\n}\n\nfunction serializeMessage(\n  m: ChatWithToolsMessage\n): OpenAI.Chat.Completions.ChatCompletionMessageParam {\n  if (m.role === \"tool\")\n    return { role: \"tool\", content: m.content, tool_call_id: m.tool_call_id };\n  if (m.role === \"assistant\" && \"tool_calls\" in m && m.tool_calls?.length) {\n    return {\n      role: \"assistant\",\n      content: m.content ?? null,\n      tool_calls: m.tool_calls.map((tc) => ({\n        id: tc.id,\n        type: \"function\" as const,\n        function: { name: tc.function.name, arguments: tc.function.arguments },\n      })),\n    };\n  }\n  return { role: m.role, content: (m as ChatMessage).content };\n}\n\nexport function createOpenAIChatClient(config: LLMConfig): ILLMClient {\n  const client = new OpenAI(createOpenAIClientOptions(config));\n  const model = config.model ?? process.env.OPENAI_MODEL ?? \"gpt-4o-mini\";\n  const temperature = config.temperature ?? 0;\n\n  return {\n    id: config.id,\n    type: \"chat\",\n    async chat(messages: ChatMessage[]): Promise<ChatResult> {\n      const resp = await client.chat.completions.create({\n        model,\n        temperature,\n        messages: messages.map((m) => ({ role: m.role, content: m.content })),\n      });\n      const content = resp.choices[0]?.message?.content ?? \"\";\n      const usage = resp.usage\n        ? { promptTokens: resp.usage.prompt_tokens, completionTokens: resp.usage.completion_tokens }\n        : undefined;\n      return { content, usage };\n    },\n    async chatWithTools(\n      messages: ChatWithToolsMessage[],\n      tools: ToolDefinition[],\n      _options?: { timeoutMs?: number }\n    ): Promise<ChatWithToolsResult> {\n      const resp = await client.chat.completions.create({\n        model,\n        temperature,\n        messages: messages.map(serializeMessage),\n        tools: tools.map((t) => ({\n          type: \"function\" as const,\n          function: {\n            name: t.function.name,\n            description: t.function.description,\n            parameters: (t.function.parameters ?? undefined) as Record<string, unknown> | undefined,\n          },\n        })),\n      });\n      const msg = resp.choices[0]?.message;\n      const usage = resp.usage\n        ? { promptTokens: resp.usage.prompt_tokens, completionTokens: resp.usage.completion_tokens }\n        : undefined;\n      return {\n        message: {\n          role: \"assistant\",\n          content: msg?.content ?? null,\n          tool_calls: msg?.tool_calls?.map((tc) => ({\n            id: tc.id,\n            type: \"function\" as const,\n            function: {\n              name: tc.function?.name ?? \"\",\n              arguments: tc.function?.arguments ?? \"\",\n            },\n          })),\n        },\n        usage,\n      };\n    },\n  };\n}\n\nexport function createOpenAIImageClient(config: LLMConfig): ILLMClient {\n  const client = new OpenAI(createOpenAIClientOptions(config));\n  const model = (config.model as string) ?? \"dall-e-3\";\n\n  return {\n    id: config.id,\n    type: \"image\",\n    async chat(): Promise<ChatResult> {\n      throw new Error(\"OpenAI image model does not support chat; use generateImage()\");\n    },\n    async generateImage(options: { prompt: string; size?: string; n?: number }): Promise<ImageResult> {\n      const resp = await client.images.generate({\n        model,\n        prompt: options.prompt,\n        size: (options.size as \"1024x1024\" | \"1792x1024\" | \"1024x1792\") ?? \"1024x1024\",\n        n: options.n ?? 1,\n        response_format: \"url\",\n      });\n      const url = resp.data?.[0]?.url ?? undefined;\n      return { url };\n    },\n  };\n}\n\nexport function createOpenAIClient(config: LLMConfig): ILLMClient {\n  if (config.type === \"image\") return createOpenAIImageClient(config);\n  return createOpenAIChatClient(config);\n}\n","/**\n * Supports OpenAI-compatible and extension providers.\n */\n\nimport type { LLMConfig, ILLMClient } from \"../types.js\";\nimport { createOpenAIClient } from \"./openai.js\";\n\nconst OPENAI_COMPATIBLE = \"openai-compatible\";\n\nfunction createOpenAICompat(config: LLMConfig): ILLMClient {\n  return createOpenAIClient(config);\n}\n\nconst PROVIDERS: Record<string, (config: LLMConfig) => ILLMClient> = {\n  openai: createOpenAICompat,\n  [OPENAI_COMPATIBLE]: createOpenAICompat,\n};\n\nexport function createClient(config: LLMConfig): ILLMClient {\n  const p = (config.provider ?? \"\").toLowerCase();\n  const fn = PROVIDERS[p];\n  if (!fn) {\n    const supported = [...new Set([...Object.keys(PROVIDERS), \"extension providers\"])].sort().join(\", \");\n    throw new Error(\n      `Unsupported LLM provider: ${config.provider}. Supported: ${supported}.`\n    );\n  }\n  return fn(config);\n}\n\nexport function registerProvider(name: string, factory: (config: LLMConfig) => ILLMClient): void {\n  PROVIDERS[name.toLowerCase()] = factory;\n}\n","/**\n * Create LLM registry from agent.yaml llm section.\n */\n\nimport { parseLlmSection } from \"./config.js\";\nimport { createClient } from \"./providers/index.js\";\nimport type { AgentConfigLlmSection, ILLMClient, ILLMRegistry } from \"./types.js\";\n\nexport interface CreateLLMRegistryOptions {\n  /** 已解析的 llm section（来自 loadAgentConfig 的 config.llm） */\n  llmSection: AgentConfigLlmSection | null | undefined;\n}\n\n/**\n * 从 agent config 的 llm 段创建 LLM 注册表；支持多 provider、多模型、每 LLM 有 id 与 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 * Registry for LangChain ChatModel by provider name.\n * Extensions register via registerChatModelProvider; llmAdapter uses getChatModelFactory.\n */\n\nimport type { BaseChatModel } from \"@langchain/core/language_models/chat_models\";\nimport type { LLMConfig } from \"./types.js\";\n\nexport type ChatModelFactory = (config: LLMConfig) => BaseChatModel;\n\nconst CHAT_MODEL_FACTORIES = new Map<string, ChatModelFactory>();\n\n/**\n * Register a ChatModel factory for a provider name.\n * Called by extensions (e.g. wallee-llm) on load.\n */\nexport function registerChatModelProvider(providerName: string, factory: ChatModelFactory): void {\n  CHAT_MODEL_FACTORIES.set(providerName.toLowerCase(), factory);\n}\n\n/**\n * Get the ChatModel factory for a provider name, if registered.\n */\nexport function getChatModelFactory(providerName: string): ChatModelFactory | undefined {\n  return CHAT_MODEL_FACTORIES.get(providerName.toLowerCase());\n}\n","/**\n * Build LangChain ChatModel from agent.yaml llm section.\n * Supports single object, default + instances, and flat keyed configs.\n * When provider is registered by an extension, uses that extension's ChatModel;\n * otherwise uses ChatOpenAI.\n */\n\nimport { ChatOpenAI } from \"@langchain/openai\";\nimport type { BaseChatModel } from \"@langchain/core/language_models/chat_models\";\nimport { parseLlmSection } from \"./config.js\";\nimport { getChatModelFactory } from \"./chatModelRegistry.js\";\n\nconst DEFAULT_MODEL = \"gpt-4o-mini\";\n\nexport interface CreateChatModelFromLlmConfigOptions {\n  /** agent.yaml llm section (raw or parsed); compatible with AgentConfigLlmSection / AgentConfigLlm */\n  llmSection?: unknown;\n  /** Override model from env */\n  modelEnv?: string;\n  /** Override API key from env */\n  apiKeyEnv?: string;\n}\n\n/**\n * Create a LangChain ChatModel from agent config llm section.\n * Uses extension-registered ChatModel when available; otherwise ChatOpenAI.\n */\nexport function createChatModelFromLlmConfig(\n  options: CreateChatModelFromLlmConfigOptions\n): BaseChatModel {\n  const { llmSection, modelEnv, apiKeyEnv } = options;\n  const { defaultId, configs } = parseLlmSection(llmSection ?? null);\n  const defaultConfig = configs.find((c) => c.id === defaultId) ?? configs[0];\n\n  if (!defaultConfig) {\n    const model =\n      modelEnv ?? process.env.OPENAI_MODEL ?? DEFAULT_MODEL;\n    const apiKey = apiKeyEnv ?? process.env.OPENAI_API_KEY;\n    return new ChatOpenAI({\n      model,\n      temperature: 0,\n      ...(apiKey ? { apiKey } : {}),\n    });\n  }\n\n  const provider = (defaultConfig as { provider?: string }).provider ?? \"openai\";\n  const chatModelFactory = getChatModelFactory(provider);\n  if (chatModelFactory) {\n    const config = {\n      ...defaultConfig,\n      model:\n        modelEnv ??\n        defaultConfig.model ??\n        (provider === \"cis\" ? process.env.CIS_MODEL ?? \"gcp/gemini-2.5-pro\" : defaultConfig.model),\n      temperature:\n        typeof defaultConfig.temperature === \"number\"\n          ? defaultConfig.temperature\n          : 0,\n    };\n    return chatModelFactory(config);\n  }\n\n  const model =\n    modelEnv ??\n    defaultConfig?.model ??\n    process.env.OPENAI_MODEL ??\n    DEFAULT_MODEL;\n\n  const apiKey =\n    apiKeyEnv ?? defaultConfig?.apiKey ?? process.env.OPENAI_API_KEY;\n\n  const temperature =\n    typeof defaultConfig?.temperature === \"number\" ? defaultConfig.temperature : 0;\n\n  const baseURL = defaultConfig?.baseURL;\n\n  const constructorOptions: ConstructorParameters<typeof ChatOpenAI>[0] = {\n    model,\n    temperature,\n    ...(apiKey ? { apiKey } : {}),\n    ...(baseURL ? { configuration: { baseURL } } : {}),\n  };\n\n  return new ChatOpenAI(constructorOptions);\n}\n","/**\n * Load optional LLM extensions by npm package name (e.g. wallee-llm).\n * Call before createChatModelFromLlmConfig when using extension providers.\n * Config llm.type = npm package name(s); we dynamic load those packages. No extensions field.\n */\n\nconst loadedPackages = new Set<string>();\n\nconst DEFAULT_EXTENSIONS = [\"wallee-llm\"];\n\n/**\n * Resolve llm.type to a list of npm package names to load.\n * type is the npm package name or array of package names; we load them directly (no mapping).\n */\nexport function resolveLLMExtensionPackages(types?: string | string[]): string[] {\n  const typeList = types == null ? [] : Array.isArray(types) ? types : [types];\n  const packages = typeList.filter(\n    (t): t is string => typeof t === \"string\" && t.length > 0\n  );\n  return packages.length > 0 ? packages : DEFAULT_EXTENSIONS;\n}\n\n/**\n * Dynamically load LLM extensions by npm package name.\n * Each package must export registerLLMExtension() and will register its provider(s) and ChatModel factory.\n * Safe to call multiple times; each package is loaded at most once.\n * @param extensionPackages npm package names; default [\"wallee-llm\"] when omitted\n */\nexport async function loadLLMExtensions(\n  extensionPackages?: string[]\n): Promise<void> {\n  const packages = extensionPackages ?? DEFAULT_EXTENSIONS;\n  for (const pkg of packages) {\n    if (loadedPackages.has(pkg)) continue;\n    loadedPackages.add(pkg);\n    try {\n      const m = await import(/* @vite-ignore */ pkg);\n      if (\n        typeof (m as { registerLLMExtension?: () => void })\n          .registerLLMExtension === \"function\"\n      ) {\n        (m as { registerLLMExtension: () => void }).registerLLMExtension();\n      }\n    } catch {\n      // extension not installed or load failed\n    }\n  }\n}\n"],"mappings":"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","names":["model","apiKey"]}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/llmAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"llmAdapter.d.ts","sourceRoot":"","sources":["../src/llmAdapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC;AAMjF,MAAM,WAAW,mCAAmC;IAClD,qGAAqG;IACrG,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,mCAAmC,GAC3C,aAAa,CAuDf"}
+{"version":3,"file":"llmAdapter.d.ts","sourceRoot":"","sources":["../src/llmAdapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC;AAMjF,MAAM,WAAW,mCAAmC;IAClD,qGAAqG;IACrG,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,mCAAmC,GAC3C,aAAa,CA2Df"}

package/dist/loadLlmConfig.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Load and parse LLM config from YAML (e.g. config/llm.yaml).
+ * Supports ${VAR} substitution from process.env.
+ */
+export interface LoadLlmConfigOptions {
+    /** Replace ${VAR} with process.env.VAR. Default true. */
+    substituteEnv?: boolean;
+}
+/**
+ * Recursively replace ${VAR} in strings with process.env.VAR.
+ */
+export declare function substituteEnv(obj: unknown): unknown;
+/**
+ * Parse YAML string and return the llm section (top-level key "llm").
+ * Returns undefined if content has no llm key.
+ */
+export declare function parseLlmYaml(content: string, options?: LoadLlmConfigOptions): unknown;
+/**
+ * Load LLM config from a YAML file (e.g. config/llm.yaml).
+ * Returns the llm section for use with createChatModelFromLlmConfig or parseLlmSection.
+ * Returns null if file does not exist or has no llm key.
+ */
+export declare function loadLlmConfig(filePath: string, options?: LoadLlmConfigOptions): unknown | null;
+//# sourceMappingURL=loadLlmConfig.d.ts.map

package/dist/loadLlmConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadLlmConfig.d.ts","sourceRoot":"","sources":["../src/loadLlmConfig.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,WAAW,oBAAoB;IACnC,yDAAyD;IACzD,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAanD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAMT;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,oBAAyB,GACjC,OAAO,GAAG,IAAI,CAShB"}

package/dist/npmProviderProtocol.d.ts

@@ -0,0 +1,61 @@
+/**
+ * npm: protocol in provider — specify an npm package name (and optional version) in config's model provider.
+ * Format: npm:<package-name> or npm:<package-name>@<version> or npm:<package-name>#<provider-name> or npm:<package-name>@<version>#<provider-name>
+ * When installNpmIfMissing is true, the framework will run npm install <package>[@version] if the package is not found.
+ */
+import type { CreateChatModelFromLlmConfigOptions } from "./llmAdapter.js";
+import type { BaseChatModel } from "@langchain/core/language_models/chat_models";
+export declare const NPM_PROTOCOL_PREFIX = "npm:";
+/** Parse npm: spec into package name, optional version, and optional #provider fragment. */
+export declare function parseNpmProviderSpec(spec: string): {
+    packageName: string;
+    version?: string;
+    provider?: string;
+} | null;
+export interface EnsureNpmPackageInstalledOptions {
+    /** Version to install (e.g. 0.1.0, latest). If set, runs npm install <package>@<version>. */
+    version?: string;
+    /** Working directory for npm install. Default: process.cwd() */
+    cwd?: string;
+}
+/**
+ * Check if a provider spec uses the npm: protocol.
+ */
+export declare function isNpmProviderSpec(spec: unknown): spec is string;
+/**
+ * Ensure an npm package is installed: if it cannot be resolved, run npm install <packageName>[@version] from cwd.
+ * Call this before loading a provider package when the config uses npm:<package-name>[@version].
+ */
+export declare function ensureNpmPackageInstalled(packageName: string, options?: EnsureNpmPackageInstalledOptions): Promise<void>;
+export interface ResolveNpmProviderOptions {
+    /** If true (default), run npm install <package> when the package is not found. */
+    installNpmIfMissing?: boolean;
+    /** Working directory for npm install. Default: process.cwd() */
+    cwd?: string;
+}
+/**
+ * Resolve an npm provider spec to the concrete provider name.
+ * - npm:wallee-llm → load wallee-llm, use its default provider (e.g. cis)
+ * - npm:wallee-llm@0.1.0 → load wallee-llm@0.1.0, use its default provider
+ * - npm:wallee-llm#cis → load wallee-llm, use provider "cis"
+ * - npm:wallee-llm@0.1.0#cis → load wallee-llm@0.1.0, use provider "cis"
+ * When installNpmIfMissing is true, installs the package (with optional version) if not found.
+ * Returns the provider name to use, or null if spec is not npm: protocol.
+ */
+export declare function resolveNpmProvider(spec: string, options?: ResolveNpmProviderOptions): Promise<string | null>;
+export interface ResolveLlmSectionWithNpmOptions extends ResolveNpmProviderOptions {
+}
+/**
+ * Recursively resolve all provider values that use the npm: protocol in a clone of the llm section.
+ * When installNpmIfMissing is true, installs any npm: package that is not found.
+ */
+export declare function resolveLlmSectionWithNpm(llmSection: unknown, options?: ResolveLlmSectionWithNpmOptions): Promise<unknown>;
+export interface CreateChatModelFromLlmConfigWithNpmOptions extends CreateChatModelFromLlmConfigOptions, ResolveNpmProviderOptions {
+}
+/**
+ * Create a LangChain ChatModel from llm section, resolving any provider values that use the npm: protocol.
+ * Use when config has provider: "npm:wallee-llm" or provider: "npm:wallee-llm#cis".
+ * When installNpmIfMissing is true (default), the framework will run npm install <package> if the package is not found.
+ */
+export declare function createChatModelFromLlmConfigWithNpm(options: CreateChatModelFromLlmConfigWithNpmOptions): Promise<BaseChatModel>;
+//# sourceMappingURL=npmProviderProtocol.d.ts.map

package/dist/npmProviderProtocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"npmProviderProtocol.d.ts","sourceRoot":"","sources":["../src/npmProviderProtocol.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,mCAAmC,EAAE,MAAM,iBAAiB,CAAC;AAC3E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC;AAEjF,eAAO,MAAM,mBAAmB,SAAS,CAAC;AAE1C,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,6FAA6F;IAC7F,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;AAYD;;;GAGG;AACH,wBAAsB,yBAAyB,CAC7C,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,gCAAqC,GAC7C,OAAO,CAAC,IAAI,CAAC,CAef;AAED,MAAM,WAAW,yBAAyB;IACxC,kFAAkF;IAClF,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,gEAAgE;IAChE,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,yBAA8B,GACtC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAsCxB;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,CAsBlB;AAED,MAAM,WAAW,0CACf,SAAQ,mCAAmC,EACzC,yBAAyB;CAAG;AAEhC;;;;GAIG;AACH,wBAAsB,mCAAmC,CACvD,OAAO,EAAE,0CAA0C,GAClD,OAAO,CAAC,aAAa,CAAC,CAUxB"}

package/dist/providers/openai.d.ts

@@ -1,6 +1,6 @@
 /**
- * OpenAI 兼容格式：chat (/v1/chat/completions) 与 image。
- * 支持 baseURL 以对接 Azure、本地代理等兼容端点。
+ * OpenAI-compatible format: chat (/v1/chat/completions) and image.
+ * Supports baseURL for Azure, local proxy, and other compatible endpoints.
  */
 import type { LLMConfig, ILLMClient } from "../types.js";
 export declare function createOpenAIChatClient(config: LLMConfig): ILLMClient;

package/dist/types.d.ts

@@ -1,37 +1,37 @@
 /**
- * Agent LLM: 暂时只支持 OpenAI 兼容格式（/v1/chat/completions 等）。
- * 多实例，每 LLM 有 id、type；可选 baseURL 对接其他兼容端点。
+ * Agent LLM: OpenAI-compatible format only (/v1/chat/completions etc.).
+ * Multi-instance: each LLM has id and type; optional baseURL for other compatible endpoints.
  */
-/** LLM 类型：chat=对话，image=图像生成（OpenAI 兼容格式） */
+/** LLM type: chat = conversation, image = image generation (OpenAI-compatible format) */
 export type LLMType = "chat" | "image";
-/** 单条 LLM 配置：id、type、model；仅支持 OpenAI 兼容 API */
+/** Single LLM config: id, type, model; OpenAI-compatible API only */
 export interface LLMConfig {
-    /** 唯一 id，用于从 registry 获取实例 */
+    /** Unique id for fetching the instance from the registry */
     id: string;
     /** chat | image */
     type: LLMType;
-    /** 固定为 openai 或 openai-compatible；暂时只支持此格式 */
+    /** Must be openai or openai-compatible; only this format is supported */
     provider: string;
-    /** 模型名，如 gpt-4o-mini、dall-e-3 */
+    /** Model name, e.g. gpt-4o-mini, dall-e-3 */
     model?: string;
-    /** 温度等；chat 常用 */
+    /** Temperature etc.; commonly used for chat */
     temperature?: number;
-    /** API key；也可用环境变量 */
+    /** API key; can also be set via env */
     apiKey?: string;
-    /** OpenAI 兼容端点 baseURL（如 Azure、本地代理、其他兼容 /v1 的厂商） */
+    /** 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 段：扁平（每个模型一个 name 为 key）或 default+instances 或单对象 */
+/** agent.yaml llm section: flat (each model keyed by name), default+instances, or single object */
 export interface AgentConfigLlmSection {
-    /** 默认使用的模型 name（id） */
+    /** Default model name (id) to use */
     default?: string;
-    /** npm 包名或包名数组，动态加载；如 "wallee-llm" 或 ["wallee-llm"] */
+    /** npm package name or array for dynamic load; e.g. "wallee-llm" or ["wallee-llm"] */
     type?: string | string[];
-    /** 多个 LLM 配置（数组格式） */
+    /** Array of LLM configs */
     instances?: LLMConfig[];
-    /** 兼容单对象：provider、model 等，解析为 id=default 的 chat */
+    /** Single-object form: provider, model etc., parsed as id=default chat */
     provider?: string;
     model?: string;
     name?: string;
@@ -39,15 +39,15 @@ export interface AgentConfigLlmSection {
     apiKey?: string;
     baseURL?: string;
     base_url?: string;
-    /** 扁平：strong/medium/fast 等 name → 配置（provider、base_url、name、options） */
+    /** 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?: {
@@ -55,7 +55,7 @@ export interface ChatResult {
         completionTokens?: number;
     };
 }
-/** OpenAI 兼容的工具定义（function） */
+/** OpenAI-compatible tool definition (function) */
 export interface ToolDefinition {
     type: "function";
     function: {
@@ -64,7 +64,7 @@ export interface ToolDefinition {
         parameters?: object;
     };
 }
-/** 带 tool 调用的消息（assistant 可能含 tool_calls；tool 为工具结果） */
+/** Message with tool calls (assistant may include tool_calls; tool = tool result) */
 export type ChatWithToolsMessage = ChatMessage | {
     role: "tool";
     content: string;
@@ -81,7 +81,7 @@ export type ChatWithToolsMessage = ChatMessage | {
         };
     }>;
 };
-/** 带工具调用的聊天结果 */
+/** Chat result with tool calls */
 export interface ChatWithToolsResult {
     message: {
         role: "assistant";
@@ -100,29 +100,29 @@ export interface ChatWithToolsResult {
         completionTokens?: number;
     };
 }
-/** 图像生成结果 */
+/** Image generation result */
 export interface ImageResult {
     url?: string;
     b64?: string;
 }
 /**
- * 单个 LLM 实例的极简调用接口。
- * type=chat 时提供 chat；type=image 时提供 generateImage。
- * chat 型可选提供 chatWithTools 以支持 ReAct/Agent 工具调用。
+ * 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;
-    /** 对话（type=chat 时可用） */
+    /** Chat (available when type=chat) */
     chat(messages: ChatMessage[]): Promise<ChatResult>;
     /**
-     * 带工具调用的对话（type=chat 时可选；用于 ReAct/Agent）。
-     * 若未实现，调用方可用 chat 轮询或使用其他客户端。
+     * 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>;
-    /** 图像生成（type=image 时可用）；否则可抛错或忽略 */
+    /** Image generation (when type=image); otherwise may throw or be ignored */
     generateImage?(options: {
         prompt: string;
         size?: string;
@@ -130,7 +130,7 @@ export interface ILLMClient {
     }): Promise<ImageResult>;
 }
 /**
- * 从 llm section 创建的 LLM 注册表：按 id 获取实例。
+ * LLM registry created from llm section: get instance by id.
  */
 export interface ILLMRegistry {
     get(id: string): ILLMClient | undefined;

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":"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"}

package/package.json

@@ -1,8 +1,12 @@
 {
   "name": "@easynet/agent-llm",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "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"
+  },
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "scripts": {
@@ -11,14 +15,17 @@
     "test": "vitest run",
     "test:watch": "vitest",
     "test:llm-live": "vitest run llm-live.test.ts",
-    "test:link": "vitest run -t 'connects to CIS'",
+    "test:link": "vitest run -t 'invokes OpenAI-compatible API'",
+    "example:agent": "cd examples && npm run start",
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@langchain/core": ">=0.3.0",
-    "@langchain/openai": "^1.2.3",
+    "@langchain/core": ">=0.3.58 <0.4.0",
+    "@langchain/openai": "^0.5.0",
     "axios": "^1.7.0",
-    "openai": "^4.77.0"
+    "openai": "^4.77.0",
+    "yaml": "^2.7.0",
+    "zod": "^3.23.0"
   },
   "devDependencies": {
     "@semantic-release/git": "^10.0.1",