@keyoku/openclaw 1.0.0

package/dist/service.js

@@ -0,0 +1,133 @@
+/**
+ * Keyoku binary lifecycle management.
+ * Starts/stops the Keyoku Go binary as a child process.
+ */
+import { spawn } from 'node:child_process';
+import { existsSync, mkdirSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { randomBytes } from 'node:crypto';
+let keyokuProcess = null;
+/**
+ * Check if Keyoku is already running by attempting a health check.
+ */
+async function isKeyokuRunning(url) {
+    try {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), 2000);
+        const res = await fetch(`${url}/health`, { signal: controller.signal });
+        clearTimeout(timer);
+        return res.ok;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Wait for Keyoku to become healthy, polling every interval up to a timeout.
+ */
+async function waitForHealthy(url, timeoutMs = 5000, intervalMs = 500) {
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        if (await isKeyokuRunning(url))
+            return true;
+        await new Promise((r) => setTimeout(r, intervalMs));
+    }
+    return false;
+}
+/**
+ * Find keyoku binary on disk or PATH.
+ */
+function findKeyokuBinary() {
+    const home = process.env.HOME ?? '';
+    const candidates = [
+        resolve(home, '.keyoku', 'bin', 'keyoku'),
+        resolve(home, '.local', 'bin', 'keyoku'),
+    ];
+    for (const candidate of candidates) {
+        if (existsSync(candidate))
+            return candidate;
+    }
+    // Fall back to PATH resolution
+    return 'keyoku';
+}
+/**
+ * Ensure the Keyoku data directory exists and return the DB path.
+ */
+function ensureDataDir() {
+    const dir = resolve(process.env.HOME ?? '', '.keyoku', 'data');
+    mkdirSync(dir, { recursive: true });
+    return resolve(dir, 'keyoku.db');
+}
+export function registerService(api, keyokuUrl) {
+    api.registerService({
+        id: 'keyoku-engine',
+        async start() {
+            // Skip if already running
+            if (await isKeyokuRunning(keyokuUrl)) {
+                api.logger.info('keyoku: Keyoku already running');
+                return;
+            }
+            const binary = findKeyokuBinary();
+            if (!binary) {
+                api.logger.warn('keyoku: Keyoku binary not found — memory features require Keyoku to be running');
+                return;
+            }
+            // Prepare environment
+            const env = { ...process.env };
+            if (!env.KEYOKU_SESSION_TOKEN) {
+                env.KEYOKU_SESSION_TOKEN = randomBytes(16).toString('hex');
+                api.logger.info('keyoku: Generated session token');
+            }
+            if (!env.KEYOKU_DB_PATH) {
+                env.KEYOKU_DB_PATH = ensureDataDir();
+                api.logger.info(`keyoku: Using database at ${env.KEYOKU_DB_PATH}`);
+            }
+            try {
+                keyokuProcess = spawn(binary, [], {
+                    stdio: ['ignore', 'pipe', 'pipe'],
+                    detached: false,
+                    env,
+                });
+                // Pipe stdout/stderr to logger
+                keyokuProcess.stdout?.on('data', (data) => {
+                    const line = data.toString().trim();
+                    if (line)
+                        api.logger.info(`keyoku: ${line}`);
+                });
+                keyokuProcess.stderr?.on('data', (data) => {
+                    const line = data.toString().trim();
+                    if (line)
+                        api.logger.warn(`keyoku: ${line}`);
+                });
+                keyokuProcess.on('error', (err) => {
+                    api.logger.warn(`keyoku: Failed to start Keyoku: ${err.message}`);
+                    keyokuProcess = null;
+                });
+                keyokuProcess.on('exit', (code) => {
+                    if (code !== 0 && code !== null) {
+                        api.logger.warn(`keyoku: Keyoku exited with code ${code}`);
+                    }
+                    keyokuProcess = null;
+                });
+                // Wait for health check with retry
+                if (await waitForHealthy(keyokuUrl)) {
+                    api.logger.info('keyoku: Keyoku started successfully');
+                }
+                else {
+                    api.logger.warn('keyoku: Keyoku started but health check failed — it may still be initializing');
+                }
+            }
+            catch (err) {
+                api.logger.warn(`keyoku: Could not start Keyoku: ${String(err)}`);
+            }
+        },
+        stop() {
+            if (keyokuProcess) {
+                keyokuProcess.kill('SIGTERM');
+                keyokuProcess = null;
+                api.logger.info('keyoku: Keyoku stopped');
+            }
+        },
+    });
+}
+//# sourceMappingURL=service.js.map

package/dist/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"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"}

package/dist/tools.d.ts

@@ -0,0 +1,11 @@
+/**
+ * OpenClaw tool registrations for Keyoku memory operations.
+ * Registers 7 tools:
+ *   memory_search, memory_get (OpenClaw standard — replaces built-in file-based memory)
+ *   memory_store, memory_forget, memory_stats (Keyoku memory management)
+ *   schedule_create, schedule_list (Keyoku scheduling)
+ */
+import type { KeyokuClient } from '@keyoku/memory';
+import type { PluginApi } from './types.js';
+export declare function registerTools(api: PluginApi, client: KeyokuClient, entityId: string, agentId: string): void;
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,wBAAgB,aAAa,CAAC,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAkO3G"}

package/dist/tools.js

@@ -0,0 +1,188 @@
+/**
+ * OpenClaw tool registrations for Keyoku memory operations.
+ * Registers 7 tools:
+ *   memory_search, memory_get (OpenClaw standard — replaces built-in file-based memory)
+ *   memory_store, memory_forget, memory_stats (Keyoku memory management)
+ *   schedule_create, schedule_list (Keyoku scheduling)
+ */
+import { Type } from '@sinclair/typebox';
+export function registerTools(api, client, entityId, agentId) {
+    // memory_search — OpenClaw-standard search tool (replaces memory-core's built-in)
+    api.registerTool({
+        name: 'memory_search',
+        label: 'Memory Search',
+        description: 'Search through memories for relevant information. Returns semantically similar memories ranked by relevance.',
+        parameters: Type.Object({
+            query: Type.String({ description: 'Search query' }),
+            maxResults: Type.Optional(Type.Number({ description: 'Max results (default: 5)' })),
+            minScore: Type.Optional(Type.Number({ description: 'Minimum relevance score 0-1' })),
+        }),
+        async execute(_toolCallId, params) {
+            const { query, maxResults = 5, minScore = 0.1 } = params;
+            const results = await client.search(entityId, query, { limit: maxResults, min_score: minScore });
+            if (results.length === 0) {
+                return {
+                    content: [{ type: 'text', text: JSON.stringify({ results: [], provider: 'memory', mode: 'semantic' }) }],
+                    details: { count: 0 },
+                };
+            }
+            const mapped = results.map((r) => ({
+                path: `mem:${r.memory.id}`,
+                startLine: 1,
+                endLine: 1,
+                score: r.similarity,
+                snippet: r.memory.content,
+                source: 'memory',
+                citation: `mem:${r.memory.id}`,
+            }));
+            return {
+                content: [
+                    { type: 'text', text: JSON.stringify({ results: mapped, provider: 'memory', mode: 'semantic' }) },
+                ],
+                details: { count: mapped.length },
+            };
+        },
+    }, { name: 'memory_search' });
+    // memory_get — OpenClaw-standard memory read tool (replaces file-based reads)
+    api.registerTool({
+        name: 'memory_get',
+        label: 'Memory Get',
+        description: 'Read a specific memory by its ID (mem:<id>) or search for a memory by keyword.',
+        parameters: Type.Object({
+            path: Type.String({ description: 'Memory path (mem:<id>) or keyword to search' }),
+            from: Type.Optional(Type.Number({ description: 'Line offset (unused)' })),
+            lines: Type.Optional(Type.Number({ description: 'Line count (unused)' })),
+        }),
+        async execute(_toolCallId, params) {
+            const { path: memPath } = params;
+            if (memPath.startsWith('mem:') || memPath.startsWith('keyoku:')) {
+                const id = memPath.startsWith('mem:') ? memPath.slice(4) : memPath.slice(7);
+                try {
+                    const memory = await client.getMemory(id);
+                    return {
+                        content: [{ type: 'text', text: JSON.stringify({ text: memory.content, path: memPath }) }],
+                    };
+                }
+                catch {
+                    return {
+                        content: [{ type: 'text', text: JSON.stringify({ text: '', path: memPath, error: 'Memory not found' }) }],
+                    };
+                }
+            }
+            // Fallback: treat path as a search query
+            const results = await client.search(entityId, memPath, { limit: 1 });
+            if (results.length > 0) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                text: results[0].memory.content,
+                                path: `mem:${results[0].memory.id}`,
+                            }),
+                        },
+                    ],
+                };
+            }
+            return {
+                content: [{ type: 'text', text: JSON.stringify({ text: '', path: memPath, error: 'Not found' }) }],
+            };
+        },
+    }, { name: 'memory_get' });
+    // memory_store — store a new memory
+    api.registerTool({
+        name: 'memory_store',
+        label: 'Memory Store',
+        description: 'Save important information in long-term memory. Use for preferences, facts, decisions.',
+        parameters: Type.Object({
+            text: Type.String({ description: 'Information to remember' }),
+        }),
+        async execute(_toolCallId, params) {
+            const { text } = params;
+            const result = await client.remember(entityId, text, { agent_id: agentId });
+            return {
+                content: [{ type: 'text', text: `Stored: "${text.slice(0, 100)}${text.length > 100 ? '...' : ''}"` }],
+                details: { memories_created: result.memories_created },
+            };
+        },
+    }, { name: 'memory_store' });
+    // memory_forget — delete a memory by ID
+    api.registerTool({
+        name: 'memory_forget',
+        label: 'Memory Forget',
+        description: 'Delete a specific memory by ID.',
+        parameters: Type.Object({
+            memory_id: Type.String({ description: 'The memory ID to delete' }),
+        }),
+        async execute(_toolCallId, params) {
+            const { memory_id } = params;
+            const result = await client.deleteMemory(memory_id);
+            return {
+                content: [{ type: 'text', text: `Memory ${memory_id} deleted.` }],
+                details: { status: result.status },
+            };
+        },
+    }, { name: 'memory_forget' });
+    // memory_stats — get memory statistics
+    api.registerTool({
+        name: 'memory_stats',
+        label: 'Memory Stats',
+        description: 'Get memory statistics for the current entity.',
+        parameters: Type.Object({}),
+        async execute() {
+            const stats = await client.getStats(entityId);
+            const text = [
+                `Total memories: ${stats.total_memories}`,
+                `Active memories: ${stats.active_memories}`,
+                `By type: ${JSON.stringify(stats.by_type)}`,
+                `By state: ${JSON.stringify(stats.by_state)}`,
+            ].join('\n');
+            return {
+                content: [{ type: 'text', text }],
+                details: { ...stats },
+            };
+        },
+    }, { name: 'memory_stats' });
+    // schedule_create — create a scheduled memory
+    api.registerTool({
+        name: 'schedule_create',
+        label: 'Schedule Create',
+        description: 'Create a scheduled task/reminder. Cron tags: "daily", "weekly", "monthly", or a cron expression.',
+        parameters: Type.Object({
+            content: Type.String({ description: 'What to schedule' }),
+            cron_tag: Type.String({ description: 'Cron tag: "daily", "weekly", "monthly", or cron expression' }),
+        }),
+        async execute(_toolCallId, params) {
+            const { content, cron_tag } = params;
+            const result = await client.createSchedule(entityId, agentId, content, cron_tag);
+            return {
+                content: [{ type: 'text', text: `Scheduled: "${content}" (${cron_tag})` }],
+                details: { id: result.id },
+            };
+        },
+    }, { name: 'schedule_create' });
+    // schedule_list — list schedules
+    api.registerTool({
+        name: 'schedule_list',
+        label: 'Schedule List',
+        description: 'List active schedules.',
+        parameters: Type.Object({}),
+        async execute() {
+            const schedules = await client.listSchedules(entityId, agentId);
+            if (schedules.length === 0) {
+                return {
+                    content: [{ type: 'text', text: 'No active schedules.' }],
+                    details: { count: 0 },
+                };
+            }
+            const text = schedules
+                .map((s, i) => `${i + 1}. ${s.content} (id: ${s.id})`)
+                .join('\n');
+            return {
+                content: [{ type: 'text', text: `${schedules.length} schedules:\n\n${text}` }],
+                details: { count: schedules.length },
+            };
+        },
+    }, { name: 'schedule_list' });
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Minimal OpenClaw plugin API types.
+ * These mirror the types from openclaw/src/plugins/types.ts
+ * so that @keyoku/openclaw can compile without importing openclaw directly.
+ * At runtime, the actual OpenClaw API object is passed in.
+ */
+export type PluginLogger = {
+    debug?: (message: string) => void;
+    info: (message: string) => void;
+    warn: (message: string) => void;
+    error: (message: string) => void;
+};
+export type ToolResult = {
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+    details?: Record<string, unknown>;
+};
+export type AgentTool = {
+    name: string;
+    label?: string;
+    description: string;
+    parameters: unknown;
+    execute: (toolCallId: string, params: Record<string, unknown>) => Promise<ToolResult>;
+};
+export type PluginApi = {
+    id: string;
+    name: string;
+    logger: PluginLogger;
+    pluginConfig?: Record<string, unknown>;
+    registerTool: (tool: AgentTool, opts?: {
+        name?: string;
+        names?: string[];
+    }) => void;
+    registerHook?: (events: string | string[], handler: (...args: unknown[]) => unknown, opts?: Record<string, unknown>) => void;
+    registerCli: (registrar: (ctx: {
+        program: unknown;
+        config: unknown;
+        logger: PluginLogger;
+    }) => void, opts?: {
+        commands?: string[];
+    }) => void;
+    registerService: (service: {
+        id: string;
+        start: (ctx: unknown) => void | Promise<void>;
+        stop?: (ctx: unknown) => void | Promise<void>;
+    }) => void;
+    resolvePath: (input: string) => string;
+    on: (hookName: string, handler: (...args: unknown[]) => unknown, opts?: {
+        priority?: number;
+    }) => void;
+    config?: Record<string, unknown>;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;CACvF,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,YAAY,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,YAAY,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,KAAK,IAAI,CAAC;IACpF,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAC7H,WAAW,EAAE,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,YAAY,CAAA;KAAE,KAAK,IAAI,EAAE,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,KAAK,IAAI,CAAC;IAC7I,eAAe,EAAE,CAAC,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAAC,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,KAAK,IAAI,CAAC;IACjJ,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACvC,EAAE,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,EAAE,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACvG,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC,CAAC"}

package/dist/types.js

@@ -0,0 +1,8 @@
+/**
+ * Minimal OpenClaw plugin API types.
+ * These mirror the types from openclaw/src/plugins/types.ts
+ * so that @keyoku/openclaw can compile without importing openclaw directly.
+ * At runtime, the actual OpenClaw API object is passed in.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@keyoku/openclaw",
+  "version": "1.0.0",
+  "description": "Keyoku memory plugin for OpenClaw — persistent memory, heartbeat enhancement, and scheduling",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc"
+  },
+  "dependencies": {
+    "@keyoku/memory": "1.0.0",
+    "@keyoku/types": "1.0.0",
+    "@sinclair/typebox": "^0.34.0"
+  },
+  "peerDependencies": {
+    "openclaw": ">=0.1.0"
+  },
+  "peerDependenciesMeta": {
+    "openclaw": {
+      "optional": true
+    }
+  },
+  "openclaw": {
+    "extensions": ["dist/index.js"]
+  },
+  "license": "MIT",
+  "engines": {
+    "node": ">=20"
+  }
+}

package/src/capture.ts

@@ -0,0 +1,116 @@
+/**
+ * Heuristic extraction of memorable facts from conversation messages.
+ * Only captures from user messages to avoid self-poisoning from model output.
+ */
+
+const MEMORY_TRIGGERS = [
+  /remember|don't forget|keep in mind/i,
+  /i (like|prefer|hate|love|want|need|always|never)/i,
+  /my\s+\w+\s+is|is\s+my/i,
+  /decided|will use|going with|chose|switched to/i,
+  /important|critical|must|required/i,
+  /[\w.-]+@[\w.-]+\.\w+/,  // email
+  /\+\d{10,}/,              // phone number
+];
+
+const PROMPT_INJECTION_PATTERNS = [
+  /ignore (all|any|previous|above|prior) instructions/i,
+  /do not follow (the )?(system|developer)/i,
+  /system prompt/i,
+  /<\s*(system|assistant|developer|tool)\b/i,
+];
+
+/**
+ * Check if text looks like a prompt injection attempt.
+ */
+export function looksLikePromptInjection(text: string): boolean {
+  const normalized = text.replace(/\s+/g, ' ').trim();
+  if (!normalized) return false;
+  return PROMPT_INJECTION_PATTERNS.some((p) => p.test(normalized));
+}
+
+/**
+ * Determine if a message should be captured as a memory.
+ */
+export function shouldCapture(text: string, maxChars = 2000): boolean {
+  if (text.length < 10 || text.length > maxChars) return false;
+  if (text.includes('<relevant-memories>')) return false;
+  if (text.includes('<heartbeat-signals>')) return false;
+  if (text.startsWith('<') && text.includes('</')) return false;
+  if (looksLikePromptInjection(text)) return false;
+  return MEMORY_TRIGGERS.some((r) => r.test(text));
+}
+
+const SUBSTANTIAL_PATTERNS = [
+  // Decisions and choices
+  /\b(decided|will use|going with|chose|configured|set up|switched to|picked|selected)\b/i,
+  // Summaries and conclusions
+  /\b(summary|conclusion|result|finding|outcome|in short|to summarize|overall)\b/i,
+  // Actions completed
+  /\b(created|built|implemented|fixed|resolved|deployed|installed|migrated|refactored)\b/i,
+  // Explicit memory cues
+  /\b(note|remember|important|key takeaway|keep in mind|for reference|fyi)\b/i,
+  // Architecture and design
+  /\b(architecture|design|pattern|approach|strategy|tradeoff|trade-off)\b/i,
+  // Project structure
+  /\b(directory|folder|file structure|layout|organized|structured)\b/i,
+  // Tech stack and tools
+  /\b(using|stack|framework|library|database|api|endpoint|schema|model)\b/i,
+  // Contains bullet points or numbered lists (likely a list/summary)
+  /^\s*[-*]\s+/m,
+  /^\s*\d+[.)]\s+/m,
+  // Contains code references
+  /`[^`]+`/,
+  // Contains URLs or paths
+  /https?:\/\/\S+/,
+  /\/[\w-]+\/[\w-]+/,
+];
+
+/**
+ * Check if text contains substantial information worth capturing.
+ * Used for incremental (per-message) capture of assistant output.
+ */
+export function hasSubstantialContent(text: string): boolean {
+  if (text.length < 50) return false;
+  return SUBSTANTIAL_PATTERNS.some((p) => p.test(text));
+}
+
+/**
+ * Extract capturable text segments from conversation messages.
+ * Only processes user messages to avoid self-poisoning.
+ */
+export function extractCapturableTexts(messages: unknown[], maxChars = 2000): string[] {
+  const texts: string[] = [];
+
+  for (const msg of messages) {
+    if (!msg || typeof msg !== 'object') continue;
+    const msgObj = msg as Record<string, unknown>;
+
+    // Only capture from user messages
+    if (msgObj.role !== 'user') continue;
+
+    const content = msgObj.content;
+    if (typeof content === 'string') {
+      if (shouldCapture(content, maxChars)) texts.push(content);
+      continue;
+    }
+
+    if (Array.isArray(content)) {
+      for (const block of content) {
+        if (
+          block &&
+          typeof block === 'object' &&
+          'type' in block &&
+          (block as Record<string, unknown>).type === 'text' &&
+          'text' in block &&
+          typeof (block as Record<string, unknown>).text === 'string'
+        ) {
+          const text = (block as Record<string, unknown>).text as string;
+          if (shouldCapture(text, maxChars)) texts.push(text);
+        }
+      }
+    }
+  }
+
+  return texts;
+}