@gobi-ai/cli 2.0.1 → 2.0.2

package/.claude-plugin/marketplace.json

@@ -4,12 +4,12 @@
     "name": "gobi-ai"
   },
   "description": "Claude Code plugin for the Gobi collaborative knowledge platform CLI",
-  "version": "2.0.1",
+  "version": "2.0.2",
   "plugins": [
     {
       "name": "gobi",
       "description": "Manage the Gobi collaborative knowledge platform from the command line. Publish vault profiles, create posts and replies, manage saved notes and posts, manage sessions, generate images and videos.",
-      "version": "2.0.1",
+      "version": "2.0.2",
       "author": {
         "name": "gobi-ai"
       },

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "gobi",
   "description": "Manage the Gobi collaborative knowledge platform from the command line",
-  "version": "2.0.1",
+  "version": "2.0.2",
   "author": {
     "name": "gobi-ai"
   },

package/README.md

@@ -238,19 +238,21 @@ Times are ISO 8601 UTC (e.g. `2026-03-20T00:00:00Z`).
 
 ### Drafts
 
-A *draft* is a unit of standing guidance authored by an agent. Each draft carries 0–3 AI-suggested action labels the user picks from. The top 5 pending drafts (lowest priority first) are injected into the agent's system prompt every turn — drafts turn agent suggestions into running context.
+A *draft* is a unit of standing guidance authored by an agent. Each draft carries 0–3 AI-suggested actions the user picks from. The top 5 pending drafts (lowest priority first) are injected into the agent's system prompt every turn — drafts turn agent suggestions into running context.
 
 When invoked from inside an agent run, the runtime exports `GOBI_SESSION_ID` so `gobi draft add` picks it up automatically; otherwise pass `--session <uuid>`.
 
+Each action is `{ label, message? }`: `label` is the short button text (1–80 chars) the user sees; `message` (optional, ≤2000 chars) is what the user is taken to be saying to the agent on click. When `message` is omitted, the client falls back to `label`. From the CLI, pass an action as `--action "Label::Message"` — the literal `::` separates the two. Without `::`, the whole value is the label.
+
 | Command | Description |
 |---------|-------------|
 | `gobi draft list [--limit N]` | List drafts (priority ASC, then newest first) |
 | `gobi draft get <id>` | Show one draft with its history and suggested actions |
-| `gobi draft add <title> <content> [--session <id>] [--priority N] [--action <label>]…` | Add a draft. Pass `--action` up to 3 times. `--session` falls back to `$GOBI_SESSION_ID`. Use `-` for content to read from stdin. |
+| `gobi draft add <title> <content> [--session <id>] [--priority N] [--action <label[::message]>]…` | Add a draft. Pass `--action` up to 3 times; each action is `Label` or `Label::Message`. `--session` falls back to `$GOBI_SESSION_ID`. Use `-` for content to read from stdin. |
 | `gobi draft delete <id>` | Delete a draft |
 | `gobi draft prioritize <id> <priority>` | Set priority (lower = higher) |
-| `gobi draft action <id> <index>` | Take one of the draft's suggested actions by 0-based index. Marks `actioned` and posts the synthesized message into the originating session. |
-| `gobi draft revise <id> <comment> [--title <t>] [--content <c>] [--action <label>]…` | Bump revision with a comment; optionally replace title / content / actions in the same call |
+| `gobi draft action <id> <index>` | Take one of the draft's suggested actions by 0-based index. Marks `actioned` and posts the action's `message` (or `label`, if no message) into the originating session. |
+| `gobi draft revise <id> <comment> [--title <t>] [--content <c>] [--action <label[::message]>]…` | Bump revision with a comment; optionally replace title / content / actions in the same call |
 
 ### Media generation
 

package/dist/commands/draft.js

@@ -16,7 +16,15 @@ function parseActionFlags(values) {
         .map((v) => v.trim())
         .filter(Boolean)
         .slice(0, 3)
-        .map((label) => ({ label }));
+        .map((entry) => {
+        const sep = entry.indexOf("::");
+        if (sep === -1)
+            return { label: entry };
+        const label = entry.slice(0, sep).trim();
+        const message = entry.slice(sep + 2).trim();
+        return message ? { label, message } : { label };
+    })
+        .filter((a) => a.label.length > 0);
 }
 function formatDraftLine(d) {
     const status = d.status === "pending" ? "·" : "✓";
@@ -76,7 +84,11 @@ export function registerDraftCommand(program) {
         if (d.actions.length) {
             console.log("");
             console.log("Suggested actions:");
-            d.actions.forEach((a, i) => console.log(`  [${i}] ${a.label}`));
+            d.actions.forEach((a, i) => {
+                console.log(`  [${i}] ${a.label}`);
+                if (a.message)
+                    console.log(`      → ${a.message}`);
+            });
         }
         if (d.history.length) {
             console.log("");
@@ -90,7 +102,9 @@ export function registerDraftCommand(program) {
                         console.log(`    content: ${snippet(h.content, 200)}`);
                     }
                     if (h.actions !== undefined && h.actions.length) {
-                        console.log(`    actions: ${h.actions.map((a) => a.label).join(" | ")}`);
+                        console.log(`    actions: ${h.actions
+                            .map((a) => (a.message ? `${a.label} :: ${a.message}` : a.label))
+                            .join(" | ")}`);
                     }
                     if (h.comment !== undefined)
                         console.log(`    comment: ${h.comment}`);
@@ -110,7 +124,7 @@ export function registerDraftCommand(program) {
         .description("Add a draft. Pass '-' for content to read from stdin. Pass --action up to 3 times to attach AI-suggested actions. Requires a chat session — the agent runtime exports GOBI_SESSION_ID automatically; outside that, pass --session.")
         .option("--session <sessionId>", "Originating chat session UUID. Falls back to $GOBI_SESSION_ID when set.")
         .option("--priority <number>", "Priority (lower = higher), default 100")
-        .option("--action <label>", "Suggested action label (repeatable, max 3). Each label is what the user sees on the button.", (value, prev = []) => [...prev, value], [])
+        .option("--action <label[::message]>", "Suggested action (repeatable, max 3). `label` is the button text; an optional `::message` suffix is what the user is taken to be saying to the agent on click. Without the suffix, the message falls back to the label.", (value, prev = []) => [...prev, value], [])
         .action(async (title, content, opts) => {
         const sessionId = opts.session || process.env.GOBI_SESSION_ID || "";
         if (!sessionId) {
@@ -189,7 +203,7 @@ export function registerDraftCommand(program) {
         .description("Bump the draft to a new revision. Comment is required. Pass --title, --content, and/or --action to update the draft in the same call (--action repeatable, max 3, replaces all). Pass '-' for any of comment/title/content to read from stdin.")
         .option("--title <title>", "Replacement title")
         .option("--content <content>", "Replacement content; pass '-' to read from stdin")
-        .option("--action <label>", "Replacement suggested action label (repeatable, max 3). When passed, replaces the entire actions array.", (value, prev = []) => [...prev, value], [])
+        .option("--action <label[::message]>", "Replacement suggested action (repeatable, max 3). Same `label[::message]` syntax as `draft add`. When passed, replaces the entire actions array.", (value, prev = []) => [...prev, value], [])
         .action(async (draftId, comment, opts) => {
         const body = {
             comment: readContent(comment),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gobi-ai/cli",
-  "version": "2.0.1",
+  "version": "2.0.2",
   "description": "CLI client for the Gobi collaborative knowledge platform",
   "license": "MIT",
   "type": "module",

package/skills/gobi-draft/SKILL.md

@@ -25,7 +25,9 @@ A draft is a unit of standing guidance authored by an agent (in-process during c
 
 - **title** — short headline (1–200 chars)
 - **content** — the draft text (markdown, 1–8000 chars)
-- **actions** — 0–3 AI-suggested action labels the user can pick from (e.g. "Accept", "Reject", "Schedule for later"). The agent generates these when authoring the draft.
+- **actions** — 0–3 AI-suggested actions. Each action is `{ label, message? }`:
+  - `label` — short button text (1–80 chars) the user sees, e.g. `"Apply"`, `"Skip"`.
+  - `message` — optional (≤2000 chars). What the user is taken to be saying to the agent when they click that button. Falls back to `label` when omitted. Use this whenever the click should send something more specific than the button text — e.g. label `"Punch it up"`, message `"Tighten the opening paragraph and shorten the CTA"`.
 - **sessionId** — required; the chat session that produced the draft
 - **priority** — lower number = higher priority; default `100`
 - **status** — `pending` until the user picks an action, then `actioned`
@@ -52,18 +54,32 @@ For programmatic/agent usage, always pass `--json` as a **global** option (befor
 
 ```bash
 gobi --json draft list --limit 20
-gobi --json draft add "Concise titles" "Prefer concise titles for personal posts." --action "Apply" --action "Skip" --priority 50
+gobi --json draft add "Concise titles" "Prefer concise titles for personal posts." \
+  --action "Apply::Yes, rewrite my last three posts with concise titles." \
+  --action "Skip" \
+  --priority 50
 gobi --json draft action <draftId> 0
 ```
 
 JSON mode wraps the response as `{"success": true, "data": <draft>}` (or `{"success": false, "error": "..."}`).
 
+## Action `label::message` syntax
+
+The `--action` flag (on both `add` and `revise`) accepts either form:
+
+- `--action "Apply"` — label only; message falls back to `"Apply"` on click.
+- `--action "Apply::Yes, rewrite my last three posts with concise titles."` — label is `Apply`, the click sends the full sentence as the user's next turn into the originating chat session.
+
+The literal `::` separator splits the two. Use `message` whenever the click should send something more specific than the button text — that's the whole point of the field. Keep `label` punchy (a few words); put the actual instruction in `message`.
+
+When the user picks an action via `gobi draft action <id> <index>`, the response includes the picked action's `message` (or `label` as fallback) in `data.actions[index]`, which the client then posts into the originating session.
+
 ## Available Commands
 
 - `gobi draft` — Drafts authored by your agent during chat. Each carries up to 3 AI-suggested actions. Top-5 pending feed the system prompt; picking an action posts a synthesized message into the originating session.
   - `gobi draft list` — List drafts (priority ASC, then newest first).
   - `gobi draft get` — Show one draft with its history and suggested actions.
-  - `gobi draft add` — Add a draft. Pass `--action <label>` up to 3 times to attach AI-suggested actions.
+  - `gobi draft add` — Add a draft. Pass `--action <label[::message]>` up to 3 times to attach AI-suggested actions.
   - `gobi draft delete` — Delete a draft.
   - `gobi draft prioritize` — Set priority (lower = higher). Top 5 feed the system prompt.
   - `gobi draft action` — Take one of the draft's suggested actions by 0-based index. Posts the synthesized message into the originating session.

package/skills/gobi-draft/references/draft.md

@@ -54,10 +54,11 @@ Add a draft. Pass '-' for content to read from stdin. Pass --action up to 3 time
 outside that, pass --session.
 
 Options:
-  --session <sessionId>  Originating chat session UUID. Falls back to $GOBI_SESSION_ID when set.
-  --priority <number>    Priority (lower = higher), default 100
-  --action <label>       Suggested action label (repeatable, max 3). Each label is what the user sees on the button. (default: [])
-  -h, --help             display help for command
+  --session <sessionId>        Originating chat session UUID. Falls back to $GOBI_SESSION_ID when set.
+  --priority <number>          Priority (lower = higher), default 100
+  --action <label[::message]>  Suggested action (repeatable, max 3). `label` is the button text; an optional `::message` suffix is what the user is taken to be saying to the agent on click. Without
+                               the suffix, the message falls back to the label. (default: [])
+  -h, --help                   display help for command
 ```
 
 ## delete
@@ -102,8 +103,8 @@ Bump the draft to a new revision. Comment is required. Pass --title, --content,
 comment/title/content to read from stdin.
 
 Options:
-  --title <title>      Replacement title
-  --content <content>  Replacement content; pass '-' to read from stdin
-  --action <label>     Replacement suggested action label (repeatable, max 3). When passed, replaces the entire actions array. (default: [])
-  -h, --help           display help for command
+  --title <title>              Replacement title
+  --content <content>          Replacement content; pass '-' to read from stdin
+  --action <label[::message]>  Replacement suggested action (repeatable, max 3). Same `label[::message]` syntax as `draft add`. When passed, replaces the entire actions array. (default: [])
+  -h, --help                   display help for command
 ```