harmos-guest 0.1.8

Harmos guest kit for WebAssembly component plugins.
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

package harmos:guest@1.0.0;

interface capabilities {
    /// A carrier refusal: its code beside the encoded Harmos failure it
    /// carries unchanged across the component boundary.
    record refusal {
        code: string,
        failure: list<u8>,
    }

    /// One consumer-owned declaration registered before initialization.
    record registration {
        namespace: string,
        schema: u32,
        payload: list<u8>,
    }
}

/// The host resolves child calls against the original finite attempt or
/// initialized plugin generation, retaining admission and settlement authority.
interface operation-context {
    use capabilities.{refusal};
    child: async func(call: list<u8>) -> result<list<u8>, refusal>;
}

/// SDK lifecycle and ordinary operations share the original retained table.
world plugin {
    import operation-context;
    use capabilities.{registration, refusal as operation-refusal};
    /// Read-only metadata collection; never prepares lifecycle resources.
    export register: func() -> result<list<registration>, string>;
    export operate: async func(owner: string, command: list<u8>) -> result<list<u8>, operation-refusal>;
}