/**
 * v1.3.2 §5 — the delegation-graph view of an agent (actor) definition.
 *
 * Distinct from `skill-parser`'s `SkillSpec`: that parser reads procedural
 * skill fields and (as of v1.3.2) does *not* parse the actor graph fields
 * (`tier`, `collaborators`, `used_by`, `skills_used`). This module extracts
 * exactly those so `validateAgents()` can build the orchestration topology.
 */
export interface AgentSpec {
    /** frontmatter `name` (falls back to the directory name). */
    name: string;
    /** "leader" | "member" (free string tolerated; validator flags unknowns). */
    tier?: string;
    /** frontmatter `team` (product/engineering/design/marketing/chief). */
    team: string;
    category?: string;
    devCapability?: boolean;
    /** outbound delegation/collaboration refs ("<team>/<name>" or bare name). */
    collaborators: string[];
    /** inbound refs — who uses this actor (bare name or "<team>/<name>"). */
    usedBy: string[];
    skillsUsed: string[];
    /** parent directory name — for the dir-match check. */
    dir: string;
    /** flat bucket the actor lives in: "main" | "specialists" | legacy team. */
    bucket: string;
    skillPath: string;
    /** canonical node id "<team>/<name>". */
    id: string;
}
/** Parse one SKILL.md (already located) into an AgentSpec. */
export declare function parseAgentSpec(skillPath: string, bucket: string, fallbackTeam: string): AgentSpec;
/**
 * Load every actor under `agentsDir` (defaults to the bundled agents dir).
 * The caller assembles the validation scope — e.g. bundle + a single org's
 * adopted actors (v1.3.2 §10) — by concatenating multiple loads.
 */
export declare function loadAgentSpecs(agentsDir?: string): AgentSpec[];
/**
 * Every accepted reference form for the given actors — for resolving refs that
 * appear in *other* artifacts (e.g. `workflow.yaml` `agent:` fields):
 *   - "<team>/<name>"      canonical              (chief/chief)
 *   - "<bucket>/<name>"    flat bucket            (main/chief, specialists/architect)
 *   - "_main/<name>"       main-bot sentinel      (_main/chief)
 *   - "<name>"             bare                   (chief)
 *
 * `_skill/<name>` refs are intentionally *not* included — those denote a skill
 * stage, not an actor, and the caller resolves them against the skill registry.
 */
export declare function agentRefAliases(specs: AgentSpec[]): Set<string>;