/**
 * Container lookup and URL computation.
 *
 * Containers are tagged with `devbox.branch=<branch>` and
 * `devbox.repo=<repoName>` labels at creation time. These functions query
 * by label — the source of truth, not CLI text parsing.
 *
 * OrbStack exposes container ports at `<name>.orb.local:<port>`. The bash
 * version only uses .orb.local (no real IP fallback despite a comment about
 * it); we match that. A non-OrbStack fallback is a future improvement.
 */
import type { ShellRunner } from '../../lib/shell.js';
/**
 * Format the id-label used to tag containers for a branch.
 */
export declare function idLabel(branch: string): string;
/**
 * Find the running container id for a branch.
 * Returns empty string if none found.
 */
export declare function containerFor(runner: ShellRunner, branch: string): Promise<string>;
/**
 * Find any container (running or stopped) for a branch.
 * Returns empty string if none found.
 */
export declare function containerForAll(runner: ShellRunner, branch: string): Promise<string>;
/**
 * Compute the noVNC URL for a container.
 * Uses the container name from `docker inspect`, formatted as
 * `http://<name>.orb.local:6080/vnc.html`.
 */
export declare function novncUrlFor(runner: ShellRunner, cid: string): Promise<string>;
/**
 * Get the container name for a cid.
 */
export declare function containerName(runner: ShellRunner, cid: string): Promise<string>;