@nex-ai/nex 0.1.65 → 0.1.67

package/dist/plugin/update-check.js

@@ -0,0 +1,134 @@
+#!/usr/bin/env node
+/**
+ * nex-update-check — lightweight version check with caching.
+ *
+ * Outputs one of:
+ *   UPGRADE_AVAILABLE <current> <latest>
+ *   (nothing — up to date, snoozed, disabled, or cached)
+ *
+ * Designed to run inline in session start hooks with minimal latency.
+ * Caches results to ~/.nex/last-update-check (60 min TTL for "up to date",
+ * 720 min for "upgrade available"). Supports snooze with escalating backoff.
+ */
+import { readFileSync, writeFileSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+import { execFileSync } from "node:child_process";
+import { createRequire } from "node:module";
+const require = createRequire(import.meta.url);
+const pkg = require("../../package.json");
+const NEX_DIR = join(homedir(), ".nex");
+const CACHE_PATH = join(NEX_DIR, "last-update-check");
+const SNOOZE_PATH = join(NEX_DIR, "update-snoozed");
+const UPGRADED_PATH = join(NEX_DIR, "just-upgraded-from");
+const UP_TO_DATE_TTL_MS = 60 * 60 * 1000; // 60 min
+const UPGRADE_AVAIL_TTL_MS = 12 * 60 * 60 * 1000; // 12 hours
+// Snooze escalation: 24h → 48h → 7d
+const SNOOZE_LEVELS_MS = [
+    24 * 60 * 60 * 1000,
+    48 * 60 * 60 * 1000,
+    7 * 24 * 60 * 60 * 1000,
+];
+function compareVersions(a, b) {
+    const pa = a.split(".").map(Number);
+    const pb = b.split(".").map(Number);
+    for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
+        const diff = (pa[i] ?? 0) - (pb[i] ?? 0);
+        if (diff !== 0)
+            return diff;
+    }
+    return 0;
+}
+function readJson(path) {
+    try {
+        return JSON.parse(readFileSync(path, "utf-8"));
+    }
+    catch {
+        return null;
+    }
+}
+function writeJson(path, data) {
+    mkdirSync(NEX_DIR, { recursive: true });
+    writeFileSync(path, JSON.stringify(data) + "\n", "utf-8");
+}
+/** Check if snoozed for current latest version. */
+function isSnoozed(latestVersion) {
+    const snooze = readJson(SNOOZE_PATH);
+    if (!snooze)
+        return false;
+    if (snooze.version !== latestVersion)
+        return false; // new version resets snooze
+    const level = Math.min(snooze.level, SNOOZE_LEVELS_MS.length - 1);
+    const elapsed = Date.now() - snooze.snoozed_at;
+    return elapsed < SNOOZE_LEVELS_MS[level];
+}
+/** Check if we just upgraded (marker left by upgrade command). */
+function checkJustUpgraded() {
+    try {
+        const old = readFileSync(UPGRADED_PATH, "utf-8").trim();
+        // Clean up the marker
+        try {
+            writeFileSync(UPGRADED_PATH, "", "utf-8");
+        }
+        catch { /* ignore */ }
+        return old;
+    }
+    catch {
+        return null;
+    }
+}
+function fetchLatestVersion() {
+    try {
+        const raw = execFileSync("curl", ["-sf", "--max-time", "5", "https://registry.npmjs.org/@nex-ai/nex/latest"], { encoding: "utf-8", timeout: 6000 });
+        const data = JSON.parse(raw);
+        const ver = data.version;
+        if (typeof ver === "string" && /^\d+\.\d+\.\d+/.test(ver))
+            return ver;
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+function main() {
+    const current = pkg.version;
+    // Check if update checking is disabled
+    try {
+        const config = readJson(join(NEX_DIR, "config.json"));
+        if (config?.update_check === false)
+            return;
+    }
+    catch { /* continue */ }
+    // Check for just-upgraded marker
+    const upgradedFrom = checkJustUpgraded();
+    if (upgradedFrom && upgradedFrom !== current) {
+        console.log(`JUST_UPGRADED ${upgradedFrom} ${current}`);
+        // Clear stale cache
+        writeJson(CACHE_PATH, { current, latest: current, status: "up_to_date", checked_at: Date.now() });
+        return;
+    }
+    // Fast path: check cache
+    const cached = readJson(CACHE_PATH);
+    if (cached && cached.current === current) {
+        const age = Date.now() - cached.checked_at;
+        const ttl = cached.status === "up_to_date" ? UP_TO_DATE_TTL_MS : UPGRADE_AVAIL_TTL_MS;
+        if (age < ttl) {
+            if (cached.status === "upgrade_available" && !isSnoozed(cached.latest)) {
+                console.log(`UPGRADE_AVAILABLE ${current} ${cached.latest}`);
+            }
+            return;
+        }
+    }
+    // Slow path: fetch from registry
+    const latest = fetchLatestVersion();
+    if (!latest)
+        return; // network error — fail silently
+    const status = compareVersions(latest, current) > 0 ? "upgrade_available" : "up_to_date";
+    // Write cache
+    writeJson(CACHE_PATH, { current, latest, status, checked_at: Date.now() });
+    if (status === "upgrade_available" && !isSnoozed(latest)) {
+        console.log(`UPGRADE_AVAILABLE ${current} ${latest}`);
+    }
+}
+main();
+//# sourceMappingURL=update-check.js.map

package/dist/plugin/update-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-check.js","sourceRoot":"","sources":["../../src/plugin/update-check.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":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAStD,8DAA8D;AAC9D,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC,CAAC;AAE7D,MAAM,UAAU,GAAG,EAAE,CAAC;AACtB,MAAM,UAAU,GAAG,MAAM,CAAC;AAE1B;;;GAGG;AACH,SAAS,WAAW,CAAC,IAAY;IAC/B,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAC9B,IAAI,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,IAAI,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;AAC3B,CAAC;AAQD,MAAM,SAAS,GAAG,EAAE,CAAC;AACrB,MAAM,YAAY,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,SAAS;AAE9C,kDAAkD;AAClD,MAAM,UAAU,GAAiB,EAAE,CAAC;AAEpC,SAAS,WAAW,CAAC,IAAY;IAC/B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,wBAAwB;IACxB,OAAO,UAAU,CAAC,MAAM,GAAG,CAAC,IAAI,GAAG,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,GAAG,YAAY,EAAE,CAAC;QAC7E,UAAU,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IACD,kBAAkB;IAClB,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QAC5C,OAAO,IAAI,CAAC;IACd,CAAC;IACD,eAAe;IACf,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;IAC1C,4BAA4B;IAC5B,IAAI,UAAU,CAAC,MAAM,GAAG,SAAS,EAAE,CAAC;QAClC,UAAU,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,iDAAiD;AACjD,SAAS,WAAW,CAAC,GAAiB;IACpC,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC,OAAO,CAAC;IACxD,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/B,OAAO,GAAG,CAAC,OAAO;aACf,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,CAAC,IAAI,CAAC;aAC1C,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAK,CAAC;aACnB,IAAI,CAAC,IAAI,CAAC,CAAC;IAChB,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAYD;;;GAGG;AACH,MAAM,UAAU,aAAa,CAC3B,QAAwB,EACxB,MAAuB,EACvB,IAAsD;IAEtD,yBAAyB;IACzB,IAAI,IAAI,EAAE,OAAO,KAAK,KAAK,EAAE,CAAC;QAC5B,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC;IACvD,CAAC;IAED,8BAA8B;IAC9B,IAAI,IAAI,EAAE,eAAe,IAAI,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC;QACtE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,aAAa,IAAI,CAAC,eAAe,mBAAmB,EAAE,CAAC;IACzF,CAAC;IAED,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;IAClD,CAAC;IAED,IAAI,IAAY,CAAC;IAEjB,IAAI,MAAM,CAAC,WAAW,KAAK,WAAW,EAAE,CAAC;QACvC,6CAA6C;QAC7C,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC;QAEzC,MAAM,aAAa,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC;QACnE,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;QAEzD,IAAI,QAAQ;YAAE,KAAK,CAAC,IAAI,CAAC,SAAS,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAC3D,IAAI,aAAa;YAAE,KAAK,CAAC,IAAI,CAAC,cAAc,WAAW,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;QAE1E,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;SAAM,CAAC;QACN,wDAAwD;QACxD,IAAI,GAAG,QAAQ;aACZ,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC;aAC1D,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,KAAK,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;aAC5E,IAAI,CAAC,MAAM,CAAC,CAAC;IAClB,CAAC;IAED,wDAAwD;IACxD,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IAE7B,sBAAsB;IACtB,IAAI,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC/B,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC;IACpD,CAAC;IAED,iBAAiB;IACjB,IAAI,IAAI,CAAC,MAAM,GAAG,UAAU,EAAE,CAAC;QAC7B,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,cAAc,IAAI,CAAC,MAAM,SAAS,EAAE,CAAC;IACvE,CAAC;IAED,gBAAgB;IAChB,IAAI,IAAI,CAAC,MAAM,GAAG,UAAU,EAAE,CAAC;QAC7B,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,aAAa,IAAI,CAAC,MAAM,SAAS,EAAE,CAAC;IACtE,CAAC;IAED,cAAc;IACd,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC;IACxD,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAClC,CAAC;AAED,uCAAuC;AACvC,MAAM,UAAU,eAAe;IAC7B,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;AACxB,CAAC"}

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":"AAAA;;;GAGG;AAcH,MAAM,QAAQ,GAAoC;IAChD,OAAO,EAAE,oBAAoB;IAC7B,UAAU,EAAE,IAAI;IAChB,WAAW,EAAE,IAAI;IACjB,WAAW,EAAE,WAAW;IACxB,gBAAgB,EAAE,CAAC;IACnB,eAAe,EAAE,IAAI;IACrB,eAAe,EAAE,IAAI;IACrB,KAAK,EAAE,KAAK;CACb,CAAC;AAEF,sDAAsD;AACtD,SAAS,cAAc,CAAC,KAAa;IACnC,OAAO,KAAK,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC,EAAE,OAAe,EAAE,EAAE;QAC5D,OAAO,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;IAC3C,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,OAAO,WAAY,SAAQ,KAAK;IACpC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,GAA6B;IACvD,MAAM,GAAG,GAAG,GAAG,IAAI,EAAE,CAAC;IAEtB,oEAAoE;IACpE,IAAI,MAAM,GAAG,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACrF,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;IACnC,CAAC;IACD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,WAAW,CACnB,kGAAkG,CACnG,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW;WAChC,CAAC,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;WAC/F,QAAQ,CAAC,OAAO,CAAC;IAEtB,MAAM,WAAW,GAAG,GAAG,CAAC,WAAiC,CAAC;IAC1D,IAAI,WAAW,KAAK,SAAS,IAAI,WAAW,KAAK,WAAW,IAAI,WAAW,KAAK,cAAc,EAAE,CAAC;QAC/F,MAAM,IAAI,WAAW,CAAC,yBAAyB,WAAW,2CAA2C,CAAC,CAAC;IACzG,CAAC;IAED,MAAM,gBAAgB,GAAG,OAAO,GAAG,CAAC,gBAAgB,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IACrH,IAAI,gBAAgB,GAAG,CAAC,IAAI,gBAAgB,GAAG,EAAE,EAAE,CAAC;QAClD,MAAM,IAAI,WAAW,CAAC,kDAAkD,gBAAgB,GAAG,CAAC,CAAC;IAC/F,CAAC;IAED,MAAM,eAAe,GAAG,OAAO,GAAG,CAAC,eAAe,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,QAAQ,CAAC,eAAe,CAAC;IACjH,IAAI,eAAe,GAAG,GAAG,IAAI,eAAe,GAAG,KAAK,EAAE,CAAC;QACrD,MAAM,IAAI,WAAW,CAAC,sDAAsD,eAAe,GAAG,CAAC,CAAC;IAClG,CAAC;IAED,OAAO;QACL,MAAM;QACN,OAAO;QACP,UAAU,EAAE,OAAO,GAAG,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU;QACtF,WAAW,EAAE,OAAO,GAAG,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW;QAC1F,WAAW,EAAG,WAA8C,IAAI,QAAQ,CAAC,WAAW;QACpF,gBAAgB;QAChB,eAAe,EAAE,OAAO,GAAG,CAAC,eAAe,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,QAAQ,CAAC,eAAe;QAC1G,eAAe;QACf,KAAK,EAAE,OAAO,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK;KACnE,CAAC;AACJ,CAAC"}

package/openclaw-plugin/dist/context-format.d.ts

@@ -0,0 +1,23 @@
+/**
+ * XML context formatting and stripping for recall injection.
+ * Wraps Nex answers in <nex-context> tags and strips them before capture.
+ */
+export interface NexRecallResult {
+    answer: string;
+    entityCount: number;
+    sessionId?: string;
+}
+/**
+ * Format a Nex /ask response as an XML block for context injection.
+ */
+export declare function formatNexContext(result: NexRecallResult): string;
+/**
+ * Strip all <nex-context>...</nex-context> blocks from text.
+ * Also handles unclosed tags (strips from open tag to end of text).
+ */
+export declare function stripNexContext(text: string): string;
+/**
+ * Check if text contains a nex-context block.
+ */
+export declare function hasNexContext(text: string): boolean;
+//# sourceMappingURL=context-format.d.ts.map

package/openclaw-plugin/dist/context-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-format.d.ts","sourceRoot":"","sources":["../src/context-format.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAehE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMpD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnD"}

package/openclaw-plugin/dist/context-format.js

@@ -0,0 +1,40 @@
+/**
+ * XML context formatting and stripping for recall injection.
+ * Wraps Nex answers in <nex-context> tags and strips them before capture.
+ */
+const OPEN_TAG = "<nex-context>";
+const CLOSE_TAG = "</nex-context>";
+/**
+ * Format a Nex /ask response as an XML block for context injection.
+ */
+export function formatNexContext(result) {
+    const parts = [
+        OPEN_TAG,
+        "The following is relevant context from the user's knowledge base. Use it to inform your response, but do not mention this block directly.",
+    ];
+    if (result.entityCount > 0) {
+        parts.push(`[${result.entityCount} related entities found]`);
+    }
+    parts.push("");
+    parts.push(result.answer);
+    parts.push(CLOSE_TAG);
+    return parts.join("\n");
+}
+/**
+ * Strip all <nex-context>...</nex-context> blocks from text.
+ * Also handles unclosed tags (strips from open tag to end of text).
+ */
+export function stripNexContext(text) {
+    // First: strip complete blocks
+    let result = text.replace(/<nex-context>[\s\S]*?<\/nex-context>/g, "");
+    // Then: strip unclosed tags (open tag without matching close)
+    result = result.replace(/<nex-context>[\s\S]*/g, "");
+    return result.trim();
+}
+/**
+ * Check if text contains a nex-context block.
+ */
+export function hasNexContext(text) {
+    return text.includes(OPEN_TAG);
+}
+//# sourceMappingURL=context-format.js.map

package/openclaw-plugin/dist/context-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-format.js","sourceRoot":"","sources":["../src/context-format.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,QAAQ,GAAG,eAAe,CAAC;AACjC,MAAM,SAAS,GAAG,gBAAgB,CAAC;AAQnC;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAuB;IACtD,MAAM,KAAK,GAAa;QACtB,QAAQ;QACR,2IAA2I;KAC5I,CAAC;IAEF,IAAI,MAAM,CAAC,WAAW,GAAG,CAAC,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,WAAW,0BAA0B,CAAC,CAAC;IAC/D,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC1B,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAEtB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,+BAA+B;IAC/B,IAAI,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,uCAAuC,EAAE,EAAE,CAAC,CAAC;IACvE,8DAA8D;IAC9D,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,uBAAuB,EAAE,EAAE,CAAC,CAAC;IACrD,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;AACvB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACjC,CAAC"}

package/openclaw-plugin/dist/file-scanner.d.ts

@@ -0,0 +1,23 @@
+/**
+ * File scanner for OpenClaw plugin.
+ * Discovers text files, tracks changes via SHA-256 content hash,
+ * and ingests new/changed files into Nex.
+ */
+import { NexClient } from "./nex-client.js";
+export interface ScanResult {
+    scanned: number;
+    skipped: number;
+    errors: number;
+    files: Array<{
+        path: string;
+        status: string;
+        reason?: string;
+    }>;
+}
+export declare function scanFiles(dir: string, client: NexClient, opts?: {
+    extensions?: string[];
+    maxFiles?: number;
+    depth?: number;
+    force?: boolean;
+}): Promise<ScanResult>;
+//# sourceMappingURL=file-scanner.d.ts.map

package/openclaw-plugin/dist/file-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-scanner.d.ts","sourceRoot":"","sources":["../src/file-scanner.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,EAAE,SAAS,EAAuB,MAAM,iBAAiB,CAAC;AAejE,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjE;AAsED,wBAAsB,SAAS,CAC7B,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,SAAS,EACjB,IAAI,CAAC,EAAE;IACL,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,GACA,OAAO,CAAC,UAAU,CAAC,CAmDrB"}

package/openclaw-plugin/dist/file-scanner.js

@@ -0,0 +1,119 @@
+/**
+ * File scanner for OpenClaw plugin.
+ * Discovers text files, tracks changes via SHA-256 content hash,
+ * and ingests new/changed files into Nex.
+ */
+import { createHash } from "node:crypto";
+import { readFileSync, writeFileSync, mkdirSync, statSync, readdirSync } from "node:fs";
+import { join, extname, resolve, dirname } from "node:path";
+import { homedir } from "node:os";
+// --- Constants ---
+const MANIFEST_PATH = join(homedir(), ".nex", "file-scan-manifest.json");
+const DEFAULT_EXTENSIONS = [
+    ".md", ".txt", ".rtf", ".html", ".htm",
+    ".csv", ".tsv", ".json", ".yaml", ".yml", ".toml", ".xml",
+    ".js", ".ts", ".jsx", ".tsx", ".py", ".rb", ".go", ".rs", ".java",
+    ".sh", ".bash", ".zsh", ".fish",
+    ".org", ".rst", ".adoc", ".tex", ".log",
+    ".env", ".ini", ".cfg", ".conf", ".properties",
+];
+const SKIP_DIRS = new Set([
+    "node_modules", ".git", "dist", "build", ".next", "__pycache__", ".venv",
+    ".cache", ".turbo", "coverage", ".nyc_output",
+]);
+// --- Manifest ---
+function loadManifest() {
+    try {
+        const raw = readFileSync(MANIFEST_PATH, "utf-8");
+        const data = JSON.parse(raw);
+        if (data.version === 1 && typeof data.files === "object")
+            return data;
+    }
+    catch { /* missing or corrupt */ }
+    return { version: 1, files: {} };
+}
+function saveManifest(manifest) {
+    mkdirSync(dirname(MANIFEST_PATH), { recursive: true });
+    writeFileSync(MANIFEST_PATH, JSON.stringify(manifest, null, 2) + "\n", "utf-8");
+}
+function discoverFiles(dir, extensions, maxDepth, depth = 0) {
+    if (depth > maxDepth)
+        return [];
+    const results = [];
+    let entries;
+    try {
+        entries = readdirSync(dir);
+    }
+    catch {
+        return results;
+    }
+    for (const entry of entries) {
+        if (SKIP_DIRS.has(entry))
+            continue;
+        const fullPath = join(dir, entry);
+        let stat;
+        try {
+            stat = statSync(fullPath);
+        }
+        catch {
+            continue;
+        }
+        if (stat.isDirectory()) {
+            results.push(...discoverFiles(fullPath, extensions, maxDepth, depth + 1));
+        }
+        else if (stat.isFile() && extensions.has(extname(entry).toLowerCase())) {
+            results.push({ path: fullPath, size: stat.size, mtime: stat.mtimeMs });
+        }
+    }
+    return results;
+}
+function hashFile(filePath) {
+    const content = readFileSync(filePath);
+    return "sha256-" + createHash("sha256").update(content).digest("hex");
+}
+// --- Scanner ---
+export async function scanFiles(dir, client, opts) {
+    const absDir = resolve(dir);
+    const extensions = opts?.extensions ?? DEFAULT_EXTENSIONS;
+    const extSet = new Set(extensions.map((e) => (e.startsWith(".") ? e : `.${e}`).toLowerCase()));
+    const maxFiles = opts?.maxFiles ?? 5;
+    const maxDepth = opts?.depth ?? 20;
+    const force = opts?.force ?? false;
+    const discovered = discoverFiles(absDir, extSet, maxDepth);
+    discovered.sort((a, b) => b.mtime - a.mtime);
+    const candidates = discovered.slice(0, maxFiles);
+    const manifest = force ? { version: 1, files: {} } : loadManifest();
+    const result = { scanned: 0, skipped: 0, errors: 0, files: [] };
+    for (const file of candidates) {
+        const hash = hashFile(file.path);
+        const existing = manifest.files[file.path];
+        if (existing && existing.hash === hash && !force) {
+            result.skipped++;
+            result.files.push({ path: file.path, status: "skipped", reason: "unchanged" });
+            continue;
+        }
+        try {
+            const content = readFileSync(file.path, "utf-8");
+            if (!content.trim()) {
+                result.skipped++;
+                result.files.push({ path: file.path, status: "skipped", reason: "empty" });
+                continue;
+            }
+            await client.ingest(content, `file-scan:${file.path}`);
+            manifest.files[file.path] = {
+                hash,
+                size: file.size,
+                scanned_at: new Date().toISOString(),
+            };
+            result.scanned++;
+            result.files.push({ path: file.path, status: "ingested", reason: existing ? "changed" : "new" });
+        }
+        catch (err) {
+            result.errors++;
+            result.files.push({ path: file.path, status: "error", reason: err instanceof Error ? err.message : String(err) });
+        }
+    }
+    saveManifest(manifest);
+    return result;
+}
+//# sourceMappingURL=file-scanner.js.map

package/openclaw-plugin/dist/file-scanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-scanner.js","sourceRoot":"","sources":["../src/file-scanner.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACxF,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAuBlC,oBAAoB;AAEpB,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,yBAAyB,CAAC,CAAC;AACzE,MAAM,kBAAkB,GAAG;IACzB,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;IACtC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;IACzD,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO;IACjE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO;IAC/B,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM;IACvC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa;CAC/C,CAAC;AACF,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC;IACxB,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO;IACxE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,aAAa;CAC9C,CAAC,CAAC;AAEH,mBAAmB;AAEnB,SAAS,YAAY;IACnB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;QACjD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAa,CAAC;QACzC,IAAI,IAAI,CAAC,OAAO,KAAK,CAAC,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;IACxE,CAAC;IAAC,MAAM,CAAC,CAAC,wBAAwB,CAAC,CAAC;IACpC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;AACnC,CAAC;AAED,SAAS,YAAY,CAAC,QAAkB;IACtC,SAAS,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACvD,aAAa,CAAC,aAAa,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;AAClF,CAAC;AAUD,SAAS,aAAa,CAAC,GAAW,EAAE,UAAuB,EAAE,QAAgB,EAAE,KAAK,GAAG,CAAC;IACtF,IAAI,KAAK,GAAG,QAAQ;QAAE,OAAO,EAAE,CAAC;IAChC,MAAM,OAAO,GAAqB,EAAE,CAAC;IACrC,IAAI,OAAiB,CAAC;IACtB,IAAI,CAAC;QAAC,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,OAAO,CAAC;IAAC,CAAC;IAE7D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,SAAS;QACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAClC,IAAI,IAAI,CAAC;QACT,IAAI,CAAC;YAAC,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC;YAAC,SAAS;QAAC,CAAC;QAEtD,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACvB,OAAO,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;QAC5E,CAAC;aAAM,IAAI,IAAI,CAAC,MAAM,EAAE,IAAI,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;YACzE,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,QAAQ,CAAC,QAAgB;IAChC,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IACvC,OAAO,SAAS,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACxE,CAAC;AAED,kBAAkB;AAElB,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,GAAW,EACX,MAAiB,EACjB,IAKC;IAED,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC5B,MAAM,UAAU,GAAG,IAAI,EAAE,UAAU,IAAI,kBAAkB,CAAC;IAC1D,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IAC/F,MAAM,QAAQ,GAAG,IAAI,EAAE,QAAQ,IAAI,CAAC,CAAC;IACrC,MAAM,QAAQ,GAAG,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;IACnC,MAAM,KAAK,GAAG,IAAI,EAAE,KAAK,IAAI,KAAK,CAAC;IAEnC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC3D,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IAC7C,MAAM,UAAU,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IAEjD,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAc,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC;IAChF,MAAM,MAAM,GAAe,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IAE5E,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjC,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAE3C,IAAI,QAAQ,IAAI,QAAQ,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACjD,MAAM,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;YAC/E,SAAS;QACX,CAAC;QAED,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YACjD,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;gBACpB,MAAM,CAAC,OAAO,EAAE,CAAC;gBACjB,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;gBAC3E,SAAS;YACX,CAAC;YAED,MAAM,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,aAAa,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;YAEvD,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;gBAC1B,IAAI;gBACJ,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACrC,CAAC;YAEF,MAAM,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QACnG,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACpH,CAAC;IACH,CAAC;IAED,YAAY,CAAC,QAAQ,CAAC,CAAC;IACvB,OAAO,MAAM,CAAC;AAChB,CAAC"}