@easynet/agent-tool 1.0.34 → 1.0.36

package/dist/{chunk-UUQGKFSG.js → chunk-7VBJ64YC.js}

@@ -6,7 +6,7 @@ import { bulkhead, circuitBreaker, handleAll, ConsecutiveBreaker } from 'cockati
 import { EventEmitter } from 'eventemitter3';
 import { v4 } from 'uuid';
 import pTimeout from 'p-timeout';
-import { readFileSync, existsSync, mkdirSync, readdirSync, rmSync, renameSync } from 'fs';
+import { readFileSync, existsSync, rmSync, mkdirSync, readdirSync, renameSync, statSync } from 'fs';
 import { join, resolve, dirname, isAbsolute, basename } from 'path';
 import { homedir } from 'os';
 import yaml from 'js-yaml';
@@ -1509,8 +1509,20 @@ function npmDescriptorToRegistryPrefix(descriptor, resolvedVersion) {
   const lastAt = beforeHash.lastIndexOf("@");
   const scopeAndPackage = lastAt <= 0 ? beforeHash : beforeHash.slice(0, lastAt);
   let version = lastAt <= 0 ? "latest" : beforeHash.slice(lastAt + 1).trim() || "latest";
-  if ((version === "latest" || !version) && resolvedVersion != null && resolvedVersion !== "") {
-    version = resolvedVersion;
+  if (version === "latest" || !version) {
+    const resolved = (resolvedVersion ?? "").trim();
+    if (resolved !== "" && resolved.toLowerCase() !== "latest") {
+      version = resolved;
+    } else {
+      throw new Error(
+        `Registry prefix requires a concrete version when descriptor uses latest (${descriptor}). Resolve version from registry (e.g. resolveLatestVersionFromRegistry) and pass as resolvedVersion.`
+      );
+    }
+  }
+  if (!version || version.toLowerCase() === "latest") {
+    throw new Error(
+      `Registry never uses "latest"; pass resolved concrete version for npm descriptor: ${descriptor}`
+    );
   }
   const slashIdx = scopeAndPackage.indexOf("/");
   const scope = slashIdx < 0 ? scopeAndPackage : scopeAndPackage.slice(0, slashIdx).replace(/^@/, "");
@@ -1520,6 +1532,39 @@ function npmDescriptorToRegistryPrefix(descriptor, resolvedVersion) {
   if (!normalized) return "";
   return "npm." + normalized + ".";
 }
+function npmDescriptorToPackagePrefix(descriptor) {
+  const s = descriptor.trim();
+  if (typeof s !== "string" || !s.startsWith("npm:")) return "";
+  const rest = s.slice(4).trim();
+  const hashIdx = rest.indexOf("#");
+  const beforeHash = hashIdx < 0 ? rest : rest.slice(0, hashIdx);
+  const lastAt = beforeHash.lastIndexOf("@");
+  const scopeAndPackage = lastAt <= 0 ? beforeHash : beforeHash.slice(0, lastAt);
+  const slashIdx = scopeAndPackage.indexOf("/");
+  const scope = slashIdx < 0 ? scopeAndPackage : scopeAndPackage.slice(0, slashIdx).replace(/^@/, "");
+  const pkg = slashIdx < 0 ? "" : scopeAndPackage.slice(slashIdx + 1);
+  const segment = [scope, pkg].filter(Boolean).join(".");
+  const normalized = normalizeToolName(segment);
+  if (!normalized) return "";
+  return "npm." + normalized;
+}
+function npmDescriptorToPackagePrefixWithVersion(descriptor) {
+  const s = descriptor.trim();
+  if (typeof s !== "string" || !s.startsWith("npm:")) return "";
+  const rest = s.slice(4).trim();
+  const hashIdx = rest.indexOf("#");
+  const beforeHash = hashIdx < 0 ? rest : rest.slice(0, hashIdx);
+  const lastAt = beforeHash.lastIndexOf("@");
+  const scopeAndPackage = lastAt <= 0 ? beforeHash : beforeHash.slice(0, lastAt);
+  const version = lastAt <= 0 ? "" : beforeHash.slice(lastAt + 1).trim();
+  const slashIdx = scopeAndPackage.indexOf("/");
+  const scope = slashIdx < 0 ? scopeAndPackage : scopeAndPackage.slice(0, slashIdx).replace(/^@/, "");
+  const pkg = slashIdx < 0 ? "" : scopeAndPackage.slice(slashIdx + 1);
+  const segment = [scope, pkg, version].filter(Boolean).join(".");
+  const normalized = normalizeToolName(segment);
+  if (!normalized) return "";
+  return "npm." + normalized;
+}
 function isNpmToolDescriptor(descriptor) {
   return isToolPath(descriptor) && parseToolPath(descriptor)?.protocol === "npm";
 }
@@ -1563,6 +1608,30 @@ function expandToolDescriptorsToRegistryNames(descriptors, registryNames) {
       if (registryNames.includes(s) && !seen.has(s)) {
         seen.add(s);
         out.push(s);
+        continue;
+      }
+      const path = parseToolPath(s);
+      if (path) {
+        const packagePrefix = path.protocol === "npm" ? npmDescriptorToPackagePrefix(s) : path.protocol === "file" ? fileDescriptorToPackagePrefix(s) : "";
+        const prefixWithDot = packagePrefix ? packagePrefix + "." : "";
+        if (prefixWithDot) {
+          if (path.toolName) {
+            const suffix = "." + path.toolName;
+            for (const r of registryNames) {
+              if (r.startsWith(prefixWithDot) && r.endsWith(suffix) && !seen.has(r)) {
+                seen.add(r);
+                out.push(r);
+              }
+            }
+          } else {
+            for (const r of registryNames) {
+              if (r.startsWith(prefixWithDot) && !seen.has(r)) {
+                seen.add(r);
+                out.push(r);
+              }
+            }
+          }
+        }
       }
       continue;
     }
@@ -1588,6 +1657,18 @@ function normalizeToolList(descriptors) {
   }
   return out;
 }
+function fileDescriptorToPackagePrefix(descriptor) {
+  const path = parseToolPath(descriptor.trim());
+  if (!path || path.protocol !== "file") return "";
+  const pathPart = `${path.scope}/${path.packageWithVersion}`;
+  const normalized = normalizeToolName(pathPart);
+  if (!normalized) return "";
+  return "file." + normalized;
+}
+function fileDescriptorToRegistryPrefix(descriptor) {
+  const prefix = fileDescriptorToPackagePrefix(descriptor);
+  return prefix ? prefix + "." : "";
+}
 function loadToolConfig(toolYamlPath) {
   const abs = resolve(toolYamlPath);
   const raw = readFileSync(abs, "utf8");
@@ -1595,20 +1676,29 @@ function loadToolConfig(toolYamlPath) {
   if (!parsed || typeof parsed !== "object") return {};
   const toolsBlock = parsed.tools;
   if (toolsBlock != null && typeof toolsBlock === "object" && !Array.isArray(toolsBlock)) {
+    const toolDefaults = toolsBlock.defaults != null && typeof toolsBlock.defaults === "object" && !Array.isArray(toolsBlock.defaults) ? toolsBlock.defaults : void 0;
+    const packageToolDefaults2 = toolsBlock.packages != null && typeof toolsBlock.packages === "object" && !Array.isArray(toolsBlock.packages) ? toolsBlock.packages : void 0;
+    const list2 = Array.isArray(toolsBlock.list) && toolsBlock.list.length > 0 ? toolsBlock.list : void 0;
     return {
-      tools: Array.isArray(toolsBlock.list) ? toolsBlock.list : void 0,
+      tools: list2 ?? (packageToolDefaults2 ? Object.keys(packageToolDefaults2) : void 0),
       sandboxedPath: typeof toolsBlock.sandboxedPath === "string" ? toolsBlock.sandboxedPath : parsed.sandboxedPath,
       allowedHosts: Array.isArray(toolsBlock.allowedHosts) ? toolsBlock.allowedHosts : parsed.allowedHosts,
       blockedHosts: Array.isArray(toolsBlock.blockedHosts) ? toolsBlock.blockedHosts : parsed.blockedHosts,
-      blockedCidrs: Array.isArray(toolsBlock.blockedCidrs) ? toolsBlock.blockedCidrs : parsed.blockedCidrs
+      blockedCidrs: Array.isArray(toolsBlock.blockedCidrs) ? toolsBlock.blockedCidrs : parsed.blockedCidrs,
+      toolDefaults,
+      packageToolDefaults: packageToolDefaults2
     };
   }
+  const packageToolDefaults = typeof parsed.packageToolDefaults === "object" && !Array.isArray(parsed.packageToolDefaults) ? parsed.packageToolDefaults : void 0;
+  const list = Array.isArray(parsed.tools) && parsed.tools.length > 0 ? parsed.tools : void 0;
   return {
-    tools: Array.isArray(parsed.tools) ? parsed.tools : void 0,
+    tools: list ?? (packageToolDefaults ? Object.keys(packageToolDefaults) : void 0),
     sandboxedPath: parsed.sandboxedPath,
     allowedHosts: Array.isArray(parsed.allowedHosts) ? parsed.allowedHosts : void 0,
     blockedHosts: Array.isArray(parsed.blockedHosts) ? parsed.blockedHosts : void 0,
-    blockedCidrs: Array.isArray(parsed.blockedCidrs) ? parsed.blockedCidrs : void 0
+    blockedCidrs: Array.isArray(parsed.blockedCidrs) ? parsed.blockedCidrs : void 0,
+    toolDefaults: typeof parsed.toolDefaults === "object" && !Array.isArray(parsed.toolDefaults) ? parsed.toolDefaults : void 0,
+    packageToolDefaults
   };
 }
 function resolveSandboxedPath(toolYamlPath, sandboxedPath) {
@@ -1635,6 +1725,37 @@ function findAndLoadToolConfig(dir) {
   return {};
 }
 var DEFAULT_CACHE_BASE = join(homedir(), ".agent", "cache");
+function isLatestRequest(version) {
+  const v = (version ?? "").trim().toLowerCase();
+  return v === "" || v === "latest";
+}
+function resolveLatestVersionFromRegistry(packageName) {
+  const quoted = packageName.includes(" ") ? `"${packageName}"` : packageName;
+  try {
+    const out = execSync(`npm view ${quoted} version`, {
+      encoding: "utf-8",
+      stdio: ["pipe", "pipe", "pipe"]
+    });
+    const version = (out ?? "").trim();
+    if (!version) {
+      throw new Error(`npm view ${packageName} version returned empty`);
+    }
+    return version;
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    throw new Error(`Failed to resolve latest version for ${packageName}: ${msg}`);
+  }
+}
+function getCachedPackageVersion(cacheDir) {
+  const pkgPath = join(cacheDir, "package.json");
+  if (!existsSync(pkgPath)) return void 0;
+  try {
+    const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+    return typeof pkg.version === "string" ? pkg.version : void 0;
+  } catch {
+    return void 0;
+  }
+}
 function packagePathSegments(name) {
   const withoutScope = name.replace(/^@/, "");
   return withoutScope.split("/").filter(Boolean);
@@ -1643,17 +1764,29 @@ function resolveCacheDir(cacheBase, packageName, version) {
   const segments = packagePathSegments(packageName);
   return join(cacheBase, ...segments, version);
 }
-function getVersionFromTarball(tgzName) {
-  const base = tgzName.replace(/\.tgz$/i, "");
-  const match = base.match(/-(\d+\.\d+\.\d+(-[a-zA-Z0-9.-]+)?)$/);
-  return match ? match[1] : base;
-}
 function ensurePackageInCache(packageName, version = "latest", options = {}) {
   const cacheBase = options.cacheBase ?? DEFAULT_CACHE_BASE;
+  let resolvedVersion;
+  if (isLatestRequest(version)) {
+    resolvedVersion = resolveLatestVersionFromRegistry(packageName);
+  } else {
+    resolvedVersion = version;
+  }
+  const cacheDir = resolveCacheDir(cacheBase, packageName, resolvedVersion);
+  const packageJsonPath = join(cacheDir, "package.json");
+  const nodeModulesPath = join(cacheDir, "node_modules");
+  if (existsSync(packageJsonPath) && existsSync(nodeModulesPath)) {
+    const cachedVersion = getCachedPackageVersion(cacheDir);
+    if (cachedVersion === resolvedVersion) {
+      options.afterInstall?.(cacheDir, packageName);
+      return cacheDir;
+    }
+    rmSync(cacheDir, { recursive: true, force: true });
+  }
   const packDest = join(cacheBase, ".pack-tmp", packageName.replace(/@/g, "").replace(/\//g, "_"));
   mkdirSync(packDest, { recursive: true });
   try {
-    execSync(`npm pack ${packageName}@${version} --pack-destination "${packDest}"`, {
+    execSync(`npm pack ${packageName}@${resolvedVersion} --pack-destination "${packDest}"`, {
       cwd: process.cwd(),
       stdio: "pipe",
       encoding: "utf-8"
@@ -1663,15 +1796,6 @@ function ensurePackageInCache(packageName, version = "latest", options = {}) {
     if (!tgz) {
       throw new Error(`npm pack did not produce a .tgz in ${packDest}`);
     }
-    const resolvedVersion = getVersionFromTarball(tgz);
-    const cacheDir = resolveCacheDir(cacheBase, packageName, resolvedVersion);
-    const packageJsonPath = join(cacheDir, "package.json");
-    const nodeModulesPath = join(cacheDir, "node_modules");
-    if (existsSync(packageJsonPath) && existsSync(nodeModulesPath)) {
-      options.afterInstall?.(cacheDir, packageName);
-      rmSync(packDest, { recursive: true, force: true });
-      return cacheDir;
-    }
     const extractDir = join(packDest, "extract");
     mkdirSync(extractDir, { recursive: true });
     execSync(`tar -xzf "${join(packDest, tgz)}" -C "${extractDir}"`, {
@@ -1687,11 +1811,33 @@ function ensurePackageInCache(packageName, version = "latest", options = {}) {
       rmSync(cacheDir, { recursive: true, force: true });
     }
     renameSync(extractedPackage, cacheDir);
-    execSync("npm install", {
-      cwd: cacheDir,
-      stdio: "pipe",
-      encoding: "utf-8"
-    });
+    const npmInstallTimeout = 12e4;
+    const maxAttempts = 3;
+    let lastErr;
+    for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+      try {
+        execSync("npm install --prefer-offline --no-audit --no-fund", {
+          cwd: cacheDir,
+          stdio: "pipe",
+          encoding: "utf-8",
+          timeout: npmInstallTimeout
+        });
+        lastErr = void 0;
+        break;
+      } catch (err) {
+        lastErr = err instanceof Error ? err : new Error(String(err));
+        if (attempt < maxAttempts) {
+          const delayMs = 5e3 * attempt;
+          const deadline = Date.now() + delayMs;
+          while (Date.now() < deadline) {
+          }
+        } else {
+          throw new Error(
+            `npm install in cache failed after ${maxAttempts} attempts: ${lastErr.message}`
+          );
+        }
+      }
+    }
     options.afterInstall?.(cacheDir, packageName);
     return cacheDir;
   } finally {
@@ -1808,34 +1954,95 @@ function parseNpmDescriptor(entry) {
   const version = rest.slice(at + 1).split("#")[0]?.trim() || "latest";
   return { packageName, version };
 }
-function loadExtensionFromToolYamlNodeModules(configFilePath, stepLog) {
+function loadExtensionFromFileDescriptorSync(descriptor, configFilePath, stepLog) {
+  const entryStr = descriptor.trim();
+  const path = parseToolPath(entryStr);
+  if (!path || path.protocol !== "file") return null;
+  const localPath = isAbsolute(configFilePath) ? configFilePath : resolve(process.cwd(), configFilePath);
+  const configDir = dirname(localPath);
+  const pathPart = `${path.scope}/${path.packageWithVersion}`;
+  const resolvedPath = resolve(configDir, pathPart);
+  if (!existsSync(resolvedPath) || !statSync(resolvedPath).isDirectory()) return null;
+  try {
+    const entryPath = getPackageEntryPath(resolvedPath);
+    const req = createRequire(join(resolvedPath, "package.json"));
+    const mod = req(entryPath);
+    const fn = getRegisterFn(mod);
+    if (typeof fn === "function") {
+      if (stepLog) stepLog(`Loaded local extension from ${resolvedPath}`);
+      return { register: fn, descriptor: entryStr, resolvedVersion: "local" };
+    }
+  } catch {
+  }
+  return null;
+}
+function loadExtensionForDescriptorSync(descriptor, configFilePath, stepLog) {
+  const entryStr = descriptor.trim();
+  const parsed = parseNpmDescriptor(entryStr);
+  if (!parsed) return null;
   const localPath = isAbsolute(configFilePath) ? configFilePath : resolve(process.cwd(), configFilePath);
-  if (!existsSync(localPath)) return null;
-  const config = loadToolConfig(localPath);
-  const tools = config.tools;
-  if (!Array.isArray(tools) || tools.length === 0) return null;
   const configDir = dirname(localPath);
   const packageJsonPath = join(configDir, "package.json");
-  if (!existsSync(packageJsonPath)) return null;
-  const configRequire = createRequire(packageJsonPath);
-  if (stepLog) stepLog("Trying tool.yaml npm entries from node_modules");
-  for (const entry of tools) {
-    const entryStr = String(entry).trim();
-    const parsed = parseNpmDescriptor(entryStr);
-    if (!parsed) continue;
+  const useNodeModules = existsSync(packageJsonPath);
+  const configRequire = useNodeModules ? createRequire(packageJsonPath) : null;
+  if (configRequire) {
     try {
       const mod = configRequire(parsed.packageName);
       const fn = getRegisterFn(mod);
       if (typeof fn === "function") {
-        const resolvedVersion = getInstalledPackageVersionFromRequire(parsed.packageName, configRequire) ?? "latest";
+        const installed = getInstalledPackageVersionFromRequire(parsed.packageName, configRequire);
+        const requested = parsed.version === "latest" || !parsed.version?.trim() ? null : parsed.version;
+        const resolvedVersion = installed ?? (requested === null ? resolveLatestVersionFromRegistry(parsed.packageName) : requested);
+        if (requested === null || installed === requested) {
+          if (stepLog) stepLog(`Loaded ${parsed.packageName}@${resolvedVersion} from node_modules`);
+          return { register: fn, descriptor: entryStr, resolvedVersion };
+        }
+      }
+    } catch {
+    }
+  }
+  const cacheBase = getCacheBaseFromToolConfig(localPath);
+  const cacheOpts = cacheBase ? { cacheBase } : {};
+  for (const opts of [cacheOpts, {}]) {
+    try {
+      const cacheDir = ensurePackageInCache(parsed.packageName, parsed.version, opts);
+      if (stepLog) stepLog(`Loaded ${parsed.packageName} from cache: ${cacheDir}`);
+      const entryPath = getPackageEntryPath(cacheDir);
+      const req = createRequire(join(cacheDir, "package.json"));
+      const mod = req(entryPath);
+      const fn = getRegisterFn(mod);
+      if (typeof fn === "function") {
+        const resolvedVersion = basename(cacheDir);
         return { register: fn, descriptor: entryStr, resolvedVersion };
       }
+      break;
     } catch {
-      continue;
+      if (Object.keys(opts).length > 0) continue;
+      break;
     }
   }
   return null;
 }
+function loadAllExtensionsFromToolYamlSync(configFilePath, stepLog) {
+  const localPath = isAbsolute(configFilePath) ? configFilePath : resolve(process.cwd(), configFilePath);
+  if (!existsSync(localPath)) return [];
+  const config = loadToolConfig(localPath);
+  const tools = config.tools;
+  if (!Array.isArray(tools) || tools.length === 0) return [];
+  if (stepLog) stepLog("Loading extensions from tool.yaml (npm + file)");
+  const loaded = [];
+  for (const entry of tools) {
+    const entryStr = String(entry).trim();
+    if (entryStr.startsWith("npm:")) {
+      const result = loadExtensionForDescriptorSync(entryStr, configFilePath, stepLog);
+      if (result) loaded.push(result);
+    } else if (entryStr.startsWith("file:")) {
+      const result = loadExtensionFromFileDescriptorSync(entryStr, configFilePath, stepLog);
+      if (result) loaded.push(result);
+    }
+  }
+  return loaded;
+}
 function getInstalledPackageVersionFromRequire(packageName, req) {
   try {
     const pkgJsonPath = req.resolve(`${packageName}/package.json`);
@@ -1846,114 +2053,84 @@ function getInstalledPackageVersionFromRequire(packageName, req) {
     return null;
   }
 }
-function loadExtensionFromToolYamlCache(configFilePath, stepLog) {
+async function loadExtensionForDescriptorAsync(descriptor, configFilePath, stepLog) {
+  const syncResult = loadExtensionForDescriptorSync(descriptor, configFilePath, stepLog);
+  if (syncResult) return syncResult;
+  const entryStr = descriptor.trim();
+  const parsed = parseNpmDescriptor(entryStr);
+  if (!parsed) return null;
   const localPath = isAbsolute(configFilePath) ? configFilePath : resolve(process.cwd(), configFilePath);
-  if (!existsSync(localPath)) return null;
-  const config = loadToolConfig(localPath);
-  const tools = config.tools;
-  if (!Array.isArray(tools)) return null;
   const cacheBase = getCacheBaseFromToolConfig(localPath);
   const cacheOpts = cacheBase ? { cacheBase } : {};
-  if (stepLog) stepLog(`Loading extension from tool.yaml cache (cacheBase: ${cacheBase ?? "~/.agent/cache"})`);
-  for (const entry of tools) {
-    const entryStr = String(entry).trim();
-    const parsed = parseNpmDescriptor(entryStr);
-    if (!parsed) continue;
-    for (const opts of [cacheOpts, {}]) {
-      try {
-        if (stepLog && Object.keys(opts).length === 0 && cacheBase) stepLog("Falling back to default cache ~/.agent/cache");
-        const cacheDir = ensurePackageInCache(parsed.packageName, parsed.version, opts);
-        if (stepLog) stepLog(`Using cache: ${cacheDir}`);
-        const entryPath = getPackageEntryPath(cacheDir);
-        const req = createRequire(join(cacheDir, "package.json"));
-        const mod = req(entryPath);
-        const fn = getRegisterFn(mod);
-        if (typeof fn === "function") {
-          const resolvedVersion = basename(cacheDir);
-          return { register: fn, descriptor: entryStr, resolvedVersion };
-        }
-        break;
-      } catch {
-        if (Object.keys(opts).length > 0) continue;
-        break;
+  for (const opts of [cacheOpts, {}]) {
+    try {
+      const cacheDir = ensurePackageInCache(parsed.packageName, parsed.version, opts);
+      if (stepLog) stepLog(`Loaded ${parsed.packageName} from cache (async): ${cacheDir}`);
+      const mod = await importFromCache(cacheDir);
+      const fn = getRegisterFn(mod);
+      if (typeof fn === "function") {
+        const resolvedVersion = basename(cacheDir);
+        return { register: fn, descriptor: entryStr, resolvedVersion };
       }
+      break;
+    } catch {
+      if (Object.keys(opts).length > 0) continue;
+      break;
     }
   }
   return null;
 }
-async function loadExtensionFromToolYamlCacheAsync(configFilePath, stepLog) {
+async function loadAllExtensionsFromToolYamlAsync(configFilePath, stepLog) {
   const localPath = isAbsolute(configFilePath) ? configFilePath : resolve(process.cwd(), configFilePath);
-  if (!existsSync(localPath)) return null;
+  if (!existsSync(localPath)) return [];
   const config = loadToolConfig(localPath);
   const tools = config.tools;
-  if (!Array.isArray(tools)) return null;
-  const cacheBase = getCacheBaseFromToolConfig(localPath);
-  const cacheOpts = cacheBase ? { cacheBase } : {};
-  if (stepLog) stepLog("Loading extension from tool.yaml cache (async)");
+  if (!Array.isArray(tools) || tools.length === 0) return [];
+  if (stepLog) stepLog("Loading extensions from tool.yaml (async)");
+  const loaded = [];
   for (const entry of tools) {
     const entryStr = String(entry).trim();
-    const parsed = parseNpmDescriptor(entryStr);
-    if (!parsed) continue;
-    for (const opts of [cacheOpts, {}]) {
-      try {
-        if (stepLog && Object.keys(opts).length === 0 && cacheBase) stepLog("Falling back to default cache ~/.agent/cache");
-        const cacheDir = ensurePackageInCache(parsed.packageName, parsed.version, opts);
-        if (stepLog) stepLog(`Using cache: ${cacheDir}`);
-        const mod = await importFromCache(cacheDir);
-        const fn = getRegisterFn(mod);
-        if (typeof fn === "function") {
-          const resolvedVersion = basename(cacheDir);
-          return { register: fn, descriptor: entryStr, resolvedVersion };
-        }
-        break;
-      } catch {
-        if (Object.keys(opts).length > 0) continue;
-        break;
-      }
+    if (entryStr.startsWith("npm:")) {
+      const result = await loadExtensionForDescriptorAsync(entryStr, configFilePath, stepLog);
+      if (result) loaded.push(result);
+    } else if (entryStr.startsWith("file:")) {
+      const result = loadExtensionFromFileDescriptorSync(entryStr, configFilePath, stepLog);
+      if (result) loaded.push(result);
     }
   }
-  return null;
+  return loaded;
 }
 function createRuntimeFromConfigSync(options = {}) {
   const registry = new ToolRegistry();
   const stepLog = options.stepLog;
   if (options.coreTools !== void 0) {
+    if (options.configFilePath) {
+      const all = loadAllExtensionsFromToolYamlSync(options.configFilePath, stepLog);
+      if (all.length > 0) {
+        if (stepLog) stepLog(`Registered ${all.length} extension(s) from tool.yaml`);
+        const runtime3 = new PTCRuntime({ registry });
+        for (const ext of all) {
+          const prefix = ext.descriptor.startsWith("file:") ? fileDescriptorToRegistryPrefix(ext.descriptor) : npmDescriptorToRegistryPrefix(ext.descriptor, ext.resolvedVersion);
+          const reg = prefix ? createPrefixingRegistry(registry, prefix) : registry;
+          const adapter = ext.register(reg, options.coreTools);
+          runtime3.registerAdapter(adapter);
+        }
+        return { runtime: runtime3, registry };
+      }
+    }
     if (stepLog) stepLog("Trying extension from node_modules");
-    let extensionNode = loadExtensionFromNodeModules();
+    const extensionNode = loadExtensionFromNodeModules();
     if (extensionNode) {
       if (stepLog) stepLog("Registered extension from node_modules");
       const descriptor = `npm:${extensionNode.packageName}`;
-      const resolvedVersion = getInstalledPackageVersion(extensionNode.packageName);
-      const prefix = npmDescriptorToRegistryPrefix(descriptor, resolvedVersion ?? void 0);
+      const resolvedVersion = getInstalledPackageVersion(extensionNode.packageName) ?? resolveLatestVersionFromRegistry(extensionNode.packageName);
+      const prefix = npmDescriptorToRegistryPrefix(descriptor, resolvedVersion);
       const reg = prefix ? createPrefixingRegistry(registry, prefix) : registry;
       const coreAdapter = extensionNode.register(reg, options.coreTools);
       const runtime3 = new PTCRuntime({ registry });
       runtime3.registerAdapter(coreAdapter);
       return { runtime: runtime3, registry };
     }
-    if (options.configFilePath) {
-      const extensionFromNodeModules = loadExtensionFromToolYamlNodeModules(options.configFilePath, stepLog);
-      if (extensionFromNodeModules) {
-        if (stepLog) stepLog("Registered extension from tool.yaml list (node_modules)");
-        const prefix = npmDescriptorToRegistryPrefix(extensionFromNodeModules.descriptor, extensionFromNodeModules.resolvedVersion);
-        const reg = prefix ? createPrefixingRegistry(registry, prefix) : registry;
-        const coreAdapter = extensionFromNodeModules.register(reg, options.coreTools);
-        const runtime3 = new PTCRuntime({ registry });
-        runtime3.registerAdapter(coreAdapter);
-        return { runtime: runtime3, registry };
-      }
-      if (stepLog) stepLog("No extension in node_modules, loading from tool.yaml cache");
-      const extensionCache = loadExtensionFromToolYamlCache(options.configFilePath, stepLog);
-      if (extensionCache) {
-        if (stepLog) stepLog("Registered extension from cache");
-        const prefix = npmDescriptorToRegistryPrefix(extensionCache.descriptor, extensionCache.resolvedVersion);
-        const reg = prefix ? createPrefixingRegistry(registry, prefix) : registry;
-        const coreAdapter = extensionCache.register(reg, options.coreTools);
-        const runtime3 = new PTCRuntime({ registry });
-        runtime3.registerAdapter(coreAdapter);
-        return { runtime: runtime3, registry };
-      }
-    }
     const runtime2 = new PTCRuntime({ registry });
     return { runtime: runtime2, registry };
   }
@@ -1962,27 +2139,17 @@ function createRuntimeFromConfigSync(options = {}) {
 }
 async function createRuntimeFromConfig(options = {}) {
   if (options.coreTools !== void 0 && options.configFilePath) {
-    const fromNodeModules = loadExtensionFromToolYamlNodeModules(options.configFilePath, options.stepLog);
-    if (fromNodeModules) {
-      if (options.stepLog) options.stepLog("Registered extension from tool.yaml list (node_modules)");
+    const all = await loadAllExtensionsFromToolYamlAsync(options.configFilePath, options.stepLog);
+    if (all.length > 0) {
+      if (options.stepLog) options.stepLog(`Registered ${all.length} extension(s) from tool.yaml`);
       const registry = new ToolRegistry();
-      const prefix = npmDescriptorToRegistryPrefix(fromNodeModules.descriptor, fromNodeModules.resolvedVersion);
-      const reg = prefix ? createPrefixingRegistry(registry, prefix) : registry;
-      const coreAdapter = fromNodeModules.register(reg, options.coreTools);
       const runtime = new PTCRuntime({ registry });
-      runtime.registerAdapter(coreAdapter);
-      return { runtime, registry };
-    }
-    if (options.stepLog) options.stepLog("Loading extension from tool.yaml cache (dynamic: npm pack + import)");
-    const fromCache = await loadExtensionFromToolYamlCacheAsync(options.configFilePath, options.stepLog);
-    if (fromCache) {
-      if (options.stepLog) options.stepLog("Registered extension from cache");
-      const registry = new ToolRegistry();
-      const prefix = npmDescriptorToRegistryPrefix(fromCache.descriptor, fromCache.resolvedVersion);
-      const reg = prefix ? createPrefixingRegistry(registry, prefix) : registry;
-      const coreAdapter = fromCache.register(reg, options.coreTools);
-      const runtime = new PTCRuntime({ registry });
-      runtime.registerAdapter(coreAdapter);
+      for (const ext of all) {
+        const prefix = ext.descriptor.startsWith("file:") ? fileDescriptorToRegistryPrefix(ext.descriptor) : npmDescriptorToRegistryPrefix(ext.descriptor, ext.resolvedVersion);
+        const reg = prefix ? createPrefixingRegistry(registry, prefix) : registry;
+        const adapter = ext.register(reg, options.coreTools);
+        runtime.registerAdapter(adapter);
+      }
       return { runtime, registry };
     }
   }
@@ -1996,6 +2163,6 @@ var MCP_KIND = "mcp";
 var LANGCHAIN_KIND = "langchain";
 var LANGCHAIN_DIR_NAME = "langchain";
 
-export { BudgetManager, EventLog, LANGCHAIN_DIR_NAME, LANGCHAIN_KIND, MCP_KIND, Metrics, PTCRuntime, PolicyDeniedError, PolicyEngine, SchemaValidationError, SchemaValidator, Tracing, buildEvidence, createLogger, createRuntimeFromConfig, createRuntimeFromConfigSync, ensurePackageInCache, expandToolDescriptorsToRegistryNames, findAndLoadToolConfig, getDisplayScope, getPackageEntryPath, importFromCache, isBarePackageDescriptor, isNpmToolDescriptor, loadToolConfig, normalizeToolList, npmDescriptorToRegistryPrefix, parseNpmToolDescriptor, resolveNpmToolDescriptor, resolveSandboxedPath, resolveToolDescriptor, sanitizeForLog, summarizeForLog };
-//# sourceMappingURL=chunk-UUQGKFSG.js.map
-//# sourceMappingURL=chunk-UUQGKFSG.js.map
+export { BudgetManager, EventLog, LANGCHAIN_DIR_NAME, LANGCHAIN_KIND, MCP_KIND, Metrics, PTCRuntime, PolicyDeniedError, PolicyEngine, SchemaValidationError, SchemaValidator, Tracing, buildEvidence, createLogger, createRuntimeFromConfig, createRuntimeFromConfigSync, ensurePackageInCache, expandToolDescriptorsToRegistryNames, fileDescriptorToPackagePrefix, findAndLoadToolConfig, getDisplayScope, getPackageEntryPath, importFromCache, isBarePackageDescriptor, isNpmToolDescriptor, loadToolConfig, normalizeToolList, npmDescriptorToPackagePrefixWithVersion, npmDescriptorToRegistryPrefix, parseNpmToolDescriptor, resolveLatestVersionFromRegistry, resolveNpmToolDescriptor, resolveSandboxedPath, resolveToolDescriptor, sanitizeForLog, summarizeForLog };
+//# sourceMappingURL=chunk-7VBJ64YC.js.map
+//# sourceMappingURL=chunk-7VBJ64YC.js.map