deepstrike-core 0.2.32

Cross-language agent runtime kernel — pure computation, zero I/O
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

//! # DeepStrike Core
//!
//! Cross-language agent runtime kernel — pure computation, zero I/O.
//!
//! This crate provides the core state machines, data structures, and algorithms
//! for the DeepStrike agent framework. It is designed to be embedded via FFI
//! bindings (PyO3, napi-rs, wasm-bindgen) into any language runtime.
//!
//! ## Architecture
//!
//! ```text
//! ┌─────────────┐  ┌─────────────┐  ┌─────────────┐
//! │ Python SDK  │  │ Node.js SDK │  │  WASM SDK   │
//! └──────┬──────┘  └──────┬──────┘  └──────┬──────┘
//!        └────────┬───────┴────────┬───────┘
//!                 │  deepstrike-core │
//!                 └─────────────────┘
//! ```
//!
//! ## Design Principles
//!
//! - **Pure computation**: No I/O, no async, no network calls
//! - **State machine driven**: SDK feeds events, kernel returns actions
//! - **Zero-copy where possible**: CompactString, borrowed slices
//! - **Compile-time safety**: Ownership, Send+Sync, exhaustive matches

pub mod context;
pub mod governance;
pub mod harness;
pub mod memory;
pub mod mm;
pub mod orchestration;
pub mod proc;
pub mod runtime;
pub mod scheduler;
pub mod signals;
pub mod syscall;
pub mod types;

// Re-export key types at crate root for convenience
pub use context::renewal::{ContractCheckResult, HandoffArtifact};
pub use context::snapshot::ContextSnapshotHint;
pub use governance::tool_decision::{
    ToolDecision, ToolDecisionContext, ToolDecisionPipeline, ToolDecisionStage,
};
pub use governance::sandbox::SandboxProfile;
pub use governance::pipeline::SecurityPolicySnapshot;
pub use governance::quota::ResourceQuota;
pub use mm::{
    plan_eviction, EvictionOp, EvictionPlan, Handle, HandleId, HandleKind, HandleTable,
    MemoryTierHint, PageInEntry, PageInRequest, Residency,
};
pub use proc::{AgentProcess, ProcessState};
pub use scheduler::tcb::{
    BudgetLedger, BudgetSlice, ScheduleDecision, TaskId, TaskState, TaskTable, Tcb, WaitReason,
};
pub use syscall::{Disposition, Syscall};
pub use runtime::session::SessionEvent;
pub use runtime::{
    category_for_kind, primitive_for_kind, reconstruct_messages_with_fallback,
    rebuild_os_snapshot_from_events, session_log_has_required_categories, KernelEventCategory,
    Primitive, KERNEL_ABI_VERSION, KERNEL_OBSERVATION_KINDS, KernelAction, KernelInput, OsSnapshot,
    KernelInputEvent, KernelObservation, KernelPressureAction, KernelRuntime, KernelStep,
};
pub use types::agent::{
    AgentCapabilityFilter, AgentIdentity, AgentIsolation, AgentRole, AgentRunSpec,
    ContextInheritance, IsolationManifest,
};
pub use types::capability::{
    CapabilityCommand, CapabilityDescriptor, CapabilityKind, CapabilityLease, CapabilityManifest,
};
pub use types::contract::{AcceptanceCriterion, VerificationContract};
pub use types::error::{DeepStrikeError, Result};
pub use types::message::{Message, ToolCall, ToolResult};
pub use types::milestone::{
    MilestoneCheckResult, MilestoneContract, MilestonePhase, MilestoneRollbackPolicy,
    MilestoneUnlockPolicy, MilestoneVerifier, RetryPolicy,
};
pub use types::signal::RuntimeSignal;
pub use types::task::{RuntimeTask, TaskLane};