a3s-code-core 8.0.3

A3S Code Core - Embeddable AI agent library with tool execution
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
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97

//! Immutable, source-owned capability identity and scoped lifecycle kernel.
//!
//! This module deliberately contains no package resolution, runtime
//! activation, or mutable latest-value registry. A capability source submits
//! one complete contribution, and [`CapabilitySet`] freezes the validated
//! descriptors behind an [`std::sync::Arc`]. Typed scopes add monotonic
//! ceilings, borrowed leases, reversible effects, and bounded structured
//! teardown. Closed runtime values and typestate transactions publish one
//! complete projected generation through a short catalog CAS.

mod agent_execution;
mod ceiling;
mod descriptor;
mod effect;
mod error;
mod flow_binding;
mod id;
mod knowledge_surface_binding;
mod lease;
mod projection;
mod projection_error;
mod readiness;
mod run_binding;
mod runtime;
mod scope;
mod scope_error;
mod set;
mod source;
mod supervisor;
mod transaction;
mod ui_binding;
mod value;

pub use crate::mcp::McpBinding;
pub(crate) use agent_execution::{
    AgentCapabilityOperation, AgentCapabilityRuntime, AgentCapabilitySubtask, AgentCapabilityTurn,
    AgentToolCapabilityContext,
};
pub use ceiling::{
    CapabilityCeiling, CapabilityExecutionCeiling, GovernanceCapabilityCeiling,
    WorkspaceCapabilityCeiling, CAPABILITY_CEILING_SCHEMA,
};
pub use descriptor::{CapabilityContribution, CapabilityDescriptor, MAX_CAPABILITY_DEPENDENCIES};
pub use effect::{CapabilityEffect, CapabilityEffectError};
pub use error::CapabilitySetError;
pub use flow_binding::FlowBinding;
pub use id::{
    CapabilityId, CapabilityKind, CapabilitySourceId, CodeCatalogGeneration, Sha256Digest,
    UseCapabilityGeneration, UsePackageGeneration, MAX_CAPABILITY_IDENTIFIER_BYTES,
    USE_CAPABILITY_SNAPSHOT_CURSOR_SCHEMA,
};
pub use knowledge_surface_binding::{
    KnowledgeSurfaceBinding, KnowledgeSurfaceBindingError, KnowledgeSurfaceBindingSpec,
    KNOWLEDGE_SURFACE_BINDING_SCHEMA, MAX_KNOWLEDGE_SURFACE_PROJECTIONS,
};
pub use lease::{CapabilityLease, RetainedUseGeneration};
pub use projection::{
    CapabilityCatalog, CapabilityCatalogStamp, CapabilityCleanupReport, CapabilityCommitReceipt,
    CapabilityProjection, CapabilityProjectionLease,
};
pub use projection_error::{CapabilityAdapterError, CapabilityProjectionError};
pub use readiness::{
    CapabilityReadinessPlan, CAPABILITY_READINESS_PLAN_SCHEMA, MAX_CAPABILITY_READINESS_WAVES,
};
pub use run_binding::{
    RunCapabilityBindingError, RunCapabilityBindingV1, RunUseCapabilityGenerationV1,
    CAPABILITY_CEILING_DIGEST_DOMAIN, RUN_CAPABILITY_BINDING_SCHEMA,
};
pub use runtime::{
    CapabilityRuntimeError, SessionCapabilityBatch, SessionCapabilityRun, UseGenerationLeaseError,
    UseGenerationLeaseProvider,
};
pub use scope::{
    CapabilityScope, CapabilityScopeHandle, CapabilityScopeId, CapabilityScopeKind, Run, ScopeKind,
    Session, Subtask, Turn,
};
pub use scope_error::CapabilityScopeError;
pub use set::{
    CapabilitySet, CAPABILITY_SET_DIGEST_DOMAIN, CAPABILITY_SET_SCHEMA, MAX_CAPABILITIES,
    MAX_CAPABILITY_CANONICAL_BYTES, MAX_CAPABILITY_DEPENDENCY_EDGES, MAX_CAPABILITY_SOURCES,
};
pub use source::{CapabilitySource, CapabilitySourceClass};
pub(crate) use supervisor::SupervisedTaskSpawner;
pub use supervisor::{
    ScopeClosePolicy, ScopeCloseReport, SupervisedTaskId, DEFAULT_SCOPE_CLOSE_TIMEOUT,
    MAX_SCOPE_CHILDREN, MAX_SCOPE_CLOSE_TIMEOUT, MAX_SCOPE_EFFECTS, MAX_SCOPE_TASKS,
};
pub use transaction::{
    CapabilityProjectionAdapter, CapabilityTxn, Prepared, PreparedCapability, Staged, Validated,
    MAX_CAPABILITY_TRANSACTION_EFFECTS,
};
pub use ui_binding::{
    UiAsset, UiAssetKind, UiBinding, UiBindingError, UiBindingSpec, UiDocument,
    MAX_UI_ASSETS_PER_KIND, MAX_UI_ASSET_BYTES, MAX_UI_DOCUMENT_BYTES, UI_BINDING_SCHEMA,
    UI_DOCUMENT_SCHEMA,
};
pub use value::CapabilityValue;