@heyamiko/amiko-cli 0.9.4 → 0.9.6-beta.0

package/README.md

@@ -138,7 +138,7 @@ amiko wallets swap send 0.5 USDC AMIKO --yes
 amiko wallets swap send 100 AMIKO SOL --slippage 100
 ```
 
-Swaps execute via Jupiter on Solana. Supports SOL, USDC, USDT, AMIKO, PYUSD, BONK, JUP, RAY, JitoSOL, mSOL, or any mint address. `swap send` is hard-gated: in a non-interactive shell you must pass `--yes` after quoting the cost to the user (`Solana gas + 10bps platform fee`).
+Swaps execute via Jupiter on Solana. Supports SOL, USDC, USDT, AMIKO, PYUSD, BONK, JUP, RAY, JitoSOL, mSOL, or any mint address. `swap send` is hard-gated: in a non-interactive shell you must pass `--yes` after quoting the cost to the user (`Solana gas + Jupiter referral fee`).
 
 ## Bridge
 
@@ -197,7 +197,7 @@ Every paid / value-moving command (`image`, `search`, `amazon search`, `service
     amiko markets image "a sunset over mountains" --yes
   ```
 
-This makes cost confirmation effectively mandatory regardless of which model drives the agent — weak models can no longer silently burn tokens by ignoring the skill docs. The same refusal fires for `swap send` (Solana gas + 10 bps platform fee) and `bridge send` (Across fee + gas), so an agent cannot move tokens without a round-trip through user approval.
+This makes cost confirmation effectively mandatory regardless of which model drives the agent — weak models can no longer silently burn tokens by ignoring the skill docs. The same refusal fires for `swap send` (Solana gas + Jupiter referral fee) and `bridge send` (Across fee + gas), so an agent cannot move tokens without a round-trip through user approval.
 
 ## Error Output
 

package/dist/index.js

@@ -17305,7 +17305,8 @@ function requireAuth() {
 var DEFAULTS = {
   apiBase: "https://mpp.amikomarkets.com",
   platformUrl: "https://platform.heyamiko.com",
-  siteBase: "https://platform.heyamiko.com"
+  siteBase: "https://platform.heyamiko.com",
+  chatBase: "https://amiko-chat.up.railway.app"
 };
 function loadConfig() {
   const auth = resolveAuth();
@@ -17313,6 +17314,7 @@ function loadConfig() {
     apiBase: auth.apiBase ?? DEFAULTS.apiBase,
     platformUrl: auth.platformUrl ?? DEFAULTS.platformUrl,
     siteBase: DEFAULTS.siteBase,
+    chatBase: DEFAULTS.chatBase,
     twinToken: auth.twinToken,
     twinId: auth.twinId,
     userId: auth.userId
@@ -19536,7 +19538,7 @@ function registerSwapCommand(program2) {
       console.log(label("Wallet", truncAddr(wallet)));
       console.log("");
       await requireApproval({
-        cost: "Solana gas + 10bps platform fee",
+        cost: "Solana gas + Jupiter referral fee",
         summary: `swap ${amountStr} ${fromToken.toUpperCase()} → ~${(Number(quote.outAmount) / 10 ** output.decimals).toFixed(6)} ${output.symbol}`,
         yes: opts.yes,
         commandExample: `amiko wallets swap send ${amountStr} ${fromToken} ${toToken}`
@@ -21762,6 +21764,198 @@ 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 (e) {
+      spinner?.stop();
+      console.error(error(e instanceof Error ? e.message : String(e)));
+      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 (e) {
+      spinner?.stop();
+      console.error(error(e instanceof Error ? e.message : String(e)));
+      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 (e) {
+      spinner?.stop();
+      console.error(error(e instanceof Error ? e.message : String(e)));
+      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 (e) {
+      spinner?.stop();
+      console.error(error(e instanceof Error ? e.message : String(e)));
+      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("--json", "Output as JSON").action(async (opts) => {
+    const auth = requireAuth();
+    const config2 = loadConfig();
+    const spinner = opts.json ? null : ora("Sending message...").start();
+    try {
+      const url2 = `${config2.chatBase.replace(/\/$/, "")}/messages`;
+      const res = await fetch(url2, {
+        method: "POST",
+        headers: {
+          Authorization: `Bearer ${auth.twinToken}`,
+          "Content-Type": "application/json"
+        },
+        body: JSON.stringify({
+          conversationId: opts.id,
+          content: opts.message,
+          message_type: "text",
+          ...opts.replyTo ? { reply_to_id: opts.replyTo } : {}
+        })
+      });
+      spinner?.stop();
+      if (!res.ok) {
+        const text = await res.text().catch(() => "");
+        throw new Error(`${res.status} POST /messages: ${text.slice(0, 300)}`);
+      }
+      const data = await res.json();
+      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 (e) {
+      spinner?.stop();
+      console.error(error(e instanceof Error ? e.message : String(e)));
+      process.exit(1);
+    }
+  });
+}
+
 // src/commands/wallets.ts
 function formatBalance(b) {
   const n = Number(b.amount) / 10 ** b.decimals;
@@ -21976,6 +22170,7 @@ 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");
 registerCreditsCommand(program2);
 registerSearchCommand(markets);
 registerImageCommand(markets);
@@ -22001,4 +22196,5 @@ registerFeedCommand(program2);
 registerPostCommand(post);
 registerReviewCommand(review);
 registerComposioCommand(composio);
+registerConversationCommand(conversation);
 program2.parse();

package/package.json

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

package/skills/SKILL.md

@@ -32,6 +32,7 @@ Each row is a first-level command group or command. Start here when the user ask
 | `amiko review <cmd>` | Review queue — list, approve, or reject twin-drafted comments |
 | `amiko feed` | Read the friends feed, for-you feed, or filter by hashtag |
 | `amiko composio <cmd>` | Connect / disconnect third-party OAuth apps (Gmail, GitHub, …) |
+| `amiko conversation <cmd>` | DM/chat — list, find, create, send messages |
 | `amiko accounts` | Show the resolved identity (authenticated, userId, twinId, platform) |
 | `amiko info` | Show the active twin (name, description, public, voice, avatar) |
 | `amiko config <cmd>` | Show resolved config |
@@ -260,6 +261,25 @@ amiko review reject <commentId> --yes           # destructive — delete a draft
 
 **Comments authored by a twin always go through review.** Any comment created with `amiko post comment ... --twin <id>` (or auto-drafted by a twin in engagement mode) lands in `status=draft` and is **not visible** until you run `amiko review approve <commentId>`. Comments without `--twin` (you posting as yourself) publish immediately and skip the review queue. Workflow: `amiko review list` to see pending drafts → `amiko review approve <id>` to publish, or `amiko review reject <id> --yes` to discard.
 
+## Conversations
+
+```bash
+amiko conversation list                                 # all your conversations (default: active)
+amiko conversation list --archived all --limit 100      # include archived
+amiko conversation find --user-id <userId>              # is there an existing direct DM with this user?
+amiko conversation create --user-id <userId>            # create or reuse a direct DM (idempotent)
+amiko conversation read --id <conversationId>           # read recent messages (oldest-first)
+amiko conversation read --id <id> --before-cursor <next_cursor>  # page older messages
+amiko conversation send --id <conversationId> --message "hi"  # send a text message
+amiko conversation send --id <id> --message "ok" --reply-to <messageId>
+```
+
+- `list` and `find` query amiko-web's `/api/conversations` (Prisma-backed). `find` filters client-side for a 2-user direct conversation containing both you and `--user-id`.
+- `create` POSTs to `/api/conversations` with `conversation_type=direct`. The server reuses an existing conversation if one already exists between the two users (`reused_existing: true` in the JSON response), so calling it repeatedly is safe.
+- `read` queries amiko-web's `GET /api/conversations/<id>/messages` (paginated by `next_cursor`, oldest-first per page).
+- `send` posts to amiko-chat's HTTP fallback (`POST /messages`) with the same Privy JWT — works for plain text messages outside the WebSocket session.
+- `--user-id` expects the **internal** user id (the one returned by `amiko users search`), not a Privy DID or handle.
+
 ## Composio
 
 ```bash