tinycortex 0.1.1

Rust core for the TinyCortex memory system
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

//! Memory sources — the registry of connectors that feed memory.
//!
//! This domain owns the **"what feeds my memory?"** question: a typed registry
//! of sources (Composio OAuth connections, local folders, GitHub repos, RSS
//! feeds, Twitter queries, web pages, and agent conversations) persisted in
//! `config.toml` under `[[memory_sources]]`.
//!
//! It provides:
//! - [`types`]: the [`MemorySourceEntry`] contract, [`SourceKind`] discriminator,
//!   and reader output types ([`SourceItem`], [`SourceContent`], [`ContentType`]).
//! - [`validation`]: required-field rules per kind and the shared
//!   path-traversal guard for local readers.
//! - [`registry`]: a TOML-backed [`SourceRegistry`] with the
//!   load/modify/validate/save CRUD cycle.
//! - [`readers`]: the [`SourceReader`] trait and the local folder/conversation
//!   reader implementations.
//!
//! ## Ownership boundary
//!
//! Per the engine spec, TinyCortex does **not** own live sync, polling, or
//! OAuth. Network-backed kinds keep their type contracts and validation here,
//! but their live fetchers are host-owned. Only the local kinds — `folder` and
//! `conversation` — ship real readers (see [`readers::reader_for`]). The host's
//! sync runner consumes this registry to decide what to sync and when.

pub mod readers;
pub mod registry;
pub mod types;
pub mod validation;

pub use readers::{is_locally_readable, reader_for, SourceReader};
pub use registry::{memory_sync_defaults_for_toolkit, MemorySourcePatch, SourceRegistry};
pub use types::{ContentType, MemorySourceEntry, SourceContent, SourceItem, SourceKind};
pub use validation::{ensure_within_base, validate_entry};