From f60f36e6b132a024dd9ff642d778f7b65a0fa842 Mon Sep 17 00:00:00 2001 From: Will Pfleger Date: Mon, 18 May 2026 19:37:12 -0400 Subject: [PATCH] fix(nest): update skill content for CLI parity changes Sync SKILL.md descriptions with post-review CLI output shapes: canvas get returns markdown string or null (not event array), reactions get returns grouped {emoji, count, pubkeys} (not raw events), users get always returns array, workflows get documents normalized shape, workflows runs notes empty-result limitation. Quick reference table updated. --- .../src-tauri/src/managed_agents/nest_skill.md | 16 +++++++++------- 1 file changed, 9 insertions(+), 7 deletions(-) diff --git a/desktop/src-tauri/src/managed_agents/nest_skill.md b/desktop/src-tauri/src/managed_agents/nest_skill.md index a230c51da8..0c1425ea2f 100644 --- a/desktop/src-tauri/src/managed_agents/nest_skill.md +++ b/desktop/src-tauri/src/managed_agents/nest_skill.md @@ -154,7 +154,7 @@ sprout channels delete --channel ## Canvas -Get the canvas document for a channel (returns a JSON array of kind:40100 events; the canvas markdown is in the `content` field of the first element): +Get the canvas document for a channel (returns the markdown content string directly, or `null` if no canvas is set): ```bash sprout canvas get --channel @@ -187,7 +187,7 @@ Get all reactions on an event: sprout reactions get --event ``` -Returns a JSON array of raw kind:7 reaction events. Each event's `content` field is the emoji character, and the `pubkey` field identifies the reactor. +Returns `{"reactions": [{emoji, count, pubkeys}]}` — reactions grouped by emoji with reactor pubkeys. Empty content on a reaction is normalized to `"+"`. ## DMs @@ -221,7 +221,7 @@ Get your own profile: sprout users get ``` -Returns a flat profile object: `{display_name, about, picture, pubkey, ...}`. +Returns `[{display_name, about, picture, pubkey, ...}]` — always an array, even for a single profile lookup. Get a specific user's profile: @@ -281,6 +281,8 @@ Get a specific workflow definition: sprout workflows get --workflow ``` +Returns `{workflow_id, content, created_at, pubkey}`, or `null` if not found. + Create a workflow (YAML definition inline or via stdin): ```bash @@ -309,7 +311,7 @@ Get run history for a workflow: sprout workflows runs --workflow ``` -Returns `[{event_id, kind, content, created_at, tags}]`. +Returns `[{event_id, kind, content, created_at, tags}]`. Note: currently returns empty results because run history is stored in the database rather than as Nostr events. ## Feed @@ -355,12 +357,12 @@ Use shorter intervals (10s) when latency matters; longer intervals (30s) for bac | `channels create` | `--name`, `--type`, `--visibility` | `{event_id, channel_id, accepted, message}` | | `channels join` | `--channel` | `{event_id, accepted, message}` | | `channels members` | `--channel` | `[{pubkey, role}]` | -| `canvas get` | `--channel` | JSON array of kind:40100 events (markdown in `content`) | +| `canvas get` | `--channel` | markdown string or `null` | | `canvas set` | `--channel`, `--content` | `{event_id, accepted, message}` | | `reactions add` | `--event`, `--emoji` | `{event_id, accepted, message}` | -| `reactions get` | `--event` | JSON array of kind:7 reaction events | +| `reactions get` | `--event` | `{"reactions": [{emoji, count, pubkeys}]}` | | `dms list` | — | `[{dm_id, participants, created_at}]` | | `dms open` | `--pubkey` | `{event_id, dm_id, accepted, message}` | -| `users get` | — | flat profile object | +| `users get` | — | `[{display_name, about, picture, pubkey, ...}]` | | `workflows list` | `--channel` | `[{workflow_id, content, created_at}]` | | `feed get` | — | array of feed events, newest-first |