/**
 * bundle-source.ts — Phase C C2 (olam-world-bundle-freshness).
 *
 * Single resolver for the agent-stream bind-mount source path. Two modes:
 *
 *   source-mode  (OLAM_DEV=1 + packages/ sibling in repo root):
 *     → <repo>/packages/intelligence/dist/agent-stream
 *
 *   install-mode (OLAM_FORCE_INSTALL_MODE=1, or OLAM_DEV is absent/not '1',
 *                 or the packages/ sibling is absent):
 *     → <cli-pkg-root>/dist/agent-stream
 *     (the path populated by bundle-agent-stream.mjs at publish time)
 *
 * Throws `BundleSourceNotFoundError` with a remediation message when neither
 * path exists on disk.
 *
 * Design decisions:
 *   - Reuses `installRoot()` + `isDevMode()` from install-root.ts (the seam
 *     established by Phase B / fresh-install-self-bootstrap). No new heuristics.
 *   - `OLAM_FORCE_INSTALL_MODE=1` forces install-mode regardless of cwd; used
 *     by the C4 integration test to exercise install-mode paths without a real
 *     global install.
 *   - Does NOT import from @olam/adapters (dep cycle — adapters cannot import
 *     from @pleri/olam-cli). The container.ts refactor in Phase C receives the
 *     resolved path as an argument instead of computing it internally.
 */
/** Resolved bundle source description. */
export interface BundleSource {
    /** 'source' = operator repo dist; 'install' = CLI package dist. */
    readonly mode: 'source' | 'install';
    /** Absolute path to the agent-stream dist directory. */
    readonly path: string;
}
/**
 * Thrown when neither the source-mode nor the install-mode bundle directory
 * exists on disk. Carries a remediation message operators can act on.
 */
export declare class BundleSourceNotFoundError extends Error {
    constructor(sourceModePath: string, installModePath: string);
}
/**
 * Resolve the agent-stream bind-mount source for the current runtime context.
 *
 * @param env - Process environment. Defaults to `process.env`. Injectable for
 *   tests — pass `{ OLAM_FORCE_INSTALL_MODE: '1' }` to exercise install-mode.
 * @param installRootDir - Override the CLI package root. Defaults to
 *   `installRoot()`. Injectable for tests.
 * @returns `BundleSource` with the resolved mode and absolute directory path.
 * @throws `BundleSourceNotFoundError` when neither path exists.
 */
export declare function resolveBundleSource(env?: NodeJS.ProcessEnv, installRootDir?: string): BundleSource;
//# sourceMappingURL=bundle-source.d.ts.map