@nex-ai/nex 0.1.64 → 0.1.66

package/dist/plugin/shared.js

@@ -0,0 +1,380 @@
+/**
+ * Shared hook logic — platform-agnostic recall, capture, and session-start.
+ *
+ * Extracted from auto-recall.ts, auto-capture.ts, auto-session-start.ts
+ * so adapters for Cursor, Windsurf, Cline, etc. can reuse the same logic
+ * without duplicating filter/client/format code.
+ */
+import { loadConfig, loadScanConfig, ConfigError, isHookEnabled } from "./config.js";
+import { NexClient, NexAuthError } from "./nex-client.js";
+import { formatNexContext } from "./context-format.js";
+import { captureFilter } from "./capture-filter.js";
+import { SessionStore } from "./session-store.js";
+import { shouldRecall, recordRecall } from "./recall-filter.js";
+import { RateLimiter } from "./rate-limiter.js";
+import { scanAndIngest } from "./file-scanner.js";
+import { ingestContextFiles } from "./context-files.js";
+import { readManifest, writeManifest, isChanged, markIngested, isScanFresh, markScanned } from "./file-manifest.js";
+import { readdirSync, statSync, readFileSync } from "node:fs";
+import { join, extname } from "node:path";
+import { homedir } from "node:os";
+const sessions = new SessionStore();
+// ── Recall ──────────────────────────────────────────────────────────────
+/**
+ * Run recall logic: filter prompt → query Nex /ask → return formatted context.
+ * Returns null if recall is skipped or fails.
+ */
+export async function doRecall(prompt, sessionKey) {
+    if (!isHookEnabled("recall"))
+        return null;
+    const trimmed = prompt?.trim();
+    if (!trimmed || trimmed.length < 5)
+        return null;
+    if (trimmed.startsWith("/"))
+        return null;
+    const isFirst = sessionKey ? !sessions.get(sessionKey) : true;
+    const decision = shouldRecall(trimmed, isFirst);
+    if (!decision.shouldRecall)
+        return null;
+    const cfg = loadConfig();
+    const client = new NexClient(cfg.apiKey, cfg.baseUrl);
+    let result;
+    try {
+        const nexSessionId = sessionKey ? sessions.get(sessionKey) : undefined;
+        result = await client.ask(trimmed, nexSessionId, 30_000);
+    }
+    catch (err) {
+        if (err instanceof NexAuthError) {
+            return {
+                context: "[Nex] API key expired or invalid. Run: nex register --email <email>",
+            };
+        }
+        throw err;
+    }
+    if (!result.answer)
+        return null;
+    if (result.session_id && sessionKey) {
+        sessions.set(sessionKey, result.session_id);
+    }
+    recordRecall(result.session_id);
+    const entityCount = result.entity_references?.length ?? 0;
+    const context = formatNexContext({
+        answer: result.answer,
+        entityCount,
+        sessionId: result.session_id,
+    });
+    return { context, nexSessionId: result.session_id };
+}
+// ── Capture ─────────────────────────────────────────────────────────────
+const INGEST_TIMEOUT_MS = 3_000;
+const MAX_PLAN_FILES = 2;
+/**
+ * Run capture logic: filter message → ingest to Nex + scan plan files.
+ */
+export async function doCapture(input) {
+    if (!isHookEnabled("capture"))
+        return;
+    let cfg;
+    try {
+        cfg = loadConfig();
+    }
+    catch {
+        return;
+    }
+    const client = new NexClient(cfg.apiKey, cfg.baseUrl);
+    const rateLimiter = new RateLimiter();
+    // Conversation capture
+    const message = input.message?.trim();
+    if (message) {
+        const filterResult = captureFilter(message);
+        if (!filterResult.skipped) {
+            if (rateLimiter.canProceed()) {
+                try {
+                    await client.ingest(filterResult.text, "claude-code-conversation", INGEST_TIMEOUT_MS);
+                }
+                catch (err) {
+                    if (err instanceof NexAuthError) {
+                        process.stderr.write(`[nex-capture] API key expired or invalid. Run 'nex register --email <email>' to get a new key.\n`);
+                        return;
+                    }
+                    process.stderr.write(`[nex-capture] Ingest failed: ${err instanceof Error ? err.message : String(err)}\n`);
+                }
+            }
+        }
+    }
+    // Plan file ingestion
+    const plansDir = input.planDir ?? join(process.cwd(), ".claude", "plans");
+    try {
+        await ingestPlanFiles(client, rateLimiter, plansDir);
+    }
+    catch (err) {
+        process.stderr.write(`[nex-capture] Plan file scan error: ${err instanceof Error ? err.message : String(err)}\n`);
+    }
+    // Transcript ingestion — ingest the full session conversation
+    if (input.sessionId) {
+        try {
+            await ingestTranscript(client, input.sessionId);
+        }
+        catch {
+            // non-fatal
+        }
+    }
+}
+async function ingestPlanFiles(client, rateLimiter, plansDir) {
+    const scanConfig = loadScanConfig();
+    if (!scanConfig.enabled)
+        return;
+    let entries;
+    try {
+        entries = readdirSync(plansDir, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    const manifest = readManifest();
+    let ingested = 0;
+    for (const entry of entries) {
+        if (ingested >= MAX_PLAN_FILES)
+            break;
+        if (!entry.isFile())
+            continue;
+        if (extname(entry.name).toLowerCase() !== ".md")
+            continue;
+        const fullPath = join(plansDir, entry.name);
+        try {
+            const stat = statSync(fullPath);
+            if (!isChanged(fullPath, stat, manifest))
+                continue;
+            if (!rateLimiter.canProceed())
+                break;
+            let content = readFileSync(fullPath, "utf-8");
+            if (content.length > 100_000) {
+                content = content.slice(0, 100_000) + "\n[...truncated]";
+            }
+            const context = `claude-code-plan:${entry.name}`;
+            await client.ingest(content, context, INGEST_TIMEOUT_MS);
+            markIngested(fullPath, stat, context, manifest);
+            ingested++;
+        }
+        catch {
+            // skip individual file errors
+        }
+    }
+    if (ingested > 0)
+        writeManifest(manifest);
+}
+/**
+ * Read a Claude Code session transcript and ingest the full conversation.
+ *
+ * Extracts user and assistant messages from the JSONL transcript file,
+ * builds a condensed conversation text, and sends it to Nex in one shot.
+ * This captures the full context instead of just the last assistant message.
+ */
+const MAX_TRANSCRIPT_LENGTH = 100_000;
+async function ingestTranscript(client, sessionId) {
+    const cwd = process.cwd();
+    // Claude Code stores transcripts at ~/.claude/projects/<project-hash>/<session-id>.jsonl
+    // Project hash is the CWD path with / replaced by -
+    const projectHash = "-" + cwd.replace(/\//g, "-");
+    const transcriptPath = join(homedir(), ".claude", "projects", projectHash, `${sessionId}.jsonl`);
+    let raw;
+    try {
+        raw = readFileSync(transcriptPath, "utf-8");
+    }
+    catch {
+        return; // transcript doesn't exist yet or path is wrong
+    }
+    // Extract user/assistant messages
+    const lines = [];
+    for (const line of raw.split("\n")) {
+        if (!line.trim())
+            continue;
+        try {
+            const entry = JSON.parse(line);
+            const role = entry.message?.role;
+            if (role !== "user" && role !== "assistant")
+                continue;
+            let text = "";
+            const content = entry.message?.content;
+            if (typeof content === "string") {
+                text = content;
+            }
+            else if (Array.isArray(content)) {
+                text = content
+                    .filter((c) => c.type === "text")
+                    .map((c) => c.text)
+                    .join("\n");
+            }
+            if (!text.trim())
+                continue;
+            // Strip nex-context blocks to avoid feedback loops
+            text = text.replace(/<nex-context>[\s\S]*?<\/nex-context>/g, "").trim();
+            if (!text)
+                continue;
+            lines.push(`[${role}]: ${text}`);
+        }
+        catch {
+            continue;
+        }
+    }
+    if (lines.length < 2)
+        return; // need at least one exchange
+    let transcript = lines.join("\n\n");
+    if (transcript.length > MAX_TRANSCRIPT_LENGTH) {
+        // Keep the most recent messages (end of conversation is most valuable)
+        transcript = transcript.slice(-MAX_TRANSCRIPT_LENGTH);
+        transcript = "[...earlier messages truncated]\n\n" + transcript;
+    }
+    await client.ingest(transcript, `claude-code-transcript:${sessionId}`, 30_000);
+}
+// ── Session Start ───────────────────────────────────────────────────────
+const SESSION_START_QUERY = "Summarize the key active context, recent interactions, and important updates for this user.";
+/**
+ * Run session-start logic: scan files → query Nex baseline → return context.
+ * Returns null if disabled. Returns registrationPrompt if no API key.
+ */
+export async function doSessionStart(source, sessionKey) {
+    if (!isHookEnabled("session_start"))
+        return null;
+    let cfg;
+    try {
+        cfg = loadConfig();
+    }
+    catch (err) {
+        if (err instanceof ConfigError) {
+            // No API key — return registration instructions
+            return {
+                context: "",
+                registrationPrompt: buildRegistrationPrompt(),
+            };
+        }
+        return null;
+    }
+    const client = new NexClient(cfg.apiKey, cfg.baseUrl);
+    const contextParts = [];
+    // File scan on startup or clear
+    const shouldScan = source === "startup" || source === "clear";
+    if (shouldScan) {
+        // Skip expensive file scanning if a scan completed recently (within 1 hour).
+        // The context query below still runs — only the file walk + ingest is skipped.
+        const scanManifest = readManifest();
+        const scanFresh = isScanFresh(scanManifest);
+        if (!scanFresh) {
+            const rateLimiter = new RateLimiter();
+            const cwd = process.cwd();
+            try {
+                const ctxResult = await ingestContextFiles(client, rateLimiter, cwd);
+                if (ctxResult.ingested > 0) {
+                    contextParts.push(`[Context files: ${ctxResult.ingested} ingested (${ctxResult.files.join(", ")})]`);
+                }
+            }
+            catch {
+                // non-fatal
+            }
+            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]`);
+                        // Trigger compounding intelligence after ingestion (non-blocking, best-effort)
+                        triggerCompounding(cfg).catch(() => { });
+                    }
+                }
+            }
+            catch {
+                // non-fatal
+            }
+            // Mark scan as complete so subsequent sessions skip it
+            markScanned(scanManifest);
+            writeManifest(scanManifest);
+        }
+    }
+    let result;
+    try {
+        result = await client.ask(SESSION_START_QUERY, undefined, 30_000);
+    }
+    catch (err) {
+        if (err instanceof NexAuthError) {
+            return {
+                context: "",
+                registrationPrompt: buildAuthExpiredPrompt(),
+            };
+        }
+        throw err;
+    }
+    if (!result.answer && contextParts.length === 0)
+        return null;
+    if (result.session_id && sessionKey) {
+        sessions.set(sessionKey, result.session_id);
+    }
+    recordRecall(result.session_id);
+    const entityCount = result.entity_references?.length ?? 0;
+    const context = formatNexContext({
+        answer: result.answer,
+        entityCount,
+        sessionId: result.session_id,
+    });
+    const fullContext = contextParts.length > 0
+        ? `${context}\n${contextParts.join("\n")}`
+        : context;
+    return { context: fullContext, nexSessionId: result.session_id };
+}
+function buildRegistrationPrompt() {
+    return [
+        "[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: nex register --email <email>",
+        "3. Then run: nex setup",
+        "",
+        "Keep it brief — just ask for the email and register. No restart needed after registration.",
+    ].join("\n");
+}
+function buildAuthExpiredPrompt() {
+    return [
+        "[Nex Memory Plugin] API key expired or invalid. Re-registration is required to restore persistent memory.",
+        "",
+        "IMPORTANT: Before proceeding with the user's request, you must renew the Nex API key:",
+        "1. Ask the user for their email address",
+        "2. Run: nex register --email <email>",
+        "3. Then run: nex setup",
+        "",
+        "Keep it brief — just ask for the email and register. No restart needed after registration.",
+    ].join("\n");
+}
+// ── Helpers ─────────────────────────────────────────────────────────────
+/** Read stdin as a string (shared across all hook scripts). */
+export async function readStdin() {
+    const chunks = [];
+    for await (const chunk of process.stdin) {
+        chunks.push(chunk);
+    }
+    return Buffer.concat(chunks).toString("utf-8");
+}
+/**
+ * Trigger compounding intelligence jobs after content ingestion.
+ * Runs consolidation, pattern detection, and playbook synthesis.
+ * Best-effort — errors are silently ignored.
+ */
+async function triggerCompounding(cfg) {
+    const jobs = ["consolidation", "pattern_detection", "playbook_synthesis"];
+    const url = `${cfg.baseUrl}/api/developers/v1/compounding/trigger`;
+    await Promise.allSettled(jobs.map((job) => fetch(url, {
+        method: "POST",
+        headers: { Authorization: `Bearer ${cfg.apiKey}`, "Content-Type": "application/json" },
+        body: JSON.stringify({ job_type: job, dry_run: false }),
+        signal: AbortSignal.timeout(30_000),
+    })));
+}
+/** Wrap output in Claude Code hookSpecificOutput format. */
+export function claudeCodeOutput(hookEventName, additionalContext) {
+    return JSON.stringify({
+        hookSpecificOutput: {
+            hookEventName,
+            additionalContext,
+        },
+    });
+}
+//# sourceMappingURL=shared.js.map

package/dist/plugin/shared.js.map

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

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

@@ -0,0 +1,32 @@
+/**
+ * Smart capture filtering — decides what content to send to Nex for ingestion.
+ * Cherry-picked from Supermemory (provider skip), Engram (dedup), MemOS Cloud (capture modes).
+ */
+import type { NexPluginConfig } from "./config.js";
+/** Message shape from OpenClaw agent_end event. */
+export interface AgentMessage {
+    role: string;
+    content?: string | Array<{
+        type: string;
+        text?: string;
+    }>;
+}
+export interface CaptureFilterResult {
+    text: string;
+    skipped: false;
+}
+export interface CaptureFilterSkip {
+    reason: string;
+    skipped: true;
+}
+/**
+ * Process agent_end event and decide what to capture.
+ * Returns cleaned text or a skip reason.
+ */
+export declare function captureFilter(messages: AgentMessage[], config: NexPluginConfig, opts?: {
+    messageProvider?: string;
+    success?: boolean;
+}): CaptureFilterResult | CaptureFilterSkip;
+/** Reset dedup cache (for testing). */
+export declare function resetDedupCache(): void;
+//# sourceMappingURL=capture-filter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"capture-filter.d.ts","sourceRoot":"","sources":["../src/capture-filter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,mDAAmD;AACnD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC3D;AAgED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,KAAK,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,IAAI,CAAC;CACf;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,YAAY,EAAE,EACxB,MAAM,EAAE,eAAe,EACvB,IAAI,CAAC,EAAE;IAAE,eAAe,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GACrD,mBAAmB,GAAG,iBAAiB,CA8DzC;AAED,uCAAuC;AACvC,wBAAgB,eAAe,IAAI,IAAI,CAEtC"}

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

@@ -0,0 +1,117 @@
+/**
+ * Smart capture filtering — decides what content to send to Nex for ingestion.
+ * Cherry-picked from Supermemory (provider skip), Engram (dedup), MemOS Cloud (capture modes).
+ */
+import { stripNexContext } from "./context-format.js";
+/** Providers whose messages should never be auto-captured. */
+const SKIP_PROVIDERS = new Set(["exec-event", "cron-event"]);
+const MIN_LENGTH = 10;
+const MAX_LENGTH = 50_000;
+/**
+ * Simple content hash for deduplication.
+ * Uses a fast string hash — not cryptographic, just collision-resistant enough for dedup.
+ */
+function hashContent(text) {
+    let hash = 0;
+    for (let i = 0; i < text.length; i++) {
+        const ch = text.charCodeAt(i);
+        hash = ((hash << 5) - hash + ch) | 0;
+    }
+    return hash.toString(36);
+}
+const DEDUP_MAX = 50;
+const DEDUP_TTL_MS = 60 * 60 * 1000; // 1 hour
+/** In-memory LRU cache for content hash dedup. */
+const dedupCache = [];
+function isDuplicate(hash) {
+    const now = Date.now();
+    // Evict expired entries
+    while (dedupCache.length > 0 && now - dedupCache[0].timestamp > DEDUP_TTL_MS) {
+        dedupCache.shift();
+    }
+    // Check for match
+    if (dedupCache.some((e) => e.hash === hash)) {
+        return true;
+    }
+    // Add to cache
+    dedupCache.push({ hash, timestamp: now });
+    // LIFO eviction if over max
+    if (dedupCache.length > DEDUP_MAX) {
+        dedupCache.shift();
+    }
+    return false;
+}
+/** Extract text content from an AgentMessage. */
+function extractText(msg) {
+    if (typeof msg.content === "string")
+        return msg.content;
+    if (Array.isArray(msg.content)) {
+        return msg.content
+            .filter((p) => p.type === "text" && p.text)
+            .map((p) => p.text)
+            .join("\n");
+    }
+    return "";
+}
+/**
+ * Process agent_end event and decide what to capture.
+ * Returns cleaned text or a skip reason.
+ */
+export function captureFilter(messages, config, opts) {
+    // Skip failed agent runs
+    if (opts?.success === false) {
+        return { skipped: true, reason: "agent run failed" };
+    }
+    // Skip system event providers
+    if (opts?.messageProvider && SKIP_PROVIDERS.has(opts.messageProvider)) {
+        return { skipped: true, reason: `provider "${opts.messageProvider}" is in skip list` };
+    }
+    if (!messages || messages.length === 0) {
+        return { skipped: true, reason: "no messages" };
+    }
+    let text;
+    if (config.captureMode === "last_turn") {
+        // Extract last user + last assistant message
+        const parts = [];
+        const reversed = [...messages].reverse();
+        const lastAssistant = reversed.find((m) => m.role === "assistant");
+        const lastUser = reversed.find((m) => m.role === "user");
+        if (lastUser)
+            parts.push(`User: ${extractText(lastUser)}`);
+        if (lastAssistant)
+            parts.push(`Assistant: ${extractText(lastAssistant)}`);
+        text = parts.join("\n\n");
+    }
+    else {
+        // full_session: capture all user and assistant messages
+        text = messages
+            .filter((m) => m.role === "user" || m.role === "assistant")
+            .map((m) => `${m.role === "user" ? "User" : "Assistant"}: ${extractText(m)}`)
+            .join("\n\n");
+    }
+    // Strip injected context blocks (prevent feedback loop)
+    text = stripNexContext(text);
+    // Skip slash commands
+    if (text.startsWith("User: /")) {
+        return { skipped: true, reason: "slash command" };
+    }
+    // Skip too short
+    if (text.length < MIN_LENGTH) {
+        return { skipped: true, reason: `too short (${text.length} chars)` };
+    }
+    // Skip too long
+    if (text.length > MAX_LENGTH) {
+        return { skipped: true, reason: `too long (${text.length} chars)` };
+    }
+    // Dedup check
+    const hash = hashContent(text);
+    if (isDuplicate(hash)) {
+        return { skipped: true, reason: "duplicate content" };
+    }
+    return { skipped: false, text };
+}
+/** Reset dedup cache (for testing). */
+export function resetDedupCache() {
+    dedupCache.length = 0;
+}
+//# sourceMappingURL=capture-filter.js.map

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

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

package/openclaw-plugin/dist/config.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Plugin configuration parsing and validation.
+ * Resolves API key from config, env var, or ${VAR} interpolation.
+ */
+export interface NexPluginConfig {
+    apiKey: string;
+    baseUrl: string;
+    autoRecall: boolean;
+    autoCapture: boolean;
+    captureMode: "last_turn" | "full_session";
+    maxRecallResults: number;
+    sessionTracking: boolean;
+    recallTimeoutMs: number;
+    debug: boolean;
+}
+export declare class ConfigError extends Error {
+    constructor(message: string);
+}
+/**
+ * Parse raw plugin config into a validated NexPluginConfig.
+ * Falls back to process.env.NEX_API_KEY if no apiKey in config.
+ */
+export declare function parseConfig(raw?: Record<string, unknown>): NexPluginConfig;
+//# sourceMappingURL=config.d.ts.map

package/openclaw-plugin/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,WAAW,GAAG,cAAc,CAAC;IAC1C,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,OAAO,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,OAAO,CAAC;CAChB;AAoBD,qBAAa,WAAY,SAAQ,KAAK;gBACxB,OAAO,EAAE,MAAM;CAI5B;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,eAAe,CA4C1E"}

package/openclaw-plugin/dist/config.js

@@ -0,0 +1,68 @@
+/**
+ * Plugin configuration parsing and validation.
+ * Resolves API key from config, env var, or ${VAR} interpolation.
+ */
+const DEFAULTS = {
+    baseUrl: "https://app.nex.ai",
+    autoRecall: true,
+    autoCapture: true,
+    captureMode: "last_turn",
+    maxRecallResults: 5,
+    sessionTracking: true,
+    recallTimeoutMs: 1500,
+    debug: false,
+};
+/** Resolve ${VAR_NAME} patterns in a string value. */
+function resolveEnvVars(value) {
+    return value.replace(/\$\{([^}]+)\}/g, (_, varName) => {
+        return process.env[varName.trim()] ?? "";
+    });
+}
+export class ConfigError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ConfigError";
+    }
+}
+/**
+ * Parse raw plugin config into a validated NexPluginConfig.
+ * Falls back to process.env.NEX_API_KEY if no apiKey in config.
+ */
+export function parseConfig(raw) {
+    const cfg = raw ?? {};
+    // Resolve API key: config → env var interpolation → NEX_API_KEY env
+    let apiKey = typeof cfg.apiKey === "string" ? resolveEnvVars(cfg.apiKey) : undefined;
+    if (!apiKey) {
+        apiKey = process.env.NEX_API_KEY;
+    }
+    if (!apiKey) {
+        throw new ConfigError("No API key configured. Set 'apiKey' in plugin config or export NEX_API_KEY environment variable.");
+    }
+    let baseUrl = process.env.NEX_DEV_URL
+        ?? (typeof cfg.baseUrl === "string" ? resolveEnvVars(cfg.baseUrl).replace(/\/+$/, "") : undefined)
+        ?? DEFAULTS.baseUrl;
+    const captureMode = cfg.captureMode;
+    if (captureMode !== undefined && captureMode !== "last_turn" && captureMode !== "full_session") {
+        throw new ConfigError(`Invalid captureMode: "${captureMode}". Must be "last_turn" or "full_session".`);
+    }
+    const maxRecallResults = typeof cfg.maxRecallResults === "number" ? cfg.maxRecallResults : DEFAULTS.maxRecallResults;
+    if (maxRecallResults < 1 || maxRecallResults > 20) {
+        throw new ConfigError(`maxRecallResults must be between 1 and 20, got ${maxRecallResults}.`);
+    }
+    const recallTimeoutMs = typeof cfg.recallTimeoutMs === "number" ? cfg.recallTimeoutMs : DEFAULTS.recallTimeoutMs;
+    if (recallTimeoutMs < 500 || recallTimeoutMs > 10000) {
+        throw new ConfigError(`recallTimeoutMs must be between 500 and 10000, got ${recallTimeoutMs}.`);
+    }
+    return {
+        apiKey,
+        baseUrl,
+        autoRecall: typeof cfg.autoRecall === "boolean" ? cfg.autoRecall : DEFAULTS.autoRecall,
+        autoCapture: typeof cfg.autoCapture === "boolean" ? cfg.autoCapture : DEFAULTS.autoCapture,
+        captureMode: captureMode ?? DEFAULTS.captureMode,
+        maxRecallResults,
+        sessionTracking: typeof cfg.sessionTracking === "boolean" ? cfg.sessionTracking : DEFAULTS.sessionTracking,
+        recallTimeoutMs,
+        debug: typeof cfg.debug === "boolean" ? cfg.debug : DEFAULTS.debug,
+    };
+}
+//# sourceMappingURL=config.js.map

package/openclaw-plugin/dist/config.js.map

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