@indexnetwork/cli 0.28.0 → 0.29.0-rc.88.2

package/README.md

@@ -1,6 +1,6 @@
 # Index CLI
 
-Command-line interface for [Index Network](https://index.network). Message your personal agent, manage signals, and discover opportunities — all from your terminal.
+Command-line interface for [Index Network](https://index.network). Message your personal agent, manage intents, and discover opportunities — all from your terminal.
 
 ## Installation
 
@@ -12,17 +12,17 @@ npm install -g @indexnetwork/cli
 
 Index helps you find the right people—and helps the right people find you—based on what you are actually trying to do, not just a profile headline. The value is grounded intros: suggestions come from communities you share (syndicates, founder groups, firm networks), not from spraying the open web.
 
-The flow below is one complete story—shape a room, invite people, publish an approved signal, let broker agents evaluate in the background, then review a persisted match.
+The flow below is one complete story—create an intent, let agents negotiate in the background, then review a persisted match.
 
 ```bash
 # login + setup
 index login
 index profile
 
-# 1. express intent (signals)
+# 1. express an intent
 index intent create "federated learning collaboration"
 
-# 2. broker agents evaluate approved signals in the background
+# 2. agents negotiate on your intents in the background
 index negotiation list
 
 # 3. wait for persisted opportunities, then review outcomes
@@ -53,16 +53,16 @@ flags are listed in [Options](#options), and examples follow this reference.
 | `index profile show <user-id>` | Show another user's accessible profile. |
 | `index profile sync` | Research public profile information and return a suggested profile without persisting it. |
 | `index profile update` | Save reviewed name, bio, location, or social links. |
-| `index intent list` | List signals, with optional archived, text-query, and result-limit filters. |
-| `index intent show <id>` | Show one signal. |
+| `index intent list` | List intents, with optional archived, text-query, and result-limit filters. |
+| `index intent show <id>` | Show one intent. |
 | `index intent prepare <text>` | Prepare a draft, optionally answering recovery prompts; returns an admission receipt when ready. |
-| `index intent create <text>` | Create a signal, optionally using the preparation receipt. |
-| `index intent update <id> <text>` | Update and reprocess a signal's description. |
-| `index intent archive <id>` | Archive a signal so it stops participating in discovery. |
+| `index intent create <text>` | Create an intent, optionally using the preparation receipt. |
+| `index intent update <id> <text>` | Update and reprocess an intent's description. |
+| `index intent archive <id>` | Archive an intent so it stops participating in discovery. |
 | `index intent pause <id>` / `resume <id>` | Pause or resume its agent without archiving. |
-| `index intent networks <id>` | List the networks a signal is shared in. |
-| `index intent add-to-network <id> <network-id>` | Share a signal in a network. |
-| `index intent remove-from-network <id> <network-id>` | Stop sharing a signal in a network. |
+| `index intent networks <id>` | List the networks an intent is shared in. |
+| `index intent add-to-network <id> <network-id>` | Share an intent in a network. |
+| `index intent remove-from-network <id> <network-id>` | Stop sharing an intent in a network. |
 | `index negotiation list` | List negotiations, optionally filtered by intent or open/settled state. |
 | `index negotiation show <opportunity-id>` | Read the negotiation's turns, current state, and available actions. |
 | `index negotiation turn <opportunity-id> --action <action> --message <text> --expected-turn-count <n>` | Submit one `propose`, `counter`, `accept`, or `decline` turn against the observed turn count. |
@@ -76,7 +76,7 @@ flags are listed in [Options](#options), and examples follow this reference.
 | `index network requests` / `request-update` / `request-dismiss` | Review or revise your early-access creation requests. |
 | `index network create <title>` | Create a network when eligible, or submit an early-access creation request. |
 | `index network show <id>` | Show a network and its members. |
-| `index network update <id> --title <text>` | Change a network's title. |
+| `index network update <id> [--title <text>] [--prompt <text>]` | Change a network's title or description. |
 | `index network delete <id>` | Delete a network you own. |
 | `index network join <id>` | Join an open network. |
 | `index network leave <id>` | Leave a network. |
@@ -89,9 +89,9 @@ flags are listed in [Options](#options), and examples follow this reference.
 | `index conversation stream` | Subscribe to conversation, negotiation, opportunity, and intent events over SSE. |
 | `index conversation help` | Show conversation-specific help. |
 | `index onboarding confirm-profile` | Confirm that the owner has reviewed their profile. |
-| `index onboarding complete` | Complete onboarding once profile confirmation and first-signal prerequisites are met. |
+| `index onboarding complete` | Complete onboarding once profile confirmation and first-intent prerequisites are met. |
 | `index scrape <url>` | Extract text from a URL, optionally guided by an objective. |
-| `index sync` | Read your profile, networks, and signals into `~/.index/context.json`, or stdout with `--json`. |
+| `index sync` | Read your profile, networks, and intents into `~/.index/context.json`, or stdout with `--json`. |
 
 ### `index login`
 
@@ -142,31 +142,31 @@ 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.
+Manage your intents. Create intents from natural language, list active intents, view details, and archive intents you no longer need.
 
 ```bash
-index intent list                           # List active signals
-index intent list --archived                # Include archived signals
+index intent list                           # List active intents
+index intent list --archived                # Include archived intents
 index intent list --limit 5                 # Limit to 5 results
 index intent list --query "CTO"             # Match description and summary text
-index intent show <id>                      # Show full signal details
+index intent show <id>                      # Show full intent details
 index intent prepare "Looking for a CTO"  # Read feedback / recovery prompts and receipt
 index intent prepare "Looking for a CTO" --answer 'Prompt label=My answer'
 index intent create "<returned payload>" --receipt '<returned preparationReceipt>'
 index intent pause <id>                   # Hold the agent without archiving
 index intent resume <id>                  # Start it again
-index intent update <id> "revised text"     # Update a signal (runs full pipeline)
-index intent archive <id>                   # Archive a signal
-index intent networks <id>                  # List the networks a signal is shared in
-index intent add-to-network <id> <network-id>      # Add a signal to a network
-index intent remove-from-network <id> <network-id> # Remove a signal from a network
+index intent update <id> "revised text"     # Update an intent (runs full pipeline)
+index intent archive <id>                   # Archive an intent
+index intent networks <id>                  # List the networks an intent is shared in
+index intent add-to-network <id> <network-id>      # Add an intent to a network
+index intent remove-from-network <id> <network-id> # Remove an intent from a network
 ```
 
 Preparation returns `needs_revision` with recovery field labels or `ready` with a
 `payload` and `preparationReceipt`. Use the exact returned payload with its receipt
 in `create`; `--answer` pairs the displayed recovery **label** with your response.
 You can also create directly: the server prepares the description and rejects an
-unadmitted draft. A new signal is shared in every network you belong to. Narrow it afterwards with
+unadmitted draft. A new intent is shared in every network you belong to. Narrow it afterwards with
 `remove-from-network`, or widen an existing one with `add-to-network`.
 
 ### `index negotiation`
@@ -203,7 +203,7 @@ index opportunity start-chat <id>          # Open its human chat (pending/accept
 
 `--status` accepts one of `pending`, `accepted`, `rejected`, `expired`;
 `--statuses` accepts a comma-separated radar selection including `negotiating`.
-The signal-scoped radar uses `--intent-id <id>`.
+The intent-scoped radar uses `--intent-id <id>`.
 
 ### `index network`
 
@@ -227,7 +227,7 @@ index network invite <id> user@email # Invite directly by email
 
 ### `index conversation`
 
-Read and message the personal agent within a signal, or use human DMs.
+Read and message the personal agent within an intent, or use human DMs.
 
 ```bash
 index conversation show agent --intent-id <id> --json
@@ -254,7 +254,7 @@ index onboarding complete [--intent-id <id>] --json
 ```
 
 Confirm a profile only after the owner reviews it. Completion uses the server's
-profile-confirmation and first-signal prerequisites; it does not bypass them.
+profile-confirmation and first-intent prerequisites; it does not bypass them.
 For a new account: `profile sync` to see suggested facts, `profile update` to save
 what you approve, `onboarding confirm-profile`, `intent prepare` and `intent create`
 with the returned payload and receipt, then `onboarding complete --intent-id <id>`.
@@ -298,7 +298,7 @@ fails, without saving partial context.
 
 ## Examples: Reviewing Opportunities
 
-Approved signals are evaluated in the background. `opportunity list` only reviews persisted results; it does not start evaluation.
+Approved intents are evaluated in the background. `opportunity list` only reviews persisted results; it does not start evaluation.
 
 ### Review and act
 
@@ -323,23 +323,23 @@ index opportunity reject <id>
 | Flag                 | Short | Description                                                     |
 | -------------------- | ----- | --------------------------------------------------------------- |
 | `--api-url <url>`    |       | Override API server (default: `https://protocol.index.network`) |
-| `--app-url <url>`    |       | Override app URL for login (default: `https://index.network`)   |
-| `--archived`         |       | Include archived signals (intent list)                          |
+| `--app-url <url>`    |       | Override the web app URL for login (default: inferred from the API origin) |
+| `--archived`         |       | Include archived intents (intent list)                          |
 | `--status <status>`  |       | Filter opportunities by one pending/accepted/rejected/expired status |
 | `--statuses <list>` |       | Comma-separated radar stages, including negotiating             |
 | `--limit <n>`        |       | Positive result limit for intent/opportunity lists or conversation messages |
-| `--prompt <text>`    | `-p`  | Network description (for `network create`)                      |
+| `--prompt <text>`    | `-p`  | Network description (for `network create` and `network update`) |
 | `--title <text>`     |       | Network title (for `network update`)                            |
 | `--objective <text>` |       | Focus objective (for `scrape`)                                  |
-| `--query <text>`     |       | Match signal description and summary text (intent list)         |
-| `--intent-id <id>`   |       | Filter negotiations, scope agent conversations, or select onboarding's first signal |
+| `--query <text>`     |       | Match intent description and summary text (intent list)         |
+| `--intent-id <id>`   |       | Filter negotiations, scope agent conversations, or select onboarding's first intent |
 | `--state <state>`    |       | Filter negotiations by `open` or `settled`                       |
 | `--action <action>`  |       | Required negotiation turn action: `propose`, `counter`, `accept`, or `decline` |
 | `--message <text>`   |       | Required message for a negotiation turn                         |
 | `--expected-turn-count <n>` | | Required observed nonnegative integer turn count for a negotiation turn |
 | `--question-id <id>` |       | Identify the displayed question when answering the personal agent |
 | `--answer <key=value>` |    | Repeat for recovery prompt labels or agent question IDs          |
-| `--receipt <token>`  |       | Preparation receipt for signal creation                          |
+| `--receipt <token>`  |       | Preparation receipt for intent creation                          |
 | `--name`, `--intro`, `--location` | | Profile fields to update                          |
 | `--social <label=value>` |    | Repeat to replace profile social links                  |
 | `--json`             |       | Output raw JSON to stdout                                       |

package/dist/index.js

@@ -5,7 +5,7 @@ import { spawn } from "node:child_process";
 // package.json
 var package_default = {
   name: "@indexnetwork/cli",
-  version: "0.28.0",
+  version: "0.29.0",
   description: "Command-line interface for Index Network",
   license: "MIT",
   type: "module",
@@ -25,10 +25,10 @@ var package_default = {
     "publish:all": "bun scripts/publish.ts"
   },
   optionalDependencies: {
-    "@indexnetwork/cli-linux-x64": "0.28.0",
-    "@indexnetwork/cli-linux-arm64": "0.28.0",
-    "@indexnetwork/cli-darwin-x64": "0.28.0",
-    "@indexnetwork/cli-darwin-arm64": "0.28.0"
+    "@indexnetwork/cli-linux-x64": "0.29.0",
+    "@indexnetwork/cli-linux-arm64": "0.29.0",
+    "@indexnetwork/cli-darwin-x64": "0.29.0",
+    "@indexnetwork/cli-darwin-arm64": "0.29.0"
   },
   devDependencies: {
     "@types/bun": "1.3.14"
@@ -638,7 +638,7 @@ class ApiClient {
     return (await this.get(path)).json();
   }
   async getAgent() {
-    return (await this.get("/api/agents/me")).json();
+    return await (await this.get("/api/agents/me")).json();
   }
   async getNegotiation(opportunityId) {
     const body = await (await this.get(`/api/opportunities/${encodeURIComponent(opportunityId)}/negotiation`)).json();
@@ -649,13 +649,13 @@ class ApiClient {
     return body.negotiation;
   }
   async getAgentConversation(intentId) {
-    return (await this.get(`/api/conversations/agent/messages?${new URLSearchParams({ intentId })}`)).json();
+    return await (await this.get(`/api/conversations/agent/messages?${new URLSearchParams({ intentId })}`)).json();
   }
   async confirmProfile() {
-    return (await this.post("/api/auth/onboarding/confirm-profile", {})).json();
+    return await (await this.post("/api/auth/onboarding/confirm-profile", {})).json();
   }
   async completeOnboarding(intentId) {
-    return (await this.post("/api/auth/onboarding/complete", { intentId })).json();
+    return await (await this.post("/api/auth/onboarding/complete", { intentId })).json();
   }
   async get(path) {
     const res = await fetch(`${this.baseUrl}${path}`, {
@@ -1085,7 +1085,7 @@ function profileCard(data) {
 }
 function intentTable(intents) {
   if (intents.length === 0) {
-    dim("  No signals found.");
+    dim("  No intents found.");
     return;
   }
   const idWidth = 8;
@@ -1093,7 +1093,7 @@ function intentTable(intents) {
   const statusWidth = 10;
   const sourceWidth = 16;
   const dateWidth = 20;
-  console.log(`  ${BOLD}${"ID".padEnd(idWidth)}  ${"Signal".padEnd(descWidth)}  ${"Status".padEnd(statusWidth)}  ${"Source".padEnd(sourceWidth)}  ${"Created".padEnd(dateWidth)}${RESET}`);
+  console.log(`  ${BOLD}${"ID".padEnd(idWidth)}  ${"Intent".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);
@@ -1109,9 +1109,45 @@ function intentTable(intents) {
     console.log(`  ${CYAN}${shortId}${RESET}  ${desc.padEnd(descWidth)}  ${sColor}${status}${RESET}  ${GRAY}${source}${RESET}  ${GRAY}${date}${RESET}`);
   }
 }
+function intentPreparation(prepared) {
+  if (prepared.status === "ready") {
+    success("Intent is ready to create.");
+    console.log();
+    for (const line of wordWrap(prepared.payload, 72))
+      console.log(`  ${line}`);
+    console.log();
+    console.log(`  ${BOLD}Create it:${RESET}`);
+    console.log(`  index intent create ${shellQuote(prepared.payload)} --receipt ${shellQuote(prepared.preparationReceipt)}`);
+    console.log();
+    return;
+  }
+  console.log();
+  console.log(`  ${BOLD}${YELLOW}Needs revision${RESET}`);
+  for (const line of wordWrap(prepared.feedback, 72))
+    console.log(`  ${line}`);
+  console.log();
+  console.log(`  ${BOLD}Answer these:${RESET}`);
+  for (const field of prepared.recovery) {
+    console.log(`  ${CYAN}*${RESET} ${field.label}`);
+    for (const option of field.options ?? []) {
+      const description = option.description ? `${GRAY} — ${option.description}${RESET}` : "";
+      console.log(`      ${option.label}${description}`);
+    }
+    if (field.placeholder)
+      console.log(`      ${GRAY}${field.placeholder}${RESET}`);
+  }
+  console.log();
+  const answerFlags = prepared.recovery.map((field) => `--answer ${shellQuote(`${field.label}=<reply>`)}`);
+  console.log(`  ${BOLD}Then run:${RESET}`);
+  console.log(`  index intent prepare ${shellQuote(prepared.payload)} ${answerFlags.join(" ")}`);
+  console.log();
+}
+function shellQuote(value) {
+  return `'${value.replace(/'/g, "'\\''")}'`;
+}
 function intentCard(intent) {
   console.log();
-  console.log(`  ${BOLD}${CYAN}Signal Details${RESET}`);
+  console.log(`  ${BOLD}${CYAN}Intent Details${RESET}`);
   console.log(`  ${GRAY}${"─".repeat(50)}${RESET}`);
   console.log(`  ${BOLD}ID${RESET}            ${GRAY}${intent.id}${RESET}`);
   console.log(`  ${BOLD}Status${RESET}        ${intent.status === "ACTIVE" ? GREEN : GRAY}${intent.status}${RESET}`);
@@ -1262,6 +1298,173 @@ function statusColor(st) {
       return "";
   }
 }
+var ACTION_COLORS = {
+  propose: CYAN,
+  counter: BLUE,
+  accept: GREEN,
+  decline: RED
+};
+function shortDateTime(iso) {
+  return new Date(iso).toLocaleString("en-US", {
+    month: "short",
+    day: "numeric",
+    hour: "2-digit",
+    minute: "2-digit"
+  });
+}
+function outcomeLabel(outcome) {
+  switch (outcome) {
+    case "agreed":
+      return `${GREEN}agreed${RESET}`;
+    case "declined":
+      return `${RED}declined${RESET}`;
+    case "closed":
+      return `${GRAY}closed${RESET}`;
+    case null:
+      return `${YELLOW}open${RESET}`;
+  }
+}
+function whoseTurn(negotiation) {
+  if (negotiation.awaitingUserId === null)
+    return "nobody";
+  return negotiation.awaitingUserId === negotiation.counterparty.userId ? "them" : "you";
+}
+function counterpartyName(negotiation) {
+  return negotiation.counterparty.name ?? "(unnamed)";
+}
+function negotiationTable(negotiations) {
+  if (negotiations.length === 0) {
+    dim("  No negotiations found.");
+    return;
+  }
+  const idW = 8;
+  const nameW = 22;
+  const turnsW = 5;
+  const turnW = 10;
+  const outcomeW = 8;
+  const dateW = 12;
+  console.log(`  ${BOLD}${"ID".padEnd(idW)}  ${"Counterparty".padEnd(nameW)}  ${"Turns".padEnd(turnsW)}  ${"Whose turn".padEnd(turnW)}  ${"Outcome".padEnd(outcomeW)}  ${"Updated".padEnd(dateW)}${RESET}`);
+  console.log(`  ${GRAY}${"-".repeat(idW)}  ${"-".repeat(nameW)}  ${"-".repeat(turnsW)}  ${"-".repeat(turnW)}  ${"-".repeat(outcomeW)}  ${"-".repeat(dateW)}${RESET}`);
+  for (const negotiation of negotiations) {
+    const shortId = negotiation.opportunityId.slice(0, idW);
+    const name = counterpartyName(negotiation).slice(0, nameW);
+    const turns = String(negotiation.turnCount);
+    const turn = whoseTurn(negotiation);
+    let turnCell = `${GRAY}${"—".padEnd(turnW)}${RESET}`;
+    if (turn === "you")
+      turnCell = `${YELLOW}${BOLD}${"you".padEnd(turnW)}${RESET}`;
+    if (turn === "them")
+      turnCell = `${GRAY}${"them".padEnd(turnW)}${RESET}`;
+    const outcome = outcomeLabel(negotiation.outcome);
+    const date = new Date(negotiation.updatedAt).toLocaleDateString("en-US", {
+      year: "numeric",
+      month: "short",
+      day: "numeric"
+    });
+    console.log(`  ${CYAN}${shortId}${RESET}  ${name.padEnd(nameW)}  ${turns.padEnd(turnsW)}  ${turnCell}  ${outcome}${padTo(outcomeW, stripAnsi(outcome))}  ${GRAY}${date}${RESET}`);
+  }
+}
+function negotiationCard(negotiation) {
+  const name = counterpartyName(negotiation);
+  const rule = `  ${GRAY}${"─".repeat(60)}${RESET}`;
+  let turnLabel = `${GRAY}— settled${RESET}`;
+  if (whoseTurn(negotiation) === "you")
+    turnLabel = `${YELLOW}${BOLD}you${RESET}`;
+  if (whoseTurn(negotiation) === "them")
+    turnLabel = name;
+  console.log();
+  console.log(`  ${BOLD}${CYAN}Negotiation with ${name}${RESET}`);
+  console.log(rule);
+  console.log(`  ${BOLD}Opportunity${RESET}   ${GRAY}${negotiation.opportunityId}${RESET}`);
+  console.log(`  ${BOLD}Outcome${RESET}       ${outcomeLabel(negotiation.outcome)}`);
+  console.log(`  ${BOLD}Turn${RESET}          ${negotiation.turnCount} of ${negotiation.protocol.maxTurns}`);
+  console.log(`  ${BOLD}Whose turn${RESET}    ${turnLabel}`);
+  const [firstLine, ...moreLines] = wordWrap(negotiation.counterparty.statement, 58);
+  console.log(`  ${BOLD}Their intent${RESET}  ${firstLine}`);
+  for (const line of moreLines)
+    console.log(`                ${line}`);
+  console.log();
+  console.log(`  ${BOLD}Transcript${RESET}`);
+  if (negotiation.turns.length === 0)
+    console.log(`  ${GRAY}No turns yet.${RESET}`);
+  for (const turn of negotiation.turns) {
+    const seat = turn.seatUserId === negotiation.counterparty.userId ? name : "You";
+    console.log(`  ${GRAY}${turn.turnIndex + 1}.${RESET} ${BOLD}${seat}${RESET}  ${ACTION_COLORS[turn.action]}${turn.action}${RESET}  ${GRAY}${shortDateTime(turn.createdAt)}${RESET}`);
+    for (const line of wordWrap(turn.message, 66))
+      console.log(`     ${line}`);
+  }
+  const { availableActions, blockedReason, messageLimit } = negotiation.protocol;
+  console.log();
+  if (availableActions.length > 0) {
+    const actions = availableActions.map((action) => `${ACTION_COLORS[action]}${action}${RESET}`).join(", ");
+    console.log(`  ${BOLD}Available actions:${RESET} ${actions}  ${GRAY}(message up to ${messageLimit} characters)${RESET}`);
+  } else {
+    console.log(`  ${BOLD}Available actions:${RESET} ${GRAY}none${RESET}`);
+  }
+  if (blockedReason)
+    console.log(`  ${BOLD}Blocked:${RESET} ${YELLOW}${blockedReason}${RESET}`);
+  console.log(rule);
+  if (availableActions.length > 0) {
+    dim(`  Reply: index negotiation turn ${negotiation.opportunityId.slice(0, 8)} --action <action> --message <text> --expected-turn-count ${negotiation.turnCount}`);
+  }
+  console.log();
+}
+function agentCard(selected) {
+  const { agent, onboardingCompletedAt } = selected;
+  const rule = `  ${GRAY}${"─".repeat(50)}${RESET}`;
+  console.log();
+  console.log(`  ${BOLD}${CYAN}${agent.name}${RESET}`);
+  console.log(rule);
+  console.log(`  ${BOLD}Seat${RESET}          External negotiator (negotiates instead of Index's hosted agent)`);
+  console.log(`  ${BOLD}Status${RESET}        ${agent.status === "active" ? GREEN : GRAY}${agent.status}${RESET}`);
+  if (agent.description)
+    console.log(`  ${BOLD}Description${RESET}   ${agent.description}`);
+  console.log(`  ${BOLD}Last seen${RESET}     ${GRAY}${agent.lastSeenAt ? shortDateTime(agent.lastSeenAt) : "never"}${RESET}`);
+  const onboarding = onboardingCompletedAt ? `${GREEN}complete${RESET} ${GRAY}(${shortDateTime(onboardingCompletedAt)})${RESET}` : `${YELLOW}not complete${RESET}`;
+  console.log(`  ${BOLD}Onboarding${RESET}    ${onboarding}`);
+  console.log(`  ${BOLD}ID${RESET}            ${GRAY}${agent.id}${RESET}`);
+  console.log(rule);
+  console.log();
+}
+function agentConversation(conversation) {
+  const seat = conversation.agent.status === "hosted" ? "Index's hosted agent" : "your external negotiator";
+  const rule = `  ${GRAY}${"─".repeat(60)}${RESET}`;
+  console.log();
+  console.log(`  ${BOLD}${CYAN}Personal agent${RESET}  ${GRAY}answered by ${seat}${RESET}`);
+  console.log(rule);
+  if (conversation.messages.length === 0)
+    console.log(`  ${GRAY}No messages yet.${RESET}`);
+  for (const message of conversation.messages) {
+    const author = message.role === "user" ? `${BOLD}${CYAN}you${RESET}` : `${BOLD}${BLUE}agent${RESET}`;
+    const text = message.parts.filter((part) => part.kind === "text" && part.text).map((part) => part.text).join(`
+`);
+    console.log(`  ${author}  ${GRAY}${shortDateTime(message.createdAt)}${RESET}`);
+    for (const line of wordWrap(text, 70))
+      console.log(`  ${line}`);
+    console.log();
+  }
+  const { questions } = conversation.agent;
+  if (questions.length === 0) {
+    console.log(`  ${GRAY}No questions waiting for you.${RESET}`);
+    console.log();
+    return;
+  }
+  console.log(`  ${BOLD}${YELLOW}Waiting for your answer (${questions.length})${RESET}`);
+  for (const question of questions) {
+    const [firstLine, ...moreLines] = wordWrap(question.question, 66);
+    console.log(`  ${YELLOW}?${RESET} ${BOLD}${firstLine}${RESET}`);
+    for (const line of moreLines)
+      console.log(`    ${BOLD}${line}${RESET}`);
+    console.log(`    ${GRAY}Question ID${RESET}  ${CYAN}${question.id}${RESET}`);
+    if (question.options?.length)
+      console.log(`    ${GRAY}Options${RESET}      ${question.options.join(" / ")}`);
+    if (question.matches.length > 0) {
+      const about = question.matches.map((match) => `${match.counterparty.name ?? "(unnamed)"} ${GRAY}(${match.opportunityId.slice(0, 8)})${RESET}`).join(", ");
+      console.log(`    ${GRAY}About${RESET}        ${about}`);
+    }
+    console.log();
+  }
+}
 function networkTable(networks) {
   if (networks.length === 0) {
     dim("  No networks found.");
@@ -1468,16 +1671,16 @@ async function profileSync(client, json) {
 // src/intent.command.ts
 var INTENT_HELP = `
 Usage:
-  index intent list [--archived] [--limit <n>] [--query <text>]  List your signals
-  index intent show <id>                        Show signal details (accepts short ID)
+  index intent list [--archived] [--limit <n>] [--query <text>]  List your intents
+  index intent show <id>                        Show intent details (accepts short ID)
   index intent prepare <content> [--answer 'prompt=reply']  Review and repair a draft
-  index intent create <content> [--receipt <token>]         Create an admitted signal
+  index intent create <content> [--receipt <token>]         Create an admitted intent
   index intent pause <id> | resume <id>         Hold or restart its agent
-  index intent update <id> <content>            Update a signal's description
-  index intent archive <id>                     Archive a signal (accepts short ID)
-  index intent networks <id>                    List the networks a signal is shared in
-  index intent add-to-network <id> <network-id>      Add a signal to a network
-  index intent remove-from-network <id> <network-id> Remove a signal from a network
+  index intent update <id> <content>            Update an intent's description
+  index intent archive <id>                     Archive an intent (accepts short ID)
+  index intent networks <id>                    List the networks an intent is shared in
+  index intent add-to-network <id> <network-id>      Add an intent to a network
+  index intent remove-from-network <id> <network-id> Remove an intent from a network
 `;
 async function handleIntent(client, subcommand, options) {
   if (!subcommand) {
@@ -1499,7 +1702,7 @@ async function handleIntent(client, subcommand, options) {
         console.log(JSON.stringify(result));
         return;
       }
-      heading("Signals");
+      heading("Intents");
       intentTable(result.intents);
       if (result.pagination.totalCount > 0) {
         dim(`
@@ -1510,7 +1713,7 @@ async function handleIntent(client, subcommand, options) {
     }
     case "show": {
       if (!options.intentId) {
-        error("Missing signal ID. Usage: index intent show <id>", 1);
+        error("Missing intent ID. Usage: index intent show <id>", 1);
         return;
       }
       const intent = await client.getIntent(options.intentId);
@@ -1525,7 +1728,11 @@ async function handleIntent(client, subcommand, options) {
       if (!options.intentContent)
         throw new Error("Usage: index intent prepare <content> [--answer 'prompt=reply']");
       const prepared = await client.prepareIntent(options.intentContent, (options.answers ?? []).map(({ key, value }) => ({ prompt: key, answer: value })));
-      console.log(JSON.stringify(prepared, null, options.json ? undefined : 2));
+      if (options.json) {
+        console.log(JSON.stringify(prepared));
+        return;
+      }
+      intentPreparation(prepared);
       return;
     }
     case "create": {
@@ -1534,19 +1741,19 @@ async function handleIntent(client, subcommand, options) {
         return;
       }
       if (!options.json)
-        info("Processing signal...");
+        info("Processing intent...");
       const result = await client.createIntent(options.intentContent, options.targetId ? [options.targetId] : undefined, options.receipt);
       if (options.json) {
         console.log(JSON.stringify(result));
         return;
       }
-      success("Signal created.");
+      success("Intent created.");
       dim(`  shared in ${result.networkIds.length} network${result.networkIds.length === 1 ? "" : "s"}`);
       return;
     }
     case "update": {
       if (!options.intentId) {
-        error("Missing signal ID. Usage: index intent update <id> <content>", 1);
+        error("Missing intent ID. Usage: index intent update <id> <content>", 1);
         return;
       }
       if (!options.intentContent) {
@@ -1554,13 +1761,13 @@ async function handleIntent(client, subcommand, options) {
         return;
       }
       if (!options.json)
-        info("Updating signal...");
+        info("Updating intent...");
       const result = await client.updateIntent(options.intentId, options.intentContent);
       if (options.json) {
         console.log(JSON.stringify(result));
         return;
       }
-      success("Signal updated.");
+      success("Intent updated.");
       return;
     }
     case "pause":
@@ -1572,12 +1779,12 @@ async function handleIntent(client, subcommand, options) {
       if (options.json)
         console.log(JSON.stringify({ intentId: options.intentId, status }));
       else
-        success(`Signal ${status.toLowerCase()}.`);
+        success(`Intent ${status.toLowerCase()}.`);
       return;
     }
     case "archive": {
       if (!options.intentId) {
-        error("Missing signal ID. Usage: index intent archive <id>", 1);
+        error("Missing intent ID. Usage: index intent archive <id>", 1);
         return;
       }
       await client.archiveIntent(options.intentId);
@@ -1585,7 +1792,7 @@ async function handleIntent(client, subcommand, options) {
         console.log(JSON.stringify({ success: true }));
         return;
       }
-      success(`Signal ${options.intentId} archived.`);
+      success(`Intent ${options.intentId} archived.`);
       return;
     }
     case "networks": {
@@ -1614,7 +1821,7 @@ async function handleIntent(client, subcommand, options) {
         console.log(JSON.stringify({ success: true }));
         return;
       }
-      success("Signal added to network.");
+      success("Intent added to network.");
       return;
     }
     case "remove-from-network": {
@@ -1627,7 +1834,7 @@ async function handleIntent(client, subcommand, options) {
         console.log(JSON.stringify({ success: true }));
         return;
       }
-      success("Signal removed from network.");
+      success("Intent removed from network.");
       return;
     }
   }
@@ -1724,16 +1931,30 @@ async function opportunityStatusUpdate(client, id, status, json) {
 
 // src/negotiation.command.ts
 async function handleNegotiation(client, subcommand, options) {
-  let result;
   if (subcommand === "list") {
     if (options.state !== undefined && options.state !== "open" && options.state !== "settled")
       throw new Error("--state must be open or settled");
-    result = await client.listNegotiations({ intentId: options.intentId, state: options.state });
+    const negotiations = await client.listNegotiations({ intentId: options.intentId, state: options.state });
+    if (options.json) {
+      console.log(JSON.stringify(negotiations));
+      return;
+    }
+    heading("Negotiations");
+    negotiationTable(negotiations);
+    if (negotiations.length > 0)
+      dim(`
+  Details: index negotiation show <id>  (the short ID works)`);
+    console.log();
   } else if (subcommand === "show" || subcommand === "turn") {
     if (!options.targetId)
       throw new Error("An opportunity ID is required");
     if (subcommand === "show") {
-      result = await client.getNegotiation(options.targetId);
+      const negotiation = await client.getNegotiation(options.targetId);
+      if (options.json) {
+        console.log(JSON.stringify(negotiation));
+        return;
+      }
+      negotiationCard(negotiation);
     } else {
       if (!options.action || !["propose", "counter", "accept", "decline"].includes(options.action))
         throw new Error("--action must be propose, counter, accept, or decline");
@@ -1741,16 +1962,21 @@ async function handleNegotiation(client, subcommand, options) {
         throw new Error("--message is required");
       if (options.expectedTurnCount === undefined || !Number.isSafeInteger(options.expectedTurnCount) || options.expectedTurnCount < 0)
         throw new Error("--expected-turn-count must be the observed nonnegative integer turn count");
-      result = await client.submitNegotiationTurn(options.targetId, {
+      const negotiation = await client.submitNegotiationTurn(options.targetId, {
         action: options.action,
         message: options.message,
         expectedTurnCount: options.expectedTurnCount
       });
+      if (options.json) {
+        console.log(JSON.stringify(negotiation));
+        return;
+      }
+      success(`Turn submitted: ${options.action}`);
+      negotiationCard(negotiation);
     }
   } else {
     throw new Error("Usage: index negotiation list [--intent-id <id>] [--state open|settled], show <opportunity-id>, or turn <opportunity-id> --action <action> --message <text> --expected-turn-count <n>");
   }
-  console.log(JSON.stringify(result, null, options.json ? undefined : 2));
 }
 
 // src/network.command.ts
@@ -2030,24 +2256,50 @@ async function handleConversation(client, subcommand, positionals, options) {
   if (positionals[0] === "agent" && (subcommand === "show" || subcommand === "send")) {
     if (!options?.intentId)
       throw new Error("Personal-agent conversations require --intent-id <id>");
-    let result;
-    if (subcommand === "show")
-      result = await client.getAgentConversation(options.intentId);
-    else {
-      const text = positionals.slice(1).join(" ");
-      if (!text.trim())
-        throw new Error("A message is required");
-      result = options.questionId ? await client.answerAgentQuestions(options.intentId, [{ questionId: options.questionId, text }]) : await client.sendMessage("agent", text, options.intentId);
-    }
-    console.log(JSON.stringify(result, null, options.json ? undefined : 2));
+    if (subcommand === "show") {
+      const conversation = await client.getAgentConversation(options.intentId);
+      if (options.json) {
+        console.log(JSON.stringify(conversation));
+        return;
+      }
+      agentConversation(conversation);
+      if (conversation.agent.questions.length > 0) {
+        dim(`  Answer: index conversation answer agent --intent-id ${options.intentId} --answer '<question-id>=<reply>'`);
+      }
+      return;
+    }
+    const text = positionals.slice(1).join(" ");
+    if (!text.trim())
+      throw new Error("A message is required");
+    if (options.questionId) {
+      const answers = [{ questionId: options.questionId, text }];
+      const result = await client.answerAgentQuestions(options.intentId, answers);
+      if (options.json) {
+        console.log(JSON.stringify(result));
+        return;
+      }
+      printAgentAnswers(answers, result.messages);
+      return;
+    }
+    const message = await client.sendMessage("agent", text, options.intentId);
+    if (options.json) {
+      console.log(JSON.stringify(message));
+      return;
+    }
+    success(`Message sent to your agent (${message.id})`);
     return;
   }
   if (subcommand === "answer") {
     if (positionals[0] !== "agent" || !options?.intentId || !options.answers?.length) {
       throw new Error("Usage: index conversation answer agent --intent-id <id> --answer 'question-id=text' [--answer ...]");
     }
-    const result = await client.answerAgentQuestions(options.intentId, options.answers.map(({ key, value }) => ({ questionId: key, text: value })));
-    console.log(JSON.stringify(result, null, options.json ? undefined : 2));
+    const answers = options.answers.map(({ key, value }) => ({ questionId: key, text: value }));
+    const result = await client.answerAgentQuestions(options.intentId, answers);
+    if (options.json) {
+      console.log(JSON.stringify(result));
+      return;
+    }
+    printAgentAnswers(answers, result.messages);
     return;
   }
   if (!subcommand)
@@ -2075,6 +2327,16 @@ async function handleConversation(client, subcommand, positionals, options) {
       error(`Unknown conversation subcommand: ${subcommand}`, 1);
   }
 }
+function printAgentAnswers(answers, messages) {
+  for (const [index, message] of messages.entries()) {
+    const { questionId } = answers[index];
+    if (message.metadata.principalMessage.kind === "answer") {
+      success(`Answered question ${questionId}`);
+    } else {
+      success(`Question ${questionId} is no longer waiting; your reply was sent to your agent as a message`);
+    }
+  }
+}
 async function conversationList(client, json) {
   const conversations = await client.listConversations();
   if (json) {
@@ -2232,14 +2494,23 @@ async function handleDocs(client, topic, json) {
 
 // src/onboarding.command.ts
 async function handleOnboarding(client, subcommand, options) {
-  let result;
-  if (subcommand === "confirm-profile")
-    result = await client.confirmProfile();
-  else if (subcommand === "complete")
-    result = await client.completeOnboarding(options?.intentId);
-  else
+  if (subcommand === "confirm-profile") {
+    const result = await client.confirmProfile();
+    if (options?.json) {
+      console.log(JSON.stringify(result));
+      return;
+    }
+    success("Profile confirmed.");
+  } else if (subcommand === "complete") {
+    const result = await client.completeOnboarding(options?.intentId);
+    if (options?.json) {
+      console.log(JSON.stringify(result));
+      return;
+    }
+    success(`Onboarding complete (first intent ${result.intentId}).`);
+  } else {
     throw new Error("Usage: index onboarding confirm-profile | complete [--intent-id <id>]");
-  console.log(JSON.stringify(result, null, options?.json ? undefined : 2));
+  }
 }
 
 // src/main.ts
@@ -2399,11 +2670,17 @@ async function main() {
     case "docs":
       await handleDocs(client, args.positionals?.[0], args.json);
       return;
-    case "agent":
+    case "agent": {
       if (args.subcommand !== "me")
         throw new Error("Usage: index agent me");
-      console.log(JSON.stringify(await client.getAgent(), null, args.json ? undefined : 2));
+      const selected = await client.getAgent();
+      if (args.json) {
+        console.log(JSON.stringify(selected));
+        return;
+      }
+      agentCard(selected);
       return;
+    }
     case "profile":
       await handleProfile(client, args.subcommand, args.subcommand === "search" || args.subcommand === "update" ? args.positionals ?? [] : args.userId ? [args.userId] : [], {
         json: args.json,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indexnetwork/cli",
-  "version": "0.28.0",
+  "version": "0.29.0-rc.88.2",
   "description": "Command-line interface for Index Network",
   "license": "MIT",
   "type": "module",
@@ -20,10 +20,10 @@
     "publish:all": "bun scripts/publish.ts"
   },
   "optionalDependencies": {
-    "@indexnetwork/cli-linux-x64": "0.28.0",
-    "@indexnetwork/cli-linux-arm64": "0.28.0",
-    "@indexnetwork/cli-darwin-x64": "0.28.0",
-    "@indexnetwork/cli-darwin-arm64": "0.28.0"
+    "@indexnetwork/cli-linux-x64": "0.29.0-rc.88.2",
+    "@indexnetwork/cli-linux-arm64": "0.29.0-rc.88.2",
+    "@indexnetwork/cli-darwin-x64": "0.29.0-rc.88.2",
+    "@indexnetwork/cli-darwin-arm64": "0.29.0-rc.88.2"
   },
   "devDependencies": {
     "@types/bun": "1.3.14"