/**
* Get the directory of the current module
*
* @param meta - Pass `import.meta` from your module
* @returns Absolute path to the directory containing the module
*
* @example
* ```typescript
* import { getModuleDir } from "@agentxjs/common/path";
*
* const __dirname = getModuleDir(import.meta);
* ```
*/
declare function getModuleDir(meta: ImportMeta): string;
/**
* Get the root directory of the current package (where package.json is)
*
* @param meta - Pass `import.meta` from your module
* @returns Absolute path to the package root
*
* @example
* ```typescript
* import { getPackageRoot } from "@agentxjs/common/path";
*
* const pkgRoot = getPackageRoot(import.meta);
* // e.g., /Users/sean/AgentX/packages/queue
* ```
*/
declare function getPackageRoot(meta: ImportMeta): string;
/**
* Get the monorepo root directory (where pnpm-workspace.yaml or root package.json is)
*
* @param meta - Pass `import.meta` from your module
* @returns Absolute path to the monorepo root
*
* @example
* ```typescript
* import { getMonorepoRoot } from "@agentxjs/common/path";
*
* const root = getMonorepoRoot(import.meta);
* // e.g., /Users/sean/AgentX
* ```
*/
declare function getMonorepoRoot(meta: ImportMeta): string;
/**
* Resolve a path relative to the monorepo root
*
* @param meta - Pass `import.meta` from your module
* @param paths - Path segments to resolve
* @returns Absolute resolved path
*
* @example
* ```typescript
* import { resolveFromRoot } from "@agentxjs/common/path";
*
* const dataDir = resolveFromRoot(import.meta, "data");
* // e.g., /Users/sean/AgentX/data
*
* const config = resolveFromRoot(import.meta, "packages", "config", "settings.json");
* // e.g., /Users/sean/AgentX/packages/config/settings.json
* ```
*/
declare function resolveFromRoot(meta: ImportMeta, ...paths: string[]): string;
/**
* Resolve a path relative to the current package root
*
* @param meta - Pass `import.meta` from your module
* @param paths - Path segments to resolve
* @returns Absolute resolved path
*
* @example
* ```typescript
* import { resolveFromPackage } from "@agentxjs/common/path";
*
* const testsDir = resolveFromPackage(import.meta, "tests");
* // e.g., /Users/sean/AgentX/packages/queue/tests
*
* const fixtures = resolveFromPackage(import.meta, "tests", "fixtures", "data.json");
* // e.g., /Users/sean/AgentX/packages/queue/tests/fixtures/data.json
* ```
*/
declare function resolveFromPackage(meta: ImportMeta, ...paths: string[]): string;
export { resolveFromRoot, resolveFromPackage, getPackageRoot, getMonorepoRoot, getModuleDir };
