@easynet/agent-common 1.0.0

package/dist/chunk-3PI6JR76.js

@@ -0,0 +1,253 @@
+// src/npm/provider.ts
+var NPM_PROTOCOL_PREFIX = "npm:";
+function isNpmProviderSpec(spec) {
+  return typeof spec === "string" && spec.startsWith(NPM_PROTOCOL_PREFIX);
+}
+function parseNpmProvider(provider) {
+  if (!isNpmProviderSpec(provider)) return null;
+  const rest = provider.slice(NPM_PROTOCOL_PREFIX.length);
+  const hashIdx = rest.indexOf("#");
+  const fragment = hashIdx >= 0 ? rest.slice(hashIdx + 1) : void 0;
+  const beforeHash = hashIdx >= 0 ? rest.slice(0, hashIdx) : rest;
+  const atIdx = beforeHash.startsWith("@") ? beforeHash.indexOf("@", 1) : beforeHash.lastIndexOf("@");
+  const pkg = atIdx > 0 ? beforeHash.slice(0, atIdx) : beforeHash;
+  const tag = atIdx > 0 ? beforeHash.slice(atIdx + 1) : void 0;
+  return { pkg: pkg || beforeHash, tag: tag || void 0, fragment };
+}
+function parseNpmProviderSpec(spec) {
+  const parsed = parseNpmProvider(spec);
+  if (!parsed) return null;
+  return {
+    packageName: parsed.pkg,
+    version: parsed.tag,
+    provider: parsed.fragment
+  };
+}
+
+// src/npm/version.ts
+import { execFileSync } from "child_process";
+import { readFileSync } from "fs";
+import { createRequire } from "module";
+var versionCache = /* @__PURE__ */ new Map();
+var CACHE_TTL = 5 * 60 * 1e3;
+function clearVersionCache() {
+  versionCache.clear();
+}
+function resolveNpmPackageVersion(pkg, tag, options = {}) {
+  const cacheKey = tag ? `${pkg}@${tag}` : pkg;
+  const cached = versionCache.get(cacheKey);
+  if (cached && Date.now() - cached.timestamp < CACHE_TTL) {
+    return cached.version;
+  }
+  try {
+    const spec = tag ? `${pkg}@${tag}` : pkg;
+    const out = execFileSync("npm", ["view", spec, "version"], {
+      cwd: options.cwd ?? process.cwd(),
+      encoding: "utf-8",
+      timeout: options.timeoutMs ?? 8e3,
+      stdio: ["ignore", "pipe", "pipe"]
+    });
+    const version = out?.trim() ?? null;
+    if (version) {
+      versionCache.set(cacheKey, { version, timestamp: Date.now() });
+    }
+    return version;
+  } catch {
+    return null;
+  }
+}
+function resolveLatestVersionFromRegistry(packageName, options = {}) {
+  const version = resolveNpmPackageVersion(packageName, void 0, options);
+  if (!version) {
+    throw new Error(`Failed to resolve latest version for ${packageName}`);
+  }
+  return version;
+}
+function formatProviderDisplay(provider) {
+  const parsed = parseNpmProvider(provider);
+  if (parsed == null) return provider;
+  const resolved = resolveNpmPackageVersion(parsed.pkg, parsed.tag);
+  const version = resolved ?? parsed.tag ?? "latest";
+  const frag = parsed.fragment ? `#${parsed.fragment}` : "";
+  return `npm:${parsed.pkg}@${version}${frag}`;
+}
+function getInstalledVersion(packageName, options = {}) {
+  const cwd = options.cwd ?? process.cwd();
+  const req = createRequire(import.meta.url);
+  try {
+    const p = req.resolve(`${packageName}/package.json`, { paths: [cwd] });
+    const j = JSON.parse(readFileSync(p, "utf-8"));
+    return typeof j.version === "string" ? j.version : null;
+  } catch {
+    return null;
+  }
+}
+
+// src/npm/install.ts
+import { execFileSync as execFileSync2 } from "child_process";
+var VERSION_LATEST = "latest";
+async function resolveInstallVersion(packageName, version, cwd) {
+  const isLatestOrEmpty = version === void 0 || version === "" || typeof version === "string" && version.toLowerCase() === VERSION_LATEST;
+  if (isLatestOrEmpty) {
+    return resolveLatestVersionFromRegistry(packageName, { cwd });
+  }
+  return version;
+}
+async function ensureNpmPackageInstalled(packageName, options = {}) {
+  if (typeof packageName !== "string" || packageName.trim().length === 0) {
+    throw new Error("ensureNpmPackageInstalled requires a non-empty package name");
+  }
+  const cwd = options.cwd ?? process.cwd();
+  const resolvedVersion = await resolveInstallVersion(packageName, options.version, cwd);
+  const installedVersion = getInstalledVersion(packageName, { cwd });
+  if (installedVersion === resolvedVersion) return;
+  const installSpec = `${packageName}@${resolvedVersion}`;
+  const prefix = options.logPrefix ?? "[agent-common]";
+  if (installedVersion === null) {
+    console.info(`${prefix} Installing provider: ${installSpec}`);
+  } else {
+    console.info(`${prefix} Updating provider: ${packageName} ${installedVersion} -> ${resolvedVersion}`);
+  }
+  const args = ["install", installSpec];
+  if (options.noPackageLock !== false) args.push("--no-package-lock");
+  try {
+    execFileSync2("npm", args, {
+      cwd,
+      stdio: options.stdio ?? "inherit",
+      encoding: "utf-8"
+    });
+  } catch (e) {
+    const msg = e instanceof Error ? e.message : String(e);
+    throw new Error(`npm install failed for ${installSpec}: ${msg}`, { cause: e });
+  }
+}
+
+// src/npm/cache.ts
+import { execSync } from "child_process";
+import { readFileSync as readFileSync2, readdirSync, mkdirSync, rmSync, renameSync, existsSync } from "fs";
+import { join } from "path";
+import { homedir } from "os";
+import { pathToFileURL } from "url";
+var DEFAULT_CACHE_BASE = join(homedir(), ".agent", "cache");
+function isLatestRequest(version) {
+  const v = (version ?? "").trim().toLowerCase();
+  return v === "" || v === "latest";
+}
+function getCachedPackageVersion(cacheDir) {
+  const pkgPath = join(cacheDir, "package.json");
+  if (!existsSync(pkgPath)) return void 0;
+  try {
+    const pkg = JSON.parse(readFileSync2(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);
+}
+function resolveCacheDir(cacheBase, packageName, version) {
+  const segments = packagePathSegments(packageName);
+  return join(cacheBase, ...segments, version);
+}
+function ensurePackageInCache(packageName, version = "latest", options = {}) {
+  const cacheBase = options.cacheBase ?? DEFAULT_CACHE_BASE;
+  const resolvedVersion = isLatestRequest(version) ? resolveLatestVersionFromRegistry(packageName) : 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}@${resolvedVersion} --pack-destination "${packDest}"`, {
+      cwd: process.cwd(),
+      stdio: "pipe",
+      encoding: "utf-8"
+    });
+    const files = readdirSync(packDest);
+    const tgz = files.find((f) => f.endsWith(".tgz"));
+    if (!tgz) throw new Error(`npm pack did not produce a .tgz in ${packDest}`);
+    const extractDir = join(packDest, "extract");
+    mkdirSync(extractDir, { recursive: true });
+    execSync(`tar -xzf "${join(packDest, tgz)}" -C "${extractDir}"`, {
+      stdio: "pipe",
+      encoding: "utf-8"
+    });
+    const extractedPackage = join(extractDir, "package");
+    if (!existsSync(extractedPackage)) {
+      throw new Error(`Extracted tarball did not contain "package" dir in ${extractDir}`);
+    }
+    mkdirSync(join(cacheDir, ".."), { recursive: true });
+    if (existsSync(cacheDir)) rmSync(cacheDir, { recursive: true, force: true });
+    renameSync(extractedPackage, cacheDir);
+    const npmInstallTimeout = 12e4;
+    const maxAttempts = 3;
+    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
+        });
+        break;
+      } catch (err) {
+        if (attempt >= maxAttempts) {
+          const lastErr = err instanceof Error ? err : new Error(String(err));
+          throw new Error(`npm install in cache failed after ${maxAttempts} attempts: ${lastErr.message}`);
+        }
+        const delayMs = 5e3 * attempt;
+        const deadline = Date.now() + delayMs;
+        while (Date.now() < deadline) {
+        }
+      }
+    }
+    options.afterInstall?.(cacheDir, packageName);
+    return cacheDir;
+  } finally {
+    if (existsSync(packDest)) rmSync(packDest, { recursive: true, force: true });
+  }
+}
+function getPackageEntryPath(packageRoot) {
+  const pkgPath = join(packageRoot, "package.json");
+  if (!existsSync(pkgPath)) throw new Error(`No package.json in ${packageRoot}`);
+  const pkg = JSON.parse(readFileSync2(pkgPath, "utf-8"));
+  const main = pkg.main ?? "dist/index.js";
+  const entry = join(packageRoot, main);
+  if (!existsSync(entry)) throw new Error(`Entry not found: ${entry}`);
+  return entry;
+}
+async function importFromCache(packageRoot) {
+  const entryPath = getPackageEntryPath(packageRoot);
+  const fileUrl = pathToFileURL(entryPath).href;
+  return import(
+    /* @vite-ignore */
+    fileUrl
+  );
+}
+
+export {
+  NPM_PROTOCOL_PREFIX,
+  isNpmProviderSpec,
+  parseNpmProvider,
+  parseNpmProviderSpec,
+  clearVersionCache,
+  resolveNpmPackageVersion,
+  resolveLatestVersionFromRegistry,
+  formatProviderDisplay,
+  getInstalledVersion,
+  ensureNpmPackageInstalled,
+  ensurePackageInCache,
+  getPackageEntryPath,
+  importFromCache
+};
+//# sourceMappingURL=chunk-3PI6JR76.js.map

package/dist/chunk-3PI6JR76.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/npm/provider.ts","../src/npm/version.ts","../src/npm/install.ts","../src/npm/cache.ts"],"sourcesContent":["export const NPM_PROTOCOL_PREFIX = \"npm:\";\n\nexport interface NpmProviderInfo {\n  pkg: string;\n  tag?: string;\n  fragment?: string;\n}\n\nexport interface NpmProviderSpec {\n  packageName: string;\n  version?: string;\n  provider?: string;\n}\n\nexport function isNpmProviderSpec(spec: unknown): spec is string {\n  return typeof spec === \"string\" && spec.startsWith(NPM_PROTOCOL_PREFIX);\n}\n\nexport function parseNpmProvider(provider: string): NpmProviderInfo | null {\n  if (!isNpmProviderSpec(provider)) return null;\n  const rest = provider.slice(NPM_PROTOCOL_PREFIX.length);\n  const hashIdx = rest.indexOf(\"#\");\n  const fragment = hashIdx >= 0 ? rest.slice(hashIdx + 1) : undefined;\n  const beforeHash = hashIdx >= 0 ? rest.slice(0, hashIdx) : rest;\n  const atIdx = beforeHash.startsWith(\"@\") ? beforeHash.indexOf(\"@\", 1) : beforeHash.lastIndexOf(\"@\");\n  const pkg = atIdx > 0 ? beforeHash.slice(0, atIdx) : beforeHash;\n  const tag = atIdx > 0 ? beforeHash.slice(atIdx + 1) : undefined;\n  return { pkg: pkg || beforeHash, tag: tag || undefined, fragment };\n}\n\nexport function parseNpmProviderSpec(spec: string): NpmProviderSpec | null {\n  const parsed = parseNpmProvider(spec);\n  if (!parsed) return null;\n  return {\n    packageName: parsed.pkg,\n    version: parsed.tag,\n    provider: parsed.fragment,\n  };\n}\n","import { execFileSync } from \"node:child_process\";\nimport { readFileSync } from \"node:fs\";\nimport { createRequire } from \"node:module\";\nimport { parseNpmProvider } from \"./provider.js\";\n\ninterface VersionCacheEntry {\n  version: string;\n  timestamp: number;\n}\n\nconst versionCache = new Map<string, VersionCacheEntry>();\nconst CACHE_TTL = 5 * 60 * 1000;\n\nexport interface ResolveNpmVersionOptions {\n  cwd?: string;\n  timeoutMs?: number;\n}\n\nexport function clearVersionCache(): void {\n  versionCache.clear();\n}\n\nexport function resolveNpmPackageVersion(pkg: string, tag?: string, options: ResolveNpmVersionOptions = {}): string | null {\n  const cacheKey = tag ? `${pkg}@${tag}` : pkg;\n  const cached = versionCache.get(cacheKey);\n  if (cached && Date.now() - cached.timestamp < CACHE_TTL) {\n    return cached.version;\n  }\n\n  try {\n    const spec = tag ? `${pkg}@${tag}` : pkg;\n    const out = execFileSync(\"npm\", [\"view\", spec, \"version\"], {\n      cwd: options.cwd ?? process.cwd(),\n      encoding: \"utf-8\",\n      timeout: options.timeoutMs ?? 8000,\n      stdio: [\"ignore\", \"pipe\", \"pipe\"],\n    });\n    const version = out?.trim() ?? null;\n    if (version) {\n      versionCache.set(cacheKey, { version, timestamp: Date.now() });\n    }\n    return version;\n  } catch {\n    return null;\n  }\n}\n\nexport function resolveLatestVersionFromRegistry(packageName: string, options: ResolveNpmVersionOptions = {}): string {\n  const version = resolveNpmPackageVersion(packageName, undefined, options);\n  if (!version) {\n    throw new Error(`Failed to resolve latest version for ${packageName}`);\n  }\n  return version;\n}\n\nexport function formatProviderDisplay(provider: string): string {\n  const parsed = parseNpmProvider(provider);\n  if (parsed == null) return provider;\n\n  const resolved = resolveNpmPackageVersion(parsed.pkg, parsed.tag);\n  const version = resolved ?? parsed.tag ?? \"latest\";\n  const frag = parsed.fragment ? `#${parsed.fragment}` : \"\";\n  return `npm:${parsed.pkg}@${version}${frag}`;\n}\n\nexport function getInstalledVersion(packageName: string, options: { cwd?: string } = {}): string | null {\n  const cwd = options.cwd ?? process.cwd();\n  const req = createRequire(import.meta.url);\n  try {\n    const p = req.resolve(`${packageName}/package.json`, { paths: [cwd] });\n    const j = JSON.parse(readFileSync(p, \"utf-8\")) as { version?: string };\n    return typeof j.version === \"string\" ? j.version : null;\n  } catch {\n    return null;\n  }\n}\n","import { execFileSync } from \"node:child_process\";\nimport { getInstalledVersion, resolveLatestVersionFromRegistry } from \"./version.js\";\n\nconst VERSION_LATEST = \"latest\";\n\nexport interface EnsureNpmPackageInstalledOptions {\n  version?: string;\n  cwd?: string;\n  stdio?: \"inherit\" | \"pipe\";\n  noPackageLock?: boolean;\n  logPrefix?: string;\n}\n\nasync function resolveInstallVersion(\n  packageName: string,\n  version: string | undefined,\n  cwd: string,\n): Promise<string> {\n  const isLatestOrEmpty =\n    version === undefined ||\n    version === \"\" ||\n    (typeof version === \"string\" && version.toLowerCase() === VERSION_LATEST);\n  if (isLatestOrEmpty) {\n    return resolveLatestVersionFromRegistry(packageName, { cwd });\n  }\n  return version;\n}\n\nexport async function ensureNpmPackageInstalled(\n  packageName: string,\n  options: EnsureNpmPackageInstalledOptions = {},\n): Promise<void> {\n  if (typeof packageName !== \"string\" || packageName.trim().length === 0) {\n    throw new Error(\"ensureNpmPackageInstalled requires a non-empty package name\");\n  }\n\n  const cwd = options.cwd ?? process.cwd();\n  const resolvedVersion = await resolveInstallVersion(packageName, options.version, cwd);\n  const installedVersion = getInstalledVersion(packageName, { cwd });\n\n  if (installedVersion === resolvedVersion) return;\n\n  const installSpec = `${packageName}@${resolvedVersion}`;\n  const prefix = options.logPrefix ?? \"[agent-common]\";\n  if (installedVersion === null) {\n    console.info(`${prefix} Installing provider: ${installSpec}`);\n  } else {\n    console.info(`${prefix} Updating provider: ${packageName} ${installedVersion} -> ${resolvedVersion}`);\n  }\n\n  const args = [\"install\", installSpec];\n  if (options.noPackageLock !== false) args.push(\"--no-package-lock\");\n\n  try {\n    execFileSync(\"npm\", args, {\n      cwd,\n      stdio: options.stdio ?? \"inherit\",\n      encoding: \"utf-8\",\n    });\n  } catch (e) {\n    const msg = e instanceof Error ? e.message : String(e);\n    throw new Error(`npm install failed for ${installSpec}: ${msg}`, { cause: e });\n  }\n}\n","import { execSync } from \"node:child_process\";\nimport { readFileSync, readdirSync, mkdirSync, rmSync, renameSync, existsSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport { homedir } from \"node:os\";\nimport { pathToFileURL } from \"node:url\";\nimport { resolveLatestVersionFromRegistry } from \"./version.js\";\n\nexport interface EnsurePackageInCacheOptions {\n  cacheBase?: string;\n  afterInstall?: (cacheDir: string, packageName: string) => void;\n}\n\nconst DEFAULT_CACHE_BASE = join(homedir(), \".agent\", \"cache\");\n\nfunction isLatestRequest(version: string): boolean {\n  const v = (version ?? \"\").trim().toLowerCase();\n  return v === \"\" || v === \"latest\";\n}\n\nfunction getCachedPackageVersion(cacheDir: string): string | undefined {\n  const pkgPath = join(cacheDir, \"package.json\");\n  if (!existsSync(pkgPath)) return undefined;\n  try {\n    const pkg = JSON.parse(readFileSync(pkgPath, \"utf-8\")) as { version?: string };\n    return typeof pkg.version === \"string\" ? pkg.version : undefined;\n  } catch {\n    return undefined;\n  }\n}\n\nfunction packagePathSegments(name: string): string[] {\n  const withoutScope = name.replace(/^@/, \"\");\n  return withoutScope.split(\"/\").filter(Boolean);\n}\n\nfunction resolveCacheDir(cacheBase: string, packageName: string, version: string): string {\n  const segments = packagePathSegments(packageName);\n  return join(cacheBase, ...segments, version);\n}\n\nexport function ensurePackageInCache(\n  packageName: string,\n  version: string = \"latest\",\n  options: EnsurePackageInCacheOptions = {},\n): string {\n  const cacheBase = options.cacheBase ?? DEFAULT_CACHE_BASE;\n  const resolvedVersion = isLatestRequest(version)\n    ? resolveLatestVersionFromRegistry(packageName)\n    : version;\n\n  const cacheDir = resolveCacheDir(cacheBase, packageName, resolvedVersion);\n  const packageJsonPath = join(cacheDir, \"package.json\");\n  const nodeModulesPath = join(cacheDir, \"node_modules\");\n\n  if (existsSync(packageJsonPath) && existsSync(nodeModulesPath)) {\n    const cachedVersion = getCachedPackageVersion(cacheDir);\n    if (cachedVersion === resolvedVersion) {\n      options.afterInstall?.(cacheDir, packageName);\n      return cacheDir;\n    }\n    rmSync(cacheDir, { recursive: true, force: true });\n  }\n\n  const packDest = join(cacheBase, \".pack-tmp\", packageName.replace(/@/g, \"\").replace(/\\//g, \"_\"));\n  mkdirSync(packDest, { recursive: true });\n\n  try {\n    execSync(`npm pack ${packageName}@${resolvedVersion} --pack-destination \"${packDest}\"`, {\n      cwd: process.cwd(),\n      stdio: \"pipe\",\n      encoding: \"utf-8\",\n    });\n\n    const files = readdirSync(packDest);\n    const tgz = files.find((f) => f.endsWith(\".tgz\"));\n    if (!tgz) throw new Error(`npm pack did not produce a .tgz in ${packDest}`);\n\n    const extractDir = join(packDest, \"extract\");\n    mkdirSync(extractDir, { recursive: true });\n    execSync(`tar -xzf \"${join(packDest, tgz)}\" -C \"${extractDir}\"`, {\n      stdio: \"pipe\",\n      encoding: \"utf-8\",\n    });\n\n    const extractedPackage = join(extractDir, \"package\");\n    if (!existsSync(extractedPackage)) {\n      throw new Error(`Extracted tarball did not contain \\\"package\\\" dir in ${extractDir}`);\n    }\n\n    mkdirSync(join(cacheDir, \"..\"), { recursive: true });\n    if (existsSync(cacheDir)) rmSync(cacheDir, { recursive: true, force: true });\n    renameSync(extractedPackage, cacheDir);\n\n    const npmInstallTimeout = 120_000;\n    const maxAttempts = 3;\n    for (let attempt = 1; attempt <= maxAttempts; attempt++) {\n      try {\n        execSync(\"npm install --prefer-offline --no-audit --no-fund\", {\n          cwd: cacheDir,\n          stdio: \"pipe\",\n          encoding: \"utf-8\",\n          timeout: npmInstallTimeout,\n        });\n        break;\n      } catch (err) {\n        if (attempt >= maxAttempts) {\n          const lastErr = err instanceof Error ? err : new Error(String(err));\n          throw new Error(`npm install in cache failed after ${maxAttempts} attempts: ${lastErr.message}`);\n        }\n        const delayMs = 5_000 * attempt;\n        const deadline = Date.now() + delayMs;\n        while (Date.now() < deadline) {\n          // retry delay\n        }\n      }\n    }\n\n    options.afterInstall?.(cacheDir, packageName);\n    return cacheDir;\n  } finally {\n    if (existsSync(packDest)) rmSync(packDest, { recursive: true, force: true });\n  }\n}\n\nexport function getPackageEntryPath(packageRoot: string): string {\n  const pkgPath = join(packageRoot, \"package.json\");\n  if (!existsSync(pkgPath)) throw new Error(`No package.json in ${packageRoot}`);\n  const pkg = JSON.parse(readFileSync(pkgPath, \"utf-8\")) as { main?: string };\n  const main = pkg.main ?? \"dist/index.js\";\n  const entry = join(packageRoot, main);\n  if (!existsSync(entry)) throw new Error(`Entry not found: ${entry}`);\n  return entry;\n}\n\nexport async function importFromCache(packageRoot: string): Promise<unknown> {\n  const entryPath = getPackageEntryPath(packageRoot);\n  const fileUrl = pathToFileURL(entryPath).href;\n  return import(/* @vite-ignore */ fileUrl);\n}\n"],"mappings":"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","names":["execFileSync","execFileSync","readFileSync","readFileSync"]}

package/dist/index.d.ts

@@ -0,0 +1 @@
+export * from "./npm/index.js";

package/dist/index.js

@@ -0,0 +1,31 @@
+import {
+  NPM_PROTOCOL_PREFIX,
+  clearVersionCache,
+  ensureNpmPackageInstalled,
+  ensurePackageInCache,
+  formatProviderDisplay,
+  getInstalledVersion,
+  getPackageEntryPath,
+  importFromCache,
+  isNpmProviderSpec,
+  parseNpmProvider,
+  parseNpmProviderSpec,
+  resolveLatestVersionFromRegistry,
+  resolveNpmPackageVersion
+} from "./chunk-3PI6JR76.js";
+export {
+  NPM_PROTOCOL_PREFIX,
+  clearVersionCache,
+  ensureNpmPackageInstalled,
+  ensurePackageInCache,
+  formatProviderDisplay,
+  getInstalledVersion,
+  getPackageEntryPath,
+  importFromCache,
+  isNpmProviderSpec,
+  parseNpmProvider,
+  parseNpmProviderSpec,
+  resolveLatestVersionFromRegistry,
+  resolveNpmPackageVersion
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/npm/cache.d.ts

@@ -0,0 +1,7 @@
+export interface EnsurePackageInCacheOptions {
+    cacheBase?: string;
+    afterInstall?: (cacheDir: string, packageName: string) => void;
+}
+export declare function ensurePackageInCache(packageName: string, version?: string, options?: EnsurePackageInCacheOptions): string;
+export declare function getPackageEntryPath(packageRoot: string): string;
+export declare function importFromCache(packageRoot: string): Promise<unknown>;

package/dist/npm/index.d.ts

@@ -0,0 +1,4 @@
+export { NPM_PROTOCOL_PREFIX, isNpmProviderSpec, parseNpmProvider, parseNpmProviderSpec, type NpmProviderInfo, type NpmProviderSpec, } from "./provider.js";
+export { clearVersionCache, resolveNpmPackageVersion, resolveLatestVersionFromRegistry, formatProviderDisplay, getInstalledVersion, type ResolveNpmVersionOptions, } from "./version.js";
+export { ensureNpmPackageInstalled, type EnsureNpmPackageInstalledOptions, } from "./install.js";
+export { ensurePackageInCache, getPackageEntryPath, importFromCache, type EnsurePackageInCacheOptions, } from "./cache.js";

package/dist/npm/index.js

@@ -0,0 +1,31 @@
+import {
+  NPM_PROTOCOL_PREFIX,
+  clearVersionCache,
+  ensureNpmPackageInstalled,
+  ensurePackageInCache,
+  formatProviderDisplay,
+  getInstalledVersion,
+  getPackageEntryPath,
+  importFromCache,
+  isNpmProviderSpec,
+  parseNpmProvider,
+  parseNpmProviderSpec,
+  resolveLatestVersionFromRegistry,
+  resolveNpmPackageVersion
+} from "../chunk-3PI6JR76.js";
+export {
+  NPM_PROTOCOL_PREFIX,
+  clearVersionCache,
+  ensureNpmPackageInstalled,
+  ensurePackageInCache,
+  formatProviderDisplay,
+  getInstalledVersion,
+  getPackageEntryPath,
+  importFromCache,
+  isNpmProviderSpec,
+  parseNpmProvider,
+  parseNpmProviderSpec,
+  resolveLatestVersionFromRegistry,
+  resolveNpmPackageVersion
+};
+//# sourceMappingURL=index.js.map

package/dist/npm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/npm/install.d.ts

@@ -0,0 +1,8 @@
+export interface EnsureNpmPackageInstalledOptions {
+    version?: string;
+    cwd?: string;
+    stdio?: "inherit" | "pipe";
+    noPackageLock?: boolean;
+    logPrefix?: string;
+}
+export declare function ensureNpmPackageInstalled(packageName: string, options?: EnsureNpmPackageInstalledOptions): Promise<void>;

package/dist/npm/provider.d.ts

@@ -0,0 +1,14 @@
+export declare const NPM_PROTOCOL_PREFIX = "npm:";
+export interface NpmProviderInfo {
+    pkg: string;
+    tag?: string;
+    fragment?: string;
+}
+export interface NpmProviderSpec {
+    packageName: string;
+    version?: string;
+    provider?: string;
+}
+export declare function isNpmProviderSpec(spec: unknown): spec is string;
+export declare function parseNpmProvider(provider: string): NpmProviderInfo | null;
+export declare function parseNpmProviderSpec(spec: string): NpmProviderSpec | null;

package/dist/npm/version.d.ts

@@ -0,0 +1,11 @@
+export interface ResolveNpmVersionOptions {
+    cwd?: string;
+    timeoutMs?: number;
+}
+export declare function clearVersionCache(): void;
+export declare function resolveNpmPackageVersion(pkg: string, tag?: string, options?: ResolveNpmVersionOptions): string | null;
+export declare function resolveLatestVersionFromRegistry(packageName: string, options?: ResolveNpmVersionOptions): string;
+export declare function formatProviderDisplay(provider: string): string;
+export declare function getInstalledVersion(packageName: string, options?: {
+    cwd?: string;
+}): string | null;

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@easynet/agent-common",
+  "version": "1.0.0",
+  "description": "Shared runtime utilities for Easynet agent projects",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "typesVersions": {
+    "*": {
+      "npm": [
+        "dist/npm/index.d.ts"
+      ],
+      "*": [
+        "dist/*"
+      ]
+    }
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./npm": {
+      "types": "./dist/npm/index.d.ts",
+      "import": "./dist/npm/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup && tsc -p tsconfig.dts.json",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "npm run build && npm run typecheck",
+    "release": "semantic-release"
+  },
+  "devDependencies": {
+    "@semantic-release/commit-analyzer": "^13.0.0",
+    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/npm": "^12.0.0",
+    "@semantic-release/release-notes-generator": "^14.0.0",
+    "@types/node": "^22.10.0",
+    "semantic-release": "^24.2.0",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/easynet-world/agent-common.git"
+  },
+  "homepage": "https://github.com/easynet-world/agent-common#readme",
+  "bugs": {
+    "url": "https://github.com/easynet-world/agent-common/issues"
+  }
+}