@indexnetwork/cli 0.29.0-rc.88.2 → 0.30.0-rc.100.1

package/README.md

@@ -56,8 +56,8 @@ flags are listed in [Options](#options), and examples follow this reference.
 | `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 an intent, optionally using the preparation receipt. |
-| `index intent update <id> <text>` | Update and reprocess an intent's description. |
+| `index intent create <text>` | Create an intent, optionally using the preparation receipt and client-owned `--source-type` / `--source-id`. |
+| `index intent update <id> [<text>]` | Update and reprocess an intent's description, or set `--source-type` / `--source-id` (empty clears). |
 | `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 an intent is shared in. |
@@ -65,7 +65,7 @@ flags are listed in [Options](#options), and examples follow this reference.
 | `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. |
+| `index negotiation turn <opportunity-id> --action <action> --message <text>` | Submit one `propose`, `counter`, `accept`, or `decline` turn. |
 | `index opportunity list` | List persisted opportunities, with optional status and result-limit filters. |
 | `index opportunity show <id>` | Show an opportunity's presentation and participants. |
 | `index opportunity accept <id>` | Request acceptance through the server's owner-approval flow. |
@@ -176,7 +176,7 @@ Read current negotiations and submit structured turns using full opportunity IDs
 ```bash
 index negotiation list [--intent-id <id>] [--state open|settled]
 index negotiation show <opportunity-id> --json
-index negotiation turn <opportunity-id> --action propose --message "..." --expected-turn-count 0 --json
+index negotiation turn <opportunity-id> --action propose --message "..." --json
 ```
 
 Actions are `propose`, `counter`, `accept`, and `decline`. Read the detail's
@@ -336,7 +336,6 @@ index opportunity reject <id>
 | `--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 intent creation                          |

package/dist/index.js

@@ -5,7 +5,7 @@ import { spawn } from "node:child_process";
 // package.json
 var package_default = {
   name: "@indexnetwork/cli",
-  version: "0.29.0",
+  version: "0.30.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.29.0",
-    "@indexnetwork/cli-linux-arm64": "0.29.0",
-    "@indexnetwork/cli-darwin-x64": "0.29.0",
-    "@indexnetwork/cli-darwin-arm64": "0.29.0"
+    "@indexnetwork/cli-linux-x64": "0.30.0",
+    "@indexnetwork/cli-linux-arm64": "0.30.0",
+    "@indexnetwork/cli-darwin-x64": "0.30.0",
+    "@indexnetwork/cli-darwin-arm64": "0.30.0"
   },
   devDependencies: {
     "@types/bun": "1.3.14"
@@ -95,7 +95,7 @@ function parseArgs(args) {
       return { ...result, command: "version" };
     if (["--api-url", "--app-url", "--status", "--limit", "--prompt", "-p", "--objective", "--title"].includes(arg) && (!args[i + 1] || args[i + 1].startsWith("--")))
       throw new Error(`Missing value for ${arg}`);
-    if (["--query", "--state", "--action", "--message", "--intent-id", "--question-id", "--expected-turn-count", "--receipt", "--name", "--intro", "--location", "--statuses", "--answer", "--social"].includes(arg)) {
+    if (["--query", "--state", "--action", "--message", "--intent-id", "--question-id", "--receipt", "--source-type", "--source-id", "--name", "--intro", "--location", "--statuses", "--answer", "--social"].includes(arg)) {
       const value = args[i + 1];
       if (value === undefined || value.startsWith("--"))
         throw new Error(`Missing value for ${arg}`);
@@ -118,12 +118,15 @@ function parseArgs(args) {
         case "--question-id":
           result.questionId = value;
           break;
-        case "--expected-turn-count":
-          result.expectedTurnCount = Number(value);
-          break;
         case "--receipt":
           result.receipt = value;
           break;
+        case "--source-type":
+          result.sourceType = value;
+          break;
+        case "--source-id":
+          result.sourceId = value;
+          break;
         case "--name":
           result.name = value;
           break;
@@ -454,11 +457,12 @@ class ApiClient {
     const body = await res.json();
     return body.intent;
   }
-  async createIntent(description, networkIds, preparationReceipt) {
+  async createIntent(description, networkIds, preparationReceipt, source = {}) {
     const res = await this.post("/api/intents", {
       description,
       ...networkIds?.length ? { networkIds } : {},
-      ...preparationReceipt ? { preparationReceipt } : {}
+      ...preparationReceipt ? { preparationReceipt } : {},
+      ...source
     });
     return await res.json();
   }
@@ -469,8 +473,11 @@ class ApiClient {
   async updateIntentStatus(id, status) {
     await this.patch(`/api/intents/${encodeURIComponent(id)}/status`, { status });
   }
-  async updateIntent(intentId, description) {
-    const res = await this.patch(`/api/intents/${encodeURIComponent(intentId)}`, { description });
+  async updateIntent(intentId, description, source = {}) {
+    const res = await this.patch(`/api/intents/${encodeURIComponent(intentId)}`, {
+      ...description !== undefined ? { description } : {},
+      ...source
+    });
     return await res.json();
   }
   async archiveIntent(intentId) {
@@ -1105,7 +1112,7 @@ function intentTable(intents) {
       month: "short",
       day: "numeric"
     });
-    const sColor = intent.status === "ACTIVE" ? GREEN : GRAY;
+    const sColor = intent.status === "active" ? GREEN : GRAY;
     console.log(`  ${CYAN}${shortId}${RESET}  ${desc.padEnd(descWidth)}  ${sColor}${status}${RESET}  ${GRAY}${source}${RESET}  ${GRAY}${date}${RESET}`);
   }
 }
@@ -1150,7 +1157,7 @@ function intentCard(intent) {
   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}`);
+  console.log(`  ${BOLD}Status${RESET}        ${intent.status === "active" ? GREEN : GRAY}${intent.status}${RESET}`);
   if (intent.summary) {
     console.log(`  ${BOLD}Summary${RESET}       ${intent.summary}`);
   }
@@ -1165,7 +1172,10 @@ function intentCard(intent) {
     console.log(`  ${BOLD}Mode${RESET}          ${intent.intentMode}`);
   }
   if (intent.sourceType) {
-    console.log(`  ${BOLD}Source${RESET}        ${intent.sourceType}`);
+    console.log(`  ${BOLD}Source type${RESET}   ${intent.sourceType}`);
+  }
+  if (intent.sourceId) {
+    console.log(`  ${BOLD}Source ID${RESET}     ${intent.sourceId}`);
   }
   if (intent.confidence !== undefined) {
     console.log(`  ${BOLD}Confidence${RESET}    ${confidenceBar(intent.confidence)}`);
@@ -1405,7 +1415,7 @@ function negotiationCard(negotiation) {
     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}`);
+    dim(`  Reply: index negotiation turn ${negotiation.opportunityId.slice(0, 8)} --action <action> --message <text>`);
   }
   console.log();
 }
@@ -1417,8 +1427,6 @@ function agentCard(selected) {
   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}`);
@@ -1674,15 +1682,26 @@ Usage:
   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 intent
+  index intent create <content> [--receipt <token>] [--source-type <s>] [--source-id <s>]  Create an admitted intent
   index intent pause <id> | resume <id>         Hold or restart its agent
-  index intent update <id> <content>            Update an intent's description
+  index intent update <id> [<content>] [--source-type <s>] [--source-id <s>]  Update description or source fields
   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
+
+--source-type and --source-id are optional strings Index stores and returns
+unchanged, so a client can map its own records (such as an inferred ambient
+intent) to the published signal. Pass an empty value to clear one on update.
 `;
+function sourceField(value) {
+  return value === undefined ? undefined : value || null;
+}
 async function handleIntent(client, subcommand, options) {
+  const source = {
+    ...options.sourceType !== undefined ? { sourceType: sourceField(options.sourceType) } : {},
+    ...options.sourceId !== undefined ? { sourceId: sourceField(options.sourceId) } : {}
+  };
   if (!subcommand) {
     if (options.json) {
       console.log(JSON.stringify({ error: "No subcommand provided" }));
@@ -1742,7 +1761,7 @@ async function handleIntent(client, subcommand, options) {
       }
       if (!options.json)
         info("Processing intent...");
-      const result = await client.createIntent(options.intentContent, options.targetId ? [options.targetId] : undefined, options.receipt);
+      const result = await client.createIntent(options.intentContent, options.targetId ? [options.targetId] : undefined, options.receipt, source);
       if (options.json) {
         console.log(JSON.stringify(result));
         return;
@@ -1753,16 +1772,16 @@ async function handleIntent(client, subcommand, options) {
     }
     case "update": {
       if (!options.intentId) {
-        error("Missing intent ID. Usage: index intent update <id> <content>", 1);
+        error("Missing intent ID. Usage: index intent update <id> [<content>] [--source-type <s>] [--source-id <s>]", 1);
         return;
       }
-      if (!options.intentContent) {
-        error("Missing content. Usage: index intent update <id> <content>", 1);
+      if (!options.intentContent && Object.keys(source).length === 0) {
+        error("Nothing to update. Usage: index intent update <id> [<content>] [--source-type <s>] [--source-id <s>]", 1);
         return;
       }
       if (!options.json)
         info("Updating intent...");
-      const result = await client.updateIntent(options.intentId, options.intentContent);
+      const result = await client.updateIntent(options.intentId, options.intentContent, source);
       if (options.json) {
         console.log(JSON.stringify(result));
         return;
@@ -1774,7 +1793,7 @@ async function handleIntent(client, subcommand, options) {
     case "resume": {
       if (!options.intentId)
         throw new Error(`Usage: index intent ${subcommand} <id>`);
-      const status = subcommand === "pause" ? "PAUSED" : "ACTIVE";
+      const status = subcommand === "pause" ? "paused" : "active";
       await client.updateIntentStatus(options.intentId, status);
       if (options.json)
         console.log(JSON.stringify({ intentId: options.intentId, status }));
@@ -1960,12 +1979,9 @@ async function handleNegotiation(client, subcommand, options) {
         throw new Error("--action must be propose, counter, accept, or decline");
       if (!options.message?.trim())
         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");
       const negotiation = await client.submitNegotiationTurn(options.targetId, {
         action: options.action,
-        message: options.message,
-        expectedTurnCount: options.expectedTurnCount
+        message: options.message
       });
       if (options.json) {
         console.log(JSON.stringify(negotiation));
@@ -1975,7 +1991,7 @@ async function handleNegotiation(client, subcommand, options) {
       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>");
+    throw new Error("Usage: index negotiation list [--intent-id <id>] [--state open|settled], show <opportunity-id>, or turn <opportunity-id> --action <action> --message <text>");
   }
 }
 
@@ -2543,7 +2559,7 @@ function renderHelp(json) {
   negotiation list [--intent-id <id>] [--state open|settled]
   negotiation show <opportunity-id>
   negotiation turn <opportunity-id> --action propose|counter|accept|decline
-      --message <text> --expected-turn-count <n>
+      --message <text>
   conversation list|with|show|send|answer|stream
   conversation show agent --intent-id <id>
   conversation send agent <text> --intent-id <id> [--question-id <id>]
@@ -2700,7 +2716,9 @@ async function main() {
         targetId: args.targetId,
         query: args.query,
         receipt: args.receipt,
-        answers: args.answers
+        answers: args.answers,
+        sourceType: args.sourceType,
+        sourceId: args.sourceId
       });
       return;
     case "opportunity":
@@ -2721,7 +2739,6 @@ async function main() {
         state: args.state,
         action: args.action,
         message: args.message,
-        expectedTurnCount: args.expectedTurnCount,
         json: args.json
       });
       return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indexnetwork/cli",
-  "version": "0.29.0-rc.88.2",
+  "version": "0.30.0-rc.100.1",
   "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.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"
+    "@indexnetwork/cli-linux-x64": "0.30.0-rc.100.1",
+    "@indexnetwork/cli-linux-arm64": "0.30.0-rc.100.1",
+    "@indexnetwork/cli-darwin-x64": "0.30.0-rc.100.1",
+    "@indexnetwork/cli-darwin-arm64": "0.30.0-rc.100.1"
   },
   "devDependencies": {
     "@types/bun": "1.3.14"