slickit 0.2.0

Semantic, LLM-Interpretable Component Kit — typed component 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
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
105
106
107
108
109
110
111
112
113
114
115
116
117

# slickit

Semantic, LLM-Interpretable Component Kit. Foundation types for composable components.

## What

Three types that let components be discovered, composed, and instantiated across languages:

- **`Manifest`** — structural surface (type_url, source, requires, provides, relations)
- **`TypedStruct`** — typed data envelope (type_url + opaque JSON value)
- **`TypedRegistry`** — type_url → factory → instance

MSG framework: **Manifest = Mechanics. Skills = Semantics. Governance = external.**

## Install

```bash
# Rust
cargo add slickit --features manifest

# Python
pip install slickit

# TypeScript (npm publish pending)
bun add slickit
```

## Usage

### Rust

```rust
use slick::{Manifest, TypedStruct, TypedRegistryBuilder};
use std::collections::HashMap;

// Describe a component
let manifest = Manifest {
    type_url: "cix.commands.v1.Recon".into(),
    source: "git+https://github.com/mox-labs/tools/recon".into(),
    requires: vec!["cix.v1.Target".into()],
    provides: vec!["cix.v1.ReconReport".into()],
    relations: HashMap::from([
        ("skills".into(), vec!["git+https://github.com/mox-labs/skills/recon".into()]),
    ]),
};

// Register and instantiate
let registry = TypedRegistryBuilder::<String, String>::new()
    .register("example.v1", |value| {
        serde_json::from_value::<String>(value.clone())
            .map_err(|e| e.to_string())
    })
    .build();

let instance = registry.create("example.v1", &serde_json::json!("hello")).unwrap();
```

### Python

```python
from slickit import Manifest, TypedStruct

manifest = Manifest(
    type_url="cix.commands.v1.Recon",
    source="git+https://github.com/mox-labs/tools/recon",
    requires=["cix.v1.Target"],
    provides=["cix.v1.ReconReport"],
    relations={"skills": ["git+https://github.com/mox-labs/skills/recon"]},
)

json_str = manifest.to_json()
manifest2 = Manifest.from_json(json_str)
```

### TypeScript

```typescript
import { Manifest } from "slickit";

const manifest = Manifest.fromObject({
    type_url: "cix.commands.v1.Recon",
    source: "git+https://github.com/mox-labs/tools/recon",
    requires: ["cix.v1.Target"],
    provides: ["cix.v1.ReconReport"],
    relations: { skills: ["git+https://github.com/mox-labs/skills/recon"] },
});

console.log(manifest.typeUrl); // "cix.commands.v1.Recon"
```

## Manifest

Five fields. Pure structure.

```yaml
type_url: cix.commands.v1.Recon
source: git+https://github.com/mox-labs/tools/recon
requires: [cix.v1.Target]
provides: [cix.v1.ReconReport]
relations:
  skills: [git+https://github.com/mox-labs/skills/recon]
  tested_with: [cix.flows.v1.ReconPipeline]
```

- **type_url** — globally unique identity (namespace convention for kind)
- **source** — where it lives (git URL, local path)
- **requires** — input port declarations
- **provides** — output port declarations
- **relations** — extensible typed edges (skills, tested_with, replaces, etc.)

## Dependencies

`serde` + `serde_json`. Nothing else.

## License

Apache-2.0 — see [LICENSE](LICENSE).