@troykelly/openclaw-projects 0.0.1

package/dist/tools/threads.js

@@ -0,0 +1,202 @@
+/**
+ * Thread tools implementation.
+ * Provides thread_list and thread_get tools for viewing message threads.
+ */
+import { z } from 'zod';
+/** Channel type enum */
+const ChannelType = z.enum(['sms', 'email']);
+/** Default and max limits */
+const DEFAULT_LIST_LIMIT = 20;
+const MAX_LIST_LIMIT = 100;
+const DEFAULT_MESSAGE_LIMIT = 50;
+const MAX_MESSAGE_LIMIT = 200;
+// =====================================================
+// Thread List Tool
+// =====================================================
+/** Parameters for thread_list tool */
+export const ThreadListParamsSchema = z.object({
+    channel: ChannelType.optional(),
+    contactId: z.string().uuid().optional(),
+    limit: z
+        .number()
+        .int()
+        .min(1, 'Limit must be at least 1')
+        .max(MAX_LIST_LIMIT, `Limit must be ${MAX_LIST_LIMIT} or less`)
+        .default(DEFAULT_LIST_LIMIT),
+});
+/**
+ * Creates the thread_list tool.
+ */
+export function createThreadListTool(options) {
+    const { client, logger, userId } = options;
+    return {
+        name: 'thread_list',
+        description: 'List message threads (conversations). Use to see recent conversations with contacts. ' +
+            'Can filter by channel (SMS/email) or contact.',
+        parameters: ThreadListParamsSchema,
+        async execute(params) {
+            // Validate parameters
+            const parseResult = ThreadListParamsSchema.safeParse(params);
+            if (!parseResult.success) {
+                const errorMessage = parseResult.error.errors
+                    .map((e) => `${e.path.join('.')}: ${e.message}`)
+                    .join(', ');
+                return { success: false, error: errorMessage };
+            }
+            const { channel, contactId, limit } = parseResult.data;
+            logger.info('thread_list invoked', {
+                userId,
+                channel,
+                hasContactId: !!contactId,
+                limit,
+            });
+            try {
+                // Build query parameters
+                const queryParams = new URLSearchParams();
+                queryParams.set('limit', String(limit));
+                if (channel) {
+                    queryParams.set('channel', channel);
+                }
+                if (contactId) {
+                    queryParams.set('contactId', contactId);
+                }
+                const response = await client.get(`/api/threads?${queryParams}`, { userId });
+                if (!response.success) {
+                    logger.error('thread_list API error', {
+                        userId,
+                        status: response.error.status,
+                        code: response.error.code,
+                    });
+                    return {
+                        success: false,
+                        error: response.error.message || 'Failed to list threads',
+                    };
+                }
+                const { threads, total } = response.data;
+                logger.debug('thread_list completed', {
+                    userId,
+                    threadCount: threads.length,
+                    total,
+                });
+                // Format content for display
+                const content = threads.length > 0
+                    ? threads.map((t) => {
+                        const contact = t.contactName || t.endpointValue;
+                        const msgCount = `${t.messageCount} message${t.messageCount !== 1 ? 's' : ''}`;
+                        return `[${t.channel}] ${contact} - ${msgCount}`;
+                    }).join('\n')
+                    : 'No threads found.';
+                return {
+                    success: true,
+                    data: {
+                        content,
+                        details: { threads, total, userId },
+                    },
+                };
+            }
+            catch (error) {
+                logger.error('thread_list failed', {
+                    userId,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+                return {
+                    success: false,
+                    error: error instanceof Error ? error.message : 'An unexpected error occurred while listing threads.',
+                };
+            }
+        },
+    };
+}
+// =====================================================
+// Thread Get Tool
+// =====================================================
+/** Parameters for thread_get tool */
+export const ThreadGetParamsSchema = z.object({
+    threadId: z.string().min(1, 'Thread ID is required'),
+    messageLimit: z
+        .number()
+        .int()
+        .min(1, 'Message limit must be at least 1')
+        .max(MAX_MESSAGE_LIMIT, `Message limit must be ${MAX_MESSAGE_LIMIT} or less`)
+        .default(DEFAULT_MESSAGE_LIMIT),
+});
+/**
+ * Creates the thread_get tool.
+ */
+export function createThreadGetTool(options) {
+    const { client, logger, userId } = options;
+    return {
+        name: 'thread_get',
+        description: 'Get a thread with its message history. Use to view the full conversation in a thread.',
+        parameters: ThreadGetParamsSchema,
+        async execute(params) {
+            // Validate parameters
+            const parseResult = ThreadGetParamsSchema.safeParse(params);
+            if (!parseResult.success) {
+                const errorMessage = parseResult.error.errors
+                    .map((e) => `${e.path.join('.')}: ${e.message}`)
+                    .join(', ');
+                return { success: false, error: errorMessage };
+            }
+            const { threadId, messageLimit } = parseResult.data;
+            logger.info('thread_get invoked', {
+                userId,
+                threadId,
+                messageLimit,
+            });
+            try {
+                const queryParams = new URLSearchParams();
+                queryParams.set('messageLimit', String(messageLimit));
+                const response = await client.get(`/api/threads/${threadId}?${queryParams}`, { userId });
+                if (!response.success) {
+                    logger.error('thread_get API error', {
+                        userId,
+                        threadId,
+                        status: response.error.status,
+                        code: response.error.code,
+                    });
+                    return {
+                        success: false,
+                        error: response.error.message || 'Failed to get thread',
+                    };
+                }
+                const { thread, messages } = response.data;
+                logger.debug('thread_get completed', {
+                    userId,
+                    threadId,
+                    messageCount: messages.length,
+                });
+                // Format content for display
+                const contact = thread.contactName || thread.endpointValue || 'Unknown';
+                const header = `Thread with ${contact} [${thread.channel}]`;
+                const messageContent = messages.length > 0
+                    ? messages.map((m) => {
+                        const prefix = m.direction === 'inbound' ? '←' : '→';
+                        const timestamp = new Date(m.createdAt).toLocaleString();
+                        return `${prefix} [${timestamp}] ${m.body}`;
+                    }).join('\n')
+                    : 'No messages in this thread.';
+                const content = `${header}\n\n${messageContent}`;
+                return {
+                    success: true,
+                    data: {
+                        content,
+                        details: { thread, messages, userId },
+                    },
+                };
+            }
+            catch (error) {
+                logger.error('thread_get failed', {
+                    userId,
+                    threadId,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+                return {
+                    success: false,
+                    error: error instanceof Error ? error.message : 'An unexpected error occurred while getting thread.',
+                };
+            }
+        },
+    };
+}
+//# sourceMappingURL=threads.js.map

package/dist/tools/threads.js.map

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

package/dist/tools/todos.d.ts

@@ -0,0 +1,142 @@
+/**
+ * Todo management tools implementation.
+ * Provides todo_list, todo_create, and todo_complete tools.
+ */
+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 todo_list tool */
+export declare const TodoListParamsSchema: z.ZodObject<{
+    projectId: z.ZodOptional<z.ZodString>;
+    completed: z.ZodOptional<z.ZodBoolean>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    offset: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    limit?: number | undefined;
+    completed?: boolean | undefined;
+    offset?: number | undefined;
+    projectId?: string | undefined;
+}, {
+    limit?: number | undefined;
+    completed?: boolean | undefined;
+    offset?: number | undefined;
+    projectId?: string | undefined;
+}>;
+export type TodoListParams = z.infer<typeof TodoListParamsSchema>;
+/** Todo item from API */
+export interface Todo {
+    id: string;
+    title: string;
+    completed: boolean;
+    projectId?: string;
+    dueDate?: string;
+    createdAt?: string;
+    updatedAt?: string;
+}
+/** Successful list result */
+export interface TodoListSuccess {
+    success: true;
+    data: {
+        content: string;
+        details: {
+            todos: Todo[];
+            total: number;
+            userId: string;
+        };
+    };
+}
+/** Failed result */
+export interface TodoFailure {
+    success: false;
+    error: string;
+}
+export type TodoListResult = TodoListSuccess | TodoFailure;
+/** Tool configuration */
+export interface TodoToolOptions {
+    client: ApiClient;
+    logger: Logger;
+    config: PluginConfig;
+    userId: string;
+}
+/** Tool definition */
+export interface TodoListTool {
+    name: string;
+    description: string;
+    parameters: typeof TodoListParamsSchema;
+    execute: (params: TodoListParams) => Promise<TodoListResult>;
+}
+/**
+ * Creates the todo_list tool.
+ */
+export declare function createTodoListTool(options: TodoToolOptions): TodoListTool;
+/** Parameters for todo_create tool */
+export declare const TodoCreateParamsSchema: z.ZodObject<{
+    title: z.ZodString;
+    projectId: z.ZodOptional<z.ZodString>;
+    dueDate: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    title: string;
+    projectId?: string | undefined;
+    dueDate?: string | undefined;
+}, {
+    title: string;
+    projectId?: string | undefined;
+    dueDate?: string | undefined;
+}>;
+export type TodoCreateParams = z.infer<typeof TodoCreateParamsSchema>;
+/** Successful create result */
+export interface TodoCreateSuccess {
+    success: true;
+    data: {
+        content: string;
+        details: {
+            id: string;
+            title: string;
+            userId: string;
+        };
+    };
+}
+export type TodoCreateResult = TodoCreateSuccess | TodoFailure;
+export interface TodoCreateTool {
+    name: string;
+    description: string;
+    parameters: typeof TodoCreateParamsSchema;
+    execute: (params: TodoCreateParams) => Promise<TodoCreateResult>;
+}
+/**
+ * Creates the todo_create tool.
+ */
+export declare function createTodoCreateTool(options: TodoToolOptions): TodoCreateTool;
+/** Parameters for todo_complete tool */
+export declare const TodoCompleteParamsSchema: z.ZodObject<{
+    id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+}, {
+    id: string;
+}>;
+export type TodoCompleteParams = z.infer<typeof TodoCompleteParamsSchema>;
+/** Successful complete result */
+export interface TodoCompleteSuccess {
+    success: true;
+    data: {
+        content: string;
+        details: {
+            id: string;
+            userId: string;
+        };
+    };
+}
+export type TodoCompleteResult = TodoCompleteSuccess | TodoFailure;
+export interface TodoCompleteTool {
+    name: string;
+    description: string;
+    parameters: typeof TodoCompleteParamsSchema;
+    execute: (params: TodoCompleteParams) => Promise<TodoCompleteResult>;
+}
+/**
+ * Creates the todo_complete tool.
+ */
+export declare function createTodoCompleteTool(options: TodoToolOptions): TodoCompleteTool;
+//# sourceMappingURL=todos.d.ts.map

package/dist/tools/todos.d.ts.map

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

package/dist/tools/todos.js

@@ -0,0 +1,308 @@
+/**
+ * Todo management tools implementation.
+ * Provides todo_list, todo_create, and todo_complete tools.
+ */
+import { z } from 'zod';
+/** UUID validation regex */
+const UUID_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+/** ISO 8601 date format (YYYY-MM-DD) */
+const ISO_DATE_REGEX = /^\d{4}-\d{2}-\d{2}$/;
+// ==================== todo_list ====================
+/** Parameters for todo_list tool */
+export const TodoListParamsSchema = z.object({
+    projectId: z.string().optional(),
+    completed: z.boolean().optional(),
+    limit: z.number().int().min(1).max(200).optional(),
+    offset: z.number().int().min(0).optional(),
+});
+/**
+ * Create a sanitized error message.
+ */
+function sanitizeErrorMessage(error) {
+    if (error instanceof Error) {
+        const message = error.message
+            .replace(/\b\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}\b/g, '[host]')
+            .replace(/:\d{2,5}\b/g, '')
+            .replace(/\b(?:localhost|internal[-\w]*)\b/gi, '[internal]');
+        if (message.includes('[internal]') || message.includes('[host]')) {
+            return 'Operation failed. Please try again.';
+        }
+        return message;
+    }
+    return 'An unexpected error occurred.';
+}
+/**
+ * Strip HTML tags from a string.
+ * Also removes content inside script and style tags for security.
+ */
+function stripHtml(text) {
+    return text
+        .replace(/<script\b[^<]*(?:(?!<\/script>)<[^<]*)*<\/script>/gi, '')
+        .replace(/<style\b[^<]*(?:(?!<\/style>)<[^<]*)*<\/style>/gi, '')
+        .replace(/<[^>]*>/g, '')
+        .trim();
+}
+/**
+ * Validate UUID format.
+ */
+function isValidUuid(id) {
+    return UUID_REGEX.test(id);
+}
+/**
+ * Validate ISO 8601 date format (YYYY-MM-DD).
+ */
+function isValidIsoDate(date) {
+    if (!ISO_DATE_REGEX.test(date)) {
+        return false;
+    }
+    // Also validate it's a real date
+    const parsed = new Date(date);
+    return !isNaN(parsed.getTime());
+}
+/**
+ * Creates the todo_list tool.
+ */
+export function createTodoListTool(options) {
+    const { client, logger, userId } = options;
+    return {
+        name: 'todo_list',
+        description: 'List todos. Optionally filter by project ID or completion status.',
+        parameters: TodoListParamsSchema,
+        async execute(params) {
+            const parseResult = TodoListParamsSchema.safeParse(params);
+            if (!parseResult.success) {
+                const errorMessage = parseResult.error.errors
+                    .map((e) => `${e.path.join('.')}: ${e.message}`)
+                    .join(', ');
+                return { success: false, error: errorMessage };
+            }
+            const { projectId, completed, limit = 50, offset = 0 } = parseResult.data;
+            // Validate projectId if provided
+            if (projectId && !isValidUuid(projectId)) {
+                return { success: false, error: 'Invalid projectId format. Expected UUID.' };
+            }
+            logger.info('todo_list invoked', { userId, projectId, completed, limit, offset });
+            try {
+                const queryParams = new URLSearchParams({
+                    limit: String(limit),
+                    offset: String(offset),
+                });
+                if (projectId) {
+                    queryParams.set('projectId', projectId);
+                }
+                if (completed !== undefined) {
+                    queryParams.set('completed', String(completed));
+                }
+                const response = await client.get(`/api/todos?${queryParams.toString()}`, { userId });
+                if (!response.success) {
+                    logger.error('todo_list API error', {
+                        userId,
+                        status: response.error.status,
+                        code: response.error.code,
+                    });
+                    return {
+                        success: false,
+                        error: response.error.message || 'Failed to list todos',
+                    };
+                }
+                const todos = response.data.todos ?? response.data.items ?? [];
+                const total = response.data.total ?? todos.length;
+                if (todos.length === 0) {
+                    return {
+                        success: true,
+                        data: {
+                            content: 'No todos found.',
+                            details: { todos: [], total: 0, userId },
+                        },
+                    };
+                }
+                const content = todos
+                    .map((t) => {
+                    const checkbox = t.completed ? '[x]' : '[ ]';
+                    const dueStr = t.dueDate ? ` (due: ${t.dueDate})` : '';
+                    return `- ${checkbox} ${t.title}${dueStr}`;
+                })
+                    .join('\n');
+                logger.debug('todo_list completed', { userId, count: todos.length });
+                return {
+                    success: true,
+                    data: {
+                        content,
+                        details: { todos, total, userId },
+                    },
+                };
+            }
+            catch (error) {
+                logger.error('todo_list failed', {
+                    userId,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+                return { success: false, error: sanitizeErrorMessage(error) };
+            }
+        },
+    };
+}
+// ==================== todo_create ====================
+/** Parameters for todo_create tool */
+export const TodoCreateParamsSchema = z.object({
+    title: z
+        .string()
+        .min(1, 'Todo title is required')
+        .max(500, 'Todo title must be 500 characters or less'),
+    projectId: z.string().optional(),
+    dueDate: z.string().optional(),
+});
+/**
+ * Creates the todo_create tool.
+ */
+export function createTodoCreateTool(options) {
+    const { client, logger, userId } = options;
+    return {
+        name: 'todo_create',
+        description: 'Create a new todo item. Optionally associate with a project and set a due date.',
+        parameters: TodoCreateParamsSchema,
+        async execute(params) {
+            const parseResult = TodoCreateParamsSchema.safeParse(params);
+            if (!parseResult.success) {
+                const errorMessage = parseResult.error.errors
+                    .map((e) => `${e.path.join('.')}: ${e.message}`)
+                    .join(', ');
+                return { success: false, error: errorMessage };
+            }
+            const { title, projectId, dueDate } = parseResult.data;
+            // Sanitize input
+            const sanitizedTitle = stripHtml(title);
+            if (sanitizedTitle.length === 0) {
+                return { success: false, error: 'Todo title cannot be empty after sanitization' };
+            }
+            // Validate projectId if provided
+            if (projectId && !isValidUuid(projectId)) {
+                return { success: false, error: 'Invalid projectId format. Expected UUID.' };
+            }
+            // Validate dueDate if provided
+            if (dueDate && !isValidIsoDate(dueDate)) {
+                return { success: false, error: 'Invalid date format. Expected ISO 8601 (YYYY-MM-DD).' };
+            }
+            logger.info('todo_create invoked', {
+                userId,
+                titleLength: sanitizedTitle.length,
+                hasProjectId: !!projectId,
+                hasDueDate: !!dueDate,
+            });
+            try {
+                const body = {
+                    title: sanitizedTitle,
+                };
+                if (projectId) {
+                    body.projectId = projectId;
+                }
+                if (dueDate) {
+                    body.dueDate = dueDate;
+                }
+                const response = await client.post('/api/todos', body, { userId });
+                if (!response.success) {
+                    logger.error('todo_create API error', {
+                        userId,
+                        status: response.error.status,
+                        code: response.error.code,
+                    });
+                    return {
+                        success: false,
+                        error: response.error.message || 'Failed to create todo',
+                    };
+                }
+                const newTodo = response.data;
+                logger.debug('todo_create completed', {
+                    userId,
+                    todoId: newTodo.id,
+                });
+                return {
+                    success: true,
+                    data: {
+                        content: `Created todo "${sanitizedTitle}" (ID: ${newTodo.id})`,
+                        details: {
+                            id: newTodo.id,
+                            title: sanitizedTitle,
+                            userId,
+                        },
+                    },
+                };
+            }
+            catch (error) {
+                logger.error('todo_create failed', {
+                    userId,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+                return { success: false, error: sanitizeErrorMessage(error) };
+            }
+        },
+    };
+}
+// ==================== todo_complete ====================
+/** Parameters for todo_complete tool */
+export const TodoCompleteParamsSchema = z.object({
+    id: z.string().min(1, 'Todo ID is required'),
+});
+/**
+ * Creates the todo_complete tool.
+ */
+export function createTodoCompleteTool(options) {
+    const { client, logger, userId } = options;
+    return {
+        name: 'todo_complete',
+        description: 'Mark a todo as completed. This operation is idempotent.',
+        parameters: TodoCompleteParamsSchema,
+        async execute(params) {
+            const parseResult = TodoCompleteParamsSchema.safeParse(params);
+            if (!parseResult.success) {
+                const errorMessage = parseResult.error.errors
+                    .map((e) => `${e.path.join('.')}: ${e.message}`)
+                    .join(', ');
+                return { success: false, error: errorMessage };
+            }
+            const { id } = parseResult.data;
+            // Validate UUID format
+            if (!isValidUuid(id)) {
+                return { success: false, error: 'Invalid todo ID format. Expected UUID.' };
+            }
+            logger.info('todo_complete invoked', { userId, todoId: id });
+            try {
+                const response = await client.post(`/api/todos/${id}/complete`, {}, { userId });
+                if (!response.success) {
+                    if (response.error.code === 'NOT_FOUND') {
+                        return { success: false, error: 'Todo not found.' };
+                    }
+                    logger.error('todo_complete API error', {
+                        userId,
+                        todoId: id,
+                        status: response.error.status,
+                    });
+                    return {
+                        success: false,
+                        error: response.error.message || 'Failed to complete todo',
+                    };
+                }
+                logger.debug('todo_complete completed', { userId, todoId: id });
+                return {
+                    success: true,
+                    data: {
+                        content: 'Todo marked as completed.',
+                        details: {
+                            id,
+                            userId,
+                        },
+                    },
+                };
+            }
+            catch (error) {
+                logger.error('todo_complete failed', {
+                    userId,
+                    todoId: id,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+                return { success: false, error: sanitizeErrorMessage(error) };
+            }
+        },
+    };
+}
+//# sourceMappingURL=todos.js.map