u-foo 3.0.15 → 3.0.16

package/OPTIONAL_SKILLS/ufoo-bus-poll/SKILL.md

@@ -0,0 +1,60 @@
+---
+name: ufoo-bus-poll
+description: >-
+  Stream pending ufoo bus messages through a resident background task for an
+  MCP-registered or externally provisioned agent whose host cannot receive
+  automatic ufoo prompt injection. Use only with a host that forwards streaming
+  background-task output into the agent session; do not use for Codex CLI,
+  Claude Code CLI, Agy, Kimi, or native ucode.
+---
+
+# ufoo bus poll
+
+Attach one provisioned external subscriber to a host-managed background stream.
+Keep the stream queue-read-only so the agent controls acknowledgement.
+
+## Attach the registered subscriber
+
+1. Reuse the exact subscriber returned by MCP `register_agent` or supplied by
+   the host. Never create a second identity for the stream, call bare
+   `ufoo bus join`, guess an agent type, or borrow another workspace subscriber.
+2. Start exactly one streaming background task for that subscriber:
+
+   ```bash
+   ufoo bus poll "<subscriber-id>" --follow --interval 2
+   ```
+
+3. Keep the command owned by the host's streaming background-task facility.
+   Do not use `nohup`, shell `&`, or an OS-detached daemon; those routes can
+   write output somewhere the agent never receives.
+
+The command rejects a second resident poll for the same subscriber. It emits
+the current pending batch, waits for that batch to be acknowledged, then emits
+the next batch. It never acknowledges, claims, injects, or clears messages.
+
+## Handle stream batches
+
+For every `[ufoo]<from:...>` event:
+
+1. Read `Content.message` and execute actionable work.
+2. After handling the emitted batch, run the exact acknowledgement command
+   printed by the stream:
+
+   ```bash
+   ufoo bus ack "<subscriber-id>" --through <seq>
+   ```
+
+   Preserve `--through`; it keeps later messages pending.
+3. Reply only with a requested result, answer, blocker, or fact the sender
+   needs:
+
+   ```bash
+   ufoo bus send "<sender-id>" "<substantive result>"
+   ```
+
+Do not reply to greetings, thanks, or acknowledgement-only messages. After
+sending, continue the current task; do not start another poll, sleep, or wait.
+The resident stream delivers follow-up output.
+
+If the host cannot forward incremental output from a still-running task, stop
+this workflow and use an explicitly invoked `$ufoo-bus` inbox check instead.

package/OPTIONAL_SKILLS/ufoo-bus-poll/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "ufoo bus poll"
+  short_description: "Stream ufoo bus messages for non-injectable agents"
+  default_prompt: "Use $ufoo-bus-poll to attach this MCP-registered agent to its resident ufoo bus stream."

package/README.md

@@ -209,11 +209,12 @@ queue-read-only bus stream:
 
 ```bash
 ufoo skills list --optional
-ufoo skills install ubus-poll --target /path/to/that/agent/skills
-ufoo bus poll "$UFOO_SUBSCRIBER_ID" --follow --interval 2
+ufoo skills install ufoo-bus-poll --target /path/to/that/agent/skills
+ufoo bus poll "<subscriber-id>" --follow --interval 2
 ```
 
-Run the final command through that host's streaming background-task facility.
+Use the subscriber returned by MCP `register_agent` or provisioned by the host,
+then run the final command through that host's streaming background-task facility.
 It prints newly observed pending events but never claims or acknowledges them;
 the agent runs the printed `ufoo bus ack --through <seq>` command only after
 handling the emitted batch, preserving later arrivals. The fallback is not

package/README.zh-CN.md

@@ -202,11 +202,12 @@ bus 消息流：
 
 ```bash
 ufoo skills list --optional
-ufoo skills install ubus-poll --target /path/to/that/agent/skills
-ufoo bus poll "$UFOO_SUBSCRIBER_ID" --follow --interval 2
+ufoo skills install ufoo-bus-poll --target /path/to/that/agent/skills
+ufoo bus poll "<subscriber-id>" --follow --interval 2
 ```
 
-最后一条命令必须由该 host 的流式后台任务能力托管。它只输出新观察到的
+使用 MCP `register_agent` 返回或由 host 预配的 subscriber，并由该 host 的
+流式后台任务能力托管最后一条命令。它只输出新观察到的
 pending event，不 claim、不 ack；Agent 处理完输出批次后，再执行输出中
 给出的 `ufoo bus ack --through <seq>`，以保留稍后到达的消息。
 这个 fallback 不会被 postinstall 或 `skills install all` 安装，而且

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "u-foo",
-  "version": "3.0.15",
+  "version": "3.0.16",
   "description": "Multi-Agent Workspace Protocol. Just add u. claude → uclaude, codex → ucodex.",
   "license": "SEE LICENSE IN LICENSE",
   "homepage": "https://ufoo.dev",

package/OPTIONAL_SKILLS/ubus-poll/SKILL.md

@@ -1,76 +0,0 @@
----
-name: ubus-poll
-description: |
-  Explicitly start a resident ufoo bus stream in an agent host that has been
-  configured to deliver streaming background-task output. Install by name only.
----
-
-# /ubus-poll - Resident Bus Stream
-
-This is an opt-in session-start skill. Run it only in a host where a human has
-configured this fallback. Do not install or invoke it for Codex CLI, Claude
-Code CLI, Agy, Kimi, or native ucode; those runtimes already have their own
-ufoo delivery path.
-
-## Start once per agent session
-
-Reuse the provisioned subscriber identity. Never create a second identity just
-for the poll process.
-
-```bash
-SUBSCRIBER="${UFOO_SUBSCRIBER_ID:-}"
-test -n "$SUBSCRIBER" || {
-  echo "ubus-poll requires a provisioned UFOO_SUBSCRIBER_ID"
-  exit 1
-}
-```
-
-Identity provisioning is a host/human setup step. Do not guess an agent type,
-call bare `ufoo bus join`, or borrow the workspace's current subscriber.
-
-Use the agent host's **streaming background-task** facility to start:
-
-```bash
-ufoo bus poll "$SUBSCRIBER" --follow --interval 2
-```
-
-The command must remain owned by that facility. Do not use `nohup`, shell `&`,
-or an OS-detached daemon: those routes can put output in a log that never
-reaches the agent. The command rejects a second resident poll for the same
-subscriber.
-
-The poll is deliberately queue-read-only. It emits current pending events at
-startup, waits for that batch to be acknowledged, then emits the next pending
-batch. It does not ack, claim, inject, or clear messages itself.
-
-## When background output arrives
-
-For every `[ufoo]<from:...>` event:
-
-1. Read `Content.message` and execute actionable work.
-2. After handling the emitted batch, run the exact `ack --through <seq>`
-   command printed by the poll stream. For example:
-
-   ```bash
-   ufoo bus ack "$SUBSCRIBER" --through 42
-   ```
-
-   `--through` preserves any later message that was not in the displayed batch.
-
-3. Reply to the sender only for a requested result, an answer, or information
-   they need to continue:
-
-   ```bash
-   ufoo bus send "<sender-id>" "<substantive result>"
-   ```
-
-Ack-only messages, greetings, and thanks need no reply.
-
-After sending, do not poll, sleep, or wait for a reply. Keep working; this
-resident stream will emit any follow-up.
-
-## Host requirement
-
-This flow works only when the agent host forwards incremental output from a
-still-running background task into the agent session. If it only returns output
-after process exit, use an explicitly invoked `/ubus` instead.