/**
 * spawn.validator — SDK tool that spawns a Validator subagent.
 *
 * Auth model — orchestrator-tier-1+: only an agent with
 * `caller.role === 'orchestrator'` AND `caller.tier >= 1` may invoke. This
 * mirrors the existing spawn-tool tier model — workers / leads / tier-0
 * orchestrators cannot directly spawn Validators.
 *
 * Delegates to the existing {@link orchestrateSpawn} pipeline with the
 * Validator's task id (one task per Validator-review cycle). The spawn
 * machinery provisions a worktree, builds the prompt preamble, and emits
 * the same `WorktreeSpawnResult`-shaped envelope used by every other
 * `cleo orchestrate spawn` call.
 *
 * Tier-protocol invariant: the resulting subagent runs with
 * `CLEO_AGENT_ROLE=worker` at the harness level (Validator is a CANT-defined
 * persona, NOT a separate harness role), but the spawned task's protocolType
 * is set to `'validator'` so the prompt-builder applies the Validator stage
 * guidance. See ADR-079-r* §validator-semantics.
 *
 * @arch SDK Tool (Category B) — harness-agnostic, contracts-typed
 * @task T10511
 * @epic T10383 (E-VALIDATOR-ROLE)
 * @saga T10377 (SG-IVTR-AC-BINDING)
 */
import type { AgentRole } from '@cleocode/contracts';
import type { EngineResult } from '../engine-result.js';
import type { RegisteredSdkTool } from '../task-tools/sdk-tool.js';
/**
 * Input envelope for the {@link spawnValidator} SDK tool.
 *
 * @task T10511
 */
export interface SpawnValidatorInput {
    /** Absolute project root. */
    projectRoot: string;
    /** Caller identity — must be orchestrator at tier ≥ 1. */
    caller: {
        /** Canonical agent role — must be `'orchestrator'`. */
        role: AgentRole;
        /** Tier — must be ≥ 1. tier 0 orchestrators cannot spawn Validators. */
        tier: 0 | 1 | 2;
    };
    /** Task ID the Validator will review. */
    taskId: string;
    /**
     * Optional spawn-scope override. Defaults are inherited from the
     * existing spawn pipeline.
     */
    spawnScope?: string;
    /** Pass-through to {@link orchestrateSpawn} — defaults to false. */
    noWorktree?: boolean;
}
/**
 * Output envelope for the {@link spawnValidator} SDK tool.
 *
 * Discriminated by `ok`. On success, returns the underlying EngineResult
 * (carrying the spawn prompt + worktree env-vars + cwd). On failure,
 * returns a structured error code + message.
 *
 * @task T10511
 */
export type SpawnValidatorOutput = {
    ok: true;
    /** Raw EngineResult from `orchestrateSpawn`. */
    result: EngineResult;
} | {
    ok: false;
    code: string;
    message: string;
};
/**
 * Registered SDK tool: spawn.validator.
 *
 * @example
 * ```typescript
 * const out = await spawnValidator.invoke({
 *   projectRoot: '/mnt/projects/cleocode',
 *   caller: { role: 'orchestrator', tier: 1 },
 *   taskId: 'T1234',
 * });
 * if (out.ok) console.log('validator spawned:', out.result);
 * ```
 *
 * @task T10511
 */
export declare const spawnValidator: RegisteredSdkTool<SpawnValidatorInput, Promise<SpawnValidatorOutput>>;
//# sourceMappingURL=spawn-validator.d.ts.map