Crate rullama_core 

rullama-core

Foundation types, traits, and error handling for the rullama.

This crate provides the core data structures used across all framework crates:

• Message types for AI conversations
• Tool definitions and execution results
• Task and agent context types
• Plan metadata and status
• Working set for file context management
• Chat options and provider configuration
• Permission modes

Re-exports

pub use content_source::ContentSource;

pub use embedding::EmbeddingProvider;

pub use search::ChunkMetadata;

pub use search::DatabaseStats;

pub use search::SearchResult;

pub use vector_store::VectorSearchResult;

pub use vector_store::VectorStore;

pub use working_set::WorkingSet;

pub use working_set::WorkingSetConfig;

pub use working_set::WorkingSetEntry;

pub use working_set::estimate_tokens;

pub use working_set::estimate_tokens_from_size;

pub use error::*;

pub use graph::*;

pub use message::*;

pub use permission::*;

pub use plan::*;

pub use provider::*;

pub use task::*;

pub use tool::*;

Modules

confidence

Response confidence extraction (CISC heuristics) — used by SEAL learning and validation policies to score model output quality. Response Confidence Extraction

content_source

Content source types for tracking where content originates.

embedding

Embedding provider trait for vector operations. Unified embedding abstraction

error

Framework error types and result aliases. Framework error types

event

Unified event trait and EventEnvelope<E> with trace IDs and sequence numbers. Unified event schema with trace IDs and sequence numbers.

file_context

File chunking + content extraction primitives — FileContextManager, FileContent, FileChunk. Moved from rullama-storage in Phase 9. Native-only (uses tokio::fs). File Context Manager

graph

Knowledge graph types: entities, edges, and trait interfaces. Graph types and traits for knowledge graph abstraction.

lifecycle

Lifecycle hooks for intercepting framework events. Lifecycle Hooks

message

Message, role, and streaming types for AI conversations.

paths

Platform-specific path helpers — PlatformPaths. Moved from rullama-storage in Phase 9.

permission

Permission mode definitions. Permission mode types

plan

Plan metadata, steps, budgets, and serializable plans.

provider

Provider configuration and chat options.

search

Shared search types (SearchResult, ChunkMetadata, DatabaseStats). Shared search types used across the RAG, vector DB, and spectral modules.

task

Task, priority, and agent response types.

tool

Tool definitions, schemas, contexts, and idempotency.

vector_store

Vector store trait for similarity search. Vector store abstraction

workflow_state

Persistent workflow state for crash-safe agent retry.

working_set

Working set for file context management with LRU eviction. Working Set for File Context Management