@usenaive-sdk/cli 0.1.0

package/README.md

@@ -0,0 +1,197 @@
+# @usenaive/cli
+
+Command-line interface for the Naive API v2. Register, manage identity, and use all primitives directly from the terminal.
+
+## What It Provides
+
+- **Auth & Onboarding** — Register new accounts, login, link existing ones, manage API keys
+- **Identity** — View agent profile, company, email inboxes, resources
+- **Domains** — List domains, connect custom domains (BYOD), view DNS records, verify
+- **Email** — Create/delete inboxes, send emails, read inboxes
+- **Search** — Web search, URL extraction, deep research
+- **Images** — Generate via fal.ai, search stock photos (dynamic pricing)
+- **Video** — Generate via fal.ai (dynamic pricing)
+- **Jobs** — List, inspect, and cancel async jobs
+- **Status** — Credit balance and usage history
+
+## Local Development
+
+### Prerequisites
+
+- Node.js 20+
+- pnpm 9+
+
+### Setup
+
+```bash
+# From monorepo root
+pnpm install
+```
+
+### Run (development)
+
+```bash
+# Run any command directly with tsx
+pnpm --filter @usenaive/cli dev -- register --name "Test" --email test@example.com
+
+# Or from packages/cli
+cd packages/cli
+pnpm dev -- search "AI frameworks"
+```
+
+### Build
+
+```bash
+pnpm --filter @usenaive/cli build
+```
+
+### Link locally (test as global binary)
+
+```bash
+cd packages/cli
+pnpm link --global
+naive --help
+```
+
+## Usage
+
+### Configuration
+
+The CLI stores config at `~/.naive/config.json`:
+
+```json
+{
+  "api_key": "nv_sk_live_...",
+  "base_url": "https://api.usenaive.ai"
+}
+```
+
+Set via registration or environment:
+
+```bash
+# Auto-saved on register/login/link
+naive register --name "My Agent" --email owner@example.com --password yourpassword
+
+# Or set manually
+export NAIVE_API_KEY=nv_sk_live_...
+export NAIVE_BASE_URL=http://localhost:3100  # for local dev
+```
+
+### Commands
+
+```bash
+# Auth
+naive register --name "Agent" --email user@example.com --password mypassword --company "Acme"
+naive login --email user@example.com --password mypassword
+naive link --email existing@example.com
+naive whoami
+naive companies
+naive keys list
+naive keys create "Production"
+naive keys revoke <key-id>
+
+# Identity
+naive identity
+naive identity emails
+naive identity resources
+
+# Domains
+naive domains                             # List all domains
+naive domains connect example.com         # Connect a custom domain (BYOD)
+naive domains dns-records <domain-id>     # Show required DNS records
+naive domains verify <domain-id>          # Trigger domain verification
+
+# Email
+naive email inboxes
+naive email create --local-part hello     # Create new inbox on active domain
+naive email delete <inbox-id>             # Delete an inbox
+naive email send --from-inbox <uuid> --to user@example.com --subject "Hi" --body "Hello"
+naive email inbox --inbox <uuid> --limit 20
+naive email read <email-id>
+
+# Search
+naive search "AI agent frameworks"
+naive search url https://example.com --extract "Main points?"
+naive search research "Compare React vs Astro" --depth thorough --wait
+
+# Images
+naive images generate "A tech logo" --model "fal-ai/flux-pro/v1.1" --wait
+naive images generate --input '{"prompt":"...","num_images":2}' --wait
+naive images status <job-id>
+naive images stock "office workspace" --count 5
+naive images models
+
+# Video
+naive video generate "Dog on beach" --model "fal-ai/kling-video/v3/pro/text-to-video" --duration 5 --wait
+naive video status <job-id>
+naive video models
+
+# Jobs
+naive jobs
+naive jobs --status processing
+naive jobs get <job-id>
+naive jobs cancel <job-id>
+
+# Status
+naive status
+naive usage --days 7
+```
+
+### Global Options
+
+```
+--api-key <key>    Override API key (env: NAIVE_API_KEY)
+--base-url <url>   Override base URL (env: NAIVE_BASE_URL)
+--help             Show help
+--version          Show version
+```
+
+## Production / Publishing
+
+### Publish to npm
+
+```bash
+cd packages/cli
+pnpm build
+npm publish --access public
+```
+
+Users install with:
+
+```bash
+npm install -g @usenaive/cli
+naive --help
+```
+
+### Use without installing
+
+```bash
+npx @usenaive/cli register --name "My Agent" --email user@example.com
+npx @usenaive/cli search "AI frameworks"
+```
+
+## Architecture
+
+```
+src/
+├── index.ts          # Entry point, commander program setup
+├── config.ts         # ~/.naive/config.json read/write
+├── client.ts         # HTTP client (fetch wrapper with auth + error handling)
+├── output.ts         # Structured agent-native JSON output (agentOutput/agentError)
+└── commands/
+    ├── register.ts   # naive register
+    ├── login.ts      # naive login
+    ├── link.ts       # naive link
+    ├── whoami.ts     # naive whoami
+    ├── companies.ts  # naive companies
+    ├── keys.ts       # naive keys
+    ├── identity.ts   # naive identity
+    ├── status.ts     # naive status
+    ├── usage.ts      # naive usage
+    ├── domains.ts    # naive domains (list/connect/dns-records/verify)
+    ├── email.ts      # naive email (inboxes/create/delete/send/inbox/read)
+    ├── search.ts     # naive search (web/url/research)
+    ├── images.ts     # naive images (generate/stock/models)
+    ├── video.ts      # naive video (generate/models)
+    └── jobs.ts       # naive jobs (list/get/cancel)
+```

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@usenaive-sdk/cli",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "CLI for Naive AI Business Primitives API",
+  "license": "MIT",
+  "bin": {
+    "naive": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "dev": "tsx src/index.ts",
+    "build": "tsc",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "commander": "^13.1.0",
+    "chalk": "^5.4.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.3",
+    "tsx": "^4.19.4",
+    "typescript": "^5.7.3"
+  }
+}