a4aa 0.1.0

Adapter-For-All-Agents — unified agent client adapter: process supervision, stdio/PTY transports, JSON-RPC and ACP lanes, CLI drivers, and a stdio sidecar for hosts in other languages.
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

//! # a4aa — Adapter For All Agents
//!
//! One crate owns every agent-client adaptation path a host needs:
//!
//! - **supervision** — process-group spawn, sanitized environment, bounded
//!   I/O, interrupt (SIGINT→grace→kill) and tree teardown;
//! - **transports** — piped stdio and Unix PTY (raw slave, streaming master);
//! - **lanes** — [`proto::acp`] (official `agent-client-protocol` crate),
//!   [`proto::rpc`] (host-declared JSON-RPC methods), [`proto::cli`]
//!   (argv/stdin prompt, streamed output);
//! - **facade** — [`Adapter`] produces a lane-erased [`AgentSession`];
//! - **sidecar** — the `a4aa serve` binary speaks `a4aa.v1` NDJSON-RPC on its
//!   own stdio, so hosts in any language reuse the identical adapters by
//!   spawning this crate.
//!
//! Design invariants:
//! - **Zero-assumption output.** No lane forces a schema onto agent output;
//!   natural language is a valid turn result.
//! - **Fail closed.** Unknown inbound requests are rejected, unresolved
//!   secrets and unset permission handlers never grant.
//! - **Explicit cancellation only.** Cancel signals reach the agent solely
//!   from a caller's `cancel()`; a dropped observer or transport error is
//!   never rewritten as user cancellation.
//! - **Bounded resources.** Output caps drain-and-discard; a chatty agent
//!   can never exhaust host memory or stall its own pipes.

pub mod adapter;
pub mod bounds;
pub mod dialect;
pub mod env;
pub mod error;
pub mod framing;
pub mod mechanisms;
pub mod model;
pub mod observe;
pub mod proto;
pub mod rpc;
pub mod supervision;
pub mod transport;

pub use adapter::{Adapter, AgentSession, BeforeTurn, LaneSession, PermissionHandler, TurnRequest};
pub use dialect::{
    adapt, CommandSurface, Dialect, ExtensionKind, HookSurface, McpSurface, PermissionSurface,
    PluginSurface, SubagentSurface, Target,
};
pub use env::{EnvPolicy, EnvSource, EnvValue, NoSecrets, SecretResolver};
pub use error::{AdapterError, Result};
pub use mechanisms::{
    AdaptationPlan, Artifact, ArtifactScope, CommandDecl, HookDecl, HookEvent, HookIntent,
    MechanismSet, PermissionDecl, PluginDecl, RuleDecl, SkillDecl, SubagentDecl, Support,
    SupportEntry, WriteMode,
};
pub use model::{
    AgentEvent, AgentSpec, Capabilities, CliLaneSpec, CommandSpec, LaneKind, LaneSpec,
    PromptChannel, RpcCallSpec, RpcLaneSpec, SessionRequest, StreamMode, TurnOutcome,
};
pub use observe::{Direction, Observer, SharedObserver};
pub use proto::acp::{PermissionDecision, PermissionPrompt, SessionDelegate};
pub use proto::rpc::RpcSessionDelegate;
pub use rpc::{CallFailure, JsonRpcPeer, RpcDelegate, RpcErrorObject};
pub use supervision::{IoPlan, StdioKind, SupervisedChild};