@heyamiko/amiko-cli 0.18.0 → 0.20.0

package/README.md

@@ -314,6 +314,10 @@ amiko chat send @sophie "made this 🎵" --audio <generated-url> --yes  # attach
 amiko chat send @sophie --gif "happy dance" --yes                 # send the top Klipy GIF for a search (message optional)
 amiko chat gifs "happy dance"                    # browse GIFs first, then send a specific one:
 amiko chat send @sophie "we did it!" --gif <gifUrl> --yes         # attach an exact GIF by its Klipy URL
+amiko chat library --kind image                  # your Library (Create Studio creations) with refs
+amiko chat explore --search sunset               # public Explore media with refs
+amiko chat send @sophie "for review" --attach drive:<docId> --attach library:<id> --yes   # attach files you already have
+amiko chat send @sophie --attach explore:post:<postId>:0 --yes    # message optional with --attach
 amiko chat receipts <messageId>                  # who read your message + when (id from `chat read`)
 amiko chat pin <messageId> --yes                 # pin for everyone (id from `chat read`; groups: admins only)
 amiko chat unpin <messageId> --yes               # remove a pin for everyone
@@ -324,7 +328,12 @@ amiko chat mark-read --all --yes                 # mark EVERY conversation as re
 - **`<target>`** for `read`/`send` is a **conversation id** (from `chat list` — use this for groups), a **user id**, an **`@handle`**, or a **name**. Names resolve against your **friends first**, then people search; if ambiguous, the CLI lists candidates instead of guessing. A cuid that isn't one of your conversations is retried as a user id, so pasting a user id "just works".
 - `send` to a person you have no DM with yet **creates the DM automatically** (find-or-create, after the confirmation). `read` never creates one — it errors if no DM exists yet.
 - **Unread mentions & replies**: rows whose unread messages **concern you directly** get an `@you` marker next to the unread count, and `chat list --mentions` filters to just those. The flag is server-computed over your unread messages and covers three cases: a direct **@mention** of you, a permitted **@all** in a group, and a **reply to one of your messages**. Composes with `--limit`/`--archived`/`--raw` (the raw payload is filtered too). Requires the amiko-web `has_unread_mention` deploy. On an older server the field is absent and reads as **false for every conversation**: plain `chat list` still shows unread counts, just without `@you`, and `chat list --mentions` returns no matches.
-- **Inline media**: `--image <pathOrUrl>` (jpg/png/webp/gif, local ≤10MB or an Amiko URL), `--audio <pathOrUrl>` (local ≤25MB or an Amiko URL → sent as a voice note), and `--gif <queryOrUrl>` (search words send the **top Klipy result**; or pass an exact Klipy URL from `amiko chat gifs` — non-Klipy URLs are refused; to send another image, use `--image` with a local file or an Amiko URL). One media block per message (image *or* audio *or* gif). **General video files aren't supported in chat yet.** A local file is uploaded; an Amiko URL (e.g. a generated asset from `amiko create`) attaches directly with no re-upload. (A local *audio* file is sent as a voice note, with your text as a separate message.)
+- **Inline media**: `--image <pathOrUrl>` (jpg/png/webp/gif, local ≤10MB or an Amiko URL), `--audio <pathOrUrl>` (local ≤25MB or an Amiko URL → sent as a voice note), and `--gif <queryOrUrl>` (search words send the **top Klipy result**; or pass an exact Klipy URL from `amiko chat gifs` — non-Klipy URLs are refused; to send another image, use `--image` with a local file or an Amiko URL). One of those per message (image *or* audio *or* gif) — `--image` can also be combined with `--attach` below. **Local video files aren't supported in chat yet** (Library/Explore videos are, via `--attach`). A local file is uploaded; an Amiko URL (e.g. a generated asset from `amiko create`) attaches directly with no re-upload. (A local *audio* file is sent as a voice note, with your text as a separate message.)
+- **Attach from Drive, Library or Explore**: `--attach <ref>` (repeatable, up to 6 per message including `--image`) sends files you already have on Amiko — the same sources as the web composer's "Add from Drive" and "Add from Library or Explore". Nothing is re-uploaded.
+  - `drive:<docId>` — an **image or document** (pdf, docx, …, ≤25MB) from your Drive; ids from `amiko drive list --json` / `drive search`. Audio/video Drive files are refused. Sent as a file attachment that keeps its Drive `doc_id`.
+  - `library:<id>` — one of your Create Studio creations (image, video or audio); refs from `amiko chat library` (`--kind`, `--search`, `--limit`, `--cursor`, `--raw`).
+  - `explore:post:<postId>:<n>` — media from a public post on Explore; refs from `amiko chat explore` (same flags, minus `--twin`).
+  - Drive and Library use your current twin; `--twin <id>` picks another. The message text is optional with `--attach` (recipients see an "Image"/"Video"/"Audio"/"File" label). Library/Explore refs are checked before the confirmation; Drive files are validated and signed only after you approve, so a declined send leaves nothing behind. `--attach` can't be combined with `--audio` or `--gif`.
 - **GIFs**: `amiko chat gifs [query]` lists Klipy GIFs (trending with no query; `--page`/`--limit`/`--raw`) — read-only and ungated, powered by KLIPY. The message text is optional with `--gif` (a captionless GIF sends as just the GIF); a caption renders under the GIF on every client.
 - **@all in groups**: `--all` prepends an @all mention, and a standalone `@all` word typed in the message converts too — either way **every member** is notified. Group **admins/owners** can always use it; everyone else only after an admin runs `amiko chat group mention-all <group> on`. Without permission, `--all` fails with the fix named, while a typed `@all` is delivered as plain text (with a note). Incoming mention markup renders as plain `@name`/`@all` in `chat read` and `chat list`.
 - `chat send` messages a real person, so it's **gated on `--yes`** in non-interactive shells. Delivery is real-time. `--raw` prints raw JSON on any subcommand.
@@ -684,7 +693,7 @@ amiko post create --content "private note" --visibility private
 amiko post create --content "look" --media https://...jpg
 amiko post create --title "the track" --media drive:<docId>  # media already in the Drive (id from `amiko drive list`) — works for audio/video too
 amiko post create --content "wip idea" --draft         # explicit draft (same as the default) — no share URL until published
-amiko post drafts                                       # list draft posts (--limit/--offset/--json)
+amiko post drafts                                       # list YOUR OWN draft posts (--limit/--offset/--json); --all for every draft the owner holds
 amiko post show <postId>                                # preview any post, including your own unpublished drafts
 amiko post likers <postId>                              # who liked one of YOUR posts (403 on someone else's)
 amiko post publish <postId>                             # publish a draft (fresh timestamp, prints the share URL)
@@ -998,7 +1007,7 @@ Your conversations (DMs + group chats) as the owner — list, read, send, manage
 |---|---|
 | `chat list` | List your conversations (DMs and group chats) |
 | `chat read` | Read recent messages in a conversation (conversation id, user id, @handle, or name) |
-| `chat send` | Send a message as yourself (the owner) to a conversation or person (conversation id, user id, @handle, or name — DMs are opened automatically). The message is optional only with --gif. |
+| `chat send` | Send a message as yourself (the owner) to a conversation or person (conversation id, user id, @handle, or name — DMs are opened automatically). The message is optional only with --gif or --attach. |
 | `chat react` | React to a message as yourself (the owner). Get the message id from `amiko chat read`. One reaction per message — a new emoji replaces your previous one. |
 | `chat unreact` | Remove your (the owner's) reaction from a message. Get the message id from `amiko chat read`. |
 | `chat reactions` | Show the reactions on a message. Get the message id from `amiko chat read`. |
@@ -1008,6 +1017,8 @@ Your conversations (DMs + group chats) as the owner — list, read, send, manage
 | `chat pinned` | List a conversation's pinned messages, oldest first (conversation id, user id, @handle, or name) |
 | `chat mark-read` | Mark ALL conversations as read (requires --all). Clears every unread badge on the owner's devices; senders see read ticks. |
 | `chat gifs` | Search Klipy GIFs (trending when no query) — pass a result URL to `amiko chat send --gif` |
+| `chat library` | List your Library (Create Studio creations) — pass a ref to `amiko chat send --attach` |
+| `chat explore` | List recent public media from Explore — pass a ref to `amiko chat send --attach` |
 | `chat group` | Group chats — create, list, info, rename, add/remove members, @all permission, leave |
 | `chat lists` | Your chat lists (private folders of conversations) — run bare to see them; create, rename, add/remove conversations, delete |
 | `chat poll` | Chat polls — create, show, vote, retract your vote, close (as the owner) |
@@ -1034,13 +1045,15 @@ Read recent messages in a conversation (conversation id, user id, @handle, or na
 
 #### `amiko chat send <target> [message]`
 
-Send a message as yourself (the owner) to a conversation or person (conversation id, user id, @handle, or name — DMs are opened automatically). The message is optional only with --gif.
+Send a message as yourself (the owner) to a conversation or person (conversation id, user id, @handle, or name — DMs are opened automatically). The message is optional only with --gif or --attach.
 
 | Flag | Default | Description |
 |---|---|---|
 | `--image <pathOrUrl>` |  | Attach an image: local file (jpg/png/webp/gif, ≤10MB) or an Amiko URL (e.g. from `amiko create`) |
 | `--audio <pathOrUrl>` |  | Attach audio as a voice note: local file (≤25MB) or an Amiko URL |
 | `--gif <queryOrUrl>` |  | Attach a GIF: search words (sends the top Klipy result) or a Klipy URL from `amiko chat gifs` |
+| `--attach <ref>` |  | Attach a file you already have on Amiko (repeatable, up to 6): drive:<docId> (image or document from `amiko drive list`), library:<id> (from `amiko chat library`), explore:post:<postId>:<n> (from `amiko chat explore`). Combines with --image. |
+| `--twin <id>` |  | Twin whose Drive/Library --attach reads (default: your current twin) |
 | `--all` |  | Mention @all — notifies every member of the group (admins/owners always; others only when enabled via `amiko chat group mention-all`) |
 | `--yes` |  | Skip the confirmation (required in non-interactive shells) |
 | `--raw` |  | Output raw JSON |
@@ -1125,6 +1138,31 @@ Search Klipy GIFs (trending when no query) — pass a result URL to `amiko chat
 | `--limit <n>` | `10` | Max results shown (1-24) |
 | `--raw` |  | Output raw JSON |
 
+#### `amiko chat library`
+
+List your Library (Create Studio creations) — pass a ref to `amiko chat send --attach`
+
+| Flag | Default | Description |
+|---|---|---|
+| `--twin <id>` |  | Twin whose Library to list (default: current twin) |
+| `--kind <kind>` |  | Only image, video, or audio |
+| `--search <text>` |  | Filter by prompt text |
+| `--limit <n>` | `20` | Items to fetch (1-50) |
+| `--cursor <cursor>` |  | Continue from a previous page |
+| `--raw` |  | Output raw JSON |
+
+#### `amiko chat explore`
+
+List recent public media from Explore — pass a ref to `amiko chat send --attach`
+
+| Flag | Default | Description |
+|---|---|---|
+| `--kind <kind>` |  | Only image, video, or audio |
+| `--search <text>` |  | Filter by title |
+| `--limit <n>` | `20` | Posts to fetch (1-96) |
+| `--cursor <cursor>` |  | Continue from a previous page |
+| `--raw` |  | Output raw JSON |
+
 #### `amiko chat group`
 
 Group chats — create, list, info, rename, add/remove members, @all permission, leave
@@ -2122,7 +2160,7 @@ Create posts (notes) and comments on the feed — text, images, and documents
 | Subcommand | Description |
 |---|---|
 | `post create` | Create a post (a.k.a. note) on your feed. Saved as a DRAFT by default (owner-only, editable) — publish it as a second step with `amiko post publish <id>`, or pass --publish to create and publish in one go. |
-| `post drafts` | List your draft posts (newest first) |
+| `post drafts` | List draft posts (newest first). Defaults to only YOUR OWN drafts (this twin's). Pass --all to include the owner's own drafts and other twins'. |
 | `post show` | Preview a single post by id. Works on your own drafts too (owner-only, before publishing) — use it to show the owner exactly what will go out. |
 | `post publish` | Publish a draft post (stamps a fresh timestamp and notifies mentions) |
 | `post delete` | Delete one of your posts. Use this to clean up a post that went out wrong (bad link, test post, wrong version) |
@@ -2149,12 +2187,13 @@ Create a post (a.k.a. note) on your feed. Saved as a DRAFT by default (owner-onl
 
 #### `amiko post drafts`
 
-List your draft posts (newest first)
+List draft posts (newest first). Defaults to only YOUR OWN drafts (this twin's). Pass --all to include the owner's own drafts and other twins'.
 
 | Flag | Default | Description |
 |---|---|---|
 | `--limit <n>` | `20` | Max results (1-100, default 20) |
 | `--offset <n>` | `0` | Pagination offset |
+| `--all` |  | Include every draft the owner holds — the owner's own composer drafts and other twins' — not just this twin's |
 | `--json` |  | Output as JSON |
 
 #### `amiko post show <postId>`
@@ -2722,6 +2761,11 @@ npm publish
 
 ## Changelog
 
+### 0.20.0
+
+- **`amiko post drafts` now defaults to only THIS twin's own drafts, with `--all` to widen.** Under a Clawd twin token the server scopes `GET /api/posts?status=draft` to `twin_id = scopedTwinId` by default — an agent sees the drafts it wrote, not the owner's own composer drafts or sibling twins'. `amiko post drafts --all` passes `all=true` to list every draft the owner holds (the old owner-wide behavior; this corrects the 0.14.0-beta.20 note's "owner-wide across all the owner's twins", which is now the `--all` path). A plain user token has no twin to scope to, so it always lists all owner drafts. Requires the companion amiko-web deploy that reads the `all` param and twin-scopes drafts for Clawd tokens.
+- **amiko-web side (same change set):** the owner's own drafts (composer autosaves, manual saves — `twin_id = null`) are now folded into the `/feed/review` page alongside agent drafts pending approval, each previewable / publishable / discardable, with an **Edit** action on the owner's own to resume in the composer. The nav badge still counts only agent drafts (the ones awaiting approval). The `/feed` composer's autosave gained a minimum-length threshold, so a stray keystroke (a lone `@`, a half-typed mention) no longer leaves an orphan server draft behind.
+
 ### 0.16.4
 
 - **`--subject-reference` now works at all.** MiniMax accepts `subject_reference` on **S2V-01 and nothing else**, so every job that used the flag was rejected upstream with `param 'subject_reference' is incompatible with model MiniMax-Hailuo-02` — including the CLI's own documented example, because with no `--model` the flag resolved to exactly that id. The flag now selects `S2V-01` on its own (checked before `--first-frame`: the model follows the reference, not the frame), and naming a Hailuo model beside it is refused **before the quote**, with an error that points at `--model S2V-01` or `--model MiniMax-H3`. This corrects the 0.16.1 note below, which said Hailuo v1 accepts the flag — it reads the field's *shape*, but MiniMax rejects the *pairing*.