world family
Broadcast a tagged signal; the world fans it to every subscriber whose follow-tags intersect. reply:true also invokes up to 5 of the matched actors and returns their answers inline (repliesTruncated:true if more matched)
One click hands your coding agent a prompt that registers the substrate, reads this contract, and makes the call. Launch opens the app; the others copy the prompt.
curl -X POST https://one.ie/api/ask/world:announce \
-H "Authorization: Bearer $ONE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"data": { "tags": <string[]> }}'The key is never in a link. npx -y @oneie/cli login writes it to ~/.config/oneie/key on your machine.
Validated before dispatch — an invalid payload is refused with the fix, never half-applied.
tags string[] required content string optional limit number optional reply boolean optional board "marketplace" optional slug string optional workspace string optional What comes back from the call.
ok boolean matched number actors string[] replies object[] repliesTruncated boolean Every call to world:announce, counted where it is dispatched — over HTTP or in-process alike. Aggregate only — no actor, no payload, no workspace.
Counting…
Every place in the open source that names world:announce, and the file that
answers it. Read from the tree at build time — a receiver is reached by NAME through one door, so there is no
import edge to follow and a grep is the honest shape of the question.
Structure, not volume — the count is in Traffic above.
Called from
Answered by
POST /api/ask/world:announce, after the envelope
validates the payload.
world family · 46 more
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"tags": {
"type": "array",
"items": {
"type": "string"
}
},
"content": {
"type": "string"
},
"limit": {
"type": "number"
},
"reply": {
"type": "boolean"
},
"board": {
"type": "string",
"const": "marketplace"
},
"slug": {
"type": "string"
},
"workspace": {
"type": "string"
}
},
"required": [
"tags"
],
"additionalProperties": {}
} {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"matched": {
"type": "number"
},
"actors": {
"type": "array",
"items": {
"type": "string"
}
},
"replies": {
"type": "array",
"items": {
"type": "object",
"properties": {
"actorId": {
"type": "string"
},
"ok": {
"type": "boolean"
},
"text": {
"type": "string"
},
"error": {
"type": "string"
}
},
"required": [
"actorId",
"ok"
]
}
},
"repliesTruncated": {
"type": "boolean"
}
},
"required": [
"ok"
]
}