@easynet/agent-common 1.0.4 → 1.0.5

package/dist/connectivity/check.d.ts

@@ -0,0 +1,17 @@
+import type { CheckConnectivityResult } from "./types.js";
+export interface EndpointConnectivityOptions {
+    timeoutMs?: number;
+    resolveHost?: {
+        from: string;
+        to: string;
+    };
+    host?: string;
+    verifySSL?: boolean;
+    bypassAuth?: boolean;
+    featureKey?: string;
+}
+export declare function checkEndpointConnectivity(baseURL: string, options?: {
+    timeoutMs?: number;
+} & EndpointConnectivityOptions): Promise<CheckConnectivityResult>;
+export declare const CIS_UNREACHABLE_REMINDER = "Please ensure you are connected to Secure VPN and try again.";
+export declare function buildUnreachableError(endpointId: string, baseURL: string, detail?: string): string;

package/dist/connectivity/index.d.ts

@@ -0,0 +1,3 @@
+export { checkEndpointConnectivity, buildUnreachableError, CIS_UNREACHABLE_REMINDER, } from "./check.js";
+export type { EndpointConnectivityOptions } from "./check.js";
+export type { ConnectionStatus, ConnectionPhase, CheckConnectivityResult, } from "./types.js";

package/dist/connectivity/types.d.ts

@@ -0,0 +1,12 @@
+export type ConnectionPhase = "checking" | "reachable" | "unreachable";
+export interface ConnectionStatus {
+    phase: ConnectionPhase;
+    endpointId?: string;
+    baseURL?: string;
+    message?: string;
+}
+export interface CheckConnectivityResult {
+    reachable: boolean;
+    message?: string;
+    statusCode?: number;
+}

package/dist/embedding/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * OpenAI-compatible embedding API: POST /embeddings.
+ * No LangChain dependency; for use by any module that needs embeddings.
+ */
+export interface EmbeddingOptions {
+    baseURL: string;
+    apiKey?: string;
+    model?: string;
+    timeoutMs?: number;
+}
+export interface EmbedRequest {
+    input: string | string[];
+    model?: string;
+}
+export interface EmbedResult {
+    vectors: number[][];
+    dimensions?: number;
+    model?: string;
+}
+/**
+ * Call OpenAI-compatible /embeddings endpoint.
+ * baseURL should be the API root (e.g. https://api.openai.com/v1); trailing slash is stripped.
+ */
+export declare function embedViaOpenAICompatibleApi(options: EmbeddingOptions, input: EmbedRequest): Promise<EmbedResult>;

package/dist/index.d.ts

@@ -1,2 +1,6 @@
 export * from "./npm/index.js";
 export * from "./config/index.js";
+export * from "./connectivity/index.js";
+export * from "./llm/index.js";
+export * from "./embedding/index.js";
+export * from "./utils/index.js";

package/dist/index.js

@@ -120,11 +120,290 @@ function resolveConfigPath(pathRef, configDir, options = {}) {
   const expanded = options.expandHome === false ? pathRef : expandHomePath(pathRef, { homeDir: options.homeDir });
   return path2.resolve(configDir, expanded);
 }
+
+// src/connectivity/check.ts
+import https from "https";
+var DEFAULT_TIMEOUT_MS = 8e3;
+function probePath(baseURL) {
+  const base = baseURL.replace(/\/+$/, "");
+  if (base.endsWith("/v1")) return `${base}/models`;
+  return base.includes("/v1") ? `${base}/models` : `${base}/v1/models`;
+}
+function resolveProbeRequest(baseURL, endpointOptions) {
+  let path3 = probePath(baseURL);
+  const urlObj = new URL(path3);
+  const resolveFrom = endpointOptions?.resolveHost?.from;
+  const resolveTo = endpointOptions?.resolveHost?.to;
+  let hostHeader = endpointOptions?.host;
+  if (resolveFrom && resolveTo && urlObj.hostname) {
+    urlObj.hostname = urlObj.hostname.replace(resolveFrom, resolveTo);
+    hostHeader = hostHeader ?? resolveFrom;
+  }
+  const searchParams = new URLSearchParams(urlObj.search);
+  if (endpointOptions?.bypassAuth === true) searchParams.set("bypass_auth", "true");
+  urlObj.search = searchParams.toString();
+  return { url: urlObj.toString(), hostHeader };
+}
+function checkWithHttps(url, hostHeader, options) {
+  return new Promise((resolve) => {
+    const u = new URL(url);
+    const reqOpts = {
+      hostname: u.hostname,
+      port: u.port || (u.protocol === "https:" ? 443 : 80),
+      path: u.pathname + u.search,
+      method: "GET",
+      headers: { Accept: "application/json" },
+      rejectUnauthorized: options.verifySSL
+    };
+    if (hostHeader) reqOpts.headers = { ...reqOpts.headers, Host: hostHeader };
+    const timeoutId = setTimeout(() => {
+      req.destroy();
+      resolve({ reachable: false, message: "Connection timed out" });
+    }, options.timeoutMs);
+    const req = https.request(reqOpts, (res) => {
+      clearTimeout(timeoutId);
+      resolve({
+        reachable: true,
+        message: res.statusCode === 200 ? "OK" : `HTTP ${res.statusCode}`,
+        statusCode: res.statusCode
+      });
+    });
+    req.on("error", (err) => {
+      clearTimeout(timeoutId);
+      resolve({ reachable: false, message: err.message || "Connection failed" });
+    });
+    req.end();
+  });
+}
+async function checkEndpointConnectivity(baseURL, options) {
+  const timeoutMs = options?.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+  const useHttps = options?.resolveHost != null || options?.verifySSL === false || options?.host != null || options?.bypassAuth === true;
+  if (useHttps) {
+    const { url: url2, hostHeader } = resolveProbeRequest(baseURL, options);
+    return checkWithHttps(url2, hostHeader, {
+      timeoutMs,
+      verifySSL: options?.verifySSL === true
+    });
+  }
+  const url = probePath(baseURL);
+  const controller = new AbortController();
+  const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+  try {
+    const res = await fetch(url, {
+      method: "GET",
+      signal: controller.signal,
+      headers: { Accept: "application/json" }
+    });
+    clearTimeout(timeoutId);
+    return {
+      reachable: true,
+      message: res.ok ? "OK" : `HTTP ${res.status}`,
+      statusCode: res.status
+    };
+  } catch (err) {
+    clearTimeout(timeoutId);
+    const message = err instanceof Error ? err.message : String(err);
+    const isTimeout = err instanceof Error && err.name === "AbortError";
+    return {
+      reachable: false,
+      message: isTimeout ? "Connection timed out" : message || "Connection failed"
+    };
+  }
+}
+var CIS_UNREACHABLE_REMINDER = "Please ensure you are connected to Secure VPN and try again.";
+function buildUnreachableError(endpointId, baseURL, detail) {
+  const parts = [
+    `Cannot connect to CIS (endpoint: ${endpointId}, base URL: ${baseURL}).`,
+    detail && ` ${detail}`,
+    ` ${CIS_UNREACHABLE_REMINDER}`
+  ];
+  return parts.filter(Boolean).join("").trim();
+}
+
+// src/llm/parser.ts
+var DEFAULT_LLM_ID = "default";
+var RESERVED_KEYS = /* @__PURE__ */ new Set([
+  "default",
+  "instances",
+  "catalog",
+  "provider",
+  "model",
+  "temperature",
+  "apiKey",
+  "baseURL",
+  "base_url",
+  "type",
+  "id"
+]);
+function parseLlmSection(section) {
+  if (section == null || typeof section !== "object") {
+    return { defaultId: DEFAULT_LLM_ID, configs: [] };
+  }
+  if (Array.isArray(section)) {
+    const configs = section.filter((i) => i != null && typeof i === "object").map((item, i) => normalizeLlmConfig({ ...item, id: item.id ?? item.name ?? String(i) })).filter((c) => c != null);
+    const defaultId = configs.length > 0 ? configs[0].id : DEFAULT_LLM_ID;
+    return { defaultId, configs };
+  }
+  const s = section;
+  const flatEntries = Object.entries(s).filter(
+    ([k, v]) => !RESERVED_KEYS.has(k) && v != null && typeof v === "object" && !Array.isArray(v)
+  );
+  if (flatEntries.length > 0) {
+    const configs = [];
+    for (const [id, entry] of flatEntries) {
+      const c = entryToLlmConfig(id, entry);
+      if (c) configs.push(c);
+    }
+    const defaultId = typeof s.default === "string" && s.default && flatEntries.some(([k]) => k === s.default) ? s.default : configs.length > 0 ? configs[0].id : DEFAULT_LLM_ID;
+    return { defaultId, configs };
+  }
+  if (Array.isArray(s.instances)) {
+    const configs = s.instances.filter((i) => i != null && typeof i === "object").map((i) => normalizeLlmConfig(i)).filter((c) => c != null);
+    const defaultId = typeof s.default === "string" && s.default ? s.default : configs.length > 0 ? configs[0].id : DEFAULT_LLM_ID;
+    return { defaultId, configs };
+  }
+  if (typeof s.provider === "string" || typeof s.model === "string" || typeof s.name === "string") {
+    const one = singleObjectToLlmConfig(s);
+    return { defaultId: one.id, configs: [one] };
+  }
+  return { defaultId: DEFAULT_LLM_ID, configs: [] };
+}
+var EXTENSION_OPTION_KEYS = ["featureKey", "tenant", "authToken", "verifySSL", "bypassAuth", "host", "resolveHost", "timeoutMs", "options"];
+function entryToLlmConfig(id, entry) {
+  const opts = entry.options;
+  const baseURL = typeof entry.base_url === "string" ? entry.base_url : typeof entry.baseURL === "string" ? entry.baseURL : void 0;
+  const model = typeof entry.name === "string" ? entry.name : typeof entry.model === "string" ? entry.model : void 0;
+  const provider = typeof entry.provider === "string" && entry.provider ? entry.provider : "openai";
+  const config = {
+    id,
+    type: "chat",
+    provider,
+    model,
+    temperature: typeof opts?.temperature === "number" ? opts.temperature : typeof entry.temperature === "number" ? entry.temperature : void 0,
+    apiKey: typeof opts?.apiKey === "string" ? opts.apiKey : typeof entry.apiKey === "string" ? entry.apiKey : void 0,
+    baseURL
+  };
+  if (typeof entry.type === "string" && entry.type === "image") config.type = "image";
+  if (opts && typeof opts === "object") config.options = opts;
+  for (const k of EXTENSION_OPTION_KEYS) {
+    if (entry[k] !== void 0) config[k] = entry[k];
+    else if (opts && opts[k] !== void 0) config[k] = opts[k];
+  }
+  return config;
+}
+function singleObjectToLlmConfig(s) {
+  const one = {
+    id: DEFAULT_LLM_ID,
+    type: "chat",
+    provider: typeof s.provider === "string" ? s.provider : "openai",
+    model: typeof s.model === "string" ? s.model : typeof s.name === "string" ? s.name : void 0,
+    temperature: typeof s.temperature === "number" ? s.temperature : void 0,
+    apiKey: typeof s.apiKey === "string" ? s.apiKey : void 0,
+    baseURL: typeof s.baseURL === "string" ? s.baseURL : typeof s.base_url === "string" ? s.base_url : void 0
+  };
+  Object.keys(s).forEach((k) => {
+    if (!["id", "type", "provider", "model", "name", "temperature", "apiKey", "baseURL", "base_url", "default", "instances"].includes(k)) {
+      one[k] = s[k];
+    }
+  });
+  return one;
+}
+function normalizeLlmConfig(o) {
+  const id = typeof o.id === "string" && o.id ? o.id : DEFAULT_LLM_ID;
+  const type = o.type === "image" ? "image" : "chat";
+  const provider = typeof o.provider === "string" && o.provider ? o.provider : "openai";
+  const opts = o.options;
+  const config = {
+    id,
+    type,
+    provider,
+    model: typeof o.model === "string" ? o.model : typeof o.name === "string" ? o.name : void 0,
+    temperature: typeof o.temperature === "number" ? o.temperature : typeof opts?.temperature === "number" ? opts.temperature : void 0,
+    apiKey: typeof o.apiKey === "string" ? o.apiKey : typeof opts?.apiKey === "string" ? opts.apiKey : void 0,
+    baseURL: typeof o.baseURL === "string" ? o.baseURL : typeof o.base_url === "string" ? o.base_url : void 0
+  };
+  Object.keys(o).forEach((k) => {
+    if (!["id", "type", "provider", "model", "name", "temperature", "apiKey", "baseURL", "base_url"].includes(k)) {
+      config[k] = o[k];
+    }
+  });
+  return config;
+}
+
+// src/embedding/index.ts
+var DEFAULT_EMBEDDING_TIMEOUT_MS = 3e4;
+function isLocalBaseUrl(url) {
+  try {
+    const u = new URL(url);
+    const host = u.hostname.toLowerCase();
+    return host === "localhost" || host === "127.0.0.1" || host === "::1";
+  } catch {
+    return false;
+  }
+}
+async function embedViaOpenAICompatibleApi(options, input) {
+  const baseUrl = options.baseURL.replace(/\/$/, "");
+  const apiKey = options.apiKey?.trim();
+  const timeoutMs = options.timeoutMs ?? DEFAULT_EMBEDDING_TIMEOUT_MS;
+  const modelName = typeof input.model === "string" && input.model.trim() !== "" ? input.model.trim() : options.model ?? "text-embedding-3-small";
+  if (!apiKey && !isLocalBaseUrl(baseUrl)) {
+    throw new Error("Embedding API key is required for non-local baseURL");
+  }
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), timeoutMs);
+  try {
+    const response = await fetch(`${baseUrl}/embeddings`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        ...apiKey ? { Authorization: `Bearer ${apiKey}` } : {}
+      },
+      body: JSON.stringify({ model: modelName, input: input.input }),
+      signal: controller.signal
+    });
+    if (!response.ok) {
+      const body = await response.text();
+      throw new Error(`Embedding API error ${response.status}: ${body.slice(0, 500)}`);
+    }
+    const data = await response.json();
+    const vectors = (data.data ?? []).slice().sort((a, b) => (a.index ?? 0) - (b.index ?? 0)).map((v) => v.embedding).filter((v) => Array.isArray(v));
+    return {
+      vectors,
+      dimensions: vectors[0]?.length,
+      model: data.model ?? modelName
+    };
+  } finally {
+    clearTimeout(timer);
+  }
+}
+
+// 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;
+}
 export {
+  CIS_UNREACHABLE_REMINDER,
   NPM_PROTOCOL_PREFIX,
   assertNpmCommandSuccess,
+  buildUnreachableError,
+  checkEndpointConnectivity,
   clearVersionCache,
   clearYamlFileCache,
+  deepMerge,
+  embedViaOpenAICompatibleApi,
   ensureNpmPackageInstalled,
   ensurePackageInCache,
   expandHomePath,
@@ -141,6 +420,7 @@ export {
   npmRoot,
   npmRunScript,
   npmSearchJson,
+  parseLlmSection,
   parseNpmProvider,
   parseNpmProviderSpec,
   parseYamlContent,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/config/yaml.ts","../src/config/path.ts"],"sourcesContent":["import { existsSync, readFileSync, statSync } from \"node:fs\";\nimport { readFile, stat } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { parse as parseYaml } from \"yaml\";\n\nexport interface YamlEnvOptions {\n  substituteEnv?: boolean;\n  missingEnv?: \"keep\" | \"empty\";\n  env?: NodeJS.ProcessEnv;\n}\n\nexport interface LoadYamlOptions extends YamlEnvOptions {\n  cache?: boolean;\n}\n\ninterface CacheEntry {\n  mtimeMs: number;\n  value: unknown;\n}\n\nconst YAML_CACHE = new Map<string, CacheEntry>();\n\nexport function clearYamlFileCache(): void {\n  YAML_CACHE.clear();\n}\n\nfunction substituteEnvInString(\n  input: string,\n  env: NodeJS.ProcessEnv,\n  missingEnv: \"keep\" | \"empty\",\n): string {\n  return input.replace(/\\$\\{(\\w+)\\}/g, (_, name: string) => {\n    const value = env[name];\n    if (value !== undefined) return value;\n    return missingEnv === \"empty\" ? \"\" : `\\${${name}}`;\n  });\n}\n\nfunction substituteEnvInValue(\n  input: unknown,\n  options: { env: NodeJS.ProcessEnv; missingEnv: \"keep\" | \"empty\" },\n): unknown {\n  if (typeof input === \"string\") {\n    return substituteEnvInString(input, options.env, options.missingEnv);\n  }\n  if (Array.isArray(input)) {\n    return input.map((item) => substituteEnvInValue(item, options));\n  }\n  if (input && typeof input === \"object\") {\n    const out: Record<string, unknown> = {};\n    for (const [k, v] of Object.entries(input)) {\n      out[k] = substituteEnvInValue(v, options);\n    }\n    return out;\n  }\n  return input;\n}\n\nexport function parseYamlContent<T = unknown>(\n  content: string,\n  options: YamlEnvOptions = {},\n): T {\n  const parsed = parseYaml(content) as unknown;\n  if (options.substituteEnv === false) return parsed as T;\n  return substituteEnvInValue(parsed, {\n    env: options.env ?? process.env,\n    missingEnv: options.missingEnv ?? \"keep\",\n  }) as T;\n}\n\nfunction readFromCache(filePath: string, mtimeMs: number): unknown | undefined {\n  const cached = YAML_CACHE.get(filePath);\n  if (!cached) return undefined;\n  if (cached.mtimeMs !== mtimeMs) return undefined;\n  return cached.value;\n}\n\nfunction writeCache(filePath: string, mtimeMs: number, value: unknown): void {\n  YAML_CACHE.set(filePath, { mtimeMs, value });\n}\n\nexport function loadYamlFileSync<T = unknown>(\n  filePath: string,\n  options: LoadYamlOptions = {},\n): T | undefined {\n  const absPath = path.resolve(filePath);\n  if (!existsSync(absPath)) return undefined;\n  const useCache = options.cache === true;\n  const fileStat = statSync(absPath);\n  if (useCache) {\n    const cached = readFromCache(absPath, fileStat.mtimeMs);\n    if (cached !== undefined) return cached as T;\n  }\n  const content = readFileSync(absPath, \"utf-8\");\n  const parsed = parseYamlContent<T>(content, options);\n  if (useCache) writeCache(absPath, fileStat.mtimeMs, parsed);\n  return parsed;\n}\n\nexport async function loadYamlFile<T = unknown>(\n  filePath: string,\n  options: LoadYamlOptions = {},\n): Promise<T | undefined> {\n  const absPath = path.resolve(filePath);\n  let fileStat;\n  try {\n    fileStat = await stat(absPath);\n  } catch (err) {\n    if ((err as NodeJS.ErrnoException)?.code === \"ENOENT\") return undefined;\n    throw err;\n  }\n  const useCache = options.cache === true;\n  if (useCache) {\n    const cached = readFromCache(absPath, fileStat.mtimeMs);\n    if (cached !== undefined) return cached as T;\n  }\n  const content = await readFile(absPath, \"utf-8\");\n  const parsed = parseYamlContent<T>(content, options);\n  if (useCache) writeCache(absPath, fileStat.mtimeMs, parsed);\n  return parsed;\n}\n","import path from \"node:path\";\nimport { homedir } from \"node:os\";\n\nexport interface ResolveConfigPathOptions {\n  expandHome?: boolean;\n  homeDir?: string;\n}\n\nexport function isPathRef(value: unknown): value is string {\n  return (\n    typeof value === \"string\" &&\n    value.length > 0 &&\n    (value.endsWith(\".yaml\") || value.endsWith(\".yml\"))\n  );\n}\n\nexport function expandHomePath(inputPath: string, options: { homeDir?: string } = {}): string {\n  const home = options.homeDir ?? homedir();\n  if (inputPath === \"~\") return home;\n  if (inputPath.startsWith(\"~/\")) return path.join(home, inputPath.slice(2));\n  return inputPath;\n}\n\nexport function resolveConfigPath(\n  pathRef: string,\n  configDir: string,\n  options: ResolveConfigPathOptions = {},\n): string {\n  const expanded = options.expandHome === false ? pathRef : expandHomePath(pathRef, { homeDir: options.homeDir });\n  return path.resolve(configDir, expanded);\n}\n"],"mappings":"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","names":["path"]}
+{"version":3,"sources":["../src/config/yaml.ts","../src/config/path.ts","../src/connectivity/check.ts","../src/llm/parser.ts","../src/embedding/index.ts","../src/utils/deep-merge.ts"],"sourcesContent":["import { existsSync, readFileSync, statSync } from \"node:fs\";\nimport { readFile, stat } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { parse as parseYaml } from \"yaml\";\n\nexport interface YamlEnvOptions {\n  substituteEnv?: boolean;\n  missingEnv?: \"keep\" | \"empty\";\n  env?: NodeJS.ProcessEnv;\n}\n\nexport interface LoadYamlOptions extends YamlEnvOptions {\n  cache?: boolean;\n}\n\ninterface CacheEntry {\n  mtimeMs: number;\n  value: unknown;\n}\n\nconst YAML_CACHE = new Map<string, CacheEntry>();\n\nexport function clearYamlFileCache(): void {\n  YAML_CACHE.clear();\n}\n\nfunction substituteEnvInString(\n  input: string,\n  env: NodeJS.ProcessEnv,\n  missingEnv: \"keep\" | \"empty\",\n): string {\n  return input.replace(/\\$\\{(\\w+)\\}/g, (_, name: string) => {\n    const value = env[name];\n    if (value !== undefined) return value;\n    return missingEnv === \"empty\" ? \"\" : `\\${${name}}`;\n  });\n}\n\nfunction substituteEnvInValue(\n  input: unknown,\n  options: { env: NodeJS.ProcessEnv; missingEnv: \"keep\" | \"empty\" },\n): unknown {\n  if (typeof input === \"string\") {\n    return substituteEnvInString(input, options.env, options.missingEnv);\n  }\n  if (Array.isArray(input)) {\n    return input.map((item) => substituteEnvInValue(item, options));\n  }\n  if (input && typeof input === \"object\") {\n    const out: Record<string, unknown> = {};\n    for (const [k, v] of Object.entries(input)) {\n      out[k] = substituteEnvInValue(v, options);\n    }\n    return out;\n  }\n  return input;\n}\n\nexport function parseYamlContent<T = unknown>(\n  content: string,\n  options: YamlEnvOptions = {},\n): T {\n  const parsed = parseYaml(content) as unknown;\n  if (options.substituteEnv === false) return parsed as T;\n  return substituteEnvInValue(parsed, {\n    env: options.env ?? process.env,\n    missingEnv: options.missingEnv ?? \"keep\",\n  }) as T;\n}\n\nfunction readFromCache(filePath: string, mtimeMs: number): unknown | undefined {\n  const cached = YAML_CACHE.get(filePath);\n  if (!cached) return undefined;\n  if (cached.mtimeMs !== mtimeMs) return undefined;\n  return cached.value;\n}\n\nfunction writeCache(filePath: string, mtimeMs: number, value: unknown): void {\n  YAML_CACHE.set(filePath, { mtimeMs, value });\n}\n\nexport function loadYamlFileSync<T = unknown>(\n  filePath: string,\n  options: LoadYamlOptions = {},\n): T | undefined {\n  const absPath = path.resolve(filePath);\n  if (!existsSync(absPath)) return undefined;\n  const useCache = options.cache === true;\n  const fileStat = statSync(absPath);\n  if (useCache) {\n    const cached = readFromCache(absPath, fileStat.mtimeMs);\n    if (cached !== undefined) return cached as T;\n  }\n  const content = readFileSync(absPath, \"utf-8\");\n  const parsed = parseYamlContent<T>(content, options);\n  if (useCache) writeCache(absPath, fileStat.mtimeMs, parsed);\n  return parsed;\n}\n\nexport async function loadYamlFile<T = unknown>(\n  filePath: string,\n  options: LoadYamlOptions = {},\n): Promise<T | undefined> {\n  const absPath = path.resolve(filePath);\n  let fileStat;\n  try {\n    fileStat = await stat(absPath);\n  } catch (err) {\n    if ((err as NodeJS.ErrnoException)?.code === \"ENOENT\") return undefined;\n    throw err;\n  }\n  const useCache = options.cache === true;\n  if (useCache) {\n    const cached = readFromCache(absPath, fileStat.mtimeMs);\n    if (cached !== undefined) return cached as T;\n  }\n  const content = await readFile(absPath, \"utf-8\");\n  const parsed = parseYamlContent<T>(content, options);\n  if (useCache) writeCache(absPath, fileStat.mtimeMs, parsed);\n  return parsed;\n}\n","import path from \"node:path\";\nimport { homedir } from \"node:os\";\n\nexport interface ResolveConfigPathOptions {\n  expandHome?: boolean;\n  homeDir?: string;\n}\n\nexport function isPathRef(value: unknown): value is string {\n  return (\n    typeof value === \"string\" &&\n    value.length > 0 &&\n    (value.endsWith(\".yaml\") || value.endsWith(\".yml\"))\n  );\n}\n\nexport function expandHomePath(inputPath: string, options: { homeDir?: string } = {}): string {\n  const home = options.homeDir ?? homedir();\n  if (inputPath === \"~\") return home;\n  if (inputPath.startsWith(\"~/\")) return path.join(home, inputPath.slice(2));\n  return inputPath;\n}\n\nexport function resolveConfigPath(\n  pathRef: string,\n  configDir: string,\n  options: ResolveConfigPathOptions = {},\n): string {\n  const expanded = options.expandHome === false ? pathRef : expandHomePath(pathRef, { homeDir: options.homeDir });\n  return path.resolve(configDir, expanded);\n}\n","/**\n * Check connectivity to OpenAI-compatible / CIS endpoints.\n */\nimport https from \"node:https\";\nimport type { CheckConnectivityResult } from \"./types.js\";\n\nconst DEFAULT_TIMEOUT_MS = 8000;\n\nexport interface EndpointConnectivityOptions {\n  timeoutMs?: number;\n  resolveHost?: { from: string; to: string };\n  host?: string;\n  verifySSL?: boolean;\n  bypassAuth?: boolean;\n  featureKey?: string;\n}\n\nfunction probePath(baseURL: string): string {\n  const base = baseURL.replace(/\\/+$/, \"\");\n  if (base.endsWith(\"/v1\")) return `${base}/models`;\n  return base.includes(\"/v1\") ? `${base}/models` : `${base}/v1/models`;\n}\n\nfunction resolveProbeRequest(\n  baseURL: string,\n  endpointOptions?: EndpointConnectivityOptions | null\n): { url: string; hostHeader: string | undefined } {\n  let path = probePath(baseURL);\n  const urlObj = new URL(path);\n  const resolveFrom = endpointOptions?.resolveHost?.from;\n  const resolveTo = endpointOptions?.resolveHost?.to;\n  let hostHeader = endpointOptions?.host;\n  if (resolveFrom && resolveTo && urlObj.hostname) {\n    urlObj.hostname = urlObj.hostname.replace(resolveFrom, resolveTo);\n    hostHeader = hostHeader ?? resolveFrom;\n  }\n  const searchParams = new URLSearchParams(urlObj.search);\n  if (endpointOptions?.bypassAuth === true) searchParams.set(\"bypass_auth\", \"true\");\n  urlObj.search = searchParams.toString();\n  return { url: urlObj.toString(), hostHeader };\n}\n\nfunction checkWithHttps(\n  url: string,\n  hostHeader: string | undefined,\n  options: { timeoutMs: number; verifySSL: boolean }\n): Promise<CheckConnectivityResult> {\n  return new Promise((resolve) => {\n    const u = new URL(url);\n    const reqOpts: https.RequestOptions = {\n      hostname: u.hostname,\n      port: u.port || (u.protocol === \"https:\" ? 443 : 80),\n      path: u.pathname + u.search,\n      method: \"GET\",\n      headers: { Accept: \"application/json\" },\n      rejectUnauthorized: options.verifySSL,\n    };\n    if (hostHeader) reqOpts.headers = { ...reqOpts.headers, Host: hostHeader };\n\n    const timeoutId = setTimeout(() => {\n      req.destroy();\n      resolve({ reachable: false, message: \"Connection timed out\" });\n    }, options.timeoutMs);\n\n    const req = https.request(reqOpts, (res) => {\n      clearTimeout(timeoutId);\n      resolve({\n        reachable: true,\n        message: res.statusCode === 200 ? \"OK\" : `HTTP ${res.statusCode}`,\n        statusCode: res.statusCode,\n      });\n    });\n    req.on(\"error\", (err) => {\n      clearTimeout(timeoutId);\n      resolve({ reachable: false, message: err.message || \"Connection failed\" });\n    });\n    req.end();\n  });\n}\n\nexport async function checkEndpointConnectivity(\n  baseURL: string,\n  options?: { timeoutMs?: number } & EndpointConnectivityOptions\n): Promise<CheckConnectivityResult> {\n  const timeoutMs = options?.timeoutMs ?? DEFAULT_TIMEOUT_MS;\n  const useHttps =\n    options?.resolveHost != null ||\n    options?.verifySSL === false ||\n    options?.host != null ||\n    options?.bypassAuth === true;\n\n  if (useHttps) {\n    const { url, hostHeader } = resolveProbeRequest(baseURL, options);\n    return checkWithHttps(url, hostHeader, {\n      timeoutMs,\n      verifySSL: options?.verifySSL === true,\n    });\n  }\n\n  const url = probePath(baseURL);\n  const controller = new AbortController();\n  const timeoutId = setTimeout(() => controller.abort(), timeoutMs);\n\n  try {\n    const res = await fetch(url, {\n      method: \"GET\",\n      signal: controller.signal,\n      headers: { Accept: \"application/json\" },\n    });\n    clearTimeout(timeoutId);\n    return {\n      reachable: true,\n      message: res.ok ? \"OK\" : `HTTP ${res.status}`,\n      statusCode: res.status,\n    };\n  } catch (err) {\n    clearTimeout(timeoutId);\n    const message = err instanceof Error ? err.message : String(err);\n    const isTimeout = err instanceof Error && err.name === \"AbortError\";\n    return {\n      reachable: false,\n      message: isTimeout ? \"Connection timed out\" : message || \"Connection failed\",\n    };\n  }\n}\n\nexport const CIS_UNREACHABLE_REMINDER =\n  \"Please ensure you are connected to Secure VPN and try again.\";\n\nexport function buildUnreachableError(\n  endpointId: string,\n  baseURL: string,\n  detail?: string\n): string {\n  const parts = [\n    `Cannot connect to CIS (endpoint: ${endpointId}, base URL: ${baseURL}).`,\n    detail && ` ${detail}`,\n    ` ${CIS_UNREACHABLE_REMINDER}`,\n  ];\n  return parts.filter(Boolean).join(\"\").trim();\n}\n","/**\n * Parse agent.yaml llm section into normalized LLMConfig[] and default id.\n * Supports: flat (each model keyed by name), instances[], or single object.\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\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 opts = o.options as Record<string, unknown> | undefined;\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:\n      typeof o.temperature === \"number\"\n        ? o.temperature\n        : typeof opts?.temperature === \"number\"\n          ? opts.temperature\n          : undefined,\n    apiKey:\n      typeof o.apiKey === \"string\"\n        ? o.apiKey\n        : typeof opts?.apiKey === \"string\"\n          ? opts.apiKey\n          : 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-compatible embedding API: POST /embeddings.\n * No LangChain dependency; for use by any module that needs embeddings.\n */\n\nconst DEFAULT_EMBEDDING_TIMEOUT_MS = 30_000;\n\nexport interface EmbeddingOptions {\n  baseURL: string;\n  apiKey?: string;\n  model?: string;\n  timeoutMs?: number;\n}\n\nexport interface EmbedRequest {\n  input: string | string[];\n  model?: string;\n}\n\nexport interface EmbedResult {\n  vectors: number[][];\n  dimensions?: number;\n  model?: string;\n}\n\nfunction isLocalBaseUrl(url: string): boolean {\n  try {\n    const u = new URL(url);\n    const host = u.hostname.toLowerCase();\n    return host === \"localhost\" || host === \"127.0.0.1\" || host === \"::1\";\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Call OpenAI-compatible /embeddings endpoint.\n * baseURL should be the API root (e.g. https://api.openai.com/v1); trailing slash is stripped.\n */\nexport async function embedViaOpenAICompatibleApi(\n  options: EmbeddingOptions,\n  input: EmbedRequest\n): Promise<EmbedResult> {\n  const baseUrl = options.baseURL.replace(/\\/$/, \"\");\n  const apiKey = options.apiKey?.trim();\n  const timeoutMs = options.timeoutMs ?? DEFAULT_EMBEDDING_TIMEOUT_MS;\n  const modelName =\n    typeof input.model === \"string\" && input.model.trim() !== \"\"\n      ? input.model.trim()\n      : options.model ?? \"text-embedding-3-small\";\n\n  if (!apiKey && !isLocalBaseUrl(baseUrl)) {\n    throw new Error(\"Embedding API key is required for non-local baseURL\");\n  }\n\n  const controller = new AbortController();\n  const timer = setTimeout(() => controller.abort(), timeoutMs);\n  try {\n    const response = await fetch(`${baseUrl}/embeddings`, {\n      method: \"POST\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n        ...(apiKey ? { Authorization: `Bearer ${apiKey}` } : {}),\n      },\n      body: JSON.stringify({ model: modelName, input: input.input }),\n      signal: controller.signal,\n    });\n    if (!response.ok) {\n      const body = await response.text();\n      throw new Error(`Embedding API error ${response.status}: ${body.slice(0, 500)}`);\n    }\n    const data = (await response.json()) as {\n      data?: Array<{ embedding?: number[]; index?: number }>;\n      model?: string;\n    };\n    const vectors = (data.data ?? [])\n      .slice()\n      .sort((a, b) => (a.index ?? 0) - (b.index ?? 0))\n      .map((v) => v.embedding)\n      .filter((v): v is number[] => Array.isArray(v));\n    return {\n      vectors,\n      dimensions: vectors[0]?.length,\n      model: data.model ?? modelName,\n    };\n  } finally {\n    clearTimeout(timer);\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"],"mappings":"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","names":["path","path","url"]}

package/dist/llm/index.d.ts

@@ -0,0 +1,2 @@
+export type { LLMType, LLMConfig, AgentConfigLlmSection } from "./types.js";
+export { parseLlmSection } from "./parser.js";

package/dist/llm/parser.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Parse agent.yaml llm section into normalized LLMConfig[] and default id.
+ * Supports: flat (each model keyed by name), instances[], or single object.
+ */
+import type { LLMConfig } from "./types.js";
+export declare function parseLlmSection(section: unknown): {
+    defaultId: string;
+    configs: LLMConfig[];
+};

package/dist/llm/types.d.ts

@@ -0,0 +1,30 @@
+/**
+ * LLM config types (no LangChain dependency).
+ * Used by any module that needs to read/parse llm section (e.g. agent-llm, agent-memory).
+ */
+export type LLMType = "chat" | "image";
+export interface LLMConfig {
+    id: string;
+    type: LLMType;
+    provider: string;
+    model?: string;
+    temperature?: number;
+    apiKey?: string;
+    baseURL?: string;
+    options?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+export interface AgentConfigLlmSection {
+    default?: string;
+    type?: string | string[];
+    instances?: LLMConfig[];
+    provider?: string;
+    model?: string;
+    name?: string;
+    temperature?: number;
+    apiKey?: string;
+    baseURL?: string;
+    base_url?: string;
+    options?: Record<string, unknown>;
+    [key: string]: unknown;
+}

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

@@ -0,0 +1,4 @@
+/**
+ * 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;

package/dist/utils/index.d.ts

@@ -0,0 +1 @@
+export { deepMerge } from "./deep-merge.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@easynet/agent-common",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "description": "Shared runtime utilities for Easynet agent projects",
   "type": "module",
   "main": "./dist/index.js",