agentyk-core 0.1.0

The agentyk contract: traits, event protocol, and the turn state machine. Implement against this; build with `agentyk`.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66

//! # agentyk-core
//!
//! The agentyk **contract crate**: everything a host or extension implements
//! against, and nothing else. If you are building an application, depend on
//! [`agentyk`](https://crates.io/crates/agentyk) (which re-exports all of
//! this); depend on `agentyk-core` directly when you are *implementing* a
//! seam — a custom [`tool::Tool`], [`capability::Capability`],
//! [`driver::ChatDriver`], [`event_log::EventLog`], or
//! [`executor::TurnExecutor`] (e.g. a durable execution host).
//!
//! Contents:
//!
//! - **Protocol data** — [`event`] (the event protocol), [`message`],
//!   [`tool`] definitions, typed [`id`]s, [`error`].
//! - **Seams** — the traits in [`capability`], [`tool`], [`driver`],
//!   [`event_log`], [`event`] (listeners), [`executor`], and [`hooks`]
//!   (pre/post tool interception).
//! - **The turn machine** — [`turn`] (pure, serializable) and the stateless
//!   [`atoms`] it sequences; [`replay`] folds an event log back into message
//!   history.
//!
//! This crate is deliberately lean: no tokio, no HTTP, no process spawning —
//! pure data, traits, and std-only implementations (like
//! [`event_log::InMemoryEventLog`]).

pub mod atoms;
pub mod budget;
pub mod cancellation;
pub mod capability;
pub mod context;
pub mod controls;
pub mod driver;
pub mod error;
pub mod event;
pub mod event_log;
pub mod executor;
pub mod extensions;
pub mod hooks;
pub mod id;
pub mod message;
pub mod replay;
pub mod tool;
pub mod turn;

pub use budget::{BudgetChecker, BudgetDecision};
pub use cancellation::CancellationToken;
pub use capability::{Capability, CommandContext, CommandDescriptor, SystemPromptContext};
pub use context::{ContextAssembler, PassthroughContextAssembler};
pub use controls::TurnControls;
pub use driver::{
    ChatDriver, ChatRequest, ChatResponse, DeltaSink, DriverId, DriverRegistry, ModelSpec,
    ReasoningConfig, Usage,
};
pub use error::{Error, LlmErrorKind, Result};
pub use event::{Event, EventData, EventListener, EventRequest, event_types};
pub use event_log::{EventLog, InMemoryEventLog};
pub use executor::{TurnExecutor, TurnHost, TurnResult};
pub use extensions::Extensions;
pub use hooks::{PostToolExecHook, PreToolUseDecision, PreToolUseHook};
pub use id::{EventId, SessionId, TurnId};
pub use message::{ContentPart, ImageContentPart, Message, Role, TextContentPart, ToolCall};
pub use replay::messages_from_events;
pub use tool::{
    DeferrablePolicy, FnTool, Tool, ToolContext, ToolDefinition, ToolOutput, ToolPolicy,
};
pub use turn::{SealReason, TurnAction, TurnOutcome, TurnPhase, TurnState};