nebula-ai 0.1.18 → 0.1.19

package/README.md

@@ -130,7 +130,7 @@ The same surface is available from the command line:
 
 - `chat` — send a message to an agent (`-a/--agent`, `-t/--task`, `--no-stream`). The old `-c/--channel <task-id>` remains a hidden alias for `--task`. Use `channels message <name> <message>` to write to a Channel.
 - `call` — voice calls. `call start` / `call join <thread>` open the TUI's call screen (`--headless` runs the audio engine with no TUI — the edge-speakerphone mode; `--chat` joins data-only); `call list/status <thread>` inspect calls; `call chat <thread> -m "…"` pipes a one-shot typed message into a live call; `call leave/end <thread>`.
-- `channels` (alias `spaces`) — the Channel board from the command line: `list`, `create`, `join`, `rename`, `delete`, `message`, `tasks`, `files`, `calls`, `call`, `miniapps`/`add-miniapp`/`remove-miniapp`, `model`, `posture`, `appearance`, `agents`/`add-agent`/`remove-agent`, `default-model`, `default-device`, `devices`/`add-device`/`remove-device`, and for named Channels `members`/`invite`/`remove-member`/`member-role`.
+- `channels` (alias `spaces`) — the Channel board from the command line: `list`, `create`, `join`, `rename`, `delete`, `message`, `tasks`, `files`, `calls`, `call`, `miniapps`/`add-miniapp`/`remove-miniapp`, `model`, `appearance`, `agents`/`add-agent`/`remove-agent`, `default-model`, `default-device`, `devices`/`add-device`/`remove-device`, and for named Channels `members`/`invite`/`remove-member`/`member-role`.
 - `tasks` — list, create, get, delete, archive, unarchive, share, update, and read a Task's messages. `tasks create --channel <name>` places a Task in that Channel; omitting it uses Home. `--space` remains an alias. Use `--workspace <slug> chat --resume <task-id>` to open a Task directly in a chosen workspace; `--json tasks status <task-id>` exposes the canonical Task work state for launchers.
 - `agents` — list, create, update, delete, enable/disable, view logs/errors, manage triggers, and attach/detach skills.
 - `user` — profile, account, and platform-side resources.
@@ -158,8 +158,9 @@ Every command supports `--json` for machine-readable output, `-v/--verbose` for
 
 Exit codes: `0` success; `1` error (including a failed chat turn); `3` not
 signed in or session unusable; `4` chat waiting for your decision; `5` a
-message was sent or possibly accepted, but its outcome is unknown. For `5`,
-check `nebula-ai channels messages <id>` before sending again.
+message or other write was sent or possibly accepted, but its outcome is
+unknown. For `5`, check with the matching read command (for a chat,
+`nebula-ai channels messages <id>`) before sending again.
 
 With `--json`, errors are exactly one JSON line on stderr, without ANSI:
 `{"error":{"code":"usage","message":"…"}}`. Codes are `error`, `usage`,
@@ -172,6 +173,85 @@ When `status` is `waiting`, `pending` contains `{kind, title, summary}` (title
 and summary may be null); otherwise `pending` is null. Failed, waiting, and
 incomplete chat results still print on stdout before the corresponding exit.
 
+### Changelog: what a write prints under `--json`
+
+Every CLI command that writes now prints `{ "ok": true }` plus the ids it was
+given or created under `--json`, in place of the server's response body. Run
+the matching read command for the row. `tasks share` and `files share` still
+print their link. A write with no server answer in 30 seconds exits 5 with
+`outcome_unknown`.
+
+The key is `id` when a command has one id, and a snake_case name per id when
+it has more. Without `--json`, each command prints one line built from its
+arguments.
+
+| Command | `--json` before | `--json` now | Text |
+| --- | --- | --- | --- |
+| `agents update <id>` | the agent | `{ "ok": true, "id" }` | `Updated agent: <id>` (it used to print the agent) |
+| `agents enable <id>` | the response body | `{ "ok": true, "id" }` | `Enabled agent: <id>` |
+| `agents disable <id>` | the response body | `{ "ok": true, "id" }` | `Disabled agent: <id>` |
+| `agents delete <id>` | the agent id as a bare string | `{ "ok": true, "id" }` | `Deleted agent: <id>` |
+| `channels message <channel>` | `{ "sent": true, "space" }` | `{ "ok": true }` | `Sent.` |
+| `agents create` | the agent | `{ "ok": true, "id" }` | `Created agent: <name> (<id>)` |
+| `agents skills detach <agent-id> <skill-name>` | the response body | `{ "ok": true, "id" }` | `Detached skill "<skill-name>" from agent <agent-id>` |
+| `tasks create` | the Task | `{ "ok": true, "id" }` | `Started a Task: <id>` |
+| `tasks delete <id>` | the response body | `{ "ok": true, "id" }` | `Deleted Task: <id>` |
+| `tasks archive <id>` | the thread | `{ "ok": true, "id" }` | `Archived Task: <id>` |
+| `tasks unarchive <id>` | the response body | `{ "ok": true, "id" }` | `Unarchived Task: <id>` |
+| `tasks update <id>` | the response body | `{ "ok": true, "id" }` | `Updated Task: <id>` (it used to print the Task) |
+| `user files delete <id>` | the response body | `{ "ok": true, "id" }` | `Deleted file: <id>` |
+| `user update` | the response body | `{ "ok": true }` | `Profile updated.` |
+| `user variables set <name> <value>` | the response body | `{ "ok": true }` | `Variable "<name>" set.` |
+| `user variables create <name> <value>` | the response body | `{ "ok": true, "id" }` | `Variable "<name>" created (<id>).` |
+| `user variables delete <name>` | the response body | `{ "ok": true }` | `Deleted variable: <name>` (the list of agents that used it is gone) |
+| `profile set` | the response body | `{ "ok": true }` | `Profile updated.` |
+| `profile set-email <address>` | the response body | `{ "ok": true }` | unchanged |
+| `profile verify-email <code>` | the response body | `{ "ok": true }` | `Email address updated.` |
+| `user billing auto-topup` with `--enable`, `--disable`, `--threshold` or `--amount` | the settings | `{ "ok": true }` | `Auto top-up updated.` (it used to print the settings) |
+| `user devices start` | the response body | `{ "ok": true }` | `Device started.` |
+| `user devices stop` | the response body | `{ "ok": true }` | `Device stopped.` |
+| `user devices delete` | the response body | `{ "ok": true }` | `Device deleted.` |
+| `user devices rename <name>` | the response body | `{ "ok": true }` | `Device renamed to: <name>` |
+| `user devices visibility <public>` | the response body | `{ "ok": true }` | `Device is visible to the workspace.` or `Device is private.` |
+| `user devices services create <name>` | the response body | `{ "ok": true }` | `Created service: <name>` |
+| `user devices services start <name>` | the response body | `{ "ok": true }` | `Started service: <name>` |
+| `user devices services stop <name>` | the response body | `{ "ok": true }` | `Stopped service: <name>` |
+| `integrations disconnect <provider> [accountId]` | `{ "provider", "accountId" }` | `{ "ok": true, "id" }`, with no `id` when you passed no account | `Disconnected <provider> (<accountId>).`, or `Disconnected <provider>.` with no account |
+| `call start` | the response body, with `thread_id`, `call_id` and the join credential | `{ "ok": true, "thread_id", "call_id" }` | `Call started: <thread_id>` |
+| `call join <task>` | the response body, with the join credential | `{ "ok": true, "thread_id", "call_id" }` | `Joined the call: <thread_id>` |
+| `call end <task>` | the response body | `{ "ok": true, "id" }` | `Call ended.` |
+| `call chat <task>` | `true` | `{ "ok": true, "thread_id", "event_id" }` | `Sent.` |
+| `call leave <task>` | `call_id`, `thread_id`, `left`, `call_ended` | `{ "ok": true, "id" }` | `Left the call.`; a Task with no live Call now exits 1 |
+| `channels create <name>` | the Channel | `{ "ok": true, "id" }` | `Created Channel: <name> (<id>)` (it used to print the slug) |
+| `channels call <channel>` | the response body, with `thread_id`, `call_id` and the join credential | `{ "ok": true, "thread_id", "call_id" }` | `Started a Call in <channel>: <thread_id>` |
+| `channels join <channel>` | `{ "joined" }` | `{ "ok": true }` | `Joined Channel: <channel>` |
+| `channels rename <channel> <new-name>` | `{ "renamed": true }` | `{ "ok": true }` | `Renamed Channel <channel> to <new-name>` |
+| `channels delete <channel>` | `{ "deleted": true }` | `{ "ok": true }` | `Deleted Channel: <channel>` |
+| `channels add-miniapp <channel> <miniapp>` | `{ "added" }` | `{ "ok": true }` | `Added <miniapp> to <channel>` |
+| `channels remove-miniapp <channel> <miniapp>` | `{ "removed" }` | `{ "ok": true }` | `Removed <miniapp> from <channel>` |
+| `channels model <channel> <model>` | `{ "model", "space" }` | `{ "ok": true }` | `Set <channel> to <model>` |
+| `channels appearance <channel>` | `{ "space" }` | `{ "ok": true }` | `Updated <channel>` |
+| `channels add-agent <channel> <agent>` | `{ "added": true }` | `{ "ok": true, "id" }` | `Added agent <agent> to <channel>` |
+| `channels remove-agent <channel> <agent>` | `{ "removed": true }` | `{ "ok": true, "id" }` | `Removed agent <agent> from <channel>` |
+| `channels default-model <channel> <model>` | `{ "model", "space" }` | `{ "ok": true }` | `New Tasks in <channel> will use <model>` |
+| `channels add-device <channel>` | `{ "kind" }` | `{ "ok": true, "id" }` with `--local`, the id of this computer; `{ "ok": true }` for a cloud device | `Added a device to <channel>` |
+| `channels remove-device <channel> <device>` | `{ "removed": true }` | `{ "ok": true, "id" }` | `Removed device <device> from <channel>` |
+| `channels default-device <channel> [device]` | `{ "device" }` | `{ "ok": true, "id" }`, with no `id` when it clears the default | `New Tasks in <channel> will run on <device>` |
+| `channels invite <channel> <member>` | `{ "invited": true }` | `{ "ok": true, "id" }` | `Invited <member> to <channel>` |
+| `channels remove-member <channel> <member>` | `{ "removed": true }` | `{ "ok": true, "id" }` | `Removed <member> from <channel>` |
+| `channels member-role <channel> <member> <role>` | `{ "role" }` | `{ "ok": true, "id" }` | `<member> is now a <role> in <channel>` |
+
+`tasks share` and `user files share` print the server's answer under
+`--json`, as before. Without `--json` they now print the link instead of the whole body.
+
+A create prints the id of the row it made, whoever minted it. `call start`,
+`call join` and `channels call` print the Task and Call ids and never the
+join credential. A cloud device added with `channels add-device` prints no
+id, because the server mints it after the command returns.
+
+The table covers all 53 kernel writes that print the envelope. The two
+floor commands above make 55 kernel writes in total.
+
 
 ## Privacy and telemetry
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nebula-ai",
-  "version": "0.1.18",
+  "version": "0.1.19",
   "description": "CLI/TUI for the nebula.gg AI task orchestration platform",
   "type": "module",
   "bin": {