@mysten-incubation/oc-memwal 0.0.1-dev.0

package/LICENSE

@@ -0,0 +1,176 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute
+          must include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS

package/README.md

@@ -0,0 +1,216 @@
+<h1 align="center">@mysten-incubation/oc-memwal</h1>
+
+<p align="center">
+  Cloud-based long-term memory plugin for NemoClaw/OpenClaw — gives your AI agents persistent, encrypted, cross-session memory powered by <strong>MemWal</strong>.
+</p>
+
+<p align="center">
+  <a href="https://docs.memwal.ai/openclaw/overview"><strong>Documentation</strong></a> ·
+  <a href="#quick-start"><strong>Quick Start</strong></a> ·
+  <a href="#verify"><strong>Verify</strong></a> ·
+  <a href="#how-it-works"><strong>How It Works</strong></a>
+</p>
+<br/>
+
+## Overview
+
+Replaces OpenClaw's default file-based memory with a **remote memory backend**. After setup, the plugin runs silently — your agent remembers things from past conversations and learns new facts automatically, with no user intervention required.
+
+Memories are **encrypted** and stored on **MemWal**, a privacy-preserving memory protocol built on Walrus decentralized storage. Each user owns their memories via an **Ed25519 key** — no platform can access them without it.
+
+**Features:**
+- **Auto-recall** — relevant memories injected before each conversation turn
+- **Auto-capture** — facts extracted and stored after each turn
+- **Agent tools** — `memory_search` and `memory_store` for explicit LLM control
+- **Multi-agent isolation** — each agent gets its own memory namespace
+- **Prompt injection protection** — detection and escaping on all read/write paths
+- **CLI** — `openclaw memwal search` and `openclaw memwal stats` for debugging
+
+## Prerequisites
+
+### OpenClaw
+
+You need [OpenClaw](https://openclaw.ai) `>=2026.3.11` installed and running, and a package manager ([bun](https://bun.sh), pnpm, or npm).
+
+### MemWal Setup
+
+**MemWal** is an open-source, self-hostable memory infrastructure kit for encrypted, decentralized storage. You can run your own relayer or use a managed endpoint.
+
+The plugin needs three values:
+
+| Value | What it is |
+|-------|-----------|
+| **Delegate Key** | Private key (64-char hex) used to sign requests and encrypt memories |
+| **Account ID** | Your MemWalAccount object ID on Sui (`0x...`) |
+| **Relayer URL** | The MemWal relayer endpoint that handles search, storage, and encryption |
+
+Get your delegate key and account ID from the [MemWal dashboard](https://memwal.ai), or see the [Quick Start guide](/getting-started/quick-start) for detailed setup.
+
+For the relayer, use a managed endpoint or [self-host your own](/relayer/self-hosting):
+
+| Environment | Relayer URL |
+|-------------|-------------|
+| **Production** (mainnet) | `https://relayer.memwal.ai` |
+| **Development** (testnet) | `https://relayer.dev.memwal.ai` |
+
+## Quick Start
+
+### 1. Install
+
+```bash
+openclaw plugins install @mysten-incubation/oc-memwal
+```
+
+### 2. Set your delegate key
+
+Store your delegate key as an environment variable so it's never hardcoded in config files:
+
+```bash
+# Add to your shell profile (.zshrc, .bashrc, etc.)
+export MEMWAL_PRIVATE_KEY="your-64-char-hex-key"
+```
+
+### 3. Configure OpenClaw
+
+Add the plugin config to `~/.openclaw/openclaw.json`:
+
+```jsonc
+{
+  "plugins": {
+    "slots": { "memory": "oc-memwal" },
+    "entries": {
+      "oc-memwal": {
+        "enabled": true,
+        "config": {
+          "privateKey": "${MEMWAL_PRIVATE_KEY}",             // References the env var
+          "accountId": "0x3247e3da...",                    // Your account ID from the dashboard
+          "serverUrl": "https://relayer.dev.memwal.ai"    // Or your self-hosted relayer
+        }
+      }
+    }
+  }
+}
+```
+
+Optional settings you can add to the `config` block:
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `autoRecall` | `true` | Inject relevant memories before each turn |
+| `autoCapture` | `true` | Extract and store facts after each turn |
+| `maxRecallResults` | `5` | Max memories to inject per turn |
+| `minRelevance` | `0.3` | Relevance threshold (0-1) for memory injection |
+| `captureMaxMessages` | `10` | How many recent messages to analyze for facts |
+
+The defaults work well for most setups — you don't need to change them to get started.
+
+### 4. Start OpenClaw
+
+```bash
+openclaw gateway stop && openclaw gateway
+```
+
+You should see in the logs:
+
+```
+memory-memwal: registered (server: https://..., key: e21d...ed9b, namespace: default)
+memory-memwal: connected (status: ok, version: ...)
+```
+
+If you see `health check failed`, double-check that your server URL is reachable and your private key env var is set.
+
+## Verify
+
+### Check connectivity
+
+Run the stats command to confirm the plugin is connected and configured correctly:
+
+```bash
+openclaw memwal stats
+```
+
+This shows the server status, your key (masked), account ID, active namespace, and whether auto-recall/capture are enabled.
+
+### Test the memory loop
+
+The core value of the plugin is the automatic recall/capture cycle. Test it end-to-end:
+
+1. **Store a fact** — start a conversation and share something memorable:
+
+   ```
+   You: I prefer TypeScript over JavaScript for backend work
+   Bot: (responds normally)
+   ```
+
+   Check logs — you should see `memory-memwal: auto-captured 1 facts`. The plugin extracted the preference and stored it.
+
+2. **Recall it** — in a **new conversation**, ask about it:
+
+   ```
+   You: What programming languages do I like?
+   ```
+
+   Check logs — you should see `memory-memwal: auto-recall injected 1 memories`. The plugin found the stored preference and injected it into the LLM's context.
+
+3. **Search from terminal** — confirm the memory exists via CLI:
+
+   ```bash
+   openclaw memwal search "programming"
+   ```
+
+If all three steps work, the plugin is fully operational.
+
+---
+
+## How it works
+
+The plugin sits between OpenClaw's gateway and the MemWal server. It operates through **hooks** — automatic callbacks that run on every conversation turn. The LLM never sees them, doesn't trigger them, and can't prevent them.
+
+```mermaid
+graph TB
+    subgraph "OpenClaw Gateway"
+        RECALL["Auto-Recall Hook"]
+        PROMPT["Prompt Assembly"]
+        CAPTURE["Auto-Capture Hook"]
+    end
+
+    subgraph "LLM"
+        LLM_PROC["Language Model"]
+    end
+
+    subgraph "MemWal Server"
+        SEARCH["Vector Search"]
+        ANALYZE["Fact Extraction"]
+        STORE["Encrypted Storage"]
+    end
+
+    WALRUS["Walrus Network"]
+
+    USER([User Message]) --> RECALL
+    RECALL -->|"search memories"| SEARCH
+    SEARCH --> RECALL
+    RECALL -->|"inject into prompt"| PROMPT
+    PROMPT --> LLM_PROC
+    LLM_PROC --> RESPONSE([Response to User])
+    RESPONSE --> CAPTURE
+    CAPTURE -->|"extract facts"| ANALYZE
+    ANALYZE --> STORE
+    STORE --> WALRUS
+
+    style RECALL fill:#4a9eff,color:#fff
+    style CAPTURE fill:#4a9eff,color:#fff
+    style LLM_PROC fill:#ff9f4a,color:#fff
+    style STORE fill:#6b7280,color:#fff
+```
+
+Every conversation turn goes through two phases:
+
+- **Auto-recall** — before the LLM sees the user's message, the plugin searches MemWal for relevant memories and injects them into the prompt as context. The LLM sees these as background knowledge — it doesn't know they were injected.
+
+- **Auto-capture** — after the LLM responds, the plugin extracts the conversation, filters out trivial content (filler responses, emoji, etc.), and sends it to the MemWal server. The server-side LLM extracts individual facts and stores them as encrypted blobs on Walrus.
+
+The plugin also registers two optional **tools** (`memory_search` and `memory_store`) that give the LLM explicit control over memory operations. These require `tools.allow` in the agent profile and are a power-user feature — hooks handle the common case automatically.
+
+## License
+
+Apache-2.0

package/dist/capture.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Capture filtering — determines whether a conversation turn
+ * is worth sending to analyze() for fact extraction.
+ *
+ * Prevents wasted server calls on trivial turns like "ok", "thanks", emoji.
+ * Based on patterns from LanceDB's shouldCapture() implementation.
+ */
+/**
+ * Check if text looks like a prompt injection attempt.
+ * Used by both capture (reject on store) and recall (reject on inject).
+ */
+export declare function looksLikeInjection(text: string): boolean;
+/**
+ * Determine whether a conversation text is worth capturing.
+ *
+ * Applies a multi-step filter chain: rejects short text, filler responses,
+ * XML/system content, emoji-heavy messages, and injection attempts.
+ * Accepts immediately if a trigger pattern matches (e.g. "remember", "prefer").
+ * Falls through to accept if text is long enough for the server LLM to evaluate.
+ *
+ * @param text - Raw message text (user or assistant)
+ * @returns `true` if the text likely contains memorable facts
+ */
+export declare function shouldCapture(text: string): boolean;
+//# sourceMappingURL=capture.d.ts.map

package/dist/capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../src/capture.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAoCH;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAIxD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAsBnD"}

package/dist/capture.js

@@ -0,0 +1,80 @@
+/**
+ * Capture filtering — determines whether a conversation turn
+ * is worth sending to analyze() for fact extraction.
+ *
+ * Prevents wasted server calls on trivial turns like "ok", "thanks", emoji.
+ * Based on patterns from LanceDB's shouldCapture() implementation.
+ */
+// ============================================================================
+// Constants
+// ============================================================================
+const MIN_CAPTURE_LENGTH = 30;
+const MAX_EMOJI_COUNT = 3;
+/** Filler patterns — exact-match trivial responses. */
+const FILLER_PATTERN = /^(ok|okay|sure|thanks|thank you|thx|yes|yep|yeah|no|nope|nah|got it|hmm|hm|ah|oh|lol|haha|nice|cool|great|right|alright|fine|k|kk)\s*[.!?]*$/i;
+/** Prompt injection patterns — never capture these. */
+const INJECTION_PATTERNS = [
+    /ignore (all|any|previous|above|prior) instructions/i,
+    /do not follow (the )?(system|developer)/i,
+    /system prompt/i,
+    /<\s*(system|assistant|developer|tool|function)\b/i,
+    /\b(run|execute|call|invoke)\b.{0,40}\b(tool|command)\b/i,
+];
+/** Memory trigger patterns — always capture if matched (whitelist boost). */
+const TRIGGER_PATTERNS = [
+    /remember|prefer|radši|zapamatuj/i,
+    /i (like|prefer|hate|love|want|need|use|am|work)/i,
+    /my\s+\w+\s+is|is\s+my/i,
+    /always|never|important/i,
+    /decided|will use|switched to/i,
+    /\+\d{10,}/, // phone numbers
+    /[\w.-]+@[\w.-]+\.\w+/, // email addresses
+];
+// ============================================================================
+// Functions
+// ============================================================================
+/**
+ * Check if text looks like a prompt injection attempt.
+ * Used by both capture (reject on store) and recall (reject on inject).
+ */
+export function looksLikeInjection(text) {
+    const normalized = text.replace(/\s+/g, " ").trim();
+    if (!normalized)
+        return false;
+    return INJECTION_PATTERNS.some((p) => p.test(normalized));
+}
+/**
+ * Determine whether a conversation text is worth capturing.
+ *
+ * Applies a multi-step filter chain: rejects short text, filler responses,
+ * XML/system content, emoji-heavy messages, and injection attempts.
+ * Accepts immediately if a trigger pattern matches (e.g. "remember", "prefer").
+ * Falls through to accept if text is long enough for the server LLM to evaluate.
+ *
+ * @param text - Raw message text (user or assistant)
+ * @returns `true` if the text likely contains memorable facts
+ */
+export function shouldCapture(text) {
+    // Too short to contain useful facts
+    if (text.length < MIN_CAPTURE_LENGTH)
+        return false;
+    // Pure filler response
+    if (FILLER_PATTERN.test(text.trim()))
+        return false;
+    // System/XML content (likely injected context, not user speech)
+    if (text.trim().startsWith("<") && text.includes("</"))
+        return false;
+    // Emoji-heavy (likely reactions, not factual content)
+    const emojiCount = (text.match(/[\u{1F300}-\u{1F9FF}]/gu) || []).length;
+    if (emojiCount > MAX_EMOJI_COUNT)
+        return false;
+    // Prompt injection attempt — never store
+    if (INJECTION_PATTERNS.some((p) => p.test(text)))
+        return false;
+    // If it matches a trigger pattern, definitely capture
+    if (TRIGGER_PATTERNS.some((p) => p.test(text)))
+        return true;
+    // Default: capture if it's long enough (the server LLM will decide what's worth keeping)
+    return true;
+}
+//# sourceMappingURL=capture.js.map

package/dist/capture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture.js","sourceRoot":"","sources":["../src/capture.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAC9B,MAAM,eAAe,GAAG,CAAC,CAAC;AAE1B,uDAAuD;AACvD,MAAM,cAAc,GAAG,+IAA+I,CAAC;AAEvK,uDAAuD;AACvD,MAAM,kBAAkB,GAAG;IACzB,qDAAqD;IACrD,0CAA0C;IAC1C,gBAAgB;IAChB,mDAAmD;IACnD,yDAAyD;CAC1D,CAAC;AAEF,6EAA6E;AAC7E,MAAM,gBAAgB,GAAG;IACvB,kCAAkC;IAClC,kDAAkD;IAClD,wBAAwB;IACxB,yBAAyB;IACzB,+BAA+B;IAC/B,WAAW,EAAwB,gBAAgB;IACnD,sBAAsB,EAAa,kBAAkB;CACtD,CAAC;AAEF,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACpD,IAAI,CAAC,UAAU;QAAE,OAAO,KAAK,CAAC;IAC9B,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;AAC5D,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,oCAAoC;IACpC,IAAI,IAAI,CAAC,MAAM,GAAG,kBAAkB;QAAE,OAAO,KAAK,CAAC;IAEnD,uBAAuB;IACvB,IAAI,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAAE,OAAO,KAAK,CAAC;IAEnD,gEAAgE;IAChE,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAErE,sDAAsD;IACtD,MAAM,UAAU,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,yBAAyB,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;IACxE,IAAI,UAAU,GAAG,eAAe;QAAE,OAAO,KAAK,CAAC;IAE/C,yCAAyC;IACzC,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IAE/D,sDAAsD;IACtD,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAE5D,yFAAyF;IACzF,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/cli/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * CLI commands — openclaw memwal <command>
+ *
+ * Agent scoping via --agent flag → namespace.
+ */
+import type { MemWal } from "@mysten-incubation/memwal";
+import type { PluginConfig } from "../types.js";
+/** Register `openclaw memwal` CLI commands. */
+export declare function registerCli(api: any, client: MemWal, config: PluginConfig): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AAGxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,+CAA+C;AAC/C,wBAAgB,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAYhF"}

package/dist/cli/index.js

@@ -0,0 +1,18 @@
+/**
+ * CLI commands — openclaw memwal <command>
+ *
+ * Agent scoping via --agent flag → namespace.
+ */
+import { registerSearchCommand } from "./search.js";
+import { registerStatsCommand } from "./stats.js";
+/** Register `openclaw memwal` CLI commands. */
+export function registerCli(api, client, config) {
+    api.registerCli(({ program }) => {
+        const cmd = program
+            .command("memwal")
+            .description("MemWal memory plugin commands");
+        registerSearchCommand(cmd, client, config);
+        registerStatsCommand(cmd, client, config);
+    }, { commands: ["memwal"] });
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAGlD,+CAA+C;AAC/C,MAAM,UAAU,WAAW,CAAC,GAAQ,EAAE,MAAc,EAAE,MAAoB;IACxE,GAAG,CAAC,WAAW,CACb,CAAC,EAAE,OAAO,EAAO,EAAE,EAAE;QACnB,MAAM,GAAG,GAAG,OAAO;aAChB,OAAO,CAAC,QAAQ,CAAC;aACjB,WAAW,CAAC,+BAA+B,CAAC,CAAC;QAEhD,qBAAqB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAC3C,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C,CAAC,EACD,EAAE,QAAQ,EAAE,CAAC,QAAQ,CAAC,EAAE,CACzB,CAAC;AACJ,CAAC"}

package/dist/cli/search.d.ts

@@ -0,0 +1,10 @@
+/**
+ * CLI command — openclaw memwal search <query>
+ *
+ * Semantic search with JSON output, scoped by --agent flag.
+ */
+import type { MemWal } from "@mysten-incubation/memwal";
+import type { PluginConfig } from "../types.js";
+/** Register the `openclaw memwal search` command. */
+export declare function registerSearchCommand(cmd: any, client: MemWal, config: PluginConfig): void;
+//# sourceMappingURL=search.d.ts.map

package/dist/cli/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/cli/search.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AAExD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,qDAAqD;AACrD,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAuB1F"}

package/dist/cli/search.js

@@ -0,0 +1,32 @@
+/**
+ * CLI command — openclaw memwal search <query>
+ *
+ * Semantic search with JSON output, scoped by --agent flag.
+ */
+import { resolveAgent } from "../config.js";
+/** Register the `openclaw memwal search` command. */
+export function registerSearchCommand(cmd, client, config) {
+    cmd
+        .command("search")
+        .description("Search memories")
+        .argument("<query>", "Search query")
+        .option("--limit <n>", "Max results", "5")
+        .option("--agent <name>", "Search a specific agent's memory (namespace)")
+        .action(async (query, opts) => {
+        const { namespace } = resolveAgent(config.defaultNamespace, opts.agent ? `agent:${opts.agent}:cli` : undefined);
+        const limit = parseInt(opts.limit, 10);
+        try {
+            const result = await client.recall(query, limit, namespace);
+            const output = result.results.map((r) => ({
+                text: r.text,
+                blob_id: r.blob_id,
+                relevance: Math.round((1 - r.distance) * 100) / 100,
+            }));
+            console.log(JSON.stringify(output, null, 2));
+        }
+        catch (err) {
+            console.error(`Search failed: ${String(err)}`);
+        }
+    });
+}
+//# sourceMappingURL=search.js.map

package/dist/cli/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/cli/search.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAG5C,qDAAqD;AACrD,MAAM,UAAU,qBAAqB,CAAC,GAAQ,EAAE,MAAc,EAAE,MAAoB;IAClF,GAAG;SACA,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,iBAAiB,CAAC;SAC9B,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;SACnC,MAAM,CAAC,aAAa,EAAE,aAAa,EAAE,GAAG,CAAC;SACzC,MAAM,CAAC,gBAAgB,EAAE,8CAA8C,CAAC;SACxE,MAAM,CAAC,KAAK,EAAE,KAAa,EAAE,IAAS,EAAE,EAAE;QACzC,MAAM,EAAE,SAAS,EAAE,GAAG,YAAY,CAAC,MAAM,CAAC,gBAAgB,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAChH,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAEvC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;YAC5D,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC;gBAC7C,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG;aACpD,CAAC,CAAC,CAAC;YACJ,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC/C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,kBAAkB,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACjD,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/stats.d.ts

@@ -0,0 +1,10 @@
+/**
+ * CLI command — openclaw memwal stats
+ *
+ * Shows server health, config summary, and active namespace.
+ */
+import type { MemWal } from "@mysten-incubation/memwal";
+import type { PluginConfig } from "../types.js";
+/** Register the `openclaw memwal stats` command. */
+export declare function registerStatsCommand(cmd: any, client: MemWal, config: PluginConfig): void;
+//# sourceMappingURL=stats.d.ts.map

package/dist/cli/stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../src/cli/stats.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AAExD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,oDAAoD;AACpD,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAuBzF"}

package/dist/cli/stats.js

@@ -0,0 +1,31 @@
+/**
+ * CLI command — openclaw memwal stats
+ *
+ * Shows server health, config summary, and active namespace.
+ */
+import { resolveAgent, keyPreview } from "../config.js";
+/** Register the `openclaw memwal stats` command. */
+export function registerStatsCommand(cmd, client, config) {
+    cmd
+        .command("stats")
+        .description("Show memory status")
+        .option("--agent <name>", "Show stats for a specific agent (namespace)")
+        .action(async (opts) => {
+        const { namespace } = resolveAgent(config.defaultNamespace, opts.agent ? `agent:${opts.agent}:cli` : undefined);
+        try {
+            const health = await client.health();
+            console.log(`Server:     ${config.serverUrl}`);
+            console.log(`Status:     ${health.status}`);
+            console.log(`Version:    ${health.version}`);
+            console.log(`Key:        ${keyPreview(config.privateKey)}`);
+            console.log(`Account:    ${config.accountId.slice(0, 10)}...`);
+            console.log(`Namespace:  ${namespace}`);
+            console.log(`Auto-recall:  ${config.autoRecall}`);
+            console.log(`Auto-capture: ${config.autoCapture}`);
+        }
+        catch (err) {
+            console.error(`Stats failed: ${String(err)}`);
+        }
+    });
+}
+//# sourceMappingURL=stats.js.map

package/dist/cli/stats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.js","sourceRoot":"","sources":["../../src/cli/stats.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAGxD,oDAAoD;AACpD,MAAM,UAAU,oBAAoB,CAAC,GAAQ,EAAE,MAAc,EAAE,MAAoB;IACjF,GAAG;SACA,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,oBAAoB,CAAC;SACjC,MAAM,CAAC,gBAAgB,EAAE,6CAA6C,CAAC;SACvE,MAAM,CAAC,KAAK,EAAE,IAAS,EAAE,EAAE;QAC1B,MAAM,EAAE,SAAS,EAAE,GAAG,YAAY,CAAC,MAAM,CAAC,gBAAgB,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAEhH,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC;YAErC,OAAO,CAAC,GAAG,CAAC,eAAe,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;YAC/C,OAAO,CAAC,GAAG,CAAC,eAAe,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;YAC5C,OAAO,CAAC,GAAG,CAAC,eAAe,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;YAC7C,OAAO,CAAC,GAAG,CAAC,eAAe,UAAU,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;YAC5D,OAAO,CAAC,GAAG,CAAC,eAAe,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC;YAC/D,OAAO,CAAC,GAAG,CAAC,eAAe,SAAS,EAAE,CAAC,CAAC;YACxC,OAAO,CAAC,GAAG,CAAC,iBAAiB,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;YAClD,OAAO,CAAC,GAAG,CAAC,iBAAiB,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;QACrD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,iBAAiB,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChD,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}