/**
 * Prepare stage — resolve each agent's effective launch identity + ACLs by merging its persona
 * (read from disk) with the manifest. Pure: it takes already-loaded {@link AgentDef}s so it stays
 * unit-testable; the fs/live I/O lives in {@link ./preflight.js}.
 *
 * Behavior fields (model/variant/role/description/body) are persona-default + manifest-override. Access is
 * governed by {@link PersonaPermissions}: under `reject` the manifest is the sole source; under
 * `include` a persona's own grants are inherited **only for channels the manifest does not declare**
 * (one authority per channel), concrete-only (wildcards rejected), and surfaced loudly.
 */
import { type AgentDef } from "@cotal-ai/core";
import type { AgentPolicy, ResolvedAgent } from "./model.js";
import type { ManifestIssue } from "./errors.js";
/** Persona grants that fall outside the manifest's channels (unmanaged credential scopes) + the
 *  capabilities inherited from the persona — the data the loud dry-run section renders. */
export interface InheritedScopes {
    subscribe: string[];
    allowSubscribe: string[];
    allowPublish: string[];
    capabilities: string[];
}
/** A non-fatal diagnostic to surface in dry-run / topology view. `loud` = call it out prominently
 *  (e.g. an agent with capabilities but no channel access). */
export interface AgentWarning {
    agent: string;
    message: string;
    loud?: boolean;
}
/** The fully resolved launch form for one agent — what the spawn path needs. */
export interface PreparedAgent {
    name: string;
    agentType: string;
    /** Manager-host directory, forwarded without resolving on the deploying machine. */
    cwd?: string;
    /** Session continuity mode, forwarded to the manager (which owns the session id). */
    continuity?: "none" | "exact";
    /** Persona file path (or undefined for an inline agent). */
    persona?: string;
    /** Effective values (manifest override ?? persona default). */
    model?: string;
    variant?: string;
    /** Effective opaque connector launch options (manifest merged per key over persona). */
    launchOptions?: Record<string, unknown>;
    role?: string;
    description?: string;
    /** Effective persona body (manifest `instructions` REPLACES the file body; sole body for inline). */
    body?: string;
    /** Kickoff prompt auto-submitted at session start (manifest-only; personas carry none). */
    prompt?: string;
    /** Explicit event-plane choice. `false` is the declarative opt-out. */
    events?: boolean;
    /** Effective merged capabilities. */
    capabilities: string[];
    capabilitySource: "manifest" | "persona" | "none";
    /** Effective merged per-channel ACLs (manifest + persona-undeclared under `include`). */
    policy: AgentPolicy;
    /** Persona grants outside manifest channels + inherited caps (empty under `reject`/inline). */
    inherited: InheritedScopes;
}
export interface PreparedResult {
    prepared: PreparedAgent;
    issues: ManifestIssue[];
    warnings: AgentWarning[];
}
/** Merge one resolved agent with its (optional) loaded persona, given the set of channel names the
 *  manifest declares. Returns the launch form plus any errors/warnings. */
export declare function prepareAgent(agent: ResolvedAgent, persona: AgentDef | undefined, declared: Set<string>): PreparedResult;
//# sourceMappingURL=prepare.d.ts.map