import type { ExternalAgentEventType } from "../harness/external-agent.js";
/**
 * Taxonomy schema version. Bump when an event type's phase/terminal semantics
 * change or a type is added/removed in a way observability consumers must know.
 */
export declare const EXTERNAL_AGENT_EVENT_TAXONOMY_VERSION = 1;
/** Coarse lifecycle phase a raw external-agent event belongs to. */
export type ExternalAgentLifecyclePhase = "starting" | "streaming" | "tool" | "artifact" | "error" | "finished";
export interface ExternalAgentEventTaxonomyEntry {
    phase: ExternalAgentLifecyclePhase;
    /** True when the event represents a terminal state for the run. */
    terminal: boolean;
    description: string;
}
export declare const EXTERNAL_AGENT_EVENT_TAXONOMY: Record<ExternalAgentEventType, ExternalAgentEventTaxonomyEntry>;
/** Resolve the lifecycle phase for a raw external-agent event type. */
export declare function externalAgentEventPhase(type: ExternalAgentEventType): ExternalAgentLifecyclePhase;
/** Whether a raw external-agent event type is a terminal run state. */
export declare function isTerminalExternalAgentEvent(type: ExternalAgentEventType): boolean;
//# sourceMappingURL=event-taxonomy.d.ts.map