api.py

"""Public API -- MiniAutoGen Side C.

Usage::

    from miniautogen.api import WorkflowRuntime, DeliberationRuntime, CompositeRuntime

This module re-exports the essential types that define MiniAutoGen's
identity as a multi-agent coordination library.
"""

from miniautogen.backends import (
    AgentDriver,
    BackendCapabilities,
    BackendResolver,
)
from miniautogen.core.contracts import (
    AgentHook,
    AgentSpec,
    CoordinationMode,
    CoordinatorCapability,
    EffectDescriptor,
    EffectRecord,
    EffectStatus,
    EngineProfile,
    ErrorCategory,
    ExecutionEvent,
    InMemoryMemoryProvider,
    LoopStopReason,
    McpServerBinding,
    MemoryProfile,
    MemoryProvider,
    Message,
    RunContext,
    RunResult,
    RunStatus,
    RuntimeInterceptor,
    SkillSpec,
    StepSupervision,
    SupervisionDecision,
    SupervisionStrategy,
    ToolSpec,
)
from miniautogen.core.contracts.agent import (
    ConversationalAgent,
    DeliberationAgent,
    WorkflowAgent,
)
from miniautogen.core.contracts.agentic_loop import (
    AgenticLoopState,
    ConversationPolicy,
    RouterDecision,
)
from miniautogen.core.contracts.conversation import Conversation
from miniautogen.core.contracts.coordination import (
    AgenticLoopPlan,
    CoordinationKind,
    CoordinationPlan,
    DeliberationPlan,
    SubrunRequest,
    WorkflowPlan,
    WorkflowStep,
)
from miniautogen.core.contracts.delegation import (
    DelegationRouterProtocol,
    PersistableMemory,
)
from miniautogen.core.contracts.deliberation import (
    Contribution,
    Review,
)
from miniautogen.core.contracts.store import StoreProtocol
from miniautogen.core.contracts.tool import ToolProtocol, ToolResult
from miniautogen.core.contracts.tool_registry import (
    ToolCall,
    ToolDefinition,
    ToolRegistryProtocol,
)
from miniautogen.core.contracts.turn_result import TurnResult
from miniautogen.core.effect_interceptor import EffectInterceptor
from miniautogen.core.runtime.agent_runtime import AgentRuntime
from miniautogen.core.runtime.tool_registry import InMemoryToolRegistry
from miniautogen.core.runtime.delegation_router import ConfigDelegationRouter
from miniautogen.core.runtime.persistent_memory import PersistentMemoryProvider
from miniautogen.core.runtime.filesystem_tool_registry import FileSystemToolRegistry
from miniautogen.core.events.event_sink import (
    CompositeEventSink,
    EventSink,
    FilteredEventSink,
    InMemoryEventSink,
    NullEventSink,
)
from miniautogen.core.events.filters import (
    CompositeFilter,
    EventFilter,
    RunFilter,
    TypeFilter,
)
from miniautogen.core.events.types import EventType
from miniautogen.core.runtime import (
    AgenticLoopRuntime,
    CompositeRuntime,
    DeliberationRuntime,
    PipelineRunner,
    WorkflowRuntime,
)
from miniautogen.core.runtime.agent_runtime import AgentRuntime
from miniautogen.core.runtime.builtin_tools import BuiltinToolRegistry
from miniautogen.core.runtime.composite_runtime import CompositionStep
from miniautogen.core.runtime.composite_tool_registry import CompositeToolRegistry
from miniautogen.core.runtime.delegation_router import ConfigDelegationRouter
from miniautogen.core.runtime.filesystem_tool_registry import FileSystemToolRegistry
from miniautogen.core.runtime.human_agent import (
    HumanAgent,
    InputChannel,
    QueueInputChannel,
    StdinInputChannel,
)
from miniautogen.core.runtime.persistent_memory import PersistentMemoryProvider
from miniautogen.core.runtime.recovery import SessionRecovery
from miniautogen.core.runtime.tool_registry import InMemoryToolRegistry
from miniautogen.observability.event_logging import LoggingEventSink
from miniautogen.pipeline.components.pipelinecomponent import PipelineComponent
from miniautogen.pipeline.pipeline import Pipeline
from miniautogen.policies.approval import ApprovalGate, AutoApproveGate
from miniautogen.policies.approval_channel import (
    ApprovalChannel,
    ApprovalHandle,
    CallbackApprovalChannel,
    ChannelApprovalGate,
    InMemoryApprovalChannel,
    WebhookApprovalChannel,
)
from miniautogen.policies.budget import BudgetExceededError, BudgetPolicy, BudgetTracker
from miniautogen.policies.chain import PolicyChain, PolicyContext, PolicyEvaluator, PolicyResult
from miniautogen.policies.effect import EffectPolicy
from miniautogen.policies.execution import ExecutionPolicy
from miniautogen.policies.retry import RetryPolicy
from miniautogen.policies.semantic_cache import ExactCache, SemanticCache
from miniautogen.scripting import ScriptBuilder, quick_run
from miniautogen.stores.checkpoint_store import CheckpointStore
from miniautogen.stores.effect_journal import EffectJournal
from miniautogen.stores.in_memory_checkpoint_store import InMemoryCheckpointStore
from miniautogen.stores.in_memory_effect_journal import InMemoryEffectJournal
from miniautogen.stores.in_memory_run_store import InMemoryRunStore
from miniautogen.stores.run_store import RunStore
from miniautogen.stores.sqlalchemy_checkpoint_store import SQLAlchemyCheckpointStore
from miniautogen.stores.sqlalchemy_run_store import SQLAlchemyRunStore
from miniautogen.testing import MockEngine, RecordReplayEngine

__all__ = [
    # Core contracts
    "AgentSpec",
    "EngineProfile",
    "ExecutionEvent",
    "LoopStopReason",
    "McpServerBinding",
    "MemoryProfile",
    "Message",
    "RunContext",
    "RunResult",
    "RunStatus",
    "SkillSpec",
    "StoreProtocol",
    "ToolProtocol",
    "ToolResult",
    "ToolSpec",
    "ToolRegistryProtocol",
    "ToolDefinition",
    "ToolCall",
    "DelegationRouterProtocol",
    "PersistableMemory",
    "TurnResult",
    "Conversation",
    # Agent protocols
    "WorkflowAgent",
    "DeliberationAgent",
    "ConversationalAgent",
    # Agent hooks and memory
    "AgentHook",
    "MemoryProvider",
    "InMemoryMemoryProvider",
    # Agentic loop
    "RouterDecision",
    "ConversationPolicy",
    "AgenticLoopState",
    "AgenticLoopPlan",
    # Deliberation (general + specialized)
    "Contribution",
    "Review",
    # Coordination
    "CoordinationKind",
    "CoordinationMode",
    "CoordinationPlan",
    "DeliberationPlan",
    "WorkflowPlan",
    "WorkflowStep",
    "CompositionStep",
    "SubrunRequest",
    "CoordinatorCapability",
    # Runtimes (Coordination Modes)
    "AgenticLoopRuntime",
    "CompositeRuntime",
    "DeliberationRuntime",
    "PipelineRunner",
    "WorkflowRuntime",
    # Agent runtime and tools
    "AgentRuntime",
    "BuiltinToolRegistry",
    "CompositeToolRegistry",
    "InMemoryToolRegistry",
    "FileSystemToolRegistry",
    "ConfigDelegationRouter",
    "PersistentMemoryProvider",
    # Runtime interceptor
    "RuntimeInterceptor",
    # Pipeline
    "Pipeline",
    "PipelineComponent",
    # Policy enforcement
    "PolicyChain",
    "PolicyContext",
    "PolicyResult",
    "PolicyEvaluator",
    "RetryPolicy",
    "BudgetPolicy",
    "BudgetTracker",
    "BudgetExceededError",
    "ExecutionPolicy",
    # Approval
    "ApprovalGate",
    "AutoApproveGate",
    # Approval channels (decoupled human-in-the-loop)
    "ApprovalChannel",
    "ApprovalHandle",
    "CallbackApprovalChannel",
    "ChannelApprovalGate",
    "InMemoryApprovalChannel",
    "WebhookApprovalChannel",
    # Scripting mode
    "ScriptBuilder",
    "quick_run",
    # Testing (MockEngine, RecordReplay)
    "MockEngine",
    "RecordReplayEngine",
    # Semantic cache
    "ExactCache",
    "SemanticCache",
    # HumanAgent (human-as-first-class participant)
    "HumanAgent",
    "InputChannel",
    "QueueInputChannel",
    "StdinInputChannel",
    # Effect engine
    "EffectInterceptor",
    "EffectPolicy",
    "EffectDescriptor",
    "EffectRecord",
    "EffectStatus",
    # Supervision
    "StepSupervision",
    "SupervisionDecision",
    "SupervisionStrategy",
    # Error taxonomy
    "ErrorCategory",
    # Events and observability
    "EventType",
    "EventSink",
    "NullEventSink",
    "CompositeEventSink",
    "CompositeFilter",
    "EventFilter",
    "FilteredEventSink",
    "InMemoryEventSink",
    "LoggingEventSink",
    "RunFilter",
    "TypeFilter",
    # Recovery
    "SessionRecovery",
    # Backend driver abstraction
    "AgentDriver",
    "BackendCapabilities",
    "BackendResolver",
    # Stores
    "CheckpointStore",
    "InMemoryCheckpointStore",
    "EffectJournal",
    "InMemoryEffectJournal",
    "InMemoryRunStore",
    "RunStore",
    "SQLAlchemyCheckpointStore",
    "SQLAlchemyRunStore",
]