@indexnetwork/cli 0.30.0-rc.96.1 → 0.30.0-rc.98.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. |

package/dist/index.js

@@ -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", "--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}`);
@@ -121,6 +121,12 @@ function parseArgs(args) {
         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;
@@ -451,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();
   }
@@ -466,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) {
@@ -1162,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)}`);
@@ -1671,15 +1684,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" }));
@@ -1739,7 +1763,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;
@@ -1750,16 +1774,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;
@@ -2694,7 +2718,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":

package/package.json

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