@sentry/junior 0.11.1 → 0.12.1

package/dist/{chunk-ZYB3U7Q4.js → chunk-Y2LVMCQ3.js}

@@ -1,13 +1,22 @@
 import {
   sentry_exports
 } from "./chunk-Z3YD6NHK.js";
-import {
-  discoverInstalledPluginPackageContent,
-  pluginRoots
-} from "./chunk-XH7TV4JS.js";
 
 // src/chat/logging.ts
 import { AsyncLocalStorage } from "async_hooks";
+
+// src/chat/coerce.ts
+function toOptionalString(value) {
+  return typeof value === "string" && value.trim() ? value : void 0;
+}
+function toOptionalNumber(value) {
+  return typeof value === "number" && Number.isFinite(value) ? value : void 0;
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null;
+}
+
+// src/chat/logging.ts
 var MAX_STRING_VALUE = 1200;
 var SECRETS_RE = [
   /\b(sk-[A-Za-z0-9_-]{20,})\b/g,
@@ -679,9 +688,6 @@ function setSpanStatus(status) {
   }
   setStatus.call(span, status === "ok" ? "ok" : "internal_error");
 }
-function toOptionalString(value) {
-  return typeof value === "string" && value.trim() ? value : void 0;
-}
 function getActiveTraceId() {
   const sentry = sentry_exports;
   if (typeof sentry.getActiveSpan !== "function" || typeof sentry.spanToJSON !== "function") {
@@ -853,9 +859,560 @@ function extractGenAiUsageAttributes(...sources) {
   };
 }
 
+// src/chat/plugins/package-discovery.ts
+import { readFileSync, readdirSync as readdirSync2 } from "fs";
+import path2 from "path";
+import { parse as parseYaml } from "yaml";
+
+// src/chat/discovery.ts
+import fs, { readdirSync, statSync } from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+function isDirectory(targetPath) {
+  try {
+    return statSync(targetPath).isDirectory();
+  } catch {
+    return false;
+  }
+}
+function isFile(targetPath) {
+  try {
+    return statSync(targetPath).isFile();
+  } catch {
+    return false;
+  }
+}
+function normalizePath(targetPath) {
+  return path.resolve(targetPath);
+}
+function uniqueResolvedPathsInOrder(values) {
+  const seen = /* @__PURE__ */ new Set();
+  const resolved = [];
+  for (const value of values) {
+    const normalized = normalizePath(value);
+    if (seen.has(normalized)) {
+      continue;
+    }
+    seen.add(normalized);
+    resolved.push(normalized);
+  }
+  return resolved;
+}
+function isNodeModulesPath(candidatePath) {
+  return path.basename(candidatePath) === "node_modules";
+}
+function isInsidePnpmStore(candidatePath) {
+  return candidatePath.split(path.sep).includes(".pnpm");
+}
+function runningFromInstalledPackage() {
+  const currentFile = fileURLToPath(import.meta.url);
+  const marker = `${path.sep}node_modules${path.sep}@sentry${path.sep}junior${path.sep}`;
+  return currentFile.includes(marker);
+}
+function listInstalledPackageNodeModulesDirs() {
+  if (!runningFromInstalledPackage()) {
+    return [];
+  }
+  const dirs = [];
+  let current = path.resolve(path.dirname(fileURLToPath(import.meta.url)));
+  while (true) {
+    if (isNodeModulesPath(current) && !isInsidePnpmStore(current) && isDirectory(current)) {
+      dirs.push(current);
+    }
+    const parent = path.dirname(current);
+    if (parent === current) {
+      break;
+    }
+    current = parent;
+  }
+  return dirs;
+}
+function listCwdAncestorNodeModulesDirs(cwd) {
+  const resolvedCwd = normalizePath(cwd);
+  const dirs = [];
+  let current = resolvedCwd;
+  while (true) {
+    const nodeModulesDir = path.join(current, "node_modules");
+    if (isDirectory(nodeModulesDir)) {
+      dirs.push(nodeModulesDir);
+    }
+    if (isFile(path.join(current, "package.json"))) {
+      break;
+    }
+    const parent = path.dirname(current);
+    if (parent === current) {
+      break;
+    }
+    current = parent;
+  }
+  return dirs;
+}
+function discoverNodeModulesDirs(cwd = process.cwd(), options) {
+  const explicit = options?.candidateDirs?.filter((dir) => isDirectory(dir)) ?? [];
+  if (explicit.length > 0) {
+    return uniqueResolvedPathsInOrder(explicit);
+  }
+  return uniqueResolvedPathsInOrder([
+    ...listInstalledPackageNodeModulesDirs(),
+    ...listCwdAncestorNodeModulesDirs(cwd)
+  ]);
+}
+function discoverProjectRoots(cwd = process.cwd(), options) {
+  const roots = discoverNodeModulesDirs(
+    cwd,
+    options?.nodeModulesDirs ? { candidateDirs: options.nodeModulesDirs } : void 0
+  ).map((nodeModulesDir) => path.dirname(nodeModulesDir));
+  return uniqueResolvedPathsInOrder([cwd, ...roots]);
+}
+function listTopLevelPackages(nodeModulesDir) {
+  const entries = readdirSync(nodeModulesDir, { withFileTypes: true }).filter(
+    (entry) => !entry.name.startsWith(".") && entry.name !== ".bin" && entry.name !== ".pnpm"
+  ).sort((left, right) => left.name.localeCompare(right.name));
+  const packages = [];
+  for (const entry of entries) {
+    const entryPath = path.join(nodeModulesDir, entry.name);
+    if (entry.name.startsWith("@")) {
+      if (!isDirectory(entryPath)) {
+        continue;
+      }
+      const scopedEntries = readdirSync(entryPath, {
+        withFileTypes: true
+      }).sort((left, right) => left.name.localeCompare(right.name));
+      for (const scopedEntry of scopedEntries) {
+        const packageName = `${entry.name}/${scopedEntry.name}`;
+        const packagePath = path.join(entryPath, scopedEntry.name);
+        if (!isDirectory(packagePath)) {
+          continue;
+        }
+        packages.push({ name: packageName, dir: packagePath });
+      }
+      continue;
+    }
+    if (!isDirectory(entryPath)) {
+      continue;
+    }
+    packages.push({ name: entry.name, dir: entryPath });
+  }
+  return packages;
+}
+function unique(values) {
+  return [...new Set(values)];
+}
+function pathExists(targetPath) {
+  try {
+    fs.accessSync(targetPath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function hasAnyDataMarkers(appDir) {
+  return pathExists(path.join(appDir, "SOUL.md")) || pathExists(path.join(appDir, "ABOUT.md"));
+}
+function scoreAppCandidate(appDir) {
+  let score = 0;
+  if (pathExists(path.join(appDir, "SOUL.md"))) {
+    score += 4;
+  }
+  if (pathExists(path.join(appDir, "ABOUT.md"))) {
+    score += 2;
+  }
+  if (pathExists(path.join(appDir, "skills"))) {
+    score += 1;
+  }
+  if (pathExists(path.join(appDir, "plugins"))) {
+    score += 1;
+  }
+  return score;
+}
+function resolveCandidateAppDirs(cwd, projectRoots) {
+  const roots = projectRoots ?? discoverProjectRoots(cwd);
+  const resolved = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const root of roots) {
+    const appDir = path.resolve(root, "app");
+    if (!pathExists(appDir)) {
+      continue;
+    }
+    if (seen.has(appDir)) {
+      continue;
+    }
+    seen.add(appDir);
+    resolved.push(appDir);
+  }
+  return resolved;
+}
+function homeDir() {
+  return resolveHomeDir();
+}
+function resolveHomeDir(cwd = process.cwd(), options) {
+  const resolvedCwd = path.resolve(cwd);
+  const directApp = path.resolve(resolvedCwd, "app");
+  if (pathExists(directApp) && hasAnyDataMarkers(directApp)) {
+    return directApp;
+  }
+  const candidates = resolveCandidateAppDirs(
+    resolvedCwd,
+    options?.projectRoots
+  );
+  if (candidates.length === 0) {
+    return directApp;
+  }
+  candidates.sort((left, right) => {
+    const leftScore = scoreAppCandidate(left);
+    const rightScore = scoreAppCandidate(right);
+    if (leftScore !== rightScore) {
+      return rightScore - leftScore;
+    }
+    const leftDistance = path.relative(resolvedCwd, left).split(path.sep).length;
+    const rightDistance = path.relative(resolvedCwd, right).split(path.sep).length;
+    if (leftDistance !== rightDistance) {
+      return leftDistance - rightDistance;
+    }
+    return left.localeCompare(right);
+  });
+  return candidates[0];
+}
+function resolveContentRoots(subdir) {
+  if (subdir === "data") {
+    return [homeDir()];
+  }
+  return [path.join(homeDir(), subdir)];
+}
+function dataRoots() {
+  return unique(resolveContentRoots("data"));
+}
+function skillRoots() {
+  return unique(resolveContentRoots("skills"));
+}
+function pluginRoots() {
+  return unique(resolveContentRoots("plugins"));
+}
+function soulPathCandidates() {
+  const candidates = dataRoots().map((root) => path.join(root, "SOUL.md"));
+  return unique(candidates);
+}
+function aboutPathCandidates() {
+  const candidates = dataRoots().map((root) => path.join(root, "ABOUT.md"));
+  return unique(candidates);
+}
+
+// src/chat/plugins/package-discovery.ts
+function normalizeForGlob(targetPath) {
+  return targetPath.split(path2.sep).join("/");
+}
+function uniqueStringsInOrder(values) {
+  const seen = /* @__PURE__ */ new Set();
+  const resolved = [];
+  for (const value of values) {
+    if (seen.has(value)) {
+      continue;
+    }
+    seen.add(value);
+    resolved.push(value);
+  }
+  return resolved;
+}
+function pathForTracingInclude(cwd, targetPath) {
+  const relative = path2.relative(cwd, targetPath);
+  if (!relative || path2.isAbsolute(relative)) {
+    return null;
+  }
+  const normalized = normalizeForGlob(relative);
+  return normalized.startsWith(".") ? normalized : `./${normalized}`;
+}
+function parseRuntimeConfiguredPackageNames(value) {
+  if (!Array.isArray(value)) {
+    return null;
+  }
+  const parsed = value.filter(
+    (entry) => typeof entry === "string" && entry.trim().length > 0
+  );
+  return uniqueStringsInOrder(parsed.map((entry) => entry.trim()));
+}
+var configuredPluginPackages;
+function setPluginPackages(packages) {
+  configuredPluginPackages = packages;
+}
+function readNextRuntimeConfiguredPackageNames() {
+  if (configuredPluginPackages !== void 0) {
+    return configuredPluginPackages;
+  }
+  const raw = process.env.JUNIOR_PLUGIN_PACKAGES;
+  if (raw === void 0) {
+    return null;
+  }
+  try {
+    return parseRuntimeConfiguredPackageNames(JSON.parse(raw)) ?? [];
+  } catch {
+    return [];
+  }
+}
+function findWorkspaceRoot(cwd) {
+  let current = path2.resolve(cwd);
+  while (true) {
+    const candidate = path2.join(current, "pnpm-workspace.yaml");
+    if (isFile(candidate)) {
+      return current;
+    }
+    const parent = path2.dirname(current);
+    if (parent === current) {
+      return null;
+    }
+    current = parent;
+  }
+}
+function listWorkspacePackageDirs(cwd) {
+  const workspaceRoot = findWorkspaceRoot(cwd);
+  if (!workspaceRoot) {
+    return [];
+  }
+  let packagePatterns = [];
+  try {
+    const raw = readFileSync(
+      path2.join(workspaceRoot, "pnpm-workspace.yaml"),
+      "utf8"
+    );
+    const parsed = parseYaml(raw);
+    packagePatterns = Array.isArray(parsed.packages) ? parsed.packages.filter(
+      (entry) => typeof entry === "string" && entry.trim().length > 0
+    ) : [];
+  } catch {
+    return [];
+  }
+  const discovered = [];
+  const seen = /* @__PURE__ */ new Set();
+  const addDir = (candidate) => {
+    const normalized = path2.resolve(candidate);
+    if (seen.has(normalized) || !isDirectory(normalized)) {
+      return;
+    }
+    seen.add(normalized);
+    discovered.push(normalized);
+  };
+  for (const pattern of packagePatterns) {
+    const trimmed = pattern.trim();
+    if (!trimmed) {
+      continue;
+    }
+    if (trimmed.endsWith("/*")) {
+      const baseDir = path2.join(workspaceRoot, trimmed.slice(0, -2));
+      if (!isDirectory(baseDir)) {
+        continue;
+      }
+      for (const entry of readdirSync2(baseDir)) {
+        addDir(path2.join(baseDir, entry));
+      }
+      continue;
+    }
+    addDir(path2.join(workspaceRoot, trimmed));
+  }
+  return discovered;
+}
+function readPluginPackageFlags(dir) {
+  const hasRootPluginManifest = isFile(path2.join(dir, "plugin.yaml"));
+  const hasPluginsDir = isDirectory(path2.join(dir, "plugins"));
+  const hasSkillsDir = isDirectory(path2.join(dir, "skills"));
+  if (!hasRootPluginManifest && !hasPluginsDir && !hasSkillsDir) {
+    return null;
+  }
+  return {
+    hasRootPluginManifest,
+    hasPluginsDir,
+    hasSkillsDir
+  };
+}
+function discoverWorkspacePluginPackageDirs(cwd, packageNames) {
+  if (packageNames !== null) {
+    return [];
+  }
+  return listWorkspacePackageDirs(cwd).filter(
+    (candidate) => readPluginPackageFlags(candidate) !== null
+  );
+}
+function readWorkspacePackageName(dir) {
+  try {
+    const raw = readFileSync(path2.join(dir, "package.json"), "utf8");
+    const name = JSON.parse(raw).name;
+    return typeof name === "string" && name.trim().length > 0 ? name : null;
+  } catch {
+    return null;
+  }
+}
+function resolveWorkspacePackageDirFromName(cwd, packageName) {
+  for (const candidate of listWorkspacePackageDirs(cwd)) {
+    if (readWorkspacePackageName(candidate) !== packageName) {
+      continue;
+    }
+    return candidate;
+  }
+  return null;
+}
+function resolvePackageDirFromName(packageName, candidateNodeModulesDirs) {
+  for (const nodeModulesDir of candidateNodeModulesDirs) {
+    const packageDir = path2.join(nodeModulesDir, ...packageName.split("/"));
+    if (isDirectory(packageDir)) {
+      return {
+        dir: path2.resolve(packageDir),
+        nodeModulesDir: path2.resolve(nodeModulesDir)
+      };
+    }
+  }
+  return null;
+}
+function discoverDeclaredPackages(cwd, packageNames, candidateNodeModulesDirs) {
+  const discovered = [];
+  const seenPackageNames = /* @__PURE__ */ new Set();
+  const seenPackageDirs = /* @__PURE__ */ new Set();
+  for (const packageName of packageNames) {
+    const resolved = resolvePackageDirFromName(
+      packageName,
+      candidateNodeModulesDirs
+    );
+    const workspaceDir = resolved ? null : resolveWorkspacePackageDirFromName(cwd, packageName);
+    if (!resolved && !workspaceDir) {
+      continue;
+    }
+    const packageDir = resolved?.dir ?? workspaceDir;
+    if (seenPackageNames.has(packageName) || seenPackageDirs.has(packageDir)) {
+      continue;
+    }
+    const pluginFlags = readPluginPackageFlags(packageDir);
+    if (!pluginFlags) {
+      continue;
+    }
+    seenPackageNames.add(packageName);
+    seenPackageDirs.add(packageDir);
+    discovered.push({
+      name: packageName,
+      dir: packageDir,
+      nodeModulesDir: resolved?.nodeModulesDir ?? null,
+      ...pluginFlags
+    });
+  }
+  return discovered;
+}
+function discoverInstalledJuniorContentPackages(cwd = process.cwd(), nodeModulesDirs, packageNames) {
+  const resolvedCwd = path2.resolve(cwd);
+  const candidateNodeModulesDirs = nodeModulesDirs ?? discoverNodeModulesDirs(resolvedCwd);
+  const configuredPackageNames = packageNames ?? readNextRuntimeConfiguredPackageNames();
+  const declaredPackages = discoverDeclaredPackages(
+    resolvedCwd,
+    configuredPackageNames ?? [],
+    candidateNodeModulesDirs
+  );
+  const useFallbackScan = configuredPackageNames === null;
+  const discovered = [...declaredPackages];
+  const seenPackageNames = /* @__PURE__ */ new Set();
+  const seenPackageDirs = /* @__PURE__ */ new Set();
+  for (const pkg of declaredPackages) {
+    seenPackageNames.add(pkg.name);
+    seenPackageDirs.add(pkg.dir);
+  }
+  if (!useFallbackScan) {
+    return discovered;
+  }
+  for (const nodeModulesDir of candidateNodeModulesDirs) {
+    for (const pkg of listTopLevelPackages(nodeModulesDir)) {
+      const resolvedDir = path2.resolve(pkg.dir);
+      if (seenPackageNames.has(pkg.name) || seenPackageDirs.has(resolvedDir)) {
+        continue;
+      }
+      seenPackageNames.add(pkg.name);
+      seenPackageDirs.add(resolvedDir);
+      const hasRootPluginManifest = isFile(
+        path2.join(resolvedDir, "plugin.yaml")
+      );
+      const hasPluginsDir = isDirectory(path2.join(resolvedDir, "plugins"));
+      const hasSkillsDir = isDirectory(path2.join(resolvedDir, "skills"));
+      if (!hasRootPluginManifest && !hasPluginsDir && !hasSkillsDir) {
+        continue;
+      }
+      discovered.push({
+        name: pkg.name,
+        dir: resolvedDir,
+        nodeModulesDir: path2.resolve(nodeModulesDir),
+        hasRootPluginManifest,
+        hasPluginsDir,
+        hasSkillsDir
+      });
+    }
+  }
+  return discovered;
+}
+function discoverInstalledPluginPackageContent(cwd = process.cwd(), options) {
+  const resolvedCwd = path2.resolve(cwd);
+  const configuredPackageNames = options?.packageNames ?? readNextRuntimeConfiguredPackageNames();
+  const discoveredPackages = discoverInstalledJuniorContentPackages(
+    resolvedCwd,
+    options?.nodeModulesDirs,
+    configuredPackageNames
+  );
+  const workspacePluginDirs = discoverWorkspacePluginPackageDirs(
+    resolvedCwd,
+    configuredPackageNames
+  );
+  const manifestRoots = [];
+  const skillRoots2 = [];
+  const tracingIncludes = [];
+  for (const pkg of discoveredPackages) {
+    const tracingBasePath = pkg.nodeModulesDir ? pathForTracingInclude(
+      resolvedCwd,
+      path2.join(pkg.nodeModulesDir, ...pkg.name.split("/"))
+    ) : pathForTracingInclude(resolvedCwd, pkg.dir);
+    if (pkg.hasRootPluginManifest) {
+      manifestRoots.push(pkg.dir);
+      if (tracingBasePath) {
+        tracingIncludes.push(`${tracingBasePath}/plugin.yaml`);
+      }
+    }
+    if (pkg.hasPluginsDir) {
+      manifestRoots.push(path2.join(pkg.dir, "plugins"));
+      if (tracingBasePath) {
+        tracingIncludes.push(`${tracingBasePath}/plugins/**/*`);
+      }
+    }
+    if (pkg.hasSkillsDir) {
+      skillRoots2.push(path2.join(pkg.dir, "skills"));
+      if (tracingBasePath) {
+        tracingIncludes.push(`${tracingBasePath}/skills/**/*`);
+      }
+    }
+  }
+  for (const pluginDir of workspacePluginDirs) {
+    const tracingBasePath = pathForTracingInclude(resolvedCwd, pluginDir);
+    if (isFile(path2.join(pluginDir, "plugin.yaml"))) {
+      manifestRoots.push(pluginDir);
+      if (tracingBasePath) {
+        tracingIncludes.push(`${tracingBasePath}/plugin.yaml`);
+      }
+    }
+    if (isDirectory(path2.join(pluginDir, "plugins"))) {
+      manifestRoots.push(path2.join(pluginDir, "plugins"));
+      if (tracingBasePath) {
+        tracingIncludes.push(`${tracingBasePath}/plugins/**/*`);
+      }
+    }
+    if (isDirectory(path2.join(pluginDir, "skills"))) {
+      skillRoots2.push(path2.join(pluginDir, "skills"));
+      if (tracingBasePath) {
+        tracingIncludes.push(`${tracingBasePath}/skills/**/*`);
+      }
+    }
+  }
+  return {
+    packageNames: uniqueStringsInOrder(
+      discoveredPackages.map((pkg) => pkg.name)
+    ),
+    manifestRoots: uniqueStringsInOrder(manifestRoots),
+    skillRoots: uniqueStringsInOrder(skillRoots2),
+    tracingIncludes: uniqueStringsInOrder(tracingIncludes)
+  };
+}
+
 // src/chat/plugins/manifest.ts
 import { z } from "zod";
-import { parse as parseYaml } from "yaml";
+import { parse as parseYaml2 } from "yaml";
 var PLUGIN_NAME_RE = /^[a-z][a-z0-9-]*$/;
 var SHORT_CAPABILITY_RE = /^[a-z0-9-]+(\.[a-z0-9-]+)*$/;
 var SHORT_CONFIG_KEY_RE = /^[a-z0-9]+(\.[a-z0-9-]+)*$/;
@@ -1065,8 +1622,8 @@ var manifestSourceSchema = z.object({
     error: "must be an object"
   }).optional()
 }).passthrough();
-function formatPath(path2) {
-  return path2.map((segment) => String(segment)).join(".");
+function formatPath(path4) {
+  return path4.map((segment) => String(segment)).join(".");
 }
 function issueMessage(error, prefix) {
   const issue = error.issues[0];
@@ -1281,7 +1838,7 @@ function normalizeMcp(data, name) {
 function parsePluginManifest(raw, dir) {
   let parsedYaml;
   try {
-    parsedYaml = parseYaml(raw);
+    parsedYaml = parseYaml2(raw);
   } catch (error) {
     throw new Error(
       `Invalid plugin manifest in ${dir}: ${error instanceof Error ? error.message : String(error)}`
@@ -1293,51 +1850,51 @@ function parsePluginManifest(raw, dir) {
   const sourceResult = manifestSourceSchema.safeParse(parsedYaml);
   if (!sourceResult.success) {
     const issue = sourceResult.error.issues[0];
-    const path2 = formatPath(issue?.path ?? []);
-    if (path2 === "name") {
+    const path4 = formatPath(issue?.path ?? []);
+    if (path4 === "name") {
       throw new Error(
         `Invalid plugin name in ${dir}: "${parsedYaml.name}"`
       );
     }
-    if (path2 === "description") {
+    if (path4 === "description") {
       throw new Error(`Invalid plugin description in ${dir}`);
     }
-    if (path2 === "capabilities") {
+    if (path4 === "capabilities") {
       throw new Error(
         `Plugin ${parsedYaml.name ?? "unknown"} capabilities must be an array when provided`
       );
     }
-    if (path2 === "config-keys") {
+    if (path4 === "config-keys") {
       throw new Error(
         `Plugin ${parsedYaml.name ?? "unknown"} config-keys must be an array when provided`
       );
     }
-    if (path2 === "credentials") {
+    if (path4 === "credentials") {
       throw new Error(
         `Plugin ${parsedYaml.name ?? "unknown"} credentials must be an object when provided`
       );
     }
-    if (path2 === "runtime-dependencies") {
+    if (path4 === "runtime-dependencies") {
       throw new Error(
         `Plugin ${parsedYaml.name ?? "unknown"} runtime-dependencies must be an array`
       );
     }
-    if (path2 === "runtime-postinstall") {
+    if (path4 === "runtime-postinstall") {
       throw new Error(
         `Plugin ${parsedYaml.name ?? "unknown"} runtime-postinstall must be an array`
       );
     }
-    if (path2 === "mcp") {
+    if (path4 === "mcp") {
       throw new Error(
         `Plugin ${parsedYaml.name ?? "unknown"} mcp must be an object`
       );
     }
-    if (path2 === "oauth") {
+    if (path4 === "oauth") {
       throw new Error(
         `Plugin ${parsedYaml.name ?? "unknown"} oauth must be an object`
       );
     }
-    if (path2 === "target") {
+    if (path4 === "target") {
       throw new Error(
         `Plugin ${parsedYaml.name ?? "unknown"} target must be an object`
       );
@@ -1433,8 +1990,8 @@ function parsePluginManifest(raw, dir) {
 }
 
 // src/chat/plugins/registry.ts
-import { readFileSync, readdirSync, statSync } from "fs";
-import path from "path";
+import { readFileSync as readFileSync2, readdirSync as readdirSync3, statSync as statSync2 } from "fs";
+import path3 from "path";
 
 // src/chat/plugins/auth/github-app-broker.ts
 import { createPrivateKey, createSign, randomUUID } from "crypto";
@@ -1515,8 +2072,8 @@ function createAppJwt(appId, privateKeyEnv) {
   const signature = signer.sign(getPrivateKey(privateKeyEnv)).toString("base64").replace(/=/g, "").replace(/\+/g, "-").replace(/\//g, "_");
   return `${signingInput}.${signature}`;
 }
-async function githubRequest(apiBase, path2, params) {
-  const response = await fetch(`${apiBase}${path2}`, {
+async function githubRequest(apiBase, path4, params) {
+  const response = await fetch(`${apiBase}${path4}`, {
     method: params.method ?? "GET",
     headers: {
       Accept: "application/vnd.github+json",
@@ -1966,7 +2523,7 @@ function registerPluginManifest(state, raw, pluginDir) {
   const definition = {
     manifest,
     dir: pluginDir,
-    skillsDir: path.join(pluginDir, "skills")
+    skillsDir: path3.join(pluginDir, "skills")
   };
   state.pluginDefinitions.push(definition);
   state.pluginsByName.set(manifest.name, definition);
@@ -1981,7 +2538,7 @@ function normalizePluginRoots(roots) {
   const resolved = [];
   const seen = /* @__PURE__ */ new Set();
   for (const root of roots) {
-    const normalized = path.resolve(root);
+    const normalized = path3.resolve(root);
     if (seen.has(normalized)) {
       continue;
     }
@@ -2008,7 +2565,7 @@ function getExtraPluginRoots() {
     }
   }
   return normalizePluginRoots(
-    raw.split(path.delimiter).map((entry) => entry.trim()).filter((entry) => entry.length > 0)
+    raw.split(path3.delimiter).map((entry) => entry.trim()).filter((entry) => entry.length > 0)
   );
 }
 function getPluginCatalogSource() {
@@ -2042,7 +2599,7 @@ function buildLoadedPluginState(source) {
     let entries;
     let rootStat;
     try {
-      rootStat = statSync(pluginsRoot);
+      rootStat = statSync2(pluginsRoot);
     } catch (error) {
       logWarn(
         "plugin_root_read_failed",
@@ -2056,21 +2613,21 @@ function buildLoadedPluginState(source) {
       continue;
     }
     if (rootStat.isDirectory()) {
-      const manifestPath = path.join(pluginsRoot, "plugin.yaml");
+      const manifestPath = path3.join(pluginsRoot, "plugin.yaml");
       let hasRootManifest = false;
       try {
-        hasRootManifest = statSync(manifestPath).isFile();
+        hasRootManifest = statSync2(manifestPath).isFile();
       } catch {
         hasRootManifest = false;
       }
       if (hasRootManifest) {
-        const rawRootManifest = readFileSync(manifestPath, "utf8");
+        const rawRootManifest = readFileSync2(manifestPath, "utf8");
         registerPluginManifest(state, rawRootManifest, pluginsRoot);
         continue;
       }
     }
     try {
-      entries = readdirSync(pluginsRoot);
+      entries = readdirSync3(pluginsRoot);
     } catch (error) {
       logWarn(
         "plugin_root_read_failed",
@@ -2084,17 +2641,17 @@ function buildLoadedPluginState(source) {
       continue;
     }
     for (const entry of entries.sort()) {
-      const pluginDir = path.join(pluginsRoot, entry);
+      const pluginDir = path3.join(pluginsRoot, entry);
       try {
-        const stat = statSync(pluginDir);
+        const stat = statSync2(pluginDir);
         if (!stat.isDirectory()) continue;
       } catch {
         continue;
       }
-      const manifestPath = path.join(pluginDir, "plugin.yaml");
+      const manifestPath = path3.join(pluginDir, "plugin.yaml");
       let raw;
       try {
-        raw = readFileSync(manifestPath, "utf8");
+        raw = readFileSync2(manifestPath, "utf8");
       } catch {
         continue;
       }
@@ -2137,6 +2694,9 @@ function ensurePluginsLoaded() {
   logLoadedPlugins(state);
   return state;
 }
+function getPluginCatalogSignature() {
+  return ensurePluginsLoaded().signature;
+}
 function getPluginCapabilityProviders() {
   const state = ensurePluginsLoaded();
   return state.pluginDefinitions.map((plugin) => ({
@@ -2224,10 +2784,10 @@ function getPluginSkillRoots() {
 }
 function getPluginForSkillPath(skillPath) {
   const state = ensurePluginsLoaded();
-  const resolvedSkillPath = path.resolve(skillPath);
+  const resolvedSkillPath = path3.resolve(skillPath);
   return state.pluginDefinitions.find((plugin) => {
-    const resolvedSkillsDir = path.resolve(plugin.skillsDir);
-    return resolvedSkillPath === resolvedSkillsDir || resolvedSkillPath.startsWith(`${resolvedSkillsDir}${path.sep}`);
+    const resolvedSkillsDir = path3.resolve(plugin.skillsDir);
+    return resolvedSkillPath === resolvedSkillsDir || resolvedSkillPath.startsWith(`${resolvedSkillsDir}${path3.sep}`);
   });
 }
 function getPluginDefinition(provider) {
@@ -2262,6 +2822,9 @@ function createPluginBroker(provider, deps) {
 }
 
 export {
+  toOptionalString,
+  toOptionalNumber,
+  isRecord,
   logInfo,
   logWarn,
   logError,
@@ -2272,15 +2835,21 @@ export {
   withSpan,
   setSpanAttributes,
   setSpanStatus,
-  toOptionalString,
   resolveErrorReference,
   serializeGenAiAttribute,
   extractGenAiUsageAttributes,
+  homeDir,
+  skillRoots,
+  soulPathCandidates,
+  aboutPathCandidates,
+  setPluginPackages,
+  discoverInstalledPluginPackageContent,
   resolveAuthTokenPlaceholder,
   parsePluginManifest,
   CredentialUnavailableError,
   buildOAuthTokenRequest,
   parseOAuthTokenResponse,
+  getPluginCatalogSignature,
   getPluginCapabilityProviders,
   getPluginProviders,
   getPluginMcpProviders,