punch_kernel/
lib.rs

1//! # punch-kernel
2//!
3//! **The Ring** — central kernel and orchestrator for the Punch Agent Combat System.
4//!
5//! This crate coordinates fighters (conversational agents), gorillas (autonomous
6//! agents), the event bus, the scheduler, the background executor, the workflow
7//! engine, and the metering engine. It is the single entry point through which
8//! the rest of the system interacts with the agent runtime.
9
10pub mod a2a_executor;
11pub mod agent_messaging;
12pub mod background;
13pub mod budget;
14pub mod config_watcher;
15pub mod event_bus;
16pub mod heartbeat_scheduler;
17pub mod metering;
18pub mod metrics;
19pub mod patterns;
20pub mod registry;
21pub mod ring;
22pub mod scheduler;
23pub mod shutdown;
24pub mod swarm;
25pub mod tenant_registry;
26pub mod triggers;
27pub mod troop;
28pub mod workflow;
29pub mod workflow_conditions;
30pub mod workflow_loops;
31pub mod workflow_validation;
32
33pub use a2a_executor::A2ATaskExecutor;
34pub use agent_messaging::MessageRouter;
35pub use background::{BackgroundExecutor, fighter_manifest_from_gorilla, run_gorilla_tick};
36pub use budget::{BudgetEnforcer, BudgetLimit, BudgetStatus, BudgetVerdict};
37pub use config_watcher::{KernelConfigDiff, KernelConfigWatcher};
38pub use event_bus::EventBus;
39pub use heartbeat_scheduler::{HeartbeatScheduler, HeartbeatStartConfig};
40pub use metering::{MeteringEngine, ModelPrice, SpendPeriod};
41pub use metrics::{MetricsRegistry, register_default_metrics};
42pub use patterns::{
43    ChainHandler, MapReduceConfig, MapReduceResult, ScatterResponse, SupervisedWorker,
44    SupervisorConfig, auction_filter_bids, auction_select_winner, chain_find_handler, chain_walk,
45    execute_auction, execute_chain_of_responsibility, execute_map_reduce,
46    execute_map_reduce_distributed, execute_scatter_gather, map_reduce_merge, map_split,
47    scatter_select, supervisor_handle_failure, supervisor_monitor_health,
48};
49pub use registry::AgentRegistry;
50pub use ring::{FighterEntry, GorillaEntry, Ring};
51pub use scheduler::Scheduler;
52pub use shutdown::ShutdownCoordinator;
53pub use swarm::{FighterLoad, ProgressReport, SwarmCoordinator};
54pub use tenant_registry::TenantRegistry;
55pub use triggers::{
56    Trigger, TriggerAction, TriggerCondition, TriggerEngine, TriggerId, TriggerSummary,
57};
58pub use troop::{TaskAssignmentResult, TroopManager};
59pub use workflow::{
60    CircuitBreakerState, DagExecutionResult, DagWorkflow, DagWorkflowStep, DeadLetterEntry,
61    ExecutionTraceEntry, OnError, StepExecutor, StepResult, StepStatus, Workflow, WorkflowEngine,
62    WorkflowId, WorkflowRun, WorkflowRunId, WorkflowRunStatus, WorkflowStep, execute_dag,
63    expand_dag_variables,
64};
65pub use workflow_conditions::{Condition, evaluate_condition};
66pub use workflow_loops::{LoopConfig, LoopState, calculate_backoff, parse_foreach_items};
67pub use workflow_validation::{ValidationError, topological_sort, validate_workflow};
punch_kernel/lib.rs

punch_kernel/
lib.rs
