@nex-ai/nex 0.1.8 → 0.1.10

package/dist/plugin/auto-recall.js

@@ -0,0 +1,111 @@
+#!/usr/bin/env node
+/**
+ * Claude Code UserPromptSubmit hook — auto-recall from Nex.
+ *
+ * Reads the user's prompt from stdin, runs it through the recall filter
+ * to decide if recall is needed, queries Nex for relevant context,
+ * and outputs { additionalContext: "..." } to inject into the conversation.
+ *
+ * On ANY error: outputs {} and exits 0 (graceful degradation).
+ */
+import { loadConfig, isHookEnabled } from "./config.js";
+import { NexClient } from "./nex-client.js";
+import { formatNexContext } from "./context-format.js";
+import { SessionStore } from "./session-store.js";
+import { shouldRecall, recordRecall } from "./recall-filter.js";
+const sessions = new SessionStore();
+/**
+ * Check if this is the first prompt for this session.
+ * A session with no stored Nex session ID is considered "first prompt"
+ * (SessionStart may have already set one, but that's fine — it means
+ * baseline context was loaded, and first user prompt still gets recall).
+ */
+function isFirstPrompt(sessionKey) {
+    if (!sessionKey)
+        return true;
+    return !sessions.get(sessionKey);
+}
+async function main() {
+    try {
+        // Read stdin
+        const chunks = [];
+        for await (const chunk of process.stdin) {
+            chunks.push(chunk);
+        }
+        const raw = Buffer.concat(chunks).toString("utf-8");
+        let input;
+        try {
+            input = JSON.parse(raw);
+        }
+        catch {
+            process.stderr.write("[nex-recall] Failed to parse stdin JSON\n");
+            process.stdout.write("{}");
+            return;
+        }
+        // Check .nex.toml kill switch
+        if (!isHookEnabled("recall")) {
+            process.stdout.write("{}");
+            return;
+        }
+        const prompt = input.prompt?.trim();
+        if (!prompt || prompt.length < 5) {
+            process.stdout.write("{}");
+            return;
+        }
+        // Skip slash commands
+        if (prompt.startsWith("/")) {
+            process.stdout.write("{}");
+            return;
+        }
+        // --- Recall filter: decide if this prompt needs memory recall ---
+        const decision = shouldRecall(prompt, isFirstPrompt(input.session_id));
+        if (!decision.shouldRecall) {
+            process.stdout.write("{}");
+            return;
+        }
+        let cfg;
+        try {
+            cfg = loadConfig();
+        }
+        catch (err) {
+            process.stderr.write(`[nex-recall] Config error: ${err instanceof Error ? err.message : String(err)}\n`);
+            process.stdout.write("{}");
+            return;
+        }
+        const client = new NexClient(cfg.apiKey, cfg.baseUrl);
+        // Resolve session ID for multi-turn continuity
+        const sessionKey = input.session_id;
+        const nexSessionId = sessionKey ? sessions.get(sessionKey) : undefined;
+        const result = await client.ask(prompt, nexSessionId, 10_000);
+        if (!result.answer) {
+            process.stdout.write("{}");
+            return;
+        }
+        // Store session ID for future turns
+        if (result.session_id && sessionKey) {
+            sessions.set(sessionKey, result.session_id);
+        }
+        // Record successful recall for debounce
+        recordRecall(result.session_id);
+        const entityCount = result.entity_references?.length ?? 0;
+        const context = formatNexContext({
+            answer: result.answer,
+            entityCount,
+            sessionId: result.session_id,
+        });
+        // Use hookSpecificOutput for discrete context injection (not shown in transcript)
+        const output = JSON.stringify({
+            hookSpecificOutput: {
+                hookEventName: "UserPromptSubmit",
+                additionalContext: context,
+            },
+        });
+        process.stdout.write(output);
+    }
+    catch (err) {
+        process.stderr.write(`[nex-recall] Unexpected error: ${err instanceof Error ? err.message : String(err)}\n`);
+        process.stdout.write("{}");
+    }
+}
+main().then(() => process.exit(0)).catch(() => process.exit(0));
+//# sourceMappingURL=auto-recall.js.map

package/dist/plugin/auto-recall.js.map

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

package/dist/plugin/auto-register.d.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+/**
+ * Registration entry point — creates a Nex account and persists the API key.
+ *
+ * Usage: node dist/auto-register.js <email> [name] [company]
+ *
+ * On success: prints API key and saves to ~/.nex-mcp.json (shared with MCP server).
+ * If already registered (API key exists): prints status and exits.
+ */
+export {};

package/dist/plugin/auto-register.js

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+/**
+ * Registration entry point — creates a Nex account and persists the API key.
+ *
+ * Usage: node dist/auto-register.js <email> [name] [company]
+ *
+ * On success: prints API key and saves to ~/.nex-mcp.json (shared with MCP server).
+ * If already registered (API key exists): prints status and exits.
+ */
+import { loadMcpConfig, persistRegistration, loadBaseUrl, MCP_CONFIG_PATH } from "./config.js";
+import { NexClient } from "./nex-client.js";
+async function main() {
+    const email = process.argv[2];
+    const name = process.argv[3];
+    const company = process.argv[4];
+    if (!email) {
+        console.error("Usage: auto-register.js <email> [name] [company]");
+        process.exit(1);
+    }
+    // Check if already registered
+    const existing = loadMcpConfig();
+    if (existing.api_key) {
+        console.log("Already registered.");
+        console.log(`  API key: ${existing.api_key.slice(0, 12)}...`);
+        console.log(`  Config: ${MCP_CONFIG_PATH}`);
+        console.log("\nTo re-register, delete ~/.nex-mcp.json first.");
+        return;
+    }
+    const baseUrl = loadBaseUrl();
+    console.log(`Registering ${email} at ${baseUrl} ...`);
+    try {
+        const result = await NexClient.register(baseUrl, email, name, company);
+        if (!result.api_key) {
+            console.error("Registration succeeded but no API key returned.");
+            console.error("Response:", JSON.stringify(result, null, 2));
+            process.exit(1);
+        }
+        // Persist to shared config
+        persistRegistration(result);
+        console.log("Registration successful!");
+        console.log(`  API key: ${result.api_key.slice(0, 12)}...`);
+        if (result.workspace_slug)
+            console.log(`  Workspace: ${result.workspace_slug}`);
+        console.log(`  Saved to: ${MCP_CONFIG_PATH}`);
+        console.log("\nAll Nex memory features are now active. No restart needed.");
+    }
+    catch (err) {
+        console.error(`Registration failed: ${err instanceof Error ? err.message : String(err)}`);
+        process.exit(1);
+    }
+}
+main();
+//# sourceMappingURL=auto-register.js.map

package/dist/plugin/auto-register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-register.js","sourceRoot":"","sources":["../../src/plugin/auto-register.ts"],"names":[],"mappings":";AACA;;;;;;;GAOG;AAEH,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC/F,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,KAAK,UAAU,IAAI;IACjB,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC9B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC7B,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAEhC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,CAAC,KAAK,CAAC,kDAAkD,CAAC,CAAC;QAClE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,8BAA8B;IAC9B,MAAM,QAAQ,GAAG,aAAa,EAAE,CAAC;IACjC,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;QACrB,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;QACnC,OAAO,CAAC,GAAG,CAAC,cAAc,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC;QAC9D,OAAO,CAAC,GAAG,CAAC,aAAa,eAAe,EAAE,CAAC,CAAC;QAC5C,OAAO,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAC;QAC/D,OAAO;IACT,CAAC;IAED,MAAM,OAAO,GAAG,WAAW,EAAE,CAAC;IAC9B,OAAO,CAAC,GAAG,CAAC,eAAe,KAAK,OAAO,OAAO,MAAM,CAAC,CAAC;IAEtD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QAEvE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO,CAAC,KAAK,CAAC,iDAAiD,CAAC,CAAC;YACjE,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAC5D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,2BAA2B;QAC3B,mBAAmB,CAAC,MAAiC,CAAC,CAAC;QAEvD,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;QACxC,OAAO,CAAC,GAAG,CAAC,cAAc,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC;QAC5D,IAAI,MAAM,CAAC,cAAc;YAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC;QAChF,OAAO,CAAC,GAAG,CAAC,eAAe,eAAe,EAAE,CAAC,CAAC;QAC9C,OAAO,CAAC,GAAG,CAAC,8DAA8D,CAAC,CAAC;IAC9E,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,wBAAwB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC1F,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC"}

package/dist/plugin/auto-scan.d.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+/**
+ * Standalone entry point for the /scan slash command.
+ *
+ * Reads optional directory from argv[2] or stdin, scans for project files,
+ * and ingests changed ones into Nex. Prints results to stdout.
+ *
+ * Usage: node dist/auto-scan.js [directory]
+ */
+export {};

package/dist/plugin/auto-scan.js

@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+/**
+ * Standalone entry point for the /scan slash command.
+ *
+ * Reads optional directory from argv[2] or stdin, scans for project files,
+ * and ingests changed ones into Nex. Prints results to stdout.
+ *
+ * Usage: node dist/auto-scan.js [directory]
+ */
+import { loadConfig, loadScanConfig } from "./config.js";
+import { NexClient } from "./nex-client.js";
+import { RateLimiter } from "./rate-limiter.js";
+import { scanAndIngest } from "./file-scanner.js";
+async function main() {
+    try {
+        // Determine target directory: argv[2] > cwd
+        const targetDir = process.argv[2] || process.cwd();
+        let cfg;
+        try {
+            cfg = loadConfig();
+        }
+        catch (err) {
+            console.error(`Config error: ${err instanceof Error ? err.message : String(err)}`);
+            process.exit(1);
+        }
+        const scanConfig = loadScanConfig();
+        if (!scanConfig.enabled) {
+            console.log("File scanning is disabled (NEX_SCAN_ENABLED=false).");
+            return;
+        }
+        const client = new NexClient(cfg.apiKey, cfg.baseUrl);
+        const rateLimiter = new RateLimiter();
+        console.log(`Scanning ${targetDir} ...`);
+        const result = await scanAndIngest(client, rateLimiter, targetDir, scanConfig);
+        console.log(`Scan complete:`);
+        console.log(`  Scanned: ${result.scanned} files`);
+        console.log(`  Ingested: ${result.ingested} files`);
+        console.log(`  Skipped: ${result.skipped} files (unchanged)`);
+        if (result.errors > 0) {
+            console.log(`  Errors: ${result.errors}`);
+        }
+    }
+    catch (err) {
+        console.error(`Scan failed: ${err instanceof Error ? err.message : String(err)}`);
+        process.exit(1);
+    }
+}
+main();
+//# sourceMappingURL=auto-scan.js.map

package/dist/plugin/auto-scan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-scan.js","sourceRoot":"","sources":["../../src/plugin/auto-scan.ts"],"names":[],"mappings":";AACA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,KAAK,UAAU,IAAI;IACjB,IAAI,CAAC;QACH,4CAA4C;QAC5C,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QAEnD,IAAI,GAAG,CAAC;QACR,IAAI,CAAC;YACH,GAAG,GAAG,UAAU,EAAE,CAAC;QACrB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,iBAAiB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACnF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,UAAU,GAAG,cAAc,EAAE,CAAC;QACpC,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;YACxB,OAAO,CAAC,GAAG,CAAC,qDAAqD,CAAC,CAAC;YACnE,OAAO;QACT,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;QACtD,MAAM,WAAW,GAAG,IAAI,WAAW,EAAE,CAAC;QAEtC,OAAO,CAAC,GAAG,CAAC,YAAY,SAAS,MAAM,CAAC,CAAC;QACzC,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;QAE/E,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;QAC9B,OAAO,CAAC,GAAG,CAAC,cAAc,MAAM,CAAC,OAAO,QAAQ,CAAC,CAAC;QAClD,OAAO,CAAC,GAAG,CAAC,eAAe,MAAM,CAAC,QAAQ,QAAQ,CAAC,CAAC;QACpD,OAAO,CAAC,GAAG,CAAC,cAAc,MAAM,CAAC,OAAO,oBAAoB,CAAC,CAAC;QAC9D,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,OAAO,CAAC,GAAG,CAAC,aAAa,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,gBAAgB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC"}

package/dist/plugin/auto-session-start.d.ts

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+/**
+ * Claude Code SessionStart hook — bulk context load from Nex + file scan.
+ *
+ * Fires once when a new Claude Code session begins. Queries Nex for
+ * a baseline context summary and injects it so the agent "already knows"
+ * relevant business context from the first message.
+ *
+ * On startup/clear: also scans project files and ingests changed ones.
+ * On compact/resume: skips file scan (files already ingested, just re-query summary).
+ *
+ * On ANY error: outputs {} and exits 0 (graceful degradation).
+ */
+export {};

package/dist/plugin/auto-session-start.js

@@ -0,0 +1,146 @@
+#!/usr/bin/env node
+/**
+ * Claude Code SessionStart hook — bulk context load from Nex + file scan.
+ *
+ * Fires once when a new Claude Code session begins. Queries Nex for
+ * a baseline context summary and injects it so the agent "already knows"
+ * relevant business context from the first message.
+ *
+ * On startup/clear: also scans project files and ingests changed ones.
+ * On compact/resume: skips file scan (files already ingested, just re-query summary).
+ *
+ * On ANY error: outputs {} and exits 0 (graceful degradation).
+ */
+import { loadConfig, loadScanConfig, ConfigError, isHookEnabled } from "./config.js";
+import { NexClient } from "./nex-client.js";
+import { RateLimiter } from "./rate-limiter.js";
+import { formatNexContext } from "./context-format.js";
+import { SessionStore } from "./session-store.js";
+import { recordRecall } from "./recall-filter.js";
+import { scanAndIngest } from "./file-scanner.js";
+import { ingestContextFiles } from "./context-files.js";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+const sessions = new SessionStore();
+const SESSION_START_QUERY = "Summarize the key active context, recent interactions, and important updates for this user.";
+async function main() {
+    try {
+        // Read stdin
+        const chunks = [];
+        for await (const chunk of process.stdin) {
+            chunks.push(chunk);
+        }
+        const raw = Buffer.concat(chunks).toString("utf-8");
+        // Check .nex.toml kill switch
+        if (!isHookEnabled("session_start")) {
+            process.stdout.write("{}");
+            return;
+        }
+        let input = {};
+        try {
+            input = JSON.parse(raw);
+        }
+        catch {
+            process.stderr.write("[nex-session-start] Failed to parse stdin JSON, continuing with defaults\n");
+        }
+        let cfg;
+        try {
+            cfg = loadConfig();
+        }
+        catch (err) {
+            if (err instanceof ConfigError) {
+                // No API key — inject registration prompt so Claude handles it
+                const pluginDir = dirname(fileURLToPath(import.meta.url));
+                const registerScript = join(pluginDir, "auto-register.js");
+                const registrationPrompt = [
+                    "[Nex Memory Plugin] No API key configured. Registration is required to enable persistent memory.",
+                    "",
+                    "IMPORTANT: Before proceeding with the user's request, you must set up Nex memory:",
+                    "1. Ask the user for their email address to register for a Nex account",
+                    "2. Run the registration command: node " + registerScript + " <email> [name] [company]",
+                    "3. Once registration succeeds, the API key is saved automatically — all memory features activate immediately",
+                    "",
+                    "Keep it brief — just ask for the email and register. No restart needed after registration.",
+                ].join("\n");
+                const output = JSON.stringify({
+                    hookSpecificOutput: {
+                        hookEventName: "SessionStart",
+                        additionalContext: registrationPrompt,
+                    },
+                });
+                process.stdout.write(output);
+                return;
+            }
+            process.stderr.write(`[nex-session-start] Config error: ${err instanceof Error ? err.message : String(err)}\n`);
+            process.stdout.write("{}");
+            return;
+        }
+        const client = new NexClient(cfg.apiKey, cfg.baseUrl);
+        const contextParts = [];
+        // --- File scan on startup or clear ---
+        const source = input.source ?? "startup";
+        const shouldScan = source === "startup" || source === "clear";
+        if (shouldScan) {
+            const rateLimiter = new RateLimiter();
+            const cwd = process.cwd();
+            // --- Ingest CLAUDE.md + memory files (highest priority) ---
+            try {
+                const ctxResult = await ingestContextFiles(client, rateLimiter, cwd);
+                if (ctxResult.ingested > 0) {
+                    contextParts.push(`[Context files: ${ctxResult.ingested} ingested (${ctxResult.files.join(", ")})]`);
+                }
+            }
+            catch (err) {
+                process.stderr.write(`[nex-session-start] Context files error: ${err instanceof Error ? err.message : String(err)}\n`);
+            }
+            // --- Project file scan ---
+            try {
+                const scanConfig = loadScanConfig();
+                if (scanConfig.enabled) {
+                    const scanResult = await scanAndIngest(client, rateLimiter, cwd, scanConfig);
+                    if (scanResult.ingested > 0) {
+                        contextParts.push(`[File scan: ${scanResult.ingested} file${scanResult.ingested === 1 ? "" : "s"} ingested, ${scanResult.scanned} scanned]`);
+                    }
+                }
+            }
+            catch (err) {
+                process.stderr.write(`[nex-session-start] File scan error: ${err instanceof Error ? err.message : String(err)}\n`);
+            }
+        }
+        // --- Nex context query ---
+        const result = await client.ask(SESSION_START_QUERY, undefined, 10_000);
+        if (!result.answer && contextParts.length === 0) {
+            process.stdout.write("{}");
+            return;
+        }
+        // Store session mapping
+        if (result.session_id && input.session_id) {
+            sessions.set(input.session_id, result.session_id);
+        }
+        // Record this as a successful recall for debounce
+        recordRecall(result.session_id);
+        const entityCount = result.entity_references?.length ?? 0;
+        const context = formatNexContext({
+            answer: result.answer,
+            entityCount,
+            sessionId: result.session_id,
+        });
+        // Append scan summary if any
+        const fullContext = contextParts.length > 0
+            ? `${context}\n${contextParts.join("\n")}`
+            : context;
+        const output = JSON.stringify({
+            hookSpecificOutput: {
+                hookEventName: "SessionStart",
+                additionalContext: fullContext,
+            },
+        });
+        process.stdout.write(output);
+    }
+    catch (err) {
+        process.stderr.write(`[nex-session-start] Unexpected error: ${err instanceof Error ? err.message : String(err)}\n`);
+        process.stdout.write("{}");
+    }
+}
+main().then(() => process.exit(0)).catch(() => process.exit(0));
+//# sourceMappingURL=auto-session-start.js.map

package/dist/plugin/auto-session-start.js.map

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

package/dist/plugin/capture-filter.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Capture filtering for Claude Code — decides what content to send to Nex.
+ * Adapted from openclaw-plugin for plain string input.
+ */
+export interface CaptureResult {
+    text: string;
+    skipped: false;
+}
+export interface CaptureSkip {
+    reason: string;
+    skipped: true;
+}
+/**
+ * Filter text for capture eligibility.
+ * Works with plain strings (Claude Code messages).
+ *
+ * Note: Deduplication is handled server-side by the Nex extraction pipeline.
+ * Since hooks are short-lived processes (new process per invocation), in-memory
+ * dedup caches would be empty on each run and provide no value.
+ */
+export declare function captureFilter(text: string): CaptureResult | CaptureSkip;

package/dist/plugin/capture-filter.js

@@ -0,0 +1,32 @@
+/**
+ * Capture filtering for Claude Code — decides what content to send to Nex.
+ * Adapted from openclaw-plugin for plain string input.
+ */
+import { stripNexContext } from "./context-format.js";
+const MIN_LENGTH = 20;
+const MAX_LENGTH = 50_000;
+/**
+ * Filter text for capture eligibility.
+ * Works with plain strings (Claude Code messages).
+ *
+ * Note: Deduplication is handled server-side by the Nex extraction pipeline.
+ * Since hooks are short-lived processes (new process per invocation), in-memory
+ * dedup caches would be empty on each run and provide no value.
+ */
+export function captureFilter(text) {
+    if (!text || text.trim().length === 0) {
+        return { skipped: true, reason: "empty text" };
+    }
+    // Strip injected context blocks (prevent feedback loop)
+    const cleaned = stripNexContext(text);
+    // Skip too short
+    if (cleaned.length < MIN_LENGTH) {
+        return { skipped: true, reason: `too short (${cleaned.length} chars)` };
+    }
+    // Skip too long
+    if (cleaned.length > MAX_LENGTH) {
+        return { skipped: true, reason: `too long (${cleaned.length} chars)` };
+    }
+    return { skipped: false, text: cleaned };
+}
+//# sourceMappingURL=capture-filter.js.map

package/dist/plugin/capture-filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture-filter.js","sourceRoot":"","sources":["../../src/plugin/capture-filter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,MAAM,UAAU,GAAG,EAAE,CAAC;AACtB,MAAM,UAAU,GAAG,MAAM,CAAC;AAY1B;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;IACjD,CAAC;IAED,wDAAwD;IACxD,MAAM,OAAO,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IAEtC,iBAAiB;IACjB,IAAI,OAAO,CAAC,MAAM,GAAG,UAAU,EAAE,CAAC;QAChC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,cAAc,OAAO,CAAC,MAAM,SAAS,EAAE,CAAC;IAC1E,CAAC;IAED,gBAAgB;IAChB,IAAI,OAAO,CAAC,MAAM,GAAG,UAAU,EAAE,CAAC;QAChC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,aAAa,OAAO,CAAC,MAAM,SAAS,EAAE,CAAC;IACzE,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAC3C,CAAC"}

package/dist/plugin/config.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Plugin configuration — reads from environment variables,
+ * with fallback to ~/.nex-mcp.json (shared with MCP server).
+ */
+export interface NexConfig {
+    apiKey: string;
+    baseUrl: string;
+}
+export interface ScanConfig {
+    extensions: string[];
+    maxFileSize: number;
+    maxFilesPerScan: number;
+    scanDepth: number;
+    ignoreDirs: string[];
+    enabled: boolean;
+}
+export declare class ConfigError extends Error {
+    constructor(message: string);
+}
+/** Shared config file with MCP server — stores registration data. */
+declare const MCP_CONFIG_PATH: string;
+export { MCP_CONFIG_PATH };
+interface McpConfig {
+    api_key?: string;
+    base_url?: string;
+    workspace_id?: string;
+    workspace_slug?: string;
+}
+/** Read ~/.nex-mcp.json (shared with MCP server registration). */
+export declare function loadMcpConfig(): McpConfig;
+/** Write registration data to ~/.nex-mcp.json. */
+export declare function persistRegistration(data: Record<string, unknown>): void;
+/**
+ * Load config from environment variables, with fallback to ~/.nex-mcp.json.
+ *
+ * Priority: NEX_API_KEY env > ~/.nex-mcp.json api_key
+ * If neither is set, throws ConfigError with registration instructions.
+ */
+export declare function loadConfig(): NexConfig;
+/**
+ * Load base URL without requiring an API key.
+ * Used for registration (which doesn't need auth).
+ */
+export declare function loadBaseUrl(): string;
+/**
+ * Check if a specific hook is enabled in .nex.toml.
+ * Returns true by default (hooks are opt-out).
+ */
+export declare function isHookEnabled(hookName: "recall" | "capture" | "session_start"): boolean;
+/**
+ * Load scan config from NEX_SCAN_* environment variables.
+ * All fields have sensible defaults; NEX_SCAN_ENABLED=false is the kill switch.
+ */
+export declare function loadScanConfig(): ScanConfig;