@indexnetwork/cli 0.7.0

package/README.md

@@ -0,0 +1,163 @@
+# Index CLI
+
+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.
+
+## Quick Start
+
+```bash
+# Build the binary
+bun run build
+
+# Authenticate (opens browser)
+./dist/index login
+
+# Start chatting
+./dist/index conversation
+```
+
+## Commands
+
+### `index login`
+
+Authenticate with Index Network. Opens a browser window that exchanges your existing session for a CLI token, or starts a fresh OAuth flow.
+
+```bash
+index login                     # Browser-based auth (default)
+index login --token <jwt>       # Manual token (skip browser)
+index login --api-url <url>     # Custom server URL
+```
+
+Credentials are stored in `~/.index/credentials.json`.
+
+### `index logout`
+
+Clear stored credentials.
+
+```bash
+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).
+
+```bash
+index conversation                          # Interactive AI chat REPL
+index conversation "find me collaborators"  # One-shot message to AI agent
+index conversation --session <id>           # Resume an AI 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
+index conversation show <id>               # Show messages
+index conversation send <id> <msg>         # Send a message
+index conversation stream                  # Real-time SSE stream
+```
+
+### `index profile`
+
+View user profiles and trigger profile regeneration.
+
+```bash
+index profile                       # Show your own profile
+index profile show <user-id>        # Show another user's profile
+index profile sync                  # Regenerate your profile
+```
+
+### `index opportunity`
+
+Browse and manage discovered opportunities.
+
+```bash
+index opportunity list                     # List all opportunities
+index opportunity list --status pending    # Filter by status
+index opportunity list --limit 5           # Limit results
+index opportunity show <id>                # Show full details
+index opportunity accept <id>              # Accept an opportunity
+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.
+
+```bash
+index network list                     # List your networks
+index network create "My Network"      # Create a network
+index network create "AI" --prompt "AI researchers"  # Create with description
+index network show <id>                # Show details and members
+index network join <id>                # Join a public network
+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`) |
+| `--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 |
+| `--prompt <text>` | `-p` | Network description (for `network create`) |
+| `--help` | `-h` | Show help |
+| `--version` | `-v` | Show version |
+
+## Development
+
+```bash
+# Run directly with Bun (no build step)
+bun src/main.ts chat
+
+# Build a standalone binary
+bun run build        # outputs to dist/index
+
+# Run tests
+bun test
+```
+
+### Project Structure
+
+```
+cli/
+  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
+```
+
+## Roadmap
+
+Commands planned for future iterations:
+
+- ~~`index network` — Manage indexes and memberships~~ (shipped!)
+- ~~`index conversation` — H2H and A2A messaging~~ (shipped!)

package/bin/index.cjs

@@ -0,0 +1,110 @@
+#!/usr/bin/env node
+
+/**
+ * Thin bin shim for @indexnetwork/cli.
+ *
+ * Resolves and executes the platform-specific precompiled binary from
+ * the corresponding optional dependency package. If no platform binary
+ * is available, falls back to running the bundled JS via Node or Bun.
+ *
+ * This file must remain plain JavaScript (no TypeScript, no bundling)
+ * so it works immediately after npm install without a build step.
+ */
+
+"use strict";
+
+const { execFileSync } = require("child_process");
+const { existsSync } = require("fs");
+const path = require("path");
+
+/**
+ * Construct the npm package name for the current platform binary.
+ *
+ * @param {string} os - The operating system (e.g. "linux", "darwin").
+ * @param {string} arch - The CPU architecture (e.g. "x64", "arm64").
+ * @returns {string} The scoped package name.
+ */
+function platformPackageName(os, arch) {
+  return `@indexnetwork/cli-${os}-${arch}`;
+}
+
+/**
+ * Attempt to resolve the path to the platform binary.
+ *
+ * @returns {string|null} Absolute path to the binary, or null if not found.
+ */
+function resolvePlatformBinary() {
+  const pkg = platformPackageName(process.platform, process.arch);
+
+  try {
+    // require.resolve finds the package in node_modules, even when hoisted
+    const pkgJson = require.resolve(`${pkg}/package.json`);
+    const pkgDir = path.dirname(pkgJson);
+    const binPath = path.join(pkgDir, "bin", "index");
+
+    if (existsSync(binPath)) {
+      return binPath;
+    }
+  } catch {
+    // Package not installed — expected on unsupported platforms
+  }
+
+  return null;
+}
+
+/**
+ * Resolve the bundled JS fallback path.
+ *
+ * @returns {string|null} Absolute path to dist/index.js, or null if not found.
+ */
+function resolveFallbackJs() {
+  const fallback = path.join(__dirname, "..", "dist", "index.js");
+  if (existsSync(fallback)) {
+    return fallback;
+  }
+  return null;
+}
+
+// ── Main ──────────────────────────────────────────────────────────────
+
+const args = process.argv.slice(2);
+
+// Strategy 1: platform-specific precompiled binary
+const binary = resolvePlatformBinary();
+if (binary) {
+  try {
+    execFileSync(binary, args, { stdio: "inherit" });
+  } catch (err) {
+    process.exitCode = err.status || 1;
+  }
+  process.exit();
+}
+
+// Strategy 2: bundled JS fallback via bun or node
+const fallbackJs = resolveFallbackJs();
+if (fallbackJs) {
+  // Prefer bun if available, otherwise node
+  const runtime = (() => {
+    try {
+      execFileSync("bun", ["--version"], { stdio: "ignore" });
+      return "bun";
+    } catch {
+      return process.execPath; // node
+    }
+  })();
+
+  try {
+    execFileSync(runtime, [fallbackJs, ...args], { stdio: "inherit" });
+  } catch (err) {
+    process.exitCode = err.status || 1;
+  }
+  process.exit();
+}
+
+// No binary, no fallback — report error
+console.error(
+  `@indexnetwork/cli: No precompiled binary found for ${process.platform}-${process.arch},\n` +
+  `and no bundled JS fallback available at dist/index.js.\n\n` +
+  `Try reinstalling: npm install -g @indexnetwork/cli`
+);
+process.exit(1);