@heyamiko/amiko-cli 0.10.1-beta.3 → 0.10.1-beta.4

package/README.md

@@ -1,4 +1,4 @@
-# @heyamiko/amiko-cli (v0.10.1-beta.3)
+# @heyamiko/amiko-cli (v0.10.1-beta.4)
 
 Manage wallets, credits, swaps, MPP marketplace services, and your Amiko twin (identity, documents, voice, avatar, friends, feed, Composio apps) from the terminal. Works for both human users and AI agents running on OpenClaw.
 
@@ -393,6 +393,10 @@ npm publish
 
 ## Changelog
 
+### 0.10.1-beta.4
+
+- **`amiko conversation` removed (breaking).** DMs / chat history are now served by the openhermit gateway's built-in `session_list` / `session_read` tools (unified view across the agent's local sessions and platform DMs), so the CLI no longer needs `conversation list / find / create / read / send`. `src/commands/conversation.ts` deleted; index registration + command group removed; SKILL.md frontmatter and Conversations section rewritten to route DM questions to the gateway tools and the remaining notifications-only block renamed `## Notifications`. Skill description and command-groups paragraph updated; the "did anyone DM me?" example row dropped from the cold-start examples table. Update any scripts that ran `amiko conversation` — there is no shim, the command returns "unknown command".
+
 ### 0.10.1-beta.3
 
 - **`amiko drive` namespace** replaces `amiko docs` (kept as a `.alias("docs")` so existing scripts and agents keep working). Tracks the [Amiko Drive API](https://github.com/HCF-STUDIOS/amiko-platform/blob/main/amiko-web/docs/api/drive.md): files live under twin-scoped folders, every upload kicks off async RAG parsing, and search hits parsed content once processing completes. Commands:

package/dist/index.js

@@ -30951,187 +30951,6 @@ function registerComposioCommand(program2) {
   });
 }
 
-// src/commands/conversation.ts
-function describeConversation(c, selfUserId) {
-  if (c.title)
-    return c.title;
-  const others = c.participants?.filter((p) => !(p.participant_type === "user" && p.participant_id === selfUserId)) ?? [];
-  return others.map((p) => p.name ?? p.participant_id).join(", ") || c.id;
-}
-function findDirectWithUser(list, selfUserId, otherUserId) {
-  return list.find((c) => {
-    if (c.conversation_type !== "direct")
-      return false;
-    const ps = c.participants ?? [];
-    const userIds = ps.filter((p) => p.participant_type === "user" && !p.left_at).map((p) => p.participant_id);
-    if (userIds.length !== 2)
-      return false;
-    if (selfUserId && !userIds.includes(selfUserId))
-      return false;
-    return userIds.includes(otherUserId);
-  });
-}
-function registerConversationCommand(program2) {
-  program2.command("list").description("List your conversations").option("--archived <state>", "active | archived | all", "active").option("--limit <n>", "Max results (1–100)", "50").option("--offset <n>", "Pagination offset", "0").option("--json", "Output as JSON").action(async (opts) => {
-    const auth = resolveAuth();
-    const config2 = loadConfig();
-    const spinner = opts.json ? null : ora("Loading conversations...").start();
-    try {
-      const data = await amikoWebFetch(auth, "/api/conversations", {
-        query: {
-          archived: opts.archived,
-          limit: opts.limit,
-          offset: opts.offset
-        }
-      });
-      spinner?.stop();
-      renderOutput(data, (d) => {
-        if (!d.conversations.length) {
-          console.log(dim("No conversations."));
-          return;
-        }
-        console.log(heading(`Conversations — ${d.conversations.length} of ${d.pagination.total}`));
-        for (const c of d.conversations) {
-          console.log("");
-          console.log(label("ID", c.id));
-          console.log(label("With", describeConversation(c, config2.userId)));
-          console.log(label("Type", c.conversation_type));
-          if (c.last_activity_at)
-            console.log(label("Last activity", c.last_activity_at));
-          if (c.unread_count)
-            console.log(label("Unread", String(c.unread_count)));
-        }
-        if (d.pagination.has_more) {
-          console.log("");
-          console.log(dim(`More available — pass --offset ${Number(opts.offset ?? 0) + d.conversations.length}`));
-        }
-      }, { json: opts.json });
-    } catch (e5) {
-      spinner?.stop();
-      console.error(error(e5 instanceof Error ? e5.message : String(e5)));
-      process.exit(1);
-    }
-  });
-  program2.command("find").description("Find an existing direct conversation with a user").requiredOption("--user-id <id>", "Internal user id of the other party").option("--json", "Output as JSON").action(async (opts) => {
-    const auth = resolveAuth();
-    const config2 = loadConfig();
-    const spinner = opts.json ? null : ora("Searching...").start();
-    try {
-      const data = await amikoWebFetch(auth, "/api/conversations", { query: { archived: "all", limit: 100 } });
-      spinner?.stop();
-      const match = findDirectWithUser(data.conversations, config2.userId, opts.userId);
-      if (opts.json) {
-        console.log(JSON.stringify({ conversation: match ?? null }, null, 2));
-        return;
-      }
-      if (!match) {
-        console.log(dim(`No direct conversation with user ${opts.userId}. Run \`amiko conversation create --user-id ${opts.userId}\` to start one.`));
-        return;
-      }
-      console.log(success("Found conversation"));
-      console.log(label("ID", match.id));
-      console.log(label("With", describeConversation(match, config2.userId)));
-      if (match.last_activity_at)
-        console.log(label("Last activity", match.last_activity_at));
-    } catch (e5) {
-      spinner?.stop();
-      console.error(error(e5 instanceof Error ? e5.message : String(e5)));
-      process.exit(1);
-    }
-  });
-  program2.command("create").description("Create (or reuse) a direct conversation with another user").requiredOption("--user-id <id>", "Internal user id of the other party").option("--json", "Output as JSON").action(async (opts) => {
-    const auth = resolveAuth();
-    const spinner = opts.json ? null : ora("Creating conversation...").start();
-    try {
-      const data = await amikoWebFetch(auth, "/api/conversations", {
-        method: "POST",
-        body: {
-          participant_ids: [opts.userId],
-          participant_types: ["user"],
-          conversation_type: "direct"
-        }
-      });
-      spinner?.stop();
-      if (opts.json) {
-        console.log(JSON.stringify(data, null, 2));
-        return;
-      }
-      console.log(success(data.reused_existing ? "Reused existing conversation" : "Conversation created"));
-      console.log(label("ID", data.conversation.id));
-    } catch (e5) {
-      spinner?.stop();
-      console.error(error(e5 instanceof Error ? e5.message : String(e5)));
-      process.exit(1);
-    }
-  });
-  program2.command("read").description("Read messages from a conversation (oldest-first, paginated)").requiredOption("--id <conversationId>", "Target conversation id").option("--limit <n>", "Max messages (1–100)", "50").option("--before-cursor <cursor>", "Page back via next_cursor from a prior call").option("--json", "Output as JSON").action(async (opts) => {
-    const auth = resolveAuth();
-    const spinner = opts.json ? null : ora("Loading messages...").start();
-    try {
-      const data = await amikoWebFetch(auth, `/api/conversations/${encodeURIComponent(opts.id)}/messages`, {
-        query: {
-          limit: opts.limit,
-          before_cursor: opts.beforeCursor
-        }
-      });
-      spinner?.stop();
-      if (opts.json) {
-        console.log(JSON.stringify(data, null, 2));
-        return;
-      }
-      if (!data.messages.length) {
-        console.log(dim("No messages."));
-        return;
-      }
-      console.log(heading(`Messages — ${data.messages.length}`));
-      for (const m of data.messages) {
-        console.log("");
-        console.log(label(m.name ?? m.sender_id ?? "?", m.created_at?.slice(0, 19) ?? ""));
-        if (m.content)
-          console.log(m.content);
-        if (m.message_type && m.message_type !== "text")
-          console.log(dim(`[${m.message_type}]`));
-        console.log(dim(`id: ${m.id}`));
-      }
-      if (data.has_more && data.next_cursor) {
-        console.log("");
-        console.log(dim(`Older messages available — pass --before-cursor ${data.next_cursor}`));
-      }
-    } catch (e5) {
-      spinner?.stop();
-      console.error(error(e5 instanceof Error ? e5.message : String(e5)));
-      process.exit(1);
-    }
-  });
-  program2.command("send").description("Send a message into a conversation").requiredOption("--id <conversationId>", "Target conversation id").requiredOption("--message <text>", "Message body").option("--reply-to <messageId>", "Reply to a specific message").option("--as-agent", "Send as the twin agent (sender_type=agent, is_auto_reply=true). Twin must be a participant.").option("--json", "Output as JSON").action(async (opts) => {
-    const auth = requireAuth();
-    const spinner = opts.json ? null : ora("Sending message...").start();
-    try {
-      const data = await amikoWebFetch(auth, `/api/conversations/${encodeURIComponent(opts.id)}/messages`, {
-        method: "POST",
-        body: {
-          content: opts.message,
-          message_type: "text",
-          ...opts.replyTo ? { reply_to_id: opts.replyTo } : {},
-          ...opts.asAgent ? { as_agent: true } : {}
-        }
-      });
-      spinner?.stop();
-      if (opts.json) {
-        console.log(JSON.stringify(data, null, 2));
-        return;
-      }
-      console.log(success("Message sent"));
-      if (data.message?.id)
-        console.log(label("Message ID", data.message.id));
-    } catch (e5) {
-      spinner?.stop();
-      console.error(error(e5 instanceof Error ? e5.message : String(e5)));
-      process.exit(1);
-    }
-  });
-}
-
 // src/commands/notifications.ts
 function registerNotificationsCommand(program2) {
   program2.command("list").description("List platform notifications (friend requests, system alerts, activity)").option("--limit <n>", "Max results (1–100)", "20").option("--cursor <iso>", "Page older items via next_cursor from a prior call").option("--unread", "Show only unread").option("--json", "Output as JSON").action(async (opts) => {
@@ -31804,7 +31623,6 @@ var users = program2.command("users").description("Search users and view public
 var post = program2.command("post").description("Create posts and comments on the feed");
 var review = program2.command("review").description("Review queue — list, approve, or reject twin-drafted comments");
 var composio = program2.command("composio").description("Manage Composio app connections");
-var conversation = program2.command("conversation").description("Conversations — list, find, create, send messages between users/agents");
 var notifications = program2.command("notifications").description("Platform notifications — list, mark as read");
 registerCreditsCommand(program2);
 registerSearchCommand(markets);
@@ -31831,7 +31649,6 @@ registerFeedCommand(program2);
 registerPostCommand(post);
 registerReviewCommand(review);
 registerComposioCommand(composio);
-registerConversationCommand(conversation);
 registerNotificationsCommand(notifications);
 registerMemoryCommand(program2);
 program2.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heyamiko/amiko-cli",
-  "version": "0.10.1-beta.3",
+  "version": "0.10.1-beta.4",
   "description": "Amiko CLI — swap tokens, manage credits, bridge cross-chain, and call marketplace agents",
   "type": "module",
   "bin": {

package/skills/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: amiko-cli
-description: The Amiko CLI lets an agent act on the Amiko platform end-to-end — read and send platform DMs with other users (conversations list/find/read/send, the right tool when the owner asks "did X message me?" or "check my chat history with Y" — NOT the built-in sessions_list/sessions_history, which only see the agent's own local sessions), read platform notifications (friend requests, mentions, system alerts), search and write **cross-agent memories** about the owner (what other agents already know — preferences, decisions, facts), manage Solana/Base wallets (create, swap via Jupiter, bridge USDC via Across, transfer tokens to external addresses), top up and spend credits, call paid MPP marketplace services (X/Twitter search, image generation, Amazon product search, TTS/STT, AI chat, SFX/music), manage the twin's identity and RAG documents, voice and avatar, social graph (friends, posts, comments, feed), and Composio OAuth connections. Auth is automatic when run from the agent's workspace folder; payments are platform-custodied (no keys on disk). Use this skill whenever the user asks about their Amiko inbox/DMs/notifications or to do anything that would show up in their Amiko account or cost AMIKO/credits.
+description: The Amiko CLI lets an agent act on the Amiko platform end-to-end — read platform notifications (friend requests, mentions, system alerts), search and write **cross-agent memories** about the owner (what other agents already know — preferences, decisions, facts), manage Solana/Base wallets (create, swap via Jupiter, bridge USDC via Across, transfer tokens to external addresses), top up and spend credits, call paid MPP marketplace services (X/Twitter search, image generation, Amazon product search, TTS/STT, AI chat, SFX/music), manage the twin's identity and drive (files, folders, RAG), voice and avatar, social graph (friends, posts, comments, feed), and Composio OAuth connections. Auth is automatic when run from the agent's workspace folder; payments are platform-custodied (no keys on disk). DMs / chat sessions are NOT in this CLI — use the openhermit gateway's built-in session_list / session_read tools for both local sessions and platform DMs. Use this skill whenever the user asks about their Amiko notifications, drive, memory, social graph, wallets, credits, or marketplace services — anything that would show up in their Amiko account or cost AMIKO/credits.
 homepage: https://platform.heyamiko.com
 metadata: {"openclaw":{"emoji":"🤖","requires":{"bins":["node"]}}}
 ---
@@ -20,7 +20,6 @@ Call your shell tool (your runtime calls it `bash`, `shell`, `run`, or similar)
 | "what's my balance?" | shell → `amiko credits balance` |
 | "top up 10k credits with AMIKO" | shell → `amiko credits topup 10000 --token AMIKO --yes` |
 | "swap 1 SOL to USDC" | shell → `amiko wallets swap quote 1 SOL USDC` (then send with `--yes` after approval) |
-| "did anyone DM me?" | shell → `amiko conversation list` |
 | "any notifications?" | shell → `amiko notifications list --unread` |
 | "any new posts I haven't seen?" | shell → `amiko feed --unread` |
 | "upload report.pdf to my drive" | shell → `amiko drive upload ./report.pdf` |
@@ -39,7 +38,9 @@ The CLI is installed globally and is pre-authenticated when you're inside your w
 
 ## Command groups
 
-Discover everything via `amiko --help`. Groups: `markets` (paid MPP services), `wallets`, `credits`, `twin`, `drive` (files / folders / RAG; `docs` is an alias), `voice`, `avatar`, `friends`, `users`, `post`, `review`, `feed`, `composio`, `conversation`, `notifications`, `memory`, plus the top-level `accounts`, `info`, `config`, `update`. All twin-scoped commands accept `--twin <id>`. Most commands support `--json`.
+Discover everything via `amiko --help`. Groups: `markets` (paid MPP services), `wallets`, `credits`, `twin`, `drive` (files / folders / RAG; `docs` is an alias), `voice`, `avatar`, `friends`, `users`, `post`, `review`, `feed`, `composio`, `notifications`, `memory`, plus the top-level `accounts`, `info`, `config`, `update`. All twin-scoped commands accept `--twin <id>`. Most commands support `--json`.
+
+> **DMs / chat sessions are NOT in this CLI.** Use the openhermit gateway's built-in `session_list` / `session_read` tools for both the agent's local sessions and platform DMs with other users. The previous `amiko conversation` namespace was removed in 0.10.1-beta.4.
 
 ## Critical Rules
 
@@ -117,18 +118,13 @@ Workflow: start with `friends matches --limit 20 --json`; narrow with `--dimensi
 
 **Comments authored by a twin always go through review.** Any comment created with `amiko post comment ... --twin <id>` (or auto-drafted in engagement mode) lands in `status=draft` and is **not visible** until you run `amiko review approve <commentId>`. Comments without `--twin` (the owner posting) publish immediately. Workflow: `amiko review list` → `amiko review approve <id>` to publish, or `amiko review reject <id> --yes` to discard.
 
-## Conversations & Notifications
+## Notifications
 
-> **Default platform = Amiko.** When the owner asks about messages/DMs/chats/notifications **without naming a platform**, assume Amiko and answer with `amiko conversation` / `amiko notifications`. Do **not** ask "which platform?". Only ask if they explicitly mention a non-Amiko channel.
+> **Default platform = Amiko.** When the owner asks about notifications **without naming a platform**, assume Amiko and answer with `amiko notifications`. Only ask if they explicitly mention a non-Amiko channel.
 >
-> **For chat history with another person** ("did X message me?", "check my chat with Y"), use `amiko conversation`. Do **NOT** use built-in `sessions_list` / `sessions_history` — those read the agent's *own* local sessions with the owner, not platform DMs with third parties, and will return nothing useful. Typical flow: `amiko users search "<name>"` → `amiko conversation find --user-id <id>` → `amiko conversation read --id <conversationId>`.
-
-Behavior notes:
-- `conversation find` filters client-side for a 2-user direct conversation containing both you and `--user-id`.
-- `conversation create` is idempotent — server reuses an existing direct DM (`reused_existing: true`).
-- `--user-id` expects the **internal** user id (from `amiko users search`), not a Privy DID or handle.
-- `conversation send --as-agent` sends as the twin (`sender_type=agent`).
-- Platform notifications cover friend requests, mentions, system alerts, and post-related events. They don't replace `conversation read` for actual chat content.
+> **DMs / chat history are handled by the openhermit gateway**, not the CLI. For "did X message me?" / "check my chat with Y", use the built-in `session_list` / `session_read` tools — they cover both the agent's local sessions and platform DMs in the unified gateway view.
+
+Platform notifications cover friend requests, mentions, system alerts, and post-related events.
 
 ## Memory (cross-agent) — READ THIS BEFORE ANSWERING ANYTHING ABOUT THE OWNER