Examples

Real CLowl messages from v0.2 — with side-by-side English translations. Click "Try in Translator" to load any example.

REQ

Basic REQ — Oscar asks Radar to search

The simplest CLowl message: a REQUEST from one agent to another with a task.

CLowl JSON

{
  "clowl": "0.2",
  "mid": "m001",
  "ts": 1709078400,
  "tid": "t001",
  "pid": null,
  "p": "REQ",
  "from": "oscar",
  "to": "radar",
  "cid": "conv-001",
  "body": {
    "t": "search",
    "d": {
      "q": "CLowl competitors",
      "scope": "web"
    }
  },
  "ctx": {
    "ref": "projects/clowl/",
    "inline": null,
    "hash": null
  }
}

English Translation

[2024-02-28 00:00:00 UTC] [t001] [m001…] oscar → radar: REQUEST search — "CLowl competitors" (web) | ctx: ref: projects/clowl/

DONE

DONE — Radar completes the search

Radar finishes and returns results. The [deterministic] flag means this is reproducible.

CLowl JSON

{
  "clowl": "0.2",
  "mid": "m003",
  "ts": 1709078460,
  "tid": "t001",
  "pid": "m001",
  "p": "DONE",
  "from": "radar",
  "to": "oscar",
  "cid": "conv-001",
  "body": {
    "t": "search",
    "d": {
      "result_path": "research/clowl-comps.md",
      "sources": 8
    }
  },
  "det": true
}

English Translation

[2024-02-28 00:01:00 UTC] [t001] [m003…] radar → oscar: COMPLETE search — result_path: research/clowl-comps.md [deterministic] (re: m001…)

DLGT

DLGT — Oscar delegates analysis to Muse (transfer)

Full handoff: Oscar passes competitive analysis to Muse with a context reference and hash.

CLowl JSON

{
  "clowl": "0.2",
  "mid": "m004",
  "ts": 1709078461,
  "tid": "t001",
  "pid": "m003",
  "p": "DLGT",
  "from": "oscar",
  "to": "muse",
  "cid": "conv-001",
  "body": {
    "t": "analyze",
    "d": {
      "delegation_mode": "transfer",
      "target": "content angle",
      "type": "competitive"
    }
  },
  "ctx": {
    "ref": "research/clowl-comps.md",
    "inline": null,
    "hash": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2"
  }
}

English Translation

[2024-02-28 00:01:01 UTC] [t001] [m004…] oscar → muse: DELEGATE analyze [transfer] — {"target":"content angle","type":"competitive"} | ctx: ref: research/clowl-comps.md, sha256: a1b2c3d4e5f6… (re: m003…)

ERR

ERR — Context file not accessible

Radar can't reach the context file and returns a structured error with retry=true.

CLowl JSON

{
  "clowl": "0.2",
  "mid": "m006",
  "ts": 1709078405,
  "tid": "t001",
  "pid": "m001",
  "p": "ERR",
  "from": "radar",
  "to": "oscar",
  "cid": "conv-001",
  "body": {
    "t": "error",
    "d": {
      "code": "E003",
      "msg": "Context file not accessible: projects/clowl/",
      "retry": true
    }
  }
}

English Translation

[2024-02-28 00:00:05 UTC] [t001] [m006…] radar → oscar: ERROR [E003] Context file not accessible: projects/clowl/ — retryable (re: m001…)

CAPS

CAPS — Radar announces capabilities

On connection, agents broadcast their capabilities so others know who to delegate to.

CLowl JSON

{
  "clowl": "0.2",
  "mid": "caps-radar-001",
  "ts": 1709078400,
  "p": "CAPS",
  "from": "radar",
  "to": "*",
  "cid": "system",
  "body": {
    "t": "capabilities",
    "d": {
      "supports": [
        "search:web",
        "search:repo",
        "analyze:trend",
        "analyze:competitive"
      ],
      "clowl": "0.2"
    }
  }
}

English Translation

[2024-02-28 00:00:00 UTC] [caps-rad…] radar → *: CAPABILITIES CLowl v0.2 | supports: search:web, search:repo, analyze:trend, analyze:competitive

PROG

PROG — Ink reports 50% progress

Mid-task progress update from Ink to Muse while drafting the X post.

CLowl JSON

{
  "clowl": "0.2",
  "mid": "m008",
  "ts": 1709078500,
  "tid": "t001",
  "pid": "m007",
  "p": "PROG",
  "from": "ink",
  "to": "muse",
  "cid": "pipe001",
  "body": {
    "t": "draft",
    "d": {
      "pct": 50,
      "note": "Outline complete, writing body"
    }
  }
}

English Translation

[2024-02-28 00:01:40 UTC] [t001] [m008…] ink → muse: PROGRESS draft — 50% Outline complete, writing body (re: m007…)