@baselayer-id/baselayer-openclaw 0.5.2

package/README.md

@@ -0,0 +1,56 @@
+# baselayer-openclaw
+
+OpenClaw plugin that captures your AI conversations and ingests them into your [BaseLayer](https://baselayer.id) knowledge vault.
+
+## Install
+
+```bash
+openclaw plugins install @baselayer-id/baselayer-openclaw
+```
+
+## Configure
+
+Add your credentials to your OpenClaw config (`~/.openclaw/openclaw.json`):
+
+```json
+{
+  "plugins": {
+    "entries": {
+      "baselayer-openclaw": {
+        "enabled": true,
+        "config": {
+          "apiKey": "bl_your_api_key_here"
+        }
+      }
+    }
+  }
+}
+```
+
+**Where to get your API Key:**
+
+- **API Key** — [baselayer.id/profile](https://baselayer.id/profile) (starts with `bl_`)
+
+## How it works
+
+After each conversation turn, the plugin:
+
+1. Captures the user message and assistant response
+2. Sends the payload to your BaseLayer vault
+
+Conversations accumulate under a single session ID, so an ongoing chat appears as one conversation in your vault rather than scattered fragments.
+
+## Requirements
+
+- [BaseLayer Desktop](https://baselayer.id/download) installed and signed in
+- An active BaseLayer account with API key
+
+## Links
+
+- [BaseLayer](https://baselayer.id)
+- [Documentation](https://docs.baselayer.id)
+- [Chrome Extension](https://chromewebstore.google.com/detail/baselayer-sovereign-memory/bhpchdhfjgecpnphpmpgmkeajefnhmdn)
+
+## License
+
+MIT

package/index.ts

@@ -0,0 +1,356 @@
+/**
+ * BaseLayer OpenClaw Plugin
+ *
+ * Captures conversation turns from your OpenClaw agent and ingests them
+ * into your BaseLayer vault.
+ *
+ * @version 0.6.0
+ * @see https://baselayer.id/credentials
+ */
+
+import { appendFileSync } from 'node:fs';
+
+// ============================================================================
+// Debug Logging — writes to stdout AND a dedicated log file
+// ============================================================================
+
+const LOG_FILE = `${process.env.HOME}/.openclaw/logs/baselayer-plugin.log`;
+
+function pluginLog(level: string, msg: string) {
+  const ts = new Date().toISOString();
+  const line = `${ts} [baselayer:${level}] ${msg}`;
+  console.log(line);
+  try { appendFileSync(LOG_FILE, line + '\n'); } catch {}
+}
+
+// ============================================================================
+// Types
+// ============================================================================
+
+interface PluginConfig {
+  apiKey: string;
+  realm?: 'local' | 'dev' | 'prod';
+}
+
+interface ConversationTurn {
+  role: 'user' | 'assistant';
+  content: string;
+  timestamp: number;
+}
+
+interface IngestMessage {
+  role: 'user' | 'assistant';
+  content: string;
+  timestamp: number;
+}
+
+interface IngestPayload {
+  schema_version: number;
+  conversation_id: string;
+  provider: string;
+  new_messages: IngestMessage[];
+  metadata: {
+    title: string;
+    url: string;
+    message_count: number;
+  };
+}
+
+// ============================================================================
+// Session Filtering — skip automated/non-human flows
+// ============================================================================
+
+/**
+ * Returns true if this session should be SKIPPED (not captured).
+ * We only want human-initiated conversations.
+ *
+ * Excluded:
+ *  - Sub-agent sessions (sessionKind === 'isolated' or session key matches agent:*:subagent:*)
+ *  - Cron/heartbeat jobs (source === 'cron' or 'heartbeat')
+ *  - System events without a real channel
+ */
+function shouldSkipSession(event: any, ctx: any): { skip: boolean; reason: string } {
+  // Sub-agent sessions
+  if (event?.sessionKind === 'isolated') {
+    return { skip: true, reason: 'isolated sub-agent session' };
+  }
+  const sessionKey = ctx?.sessionKey || event?.sessionKey || '';
+  if (sessionKey.includes(':subagent:')) {
+    return { skip: true, reason: `sub-agent session: ${sessionKey}` };
+  }
+
+  // Cron and heartbeat
+  const source = event?.source || ctx?.source || '';
+  if (source === 'cron' || source === 'heartbeat') {
+    return { skip: true, reason: `automated source: ${source}` };
+  }
+  if (sessionKey.includes(':cron:') || sessionKey.includes(':heartbeat:')) {
+    return { skip: true, reason: `automated session key: ${sessionKey}` };
+  }
+
+  return { skip: false, reason: 'human-initiated' };
+}
+
+// ============================================================================
+// Ingest
+// ============================================================================
+
+async function flush(
+  config: PluginConfig,
+  turns: ConversationTurn[],
+  title: string,
+  conversationId: string,
+): Promise<void> {
+  if (turns.length === 0) return;
+
+  let endpoint = 'https://api.baselayer.id/api/ingest/event';
+  if (config.realm === 'local') {
+    endpoint = 'http://localhost:8080/api/ingest/event';
+  } else if (config.realm === 'dev') {
+    endpoint = 'https://api-dev.baselayer.id/api/ingest/event';
+  }
+
+  pluginLog('info', `Flushing ${turns.length} turns to ${endpoint} (convId=${conversationId})`);
+
+  const plainMessages: IngestMessage[] = turns.map((turn) => ({
+    role: turn.role,
+    content: turn.content,
+    timestamp: turn.timestamp,
+  }));
+
+  const payload: IngestPayload = {
+    schema_version: 2,
+    conversation_id: conversationId,
+    provider: 'openclaw',
+    new_messages: plainMessages,
+    metadata: {
+      title: title || 'OpenClaw Conversation',
+      url: 'openclaw://conversation',
+      message_count: plainMessages.length,
+    },
+  };
+
+  pluginLog('debug', `Payload: convId=${conversationId}, msgs=${plainMessages.length}, title="${title}"`);
+
+  try {
+    const response = await fetch(endpoint, {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        Authorization: `Bearer ${config.apiKey}`,
+      },
+      body: JSON.stringify(payload),
+    });
+
+    const body = await response.text().catch(() => '');
+
+    if (response.status === 200 || response.status === 202) {
+      let id = 'unknown';
+      try { id = JSON.parse(body)?.id || body.slice(0, 80); } catch {}
+      pluginLog('info', `✅ Captured ${plainMessages.length} messages (id=${id}, status=${response.status})`);
+    } else if (response.status === 401) {
+      pluginLog('error', `❌ API key rejected (401). Check https://baselayer.id/profile`);
+    } else {
+      pluginLog('error', `❌ Ingest failed: HTTP ${response.status} — ${body.slice(0, 500)}`);
+    }
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    pluginLog('error', `❌ Fetch error: ${msg}`);
+  }
+}
+
+// ============================================================================
+// BaseLayer MCP Helper
+// ============================================================================
+
+async function callBaseLayerMCP(tool: string, args: Record<string, any>): Promise<string | null> {
+  try {
+    const resp = await fetch('http://localhost:44044', {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({
+        jsonrpc: '2.0',
+        method: 'tools/call',
+        params: { name: tool, arguments: args },
+        id: `plugin-${Date.now()}`,
+      }),
+      signal: AbortSignal.timeout(5000),
+    });
+    const data = await resp.json() as any;
+    return data?.result?.content?.[0]?.text ?? null;
+  } catch {
+    return null;
+  }
+}
+
+// ============================================================================
+// Plugin
+// ============================================================================
+
+export default function register(api: any) {
+  const config = (api.pluginConfig ?? {}) as PluginConfig;
+
+  // ── Validate config ──────────────────────────────────────────────────
+  if (!config?.apiKey) {
+    pluginLog('error', 'Missing apiKey. Get one at https://baselayer.id/profile');
+    return;
+  }
+  if (!config?.apiKey.startsWith('bl_')) {
+    pluginLog('error', 'apiKey should start with "bl_". Check https://baselayer.id/profile');
+    return;
+  }
+
+  pluginLog('info', `Plugin active. apiKey=bl_***...`);
+
+  // ── Context Injection ─────────────────────────────────────────────────
+  let turnCount = 0;
+  const CONTEXT_REFRESH_INTERVAL = 10;
+
+  api.on('before_prompt_build', async (event: any) => {
+    turnCount++;
+    if (turnCount > 1 && turnCount % CONTEXT_REFRESH_INTERVAL !== 0) return;
+
+    const recentContext = await callBaseLayerMCP('recent', {
+      hours_back: 24,
+      max_raw: 3,
+      max_dreamed: 10,
+      include_raw: true,
+    });
+
+    if (!recentContext) return;
+
+    const contextBlock = [
+      '## BaseLayer Memory Context (auto-injected)',
+      'You have access to a sovereign knowledge vault via MCP at localhost:44044.',
+      'Use `mcporter call baselayer.memory_search query="NAME"` to search before answering.',
+      'Use `mcporter call baselayer.record_memory content="..."` to store new knowledge.',
+      '',
+      recentContext,
+    ].join('\n');
+
+    return { prependContext: contextBlock };
+  });
+
+  // ── State ────────────────────────────────────────────────────────────
+  let pendingUser: ConversationTurn | null = null;
+  let pendingAssistant: ConversationTurn | null = null;
+  let activeChannelId: string | null = null;
+  let activeChatId: string | null = null;
+
+  // ── Hooks ────────────────────────────────────────────────────────────
+
+  api.on('message_received', async (event: any, ctx: any) => {
+    pluginLog('debug', `>>> message_received fired. content=${(event?.content || '').slice(0, 80)}...`);
+    pluginLog('debug', `    ctx.channelId=${ctx?.channelId}, event.from=${event?.from}, ctx.sessionKey=${ctx?.sessionKey}`);
+    pluginLog('debug', `    event keys: ${Object.keys(event || {}).join(', ')}`);
+    pluginLog('debug', `    ctx keys: ${Object.keys(ctx || {}).join(', ')}`);
+
+    // Check session filter
+    const filter = shouldSkipSession(event, ctx);
+    if (filter.skip) {
+      pluginLog('info', `⏭️ Skipping message_received: ${filter.reason}`);
+      return;
+    }
+
+    if (!event.content) {
+      pluginLog('debug', '    No content in event, skipping');
+      return;
+    }
+
+    if (ctx?.channelId) activeChannelId = ctx.channelId;
+    if (event.from) activeChatId = event.from;
+
+    pendingUser = { role: 'user', content: event.content, timestamp: Date.now() };
+    pluginLog('info', `📩 User turn captured (channel=${activeChannelId}, chat=${activeChatId})`);
+  });
+
+  api.on('llm_output', async (event: any, ctx: any) => {
+    pluginLog('debug', `>>> llm_output fired. assistantTexts count=${event?.assistantTexts?.length || 0}`);
+
+    // Check session filter
+    const filter = shouldSkipSession(event, ctx);
+    if (filter.skip) {
+      pluginLog('info', `⏭️ Skipping llm_output: ${filter.reason}`);
+      return;
+    }
+
+    const texts: string[] = event?.assistantTexts || [];
+    const combined = texts.join('\n\n').trim();
+    if (!combined) {
+      pluginLog('debug', '    No assistant text in llm_output');
+      return;
+    }
+    pendingAssistant = { role: 'assistant', content: combined, timestamp: Date.now() };
+    pluginLog('info', `🤖 Assistant turn captured (${combined.length} chars)`);
+  });
+
+  api.on('agent_end', async (event: any, ctx: any) => {
+    pluginLog('debug', `>>> agent_end fired. messages count=${event?.messages?.length || 0}`);
+    pluginLog('debug', `    ctx keys: ${Object.keys(ctx || {}).join(', ')}`);
+
+    // Check session filter
+    const filter = shouldSkipSession(event, ctx);
+    if (filter.skip) {
+      pluginLog('info', `⏭️ Skipping agent_end: ${filter.reason}`);
+      pendingUser = null;
+      pendingAssistant = null;
+      return;
+    }
+
+    // Brief yield for llm_output to complete
+    await new Promise((r) => setTimeout(r, 200));
+
+    // Fallback: extract assistant text from agent_end messages if llm_output missed
+    if (!pendingAssistant && event?.messages?.length) {
+      const last = [...event.messages].reverse().find((m: any) => m.role === 'assistant');
+      if (last) {
+        const text =
+          typeof last.content === 'string'
+            ? last.content
+            : Array.isArray(last.content)
+              ? last.content
+                  .filter((c: any) => c.type === 'text')
+                  .map((c: any) => c.text)
+                  .join('\n\n')
+              : '';
+        if (text.trim()) {
+          pendingAssistant = { role: 'assistant', content: text.trim(), timestamp: Date.now() };
+          pluginLog('debug', `    Extracted assistant text from agent_end messages (${text.length} chars)`);
+        }
+      }
+    }
+
+    const turns: ConversationTurn[] = [];
+    if (pendingUser) { turns.push(pendingUser); pendingUser = null; }
+    if (pendingAssistant) { turns.push(pendingAssistant); pendingAssistant = null; }
+
+    if (turns.length === 0) {
+      pluginLog('debug', '    No turns to flush');
+      return;
+    }
+
+    // Build stable conversation ID from channel context.
+    // Plaintext format (e.g., "discord-1475712146506776628" or "telegram-6502483662")
+    const conversationId = (activeChannelId && activeChatId)
+      ? `${activeChannelId}-${activeChatId}`
+      : 'main';
+
+    // Build title from channel/provider name (not first message).
+    // Format: "Discord #baselayer-dev" or "Telegram James" or "Google Chat project-xyz"
+    const providerName = activeChannelId
+      ? activeChannelId.charAt(0).toUpperCase() + activeChannelId.slice(1)
+      : 'OpenClaw';
+    const flushTitle = activeChatId
+      ? `${providerName} ${activeChatId.split(':').slice(-1)[0]}`
+      : `${providerName} Conversation`;
+
+    pluginLog('info', `🚀 Flushing ${turns.length} turns (convId=${conversationId}, channel=${activeChannelId})`);
+
+    try {
+      await flush(config, turns, flushTitle, conversationId);
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      pluginLog('error', `Flush error: ${msg}`);
+    }
+  });
+}

package/openclaw.plugin.json

@@ -0,0 +1,34 @@
+{
+  "id": "baselayer-openclaw",
+  "name": "BaseLayer OpenClaw",
+  "description": "Captures conversations and ingests them into your BaseLayer vault",
+  "version": "0.5.0",
+  "configSchema": {
+    "type": "object",
+    "required": [
+      "apiKey"
+    ],
+    "additionalProperties": false,
+    "properties": {
+      "apiKey": {
+        "type": "string",
+        "description": "BaseLayer API key (starts with bl_)"
+      },
+      "ingestEndpoint": {
+        "type": "string",
+        "description": "Override ingest endpoint (advanced, defaults to https://api.baselayer.id/ingest)"
+      }
+    }
+  },
+  "uiHints": {
+    "apiKey": {
+      "label": "API Key",
+      "placeholder": "bl_...",
+      "sensitive": true
+    },
+    "ingestEndpoint": {
+      "label": "Ingest Endpoint (Advanced)",
+      "placeholder": "https://api.baselayer.id/ingest"
+    }
+  }
+}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@baselayer-id/baselayer-openclaw",
+  "version": "0.5.2",
+  "description": "OpenClaw plugin for BaseLayer — captures AI conversations into your knowledge vault",
+  "main": "index.ts",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/baselayer-id/baselayer-openclaw.git"
+  },
+  "homepage": "https://baselayer.id",
+  "keywords": [
+    "openclaw",
+    "plugin",
+    "baselayer",
+    "ai",
+    "memory",
+    "mcp",
+    "knowledge-graph"
+  ],
+  "files": [
+    "index.ts",
+    "openclaw.plugin.json",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0"
+  }
+}