Merge branch 'claude/add-memory-layer-De82O' into extension/claude-mem
This commit is contained in:
Alex Newman
commit
cc60285f49
390
docs/guides/claude-mem-setup.md
Normal file
390
docs/guides/claude-mem-setup.md
Normal file
@ -0,0 +1,390 @@
|
|||||||
|
# Clawdbot + Claude-Mem Setup Guide
|
||||||
|
|
||||||
|
Complete setup guide for integrating Clawdbot with Claude-Mem persistent memory.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Overview
|
||||||
|
|
||||||
|
This guide walks you through:
|
||||||
|
1. Installing Clawdbot (AI messaging gateway)
|
||||||
|
2. Installing Claude-Mem (persistent memory system)
|
||||||
|
3. Connecting them via the `memory-claudemem` plugin
|
||||||
|
|
||||||
|
**What you get:**
|
||||||
|
- Clawdbot routes messages between you and AI across multiple channels (Telegram, Discord, WhatsApp, etc.)
|
||||||
|
- Claude-Mem captures observations from every tool call and injects relevant context into future sessions
|
||||||
|
- Progressive disclosure memory tools (`memory_search`, `memory_observations`)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Prerequisites
|
||||||
|
|
||||||
|
- **Node.js 22+** (required for both Clawdbot and Claude-Mem)
|
||||||
|
- **macOS, Linux, or Windows (WSL2)**
|
||||||
|
- **Git** (for installing from source)
|
||||||
|
|
||||||
|
Check your Node version:
|
||||||
|
```bash
|
||||||
|
node -v
|
||||||
|
# Should show v22.x.x or higher
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Part 1: Install Clawdbot
|
||||||
|
|
||||||
|
### Option A: Quick Install (Recommended)
|
||||||
|
|
||||||
|
```bash
|
||||||
|
curl -fsSL https://clawd.bot/install.sh | bash
|
||||||
|
```
|
||||||
|
|
||||||
|
Windows (PowerShell):
|
||||||
|
```powershell
|
||||||
|
iwr -useb https://clawd.bot/install.ps1 | iex
|
||||||
|
```
|
||||||
|
|
||||||
|
This:
|
||||||
|
- Installs Node 22+ if needed
|
||||||
|
- Installs `clawdbot` globally via npm
|
||||||
|
- Runs the onboarding wizard
|
||||||
|
|
||||||
|
### Option B: Manual Install
|
||||||
|
|
||||||
|
If you already have Node 22+:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
npm install -g clawdbot@latest
|
||||||
|
```
|
||||||
|
|
||||||
|
Then run onboarding:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
clawdbot onboard --install-daemon
|
||||||
|
```
|
||||||
|
|
||||||
|
### Verify Installation
|
||||||
|
|
||||||
|
```bash
|
||||||
|
clawdbot --version
|
||||||
|
clawdbot doctor
|
||||||
|
```
|
||||||
|
|
||||||
|
### Common Issue: "clawdbot not found"
|
||||||
|
|
||||||
|
If your shell can't find `clawdbot`, add npm's global bin to your PATH:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Add to ~/.zshrc or ~/.bashrc
|
||||||
|
export PATH="$(npm prefix -g)/bin:$PATH"
|
||||||
|
```
|
||||||
|
|
||||||
|
Then restart your terminal or run `source ~/.zshrc`.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Part 2: Install Claude-Mem
|
||||||
|
|
||||||
|
Claude-Mem is a separate system that provides persistent memory. You need to install it independently.
|
||||||
|
|
||||||
|
### Option A: Via Claude Code Plugin (if using Claude Code)
|
||||||
|
|
||||||
|
If you use Claude Code (Anthropic's CLI), install claude-mem as a plugin:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# In a Claude Code session:
|
||||||
|
/plugin marketplace add thedotmack/claude-mem
|
||||||
|
/plugin install claude-mem
|
||||||
|
```
|
||||||
|
|
||||||
|
Restart Claude Code. The worker starts automatically.
|
||||||
|
|
||||||
|
### Option B: Manual Installation (Standalone)
|
||||||
|
|
||||||
|
Clone the repository:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd ~/Scripts # or wherever you keep projects
|
||||||
|
git clone https://github.com/thedotmack/claude-mem.git
|
||||||
|
cd claude-mem
|
||||||
|
```
|
||||||
|
|
||||||
|
Install dependencies and build:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
npm install
|
||||||
|
npm run build
|
||||||
|
```
|
||||||
|
|
||||||
|
Start the worker:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
npm run worker
|
||||||
|
# Or run in background:
|
||||||
|
nohup npm run worker > /tmp/claude-mem-worker.log 2>&1 &
|
||||||
|
```
|
||||||
|
|
||||||
|
### Verify Claude-Mem is Running
|
||||||
|
|
||||||
|
The worker runs on port 37777 by default.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
curl http://localhost:37777/api/health
|
||||||
|
# Should return: OK or {"status":"ok"}
|
||||||
|
```
|
||||||
|
|
||||||
|
Open the web viewer:
|
||||||
|
```bash
|
||||||
|
open http://localhost:37777
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Part 3: Enable the Memory-Claudemem Plugin
|
||||||
|
|
||||||
|
The `memory-claudemem` plugin connects Clawdbot to the Claude-Mem worker.
|
||||||
|
|
||||||
|
### Step 1: Disable Built-in Memory (Optional but Recommended)
|
||||||
|
|
||||||
|
Clawdbot has its own memory system. To avoid conflicts, disable it:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
clawdbot config set agents.defaults.memorySearch.enabled false
|
||||||
|
```
|
||||||
|
|
||||||
|
Verify:
|
||||||
|
```bash
|
||||||
|
clawdbot config get agents.defaults.memorySearch.enabled
|
||||||
|
# Should return: false
|
||||||
|
```
|
||||||
|
|
||||||
|
### Step 2: Enable the Claude-Mem Plugin
|
||||||
|
|
||||||
|
The plugin is bundled in the `extensions/memory-claudemem` directory. Enable it:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
clawdbot config set plugins.memory-claudemem.workerUrl "http://localhost:37777"
|
||||||
|
```
|
||||||
|
|
||||||
|
Optional: Adjust timeout (default 10 seconds):
|
||||||
|
```bash
|
||||||
|
clawdbot config set plugins.memory-claudemem.workerTimeout 15000
|
||||||
|
```
|
||||||
|
|
||||||
|
### Step 3: Verify Plugin Status
|
||||||
|
|
||||||
|
Check the worker connection:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
clawdbot claude-mem status
|
||||||
|
```
|
||||||
|
|
||||||
|
Expected output:
|
||||||
|
```
|
||||||
|
✓ Worker running at http://localhost:37777
|
||||||
|
```
|
||||||
|
|
||||||
|
If you see `✗ Worker not responding`, make sure Claude-Mem is running (see Part 2).
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Part 4: Test the Integration
|
||||||
|
|
||||||
|
### Test 1: Search Memories
|
||||||
|
|
||||||
|
```bash
|
||||||
|
clawdbot claude-mem search "authentication"
|
||||||
|
```
|
||||||
|
|
||||||
|
This queries Claude-Mem for observations matching "authentication".
|
||||||
|
|
||||||
|
### Test 2: Run an Agent with Memory
|
||||||
|
|
||||||
|
Send a test message through Clawdbot:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
clawdbot agent --message "List files in the current directory"
|
||||||
|
```
|
||||||
|
|
||||||
|
This should:
|
||||||
|
1. Execute the task
|
||||||
|
2. Record the observation to Claude-Mem (fire-and-forget)
|
||||||
|
3. Future queries will have this context injected
|
||||||
|
|
||||||
|
### Test 3: Verify Observation Recording
|
||||||
|
|
||||||
|
Open the Claude-Mem web viewer:
|
||||||
|
```bash
|
||||||
|
open http://localhost:37777
|
||||||
|
```
|
||||||
|
|
||||||
|
You should see new observations for tool calls made by Clawdbot.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Configuration Reference
|
||||||
|
|
||||||
|
### Full Config Example
|
||||||
|
|
||||||
|
Edit `~/.clawdbot/config.yml`:
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
# Disable built-in memory (use claude-mem instead)
|
||||||
|
agents:
|
||||||
|
defaults:
|
||||||
|
memorySearch:
|
||||||
|
enabled: false
|
||||||
|
|
||||||
|
# Enable claude-mem plugin
|
||||||
|
plugins:
|
||||||
|
memory-claudemem:
|
||||||
|
workerUrl: http://localhost:37777
|
||||||
|
workerTimeout: 10000
|
||||||
|
```
|
||||||
|
|
||||||
|
### Rollback to Built-in Memory
|
||||||
|
|
||||||
|
If you want to switch back to Clawdbot's built-in memory:
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
agents:
|
||||||
|
defaults:
|
||||||
|
memorySearch:
|
||||||
|
enabled: true
|
||||||
|
|
||||||
|
plugins:
|
||||||
|
memory-claudemem:
|
||||||
|
enabled: false
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Available Tools
|
||||||
|
|
||||||
|
When the plugin is active, these tools are available to the AI agent:
|
||||||
|
|
||||||
|
| Tool | Description |
|
||||||
|
|------|-------------|
|
||||||
|
| `memory_search` | Search past observations. Returns compact results with IDs. |
|
||||||
|
| `memory_observations` | Get full details for specific observation IDs. |
|
||||||
|
|
||||||
|
### 3-Layer Workflow
|
||||||
|
|
||||||
|
1. **Search** (`memory_search`): Get index with IDs (~50-100 tokens/result)
|
||||||
|
2. **Filter**: Review results, identify relevant IDs
|
||||||
|
3. **Fetch** (`memory_observations`): Get full details (~500-1000 tokens/result)
|
||||||
|
|
||||||
|
This pattern saves ~10x tokens compared to fetching everything.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## CLI Commands
|
||||||
|
|
||||||
|
| Command | Description |
|
||||||
|
|---------|-------------|
|
||||||
|
| `clawdbot claude-mem status` | Check if the worker is responding |
|
||||||
|
| `clawdbot claude-mem search <query>` | Search memories (JSON output) |
|
||||||
|
|
||||||
|
Options for search:
|
||||||
|
```bash
|
||||||
|
clawdbot claude-mem search "authentication" --limit 20
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Troubleshooting
|
||||||
|
|
||||||
|
### Worker Not Responding
|
||||||
|
|
||||||
|
1. Check if Claude-Mem is running:
|
||||||
|
```bash
|
||||||
|
curl http://localhost:37777/api/health
|
||||||
|
```
|
||||||
|
|
||||||
|
2. If not running, start it:
|
||||||
|
```bash
|
||||||
|
cd ~/Scripts/claude-mem
|
||||||
|
npm run worker
|
||||||
|
```
|
||||||
|
|
||||||
|
3. Check logs:
|
||||||
|
```bash
|
||||||
|
tail -f /tmp/claude-mem-worker.log
|
||||||
|
```
|
||||||
|
|
||||||
|
### Plugin Not Loading
|
||||||
|
|
||||||
|
1. Check plugin list:
|
||||||
|
```bash
|
||||||
|
clawdbot plugins list
|
||||||
|
```
|
||||||
|
|
||||||
|
2. Look for `memory-claudemem` in the output.
|
||||||
|
|
||||||
|
3. If missing, check the config:
|
||||||
|
```bash
|
||||||
|
clawdbot config get plugins.memory-claudemem
|
||||||
|
```
|
||||||
|
|
||||||
|
### No Observations Being Recorded
|
||||||
|
|
||||||
|
1. Enable debug logging:
|
||||||
|
```bash
|
||||||
|
clawdbot config set logging.level debug
|
||||||
|
```
|
||||||
|
|
||||||
|
2. Run a command and check logs:
|
||||||
|
```bash
|
||||||
|
clawdbot agent --message "test"
|
||||||
|
tail -f ~/.clawdbot/logs/gateway.log | grep claude-mem
|
||||||
|
```
|
||||||
|
|
||||||
|
### Context Not Being Injected
|
||||||
|
|
||||||
|
1. Check that there are observations in Claude-Mem (via web UI at http://localhost:37777)
|
||||||
|
2. Ensure the prompt is longer than 5 characters (short prompts skip injection)
|
||||||
|
3. Check logs for "injecting X memories into context"
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Architecture
|
||||||
|
|
||||||
|
```
|
||||||
|
┌──────────────────┐ ┌──────────────────┐
|
||||||
|
│ Clawdbot │ │ Claude-Mem │
|
||||||
|
│ Gateway │ │ Worker │
|
||||||
|
├──────────────────┤ ├──────────────────┤
|
||||||
|
│ │ │ │
|
||||||
|
│ before_agent │────▶│ context inject │
|
||||||
|
│ after_tool_call │────▶│ POST /observe │
|
||||||
|
│ │ │ │
|
||||||
|
│ memory_search │────▶│ GET /search │
|
||||||
|
│ memory_observations──▶│ POST /batch │
|
||||||
|
│ │ │ │
|
||||||
|
└──────────────────┘ └──────────────────┘
|
||||||
|
│ │
|
||||||
|
└────────────────────────┘
|
||||||
|
http://localhost:37777
|
||||||
|
```
|
||||||
|
|
||||||
|
**Hooks:**
|
||||||
|
- `before_agent_start`: Injects relevant memories as context
|
||||||
|
- `after_tool_call`: Records observations (fire-and-forget)
|
||||||
|
|
||||||
|
**Tools:**
|
||||||
|
- `memory_search`: Queries Claude-Mem's search API
|
||||||
|
- `memory_observations`: Fetches full observation details
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Next Steps
|
||||||
|
|
||||||
|
- **Set up messaging channels**: `clawdbot channels add telegram` (or discord, slack, etc.)
|
||||||
|
- **Configure the AI model**: `clawdbot config set agents.defaults.model claude-sonnet-4-20250514`
|
||||||
|
- **Start the gateway**: `clawdbot gateway run`
|
||||||
|
- **Open the dashboard**: `clawdbot dashboard`
|
||||||
|
|
||||||
|
For more information:
|
||||||
|
- Clawdbot docs: https://docs.clawd.bot
|
||||||
|
- Claude-Mem docs: https://docs.claude-mem.ai
|
||||||
619
docs/plans/claude-mem-integration.md
Normal file
619
docs/plans/claude-mem-integration.md
Normal file
@ -0,0 +1,619 @@
|
|||||||
|
# Claude-Mem Integration Plan
|
||||||
|
|
||||||
|
Integrate `thedotmack/claude-mem` as the primary observation agent and memory layer for Clawdbot.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Phase 0: Documentation Discovery
|
||||||
|
|
||||||
|
### Allowed APIs (Clawdbot Plugin System)
|
||||||
|
|
||||||
|
**Source:** `/home/user/clawdbot/src/plugins/types.ts:235-274`
|
||||||
|
|
||||||
|
| API | Signature | Use Case |
|
||||||
|
|-----|-----------|----------|
|
||||||
|
| `api.registerTool` | `(tool: AnyAgentTool \| ClawdbotPluginToolFactory, opts?: ClawdbotPluginToolOptions) => void` | Register memory tools |
|
||||||
|
| `api.on` | `<K extends PluginHookName>(hookName: K, handler: PluginHookHandlerMap[K]) => void` | Register lifecycle hooks |
|
||||||
|
| `api.registerCli` | `(registrar: ClawdbotPluginCliRegistrar, opts?: { commands?: string[] }) => void` | Add CLI commands |
|
||||||
|
| `api.registerService` | `(service: ClawdbotPluginService) => void` | Health check service |
|
||||||
|
| `api.logger` | `PluginLogger` | Logging (`info`, `warn`, `debug`) |
|
||||||
|
| `api.pluginConfig` | `Record<string, unknown>` | Plugin configuration |
|
||||||
|
|
||||||
|
### Available Hooks
|
||||||
|
|
||||||
|
**Source:** `/home/user/clawdbot/src/plugins/types.ts:289-303`
|
||||||
|
|
||||||
|
| Hook | Execution | Clawdbot → Claude-Mem |
|
||||||
|
|------|-----------|----------------------|
|
||||||
|
| `session_start` | Parallel (fire-and-forget) | → `SessionStart` |
|
||||||
|
| `before_agent_start` | Sequential (can modify) | → `UserPromptSubmit` + context injection |
|
||||||
|
| `after_tool_call` | Parallel (fire-and-forget) | → `PostToolUse` |
|
||||||
|
| `agent_end` | Parallel (fire-and-forget) | → `Stop` |
|
||||||
|
| `session_end` | Parallel (fire-and-forget) | → `SessionEnd` |
|
||||||
|
|
||||||
|
### Allowed APIs (Claude-Mem Worker)
|
||||||
|
|
||||||
|
**Source:** GitHub Issue #348, Platform Integration Guide
|
||||||
|
|
||||||
|
| Endpoint | Method | Request | Response |
|
||||||
|
|----------|--------|---------|----------|
|
||||||
|
| `/api/health` | GET | - | 200 OK |
|
||||||
|
| `/api/sessions/observations` | POST | `{ claudeSessionId, tool_name, tool_input, tool_response, cwd? }` | `{ id }` |
|
||||||
|
| `/api/search` | GET | `?query=<q>&type=observations&format=index&limit=<n>` | `SearchResult[]` |
|
||||||
|
| `/api/observations/batch` | POST | `{ ids: number[], orderBy?, limit? }` | `Observation[]` |
|
||||||
|
|
||||||
|
**Note:** `created_at_epoch` is in MILLISECONDS (not seconds).
|
||||||
|
|
||||||
|
### Memory Disable Mechanism
|
||||||
|
|
||||||
|
**Source:** `/home/user/clawdbot/src/agents/memory-search.ts:276`
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
// Existing kill switch - returns null when disabled
|
||||||
|
if (!resolved.enabled) return null;
|
||||||
|
```
|
||||||
|
|
||||||
|
**Config location:** `agents.defaults.memorySearch.enabled` (default: `true`)
|
||||||
|
|
||||||
|
### Copy-Ready Patterns
|
||||||
|
|
||||||
|
| Pattern | Source File | Lines |
|
||||||
|
|---------|-------------|-------|
|
||||||
|
| Minimal plugin structure | `/home/user/clawdbot/extensions/memory-core/index.ts` | 1-36 |
|
||||||
|
| Tool registration | `/home/user/clawdbot/extensions/memory-lancedb/index.ts` | 238-286 |
|
||||||
|
| Hook registration (`before_agent_start`) | `/home/user/clawdbot/extensions/memory-lancedb/index.ts` | 468-491 |
|
||||||
|
| Hook registration (`agent_end`) | `/home/user/clawdbot/extensions/memory-lancedb/index.ts` | 496-569 |
|
||||||
|
| CLI commands | `/home/user/clawdbot/extensions/memory-lancedb/index.ts` | 418-460 |
|
||||||
|
| Config schema with `parse` + `uiHints` | `/home/user/clawdbot/extensions/memory-lancedb/config.ts` | 61-114 |
|
||||||
|
| Plugin manifest | `/home/user/clawdbot/extensions/memory-lancedb/clawdbot.plugin.json` | 1-67 |
|
||||||
|
|
||||||
|
### Anti-Patterns to Avoid
|
||||||
|
|
||||||
|
1. **Do NOT invent API endpoints** - Only use confirmed endpoints from Phase 0
|
||||||
|
2. **Do NOT use `Type.Union` in tool schemas** - Use `stringEnum`/`optionalStringEnum` instead
|
||||||
|
3. **Do NOT use raw `format` property** - Reserved keyword in some validators
|
||||||
|
4. **Do NOT add dependencies to root package.json** - Plugin deps go in plugin's package.json
|
||||||
|
5. **Do NOT use `workspace:*` in dependencies** - Use in `devDependencies` or `peerDependencies` only
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Phase 1: Disable Built-in Memory
|
||||||
|
|
||||||
|
### What to Implement
|
||||||
|
|
||||||
|
1. Add `memorySearch.enabled: false` config to disable built-in memory tools
|
||||||
|
2. User configures this in their config file when using claude-mem
|
||||||
|
|
||||||
|
**No code changes required.** The existing kill switch at `src/agents/memory-search.ts:276` already returns `null` when `enabled: false`.
|
||||||
|
|
||||||
|
### Documentation References
|
||||||
|
|
||||||
|
- Config schema: `/home/user/clawdbot/src/config/types.tools.ts:223` (`enabled?: boolean`)
|
||||||
|
- Kill switch: `/home/user/clawdbot/src/agents/memory-search.ts:276`
|
||||||
|
- Tool creation guard: `/home/user/clawdbot/src/agents/tools/memory-tool.ts:32`
|
||||||
|
|
||||||
|
### Verification Checklist
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 1. Set config
|
||||||
|
clawdbot config set agents.defaults.memorySearch.enabled false
|
||||||
|
|
||||||
|
# 2. Verify memory tools are not registered
|
||||||
|
clawdbot agent --dry-run 2>&1 | grep -c "memory_search"
|
||||||
|
# Expected: 0
|
||||||
|
|
||||||
|
# 3. Verify config is persisted
|
||||||
|
clawdbot config get agents.defaults.memorySearch.enabled
|
||||||
|
# Expected: false
|
||||||
|
```
|
||||||
|
|
||||||
|
### Anti-Pattern Guards
|
||||||
|
|
||||||
|
- Do NOT modify `resolveMemorySearchConfig()` - existing logic sufficient
|
||||||
|
- Do NOT add new config keys - reuse existing `enabled` flag
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Phase 2: Create Plugin Structure
|
||||||
|
|
||||||
|
### What to Implement
|
||||||
|
|
||||||
|
Create `extensions/memory-claudemem/` by copying structure from `extensions/memory-lancedb/`.
|
||||||
|
|
||||||
|
### Documentation References
|
||||||
|
|
||||||
|
- Copy from: `/home/user/clawdbot/extensions/memory-lancedb/` (directory structure)
|
||||||
|
- Manifest spec: `/home/user/clawdbot/docs/plugins/manifest.md:16-42`
|
||||||
|
|
||||||
|
### Files to Create
|
||||||
|
|
||||||
|
```
|
||||||
|
extensions/memory-claudemem/
|
||||||
|
├── package.json # Copy from memory-lancedb/package.json
|
||||||
|
├── clawdbot.plugin.json # Copy from memory-lancedb/clawdbot.plugin.json
|
||||||
|
├── index.ts # Plugin entry point
|
||||||
|
├── config.ts # Config schema
|
||||||
|
├── client.ts # HTTP client for worker
|
||||||
|
└── types.ts # Type definitions
|
||||||
|
```
|
||||||
|
|
||||||
|
### package.json (Copy and Modify)
|
||||||
|
|
||||||
|
**Copy from:** `/home/user/clawdbot/extensions/memory-lancedb/package.json`
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"name": "@clawdbot/memory-claudemem",
|
||||||
|
"version": "0.0.1",
|
||||||
|
"type": "module",
|
||||||
|
"main": "index.ts",
|
||||||
|
"dependencies": {},
|
||||||
|
"devDependencies": {
|
||||||
|
"clawdbot": "workspace:*"
|
||||||
|
},
|
||||||
|
"peerDependencies": {
|
||||||
|
"clawdbot": "*"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### clawdbot.plugin.json (Copy and Modify)
|
||||||
|
|
||||||
|
**Copy from:** `/home/user/clawdbot/extensions/memory-lancedb/clawdbot.plugin.json:1-20`
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"id": "memory-claudemem",
|
||||||
|
"name": "Memory (Claude-Mem)",
|
||||||
|
"description": "Real-time observation and memory via claude-mem worker",
|
||||||
|
"kind": "memory",
|
||||||
|
"version": "0.0.1",
|
||||||
|
"configSchema": {
|
||||||
|
"type": "object",
|
||||||
|
"additionalProperties": false,
|
||||||
|
"properties": {
|
||||||
|
"workerUrl": { "type": "string", "default": "http://localhost:37777" },
|
||||||
|
"workerTimeout": { "type": "number", "default": 10000 }
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### Verification Checklist
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 1. Verify plugin loads
|
||||||
|
cd extensions/memory-claudemem && pnpm install
|
||||||
|
|
||||||
|
# 2. Verify manifest is valid JSON
|
||||||
|
cat clawdbot.plugin.json | jq .
|
||||||
|
|
||||||
|
# 3. Verify plugin appears in list
|
||||||
|
clawdbot plugins list | grep memory-claudemem
|
||||||
|
```
|
||||||
|
|
||||||
|
### Anti-Pattern Guards
|
||||||
|
|
||||||
|
- Do NOT add `workspace:*` to `dependencies` (breaks `npm install`)
|
||||||
|
- Do NOT add plugin deps to root `package.json`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Phase 3: HTTP Client
|
||||||
|
|
||||||
|
### What to Implement
|
||||||
|
|
||||||
|
Create `client.ts` with methods for claude-mem worker API.
|
||||||
|
|
||||||
|
### Documentation References
|
||||||
|
|
||||||
|
- Observation endpoint: `POST /api/sessions/observations` (GitHub Issue #348)
|
||||||
|
- Search endpoint: `GET /api/search?query=<q>&format=index`
|
||||||
|
- Batch fetch: `POST /api/observations/batch` (v7.3.0+)
|
||||||
|
- Health: `GET /api/health`
|
||||||
|
|
||||||
|
### client.ts
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
// Copy timeout + AbortController pattern from:
|
||||||
|
// /home/user/clawdbot/src/infra/fetch-with-timeout.ts (if exists)
|
||||||
|
// Otherwise use standard fetch with AbortController
|
||||||
|
|
||||||
|
export class ClaudeMemClient {
|
||||||
|
constructor(private baseUrl: string, private timeout: number) {}
|
||||||
|
|
||||||
|
async ping(): Promise<boolean> {
|
||||||
|
try {
|
||||||
|
const res = await fetch(`${this.baseUrl}/api/health`, {
|
||||||
|
signal: AbortSignal.timeout(this.timeout)
|
||||||
|
});
|
||||||
|
return res.ok;
|
||||||
|
} catch {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
async observe(sessionId: string, toolName: string, toolInput: unknown, toolResponse: unknown): Promise<void> {
|
||||||
|
await fetch(`${this.baseUrl}/api/sessions/observations`, {
|
||||||
|
method: "POST",
|
||||||
|
headers: { "Content-Type": "application/json" },
|
||||||
|
body: JSON.stringify({
|
||||||
|
claudeSessionId: sessionId,
|
||||||
|
tool_name: toolName,
|
||||||
|
tool_input: toolInput,
|
||||||
|
tool_response: toolResponse
|
||||||
|
}),
|
||||||
|
signal: AbortSignal.timeout(this.timeout)
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
async search(query: string, limit = 10): Promise<SearchResult[]> {
|
||||||
|
const params = new URLSearchParams({
|
||||||
|
query,
|
||||||
|
type: "observations",
|
||||||
|
format: "index",
|
||||||
|
limit: String(limit)
|
||||||
|
});
|
||||||
|
const res = await fetch(`${this.baseUrl}/api/search?${params}`, {
|
||||||
|
signal: AbortSignal.timeout(this.timeout)
|
||||||
|
});
|
||||||
|
return res.json();
|
||||||
|
}
|
||||||
|
|
||||||
|
async getObservations(ids: number[]): Promise<Observation[]> {
|
||||||
|
const res = await fetch(`${this.baseUrl}/api/observations/batch`, {
|
||||||
|
method: "POST",
|
||||||
|
headers: { "Content-Type": "application/json" },
|
||||||
|
body: JSON.stringify({ ids }),
|
||||||
|
signal: AbortSignal.timeout(this.timeout)
|
||||||
|
});
|
||||||
|
return res.json();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### Verification Checklist
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 1. Start claude-mem worker
|
||||||
|
claude-mem worker &
|
||||||
|
|
||||||
|
# 2. Test health endpoint
|
||||||
|
curl http://localhost:37777/api/health
|
||||||
|
# Expected: 200 OK
|
||||||
|
|
||||||
|
# 3. Test search endpoint
|
||||||
|
curl "http://localhost:37777/api/search?query=test&format=index&limit=5"
|
||||||
|
# Expected: JSON array
|
||||||
|
```
|
||||||
|
|
||||||
|
### Anti-Pattern Guards
|
||||||
|
|
||||||
|
- Do NOT invent endpoints like `/api/observe` - use documented `/api/sessions/observations`
|
||||||
|
- Do NOT assume `created_at_epoch` is in seconds - it's MILLISECONDS
|
||||||
|
- Do NOT skip error handling - worker may be offline
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Phase 4: Hook Registration
|
||||||
|
|
||||||
|
### What to Implement
|
||||||
|
|
||||||
|
Register hooks that forward events to claude-mem worker.
|
||||||
|
|
||||||
|
### Documentation References
|
||||||
|
|
||||||
|
- Hook handler signature: `/home/user/clawdbot/src/plugins/types.ts:466-520`
|
||||||
|
- Example `before_agent_start`: `/home/user/clawdbot/extensions/memory-lancedb/index.ts:468-491`
|
||||||
|
- Example `agent_end`: `/home/user/clawdbot/extensions/memory-lancedb/index.ts:496-569`
|
||||||
|
|
||||||
|
### Hook: after_tool_call → PostToolUse
|
||||||
|
|
||||||
|
**Copy pattern from:** `/home/user/clawdbot/extensions/memory-lancedb/index.ts:496-520`
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
// In index.ts register() function
|
||||||
|
api.on("after_tool_call", async (event, ctx) => {
|
||||||
|
// Skip our own tools to prevent recursion
|
||||||
|
if (event.toolName.startsWith("memory_")) return;
|
||||||
|
|
||||||
|
try {
|
||||||
|
await client.observe(
|
||||||
|
ctx.sessionId,
|
||||||
|
event.toolName,
|
||||||
|
event.params,
|
||||||
|
event.result
|
||||||
|
);
|
||||||
|
} catch (err) {
|
||||||
|
api.logger.warn?.(`claude-mem: observation failed: ${err}`);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
```
|
||||||
|
|
||||||
|
### Hook: before_agent_start → Context Injection
|
||||||
|
|
||||||
|
**Copy pattern from:** `/home/user/clawdbot/extensions/memory-lancedb/index.ts:468-491`
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
api.on("before_agent_start", async (event, ctx) => {
|
||||||
|
try {
|
||||||
|
const results = await client.search(event.prompt, 5);
|
||||||
|
if (results.length === 0) return;
|
||||||
|
|
||||||
|
const context = results
|
||||||
|
.map(r => `- [#${r.id}] ${r.title}: ${r.snippet}`)
|
||||||
|
.join("\n");
|
||||||
|
|
||||||
|
return {
|
||||||
|
prependContext: `<claude-mem-context>\n${context}\n</claude-mem-context>`
|
||||||
|
};
|
||||||
|
} catch (err) {
|
||||||
|
api.logger.warn?.(`claude-mem: context injection failed: ${err}`);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
```
|
||||||
|
|
||||||
|
### Verification Checklist
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 1. Enable debug logging
|
||||||
|
clawdbot config set plugins.memory-claudemem.debug true
|
||||||
|
|
||||||
|
# 2. Run a test message
|
||||||
|
clawdbot message send "test message"
|
||||||
|
|
||||||
|
# 3. Check logs for observation
|
||||||
|
tail -f ~/.clawdbot/logs/gateway.log | grep claude-mem
|
||||||
|
|
||||||
|
# 4. Verify in claude-mem UI
|
||||||
|
open http://localhost:37777
|
||||||
|
```
|
||||||
|
|
||||||
|
### Anti-Pattern Guards
|
||||||
|
|
||||||
|
- Do NOT observe `memory_*` tools (causes recursion)
|
||||||
|
- Do NOT block on observation failures (use fire-and-forget pattern for void hooks)
|
||||||
|
- Do NOT modify event object for void hooks (only `before_agent_start` can return modifications)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Phase 5: Progressive Disclosure Tools
|
||||||
|
|
||||||
|
### What to Implement
|
||||||
|
|
||||||
|
Register three tools following claude-mem's 3-layer retrieval pattern.
|
||||||
|
|
||||||
|
### Documentation References
|
||||||
|
|
||||||
|
- Tool registration: `/home/user/clawdbot/extensions/memory-lancedb/index.ts:238-286`
|
||||||
|
- Tool factory pattern: `/home/user/clawdbot/src/plugins/types.ts:69-77`
|
||||||
|
- Tool schema guardrails: Use `Type.Object` with `Type.String`, `Type.Optional`, `Type.Number`
|
||||||
|
|
||||||
|
### Layer 1: memory_search (~50-100 tokens per result)
|
||||||
|
|
||||||
|
**Copy pattern from:** `/home/user/clawdbot/extensions/memory-lancedb/index.ts:238-270`
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
api.registerTool({
|
||||||
|
name: "memory_search",
|
||||||
|
label: "Memory Search",
|
||||||
|
description: "Search past observations. Returns compact results with IDs. Use memory_observations for full details.",
|
||||||
|
parameters: Type.Object({
|
||||||
|
query: Type.String({ description: "Natural language search query" }),
|
||||||
|
limit: Type.Optional(Type.Number({ description: "Max results (default: 10)" }))
|
||||||
|
}),
|
||||||
|
async execute(_toolCallId, params) {
|
||||||
|
const results = await client.search(params.query, params.limit ?? 10);
|
||||||
|
const text = results.length === 0
|
||||||
|
? "No memories found."
|
||||||
|
: results.map((r, i) => `${i + 1}. [#${r.id}] ${r.title}`).join("\n");
|
||||||
|
return { content: [{ type: "text", text }] };
|
||||||
|
}
|
||||||
|
}, { name: "memory_search" });
|
||||||
|
```
|
||||||
|
|
||||||
|
### Layer 3: memory_observations (~500-1000 tokens per result)
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
api.registerTool({
|
||||||
|
name: "memory_observations",
|
||||||
|
label: "Memory Observations",
|
||||||
|
description: "Get full details for specific observation IDs. Use after memory_search to filter.",
|
||||||
|
parameters: Type.Object({
|
||||||
|
ids: Type.Array(Type.Number(), { description: "Observation IDs from memory_search" })
|
||||||
|
}),
|
||||||
|
async execute(_toolCallId, params) {
|
||||||
|
const observations = await client.getObservations(params.ids);
|
||||||
|
const text = observations.map(o =>
|
||||||
|
`## #${o.id}\n${o.narrative}\n\nFiles: ${o.files_modified?.join(", ") || "none"}`
|
||||||
|
).join("\n\n---\n\n");
|
||||||
|
return { content: [{ type: "text", text }] };
|
||||||
|
}
|
||||||
|
}, { name: "memory_observations" });
|
||||||
|
```
|
||||||
|
|
||||||
|
### Verification Checklist
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 1. Verify tools are registered
|
||||||
|
clawdbot tools list | grep memory_
|
||||||
|
|
||||||
|
# 2. Test search tool
|
||||||
|
clawdbot agent --message "Use memory_search to find recent file edits"
|
||||||
|
|
||||||
|
# 3. Test observations tool
|
||||||
|
clawdbot agent --message "Use memory_observations with IDs [1, 2, 3]"
|
||||||
|
```
|
||||||
|
|
||||||
|
### Anti-Pattern Guards
|
||||||
|
|
||||||
|
- Do NOT use `Type.Union` in parameters - not allowed by schema guardrails
|
||||||
|
- Do NOT use raw `format` property name - reserved keyword
|
||||||
|
- Do NOT return tool results without `content: [{ type: "text", text }]` structure
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Phase 6: CLI Commands
|
||||||
|
|
||||||
|
### What to Implement
|
||||||
|
|
||||||
|
Add CLI commands for worker status and manual search.
|
||||||
|
|
||||||
|
### Documentation References
|
||||||
|
|
||||||
|
- CLI registration: `/home/user/clawdbot/extensions/memory-lancedb/index.ts:418-460`
|
||||||
|
- Commander.js pattern: `/home/user/clawdbot/src/plugins/types.ts:193-200`
|
||||||
|
|
||||||
|
### Implementation
|
||||||
|
|
||||||
|
**Copy pattern from:** `/home/user/clawdbot/extensions/memory-lancedb/index.ts:418-460`
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
api.registerCli(({ program }) => {
|
||||||
|
const mem = program
|
||||||
|
.command("claude-mem")
|
||||||
|
.description("Claude-mem integration commands");
|
||||||
|
|
||||||
|
mem.command("status")
|
||||||
|
.description("Check claude-mem worker status")
|
||||||
|
.action(async () => {
|
||||||
|
const alive = await client.ping();
|
||||||
|
console.log(alive
|
||||||
|
? `✓ Worker running at ${cfg.workerUrl}`
|
||||||
|
: `✗ Worker not responding at ${cfg.workerUrl}`);
|
||||||
|
});
|
||||||
|
|
||||||
|
mem.command("search")
|
||||||
|
.description("Search memories")
|
||||||
|
.argument("<query>", "Search query")
|
||||||
|
.action(async (query) => {
|
||||||
|
const results = await client.search(query);
|
||||||
|
console.log(JSON.stringify(results, null, 2));
|
||||||
|
});
|
||||||
|
}, { commands: ["claude-mem"] });
|
||||||
|
```
|
||||||
|
|
||||||
|
### Verification Checklist
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 1. Verify command appears in help
|
||||||
|
clawdbot claude-mem --help
|
||||||
|
|
||||||
|
# 2. Test status command
|
||||||
|
clawdbot claude-mem status
|
||||||
|
|
||||||
|
# 3. Test search command
|
||||||
|
clawdbot claude-mem search "authentication"
|
||||||
|
```
|
||||||
|
|
||||||
|
### Anti-Pattern Guards
|
||||||
|
|
||||||
|
- Do NOT use reserved command names (help, send, config, status, etc.) - see `/home/user/clawdbot/src/plugins/commands.ts:33-69`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Phase 7: Verification
|
||||||
|
|
||||||
|
### Implementation Verification
|
||||||
|
|
||||||
|
1. **Memory disabled when configured:**
|
||||||
|
```bash
|
||||||
|
clawdbot config set agents.defaults.memorySearch.enabled false
|
||||||
|
clawdbot tools list | grep -v memory_claudemem | grep memory_
|
||||||
|
# Expected: no results (built-in memory tools gone)
|
||||||
|
```
|
||||||
|
|
||||||
|
2. **Plugin loads successfully:**
|
||||||
|
```bash
|
||||||
|
clawdbot plugins list | grep memory-claudemem
|
||||||
|
# Expected: memory-claudemem (enabled)
|
||||||
|
```
|
||||||
|
|
||||||
|
3. **Worker connection verified:**
|
||||||
|
```bash
|
||||||
|
clawdbot claude-mem status
|
||||||
|
# Expected: ✓ Worker running at http://localhost:37777
|
||||||
|
```
|
||||||
|
|
||||||
|
4. **Observations recorded:**
|
||||||
|
```bash
|
||||||
|
# Run a command
|
||||||
|
clawdbot agent --message "List files in current directory"
|
||||||
|
|
||||||
|
# Check worker UI
|
||||||
|
open http://localhost:37777
|
||||||
|
# Expected: New observation for "bash" tool
|
||||||
|
```
|
||||||
|
|
||||||
|
5. **Context injection works:**
|
||||||
|
```bash
|
||||||
|
# First, create some observations
|
||||||
|
clawdbot agent --message "Create a file called test.txt"
|
||||||
|
|
||||||
|
# Then search should inject context
|
||||||
|
DEBUG=claude-mem clawdbot agent --message "What files did I create recently?"
|
||||||
|
# Expected: Logs show context injection
|
||||||
|
```
|
||||||
|
|
||||||
|
### Anti-Pattern Check
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Grep for known bad patterns
|
||||||
|
grep -r "Type\.Union" extensions/memory-claudemem/
|
||||||
|
# Expected: no results
|
||||||
|
|
||||||
|
grep -r "format:" extensions/memory-claudemem/*.ts
|
||||||
|
# Expected: no results (or only in non-schema contexts)
|
||||||
|
|
||||||
|
grep -r "/api/observe" extensions/memory-claudemem/
|
||||||
|
# Expected: no results (should use /api/sessions/observations)
|
||||||
|
```
|
||||||
|
|
||||||
|
### Test Suite
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd extensions/memory-claudemem
|
||||||
|
pnpm test
|
||||||
|
# Expected: All tests pass
|
||||||
|
|
||||||
|
pnpm lint
|
||||||
|
# Expected: No lint errors
|
||||||
|
|
||||||
|
pnpm build
|
||||||
|
# Expected: Builds without type errors
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Configuration Summary
|
||||||
|
|
||||||
|
### User Config (to use claude-mem)
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
# ~/.clawdbot/config.yml
|
||||||
|
|
||||||
|
# Disable built-in memory
|
||||||
|
agents:
|
||||||
|
defaults:
|
||||||
|
memorySearch:
|
||||||
|
enabled: false
|
||||||
|
|
||||||
|
# Enable claude-mem plugin
|
||||||
|
plugins:
|
||||||
|
memory-claudemem:
|
||||||
|
workerUrl: http://localhost:37777
|
||||||
|
workerTimeout: 10000
|
||||||
|
```
|
||||||
|
|
||||||
|
### Rollback (to restore built-in memory)
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
agents:
|
||||||
|
defaults:
|
||||||
|
memorySearch:
|
||||||
|
enabled: true
|
||||||
|
|
||||||
|
plugins:
|
||||||
|
memory-claudemem:
|
||||||
|
enabled: false
|
||||||
|
```
|
||||||
27
extensions/memory-claudemem/clawdbot.plugin.json
Normal file
27
extensions/memory-claudemem/clawdbot.plugin.json
Normal file
@ -0,0 +1,27 @@
|
|||||||
|
{
|
||||||
|
"id": "memory-claudemem",
|
||||||
|
"name": "Memory (Claude-Mem)",
|
||||||
|
"description": "Real-time observation and memory via claude-mem worker",
|
||||||
|
"kind": "memory",
|
||||||
|
"version": "0.0.1",
|
||||||
|
"uiHints": {
|
||||||
|
"workerUrl": {
|
||||||
|
"label": "Worker URL",
|
||||||
|
"placeholder": "http://localhost:37777",
|
||||||
|
"help": "URL of the claude-mem worker"
|
||||||
|
},
|
||||||
|
"workerTimeout": {
|
||||||
|
"label": "Timeout (ms)",
|
||||||
|
"placeholder": "10000",
|
||||||
|
"advanced": true
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"configSchema": {
|
||||||
|
"type": "object",
|
||||||
|
"additionalProperties": false,
|
||||||
|
"properties": {
|
||||||
|
"workerUrl": { "type": "string", "default": "http://localhost:37777" },
|
||||||
|
"workerTimeout": { "type": "number", "default": 10000 }
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
143
extensions/memory-claudemem/client.ts
Normal file
143
extensions/memory-claudemem/client.ts
Normal file
@ -0,0 +1,143 @@
|
|||||||
|
import type { SearchResult, Observation } from "./types.js";
|
||||||
|
|
||||||
|
export class ClaudeMemClient {
|
||||||
|
constructor(
|
||||||
|
private readonly baseUrl: string,
|
||||||
|
private readonly timeout: number,
|
||||||
|
) {}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Check if the claude-mem worker is healthy.
|
||||||
|
* Returns true if the worker responds to health check, false otherwise.
|
||||||
|
*/
|
||||||
|
async ping(): Promise<boolean> {
|
||||||
|
try {
|
||||||
|
const response = await fetch(`${this.baseUrl}/api/health`, {
|
||||||
|
method: "GET",
|
||||||
|
signal: AbortSignal.timeout(this.timeout),
|
||||||
|
});
|
||||||
|
return response.ok;
|
||||||
|
} catch {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Record an observation to the claude-mem worker.
|
||||||
|
* Fire-and-forget pattern: errors are logged but do not block.
|
||||||
|
*/
|
||||||
|
async observe(
|
||||||
|
claudeSessionId: string,
|
||||||
|
toolName: string,
|
||||||
|
toolInput: unknown,
|
||||||
|
toolResponse: unknown,
|
||||||
|
cwd?: string,
|
||||||
|
): Promise<void> {
|
||||||
|
try {
|
||||||
|
const body = {
|
||||||
|
claudeSessionId,
|
||||||
|
tool_name: toolName,
|
||||||
|
tool_input: toolInput,
|
||||||
|
tool_response: toolResponse,
|
||||||
|
...(cwd && { cwd }),
|
||||||
|
};
|
||||||
|
|
||||||
|
await fetch(`${this.baseUrl}/api/sessions/observations`, {
|
||||||
|
method: "POST",
|
||||||
|
headers: {
|
||||||
|
"Content-Type": "application/json",
|
||||||
|
},
|
||||||
|
body: JSON.stringify(body),
|
||||||
|
signal: AbortSignal.timeout(this.timeout),
|
||||||
|
});
|
||||||
|
// Fire-and-forget: we don't check response status or throw on errors
|
||||||
|
} catch {
|
||||||
|
// Silently ignore errors - worker may be offline
|
||||||
|
// This is intentional: observations should never block the main flow
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Search observations by query.
|
||||||
|
* Returns an array of search results with id, title, snippet, and score.
|
||||||
|
*/
|
||||||
|
async search(query: string, limit = 10): Promise<SearchResult[]> {
|
||||||
|
try {
|
||||||
|
const searchParams = new URLSearchParams({
|
||||||
|
query,
|
||||||
|
type: "observations",
|
||||||
|
format: "index",
|
||||||
|
limit: String(limit),
|
||||||
|
});
|
||||||
|
|
||||||
|
const response = await fetch(
|
||||||
|
`${this.baseUrl}/api/search?${searchParams.toString()}`,
|
||||||
|
{
|
||||||
|
method: "GET",
|
||||||
|
signal: AbortSignal.timeout(this.timeout),
|
||||||
|
},
|
||||||
|
);
|
||||||
|
|
||||||
|
if (!response.ok) {
|
||||||
|
return [];
|
||||||
|
}
|
||||||
|
|
||||||
|
const data = await response.json();
|
||||||
|
|
||||||
|
// The API returns results in an array format
|
||||||
|
if (Array.isArray(data)) {
|
||||||
|
return data as SearchResult[];
|
||||||
|
}
|
||||||
|
|
||||||
|
// Handle wrapped response format { results: [...] }
|
||||||
|
if (data && Array.isArray(data.results)) {
|
||||||
|
return data.results as SearchResult[];
|
||||||
|
}
|
||||||
|
|
||||||
|
return [];
|
||||||
|
} catch {
|
||||||
|
return [];
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Fetch full observation details by IDs.
|
||||||
|
* Returns observations with narrative, files_modified, tool_name, tool_input, tool_response, and created_at_epoch.
|
||||||
|
*/
|
||||||
|
async getObservations(ids: number[]): Promise<Observation[]> {
|
||||||
|
if (ids.length === 0) {
|
||||||
|
return [];
|
||||||
|
}
|
||||||
|
|
||||||
|
try {
|
||||||
|
const response = await fetch(`${this.baseUrl}/api/observations/batch`, {
|
||||||
|
method: "POST",
|
||||||
|
headers: {
|
||||||
|
"Content-Type": "application/json",
|
||||||
|
},
|
||||||
|
body: JSON.stringify({ ids }),
|
||||||
|
signal: AbortSignal.timeout(this.timeout),
|
||||||
|
});
|
||||||
|
|
||||||
|
if (!response.ok) {
|
||||||
|
return [];
|
||||||
|
}
|
||||||
|
|
||||||
|
const data = await response.json();
|
||||||
|
|
||||||
|
// Handle direct array response
|
||||||
|
if (Array.isArray(data)) {
|
||||||
|
return data as Observation[];
|
||||||
|
}
|
||||||
|
|
||||||
|
// Handle wrapped response format { observations: [...] }
|
||||||
|
if (data && Array.isArray(data.observations)) {
|
||||||
|
return data.observations as Observation[];
|
||||||
|
}
|
||||||
|
|
||||||
|
return [];
|
||||||
|
} catch {
|
||||||
|
return [];
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
49
extensions/memory-claudemem/config.ts
Normal file
49
extensions/memory-claudemem/config.ts
Normal file
@ -0,0 +1,49 @@
|
|||||||
|
export type ClaudeMemConfig = {
|
||||||
|
workerUrl: string;
|
||||||
|
workerTimeout: number;
|
||||||
|
};
|
||||||
|
|
||||||
|
const DEFAULT_WORKER_URL = "http://localhost:37777";
|
||||||
|
const DEFAULT_TIMEOUT = 10000;
|
||||||
|
|
||||||
|
function assertAllowedKeys(
|
||||||
|
value: Record<string, unknown>,
|
||||||
|
allowed: string[],
|
||||||
|
label: string,
|
||||||
|
) {
|
||||||
|
const unknown = Object.keys(value).filter((key) => !allowed.includes(key));
|
||||||
|
if (unknown.length === 0) return;
|
||||||
|
throw new Error(`${label} has unknown keys: ${unknown.join(", ")}`);
|
||||||
|
}
|
||||||
|
|
||||||
|
export const claudeMemConfigSchema = {
|
||||||
|
parse(value: unknown): ClaudeMemConfig {
|
||||||
|
if (!value || typeof value !== "object" || Array.isArray(value)) {
|
||||||
|
// Return defaults if no config provided
|
||||||
|
return {
|
||||||
|
workerUrl: DEFAULT_WORKER_URL,
|
||||||
|
workerTimeout: DEFAULT_TIMEOUT,
|
||||||
|
};
|
||||||
|
}
|
||||||
|
const cfg = value as Record<string, unknown>;
|
||||||
|
assertAllowedKeys(cfg, ["workerUrl", "workerTimeout"], "claude-mem config");
|
||||||
|
|
||||||
|
return {
|
||||||
|
workerUrl: typeof cfg.workerUrl === "string" ? cfg.workerUrl : DEFAULT_WORKER_URL,
|
||||||
|
workerTimeout: typeof cfg.workerTimeout === "number" ? cfg.workerTimeout : DEFAULT_TIMEOUT,
|
||||||
|
};
|
||||||
|
},
|
||||||
|
uiHints: {
|
||||||
|
workerUrl: {
|
||||||
|
label: "Worker URL",
|
||||||
|
placeholder: DEFAULT_WORKER_URL,
|
||||||
|
help: "URL of the claude-mem worker",
|
||||||
|
},
|
||||||
|
workerTimeout: {
|
||||||
|
label: "Timeout (ms)",
|
||||||
|
placeholder: String(DEFAULT_TIMEOUT),
|
||||||
|
advanced: true,
|
||||||
|
help: "Request timeout in milliseconds",
|
||||||
|
},
|
||||||
|
},
|
||||||
|
};
|
||||||
195
extensions/memory-claudemem/index.ts
Normal file
195
extensions/memory-claudemem/index.ts
Normal file
@ -0,0 +1,195 @@
|
|||||||
|
import type { ClawdbotPluginApi } from "clawdbot/plugin-sdk";
|
||||||
|
import { Type } from "@sinclair/typebox";
|
||||||
|
import { claudeMemConfigSchema } from "./config.js";
|
||||||
|
import { ClaudeMemClient } from "./client.js";
|
||||||
|
|
||||||
|
const claudeMemPlugin = {
|
||||||
|
id: "memory-claudemem",
|
||||||
|
name: "Memory (Claude-Mem)",
|
||||||
|
description: "Real-time observation and memory via claude-mem worker",
|
||||||
|
kind: "memory" as const,
|
||||||
|
configSchema: claudeMemConfigSchema,
|
||||||
|
|
||||||
|
register(api: ClawdbotPluginApi) {
|
||||||
|
const cfg = claudeMemConfigSchema.parse(api.pluginConfig);
|
||||||
|
const client = new ClaudeMemClient(cfg.workerUrl, cfg.workerTimeout);
|
||||||
|
|
||||||
|
api.logger.info(
|
||||||
|
`memory-claudemem: plugin registered (worker: ${cfg.workerUrl})`,
|
||||||
|
);
|
||||||
|
|
||||||
|
// Hook: after_tool_call → Observe tool calls (fire-and-forget)
|
||||||
|
api.on("after_tool_call", async (event, ctx) => {
|
||||||
|
// Skip memory tools to prevent recursion
|
||||||
|
if (event.toolName.startsWith("memory_")) return;
|
||||||
|
|
||||||
|
try {
|
||||||
|
// Fire-and-forget: don't await, let it run in parallel
|
||||||
|
// Use sessionKey as the session identifier (may be undefined)
|
||||||
|
client.observe(
|
||||||
|
ctx.sessionKey ?? "unknown",
|
||||||
|
event.toolName,
|
||||||
|
event.params,
|
||||||
|
event.result,
|
||||||
|
);
|
||||||
|
} catch (err) {
|
||||||
|
api.logger.warn?.(`memory-claudemem: observation failed: ${err}`);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
// Hook: before_agent_start → Context injection from memory search
|
||||||
|
api.on("before_agent_start", async (event) => {
|
||||||
|
// Skip if prompt is empty or too short
|
||||||
|
if (!event.prompt || event.prompt.length < 5) return;
|
||||||
|
|
||||||
|
try {
|
||||||
|
const results = await client.search(event.prompt, 5);
|
||||||
|
if (results.length === 0) return;
|
||||||
|
|
||||||
|
const memoryContext = results
|
||||||
|
.map((r) => `- [#${r.id}] ${r.title}: ${r.snippet}`)
|
||||||
|
.join("\n");
|
||||||
|
|
||||||
|
api.logger.info?.(
|
||||||
|
`memory-claudemem: injecting ${results.length} memories into context`,
|
||||||
|
);
|
||||||
|
|
||||||
|
return {
|
||||||
|
prependContext: `<claude-mem-context>\nThe following memories may be relevant:\n${memoryContext}\n</claude-mem-context>`,
|
||||||
|
};
|
||||||
|
} catch (err) {
|
||||||
|
api.logger.warn?.(`memory-claudemem: context injection failed: ${err}`);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
// Phase 5: Tool registration
|
||||||
|
// memory_search - Layer 1: compact results (~50-100 tokens per result)
|
||||||
|
api.registerTool(
|
||||||
|
{
|
||||||
|
name: "memory_search",
|
||||||
|
label: "Memory Search",
|
||||||
|
description:
|
||||||
|
"Search past observations. Returns compact results with IDs. Use memory_observations for full details.",
|
||||||
|
parameters: Type.Object({
|
||||||
|
query: Type.String({ description: "Search query" }),
|
||||||
|
limit: Type.Optional(
|
||||||
|
Type.Number({ description: "Max results (default: 10)" }),
|
||||||
|
),
|
||||||
|
}),
|
||||||
|
async execute(_toolCallId, params) {
|
||||||
|
const { query, limit = 10 } = params as {
|
||||||
|
query: string;
|
||||||
|
limit?: number;
|
||||||
|
};
|
||||||
|
|
||||||
|
const results = await client.search(query, limit);
|
||||||
|
|
||||||
|
if (results.length === 0) {
|
||||||
|
return {
|
||||||
|
content: [{ type: "text", text: "No relevant memories found." }],
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
const text = results.map((r) => `[#${r.id}] ${r.title}`).join("\n");
|
||||||
|
|
||||||
|
return {
|
||||||
|
content: [
|
||||||
|
{
|
||||||
|
type: "text",
|
||||||
|
text: `Found ${results.length} memories:\n\n${text}`,
|
||||||
|
},
|
||||||
|
],
|
||||||
|
};
|
||||||
|
},
|
||||||
|
},
|
||||||
|
{ name: "memory_search" },
|
||||||
|
);
|
||||||
|
|
||||||
|
// memory_observations - Layer 3: full details (~500-1000 tokens per result)
|
||||||
|
api.registerTool(
|
||||||
|
{
|
||||||
|
name: "memory_observations",
|
||||||
|
label: "Memory Observations",
|
||||||
|
description:
|
||||||
|
"Get full details for specific observation IDs. Use after memory_search to filter.",
|
||||||
|
parameters: Type.Object({
|
||||||
|
ids: Type.Array(Type.Number(), {
|
||||||
|
description: "Array of observation IDs to fetch",
|
||||||
|
}),
|
||||||
|
}),
|
||||||
|
async execute(_toolCallId, params) {
|
||||||
|
const { ids } = params as { ids: number[] };
|
||||||
|
|
||||||
|
if (ids.length === 0) {
|
||||||
|
return {
|
||||||
|
content: [{ type: "text", text: "No observation IDs provided." }],
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
const observations = await client.getObservations(ids);
|
||||||
|
|
||||||
|
if (observations.length === 0) {
|
||||||
|
return {
|
||||||
|
content: [
|
||||||
|
{
|
||||||
|
type: "text",
|
||||||
|
text: "No observations found for the given IDs.",
|
||||||
|
},
|
||||||
|
],
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
const text = observations
|
||||||
|
.map((obs) => {
|
||||||
|
const filesSection =
|
||||||
|
obs.files_modified && obs.files_modified.length > 0
|
||||||
|
? `\n\nFiles: ${obs.files_modified.join(", ")}`
|
||||||
|
: "";
|
||||||
|
return `## #${obs.id}\n${obs.narrative}${filesSection}`;
|
||||||
|
})
|
||||||
|
.join("\n\n---\n\n");
|
||||||
|
|
||||||
|
return {
|
||||||
|
content: [{ type: "text", text }],
|
||||||
|
};
|
||||||
|
},
|
||||||
|
},
|
||||||
|
{ name: "memory_observations" },
|
||||||
|
);
|
||||||
|
|
||||||
|
// Phase 6: CLI registration
|
||||||
|
api.registerCli(
|
||||||
|
({ program }) => {
|
||||||
|
const claudeMem = program
|
||||||
|
.command("claude-mem")
|
||||||
|
.description("Claude-mem memory plugin commands");
|
||||||
|
|
||||||
|
claudeMem
|
||||||
|
.command("status")
|
||||||
|
.description("Check if the claude-mem worker is responding")
|
||||||
|
.action(async () => {
|
||||||
|
const isHealthy = await client.ping();
|
||||||
|
if (isHealthy) {
|
||||||
|
console.log(`✓ Worker running at ${cfg.workerUrl}`);
|
||||||
|
} else {
|
||||||
|
console.log(`✗ Worker not responding at ${cfg.workerUrl}`);
|
||||||
|
process.exitCode = 1;
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
claudeMem
|
||||||
|
.command("search")
|
||||||
|
.description("Search memories")
|
||||||
|
.argument("<query>", "Search query")
|
||||||
|
.option("--limit <n>", "Max results", "10")
|
||||||
|
.action(async (query, opts) => {
|
||||||
|
const results = await client.search(query, parseInt(opts.limit));
|
||||||
|
console.log(JSON.stringify(results, null, 2));
|
||||||
|
});
|
||||||
|
},
|
||||||
|
{ commands: ["claude-mem"] },
|
||||||
|
);
|
||||||
|
},
|
||||||
|
};
|
||||||
|
|
||||||
|
export default claudeMemPlugin;
|
||||||
13
extensions/memory-claudemem/package.json
Normal file
13
extensions/memory-claudemem/package.json
Normal file
@ -0,0 +1,13 @@
|
|||||||
|
{
|
||||||
|
"name": "@clawdbot/memory-claudemem",
|
||||||
|
"version": "0.0.1",
|
||||||
|
"type": "module",
|
||||||
|
"main": "index.ts",
|
||||||
|
"dependencies": {},
|
||||||
|
"devDependencies": {
|
||||||
|
"clawdbot": "workspace:*"
|
||||||
|
},
|
||||||
|
"peerDependencies": {
|
||||||
|
"clawdbot": "*"
|
||||||
|
}
|
||||||
|
}
|
||||||
24
extensions/memory-claudemem/types.ts
Normal file
24
extensions/memory-claudemem/types.ts
Normal file
@ -0,0 +1,24 @@
|
|||||||
|
/** Search result from claude-mem worker (index format) */
|
||||||
|
export type SearchResult = {
|
||||||
|
id: number;
|
||||||
|
title: string;
|
||||||
|
snippet?: string;
|
||||||
|
score?: number;
|
||||||
|
};
|
||||||
|
|
||||||
|
/** Full observation from claude-mem worker */
|
||||||
|
export type Observation = {
|
||||||
|
id: number;
|
||||||
|
narrative: string;
|
||||||
|
files_modified?: string[];
|
||||||
|
tool_name?: string;
|
||||||
|
tool_input?: unknown;
|
||||||
|
tool_response?: unknown;
|
||||||
|
created_at_epoch?: number;
|
||||||
|
};
|
||||||
|
|
||||||
|
/** Plugin configuration */
|
||||||
|
export type ClaudeMemConfig = {
|
||||||
|
workerUrl: string;
|
||||||
|
workerTimeout: number;
|
||||||
|
};
|
||||||
@ -283,5 +283,10 @@
|
|||||||
"apps/macos/.build/**",
|
"apps/macos/.build/**",
|
||||||
"dist/Moltbot.app/**"
|
"dist/Moltbot.app/**"
|
||||||
]
|
]
|
||||||
}
|
},
|
||||||
|
"trustedDependencies": [
|
||||||
|
"@whiskeysockets/baileys",
|
||||||
|
"node-llama-cpp",
|
||||||
|
"protobufjs"
|
||||||
|
]
|
||||||
}
|
}
|
||||||
|
|||||||
101
pnpm-lock.yaml
generated
101
pnpm-lock.yaml
generated
@ -261,6 +261,13 @@ importers:
|
|||||||
node-llama-cpp:
|
node-llama-cpp:
|
||||||
specifier: 3.15.0
|
specifier: 3.15.0
|
||||||
version: 3.15.0(typescript@5.9.3)
|
version: 3.15.0(typescript@5.9.3)
|
||||||
|
optionalDependencies:
|
||||||
|
'@napi-rs/canvas':
|
||||||
|
specifier: ^0.1.88
|
||||||
|
version: 0.1.88
|
||||||
|
node-llama-cpp:
|
||||||
|
specifier: 3.15.0
|
||||||
|
version: 3.15.0(typescript@5.9.3)
|
||||||
|
|
||||||
extensions/bluebubbles: {}
|
extensions/bluebubbles: {}
|
||||||
|
|
||||||
@ -354,11 +361,21 @@ importers:
|
|||||||
|
|
||||||
extensions/mattermost: {}
|
extensions/mattermost: {}
|
||||||
|
|
||||||
|
extensions/memory-claudemem:
|
||||||
|
devDependencies:
|
||||||
|
clawdbot:
|
||||||
|
specifier: workspace:*
|
||||||
|
version: link:../..
|
||||||
|
|
||||||
extensions/memory-core:
|
extensions/memory-core:
|
||||||
devDependencies:
|
devDependencies:
|
||||||
moltbot:
|
moltbot:
|
||||||
specifier: workspace:*
|
specifier: workspace:*
|
||||||
version: link:../..
|
version: link:../..
|
||||||
|
dependencies:
|
||||||
|
clawdbot:
|
||||||
|
specifier: '>=2026.1.24'
|
||||||
|
version: 2026.1.24(@types/express@5.0.6)(audio-decode@2.2.3)(devtools-protocol@0.0.1561482)(typescript@5.9.3)
|
||||||
|
|
||||||
extensions/memory-lancedb:
|
extensions/memory-lancedb:
|
||||||
dependencies:
|
dependencies:
|
||||||
@ -1323,6 +1340,7 @@ packages:
|
|||||||
resolution: {integrity: sha512-aYrIoEG24AC+wILCL57Ius/Y4yU+xFHDPKLvmjzzN4byAjzeIGF0TC86S5RBt4Ji+dxS7yIWV5Q/gE5/fybIFQ==}
|
resolution: {integrity: sha512-aYrIoEG24AC+wILCL57Ius/Y4yU+xFHDPKLvmjzzN4byAjzeIGF0TC86S5RBt4Ji+dxS7yIWV5Q/gE5/fybIFQ==}
|
||||||
engines: {node: '>= 18'}
|
engines: {node: '>= 18'}
|
||||||
cpu: [x64, arm64]
|
cpu: [x64, arm64]
|
||||||
|
cpu: [x64, arm64]
|
||||||
os: [darwin, linux, win32]
|
os: [darwin, linux, win32]
|
||||||
peerDependencies:
|
peerDependencies:
|
||||||
apache-arrow: '>=15.0.0 <=18.1.0'
|
apache-arrow: '>=15.0.0 <=18.1.0'
|
||||||
@ -3219,6 +3237,11 @@ packages:
|
|||||||
engines: {node: '>=22.12.0'}
|
engines: {node: '>=22.12.0'}
|
||||||
hasBin: true
|
hasBin: true
|
||||||
|
|
||||||
|
clawdbot@2026.1.24:
|
||||||
|
resolution: {integrity: sha512-foszbNXzk743kQBx2Nfc2KNlStZyBAVAYLQJ+KaONh009r8oB1a74kQ8wTnKX+SDNaQ9MvaE9tOisVUi+H3F+Q==}
|
||||||
|
engines: {node: '>=22.12.0'}
|
||||||
|
hasBin: true
|
||||||
|
|
||||||
cli-cursor@5.0.0:
|
cli-cursor@5.0.0:
|
||||||
resolution: {integrity: sha512-aCj4O5wKyszjMmDT4tZj93kxyydN/K5zPWSCe6/0AV/AA1pqe5ZBIw0a2ZfPQV7lL5/yb5HsUreJ6UFAF1tEQw==}
|
resolution: {integrity: sha512-aCj4O5wKyszjMmDT4tZj93kxyydN/K5zPWSCe6/0AV/AA1pqe5ZBIw0a2ZfPQV7lL5/yb5HsUreJ6UFAF1tEQw==}
|
||||||
engines: {node: '>=18'}
|
engines: {node: '>=18'}
|
||||||
@ -9176,6 +9199,84 @@ snapshots:
|
|||||||
- typescript
|
- typescript
|
||||||
- utf-8-validate
|
- utf-8-validate
|
||||||
|
|
||||||
|
clawdbot@2026.1.24(@types/express@5.0.6)(audio-decode@2.2.3)(devtools-protocol@0.0.1561482)(typescript@5.9.3):
|
||||||
|
dependencies:
|
||||||
|
'@agentclientprotocol/sdk': 0.13.1(zod@4.3.6)
|
||||||
|
'@aws-sdk/client-bedrock': 3.975.0
|
||||||
|
'@buape/carbon': 0.14.0(hono@4.11.4)
|
||||||
|
'@clack/prompts': 0.11.0
|
||||||
|
'@grammyjs/runner': 2.0.3(grammy@1.39.3)
|
||||||
|
'@grammyjs/transformer-throttler': 1.2.1(grammy@1.39.3)
|
||||||
|
'@homebridge/ciao': 1.3.4
|
||||||
|
'@line/bot-sdk': 10.6.0
|
||||||
|
'@lydell/node-pty': 1.2.0-beta.3
|
||||||
|
'@mariozechner/pi-agent-core': 0.49.3(ws@8.19.0)(zod@4.3.6)
|
||||||
|
'@mariozechner/pi-ai': 0.49.3(ws@8.19.0)(zod@4.3.6)
|
||||||
|
'@mariozechner/pi-coding-agent': 0.49.3(ws@8.19.0)(zod@4.3.6)
|
||||||
|
'@mariozechner/pi-tui': 0.49.3
|
||||||
|
'@mozilla/readability': 0.6.0
|
||||||
|
'@sinclair/typebox': 0.34.47
|
||||||
|
'@slack/bolt': 4.6.0(@types/express@5.0.6)
|
||||||
|
'@slack/web-api': 7.13.0
|
||||||
|
'@whiskeysockets/baileys': 7.0.0-rc.9(audio-decode@2.2.3)(sharp@0.34.5)
|
||||||
|
ajv: 8.17.1
|
||||||
|
body-parser: 2.2.2
|
||||||
|
chalk: 5.6.2
|
||||||
|
chokidar: 5.0.0
|
||||||
|
chromium-bidi: 13.0.1(devtools-protocol@0.0.1561482)
|
||||||
|
cli-highlight: 2.1.11
|
||||||
|
commander: 14.0.2
|
||||||
|
croner: 9.1.0
|
||||||
|
detect-libc: 2.1.2
|
||||||
|
discord-api-types: 0.38.37
|
||||||
|
dotenv: 17.2.3
|
||||||
|
express: 5.2.1
|
||||||
|
file-type: 21.3.0
|
||||||
|
grammy: 1.39.3
|
||||||
|
hono: 4.11.4
|
||||||
|
jiti: 2.6.1
|
||||||
|
json5: 2.2.3
|
||||||
|
jszip: 3.10.1
|
||||||
|
linkedom: 0.18.12
|
||||||
|
long: 5.3.2
|
||||||
|
markdown-it: 14.1.0
|
||||||
|
node-edge-tts: 1.2.9
|
||||||
|
osc-progress: 0.3.0
|
||||||
|
pdfjs-dist: 5.4.530
|
||||||
|
playwright-core: 1.58.0
|
||||||
|
proper-lockfile: 4.1.2
|
||||||
|
qrcode-terminal: 0.12.0
|
||||||
|
sharp: 0.34.5
|
||||||
|
sqlite-vec: 0.1.7-alpha.2
|
||||||
|
tar: 7.5.4
|
||||||
|
tslog: 4.10.2
|
||||||
|
undici: 7.19.0
|
||||||
|
ws: 8.19.0
|
||||||
|
yaml: 2.8.2
|
||||||
|
zod: 4.3.6
|
||||||
|
optionalDependencies:
|
||||||
|
'@napi-rs/canvas': 0.1.88
|
||||||
|
node-llama-cpp: 3.15.0(typescript@5.9.3)
|
||||||
|
transitivePeerDependencies:
|
||||||
|
- '@discordjs/opus'
|
||||||
|
- '@modelcontextprotocol/sdk'
|
||||||
|
- '@types/express'
|
||||||
|
- audio-decode
|
||||||
|
- aws-crt
|
||||||
|
- bufferutil
|
||||||
|
- canvas
|
||||||
|
- debug
|
||||||
|
- devtools-protocol
|
||||||
|
- encoding
|
||||||
|
- ffmpeg-static
|
||||||
|
- jimp
|
||||||
|
- link-preview-js
|
||||||
|
- node-opus
|
||||||
|
- opusscript
|
||||||
|
- supports-color
|
||||||
|
- typescript
|
||||||
|
- utf-8-validate
|
||||||
|
|
||||||
cli-cursor@5.0.0:
|
cli-cursor@5.0.0:
|
||||||
dependencies:
|
dependencies:
|
||||||
restore-cursor: 5.1.0
|
restore-cursor: 5.1.0
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user