ergo-adapter 0.1.0-alpha.1

Kernel adapter surface for manifests, event binding, composition checks, and capture helpers in Ergo
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

//! manifest.rs — Adapter manifest types
//!
//! Purpose:
//! - Defines the `AdapterManifest` and related structures that
//!   represent a validated adapter contract: context keys, event
//!   kinds, action accepts, and effect schemas.
//!
//! Owns:
//! - Canonical serde shapes for adapter YAML parsing
//! - `NO_ADAPTER_PROVENANCE` sentinel for fixture sessions

use serde::{Deserialize, Serialize};

#[derive(Debug, Clone, Deserialize, Serialize)]
pub struct AdapterManifest {
    pub kind: String,
    pub id: String,
    pub version: String,
    pub runtime_compatibility: String,
    pub context_keys: Vec<ContextKeySpec>,
    pub event_kinds: Vec<EventKindSpec>,
    pub accepts: Option<AcceptsSpec>,
    pub capture: CaptureSpec,
}

#[derive(Debug, Clone, Deserialize, Serialize)]
pub struct ContextKeySpec {
    pub name: String,
    #[serde(rename = "type")]
    pub ty: String,
    pub required: bool,
    pub writable: Option<bool>,
    pub description: Option<String>,
}

#[derive(Debug, Clone, Deserialize, Serialize)]
pub struct EventKindSpec {
    pub name: String,
    pub payload_schema: serde_json::Value,
}

#[derive(Debug, Clone, Deserialize, Serialize)]
pub struct AcceptsSpec {
    pub effects: Vec<EffectSpec>,
}

#[derive(Debug, Clone, Deserialize, Serialize)]
pub struct EffectSpec {
    pub name: String,
    pub payload_schema: serde_json::Value,
}

#[derive(Debug, Clone, Deserialize, Serialize)]
pub struct CaptureSpec {
    pub format_version: String,
    pub fields: Vec<String>,
}