astrid-capsule 0.8.0

Core runtime management for User-Space Capsules in Astrid OS
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

use std::path::PathBuf;

use async_trait::async_trait;

use super::ExecutionEngine;
use crate::context::CapsuleContext;
use crate::error::CapsuleResult;
use crate::manifest::CapsuleManifest;

/// The simplest engine. Handles universal, non-executable data injected into
/// the OS memory (e.g., static skills, context files, declarative commands).
///
/// Every CompositeCapsule contains a `StaticEngine` by default.
pub(crate) struct StaticEngine {
    _manifest: CapsuleManifest,
    _capsule_dir: PathBuf,
}

impl StaticEngine {
    /// Create a new StaticEngine from a capsule manifest.
    #[must_use]
    pub(crate) fn new(manifest: CapsuleManifest, capsule_dir: PathBuf) -> Self {
        Self {
            _manifest: manifest,
            _capsule_dir: capsule_dir,
        }
    }
}

#[async_trait]
impl ExecutionEngine for StaticEngine {
    async fn load(&mut self, _ctx: &CapsuleContext) -> CapsuleResult<()> {
        // TODO: Read `self.manifest.context_files` and `skills`
        // from `self.capsule_dir` and publish them to the OS Event Bus or LLM Router.

        // For now, loading static files is instantaneous and infallible.
        Ok(())
    }

    async fn unload(&mut self) -> CapsuleResult<()> {
        // Purge the static context from OS memory.
        Ok(())
    }
}