@indexnetwork/cli 0.7.0 → 0.8.1

package/README.md

@@ -2,20 +2,29 @@
 
 Command-line interface for [Index Network](https://index.network). Chat with the AI agent, manage signals, and discover opportunities — all from your terminal.
 
-> **Status: v0.5.0**
-> Supports `login`, `chat`, `profile`, `intent` (signal management), `opportunity`, and `network` commands.
+## Installation
+
+```bash
+npm install -g @indexnetwork/cli
+```
 
 ## Quick Start
 
 ```bash
-# Build the binary
-bun run build
-
 # Authenticate (opens browser)
-./dist/index login
+index login
+
+# Chat with the AI agent (interactive REPL)
+index conversation
 
-# Start chatting
-./dist/index conversation
+# One-shot message
+index conversation "What opportunities do I have?"
+
+# Browse your signals
+index intent list
+
+# Review pending opportunities
+index opportunity list
 ```
 
 ## Commands
@@ -40,19 +49,6 @@ Clear stored credentials.
 index logout
 ```
 
-### `index intent`
-
-Manage your signals (intents). Create signals from natural language, list active signals, view details, and archive signals you no longer need.
-
-```bash
-index intent list                           # List active signals
-index intent list --archived                # Include archived signals
-index intent list --limit 5                 # Limit to 5 results
-index intent show <id>                      # Show full signal details
-index intent create "Looking for a CTO"     # Create from natural language
-index intent archive <id>                   # Archive a signal
-```
-
 ### `index conversation`
 
 Unified conversation command for AI agent chat and human-to-human messaging. Supports streaming responses, inline markdown formatting, tool call indicators, and special blocks (signal proposals, opportunities).
@@ -79,6 +75,19 @@ index profile show <user-id>        # Show another user's profile
 index profile sync                  # Regenerate your profile
 ```
 
+### `index intent`
+
+Manage your signals (intents). Create signals from natural language, list active signals, view details, and archive signals you no longer need.
+
+```bash
+index intent list                           # List active signals
+index intent list --archived                # Include archived signals
+index intent list --limit 5                 # Limit to 5 results
+index intent show <id>                      # Show full signal details
+index intent create "Looking for a CTO"     # Create from natural language
+index intent archive <id>                   # Archive a signal
+```
+
 ### `index opportunity`
 
 Browse and manage discovered opportunities.
@@ -94,8 +103,6 @@ index opportunity reject <id>              # Reject an opportunity
 
 Status values: `pending`, `accepted`, `rejected`, `expired`.
 
-The `show` command displays a detailed card with parties (including valency roles: Helper, Seeker, Peer), reasoning, confidence, and presentation text.
-
 ### `index network`
 
 Manage networks (communities). List, create, join, leave, and invite members.
@@ -110,15 +117,14 @@ index network leave <id>               # Leave a network
 index network invite <id> user@email   # Invite a user by email
 ```
 
-
 ## Options
 
 | Flag | Short | Description |
 |------|-------|-------------|
-| `--api-url <url>` | | Override API server (default: `http://localhost:3000`) |
+| `--api-url <url>` | | Override API server (default: `https://protocol.index.network`) |
+| `--app-url <url>` | | Override app URL for login (default: `https://index.network`) |
 | `--token <token>` | `-t` | Provide bearer token directly |
 | `--session <id>` | `-s` | Resume a specific chat session |
-| `--list` | `-l` | List chat sessions |
 | `--archived` | | Include archived signals (intent list) |
 | `--status <status>` | | Filter opportunities by status |
 | `--limit <n>` | | Limit number of results |
@@ -130,34 +136,44 @@ index network invite <id> user@email   # Invite a user by email
 
 ```bash
 # Run directly with Bun (no build step)
-bun src/main.ts chat
+bun src/main.ts conversation
+
+# Build for all platforms
+bun run build
 
-# Build a standalone binary
-bun run build        # outputs to dist/index
+# Build for current platform only (fast dev builds)
+bun scripts/build.ts --current
 
 # Run tests
 bun test
+
+# Dry-run publish
+bun scripts/publish.ts --dry-run
 ```
 
 ### Project Structure
 
 ```
 cli/
+  bin/
+    index.cjs                  Bin shim (resolves platform binary or JS fallback)
+  npm/
+    {os}-{arch}/               Platform-specific packages with precompiled binaries
+  scripts/
+    build.ts                   Cross-compilation build script
+    publish.ts                 npm publish orchestration
   src/
-    main.ts                  Entry point, command routing
-    login.command.ts         OAuth flow with local callback server
-    conversation.command.ts  H2A agent chat + H2H messaging + SSE stream parser
-    network.command.ts       Network subcommand handlers
-    output.ts                Terminal formatting, colors, markdown renderer
-    api.client.ts            Typed HTTP client for the protocol API
-    auth.store.ts            Credential persistence (~/.index/credentials.json)
-    args.parser.ts           CLI argument parser (Bun-native parseArgs)
-    sse.parser.ts            Server-Sent Events parser
+    main.ts                    Entry point, command routing
+    login.command.ts           OAuth flow with local callback server
+    conversation.command.ts    H2A agent chat + H2H messaging + SSE stream parser
+    profile.command.ts         Profile subcommand handlers
+    intent.command.ts          Intent (signal) subcommand handlers
+    opportunity.command.ts     Opportunity subcommand handlers
+    network.command.ts         Network subcommand handlers
+    output/                    Terminal formatting, colors, markdown renderer
+    api.client.ts              Typed HTTP client for the protocol API
+    auth.store.ts              Credential persistence (~/.index/credentials.json)
+    args.parser.ts             CLI argument parser
+    sse.parser.ts              Server-Sent Events parser
+    types.ts                   Shared type definitions
 ```
-
-## Roadmap
-
-Commands planned for future iterations:
-
-- ~~`index network` — Manage indexes and memberships~~ (shipped!)
-- ~~`index conversation` — H2H and A2A messaging~~ (shipped!)

package/dist/index.js

@@ -265,7 +265,10 @@ class ApiClient {
   async listNetworks() {
     const res = await this.get("/api/indexes");
     const body = await res.json();
-    return body.indexes;
+    return body.indexes.map((n) => ({
+      ...n,
+      joinPolicy: n.joinPolicy ?? n.permissions?.joinPolicy
+    }));
   }
   async createNetwork(title, prompt) {
     const res = await this.post("/api/indexes", {
@@ -278,7 +281,8 @@ class ApiClient {
   async getNetwork(id) {
     const res = await this.get(`/api/indexes/${id}`);
     const body = await res.json();
-    return body.index;
+    const n = body.index;
+    return { ...n, joinPolicy: n.joinPolicy ?? n.permissions?.joinPolicy };
   }
   async getNetworkMembers(id) {
     const res = await this.get(`/api/indexes/${id}/members`);
@@ -937,13 +941,15 @@ function intentTable(intents) {
     dim("  No signals found.");
     return;
   }
-  const descWidth = 50;
+  const idWidth = 8;
+  const descWidth = 44;
   const statusWidth = 10;
   const sourceWidth = 16;
   const dateWidth = 20;
-  console.log(`  ${BOLD}${"Signal".padEnd(descWidth)}  ${"Status".padEnd(statusWidth)}  ${"Source".padEnd(sourceWidth)}  ${"Created".padEnd(dateWidth)}${RESET}`);
-  console.log(`  ${GRAY}${"-".repeat(descWidth)}  ${"-".repeat(statusWidth)}  ${"-".repeat(sourceWidth)}  ${"-".repeat(dateWidth)}${RESET}`);
+  console.log(`  ${BOLD}${"ID".padEnd(idWidth)}  ${"Signal".padEnd(descWidth)}  ${"Status".padEnd(statusWidth)}  ${"Source".padEnd(sourceWidth)}  ${"Created".padEnd(dateWidth)}${RESET}`);
+  console.log(`  ${GRAY}${"-".repeat(idWidth)}  ${"-".repeat(descWidth)}  ${"-".repeat(statusWidth)}  ${"-".repeat(sourceWidth)}  ${"-".repeat(dateWidth)}${RESET}`);
   for (const intent of intents) {
+    const shortId = intent.id.slice(0, 8);
     const desc = (intent.summary ?? intent.payload).slice(0, descWidth);
     const status2 = (intent.status ?? "").padEnd(statusWidth);
     const source = (intent.sourceType ?? "-").padEnd(sourceWidth);
@@ -953,7 +959,7 @@ function intentTable(intents) {
       day: "numeric"
     });
     const sColor = intent.status === "ACTIVE" ? GREEN : GRAY;
-    console.log(`  ${desc.padEnd(descWidth)}  ${sColor}${status2}${RESET}  ${GRAY}${source}${RESET}  ${GRAY}${date}${RESET}`);
+    console.log(`  ${CYAN}${shortId}${RESET}  ${desc.padEnd(descWidth)}  ${sColor}${status2}${RESET}  ${GRAY}${source}${RESET}  ${GRAY}${date}${RESET}`);
   }
 }
 function intentCard(intent) {
@@ -1020,26 +1026,30 @@ function opportunityTable(opportunities) {
     dim("  No opportunities found.");
     return;
   }
-  const nameW = 24;
-  const catW = 20;
+  const idW = 8;
+  const nameW = 20;
+  const catW = 18;
   const statusW = 10;
   const confW = 8;
   const dateW = 20;
-  process.stdout.write(`  ${BOLD}${"Counterparty".padEnd(nameW)}  ${"Category".padEnd(catW)}  ${"Status".padEnd(statusW)}  ${"Conf".padEnd(confW)}  ${"Created".padEnd(dateW)}${RESET}
+  process.stdout.write(`  ${BOLD}${"ID".padEnd(idW)}  ${"Counterparty".padEnd(nameW)}  ${"Category".padEnd(catW)}  ${"Status".padEnd(statusW)}  ${"Conf".padEnd(confW)}  ${"Created".padEnd(dateW)}${RESET}
 `);
-  process.stdout.write(`  ${GRAY}${"-".repeat(nameW)}  ${"-".repeat(catW)}  ${"-".repeat(statusW)}  ${"-".repeat(confW)}  ${"-".repeat(dateW)}${RESET}
+  process.stdout.write(`  ${GRAY}${"-".repeat(idW)}  ${"-".repeat(nameW)}  ${"-".repeat(catW)}  ${"-".repeat(statusW)}  ${"-".repeat(confW)}  ${"-".repeat(dateW)}${RESET}
 `);
   for (const opp of opportunities) {
-    const name = (opp.counterpartName ?? "Unknown").slice(0, nameW);
+    const shortId = opp.id.slice(0, 8);
+    const fallbackName = opp.actors?.[1]?.name ?? opp.actors?.find((a) => a.name)?.name;
+    const name = (opp.counterpartName ?? fallbackName ?? "Unknown").slice(0, nameW);
     const category = (opp.interpretation?.category ?? "-").slice(0, catW);
     const st = opp.status.slice(0, statusW);
-    const conf = opp.interpretation?.confidence != null ? `${opp.interpretation.confidence}%` : "-";
+    const rawConf = opp.interpretation?.confidence;
+    const conf = rawConf != null ? `${Math.round(rawConf <= 1 ? rawConf * 100 : rawConf)}%` : "-";
     const date = opp.createdAt ? new Date(opp.createdAt).toLocaleDateString("en-US", {
       year: "numeric",
       month: "short",
       day: "numeric"
     }) : "-";
-    process.stdout.write(`  ${name.padEnd(nameW)}  ${GRAY}${category.padEnd(catW)}${RESET}  ${statusColor(st)}${st.padEnd(statusW)}${RESET}  ${GRAY}${conf.padEnd(confW)}${RESET}  ${GRAY}${date.padEnd(dateW)}${RESET}
+    process.stdout.write(`  ${CYAN}${shortId}${RESET}  ${name.padEnd(nameW)}  ${GRAY}${category.padEnd(catW)}${RESET}  ${statusColor(st)}${st.padEnd(statusW)}${RESET}  ${GRAY}${conf.padEnd(confW)}${RESET}  ${GRAY}${date.padEnd(dateW)}${RESET}
 `);
   }
 }
@@ -1128,14 +1138,16 @@ function networkTable(networks) {
     dim("  No networks found.");
     return;
   }
-  const titleW = 30;
+  const keyW = 24;
+  const titleW = 26;
   const membersW = 8;
   const roleW = 10;
   const policyW = 12;
   const dateW = 18;
-  console.log(`  ${BOLD}${"Title".padEnd(titleW)}  ${"Members".padEnd(membersW)}  ${"Role".padEnd(roleW)}  ${"Join Policy".padEnd(policyW)}  ${"Created".padEnd(dateW)}${RESET}`);
-  console.log(`  ${GRAY}${"-".repeat(titleW)}  ${"-".repeat(membersW)}  ${"-".repeat(roleW)}  ${"-".repeat(policyW)}  ${"-".repeat(dateW)}${RESET}`);
+  console.log(`  ${BOLD}${"Key".padEnd(keyW)}  ${"Title".padEnd(titleW)}  ${"Members".padEnd(membersW)}  ${"Role".padEnd(roleW)}  ${"Join Policy".padEnd(policyW)}  ${"Created".padEnd(dateW)}${RESET}`);
+  console.log(`  ${GRAY}${"-".repeat(keyW)}  ${"-".repeat(titleW)}  ${"-".repeat(membersW)}  ${"-".repeat(roleW)}  ${"-".repeat(policyW)}  ${"-".repeat(dateW)}${RESET}`);
   for (const n of networks) {
+    const key = (n.key ?? n.id.slice(0, 8)).slice(0, keyW);
     const title = n.title.slice(0, titleW);
     const members = String(n.memberCount ?? "-");
     const role = n.role ?? "member";
@@ -1145,13 +1157,16 @@ function networkTable(networks) {
       month: "short",
       day: "numeric"
     }) : "-";
-    console.log(`  ${title.padEnd(titleW)}  ${members.padEnd(membersW)}  ${role.padEnd(roleW)}  ${policy.padEnd(policyW)}  ${GRAY}${date}${RESET}`);
+    console.log(`  ${CYAN}${key.padEnd(keyW)}${RESET}  ${title.padEnd(titleW)}  ${members.padEnd(membersW)}  ${role.padEnd(roleW)}  ${policy.padEnd(policyW)}  ${GRAY}${date}${RESET}`);
   }
 }
 function networkCard(network) {
   console.log();
   console.log(`  ${BOLD}${network.title}${RESET}`);
   console.log(`  ${GRAY}${"─".repeat(40)}${RESET}`);
+  if (network.key) {
+    console.log(`  ${GRAY}Key:${RESET}         ${CYAN}${network.key}${RESET}`);
+  }
   console.log(`  ${GRAY}ID:${RESET}          ${network.id}`);
   if (network.prompt) {
     console.log(`  ${GRAY}Prompt:${RESET}      ${network.prompt}`);
@@ -1191,19 +1206,20 @@ function conversationTable(conversations) {
     dim("  No conversations found.");
     return;
   }
-  const idWidth = 36;
-  const participantsWidth = 40;
+  const idWidth = 8;
+  const participantsWidth = 46;
   const dateWidth = 20;
   console.log(`  ${BOLD}${"ID".padEnd(idWidth)}  ${"Participants".padEnd(participantsWidth)}  ${"Created".padEnd(dateWidth)}${RESET}`);
   console.log(`  ${GRAY}${"-".repeat(idWidth)}  ${"-".repeat(participantsWidth)}  ${"-".repeat(dateWidth)}${RESET}`);
   for (const c of conversations) {
+    const shortId = c.id.slice(0, 8);
     const names = c.participants.map((p) => p.user?.name ?? p.participantId).join(", ").slice(0, participantsWidth);
     const date = new Date(c.createdAt).toLocaleDateString("en-US", {
       year: "numeric",
       month: "short",
       day: "numeric"
     });
-    console.log(`  ${GRAY}${c.id.padEnd(idWidth)}${RESET}  ${names.padEnd(participantsWidth)}  ${GRAY}${date}${RESET}`);
+    console.log(`  ${CYAN}${shortId}${RESET}  ${names.padEnd(participantsWidth)}  ${GRAY}${date}${RESET}`);
   }
 }
 function conversationCard(conversation) {
@@ -1283,9 +1299,9 @@ async function profileSync(client) {
 var INTENT_HELP = `
 Usage:
   index intent list [--archived] [--limit <n>]  List your signals
-  index intent show <id>                        Show signal details
+  index intent show <id>                        Show signal details (accepts short ID)
   index intent create <content>                 Create a signal from text
-  index intent archive <id>                     Archive a signal
+  index intent archive <id>                     Archive a signal (accepts short ID)
 `;
 async function handleIntent(client, subcommand, options) {
   if (!subcommand) {
@@ -1347,9 +1363,9 @@ Usage:
   index opportunity list                List your opportunities
   index opportunity list --status <s>   Filter by status (pending|accepted|rejected|expired)
   index opportunity list --limit <n>    Limit results
-  index opportunity show <id>           Show full opportunity details
-  index opportunity accept <id>         Accept an opportunity
-  index opportunity reject <id>         Reject an opportunity
+  index opportunity show <id>           Show full opportunity details (accepts short ID)
+  index opportunity accept <id>         Accept an opportunity (accepts short ID)
+  index opportunity reject <id>         Reject an opportunity (accepts short ID)
 `;
 async function handleOpportunity(client, subcommand, options) {
   if (!subcommand) {
@@ -1408,10 +1424,10 @@ Network Commands:
   index network list                     List your networks
   index network create <name>            Create a new network
   index network create <name> --prompt   Create with a description
-  index network show <id>                Show network details and members
-  index network join <id>                Join a public network
-  index network leave <id>               Leave a network
-  index network invite <id> <email>      Invite a user by email
+  index network show <id|key>            Show network details and members
+  index network join <id|key>            Join a public network
+  index network leave <id|key>           Leave a network
+  index network invite <id|key> <email>  Invite a user by email
 `;
 async function handleNetwork(client, subcommand, positionals, options) {
   if (!subcommand) {
@@ -1455,6 +1471,9 @@ async function networkCreate(client, name, prompt) {
   }
   const network = await client.createNetwork(name, prompt);
   success(`Network created: ${network.title}`);
+  if (network.key) {
+    dim(`  Key: ${network.key}`);
+  }
   dim(`  ID: ${network.id}`);
   dim(`  Join Policy: ${(network.joinPolicy ?? "invite_only").replace("_", " ")}`);
 }
@@ -1621,10 +1640,10 @@ Conversation Commands:
   index conversation --session <id>        Resume a specific chat session
   index conversation sessions              List AI chat sessions
   index conversation list                  List all conversations (H2A + H2H)
-  index conversation with <user-id>        Open or resume a DM with a user
-  index conversation show <id>             Show messages in a conversation
+  index conversation with <user-id|key>    Open or resume a DM with a user
+  index conversation show <id>             Show messages (accepts short ID)
   index conversation show <id> --limit <n> Limit number of messages
-  index conversation send <id> <message>   Send a message
+  index conversation send <id> <message>   Send a message (accepts short ID)
   index conversation stream                Listen for real-time events (SSE)
 `;
 async function handleConversation(client, subcommand, positionals, options) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indexnetwork/cli",
-  "version": "0.7.0",
+  "version": "0.8.1",
   "description": "Command-line interface for Index Network",
   "license": "MIT",
   "type": "module",
@@ -9,7 +9,8 @@
   },
   "files": [
     "bin/",
-    "dist/"
+    "dist/",
+    "README.md"
   ],
   "scripts": {
     "dev": "bun src/main.ts",
@@ -19,10 +20,10 @@
     "publish:all": "bun scripts/publish.ts"
   },
   "optionalDependencies": {
-    "@indexnetwork/cli-linux-x64": "0.7.0",
-    "@indexnetwork/cli-linux-arm64": "0.7.0",
-    "@indexnetwork/cli-darwin-x64": "0.7.0",
-    "@indexnetwork/cli-darwin-arm64": "0.7.0"
+    "@indexnetwork/cli-linux-x64": "0.8.1",
+    "@indexnetwork/cli-linux-arm64": "0.8.1",
+    "@indexnetwork/cli-darwin-x64": "0.8.1",
+    "@indexnetwork/cli-darwin-arm64": "0.8.1"
   },
   "devDependencies": {
     "@types/bun": "latest"