export interface ResolveRefDeps { readonly home: string; readonly cwd: string; } interface ResolvedAgentRef { readonly dir: string; /** Only a named alias can override the terminal's working directory. */ readonly cwd?: string; readonly warnings: readonly string[]; } /** * Resolve a `cradle run` ref into a folder path `loadAgentFolder` can load. * Path-shaped refs pass through untouched (`loadAgentFolder`'s own `resolve()` * handles them, and they never consult `deps.cwd`); a bare name resolves * against the global alias table into an ABSOLUTE, normalized path, falling * back to the cwd-relative folder when no alias matches (so `cradle run * hello` from `examples/` keeps working) — and throwing only when neither * resolves. Every bare-name branch resolves against the injected `deps.cwd`, * never `process.cwd()`, so the dep is the single source of truth for what the * lookup tested. */ export declare function resolveAgentRef(ref: string, deps: ResolveRefDeps): Promise; export {};