/**
 * v3 architect runner.
 *
 * The grill layer produces `spec.md` + canonical `spec.json`; architect is a
 * single autonomous goal-worker that compiles those files into `dag.json` plus
 * `architect-notes.md`.  This helper keeps that fixed execution contract in one
 * place so host commands do not hand-roll goal-mode env/layout details.
 */
import { type EphemeralPoolDeps } from './ephemeral-pool.js';
import { type BotSnapshot, type RunNode, type ValidateManifest, type WorkerSessionInfo } from './contract.js';
export interface RunArchitectInput {
    runId: string;
    runDir: string;
    specPath: string;
    specJsonPath: string;
    botSnapshot: BotSnapshot;
    timeoutMs?: number;
    cancelSignal?: AbortSignal;
    /**
     * Test seam.  Production callers normally omit this and provide
     * `resolveLarkAppSecret` so the real ephemeral pool is used.
     */
    runNode?: RunNode;
    resolveLarkAppSecret?: EphemeralPoolDeps['resolveLarkAppSecret'];
    validateManifest?: ValidateManifest;
}
export interface RunArchitectResult {
    status: 'ok' | 'fail';
    dagPath?: string;
    notesPath?: string;
    manifestPath: string;
    problems?: string[];
    sessionInfo?: WorkerSessionInfo;
}
export declare function buildArchitectGoal(specPath: string, specJsonPath: string): string;
export declare function runArchitect(input: RunArchitectInput): Promise<RunArchitectResult>;
//# sourceMappingURL=architect.d.ts.map