@mrc2204/agent-smart-memo 4.1.3 → 5.0.0

package/README.md

@@ -1,38 +1,116 @@
-# @mrc2204/agent-smart-memo
+# Agent Smart Memo
 
-🧠 **Smart Memory Plugin for [OpenClaw](https://openclaw.ai)** — Give your AI agents persistent, intelligent memory.
+> **Shared Agent Memory Platform** with runtime adapters for **OpenClaw**, **Paperclip**, and future agent systems.
 
-Your agents forget everything after each conversation. This plugin fixes that.
+`agent-smart-memo` started as an OpenClaw memory plugin. It is now evolving into a **moduleized memory platform**:
 
-## What it does
+- **core** → contracts, use-cases, namespace policy, error model
+- **adapter-openclaw** → plugin entry, tool registration, hook wiring, runtime bridge
+- **adapter-paperclip** → runtime wrapper, caller integration, compatibility mapping
+- **shared infra** → Qdrant, embeddings, SlotDB, GraphDB, packaging scripts
 
-- **Auto-Capture** — Automatically extracts important facts from every conversation (names, preferences, decisions, project status, etc.)
-- **Auto-Recall** — Injects relevant memories into agent context before each response — agents "remember" without being told
-- **Essence Distillation** — Filters noise, keeps only decision-grade facts. Your agent's memory stays clean and useful
-- **Slot Memory** — Structured key-value storage organized by categories (profile, preferences, project, environment)
-- **Vector Search** — Find semantically similar memories using Qdrant
-- **Multi-Agent Support** — Each agent maintains its own memory scope, no cross-contamination
+That means this repository should no longer be understood as *only* an OpenClaw plugin repo.
+It is a **shared memory engine with target-specific artifacts**.
 
-## Installation
+---
+
+## 1) What this project does
+
+Agent Smart Memo provides a unified memory stack for AI agents:
+
+- **Semantic memory** via Qdrant (`memory_search`, `memory_store`)
+- **Structured slot memory** via SQLite (`memory_slot_*`)
+- **Graph memory** for entity/relationship retrieval (`memory_graph_*`)
+- **Auto-capture / auto-recall** for OpenClaw runtime
+- **Shared runtime contracts** for multi-system memory callers
+- **Target-based packaging** so each runtime only consumes the artifact it needs
+
+---
+
+## 2) Runtime targets
+
+### OpenClaw target
+Use this when you want Agent Smart Memo as an OpenClaw memory plugin.
+
+Contains:
+- core
+- required infra
+- OpenClaw adapter
+- plugin entry / hooks / tool registration
+
+Artifact intent:
+- **OpenClaw plugin artifact**
+
+### Paperclip target
+Use this when you want a Paperclip runtime caller over the same memory core.
+
+Contains:
+- core
+- required infra
+- Paperclip adapter
+- runtime wrapper / compatibility mapper
+
+Artifact intent:
+- **Paperclip runtime package**
+
+### Core target
+Use this when you only want shared contracts/use-cases for future systems.
+
+Contains:
+- core contracts
+- use-case abstractions
+- shared platform rules
+
+Artifact intent:
+- **runtime-agnostic shared memory core**
+
+---
+
+## 3) Architecture principles
+
+### Compatibility-first
+Current OpenClaw behavior must not break while module boundaries are extracted.
+
+### Target-based packaging
+Do **not** treat the whole repository output as one OpenClaw-only artifact.
+
+- OpenClaw artifact should contain only what OpenClaw needs
+- Paperclip artifact should contain only what Paperclip needs
+- Core artifact should stay reusable for future systems
+
+### Shared contracts
+The following should be shared across runtimes:
+- namespace policy
+- actor context contract
+- error model
+- use-case interfaces
+- rollout guardrails
+
+---
+
+## 4) Quick start for OpenClaw
+
+If your current goal is still **“install the memory plugin into OpenClaw”**, use this section.
+
+### Install
 
 ```bash
 openclaw plugins install @mrc2204/agent-smart-memo
 ```
 
-## Quick Start
-
-### 1. Prerequisites
+### Prerequisites
 
-You need two services running:
+You need these services running:
 
-| Service | What for | Install |
-|---------|----------|---------|
-| [Qdrant](https://qdrant.tech/documentation/quick-start/) | Stores memory vectors | `docker run -d -p 6333:6333 qdrant/qdrant` |
-| [Ollama](https://ollama.ai) | Generates text embeddings | [Download](https://ollama.ai/download) then `ollama pull mxbai-embed-large` |
+| Service | Purpose | Example |
+|---|---|---|
+| Qdrant | Semantic vector memory | `docker run -d -p 6333:6333 qdrant/qdrant` |
+| Embedding backend | Embeddings for semantic memory | Ollama / OpenAI-compatible / docker adapter |
+| LLM endpoint | Fact extraction / auto-capture | Any OpenAI-compatible API |
 
-### 2. Configure
+### OpenClaw config example
 
-Add to your `~/.openclaw/openclaw.json`:
+Add to `~/.openclaw/openclaw.json`:
 
 ```json5
 {
@@ -45,25 +123,20 @@ Add to your `~/.openclaw/openclaw.json`:
       "agent-smart-memo": {
         enabled: true,
         config: {
-          // Required: Qdrant connection
           qdrantHost: "localhost",
           qdrantPort: 6333,
           qdrantCollection: "openclaw_memory",
 
-          // Required: Any OpenAI-compatible API for fact extraction
           llmBaseUrl: "https://api.openai.com/v1",
           llmApiKey: "sk-...",
           llmModel: "gpt-4o-mini",
 
-          // Required: Embedding backend (additive, backward-compatible)
           embedBaseUrl: "http://localhost:11434",
-          embedBackend: "ollama", // optional: ollama | openai | docker
-          embedModel: "mxbai-embed-large",
+          embedBackend: "ollama",
+          embedModel: "qwen3-embedding:0.6b",
           embedDimensions: 1024,
 
-          // Optional: explicit SlotDB target dir
-          // Priority: OPENCLAW_SLOTDB_DIR > config.slotDbDir > ${OPENCLAW_STATE_DIR}/agent-memo
-          slotDbDir: "/Users/mrcagents/.openclaw/agent-memo"
+          slotDbDir: "/Users/your-user/.openclaw/agent-memo"
         }
       }
     }
@@ -71,156 +144,265 @@ Add to your `~/.openclaw/openclaw.json`:
 }
 ```
 
-### 3. Done!
+### OpenClaw target commands
 
-Start chatting with your agent. Memories are captured automatically.
+```bash
+npm install
+npm run build
+openclaw plugins install -l .
+```
 
-### Embedding backend mapping (internal)
+---
 
-When `embedBackend` is set, runtime maps requests internally (no user-facing `embedPath` config):
+## 5) Quick start for Paperclip
 
-- `ollama` → `/api/embeddings` body `{ model, prompt }` (legacy path/payload)
-- `docker` → `/engines/llama.cpp/v1/embeddings` body `{ model, input }`
-- `openai` → `/v1/embeddings` body `{ model, input }`
+If your goal is to let **Paperclip** consume the same memory core:
 
-If `embedBackend` is omitted, plugin preserves legacy auto behavior.
+### Build the Paperclip target
 
-## Configuration Options
+```bash
+npm install
+npm run build:paperclip
+npm run package:paperclip
+npm run pack:paperclip
+```
 
-| Option | Type | Default | Description |
-|--------|------|---------|-------------|
-| `qdrantHost` | string | `"localhost"` | Qdrant server hostname |
-| `qdrantPort` | number | `6333` | Qdrant server port |
-| `qdrantCollection` | string | `"openclaw_memory"` | Qdrant collection name |
-| `llmBaseUrl` | string | — | OpenAI-compatible API base URL |
-| `llmApiKey` | string | — | API key for the LLM |
-| `llmModel` | string | `"gpt-4o-mini"` | Model for fact extraction |
-| `embedBaseUrl` | string | `"http://localhost:11434"` | Embedding service base URL |
-| `embedBackend` | string | _unset_ | Optional backend selector: `ollama` \| `openai` \| `docker` (unset = legacy auto behavior) |
-| `embedModel` | string | `"mxbai-embed-large"` | Embedding model name |
-| `embedDimensions` | number | `1024` | Embedding vector dimensions |
-| `slotDbDir` | string | `${OPENCLAW_STATE_DIR}/agent-memo` | Explicit SlotDB directory. Overridden by `OPENCLAW_SLOTDB_DIR` if set |
-| `autoCaptureEnabled` | boolean | `true` | Enable automatic fact extraction |
-| `autoCaptureMinConfidence` | number | `0.7` | Minimum confidence to store a fact (0-1) |
-| `contextWindowMaxTokens` | number | `12000` | Max tokens sent to LLM for extraction |
-| `summarizeEveryActions` | number | `6` | Auto-summarize project state every N turns |
-| `slotCategories` | string[] | `["profile","preferences","project","environment","custom"]` | Allowed slot categories |
-| `maxSlots` | number | `500` | Max slots per agent+user scope |
-| `injectStateTokenBudget` | number | `500` | Max tokens for auto-recall context injection |
+### What Paperclip consumes
+Paperclip should consume:
+- shared core contracts/use-cases
+- Paperclip adapter runtime
+- no OpenClaw plugin metadata/runtime dependency unless explicitly needed
 
-See [CONFIG.example.json](./CONFIG.example.json) for a copy-paste template.
+### Current maturity
+Paperclip path has:
+- adapter contracts
+- compatibility mapper
+- runtime wrapper
+- production-like smoke verification
 
-### SlotDB Path Resolution
+But README intentionally does **not** overclaim this as full production-grade multi-runtime completion.
 
-`agent-smart-memo` now resolves the SQLite slot database directory in this order:
+---
 
-1. `OPENCLAW_SLOTDB_DIR`
-2. Plugin config `slotDbDir`
-3. Legacy fallback `${OPENCLAW_STATE_DIR}/agent-memo`
+## 6) Build targets
+
+### Default build
+
+```bash
+npm run build
+```
 
-Examples:
+Default build remains **OpenClaw-compatible** for backward compatibility.
 
-- `OPENCLAW_SLOTDB_DIR=/Users/mrcagents/.openclaw/agent-memo` → DB file becomes `/Users/mrcagents/.openclaw/agent-memo/slots.db`
-- Legacy `new SlotDB("/Users/mrcagents/.openclaw")` still resolves to `/Users/mrcagents/.openclaw/agent-memo/slots.db`
-- Passing `/Users/mrcagents/.openclaw/agent-memo` as the target dir will **not** create nested `/agent-memo/agent-memo`
+### Explicit targets
 
+```bash
+npm run build:openclaw
+npm run build:paperclip
+npm run build:core
+npm run build:all
+```
 
-## How It Works
+### Packaging
 
+```bash
+npm run package:openclaw
+npm run package:paperclip
+npm run package:core
 ```
-User sends message → Agent responds
-                          ↓
-                    [agent_end event]
-                          ↓
-              Auto-Capture extracts facts
-              using LLM + Essence Distillation
-                          ↓
-              Facts stored in SlotDB + Qdrant
-                          ↓
-              Next conversation starts
-                          ↓
-              Auto-Recall searches relevant memories
-                          ↓
-              Context injected into agent prompt
-                          ↓
-              Agent "remembers" previous conversations ✨
+
+### Pack tarballs
+
+```bash
+npm run pack:openclaw
+npm run pack:paperclip
+npm run pack:core
 ```
 
-### Essence Distillation Modes
+### Publish targets
 
-The plugin automatically detects what kind of content is being discussed and applies the right distillation mode:
+```bash
+npm run publish:openclaw
+npm run publish:paperclip
+npm run publish:core
+```
 
-| Mode | Auto-detected when... | What it keeps |
-|------|----------------------|---------------|
-| `general` | Most conversations | Key decisions, rules, configurations |
-| `principles` | Learning or teaching content | Core principles, atomic rules |
-| `requirements` | Technical specs or constraints | Measurable requirements, acceptance criteria |
-| `market_signal` | Financial or market discussions | Actionable signals, risk levels, triggers |
+> Publish requires valid npm authentication. If `NPM_TOKEN` is missing, publish should be treated as not ready / dry-run only.
 
-Modes are inferred automatically — no configuration needed.
+---
 
-## Available Tools
+## 7) CI/CD model
 
-These tools are automatically registered and available to your agents:
+GitHub Actions workflow: `.github/workflows/publish.yml`
 
-| Tool | Description |
-|------|-------------|
-| `memory_search` | Semantic search across all stored memories |
-| `memory_store` | Manually store a memory with vector embedding |
-| `memory_auto_capture` | Manually trigger fact extraction on text |
-| `memory_slot_get` | Read slot value(s) by key or category |
-| `memory_slot_set` | Write a structured slot value |
-| `memory_slot_delete` | Remove a slot |
-| `memory_slot_list` | List all slots for current scope |
-| `memory_graph_add` | Add a knowledge graph relation |
-| `memory_graph_query` | Query the knowledge graph |
+Current flow:
+- matrix build for `openclaw`, `paperclip`, `core`
+- build → package → pack `.tgz` → upload artifact
+- target-aware tests
+- `workflow_dispatch` for manual publish
+- `dry_run` supported
+- real publish gated by `NPM_TOKEN`
 
-## LLM Compatibility
+### Important distinction
+A `work/...` branch is for:
+- **CI checks**
+- **PR review**
+- **dry-run readiness**
 
-Any OpenAI-compatible chat completions API works:
+It is **not** the same as:
+- production deploy
+- final release approval
+- final npm publish approval
 
-| Provider | `llmBaseUrl` | `llmModel` |
-|----------|-------------|------------|
-| OpenAI | `https://api.openai.com/v1` | `gpt-4o-mini` |
-| Anthropic (via proxy) | Your proxy URL | `claude-sonnet-4-20250514` |
-| Local (Ollama) | `http://localhost:11434/v1` | `llama3.2` |
-| OpenRouter | `https://openrouter.ai/api/v1` | `google/gemini-2.5-flash` |
-| Any proxy | Your proxy URL | Your model |
+Recommended flow:
 
-## Commands
+```text
+work/... push -> CI checks -> PR review -> approve -> merge default branch -> publish/release/deploy
+```
 
-```bash
-# Install
-openclaw plugins install @mrc2204/agent-smart-memo
+---
+
+## 8) Memory capabilities
+
+### Semantic memory
+- `memory_search`
+- `memory_store`
+- namespace-aware retrieval
+- registry-aware alias normalization
+- explicit unknown namespace validation
+
+### Slot memory
+- `memory_slot_get`
+- `memory_slot_set`
+- `memory_slot_delete`
+- `memory_slot_list`
+
+### Graph memory
+- entity create/get/search
+- relationship add/remove
+- scoped traversal
 
-# Update to latest version
-openclaw plugins update agent-smart-memo
+### Runtime automation
+- auto-capture
+- auto-recall
+- runtime identity injection where supported
 
-# Check status
-openclaw plugins info agent-smart-memo
+---
+
+## 9) Configuration notes
+
+### Embedding backend mapping
+When `embedBackend` is set:
+- `ollama` → `/api/embeddings`
+- `docker` → `/engines/llama.cpp/v1/embeddings`
+- `openai` → `/v1/embeddings`
+
+If omitted, legacy auto behavior is preserved.
+
+### SlotDB path resolution
+Resolution order:
+1. `OPENCLAW_SLOTDB_DIR`
+2. plugin config `slotDbDir`
+3. `${OPENCLAW_STATE_DIR}/agent-memo`
 
-# Uninstall
-openclaw plugins uninstall agent-smart-memo
+---
+
+## 10) Verification levels
+
+### Build level
+Confirms code compiles:
+
+```bash
+npm run build
+npm run build:all
 ```
 
-## Development
+### Contract / integration level
 
 ```bash
-# Clone
-git clone https://github.com/cong91/agent-smart-memo.git
-cd agent-smart-memo
+npm test
+npm run test:openclaw
+npm run test:paperclip
+```
+
+### Production-like runtime verification
+Examples already added in this repo include:
+- Paperclip runtime E2E
+- OpenClaw anti-regression integration
+- production-like smoke parity harness
+
+This is stronger than mock-only testing, but still distinct from a full production deployment.
+
+---
+
+## 11) Repository layout (high level)
+
+```text
+src/
+  core/
+    contracts/
+    usecases/
+  adapters/
+    openclaw/
+    paperclip/
+  tools/
+  hooks/
+  entries/
+  services/
+  db/
+  shared/
+
+scripts/
+artifacts/
+docs/architecture/
+```
+
+---
 
-# Install & build
+## 12) Current project status
+
+Current repo status after ASM-43 work:
+- architecture pack completed
+- implementation pack substantially advanced
+- runtime wiring exists for OpenClaw and Paperclip paths
+- production-like smoke parity evidence exists
+- target-based packaging/build pipeline exists
+
+Still be precise about claims:
+- strong progress beyond scaffold ✅
+- compatibility-first runtime wiring ✅
+- full production-grade multi-runtime completion should only be claimed with full runtime-host evidence and approved release flow
+
+---
+
+## 13) Useful commands
+
+```bash
+# install dependencies
 npm install
+
+# default build (OpenClaw target)
 npm run build
 
-# Link for local development (changes apply immediately)
-openclaw plugins install -l .
+# build all targets
+npm run build:all
 
-# Run tests
+# test
 npm test
+npm run test:openclaw
+npm run test:paperclip
+
+# package / pack
+npm run package:openclaw
+npm run package:paperclip
+npm run package:core
+npm run pack:openclaw
+npm run pack:paperclip
+npm run pack:core
 ```
 
-## License
+---
+
+## 14) License
 
 MIT © [mrc2204](https://github.com/cong91)

package/dist/adapters/openclaw/tool-runtime.d.ts

@@ -0,0 +1,29 @@
+import { SlotDB } from "../../db/slot-db.js";
+import type { MemoryUseCasePort } from "../../core/contracts/adapter-contracts.js";
+import type { SemanticMemoryUseCase } from "../../core/usecases/semantic-memory-usecase.js";
+import { type MemoryRuntimeConfig } from "../../core/runtime-boundary.js";
+export declare function configureOpenClawRuntime(options?: {
+    stateDir?: string;
+    slotDbDir?: string;
+    semanticUseCaseFactory?: (slotDbDir: string) => SemanticMemoryUseCase | undefined;
+}): MemoryRuntimeConfig;
+export declare function getSessionKey(ctx: any): string;
+export declare function parseOpenClawSessionIdentity(sessionKey: string): {
+    userId: string;
+    agentId: string;
+};
+export declare function getSlotDBForContext(ctx: any): SlotDB;
+export declare function getMemoryUseCasePortForContext(ctx: any): MemoryUseCasePort;
+export declare function createOpenClawResult(text: string, isError?: boolean): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    details: {
+        toolResult: {
+            text: string;
+        };
+    };
+    isError: boolean;
+};
+//# sourceMappingURL=tool-runtime.d.ts.map

package/dist/adapters/openclaw/tool-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-runtime.d.ts","sourceRoot":"","sources":["../../../src/adapters/openclaw/tool-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAE7C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2CAA2C,CAAC;AACnF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gDAAgD,CAAC;AAC5F,OAAO,EAKL,KAAK,mBAAmB,EACzB,MAAM,gCAAgC,CAAC;AAQxC,wBAAgB,wBAAwB,CAAC,OAAO,CAAC,EAAE;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sBAAsB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,qBAAqB,GAAG,SAAS,CAAC;CACnF,GAAG,mBAAmB,CAStB;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAE9C;AAED,wBAAgB,4BAA4B,CAAC,UAAU,EAAE,MAAM,GAAG;IAChE,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB,CAEA;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAQpD;AAED,wBAAgB,8BAA8B,CAAC,GAAG,EAAE,GAAG,GAAG,iBAAiB,CAU1E;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,UAAQ;;;;;;;;;;;EAEjE"}

package/dist/adapters/openclaw/tool-runtime.js

@@ -0,0 +1,48 @@
+import { SlotDB } from "../../db/slot-db.js";
+import { DefaultMemoryUseCasePort } from "../../core/usecases/default-memory-usecase-port.js";
+import { createInitialRuntimeConfig, createToolTextResult, parseSessionIdentity, resolveSlotDbDirForContext, } from "../../core/runtime-boundary.js";
+// OpenClaw runtime adapter state
+let runtimeConfig = createInitialRuntimeConfig();
+const dbInstances = new Map();
+const useCasePortInstances = new Map();
+let semanticUseCaseFactory;
+export function configureOpenClawRuntime(options) {
+    runtimeConfig = {
+        stateDir: options?.stateDir || runtimeConfig.stateDir,
+        slotDbDir: options?.slotDbDir || runtimeConfig.slotDbDir,
+    };
+    if (options?.semanticUseCaseFactory) {
+        semanticUseCaseFactory = options.semanticUseCaseFactory;
+    }
+    return runtimeConfig;
+}
+export function getSessionKey(ctx) {
+    return ctx?.sessionKey || "agent:main:default";
+}
+export function parseOpenClawSessionIdentity(sessionKey) {
+    return parseSessionIdentity(sessionKey);
+}
+export function getSlotDBForContext(ctx) {
+    const slotDbDir = resolveSlotDbDirForContext(ctx, runtimeConfig);
+    let db = dbInstances.get(slotDbDir);
+    if (!db) {
+        db = new SlotDB(runtimeConfig.stateDir, { slotDbDir });
+        dbInstances.set(slotDbDir, db);
+    }
+    return db;
+}
+export function getMemoryUseCasePortForContext(ctx) {
+    const slotDbDir = resolveSlotDbDirForContext(ctx, runtimeConfig);
+    let port = useCasePortInstances.get(slotDbDir);
+    if (!port) {
+        const db = getSlotDBForContext(ctx);
+        const semanticUseCase = semanticUseCaseFactory ? semanticUseCaseFactory(slotDbDir) : undefined;
+        port = new DefaultMemoryUseCasePort(db, semanticUseCase);
+        useCasePortInstances.set(slotDbDir, port);
+    }
+    return port;
+}
+export function createOpenClawResult(text, isError = false) {
+    return createToolTextResult(text, isError);
+}
+//# sourceMappingURL=tool-runtime.js.map

package/dist/adapters/openclaw/tool-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-runtime.js","sourceRoot":"","sources":["../../../src/adapters/openclaw/tool-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EAAE,wBAAwB,EAAE,MAAM,oDAAoD,CAAC;AAG9F,OAAO,EACL,0BAA0B,EAC1B,oBAAoB,EACpB,oBAAoB,EACpB,0BAA0B,GAE3B,MAAM,gCAAgC,CAAC;AAExC,iCAAiC;AACjC,IAAI,aAAa,GAAwB,0BAA0B,EAAE,CAAC;AACtE,MAAM,WAAW,GAAG,IAAI,GAAG,EAAkB,CAAC;AAC9C,MAAM,oBAAoB,GAAG,IAAI,GAAG,EAA6B,CAAC;AAClE,IAAI,sBAA8F,CAAC;AAEnG,MAAM,UAAU,wBAAwB,CAAC,OAIxC;IACC,aAAa,GAAG;QACd,QAAQ,EAAE,OAAO,EAAE,QAAQ,IAAI,aAAa,CAAC,QAAQ;QACrD,SAAS,EAAE,OAAO,EAAE,SAAS,IAAI,aAAa,CAAC,SAAS;KACzD,CAAC;IACF,IAAI,OAAO,EAAE,sBAAsB,EAAE,CAAC;QACpC,sBAAsB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAC1D,CAAC;IACD,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,GAAQ;IACpC,OAAO,GAAG,EAAE,UAAU,IAAI,oBAAoB,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,UAAkB;IAI7D,OAAO,oBAAoB,CAAC,UAAU,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,GAAQ;IAC1C,MAAM,SAAS,GAAG,0BAA0B,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;IACjE,IAAI,EAAE,GAAG,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACpC,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,EAAE,GAAG,IAAI,MAAM,CAAC,aAAa,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;QACvD,WAAW,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,GAAQ;IACrD,MAAM,SAAS,GAAG,0BAA0B,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;IACjE,IAAI,IAAI,GAAG,oBAAoB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC/C,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,EAAE,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC;QACpC,MAAM,eAAe,GAAG,sBAAsB,CAAC,CAAC,CAAC,sBAAsB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC/F,IAAI,GAAG,IAAI,wBAAwB,CAAC,EAAE,EAAE,eAAe,CAAC,CAAC;QACzD,oBAAoB,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAY,EAAE,OAAO,GAAG,KAAK;IAChE,OAAO,oBAAoB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC7C,CAAC"}

package/dist/core/contracts/adapter-contracts.d.ts

@@ -0,0 +1,31 @@
+import type { MemoryNamespace } from "../../shared/memory-config.js";
+export interface MemoryContext {
+    userId: string;
+    agentId: string;
+    sessionId?: string;
+    traceId?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface CoreRequestEnvelope<TPayload> {
+    context: MemoryContext;
+    namespace?: MemoryNamespace;
+    payload: TPayload;
+    meta?: {
+        source: "openclaw" | "paperclip" | "cli" | "test";
+        traceId?: string;
+        toolName?: string;
+        requestId?: string;
+    };
+}
+export type MemoryUseCaseName = "slot.get" | "slot.set" | "slot.list" | "slot.delete" | "memory.capture" | "memory.search" | "graph.entity.get" | "graph.entity.set" | "graph.rel.add" | "graph.rel.remove" | "graph.search";
+export interface MemoryUseCasePort {
+    run<TReq, TRes>(useCase: MemoryUseCaseName, req: CoreRequestEnvelope<TReq>): Promise<TRes>;
+}
+export interface RuntimeContextMapper<TRuntimeCtx> {
+    toMemoryContext(runtimeCtx: TRuntimeCtx): MemoryContext;
+    toNamespace(input: unknown): MemoryNamespace | undefined;
+}
+export interface RuntimeErrorPresenter<TRuntimeErr> {
+    fromMemoryError(error: unknown): TRuntimeErr;
+}
+//# sourceMappingURL=adapter-contracts.d.ts.map

package/dist/core/contracts/adapter-contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-contracts.d.ts","sourceRoot":"","sources":["../../../src/core/contracts/adapter-contracts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAErE,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,mBAAmB,CAAC,QAAQ;IAC3C,OAAO,EAAE,aAAa,CAAC;IACvB,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,OAAO,EAAE,QAAQ,CAAC;IAClB,IAAI,CAAC,EAAE;QACL,MAAM,EAAE,UAAU,GAAG,WAAW,GAAG,KAAK,GAAG,MAAM,CAAC;QAClD,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED,MAAM,MAAM,iBAAiB,GACzB,UAAU,GACV,UAAU,GACV,WAAW,GACX,aAAa,GACb,gBAAgB,GAChB,eAAe,GACf,kBAAkB,GAClB,kBAAkB,GAClB,eAAe,GACf,kBAAkB,GAClB,cAAc,CAAC;AAEnB,MAAM,WAAW,iBAAiB;IAChC,GAAG,CAAC,IAAI,EAAE,IAAI,EACZ,OAAO,EAAE,iBAAiB,EAC1B,GAAG,EAAE,mBAAmB,CAAC,IAAI,CAAC,GAC7B,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB,CAAC,WAAW;IAC/C,eAAe,CAAC,UAAU,EAAE,WAAW,GAAG,aAAa,CAAC;IACxD,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,GAAG,SAAS,CAAC;CAC1D;AAED,MAAM,WAAW,qBAAqB,CAAC,WAAW;IAChD,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAAC;CAC9C"}

package/dist/core/contracts/adapter-contracts.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=adapter-contracts.js.map

package/dist/core/contracts/adapter-contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-contracts.js","sourceRoot":"","sources":["../../../src/core/contracts/adapter-contracts.ts"],"names":[],"mappings":""}