cel-context 0.1.3

Portable context snapshots for AI agents. Normalize any stream into reusable elements and point-in-time snapshots.
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

# cel-context

Portable context snapshots for AI agents.

`cel-context` gives any stream a common shape an agent can consume. Browser DOM,
accessibility trees, logs, traces, metrics, tickets, database rows, app events,
OCR, and domain APIs can all emit `ContextElement`s and merge into one
`ScreenContext`.

Despite the historical name, `ScreenContext` is not limited to screens. Treat it
as a point-in-time operating context: the facts an agent should know before it
plans, answers, or acts.

## What's Included

- `ContextElement` — one source-derived fact: UI control, log line, metric, alert, ticket, row, or event.
- `ScreenContext` — one point-in-time snapshot of normalized context elements.
- `ContextSource` — source labels such as external stream, accessibility, CDP, native API, OCR, vision, merged.
- `ContentRole` — prompt-injection-aware classification.
- `ContextReference` — resilient targeting data that survives ephemeral IDs.
- `ContextContribution` / `ContextMerger` — generic source contribution merge mechanics.

## Out Of Scope

- Capturing live desktop, browser, OCR, vision, network, log, trace, metric, ticket, or database streams.
- Deciding freshness, anomaly, prioritization, or policy rules over time.
- Dispatching actions back into an app or browser.
- Hosting dashboards, audit timelines, or compliance exports.

Those responsibilities belong in whichever runtime, adapter, or product embeds
the snapshot contract.

## Example

```sh
cargo run -p cel-context --example context_snapshot -- --json
```

The example constructs a snapshot from caller-provided stream facts. Any source
that can produce `ContextElement`s can participate.

## Minimal Element

```rust
use cel_context::{ContentRole, ContextElement, ContextSource};
use std::collections::HashMap;

let element = ContextElement {
    id: "incident:metric:error_rate".into(),
    label: Some("Checkout error rate is above threshold".into()),
    description: None,
    element_type: "metric".into(),
    value: Some("7.2%".into()),
    bounds: None,
    state: Default::default(),
    parent_id: None,
    actions: vec![],
    confidence: 0.88,
    source: ContextSource::External,
    content_role: ContentRole::Content,
    properties: HashMap::new(),
};
```

## License

Apache-2.0