export declare const RUNS_USAGE = "usage: agentworkforce runs export <runId> [flags]\n\nExport the gateway envelope cloud actually delivered to a run as a\nreplayable `agentworkforce invoke --fixture` fixture (workforce#189 /\ncloud#1841). The fixture IS cloud's normalized output, so local replay\ncannot drift from production normalization.\n\nFlags:\n  --agent <selector>     Agent the run belongs to (agentId, deployedName,\n                         or persona slug). Without it, every agent in the\n                         workspace is checked for the run id.\n  --fixture <file>       Write the legacy replay fixture to <file>.\n  --bundle <file>        Write the richer replay bundle to <file>.\n                         Default: stdout.\n  --workspace <name>     Workforce workspace; defaults to the active one.\n  --cloud-url <url>      Override the workforce cloud base URL.\n  --no-prompt            Fail instead of prompting for login.\n  -h, --help             Print this message.\n\nExit codes: 0 exported; 1 run not found / envelope not captured / errors.\n";
export interface RunsExportOptions {
    runId: string;
    agent?: string;
    fixturePath?: string;
    bundlePath?: string;
    workspace?: string;
    cloudUrl?: string;
    noPrompt?: boolean;
}
export type ParsedRunsArgs = {
    action: 'export';
    options: RunsExportOptions;
} | {
    help: true;
};
export declare function parseRunsArgs(args: readonly string[]): ParsedRunsArgs;
type EnvelopeResponse = {
    captured?: unknown;
    omitted?: unknown;
    envelope?: unknown;
};
type ReplayBundleResponse = Record<string, unknown>;
export interface RunsIO {
    stdout: (text: string) => void;
    stderr: (text: string) => void;
}
/**
 * Fetch the captured envelope for a run. The envelope endpoint is
 * agent-scoped (`/deployments/:agentId/runs/:runId/envelope`), so with no
 * --agent selector every workspace agent is probed for the run id (404 =
 * not this agent's run; bounded by the workspace's agent count).
 */
export declare function runRuns(args: readonly string[], io?: RunsIO): Promise<void>;
/**
 * Interpret the envelope endpoint's response into either a fixture text or
 * a user-actionable error. Exported for unit tests.
 */
export declare function interpretEnvelopeResponse(payload: EnvelopeResponse, runId: string, agentName: string): {
    ok: true;
    fixture: string;
} | {
    ok: false;
    error: string;
};
export declare function interpretReplayBundleResponse(payload: ReplayBundleResponse, runId: string, agentName: string): {
    ok: true;
    fixture: string;
} | {
    ok: false;
    error: string;
};
/**
 * True only for the probe's "this agent does not own that run" outcome:
 * requestJson formats non-ok statuses as "<action> failed: <status> …" and
 * throws a distinct "unauthorized. Run `agentworkforce login` …" for 401.
 * Exported for unit tests.
 */
export declare function isProbeNotFound(err: unknown): boolean;
export {};
//# sourceMappingURL=runs-command.d.ts.map