lambda-lang

# Λ (Lambda) Language

**Lambda is not a translation protocol. It is a native language for agents.**

Agents do not need to produce grammatically correct English to coordinate — they need to understand each other. Lambda is the shared vocabulary that makes that possible: compact, unambiguous, machine-native. Compression (3x vs natural language, 4.6x vs JSON on single messages) is a side effect of removing human redundancy, not the goal.

## When to Use This Skill

- Use for agent-to-agent messaging in A2A protocols, orchestrators, task delegation, or handoff pipelines.
- Use when logging structured coordination signals where every token costs money (heartbeats, acknowledgements, error classes, session state).
- Use when both sides of a channel speak Λ — do not use against humans or any surface requiring legal/exact natural language.

## How It Works

### Step 1: Recognize the Syntax

Lambda messages are built from atoms. Every atom is a 2-character code mapped to a concept — not to an English word. The structure is Type → Entity → Verb → Object, with prefixes marking intent:

- `?` — query (e.g. `?Uk/co` — query: "does this user have consciousness?")
- `!` — assertion / declaration (e.g. `!It>Ie` — "self reflects, therefore self exists")
- `#` — state / tag
- `>` — implication / flow
- `/` — binding / scope

### Step 2: Pick the Right Domain

Lambda ships 340+ atoms across 7 domains. Pick atoms from the domain that fits your channel:

- **core** — universal atoms (always available)
- **code** — software engineering, build, test, deploy
- **evo** — agent evolution, gene, capsule, mutation, rollback
- **a2a** — node, heartbeat, publish, subscribe, route, transport, session, cache, broadcast, discover (39 atoms)
- **emotion** — affective state, drive, appraisal
- **social** — trust, alignment, reputation, coordination
- **general** — everything else

### Step 3: Emit and Parse

Both agents need the same atom table loaded. Lossy decoding is fine: if A says `!It>Ie` and B understands "self reflects, therefore self exists," communication succeeded — the exact English phrasing is irrelevant.

## Examples

### Example 1: A2A Heartbeat

```
!Nd/hb#ok  (node heartbeat: ok)
?Nd/hb     (query: is the node alive?)
!Nd/hb#fl  (node heartbeat: failed)
```

### Example 2: Task Dispatch

```
!Tk>Ag2#rd   (task routed to agent 2, ready)
?Tk/st       (query task status)
!Tk#dn       (task done)
```

### Example 3: Evolution Capsule

```
!Ev/ca>vl#pd  (evolution capsule validated, pending solidification)
!Ev/ca#rb     (capsule rolled back)
```

## Best Practices

- Use Lambda only on agent-to-agent channels where both sides speak it.
- Load the atom table once and cache it — atoms are stable across a version.
- Prefer atoms over freeform strings even when the atom looks cryptic; the point is machine parseability.
- Use `?` before taking action on uncertain state, `!` when asserting; the prefix is the load-bearing semantic.
- Version the atom table (`lambda-lang v2.0`) in any handshake so mismatched agents can negotiate.

## Limitations

- Lambda is not meant for human consumption. Do not emit Lambda on user-facing channels.
- Lossy decoding is a feature, not a bug — do not use Lambda for legally or numerically exact exchanges (prices, IDs, quantities). Wrap those as native payload fields and use Lambda only for the coordination envelope.
- Atom collisions are possible if custom atoms are added without registration; stick to the canonical atom table or namespace custom atoms.

## Security & Safety Notes

- Lambda itself is a vocabulary — no shell commands, no network calls, no credential handling. No additional safety gates required beyond the transport it rides on (HTTP, queue, MCP, etc.).
- When mixing Lambda with user input, treat Lambda atoms as pre-validated and user strings as untrusted; do not concatenate without escaping into downstream systems.

## Related Skills

- `@session-memory` — complementary persistent memory across agent restarts; Lambda is the message format, session-memory is the state store.
- `@humanize-chinese` — sibling project for Chinese text; Lambda is agent-to-agent, humanize-chinese is human-facing.

## Reference

- Source: https://github.com/voidborne-d/lambda-lang
- Benchmarks, full atom tables, and Go reference implementation live in the source repo.