/**
 * Plugin interface and registry for extending multi-agent orchestrator functionality.
 *
 * This module defines the MultiAgentPlugin interface and MultiAgentPluginRegistry,
 * which provide a composable way to add behavior to multi-agent orchestrators (e.g. Swarm, Graph)
 * through hook registration and custom initialization.
 */
import type { MultiAgent } from './multiagent.js';
/**
 * Interface for objects that implement multi-agent orchestrator plugin functionality.
 *
 * MultiAgentPlugins provide a composable way to add behavior to orchestrators
 * by registering hook callbacks in their `initMultiAgent` method.
 *
 * @example
 * ```typescript
 * class LoggingPlugin implements MultiAgentPlugin {
 *   get name(): string {
 *     return 'logging-plugin'
 *   }
 *
 *   initMultiAgent(orchestrator: MultiAgent): void {
 *     orchestrator.addHook(BeforeNodeCallEvent, (event) => {
 *       console.log(`Node ${event.nodeId} starting`)
 *     })
 *   }
 * }
 *
 * const swarm = new Swarm({
 *   nodes: [agentA, agentB],
 *   start: 'agentA',
 *   plugins: [new LoggingPlugin()],
 * })
 * ```
 */
export interface MultiAgentPlugin {
    /**
     * A stable string identifier for the plugin.
     * Used for logging, duplicate detection, and plugin management.
     */
    readonly name: string;
    /**
     * Initialize the plugin with the orchestrator instance.
     *
     * Implement this method to register hooks and perform custom initialization.
     *
     * @param orchestrator - The orchestrator this plugin is being attached to
     */
    initMultiAgent(orchestrator: MultiAgent): void | Promise<void>;
}
/**
 * Registry for managing plugins attached to a multi-agent orchestrator.
 *
 * Holds pending plugins and initializes them on first use.
 * Handles duplicate detection and calls each plugin's initMultiAgent method.
 */
export declare class MultiAgentPluginRegistry {
    private readonly _plugins;
    private readonly _pending;
    constructor(plugins?: MultiAgentPlugin[]);
    /**
     * Initialize all pending plugins with the orchestrator.
     * Safe to call multiple times — only runs once.
     *
     * @param orchestrator - The orchestrator instance to initialize plugins with
     */
    initialize(orchestrator: MultiAgent): Promise<void>;
    private _addAndInit;
}
//# sourceMappingURL=plugins.d.ts.map