supercode-interchange 0.5.112

Canonical, provider-neutral session interchange primitives for Volter Harness
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
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104

//! The orchestration piece of the ontology (`docs/ONTOLOGY.md` §2.7, `docs/ORCHESTRATOR-IR.md` §2):
//! a harness's operational home as ONE typed value. These are the records the
//! orchestrator loads, steps and saves; a Hermes or OpenClaw home compiles
//! into them and decompiles back (the codecs are ONT-3's). The wire form is
//! the orchestrator IR's canonical JSON: the runtime half is never persisted
//! and is not here.

pub mod access;
pub mod agent;
pub mod channel;
pub mod codec;
pub mod fire;
pub mod job;
pub mod obligation;
pub mod profile;
pub mod route;
pub mod subscription;
pub mod worker;
pub mod workflow;

pub use access::{Access, AccessPolicy};
pub use agent::{
    AgentDecl, Budget, BudgetLimit, BudgetPeriod, Conversation, ConversationKind, Cost,
    HandoffState, HistoryRef, Participant, ParticipantRole, SessionUsage, SpeakerPolicy, Transfer,
    TransferHistory, TransferState, Usage,
};
pub use channel::ChannelConfig;
pub use fire::{Fire, FireStatus};
pub use job::{Job, JobOrigin, Repeat, Schedule, Target};
pub use obligation::{
    Attachment, Obligation, ObligationSource, ObligationState, OutboundContent, Posted,
};
pub use profile::{Orchestration, PersonaRef, Profile, ProfileResidue};
pub use route::{resolve_route, route_specificity, Route, RouteMatch};
pub use subscription::WebhookSubscription;
pub use worker::{
    EnvValue, PermissionDefault, PermissionPolicy, PermissionUnattended, WorkerHome, WorkerSpec,
    WorkerSurface,
};
pub use workflow::{hermes_instance, Workflow};

/// The JSON Schema of the whole orchestration value, with every record it contains
/// as a definition — what `supercode ontology schema` prints and what the
/// TypeScript types are generated from (ONT-6).
pub fn schema() -> schemars::Schema {
    schemars::schema_for!(Orchestration)
}

/// The schema of one record by name, for readers who want a single type.
pub fn schema_for(record: &str) -> Option<schemars::Schema> {
    Some(match record {
        "Orchestration" => schemars::schema_for!(Orchestration),
        "Profile" => schemars::schema_for!(Profile),
        "Binding" => schemars::schema_for!(crate::ontology::Binding),
        "SurfaceKey" => schemars::schema_for!(crate::ontology::SurfaceKey),
        "Job" => schemars::schema_for!(Job),
        "Fire" => schemars::schema_for!(Fire),
        "Obligation" => schemars::schema_for!(Obligation),
        "ChannelConfig" => schemars::schema_for!(ChannelConfig),
        "Route" => schemars::schema_for!(Route),
        "Access" => schemars::schema_for!(Access),
        "WebhookSubscription" => schemars::schema_for!(WebhookSubscription),
        "WorkerSpec" => schemars::schema_for!(WorkerSpec),
        "PersonaRef" => schemars::schema_for!(PersonaRef),
        "SecretRef" => schemars::schema_for!(crate::ontology::SecretRef),
        "AgentDecl" => schemars::schema_for!(AgentDecl),
        "Conversation" => schemars::schema_for!(Conversation),
        "SpeakerPolicy" => schemars::schema_for!(SpeakerPolicy),
        "Transfer" => schemars::schema_for!(Transfer),
        "Handoff" => schemars::schema_for!(agent::Handoff),
        "Usage" => schemars::schema_for!(Usage),
        "Budget" => schemars::schema_for!(Budget),
        "Fidelity" => schemars::schema_for!(crate::ontology::Fidelity),
        "ArtifactFidelity" => schemars::schema_for!(crate::ontology::ArtifactFidelity),
        _ => return None,
    })
}

/// Every name [`schema_for`] answers.
pub const RECORDS: &[&str] = &[
    "Orchestration",
    "Profile",
    "Binding",
    "SurfaceKey",
    "Job",
    "Fire",
    "Obligation",
    "ChannelConfig",
    "Route",
    "Access",
    "WebhookSubscription",
    "WorkerSpec",
    "PersonaRef",
    "SecretRef",
    "AgentDecl",
    "Conversation",
    "SpeakerPolicy",
    "Transfer",
    "Handoff",
    "Usage",
    "Budget",
    "Fidelity",
    "ArtifactFidelity",
];