@dexto/core 1.1.4 → 1.1.6

package/dist/{chunk-MVKLS3LM.js → utils/fs-walk.cjs}

@@ -1,14 +1,13 @@
+"use strict";
 var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __esm = (fn, res) => function __init() {
-  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
-};
-var __commonJS = (cb, mod) => function __require() {
-  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
 };
 var __copyProps = (to, from, except, desc) => {
   if (from && typeof from === "object" || typeof from === "function") {
@@ -26,18 +25,28 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
   isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
   mod
 ));
-
-// ../../node_modules/.pnpm/tsup@8.5.0_jiti@2.5.1_postcss@8.5.6_tsx@4.20.5_typescript@5.9.2_yaml@2.8.1/node_modules/tsup/assets/esm_shims.js
-import path from "path";
-import { fileURLToPath } from "url";
-var init_esm_shims = __esm({
-  "../../node_modules/.pnpm/tsup@8.5.0_jiti@2.5.1_postcss@8.5.6_tsx@4.20.5_typescript@5.9.2_yaml@2.8.1/node_modules/tsup/assets/esm_shims.js"() {
-    "use strict";
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var fs_walk_exports = {};
+__export(fs_walk_exports, {
+  walkUpDirectories: () => walkUpDirectories
+});
+module.exports = __toCommonJS(fs_walk_exports);
+var path = __toESM(require("path"), 1);
+function walkUpDirectories(startPath, predicate) {
+  let currentPath = path.resolve(startPath);
+  const rootPath = path.parse(currentPath).root;
+  while (true) {
+    if (predicate(currentPath)) {
+      return currentPath;
+    }
+    if (currentPath === rootPath) break;
+    const parent = path.dirname(currentPath);
+    if (parent === currentPath) break;
+    currentPath = parent;
   }
+  return null;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  walkUpDirectories
 });
-
-export {
-  __commonJS,
-  __toESM,
-  init_esm_shims
-};

package/dist/utils/fs-walk.d.cts

@@ -0,0 +1,9 @@
+/**
+ * Generic directory walker that searches up the directory tree
+ * @param startPath Starting directory path
+ * @param predicate Function that returns true when the desired condition is found
+ * @returns The directory path where the condition was met, or null if not found
+ */
+declare function walkUpDirectories(startPath: string, predicate: (dirPath: string) => boolean): string | null;
+
+export { walkUpDirectories };

package/dist/utils/fs-walk.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Generic directory walker that searches up the directory tree
+ * @param startPath Starting directory path
+ * @param predicate Function that returns true when the desired condition is found
+ * @returns The directory path where the condition was met, or null if not found
+ */
+declare function walkUpDirectories(startPath: string, predicate: (dirPath: string) => boolean): string | null;
+
+export { walkUpDirectories };

package/dist/utils/fs-walk.js

@@ -0,0 +1,18 @@
+import * as path from "path";
+function walkUpDirectories(startPath, predicate) {
+  let currentPath = path.resolve(startPath);
+  const rootPath = path.parse(currentPath).root;
+  while (true) {
+    if (predicate(currentPath)) {
+      return currentPath;
+    }
+    if (currentPath === rootPath) break;
+    const parent = path.dirname(currentPath);
+    if (parent === currentPath) break;
+    currentPath = parent;
+  }
+  return null;
+}
+export {
+  walkUpDirectories
+};

package/dist/utils/index.cjs

@@ -0,0 +1,44 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var utils_exports = {};
+module.exports = __toCommonJS(utils_exports);
+__reExport(utils_exports, require("./path.js"), module.exports);
+__reExport(utils_exports, require("./service-initializer.js"), module.exports);
+__reExport(utils_exports, require("./api-key-resolver.js"), module.exports);
+__reExport(utils_exports, require("./zod-schema-converter.js"), module.exports);
+__reExport(utils_exports, require("./result.js"), module.exports);
+__reExport(utils_exports, require("./error-conversion.js"), module.exports);
+__reExport(utils_exports, require("./port-utils.js"), module.exports);
+__reExport(utils_exports, require("./env.js"), module.exports);
+__reExport(utils_exports, require("./execution-context.js"), module.exports);
+__reExport(utils_exports, require("./fs-walk.js"), module.exports);
+__reExport(utils_exports, require("./redactor.js"), module.exports);
+__reExport(utils_exports, require("./api-key-store.js"), module.exports);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ...require("./path.js"),
+  ...require("./service-initializer.js"),
+  ...require("./api-key-resolver.js"),
+  ...require("./zod-schema-converter.js"),
+  ...require("./result.js"),
+  ...require("./error-conversion.js"),
+  ...require("./port-utils.js"),
+  ...require("./env.js"),
+  ...require("./execution-context.js"),
+  ...require("./fs-walk.js"),
+  ...require("./redactor.js"),
+  ...require("./api-key-store.js")
+});

package/dist/utils/index.d.cts

@@ -0,0 +1,63 @@
+export { copyDirectory, ensureDextoGlobalDirectory, findPackageRoot, getDextoEnvPath, getDextoGlobalPath, getDextoPath, isPath, resolveBundledScript } from './path.cjs';
+export { AgentServices, createAgentServices } from './service-initializer.cjs';
+export { PROVIDER_API_KEY_MAP, getPrimaryApiKeyEnvVar, resolveApiKeyForProvider } from './api-key-resolver.cjs';
+export { getZodTypeFromProperty, jsonSchemaToZodShape } from './zod-schema-converter.cjs';
+export { EnvExpandedString, NonEmptyEnvExpandedString, NonEmptyTrimmed, OptionalURL, RequiredEnvURL, Result, fail, hasErrors, ok, splitIssues, zodToIssues } from './result.cjs';
+export { toError } from './error-conversion.cjs';
+export { getPort } from './port-utils.cjs';
+export { applyLayeredEnvironmentLoading, loadEnvironmentVariables, updateEnvFile } from './env.cjs';
+export { ExecutionContext, findDextoProjectRoot, findDextoSourceRoot, getExecutionContext } from './execution-context.cjs';
+export { walkUpDirectories } from './fs-walk.cjs';
+export { redactSensitiveData } from './redactor.cjs';
+export { getProviderKeyStatus, listProviderKeyStatus, saveProviderApiKey } from './api-key-store.cjs';
+import '../mcp/manager.cjs';
+import '../mcp/schemas.cjs';
+import 'zod';
+import '../mcp/types.cjs';
+import '@modelcontextprotocol/sdk/client/index.js';
+import '../tools/types.cjs';
+import 'json-schema';
+import '@modelcontextprotocol/sdk/types.js';
+import '../tools/tool-manager.cjs';
+import '../tools/internal-tools/registry.cjs';
+import '../search/search-service.cjs';
+import '../storage/backend/database-backend.cjs';
+import '../search/types.cjs';
+import '../context/types.cjs';
+import '../llm/types.cjs';
+import '../tools/schemas.cjs';
+import '../tools/confirmation/types.cjs';
+import '../tools/confirmation/allowed-tools-provider/types.cjs';
+import '../systemPrompt/manager.cjs';
+import '../systemPrompt/schemas.cjs';
+import '../systemPrompt/types.cjs';
+import '../agent/state-manager.cjs';
+import '../agent/schemas.cjs';
+import '../llm/schemas.cjs';
+import '../events/index.cjs';
+import 'events';
+import '../storage/backend/types.cjs';
+import '../storage/backend/cache-backend.cjs';
+import '../storage/schemas.cjs';
+import '../session/session-manager.cjs';
+import '../session/chat-session.cjs';
+import '../context/manager.cjs';
+import '../llm/formatters/types.cjs';
+import '../llm/tokenizer/types.cjs';
+import '../context/compression/types.cjs';
+import '../session/history/types.cjs';
+import '../llm/services/types.cjs';
+import 'ai';
+import '../storage/storage-manager.cjs';
+import '../errors/types.cjs';
+import '../agent/error-codes.cjs';
+import '../config/error-codes.cjs';
+import '../context/error-codes.cjs';
+import '../llm/error-codes.cjs';
+import '../mcp/error-codes.cjs';
+import '../session/error-codes.cjs';
+import '../storage/error-codes.cjs';
+import '../systemPrompt/error-codes.cjs';
+import '../tools/error-codes.cjs';
+import '../preferences/error-codes.cjs';
+import '../agent/registry/error-codes.cjs';

package/dist/utils/index.d.ts

@@ -0,0 +1,63 @@
+export { copyDirectory, ensureDextoGlobalDirectory, findPackageRoot, getDextoEnvPath, getDextoGlobalPath, getDextoPath, isPath, resolveBundledScript } from './path.js';
+export { AgentServices, createAgentServices } from './service-initializer.js';
+export { PROVIDER_API_KEY_MAP, getPrimaryApiKeyEnvVar, resolveApiKeyForProvider } from './api-key-resolver.js';
+export { getZodTypeFromProperty, jsonSchemaToZodShape } from './zod-schema-converter.js';
+export { EnvExpandedString, NonEmptyEnvExpandedString, NonEmptyTrimmed, OptionalURL, RequiredEnvURL, Result, fail, hasErrors, ok, splitIssues, zodToIssues } from './result.js';
+export { toError } from './error-conversion.js';
+export { getPort } from './port-utils.js';
+export { applyLayeredEnvironmentLoading, loadEnvironmentVariables, updateEnvFile } from './env.js';
+export { ExecutionContext, findDextoProjectRoot, findDextoSourceRoot, getExecutionContext } from './execution-context.js';
+export { walkUpDirectories } from './fs-walk.js';
+export { redactSensitiveData } from './redactor.js';
+export { getProviderKeyStatus, listProviderKeyStatus, saveProviderApiKey } from './api-key-store.js';
+import '../mcp/manager.js';
+import '../mcp/schemas.js';
+import 'zod';
+import '../mcp/types.js';
+import '@modelcontextprotocol/sdk/client/index.js';
+import '../tools/types.js';
+import 'json-schema';
+import '@modelcontextprotocol/sdk/types.js';
+import '../tools/tool-manager.js';
+import '../tools/internal-tools/registry.js';
+import '../search/search-service.js';
+import '../storage/backend/database-backend.js';
+import '../search/types.js';
+import '../context/types.js';
+import '../llm/types.js';
+import '../tools/schemas.js';
+import '../tools/confirmation/types.js';
+import '../tools/confirmation/allowed-tools-provider/types.js';
+import '../systemPrompt/manager.js';
+import '../systemPrompt/schemas.js';
+import '../systemPrompt/types.js';
+import '../agent/state-manager.js';
+import '../agent/schemas.js';
+import '../llm/schemas.js';
+import '../events/index.js';
+import 'events';
+import '../storage/backend/types.js';
+import '../storage/backend/cache-backend.js';
+import '../storage/schemas.js';
+import '../session/session-manager.js';
+import '../session/chat-session.js';
+import '../context/manager.js';
+import '../llm/formatters/types.js';
+import '../llm/tokenizer/types.js';
+import '../context/compression/types.js';
+import '../session/history/types.js';
+import '../llm/services/types.js';
+import 'ai';
+import '../storage/storage-manager.js';
+import '../errors/types.js';
+import '../agent/error-codes.js';
+import '../config/error-codes.js';
+import '../context/error-codes.js';
+import '../llm/error-codes.js';
+import '../mcp/error-codes.js';
+import '../session/error-codes.js';
+import '../storage/error-codes.js';
+import '../systemPrompt/error-codes.js';
+import '../tools/error-codes.js';
+import '../preferences/error-codes.js';
+import '../agent/registry/error-codes.js';

package/dist/utils/index.js

@@ -0,0 +1,12 @@
+export * from "./path.js";
+export * from "./service-initializer.js";
+export * from "./api-key-resolver.js";
+export * from "./zod-schema-converter.js";
+export * from "./result.js";
+export * from "./error-conversion.js";
+export * from "./port-utils.js";
+export * from "./env.js";
+export * from "./execution-context.js";
+export * from "./fs-walk.js";
+export * from "./redactor.js";
+export * from "./api-key-store.js";

package/dist/utils/path.cjs

@@ -0,0 +1,197 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var path_exports = {};
+__export(path_exports, {
+  copyDirectory: () => copyDirectory,
+  ensureDextoGlobalDirectory: () => ensureDextoGlobalDirectory,
+  findPackageRoot: () => findPackageRoot,
+  getDextoEnvPath: () => getDextoEnvPath,
+  getDextoGlobalPath: () => getDextoGlobalPath,
+  getDextoPath: () => getDextoPath,
+  isPath: () => isPath,
+  resolveBundledScript: () => resolveBundledScript
+});
+module.exports = __toCommonJS(path_exports);
+var path = __toESM(require("path"), 1);
+var import_fs = require("fs");
+var import_fs2 = require("fs");
+var import_os = require("os");
+var import_module = require("module");
+var import_url = require("url");
+var import_fs_walk = require("./fs-walk.js");
+var import_execution_context = require("./execution-context.js");
+var import_logger = require("../logger/index.js");
+const import_meta = {};
+function getDextoPath(type, filename, startPath) {
+  const context = (0, import_execution_context.getExecutionContext)(startPath);
+  let basePath;
+  switch (context) {
+    case "dexto-source": {
+      const sourceRoot = (0, import_execution_context.findDextoSourceRoot)(startPath);
+      if (!sourceRoot) {
+        throw new Error("Not in dexto source context");
+      }
+      basePath = path.join(sourceRoot, ".dexto", type);
+      break;
+    }
+    case "dexto-project": {
+      const projectRoot = (0, import_execution_context.findDextoProjectRoot)(startPath);
+      if (!projectRoot) {
+        throw new Error("Not in dexto project context");
+      }
+      basePath = path.join(projectRoot, ".dexto", type);
+      break;
+    }
+    case "global-cli": {
+      basePath = path.join((0, import_os.homedir)(), ".dexto", type);
+      break;
+    }
+    default: {
+      throw new Error(`Unknown execution context: ${context}`);
+    }
+  }
+  return filename ? path.join(basePath, filename) : basePath;
+}
+function getDextoGlobalPath(type, filename) {
+  const basePath = path.join((0, import_os.homedir)(), ".dexto", type);
+  return filename ? path.join(basePath, filename) : basePath;
+}
+async function copyDirectory(src, dest) {
+  await import_fs2.promises.mkdir(dest, { recursive: true });
+  const entries = await import_fs2.promises.readdir(src, { withFileTypes: true });
+  for (const entry of entries) {
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+    if (entry.isDirectory()) {
+      await copyDirectory(srcPath, destPath);
+    } else {
+      await import_fs2.promises.copyFile(srcPath, destPath);
+    }
+  }
+}
+function isPath(str) {
+  if (path.isAbsolute(str)) return true;
+  if (/[\\/]/.test(str)) return true;
+  if (/\.(ya?ml|json)$/i.test(str)) return true;
+  return false;
+}
+function findPackageRoot(startPath = process.cwd()) {
+  return (0, import_fs_walk.walkUpDirectories)(startPath, (dirPath) => {
+    const pkgPath = path.join(dirPath, "package.json");
+    return (0, import_fs.existsSync)(pkgPath);
+  });
+}
+function resolveBundledScript(scriptPath) {
+  const candidates = scriptPath.startsWith("dist/") ? [scriptPath, scriptPath.replace(/^dist\//, "")] : [`dist/${scriptPath}`, scriptPath];
+  const triedAbs = [];
+  const tryRoots = (roots) => {
+    for (const root of roots) {
+      if (!root) continue;
+      for (const rel of candidates) {
+        const abs = path.resolve(root, rel);
+        if ((0, import_fs.existsSync)(abs)) return abs;
+        triedAbs.push(abs);
+      }
+    }
+    return null;
+  };
+  const envRoot = process?.env?.DEXTO_PACKAGE_ROOT;
+  const fromEnv = tryRoots([envRoot]);
+  if (fromEnv) return fromEnv;
+  try {
+    const require2 = (0, import_module.createRequire)(import_meta.url);
+    const pkgJson = require2.resolve("dexto/package.json");
+    const pkgRoot = path.dirname(pkgJson);
+    const fromPkg = tryRoots([pkgRoot]);
+    if (fromPkg) return fromPkg;
+  } catch {
+  }
+  try {
+    const thisModuleDir = path.dirname((0, import_url.fileURLToPath)(import_meta.url));
+    const sourceRoot = (0, import_execution_context.findDextoSourceRoot)(thisModuleDir);
+    const fromSource = tryRoots([sourceRoot ?? void 0]);
+    if (fromSource) return fromSource;
+  } catch {
+  }
+  const repoRoot = findPackageRoot();
+  const fromCwd = tryRoots([repoRoot ?? void 0]);
+  if (fromCwd) return fromCwd;
+  throw new Error(
+    `Bundled script not found: ${scriptPath} (tried absolute: ${triedAbs.join(", ")})`
+  );
+}
+async function ensureDextoGlobalDirectory() {
+  const dextoDir = path.join((0, import_os.homedir)(), ".dexto");
+  try {
+    await import_fs2.promises.mkdir(dextoDir, { recursive: true });
+  } catch (error) {
+    if (error.code !== "EEXIST") {
+      throw error;
+    }
+  }
+}
+function getDextoEnvPath(startPath = process.cwd()) {
+  const context = (0, import_execution_context.getExecutionContext)(startPath);
+  let envPath = "";
+  switch (context) {
+    case "dexto-source": {
+      const sourceRoot = (0, import_execution_context.findDextoSourceRoot)(startPath);
+      if (!sourceRoot) {
+        throw new Error("Not in dexto source context");
+      }
+      envPath = path.join(sourceRoot, ".env");
+      break;
+    }
+    case "dexto-project": {
+      const projectRoot = (0, import_execution_context.findDextoProjectRoot)(startPath);
+      if (!projectRoot) {
+        throw new Error("Not in dexto project context");
+      }
+      envPath = path.join(projectRoot, ".env");
+      break;
+    }
+    case "global-cli": {
+      envPath = path.join((0, import_os.homedir)(), ".dexto", ".env");
+      break;
+    }
+  }
+  import_logger.logger.debug(`Dexto env path: ${envPath}, context: ${context}`);
+  return envPath;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  copyDirectory,
+  ensureDextoGlobalDirectory,
+  findPackageRoot,
+  getDextoEnvPath,
+  getDextoGlobalPath,
+  getDextoPath,
+  isPath,
+  resolveBundledScript
+});

package/dist/utils/path.d.cts

@@ -0,0 +1,54 @@
+/**
+ * Standard path resolver for logs/db/config/anything in dexto projects
+ * @param type Path type (logs, database, config, etc.)
+ * @param filename Optional filename to append
+ * @param startPath Starting directory for project detection
+ * @returns Absolute path to the requested location
+ */
+declare function getDextoPath(type: string, filename?: string, startPath?: string): string;
+/**
+ * Global path resolver that ALWAYS returns paths in the user's home directory
+ * Used for agent registry and other global-only resources that should not be project-relative
+ * @param type Path type (agents, cache, etc.)
+ * @param filename Optional filename to append
+ * @returns Absolute path to the global location (~/.dexto/...)
+ */
+declare function getDextoGlobalPath(type: string, filename?: string): string;
+/**
+ * Copy entire directory recursively
+ * @param src Source directory path
+ * @param dest Destination directory path
+ */
+declare function copyDirectory(src: string, dest: string): Promise<void>;
+/**
+ * Check if string looks like a file path vs registry name
+ * @param str String to check
+ * @returns True if looks like a path, false if looks like a registry name
+ */
+declare function isPath(str: string): boolean;
+/**
+ * Find package root (for other utilities)
+ * @param startPath Starting directory path
+ * @returns Directory containing package.json or null
+ */
+declare function findPackageRoot(startPath?: string): string | null;
+/**
+ * Resolve bundled script paths for MCP servers
+ * @param scriptPath Relative script path
+ * @returns Absolute path to bundled script
+ */
+declare function resolveBundledScript(scriptPath: string): string;
+/**
+ * Ensure ~/.dexto directory exists for global storage
+ */
+declare function ensureDextoGlobalDirectory(): Promise<void>;
+/**
+ * Get the appropriate .env file path for saving API keys.
+ * Uses the same project detection logic as other dexto paths.
+ *
+ * @param startPath Starting directory for project detection
+ * @returns Absolute path to .env file for saving
+ */
+declare function getDextoEnvPath(startPath?: string): string;
+
+export { copyDirectory, ensureDextoGlobalDirectory, findPackageRoot, getDextoEnvPath, getDextoGlobalPath, getDextoPath, isPath, resolveBundledScript };

package/dist/utils/path.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Standard path resolver for logs/db/config/anything in dexto projects
+ * @param type Path type (logs, database, config, etc.)
+ * @param filename Optional filename to append
+ * @param startPath Starting directory for project detection
+ * @returns Absolute path to the requested location
+ */
+declare function getDextoPath(type: string, filename?: string, startPath?: string): string;
+/**
+ * Global path resolver that ALWAYS returns paths in the user's home directory
+ * Used for agent registry and other global-only resources that should not be project-relative
+ * @param type Path type (agents, cache, etc.)
+ * @param filename Optional filename to append
+ * @returns Absolute path to the global location (~/.dexto/...)
+ */
+declare function getDextoGlobalPath(type: string, filename?: string): string;
+/**
+ * Copy entire directory recursively
+ * @param src Source directory path
+ * @param dest Destination directory path
+ */
+declare function copyDirectory(src: string, dest: string): Promise<void>;
+/**
+ * Check if string looks like a file path vs registry name
+ * @param str String to check
+ * @returns True if looks like a path, false if looks like a registry name
+ */
+declare function isPath(str: string): boolean;
+/**
+ * Find package root (for other utilities)
+ * @param startPath Starting directory path
+ * @returns Directory containing package.json or null
+ */
+declare function findPackageRoot(startPath?: string): string | null;
+/**
+ * Resolve bundled script paths for MCP servers
+ * @param scriptPath Relative script path
+ * @returns Absolute path to bundled script
+ */
+declare function resolveBundledScript(scriptPath: string): string;
+/**
+ * Ensure ~/.dexto directory exists for global storage
+ */
+declare function ensureDextoGlobalDirectory(): Promise<void>;
+/**
+ * Get the appropriate .env file path for saving API keys.
+ * Uses the same project detection logic as other dexto paths.
+ *
+ * @param startPath Starting directory for project detection
+ * @returns Absolute path to .env file for saving
+ */
+declare function getDextoEnvPath(startPath?: string): string;
+
+export { copyDirectory, ensureDextoGlobalDirectory, findPackageRoot, getDextoEnvPath, getDextoGlobalPath, getDextoPath, isPath, resolveBundledScript };