@nex-ai/nex 0.1.7

package/README.md

@@ -0,0 +1,228 @@
+# @nex-ai/nex
+
+Nex CLI provides organizational context & memory to AI agents across 10+ platforms.
+
+## Install
+
+```bash
+# Install globally
+npm install -g @nex-ai/nex
+
+# Or run directly (no install)
+npx @nex-ai/nex ask "who is Maria?"
+```
+
+## Quick Start
+
+```bash
+# 1. Register for an API key
+nex register --email you@company.com
+
+# 2. Set up your platforms (auto-detects installed tools)
+nex setup
+
+# 3. Query your knowledge
+nex ask "what's the latest on the Acme deal?"
+```
+
+## Supported Platforms
+
+`nex setup` auto-detects and configures these platforms:
+
+| Platform | Detection | Integration |
+|----------|-----------|-------------|
+| **Claude Code** | `~/.claude/` | Hooks (auto-recall, auto-capture, session start) + slash commands + MCP |
+| **Claude Desktop** | App config exists | MCP server |
+| **Cursor** | `~/.cursor/` | MCP server |
+| **VS Code (Copilot)** | `which code` or `.vscode/` | MCP server (workspace-level) |
+| **Windsurf** | `~/.codeium/windsurf/` | MCP server |
+| **Cline** | VS Code extension installed | MCP server (globalStorage config) |
+| **Continue.dev** | `.continue/` or `~/.continue/` | MCP server |
+| **Zed** | `~/.config/zed/` | MCP server (context_servers) |
+| **Kilo Code** | `.kilocode/` in project | MCP server |
+| **OpenCode** | `~/.config/opencode/` | MCP server |
+
+All MCP-based platforms use the same server entry:
+
+```json
+{
+  "nex": {
+    "command": "npx",
+    "args": ["-y", "@nex-crm/mcp-server"],
+    "env": { "NEX_API_KEY": "sk-..." }
+  }
+}
+```
+
+## Setup Command
+
+```bash
+nex setup                          # Auto-detect platforms, install Claude Code plugin, create .nex.toml
+nex setup --with-mcp               # Also write MCP config to all detected platforms
+nex setup --platform cursor        # Install for a specific platform only
+nex setup --no-plugin              # Only create config files, skip hooks/commands
+nex setup status                   # Show all platforms, install status, and connections
+```
+
+**Default behavior** (no flags):
+- Claude Code: installs hooks + slash commands (no MCP — avoids filling context windows)
+- Other platforms: detected but MCP not written until `--with-mcp` is passed
+- Creates `.nex.toml` project config with commented defaults
+- Syncs API key to `~/.nex-mcp.json` (shared config)
+
+> **Tip:** AI agents don't automatically know about Nex. Explicitly tell your agent to "use Nex for context and memory" in your prompts or CLAUDE.md instructions.
+
+## Project Config: `.nex.toml`
+
+Per-project settings file created by `nex setup`. All fields are optional.
+
+```toml
+[auth]
+# api_key = "sk-..."          # Prefer NEX_API_KEY env var or ~/.nex/config.json
+
+[hooks]
+# enabled = true              # Master kill switch for all hooks
+
+[hooks.recall]
+# enabled = true              # Auto-recall context on each prompt
+# debounce_ms = 30000
+
+[hooks.capture]
+# enabled = true              # Auto-capture on conversation stop
+# min_length = 20
+# max_length = 50000
+
+[hooks.session_start]
+# enabled = true              # Load context on session start
+
+[scan]
+# enabled = true
+# extensions = [".md", ".txt", ".csv", ".json", ".yaml", ".yml"]
+# ignore_dirs = ["node_modules", ".git", "dist", "build", "__pycache__"]
+# max_files = 5
+# max_file_size = 100000
+# depth = 2
+
+[mcp]
+# enabled = false             # Set to true by `nex setup --with-mcp`
+
+[output]
+# format = "text"             # "text" | "json"
+# timeout = 120000
+```
+
+**Resolution order:** CLI flags > `.nex.toml` > env vars > `~/.nex/config.json` > defaults
+
+## Commands
+
+### Knowledge Graph
+
+```bash
+nex ask <query>              # Query with natural language
+nex remember <content>       # Ingest text (meeting notes, emails, docs)
+nex recall <query>           # Query → XML-wrapped for agent injection
+nex capture [content]        # Rate-limited ingestion for agent hooks
+nex artifact <id>            # Check processing status
+nex search <query>           # Search CRM records by name
+nex insight list [--last 24h]  # Recent insights
+```
+
+### Integrations
+
+```bash
+nex integrate list                        # Show all integrations with connection status
+nex integrate connect email google        # Connect Gmail via OAuth
+nex integrate connect messaging slack     # Connect Slack
+nex integrate disconnect <id>             # Disconnect by connection ID
+```
+
+Supported providers: Gmail, Google Calendar, Outlook, Outlook Calendar, Slack, Attio, HubSpot, Salesforce.
+
+### CRM Records
+
+```bash
+nex object list              # List object types (person, company, deal)
+nex record list person --limit 10
+nex record create person --data '{"name":"Jane Doe"}'
+nex record upsert person --match email --data '{"name":"Jane","email":"jane@co.com"}'
+nex record update <id> --data '{"phone":"+1234"}'
+nex record delete <id>
+nex record timeline <id>
+```
+
+### Tasks & Notes
+
+```bash
+nex task create --title "Follow up" --priority high --due 2026-04-01
+nex task list --assignee me --search "follow up"
+nex task update <id> --completed
+nex note create --title "Call notes" --content "..." --entity <record-id>
+```
+
+### Relationships & Lists
+
+```bash
+nex rel list-defs
+nex rel create <record-id> --def <def-id> --entity1 <id1> --entity2 <id2>
+nex list list person
+nex list add-member <list-id> --parent <record-id>
+nex list-job create "enterprise contacts in EMEA"
+```
+
+### File Scanning
+
+On session start, Nex automatically scans project files and ingests changed content.
+
+**Default text-based extensions:** `.md`, `.txt`, `.csv`, `.json`, `.yaml`, `.yml`
+
+**Document formats** (handled separately): `.docx`, `.doc`, `.odt`, `.xlsx`, `.xls`, `.pptx`, `.ppt`, `.pdf`
+
+Configure via `.nex.toml` `[scan]` section or environment variables (`NEX_SCAN_ENABLED`, `NEX_SCAN_EXTENSIONS`, etc.).
+
+### Config & Sessions
+
+```bash
+nex config show              # Resolved config (key masked)
+nex config set default_format text
+nex config path              # ~/.nex/config.json
+nex session list             # Stored session mappings
+nex session clear
+```
+
+## Global Flags
+
+```
+--api-key <key>     Override API key (env: NEX_API_KEY)
+--format <fmt>      json | text (default for integrate list) | quiet
+--timeout <ms>      Request timeout (default: 120000)
+--session <id>      Session ID for multi-turn context
+--debug             Debug output on stderr
+```
+
+## Stdin Support
+
+`ask`, `remember`, and `capture` read from stdin when no argument is provided:
+
+```bash
+cat meeting-notes.txt | nex remember
+echo "what happened today?" | nex ask
+git diff | nex capture
+```
+
+## Exit Codes
+
+| Code | Meaning |
+|------|---------|
+| 0 | Success |
+| 1 | General error (server error, rate limit, invalid input) |
+| 2 | Auth error (no API key, invalid key, 401/403) |
+
+## Development
+
+```bash
+npm install
+npm run build     # TypeScript → dist/
+npm run dev       # Run with tsx (no build)
+npm test          # Unit tests
+NEX_DEV_URL=http://localhost:30000 nex ask "test"  # Local API
+```

package/dist/cli.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Commander program definition with global flags.
+ */
+import { Command } from "commander";
+export declare const program: Command;

package/dist/cli.js

@@ -0,0 +1,18 @@
+/**
+ * Commander program definition with global flags.
+ */
+import { Command } from "commander";
+import { createRequire } from "node:module";
+const require = createRequire(import.meta.url);
+const { version } = require("../package.json");
+export const program = new Command();
+program
+    .name("nex")
+    .description("Nex CLI — command-line interface for the Nex Developer API")
+    .version(version)
+    .option("--api-key <key>", "Override API key (env: NEX_API_KEY)")
+    .option("--format <fmt>", "Output format: json, text, quiet")
+    .option("--timeout <ms>", "Request timeout in milliseconds")
+    .option("--session <id>", "Session ID for multi-turn context")
+    .option("--debug", "Debug output on stderr");
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAwB,CAAC;AAEtE,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAErC,OAAO;KACJ,IAAI,CAAC,KAAK,CAAC;KACX,WAAW,CAAC,4DAA4D,CAAC;KACzE,OAAO,CAAC,OAAO,CAAC;KAChB,MAAM,CAAC,iBAAiB,EAAE,qCAAqC,CAAC;KAChE,MAAM,CAAC,gBAAgB,EAAE,kCAAkC,CAAC;KAC5D,MAAM,CAAC,gBAAgB,EAAE,iCAAiC,CAAC;KAC3D,MAAM,CAAC,gBAAgB,EAAE,mCAAmC,CAAC;KAC7D,MAAM,CAAC,SAAS,EAAE,wBAAwB,CAAC,CAAC"}

package/dist/commands/attribute.d.ts

@@ -0,0 +1,4 @@
+/**
+ * nex attribute — CRUD operations for object attributes.
+ */
+export {};

package/dist/commands/attribute.js

@@ -0,0 +1,75 @@
+/**
+ * nex attribute — CRUD operations for object attributes.
+ */
+import { program } from "../cli.js";
+import { NexClient } from "../lib/client.js";
+import { resolveApiKey, resolveFormat, resolveTimeout } from "../lib/config.js";
+import { printOutput } from "../lib/output.js";
+function getClient() {
+    const opts = program.opts();
+    const client = new NexClient(resolveApiKey(opts.apiKey), resolveTimeout(opts.timeout));
+    return { client, format: resolveFormat(opts.format) };
+}
+const attr = program.command("attribute").description("Manage object attributes");
+attr
+    .command("create")
+    .description("Create an attribute on an object")
+    .argument("<object-slug>", "Object slug")
+    .requiredOption("--name <name>", "Attribute name")
+    .requiredOption("--slug <slug>", "Attribute slug")
+    .requiredOption("--type <type>", "Attribute type")
+    .option("--description <description>", "Attribute description")
+    .option("--options <json>", "Options as JSON string")
+    .action(async (objectSlug, opts) => {
+    const { client, format } = getClient();
+    const body = { name: opts.name, slug: opts.slug, type: opts.type };
+    if (opts.description !== undefined)
+        body.description = opts.description;
+    if (opts.options) {
+        try {
+            body.options = JSON.parse(opts.options);
+        }
+        catch {
+            throw new Error(`Invalid JSON for --options: ${opts.options}`);
+        }
+    }
+    const result = await client.post(`/v1/objects/${encodeURIComponent(objectSlug)}/attributes`, body);
+    printOutput(result, format);
+});
+attr
+    .command("update")
+    .description("Update an attribute")
+    .argument("<object-slug>", "Object slug")
+    .argument("<attr-id>", "Attribute ID")
+    .option("--name <name>", "New name")
+    .option("--description <description>", "New description")
+    .option("--options <json>", "Options as JSON string")
+    .action(async (objectSlug, attrId, opts) => {
+    const { client, format } = getClient();
+    const body = {};
+    if (opts.name !== undefined)
+        body.name = opts.name;
+    if (opts.description !== undefined)
+        body.description = opts.description;
+    if (opts.options) {
+        try {
+            body.options = JSON.parse(opts.options);
+        }
+        catch {
+            throw new Error(`Invalid JSON for --options: ${opts.options}`);
+        }
+    }
+    const result = await client.patch(`/v1/objects/${encodeURIComponent(objectSlug)}/attributes/${encodeURIComponent(attrId)}`, body);
+    printOutput(result, format);
+});
+attr
+    .command("delete")
+    .description("Delete an attribute")
+    .argument("<object-slug>", "Object slug")
+    .argument("<attr-id>", "Attribute ID")
+    .action(async (objectSlug, attrId) => {
+    const { client, format } = getClient();
+    const result = await client.delete(`/v1/objects/${encodeURIComponent(objectSlug)}/attributes/${encodeURIComponent(attrId)}`);
+    printOutput(result, format);
+});
+//# sourceMappingURL=attribute.js.map

package/dist/commands/attribute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attribute.js","sourceRoot":"","sources":["../../src/commands/attribute.ts"],"names":[],"mappings":"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"}

package/dist/commands/config-cmd.d.ts

@@ -0,0 +1,4 @@
+/**
+ * nex config — view and update CLI configuration.
+ */
+export {};

package/dist/commands/config-cmd.js

@@ -0,0 +1,53 @@
+/**
+ * nex config — view and update CLI configuration.
+ */
+import { program } from "../cli.js";
+import { loadConfig, saveConfig, CONFIG_PATH, resolveApiKey, BASE_URL, } from "../lib/config.js";
+import { printOutput } from "../lib/output.js";
+import { resolveFormat } from "../lib/config.js";
+function maskApiKey(key) {
+    if (key.length <= 4)
+        return key;
+    return "****" + key.slice(-4);
+}
+const configCmd = program
+    .command("config")
+    .description("Manage CLI configuration");
+configCmd
+    .command("show")
+    .description("Show resolved configuration")
+    .action(() => {
+    const globalOpts = program.opts();
+    const format = resolveFormat(globalOpts.format);
+    const config = loadConfig();
+    const apiKey = resolveApiKey(globalOpts.apiKey);
+    const display = {
+        ...config,
+        api_key: apiKey ? maskApiKey(apiKey) : undefined,
+        base_url: BASE_URL,
+        config_path: CONFIG_PATH,
+    };
+    printOutput(display, format);
+});
+configCmd
+    .command("set")
+    .description("Set a configuration value")
+    .argument("<key>", "Config key to set")
+    .argument("<value>", "Value to set")
+    .action((key, value) => {
+    const config = loadConfig();
+    config[key] = value;
+    saveConfig(config);
+    const globalOpts = program.opts();
+    const format = resolveFormat(globalOpts.format);
+    printOutput({ [key]: value }, format);
+});
+configCmd
+    .command("path")
+    .description("Print the config file path")
+    .action(() => {
+    const globalOpts = program.opts();
+    const format = resolveFormat(globalOpts.format);
+    printOutput({ path: CONFIG_PATH }, format);
+});
+//# sourceMappingURL=config-cmd.js.map

package/dist/commands/config-cmd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-cmd.js","sourceRoot":"","sources":["../../src/commands/config-cmd.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EACL,UAAU,EACV,UAAU,EACV,WAAW,EACX,aAAa,EACb,QAAQ,GACT,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGjD,SAAS,UAAU,CAAC,GAAW;IAC7B,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC;QAAE,OAAO,GAAG,CAAC;IAChC,OAAO,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,SAAS,GAAG,OAAO;KACtB,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,0BAA0B,CAAC,CAAC;AAE3C,SAAS;KACN,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,6BAA6B,CAAC;KAC1C,MAAM,CAAC,GAAG,EAAE;IACX,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAClC,MAAM,MAAM,GAAG,aAAa,CAAC,UAAU,CAAC,MAAM,CAAW,CAAC;IAC1D,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,MAAM,GAAG,aAAa,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IAEhD,MAAM,OAAO,GAA4B;QACvC,GAAG,MAAM;QACT,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS;QAChD,QAAQ,EAAE,QAAQ;QAClB,WAAW,EAAE,WAAW;KACzB,CAAC;IAEF,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AAC/B,CAAC,CAAC,CAAC;AAEL,SAAS;KACN,OAAO,CAAC,KAAK,CAAC;KACd,WAAW,CAAC,2BAA2B,CAAC;KACxC,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;KACtC,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;KACnC,MAAM,CAAC,CAAC,GAAW,EAAE,KAAa,EAAE,EAAE;IACrC,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC3B,MAAkC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACjD,UAAU,CAAC,MAAM,CAAC,CAAC;IAEnB,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAClC,MAAM,MAAM,GAAG,aAAa,CAAC,UAAU,CAAC,MAAM,CAAW,CAAC;IAC1D,WAAW,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,EAAE,MAAM,CAAC,CAAC;AACxC,CAAC,CAAC,CAAC;AAEL,SAAS;KACN,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,4BAA4B,CAAC;KACzC,MAAM,CAAC,GAAG,EAAE;IACX,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAClC,MAAM,MAAM,GAAG,aAAa,CAAC,UAAU,CAAC,MAAM,CAAW,CAAC;IAC1D,WAAW,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,MAAM,CAAC,CAAC;AAC7C,CAAC,CAAC,CAAC"}

package/dist/commands/context.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Context commands: ask, remember, artifact, recall, capture.
+ */
+export {};

package/dist/commands/context.js

@@ -0,0 +1,135 @@
+/**
+ * Context commands: ask, remember, artifact, recall, capture.
+ */
+import { program } from "../cli.js";
+import { NexClient } from "../lib/client.js";
+import { resolveApiKey, resolveFormat, resolveTimeout } from "../lib/config.js";
+import { printOutput } from "../lib/output.js";
+import { shouldRecall, recordRecall } from "../lib/recall-filter.js";
+import { formatNexContext } from "../lib/context-format.js";
+import { captureFilter } from "../lib/capture-filter.js";
+import { RateLimiter } from "../lib/rate-limiter.js";
+import { SessionStore } from "../lib/session-store.js";
+function getClient() {
+    const opts = program.opts();
+    const client = new NexClient(resolveApiKey(opts.apiKey), resolveTimeout(opts.timeout));
+    return { client, format: resolveFormat(opts.format) };
+}
+async function readStdin() {
+    if (process.stdin.isTTY)
+        return undefined;
+    const chunks = [];
+    for await (const chunk of process.stdin) {
+        chunks.push(chunk);
+    }
+    const text = Buffer.concat(chunks).toString("utf-8").trim();
+    return text || undefined;
+}
+program
+    .command("ask")
+    .description("Ask a question against your Nex context")
+    .argument("[query]", "The question to ask")
+    .action(async (query) => {
+    const input = query ?? (await readStdin());
+    if (!input) {
+        throw new Error("No query provided. Pass as argument or pipe via stdin.");
+    }
+    const { client, format } = getClient();
+    const body = { query: input };
+    const sessionId = program.opts().session;
+    if (sessionId) {
+        body.session_id = sessionId;
+    }
+    const result = await client.post("/v1/context/ask", body);
+    printOutput(result, format);
+});
+program
+    .command("remember")
+    .description("Store content in your Nex context")
+    .argument("[content]", "The content to remember")
+    .option("--context <context>", "Additional context")
+    .action(async (content, opts) => {
+    const input = content ?? (await readStdin());
+    if (!input) {
+        throw new Error("No content provided. Pass as argument or pipe via stdin.");
+    }
+    const { client, format } = getClient();
+    const body = { content: input };
+    if (opts.context) {
+        body.context = opts.context;
+    }
+    const result = await client.post("/v1/context/text", body);
+    printOutput(result, format);
+});
+program
+    .command("artifact")
+    .description("Retrieve a context artifact by ID")
+    .argument("<id>", "Artifact ID")
+    .action(async (id) => {
+    const { client, format } = getClient();
+    const result = await client.get(`/v1/context/artifacts/${encodeURIComponent(id)}`);
+    printOutput(result, format);
+});
+program
+    .command("recall")
+    .description("Recall context for injection into LLM prompts")
+    .argument("[query]", "The query to recall context for")
+    .option("--first-prompt", "Treat as first prompt in session")
+    .action(async (query, opts) => {
+    const input = query ?? (await readStdin());
+    if (!input) {
+        throw new Error("No query provided. Pass as argument or pipe via stdin.");
+    }
+    const isFirst = opts?.firstPrompt ?? false;
+    const decision = shouldRecall(input, isFirst);
+    if (!decision.shouldRecall) {
+        process.exit(0);
+    }
+    const { client } = getClient();
+    const body = { query: input };
+    const sessionId = program.opts().session;
+    if (sessionId) {
+        body.session_id = sessionId;
+    }
+    const result = await client.post("/v1/context/ask", body);
+    recordRecall();
+    const formatted = formatNexContext({
+        answer: result.answer ?? "",
+        entityCount: result.entityCount ?? 0,
+        sessionId: result.sessionId,
+    });
+    process.stdout.write(formatted + "\n");
+});
+program
+    .command("capture")
+    .description("Capture content into Nex context with filtering and rate limiting")
+    .argument("[content]", "The content to capture")
+    .action(async (content) => {
+    const input = content ?? (await readStdin());
+    if (!input) {
+        throw new Error("No content provided. Pass as argument or pipe via stdin.");
+    }
+    const filtered = captureFilter(input);
+    if (filtered.skipped) {
+        process.stderr.write(`capture skipped: ${filtered.reason}\n`);
+        process.exit(0);
+    }
+    const limiter = new RateLimiter();
+    if (!limiter.canProceed()) {
+        process.stderr.write("capture skipped: rate limited\n");
+        process.exit(0);
+    }
+    const { client, format } = getClient();
+    const body = { content: filtered.text };
+    const sessionId = program.opts().session;
+    if (sessionId) {
+        const store = new SessionStore();
+        const existing = store.get(sessionId);
+        if (existing) {
+            body.session_id = existing;
+        }
+    }
+    const result = await client.post("/v1/context/text", body, 60_000);
+    printOutput(result, format);
+});
+//# sourceMappingURL=context.js.map

package/dist/commands/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/commands/context.ts"],"names":[],"mappings":"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"}

package/dist/commands/insight.d.ts

@@ -0,0 +1,4 @@
+/**
+ * nex insight — list insights from your Nex workspace.
+ */
+export {};

package/dist/commands/insight.js

@@ -0,0 +1,39 @@
+/**
+ * nex insight — list insights from your Nex workspace.
+ */
+import { program } from "../cli.js";
+import { NexClient } from "../lib/client.js";
+import { resolveApiKey, resolveFormat, resolveTimeout } from "../lib/config.js";
+import { printOutput } from "../lib/output.js";
+function getClient() {
+    const opts = program.opts();
+    const client = new NexClient(resolveApiKey(opts.apiKey), resolveTimeout(opts.timeout));
+    return { client, format: resolveFormat(opts.format) };
+}
+const insightCmd = program
+    .command("insight")
+    .description("Manage insights");
+insightCmd
+    .command("list")
+    .description("List insights")
+    .option("--last <duration>", "Time duration (e.g. 7d, 24h)")
+    .option("--from <date>", "Start date (ISO 8601)")
+    .option("--to <date>", "End date (ISO 8601)")
+    .option("--limit <n>", "Maximum number of results")
+    .action(async (opts) => {
+    const { client, format } = getClient();
+    const params = new URLSearchParams();
+    if (opts.last)
+        params.set("last", opts.last);
+    if (opts.from)
+        params.set("from", opts.from);
+    if (opts.to)
+        params.set("to", opts.to);
+    if (opts.limit)
+        params.set("limit", opts.limit);
+    const qs = params.toString();
+    const path = `/v1/insights${qs ? `?${qs}` : ""}`;
+    const result = await client.get(path);
+    printOutput(result, format);
+});
+//# sourceMappingURL=insight.js.map

package/dist/commands/insight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"insight.js","sourceRoot":"","sources":["../../src/commands/insight.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAChF,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG/C,SAAS,SAAS;IAChB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAC5B,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IACvF,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,CAAC,IAAI,CAAC,MAAM,CAAW,EAAE,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,GAAG,OAAO;KACvB,OAAO,CAAC,SAAS,CAAC;KAClB,WAAW,CAAC,iBAAiB,CAAC,CAAC;AAElC,UAAU;KACP,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,eAAe,CAAC;KAC5B,MAAM,CAAC,mBAAmB,EAAE,8BAA8B,CAAC;KAC3D,MAAM,CAAC,eAAe,EAAE,uBAAuB,CAAC;KAChD,MAAM,CAAC,aAAa,EAAE,qBAAqB,CAAC;KAC5C,MAAM,CAAC,aAAa,EAAE,2BAA2B,CAAC;KAClD,MAAM,CAAC,KAAK,EAAE,IAAmE,EAAE,EAAE;IACpF,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,EAAE,CAAC;IAEvC,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;IACrC,IAAI,IAAI,CAAC,IAAI;QAAE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7C,IAAI,IAAI,CAAC,IAAI;QAAE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7C,IAAI,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;IACvC,IAAI,IAAI,CAAC,KAAK;QAAE,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IAEhD,MAAM,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;IAC7B,MAAM,IAAI,GAAG,eAAe,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IAEjD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACtC,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAC9B,CAAC,CAAC,CAAC"}

package/dist/commands/integrate.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Integration commands: list, connect, disconnect.
+ */
+export {};