@troykelly/openclaw-projects 0.0.11 → 0.0.13

package/dist/tools/context-search.js

@@ -0,0 +1,267 @@
+/**
+ * context_search tool implementation.
+ * Provides unified cross-entity recall across memories, todos, projects, and messages.
+ * Fans out to memory, work-item, and message search APIs in parallel, normalizes scores,
+ * and returns a blended ranked list.
+ *
+ * Part of Issue #1219, #1222.
+ */
+import { z } from 'zod';
+import { createBoundaryMarkers, sanitizeMetadataField, wrapExternalMessage } from '../utils/injection-protection.js';
+import { sanitizeErrorMessage } from '../utils/sanitize.js';
+/** Supported entity types for cross-entity search */
+export const EntityType = z.enum(['memory', 'todo', 'project', 'message']);
+/** Parameters for context_search tool */
+export const ContextSearchParamsSchema = z.object({
+    query: z.string().min(1, 'Query cannot be empty').max(1000, 'Query must be 1000 characters or less'),
+    entity_types: z.array(EntityType).optional(),
+    limit: z.number().int().min(1).max(50).optional(),
+    // TODO: location and location_weight params will be added when #1204 (geo-aware memory) ships
+});
+/**
+ * Sanitize query input to prevent injection and remove control characters.
+ */
+function sanitizeQuery(query) {
+    return query.replace(/[\x00-\x08\x0B\x0C\x0E-\x1F\x7F]/g, '').trim();
+}
+/**
+ * Normalize an array of scores to 0-1 by dividing each by the max score in the set.
+ * If maxScore <= 0, all scores are set to 0. All results are clamped to [0, 1].
+ */
+function normalizeScores(items) {
+    if (items.length === 0)
+        return;
+    const maxScore = Math.max(...items.map((i) => i.score));
+    if (maxScore <= 0) {
+        for (const item of items) {
+            item.score = 0;
+        }
+        return;
+    }
+    for (const item of items) {
+        item.score = Math.max(0, Math.min(1, item.score / maxScore));
+    }
+}
+/**
+ * Determine entity_type for a work item based on its metadata.kind.
+ */
+function classifyWorkItem(kind) {
+    return kind === 'project' ? 'project' : 'todo';
+}
+/**
+ * Format context search results as a text list with entity type annotations.
+ */
+function formatResultsAsText(results) {
+    if (results.length === 0) {
+        return 'No matching results found across memories, todos, projects, or messages.';
+    }
+    return results
+        .map((r) => {
+        const scoreStr = r.score.toFixed(2);
+        const snippetStr = r.snippet ? ` - ${r.snippet}` : '';
+        // Include metadata annotations for messages (channel, timestamp)
+        let metaStr = '';
+        if (r.entity_type === 'message' && r.metadata) {
+            const parts = [];
+            if (r.metadata.channel)
+                parts.push(r.metadata.channel);
+            if (r.metadata.received_at)
+                parts.push(r.metadata.received_at);
+            if (parts.length > 0)
+                metaStr = ` [${parts.join(', ')}]`;
+        }
+        return `- [${r.entity_type}] ${r.title}${snippetStr}${metaStr} (score: ${scoreStr})`;
+    })
+        .join('\n');
+}
+/**
+ * Creates the context_search tool.
+ */
+export function createContextSearchTool(options) {
+    const { client, logger, userId } = options;
+    return {
+        name: 'context_search',
+        description: 'Search across memories, todos, projects, and messages simultaneously. Use when you need broad context about a topic, ' +
+            'person, or project. Returns a blended ranked list from all entity types. Optionally filter by entity_types to narrow the search.',
+        parameters: ContextSearchParamsSchema,
+        async execute(params) {
+            // Validate parameters
+            const parseResult = ContextSearchParamsSchema.safeParse(params);
+            if (!parseResult.success) {
+                const errorMessage = parseResult.error.errors.map((e) => `${e.path.join('.')}: ${e.message}`).join(', ');
+                return { success: false, error: errorMessage };
+            }
+            const { query, entity_types, limit = 10 } = parseResult.data;
+            // Sanitize query
+            const sanitizedQuery = sanitizeQuery(query);
+            if (sanitizedQuery.length === 0) {
+                return { success: false, error: 'Query cannot be empty after sanitization' };
+            }
+            // Determine which searches to run
+            const searchMemories = !entity_types || entity_types.includes('memory');
+            const searchWorkItems = !entity_types || entity_types.includes('todo') || entity_types.includes('project');
+            const searchMessages = !entity_types || entity_types.includes('message');
+            logger.info('context_search invoked', {
+                userId,
+                queryLength: sanitizedQuery.length,
+                limit,
+                entity_types: entity_types ?? 'all',
+            });
+            const taggedPromises = [];
+            if (searchMemories) {
+                const memoryParams = new URLSearchParams({
+                    q: sanitizedQuery,
+                    limit: String(limit),
+                    user_email: userId,
+                });
+                taggedPromises.push({
+                    tag: 'memory',
+                    promise: client.get(`/api/memories/search?${memoryParams.toString()}`, { userId }),
+                });
+            }
+            if (searchWorkItems) {
+                const searchParams = new URLSearchParams({
+                    q: sanitizedQuery,
+                    types: 'work_item',
+                    limit: String(Math.min(limit * 3, 50)), // Over-fetch for client-side filtering
+                    semantic: 'true',
+                    user_email: userId,
+                });
+                taggedPromises.push({
+                    tag: 'work_item',
+                    promise: client.get(`/api/search?${searchParams.toString()}`, { userId }),
+                });
+            }
+            if (searchMessages) {
+                const messageParams = new URLSearchParams({
+                    q: sanitizedQuery,
+                    types: 'message',
+                    limit: String(Math.min(limit * 2, 50)),
+                    semantic: 'true',
+                    user_email: userId,
+                });
+                taggedPromises.push({
+                    tag: 'message',
+                    promise: client.get(`/api/search?${messageParams.toString()}`, { userId }),
+                });
+            }
+            const settled = await Promise.allSettled(taggedPromises.map((tp) => tp.promise));
+            // Process results
+            const warnings = [];
+            const memoryItems = [];
+            const workItemResults = [];
+            const messageItems = [];
+            for (let i = 0; i < settled.length; i++) {
+                const entry = settled[i];
+                const tag = taggedPromises[i].tag;
+                if (entry.status === 'rejected') {
+                    const safeMsg = sanitizeErrorMessage(entry.reason);
+                    warnings.push(`${tag} search failed: ${safeMsg}`);
+                    logger.error(`context_search ${tag} search failed`, { userId, error: safeMsg });
+                    continue;
+                }
+                const response = entry.value;
+                if (!response.success) {
+                    const safeMsg = sanitizeErrorMessage(response.error?.message ?? 'Unknown error');
+                    warnings.push(`${tag} search failed: ${safeMsg}`);
+                    logger.error(`context_search ${tag} API error`, { userId, error: safeMsg });
+                    continue;
+                }
+                if (tag === 'memory') {
+                    const data = response.data;
+                    const rawResults = data.results ?? [];
+                    for (const m of rawResults) {
+                        memoryItems.push({
+                            id: m.id,
+                            entity_type: 'memory',
+                            title: m.content,
+                            snippet: '',
+                            score: m.similarity ?? 0,
+                        });
+                    }
+                }
+                else if (tag === 'message') {
+                    const data = response.data;
+                    const rawResults = data.results ?? [];
+                    // Generate a per-invocation nonce for boundary markers (#1255)
+                    const { nonce: msgNonce } = createBoundaryMarkers();
+                    for (const msg of rawResults) {
+                        // Sanitize external message content to prevent prompt injection.
+                        // Both title and snippet are wrapped since messages are external/untrusted content
+                        // mixed alongside trusted entity results from memories/todos/projects.
+                        const safeTitle = wrapExternalMessage(sanitizeMetadataField(msg.title ?? '', msgNonce), { nonce: msgNonce });
+                        const safeSnippet = msg.snippet ? wrapExternalMessage(sanitizeMetadataField(msg.snippet.substring(0, 100), msgNonce), { nonce: msgNonce }) : '';
+                        const meta = {};
+                        if (msg.metadata?.channel)
+                            meta.channel = sanitizeMetadataField(msg.metadata.channel, msgNonce);
+                        if (msg.metadata?.received_at)
+                            meta.received_at = sanitizeMetadataField(msg.metadata.received_at, msgNonce);
+                        messageItems.push({
+                            id: msg.id,
+                            entity_type: 'message',
+                            title: safeTitle,
+                            snippet: safeSnippet,
+                            score: msg.score ?? 0,
+                            metadata: Object.keys(meta).length > 0 ? meta : undefined,
+                        });
+                    }
+                }
+                else {
+                    const data = response.data;
+                    const rawResults = data.results ?? [];
+                    for (const w of rawResults) {
+                        const entityType = classifyWorkItem(w.metadata?.kind);
+                        workItemResults.push({
+                            id: w.id,
+                            entity_type: entityType,
+                            title: w.title,
+                            snippet: w.snippet,
+                            score: w.score ?? 0,
+                        });
+                    }
+                }
+            }
+            // If all searches failed, return error
+            if (memoryItems.length === 0 && workItemResults.length === 0 && messageItems.length === 0 && warnings.length === settled.length && settled.length > 0) {
+                return {
+                    success: false,
+                    error: `All searches failed: ${warnings.join('; ')}`,
+                };
+            }
+            // Normalize scores within each category
+            normalizeScores(memoryItems);
+            normalizeScores(workItemResults);
+            normalizeScores(messageItems);
+            // Merge all results
+            let allResults = [...memoryItems, ...workItemResults, ...messageItems];
+            // Filter by entity_types if specified
+            if (entity_types) {
+                allResults = allResults.filter((r) => entity_types.includes(r.entity_type));
+            }
+            // Sort by normalized score descending
+            allResults.sort((a, b) => b.score - a.score);
+            // Apply limit
+            allResults = allResults.slice(0, limit);
+            // Format output
+            const content = formatResultsAsText(allResults);
+            logger.debug('context_search completed', {
+                userId,
+                resultCount: allResults.length,
+                warningCount: warnings.length,
+            });
+            return {
+                success: true,
+                data: {
+                    content,
+                    details: {
+                        count: allResults.length,
+                        results: allResults,
+                        warnings: warnings.length > 0 ? warnings : undefined,
+                        userId,
+                    },
+                },
+            };
+        },
+    };
+}
+//# sourceMappingURL=context-search.js.map

package/dist/tools/context-search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-search.js","sourceRoot":"","sources":["../../src/tools/context-search.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACrH,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE5D,qDAAqD;AACrD,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC;AAG3E,yCAAyC;AACzC,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,uBAAuB,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,uCAAuC,CAAC;IACpG,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,QAAQ,EAAE;IAC5C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;IACjD,8FAA8F;CAC/F,CAAC,CAAC;AAqDH;;GAEG;AACH,SAAS,aAAa,CAAC,KAAa;IAClC,OAAO,KAAK,CAAC,OAAO,CAAC,mCAAmC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AACvE,CAAC;AA+BD;;;GAGG;AACH,SAAS,eAAe,CAAC,KAA0B;IACjD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAC/B,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IACxD,IAAI,QAAQ,IAAI,CAAC,EAAE,CAAC;QAClB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;QACjB,CAAC;QACD,OAAO;IACT,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC;IAC/D,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,gBAAgB,CAAC,IAAa;IACrC,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAAC,OAAkC;IAC7D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,0EAA0E,CAAC;IACpF,CAAC;IAED,OAAO,OAAO;SACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACT,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACpC,MAAM,UAAU,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtD,iEAAiE;QACjE,IAAI,OAAO,GAAG,EAAE,CAAC;QACjB,IAAI,CAAC,CAAC,WAAW,KAAK,SAAS,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;YAC9C,MAAM,KAAK,GAAa,EAAE,CAAC;YAC3B,IAAI,CAAC,CAAC,QAAQ,CAAC,OAAO;gBAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YACvD,IAAI,CAAC,CAAC,QAAQ,CAAC,WAAW;gBAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;YAC/D,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;gBAAE,OAAO,GAAG,KAAK,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;QAC3D,CAAC;QACD,OAAO,MAAM,CAAC,CAAC,WAAW,KAAK,CAAC,CAAC,KAAK,GAAG,UAAU,GAAG,OAAO,YAAY,QAAQ,GAAG,CAAC;IACvF,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAAiC;IACvE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAE3C,OAAO;QACL,IAAI,EAAE,gBAAgB;QACtB,WAAW,EACT,uHAAuH;YACvH,kIAAkI;QACpI,UAAU,EAAE,yBAAyB;QAErC,KAAK,CAAC,OAAO,CAAC,MAA2B;YACvC,sBAAsB;YACtB,MAAM,WAAW,GAAG,yBAAyB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YAChE,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;gBACzB,MAAM,YAAY,GAAG,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACzG,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC;YACjD,CAAC;YAED,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,GAAG,EAAE,EAAE,GAAG,WAAW,CAAC,IAAI,CAAC;YAE7D,iBAAiB;YACjB,MAAM,cAAc,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;YAC5C,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAChC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,0CAA0C,EAAE,CAAC;YAC/E,CAAC;YAED,kCAAkC;YAClC,MAAM,cAAc,GAAG,CAAC,YAAY,IAAI,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YACxE,MAAM,eAAe,GAAG,CAAC,YAAY,IAAI,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;YAC3G,MAAM,cAAc,GAAG,CAAC,YAAY,IAAI,YAAY,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;YAEzE,MAAM,CAAC,IAAI,CAAC,wBAAwB,EAAE;gBACpC,MAAM;gBACN,WAAW,EAAE,cAAc,CAAC,MAAM;gBAClC,KAAK;gBACL,YAAY,EAAE,YAAY,IAAI,KAAK;aACpC,CAAC,CAAC;YAIH,MAAM,cAAc,GAAyD,EAAE,CAAC;YAEhF,IAAI,cAAc,EAAE,CAAC;gBACnB,MAAM,YAAY,GAAG,IAAI,eAAe,CAAC;oBACvC,CAAC,EAAE,cAAc;oBACjB,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC;oBACpB,UAAU,EAAE,MAAM;iBACnB,CAAC,CAAC;gBACH,cAAc,CAAC,IAAI,CAAC;oBAClB,GAAG,EAAE,QAAQ;oBACb,OAAO,EAAE,MAAM,CAAC,GAAG,CAAsD,wBAAwB,YAAY,CAAC,QAAQ,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC;iBACxI,CAAC,CAAC;YACL,CAAC;YAED,IAAI,eAAe,EAAE,CAAC;gBACpB,MAAM,YAAY,GAAG,IAAI,eAAe,CAAC;oBACvC,CAAC,EAAE,cAAc;oBACjB,KAAK,EAAE,WAAW;oBAClB,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,uCAAuC;oBAC/E,QAAQ,EAAE,MAAM;oBAChB,UAAU,EAAE,MAAM;iBACnB,CAAC,CAAC;gBACH,cAAc,CAAC,IAAI,CAAC;oBAClB,GAAG,EAAE,WAAW;oBAChB,OAAO,EAAE,MAAM,CAAC,GAAG,CAAuE,eAAe,YAAY,CAAC,QAAQ,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC;iBAChJ,CAAC,CAAC;YACL,CAAC;YAED,IAAI,cAAc,EAAE,CAAC;gBACnB,MAAM,aAAa,GAAG,IAAI,eAAe,CAAC;oBACxC,CAAC,EAAE,cAAc;oBACjB,KAAK,EAAE,SAAS;oBAChB,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;oBACtC,QAAQ,EAAE,MAAM;oBAChB,UAAU,EAAE,MAAM;iBACnB,CAAC,CAAC;gBACH,cAAc,CAAC,IAAI,CAAC;oBAClB,GAAG,EAAE,SAAS;oBACd,OAAO,EAAE,MAAM,CAAC,GAAG,CAAsE,eAAe,aAAa,CAAC,QAAQ,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC;iBAChJ,CAAC,CAAC;YACL,CAAC;YAED,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;YAEjF,kBAAkB;YAClB,MAAM,QAAQ,GAAa,EAAE,CAAC;YAC9B,MAAM,WAAW,GAA8B,EAAE,CAAC;YAClD,MAAM,eAAe,GAA8B,EAAE,CAAC;YACtD,MAAM,YAAY,GAA8B,EAAE,CAAC;YAEnD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACxC,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;gBACzB,MAAM,GAAG,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;gBAElC,IAAI,KAAK,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;oBAChC,MAAM,OAAO,GAAG,oBAAoB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;oBACnD,QAAQ,CAAC,IAAI,CAAC,GAAG,GAAG,mBAAmB,OAAO,EAAE,CAAC,CAAC;oBAClD,MAAM,CAAC,KAAK,CAAC,kBAAkB,GAAG,gBAAgB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;oBAChF,SAAS;gBACX,CAAC;gBAED,MAAM,QAAQ,GAAG,KAAK,CAAC,KAA2E,CAAC;gBAEnG,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;oBACtB,MAAM,OAAO,GAAG,oBAAoB,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,IAAI,eAAe,CAAC,CAAC;oBACjF,QAAQ,CAAC,IAAI,CAAC,GAAG,GAAG,mBAAmB,OAAO,EAAE,CAAC,CAAC;oBAClD,MAAM,CAAC,KAAK,CAAC,kBAAkB,GAAG,YAAY,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;oBAC5E,SAAS;gBACX,CAAC;gBAED,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;oBACrB,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAsC,CAAC;oBAC7D,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;oBACtC,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;wBAC3B,WAAW,CAAC,IAAI,CAAC;4BACf,EAAE,EAAE,CAAC,CAAC,EAAE;4BACR,WAAW,EAAE,QAAQ;4BACrB,KAAK,EAAE,CAAC,CAAC,OAAO;4BAChB,OAAO,EAAE,EAAE;4BACX,KAAK,EAAE,CAAC,CAAC,UAAU,IAAI,CAAC;yBACzB,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;qBAAM,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;oBAC7B,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAuC,CAAC;oBAC9D,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;oBACtC,+DAA+D;oBAC/D,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,qBAAqB,EAAE,CAAC;oBACpD,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;wBAC7B,iEAAiE;wBACjE,mFAAmF;wBACnF,uEAAuE;wBACvE,MAAM,SAAS,GAAG,mBAAmB,CAAC,qBAAqB,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,EAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;wBAC7G,MAAM,WAAW,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,mBAAmB,CAAC,qBAAqB,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;wBAChJ,MAAM,IAAI,GAA2B,EAAE,CAAC;wBACxC,IAAI,GAAG,CAAC,QAAQ,EAAE,OAAO;4BAAE,IAAI,CAAC,OAAO,GAAG,qBAAqB,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;wBAChG,IAAI,GAAG,CAAC,QAAQ,EAAE,WAAW;4BAAE,IAAI,CAAC,WAAW,GAAG,qBAAqB,CAAC,GAAG,CAAC,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;wBAC5G,YAAY,CAAC,IAAI,CAAC;4BAChB,EAAE,EAAE,GAAG,CAAC,EAAE;4BACV,WAAW,EAAE,SAAS;4BACtB,KAAK,EAAE,SAAS;4BAChB,OAAO,EAAE,WAAW;4BACpB,KAAK,EAAE,GAAG,CAAC,KAAK,IAAI,CAAC;4BACrB,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;yBAC1D,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;qBAAM,CAAC;oBACN,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAwC,CAAC;oBAC/D,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;oBACtC,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;wBAC3B,MAAM,UAAU,GAAG,gBAAgB,CAAC,CAAC,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;wBACtD,eAAe,CAAC,IAAI,CAAC;4BACnB,EAAE,EAAE,CAAC,CAAC,EAAE;4BACR,WAAW,EAAE,UAAU;4BACvB,KAAK,EAAE,CAAC,CAAC,KAAK;4BACd,OAAO,EAAE,CAAC,CAAC,OAAO;4BAClB,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC;yBACpB,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;YACH,CAAC;YAED,uCAAuC;YACvC,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,IAAI,QAAQ,CAAC,MAAM,KAAK,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACtJ,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE,wBAAwB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;iBACrD,CAAC;YACJ,CAAC;YAED,wCAAwC;YACxC,eAAe,CAAC,WAAW,CAAC,CAAC;YAC7B,eAAe,CAAC,eAAe,CAAC,CAAC;YACjC,eAAe,CAAC,YAAY,CAAC,CAAC;YAE9B,oBAAoB;YACpB,IAAI,UAAU,GAAG,CAAC,GAAG,WAAW,EAAE,GAAG,eAAe,EAAE,GAAG,YAAY,CAAC,CAAC;YAEvE,sCAAsC;YACtC,IAAI,YAAY,EAAE,CAAC;gBACjB,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC;YAC9E,CAAC;YAED,sCAAsC;YACtC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;YAE7C,cAAc;YACd,UAAU,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;YAExC,gBAAgB;YAChB,MAAM,OAAO,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAC;YAEhD,MAAM,CAAC,KAAK,CAAC,0BAA0B,EAAE;gBACvC,MAAM;gBACN,WAAW,EAAE,UAAU,CAAC,MAAM;gBAC9B,YAAY,EAAE,QAAQ,CAAC,MAAM;aAC9B,CAAC,CAAC;YAEH,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE;oBACJ,OAAO;oBACP,OAAO,EAAE;wBACP,KAAK,EAAE,UAAU,CAAC,MAAM;wBACxB,OAAO,EAAE,UAAU;wBACnB,QAAQ,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;wBACpD,MAAM;qBACP;iBACF;aACF,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/email-send.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"email-send.d.ts","sourceRoot":"","sources":["../../src/tools/email-send.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAQjD,qCAAqC;AACrC,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;EAOhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AASpE,6BAA6B;AAC7B,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,IAAI,CAAC;IACd,IAAI,EAAE;QACJ,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE;YACP,SAAS,EAAE,MAAM,CAAC;YAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;YAClB,MAAM,EAAE,MAAM,CAAC;YACf,MAAM,EAAE,MAAM,CAAC;SAChB,CAAC;KACH,CAAC;CACH;AAED,yBAAyB;AACzB,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,uBAAuB;AACvB,MAAM,MAAM,eAAe,GAAG,gBAAgB,GAAG,gBAAgB,CAAC;AAElE,yBAAyB;AACzB,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,sBAAsB;AACtB,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,qBAAqB,CAAC;IACzC,OAAO,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;CAChE;AAqBD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CAgGhF"}
+{"version":3,"file":"email-send.d.ts","sourceRoot":"","sources":["../../src/tools/email-send.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAQjD,qCAAqC;AACrC,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;EAOhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AASpE,6BAA6B;AAC7B,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,IAAI,CAAC;IACd,IAAI,EAAE;QACJ,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE;YACP,SAAS,EAAE,MAAM,CAAC;YAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;YAClB,MAAM,EAAE,MAAM,CAAC;YACf,MAAM,EAAE,MAAM,CAAC;SAChB,CAAC;KACH,CAAC;CACH;AAED,yBAAyB;AACzB,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,uBAAuB;AACvB,MAAM,MAAM,eAAe,GAAG,gBAAgB,GAAG,gBAAgB,CAAC;AAElE,yBAAyB;AACzB,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,sBAAsB;AACtB,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,qBAAqB,CAAC;IACzC,OAAO,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;CAChE;AAcD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CAwFhF"}

package/dist/tools/email-send.js

@@ -27,17 +27,11 @@ function sanitizeErrorMessage(error) {
     }
     return 'An unexpected error occurred while sending email.';
 }
-/**
- * Check if Postmark is configured.
- */
-function isPostmarkConfigured(config) {
-    return !!(config.postmarkToken && config.postmarkFromEmail);
-}
 /**
  * Creates the email_send tool.
  */
 export function createEmailSendTool(options) {
-    const { client, logger, config, userId } = options;
+    const { client, logger, userId } = options;
     return {
         name: 'email_send',
         description: 'Send an email message. Use when you need to communicate via email. ' + 'Requires the recipient email address, subject, and body.',
@@ -50,13 +44,6 @@ export function createEmailSendTool(options) {
                 return { success: false, error: errorMessage };
             }
             const { to, subject, body, htmlBody, threadId, idempotencyKey } = parseResult.data;
-            // Check Postmark configuration
-            if (!isPostmarkConfigured(config)) {
-                return {
-                    success: false,
-                    error: 'Postmark is not configured. Please configure Postmark credentials.',
-                };
-            }
             // Log invocation (without email address for privacy)
             logger.info('email_send invoked', {
                 userId,

package/dist/tools/email-send.js.map

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

package/dist/tools/entity-links.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Entity linking tools for OpenClaw plugin (Issue #1220).
+ *
+ * Provides bidirectional linking between entities (memories, todos, projects,
+ * contacts) and external references (GitHub issues, URLs). Links are stored
+ * as skill_store items in the `entity_links` collection.
+ *
+ * Tools:
+ * - links_set: Create a bidirectional link between two entities
+ * - links_query: Query all links for a given entity
+ * - links_remove: Remove a bidirectional link
+ */
+import { z } from 'zod';
+import type { ApiClient } from '../api-client.js';
+import type { Logger } from '../logger.js';
+import type { PluginConfig } from '../config.js';
+/** Parameters for links_set tool */
+export declare const LinksSetParamsSchema: z.ZodObject<{
+    source_type: z.ZodEnum<["memory", "todo", "project", "contact"]>;
+    source_id: z.ZodString;
+    target_type: z.ZodEnum<["memory", "todo", "project", "contact", "github_issue", "url"]>;
+    target_ref: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    source_type: "project" | "memory" | "todo" | "contact";
+    source_id: string;
+    target_type: "project" | "memory" | "todo" | "url" | "contact" | "github_issue";
+    target_ref: string;
+    label?: string | undefined;
+}, {
+    source_type: "project" | "memory" | "todo" | "contact";
+    source_id: string;
+    target_type: "project" | "memory" | "todo" | "url" | "contact" | "github_issue";
+    target_ref: string;
+    label?: string | undefined;
+}>;
+export type LinksSetParams = z.infer<typeof LinksSetParamsSchema>;
+/** Parameters for links_query tool */
+export declare const LinksQueryParamsSchema: z.ZodObject<{
+    entity_type: z.ZodEnum<["memory", "todo", "project", "contact"]>;
+    entity_id: z.ZodString;
+    link_types: z.ZodOptional<z.ZodArray<z.ZodEnum<["memory", "todo", "project", "contact", "github_issue", "url"]>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    entity_type: "project" | "memory" | "todo" | "contact";
+    entity_id: string;
+    link_types?: ("project" | "memory" | "todo" | "url" | "contact" | "github_issue")[] | undefined;
+}, {
+    entity_type: "project" | "memory" | "todo" | "contact";
+    entity_id: string;
+    link_types?: ("project" | "memory" | "todo" | "url" | "contact" | "github_issue")[] | undefined;
+}>;
+export type LinksQueryParams = z.infer<typeof LinksQueryParamsSchema>;
+/** Parameters for links_remove tool */
+export declare const LinksRemoveParamsSchema: z.ZodObject<{
+    source_type: z.ZodEnum<["memory", "todo", "project", "contact"]>;
+    source_id: z.ZodString;
+    target_type: z.ZodEnum<["memory", "todo", "project", "contact", "github_issue", "url"]>;
+    target_ref: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    source_type: "project" | "memory" | "todo" | "contact";
+    source_id: string;
+    target_type: "project" | "memory" | "todo" | "url" | "contact" | "github_issue";
+    target_ref: string;
+}, {
+    source_type: "project" | "memory" | "todo" | "contact";
+    source_id: string;
+    target_type: "project" | "memory" | "todo" | "url" | "contact" | "github_issue";
+    target_ref: string;
+}>;
+export type LinksRemoveParams = z.infer<typeof LinksRemoveParamsSchema>;
+/** Successful tool result */
+export interface EntityLinkToolSuccess {
+    success: true;
+    data: {
+        content: string;
+        details: Record<string, unknown>;
+    };
+}
+/** Failed tool result */
+export interface EntityLinkToolFailure {
+    success: false;
+    error: string;
+}
+export type EntityLinkToolResult = EntityLinkToolSuccess | EntityLinkToolFailure;
+/** Tool configuration */
+export interface EntityLinkToolOptions {
+    client: ApiClient;
+    logger: Logger;
+    config?: PluginConfig;
+    userId: string;
+}
+/** Tool definition interface */
+export interface EntityLinkTool {
+    name: string;
+    description: string;
+    parameters: z.ZodType;
+    execute: (params: Record<string, unknown>) => Promise<EntityLinkToolResult>;
+}
+/**
+ * Create the links_set tool.
+ * Creates a bidirectional link between two entities by storing two skill_store
+ * items: one for the forward direction (A->B) and one for the reverse (B->A).
+ */
+export declare function createLinksSetTool(options: EntityLinkToolOptions): EntityLinkTool;
+/**
+ * Create the links_query tool.
+ * Queries all links for a given entity by listing skill_store items
+ * in the `entity_links` collection filtered by a source tag.
+ */
+export declare function createLinksQueryTool(options: EntityLinkToolOptions): EntityLinkTool;
+/**
+ * Create the links_remove tool.
+ * Removes a bidirectional link by deleting both the forward (A->B) and
+ * reverse (B->A) skill_store items.
+ */
+export declare function createLinksRemoveTool(options: EntityLinkToolOptions): EntityLinkTool;
+//# sourceMappingURL=entity-links.d.ts.map

package/dist/tools/entity-links.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-links.d.ts","sourceRoot":"","sources":["../../src/tools/entity-links.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AA2CjD,oCAAoC;AACpC,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;EAM/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,sCAAsC;AACtC,eAAO,MAAM,sBAAsB;;;;;;;;;;;;EAIjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,uCAAuC;AACvC,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;EAKlC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAIxE,6BAA6B;AAC7B,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,IAAI,CAAC;IACd,IAAI,EAAE;QACJ,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAClC,CAAC;CACH;AAED,yBAAyB;AACzB,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,oBAAoB,GAAG,qBAAqB,GAAG,qBAAqB,CAAC;AAIjF,yBAAyB;AACzB,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,gCAAgC;AAChC,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC;IACtB,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,oBAAoB,CAAC,CAAC;CAC7E;AAkBD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,qBAAqB,GAAG,cAAc,CAiKjF;AAYD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,GAAG,cAAc,CAmHnF;AAID;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,qBAAqB,GAAG,cAAc,CAgKpF"}