claude-smart 0.2.45 → 0.2.46

package/plugin/vendor/reflexio/reflexio/integrations/openclaw/references/HOOK.md

@@ -1,164 +0,0 @@
----
-name: reflexio-federated-plugin
-description: "Automatically capture conversations and inject cross-session context before every response"
-metadata:
-  openclaw:
-    emoji: "🧠"
-    hooks: ["before_prompt_build", "message_sent", "before_compaction", "before_reset", "session_end"]
-    requires:
-      bins: ["reflexio"]
-      env: ["REFLEXIO_USER_ID", "REFLEXIO_AGENT_VERSION"]
----
-
-# Reflexio Federated Plugin
-
-The plugin is the core component that enables automatic conversation capture and cross-session context injection. It is implemented against the **Openclaw Plugin SDK** (`openclaw/plugin-sdk`) and runs on every agent session, persisting data to a local SQLite buffer.
-
-## Plugin SDK Hooks
-
-The plugin registers the following hooks via `api.on(...)` in the Plugin SDK:
-
-### `before_prompt_build` (before each response)
-
-Fires before the agent builds its next response. This is the primary hook — it handles:
-
-1. **First-use setup check** — detects whether the `reflexio` CLI is installed and configured. If setup is needed, injects a setup instruction into the system context.
-2. **Server auto-start** — checks if the local Reflexio server is healthy via a health check; if not, spawns `reflexio services start --only backend` in the background.
-3. **Retry unpublished turns** — publishes any buffered turns from previous sessions that failed to reach the server.
-4. **Search injection** — runs `reflexio search` on the user's message and, if results are found, prepends them as system context before the agent responds. Skips search for trivial/short inputs to reduce noise. Times out after `search.timeout_ms` (default: 5 000 ms) — never blocks the response.
-
-### `message_sent` (each turn)
-
-Fires after the agent sends a response. Buffers the (user message, agent response) pair into local SQLite at `~/.reflexio/sessions.db`. Lightweight local write — no network calls. If the buffer exceeds `publish.batch_size * 2` unpublished turns, triggers an incremental publish to the server.
-
-### `before_compaction` (before transcript compaction)
-
-Fires before Openclaw compacts the transcript. Flushes all unpublished buffered turns to the Reflexio server so no data is lost when the compaction discards history.
-
-### `before_reset` (before transcript wipe)
-
-Fires before Openclaw wipes the transcript (e.g., `/reset`). Same as `before_compaction` — flushes all remaining unpublished turns.
-
-### `session_end` (session end)
-
-Fires when the session ends. Performs a final flush of all remaining buffered turns to the Reflexio server.
-
-## Tool: `reflexio_publish`
-
-In addition to hooks, the plugin registers one agent-invocable tool:
-
-- **`reflexio_publish`** — immediately flushes all buffered conversation turns to the Reflexio server. Useful after user corrections or high-signal moments when automatic session-end flushing would be too late.
-
-> **Single-session limitation:** The `execute` callback in the Plugin SDK does not receive session context, so this tool always targets the most recently active session. Concurrent multi-session use is not supported.
-
-## Prerequisites
-
-1. **`reflexio` CLI on PATH** — `pipx install reflexio-ai` or `pip install --user reflexio-ai`. The plugin shells out to this CLI to start the backend server and publish conversations.
-
-2. **Node.js 18+** — Required to run the plugin.
-
-3. **An LLM provider API key in `~/.reflexio/.env`** — Required for the backend server to extract playbooks and profiles. The first-use setup wizard prompts you to configure this on the first agent session.
-
-## Configuration
-
-All settings are optional and defined in `plugin/openclaw.plugin.json` under the `configSchema`:
-
-### `publish` — Conversation capture and publish behavior
-
-```json
-"publish": {
-  "batch_size": 10,           // Number of turns to buffer before mid-session publish
-  "max_retries": 3,           // Retry count for failed publish attempts
-  "max_content_length": 10000 // Max characters per turn (prevents oversized payloads)
-}
-```
-
-### `search` — Context injection before each response
-
-```json
-"search": {
-  "timeout_ms": 5000,         // Max time to wait for search results
-  "top_k": 5,                 // Number of playbooks to return per search
-  "min_prompt_length": 5      // Skip search for inputs shorter than this
-}
-```
-
-### `server` — Reflexio server health and startup
-
-```json
-"server": {
-  "health_check_timeout_ms": 3000,  // Time limit for health checks
-  "stale_flag_ms": 120000           // Flag file age before retry (2 minutes)
-}
-```
-
-## Security and Privacy
-
-### What the plugin reads
-
-- **Environment variables**: `REFLEXIO_USER_ID` (overrides auto-derived user ID) and `REFLEXIO_AGENT_VERSION` (overrides agent version label). Both are optional.
-- **`~/.openclaw/openclaw.json`**: read by the Openclaw host process to load the plugin; the plugin itself does not read this file directly.
-- **`~/.reflexio/.env`**: read to resolve `REFLEXIO_URL` if the env var is not set in the process environment.
-
-### What the plugin shells out to
-
-The plugin spawns the `reflexio` CLI for:
-- `reflexio services start --only backend` — starts the local server if not running
-- `reflexio search <query>` — fetches context from the local server
-- `reflexio interactions publish --file <payload.json>` — publishes buffered turns
-
-All spawned processes use the binary on your `PATH`. If `reflexio` is not found, the `error` event on the child process is caught, the affected turns are marked for retry, and the plugin continues working without blocking the agent.
-
-### Network destinations
-
-The plugin communicates only with the Reflexio server at the URL resolved from `REFLEXIO_URL` / `~/.reflexio/.env` / default `http://127.0.0.1:8081`. Local-server detection uses exact hostname matching (`127.0.0.1` or `localhost`); only local servers are auto-started.
-
-**The local Reflexio server makes outbound LLM API calls** for profile/playbook extraction. The destination depends on your `~/.reflexio/.env` configuration (OpenAI, Anthropic, Gemini, or a local LLM). For a fully offline setup, configure a local LLM provider (Ollama, LM Studio, vLLM) during first-use setup.
-
-## Buffering and Retry
-
-The plugin uses SQLite to buffer conversations locally:
-
-- **Location**: `~/.reflexio/sessions.db`
-- **Retention**: Buffered turns are kept until successfully published to the server
-- **Retry logic**: On every `before_prompt_build`, the plugin retries any unpublished sessions from previous runs (up to `max_retries`)
-- **Graceful degradation**: If the server is down, the agent works normally and buffers persist
-
-## Lifecycle Summary
-
-| Hook | Trigger | Actions |
-|------|---------|---------|
-| `before_prompt_build` | Before each agent response | Setup check, server auto-start, retry old sessions, search injection |
-| `message_sent` | After each agent response | Buffer turn to SQLite, incremental publish if batch threshold exceeded |
-| `before_compaction` | Before transcript compaction | Flush all unpublished turns |
-| `before_reset` | Before transcript wipe | Flush all unpublished turns |
-| `session_end` | Session ends | Final flush of all remaining turns |
-
-## Implementation
-
-The plugin is implemented in TypeScript in `plugin/`:
-
-- **`index.ts`** — SDK wiring: `definePluginEntry`, hook registration, tool registration
-- **`hook/handler.ts`** — Core logic: `handleBeforePromptBuild`, `handleMessageSent`, `handleSessionFlush`, `handleToolPublish`
-- **`hook/setup.ts`** — First-use setup: CLI detection, LLM provider prompt, server start
-
-Supporting libraries in `plugin/lib/`:
-
-- **`server.ts`** — URL resolution, health check, auto-start
-- **`user-id.ts`** — User identity and agent version resolution from env vars / session key
-- **`sqlite-buffer.ts`** — Turn buffering, retry management
-- **`publish.ts`** — Payload construction, CLI spawn with error handling
-- **`search.ts`** — Search invocation, result formatting, trivial-input filtering
-
-## Debugging
-
-All plugin log lines are prefixed with `[reflexio]` for easy filtering:
-
-```bash
-# Option A: capture stderr to file and tail it
-openclaw chat 2>reflexio-plugin.log
-tail -f reflexio-plugin.log | grep "\[reflexio\]"
-
-# Option B: watch inline
-openclaw chat 2>&1 | grep "\[reflexio\]"
-```

package/plugin/vendor/reflexio/reflexio/integrations/openclaw/scripts/install.sh

@@ -1,36 +0,0 @@
-#!/usr/bin/env bash
-# reflexio-federated install.sh — plugin installation.
-set -euo pipefail
-
-PLUGIN_DIR="$(cd "$(dirname "$0")/../plugin" && pwd)"
-OPENCLAW_HOME="${OPENCLAW_HOME:-$HOME/.openclaw}"
-
-die() { echo "error: $*" >&2; exit 1; }
-info() { echo "==> $*"; }
-
-# 1. Prereq checks
-info "Checking prerequisites..."
-command -v openclaw >/dev/null || die "openclaw CLI required but not found on PATH"
-command -v node >/dev/null     || die "node required but not found on PATH"
-
-# 2. Install the plugin
-info "Installing plugin..."
-openclaw plugins uninstall --force reflexio-federated 2>/dev/null || true
-rm -rf "$OPENCLAW_HOME/extensions/reflexio-federated"
-openclaw plugins install "$PLUGIN_DIR"
-openclaw plugins enable reflexio-federated 2>/dev/null || true
-
-# 3. Restart gateway
-info "Restarting openclaw gateway..."
-openclaw gateway restart
-
-# 4. Verify
-info "Verification:"
-if openclaw plugins inspect reflexio-federated 2>/dev/null | grep -q "Status: loaded"; then
-  info "  ✓ plugin registered and loaded"
-else
-  die "Plugin did not reach 'loaded' status. Run 'openclaw plugins inspect reflexio-federated' to debug."
-fi
-
-info "Installation complete."
-info "Reflexio setup (CLI install, storage config, server start) happens automatically on first agent session."

package/plugin/vendor/reflexio/reflexio/integrations/openclaw/scripts/uninstall.sh

@@ -1,35 +0,0 @@
-#!/usr/bin/env bash
-# reflexio-federated uninstall.sh — reverses install.sh.
-# Leaves ~/.reflexio/ user data intact unless --purge is passed.
-set -euo pipefail
-
-OPENCLAW_HOME="${OPENCLAW_HOME:-$HOME/.openclaw}"
-PURGE_DATA="${1:-}"
-
-info() { echo "==> $*"; }
-
-info "Disabling plugin..."
-openclaw plugins disable reflexio-federated 2>/dev/null || echo "(already disabled)"
-
-info "Uninstalling plugin..."
-openclaw plugins uninstall --force reflexio-federated 2>/dev/null || echo "(already uninstalled)"
-rm -rf "$OPENCLAW_HOME/extensions/reflexio-federated"
-
-info "Cleaning up state files..."
-rm -f "$HOME/.reflexio/sessions.db"
-rm -f "$HOME/.reflexio/logs/.server-starting"
-
-# Remove setup markers
-find "$HOME/.reflexio/" -name ".setup_complete_*" -delete 2>/dev/null || true
-
-if [[ "$PURGE_DATA" == "--purge" ]]; then
-  info "Purging ~/.reflexio/ user data per --purge flag..."
-  rm -rf "$HOME/.reflexio"
-else
-  info "User data at ~/.reflexio/ preserved. Use --purge to delete it too."
-fi
-
-info "Restarting openclaw gateway..."
-openclaw gateway restart || echo "warning: gateway restart failed — you may need to restart manually"
-
-info "Uninstall complete."

package/plugin/vendor/reflexio/reflexio/integrations/openclaw/tests/publish.test.ts

@@ -1,27 +0,0 @@
-import { describe, it, expect } from "vitest";
-import { buildPayload } from "../plugin/lib/publish.ts";
-import type { Turn } from "../plugin/lib/sqlite-buffer.ts";
-
-describe("buildPayload", () => {
-  it("builds correct JSON structure", () => {
-    const turns: Turn[] = [
-      { id: 1, session_id: "s1", role: "user", content: "hello", timestamp: "2026-01-01T00:00:00Z", published: 0, retry_count: 0 },
-      { id: 2, session_id: "s1", role: "assistant", content: "hi", timestamp: "2026-01-01T00:00:01Z", published: 0, retry_count: 0 },
-    ];
-    const payload = buildPayload(turns, "user1", "openclaw-agent", "sess1");
-    const parsed = JSON.parse(payload);
-    expect(parsed.user_id).toBe("user1");
-    expect(parsed.source).toBe("openclaw");
-    expect(parsed.agent_version).toBe("openclaw-agent");
-    expect(parsed.session_id).toBe("sess1");
-    expect(parsed.interactions).toHaveLength(2);
-    expect(parsed.interactions[0].role).toBe("user");
-    expect(parsed.interactions[0].content).toBe("hello");
-  });
-
-  it("returns empty interactions for empty turns", () => {
-    const payload = buildPayload([], "user1", "openclaw-agent", "sess1");
-    const parsed = JSON.parse(payload);
-    expect(parsed.interactions).toHaveLength(0);
-  });
-});

package/plugin/vendor/reflexio/reflexio/integrations/openclaw/tests/search.test.ts

@@ -1,31 +0,0 @@
-import { describe, it, expect } from "vitest";
-import { shouldSkipSearch, formatSearchContext } from "../plugin/lib/search.ts";
-
-describe("shouldSkipSearch", () => {
-  it("skips short messages", () => {
-    expect(shouldSkipSearch("hi", 5)).toBe(true);
-  });
-
-  it("skips trivial responses", () => {
-    expect(shouldSkipSearch("yes", 5)).toBe(true);
-    expect(shouldSkipSearch("ok", 5)).toBe(true);
-    expect(shouldSkipSearch("thanks", 5)).toBe(true);
-    expect(shouldSkipSearch("Sure", 5)).toBe(true);
-  });
-
-  it("does not skip real messages", () => {
-    expect(shouldSkipSearch("Write a Python function to sort a list", 5)).toBe(false);
-  });
-});
-
-describe("formatSearchContext", () => {
-  it("returns null for empty results", () => {
-    expect(formatSearchContext("")).toBeNull();
-    expect(formatSearchContext("Found 0 profiles, 0 playbooks")).toBeNull();
-  });
-
-  it("returns trimmed content for real results", () => {
-    const result = formatSearchContext("## Playbooks\n- Use type hints");
-    expect(result).toBe("## Playbooks\n- Use type hints");
-  });
-});

package/plugin/vendor/reflexio/reflexio/integrations/openclaw/tests/server.test.ts

@@ -1,42 +0,0 @@
-import { describe, it, expect, beforeEach, afterEach } from "vitest";
-import { resolveServerUrl, isLocalServer } from "../plugin/lib/server.ts";
-
-describe("resolveServerUrl", () => {
-  const originalEnv = process.env;
-
-  beforeEach(() => {
-    process.env = { ...originalEnv };
-  });
-
-  afterEach(() => {
-    process.env = originalEnv;
-  });
-
-  it("returns REFLEXIO_URL env var when set", () => {
-    process.env.REFLEXIO_URL = "https://custom.server:9090";
-    expect(resolveServerUrl()).toBe("https://custom.server:9090");
-  });
-
-  it("returns default when no env var and no .env file", () => {
-    delete process.env.REFLEXIO_URL;
-    expect(resolveServerUrl()).toBe("http://127.0.0.1:8081");
-  });
-});
-
-describe("isLocalServer", () => {
-  it("returns true for localhost", () => {
-    expect(isLocalServer("http://localhost:8081")).toBe(true);
-  });
-
-  it("returns true for 127.0.0.1", () => {
-    expect(isLocalServer("http://127.0.0.1:8081")).toBe(true);
-  });
-
-  it("returns false for remote URL", () => {
-    expect(isLocalServer("https://reflexio.ai:8081")).toBe(false);
-  });
-
-  it("returns false for localhost.evil.com", () => {
-    expect(isLocalServer("https://localhost.evil.com")).toBe(false);
-  });
-});

package/plugin/vendor/reflexio/reflexio/integrations/openclaw/tests/setup.test.ts

@@ -1,49 +0,0 @@
-import { describe, it, expect, beforeEach, afterEach } from "vitest";
-import * as fs from "node:fs";
-import * as os from "node:os";
-import * as path from "node:path";
-import {
-  isSetupComplete,
-  markSetupComplete,
-  checkReflexioInstalled,
-  checkReflexioConfigured,
-} from "../plugin/hook/setup.ts";
-
-describe("isSetupComplete", () => {
-  let tmpDir: string;
-
-  beforeEach(() => {
-    tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "reflexio-setup-test-"));
-  });
-
-  afterEach(() => {
-    fs.rmSync(tmpDir, { recursive: true, force: true });
-  });
-
-  it("returns false when marker does not exist", () => {
-    expect(isSetupComplete(tmpDir, "main")).toBe(false);
-  });
-
-  it("returns true after markSetupComplete", () => {
-    markSetupComplete(tmpDir, "main");
-    expect(isSetupComplete(tmpDir, "main")).toBe(true);
-  });
-
-  it("is per-agent", () => {
-    markSetupComplete(tmpDir, "main");
-    expect(isSetupComplete(tmpDir, "work")).toBe(false);
-  });
-});
-
-describe("checkReflexioInstalled", () => {
-  it("returns a boolean", async () => {
-    const result = await checkReflexioInstalled();
-    expect(typeof result).toBe("boolean");
-  });
-});
-
-describe("checkReflexioConfigured", () => {
-  it("returns false for nonexistent directory", () => {
-    expect(checkReflexioConfigured("/tmp/nonexistent-reflexio-dir-" + Date.now())).toBe(false);
-  });
-});

package/plugin/vendor/reflexio/reflexio/integrations/openclaw/tests/sqlite-buffer.test.ts

@@ -1,91 +0,0 @@
-import { describe, it, expect, beforeEach, afterEach } from "vitest";
-import * as fs from "node:fs";
-import * as os from "node:os";
-import * as path from "node:path";
-import {
-  openDb,
-  insertTurn,
-  getUnpublished,
-  markInFlight,
-  markPublished,
-  markFailed,
-  smartTruncate,
-  cleanupOldTurns,
-} from "../plugin/lib/sqlite-buffer.ts";
-import type Database from "better-sqlite3";
-
-describe("smartTruncate", () => {
-  it("returns content unchanged when under limit", () => {
-    expect(smartTruncate("hello", 100)).toBe("hello");
-  });
-
-  it("truncates with head + marker + tail within maxLength", () => {
-    const content = "a".repeat(200);
-    const result = smartTruncate(content, 100);
-    expect(result.length).toBeLessThanOrEqual(100);
-    expect(result).toContain("[...truncated");
-  });
-
-  it("returns empty string for empty input", () => {
-    expect(smartTruncate("", 100)).toBe("");
-  });
-});
-
-describe("sqlite-buffer", () => {
-  let db: Database.Database;
-  let tmpDir: string;
-
-  beforeEach(() => {
-    tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "reflexio-test-"));
-    const dbPath = path.join(tmpDir, "sessions.db");
-    db = openDb(dbPath);
-  });
-
-  afterEach(() => {
-    db.close();
-    fs.rmSync(tmpDir, { recursive: true, force: true });
-  });
-
-  it("inserts and retrieves turns", () => {
-    insertTurn(db, "sess1", "user", "hello");
-    insertTurn(db, "sess1", "assistant", "hi there");
-    const turns = getUnpublished(db, "sess1", 3, 100);
-    expect(turns).toHaveLength(2);
-    expect(turns[0].role).toBe("user");
-    expect(turns[1].role).toBe("assistant");
-  });
-
-  it("marks turns as in-flight then published", () => {
-    insertTurn(db, "sess1", "user", "hello");
-    const turns = getUnpublished(db, "sess1", 3, 100);
-    const maxId = turns[turns.length - 1].id;
-    markInFlight(db, "sess1", maxId, 3);
-    expect(getUnpublished(db, "sess1", 3, 100)).toHaveLength(0);
-    markPublished(db, "sess1", maxId);
-    expect(getUnpublished(db, "sess1", 3, 100)).toHaveLength(0);
-  });
-
-  it("increments retry count on failure", () => {
-    insertTurn(db, "sess1", "user", "hello");
-    const turns = getUnpublished(db, "sess1", 3, 100);
-    const id = turns[0].id;
-    markInFlight(db, "sess1", id, 3);
-    markFailed(db, "sess1", id);
-    const after = getUnpublished(db, "sess1", 3, 100);
-    expect(after).toHaveLength(1);
-    // After MAX_RETRIES failures, turn should be excluded
-    markInFlight(db, "sess1", id, 3);
-    markFailed(db, "sess1", id);
-    markInFlight(db, "sess1", id, 3);
-    markFailed(db, "sess1", id);
-    expect(getUnpublished(db, "sess1", 3, 100)).toHaveLength(0);
-  });
-
-  it("respects max interactions limit", () => {
-    for (let i = 0; i < 10; i++) {
-      insertTurn(db, "sess1", "user", `msg ${i}`);
-    }
-    const turns = getUnpublished(db, "sess1", 3, 5);
-    expect(turns).toHaveLength(5);
-  });
-});

package/plugin/vendor/reflexio/reflexio/integrations/openclaw/tests/user-id.test.ts

@@ -1,50 +0,0 @@
-import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
-import { resolveUserId, stripJsonComments, _resetCache } from "../plugin/lib/user-id.ts";
-
-describe("stripJsonComments", () => {
-  it("strips line comments", () => {
-    expect(stripJsonComments('{ "key": "val" } // comment')).toBe('{ "key": "val" } ');
-  });
-
-  it("preserves URLs in quoted strings", () => {
-    expect(stripJsonComments('{ "url": "http://example.com" }')).toBe(
-      '{ "url": "http://example.com" }',
-    );
-  });
-
-  it("strips comment after quoted string containing //", () => {
-    expect(stripJsonComments('{ "url": "http://x.com" } // note')).toBe(
-      '{ "url": "http://x.com" } ',
-    );
-  });
-});
-
-describe("resolveUserId", () => {
-  const originalEnv = process.env;
-
-  beforeEach(() => {
-    process.env = { ...originalEnv };
-    _resetCache();
-  });
-
-  afterEach(() => {
-    process.env = originalEnv;
-  });
-
-  it("returns REFLEXIO_USER_ID env var if set", () => {
-    process.env.REFLEXIO_USER_ID = "custom-user";
-    expect(resolveUserId("agent:main:abc123")).toBe("custom-user");
-  });
-
-  it("extracts agentId from session key format agent:<id>:<key>", () => {
-    expect(resolveUserId("agent:work:session789")).toBe("work");
-  });
-
-  it("falls back to 'openclaw' when no session key or env", () => {
-    expect(resolveUserId("")).toBe("openclaw");
-  });
-
-  it("falls back to 'openclaw' for non-agent session key format", () => {
-    expect(resolveUserId("random-session-key")).toBe("openclaw");
-  });
-});

package/plugin/vendor/reflexio/reflexio/integrations/openclaw/vitest.config.ts

@@ -1,13 +0,0 @@
-import { defineConfig } from "vitest/config";
-
-export default defineConfig({
-  test: {
-    include: ["tests/**/*.test.ts"],
-    env: {
-      // Point HOME to a nonexistent path so tests cannot accidentally read
-      // ~/.reflexio/.env or other real user config files. Tests that need
-      // specific home-dir content must set HOME themselves.
-      HOME: "/nonexistent-test-home",
-    },
-  },
-});