mcp-server-rocketchat-threads 1.0.0

package/dist/tools/base.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Base Tool Definitions
+ * Common types and utilities for MCP tools
+ */
+import { z } from 'zod';
+import { ErrorCode } from '../utils/error-handler.js';
+/**
+ * Tool parameter schemas
+ */
+export declare const CommonSchemas: {
+    roomId: z.ZodString;
+    roomName: z.ZodString;
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+    timeRange: z.ZodString;
+    query: z.ZodString;
+    threadId: z.ZodString;
+    userId: z.ZodString;
+    username: z.ZodString;
+};
+/**
+ * Tool result interface matching MCP specification
+ */
+export interface ToolResult {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}
+/**
+ * Create a successful tool result
+ */
+export declare function createToolResult(data: unknown): ToolResult;
+/**
+ * Create an error tool result
+ */
+export declare function createErrorResult(code: string, message: string, details?: string, suggestion?: string): ToolResult;
+/**
+ * Create an error result from an exception
+ * Automatically extracts message and details from error objects
+ */
+export declare function createErrorResultFromException(code: ErrorCode, defaultMessage: string, error: unknown): ToolResult;
+/**
+ * Wraps an async handler with standardized error handling
+ * Reduces boilerplate try-catch blocks in tool handlers
+ */
+export declare function wrapHandler<TParams>(handler: (params: TParams) => Promise<ToolResult>, errorCode?: ErrorCode, errorMessage?: string): (params: TParams) => Promise<ToolResult>;
+export { ErrorCodes } from '../utils/error-handler.js';
+export type { ErrorCode } from '../utils/error-handler.js';
+/**
+ * Tool definition interface with generic type parameter for type-safe handlers
+ * @template T - The type of parameters accepted by the handler
+ */
+export interface ToolDefinition<T = unknown> {
+    name: string;
+    description: string;
+    inputSchema: z.ZodType<T>;
+    handler: (params: T) => Promise<ToolResult>;
+}
+/**
+ * Helper function to create a type-safe tool definition
+ * Infers the parameter type from the Zod schema
+ */
+export declare function defineTool<T extends z.ZodType>(name: string, description: string, inputSchema: T, handler: (params: z.infer<T>) => Promise<ToolResult>): ToolDefinition<z.infer<T>>;
+/**
+ * Registry of all tools
+ */
+export declare class ToolRegistry {
+    private tools;
+    register<T>(tool: ToolDefinition<T>): void;
+    get(name: string): ToolDefinition<unknown> | undefined;
+    list(): ToolDefinition<unknown>[];
+    getSchemas(): Array<{
+        name: string;
+        description: string;
+        inputSchema: unknown;
+    }>;
+}
+/**
+ * Convert Zod schema to JSON Schema for MCP
+ */
+export declare function zodToJsonSchema(schema: z.ZodType<unknown>): Record<string, unknown>;
+export declare const toolRegistry: ToolRegistry;
+//# sourceMappingURL=base.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/tools/base.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACH,SAAS,EAKZ,MAAM,2BAA2B,CAAC;AAEnC;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;CAqBzB,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,UAAU;IACvB,OAAO,EAAE,KAAK,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,UAAU,CAO1D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC7B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,GACpB,UAAU,CAgBZ;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,CAC1C,IAAI,EAAE,SAAS,EACf,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,OAAO,GACf,UAAU,CAIZ;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAC/B,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC,UAAU,CAAC,EACjD,SAAS,GAAE,SAAgC,EAC3C,YAAY,GAAE,MAA2B,GAC1C,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC,UAAU,CAAC,CAQ1C;AAGD,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,YAAY,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAE3D;;;GAGG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,OAAO;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAC1B,OAAO,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;CAC/C;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAC1C,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,CAAC,EACd,OAAO,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,UAAU,CAAC,GACrD,cAAc,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAO5B;AAED;;GAEG;AACH,qBAAa,YAAY;IACrB,OAAO,CAAC,KAAK,CAAmD;IAEhE,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,IAAI;IAK1C,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAAC,OAAO,CAAC,GAAG,SAAS;IAItD,IAAI,IAAI,cAAc,CAAC,OAAO,CAAC,EAAE;IAIjC,UAAU,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,OAAO,CAAA;KAAE,CAAC;CAOnF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA4DnF;AAGD,eAAO,MAAM,YAAY,cAAqB,CAAC"}

package/dist/tools/base.js

@@ -0,0 +1,184 @@
+"use strict";
+/**
+ * Base Tool Definitions
+ * Common types and utilities for MCP tools
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toolRegistry = exports.ToolRegistry = exports.ErrorCodes = exports.CommonSchemas = void 0;
+exports.createToolResult = createToolResult;
+exports.createErrorResult = createErrorResult;
+exports.createErrorResultFromException = createErrorResultFromException;
+exports.wrapHandler = wrapHandler;
+exports.defineTool = defineTool;
+exports.zodToJsonSchema = zodToJsonSchema;
+const zod_1 = require("zod");
+const error_handler_js_1 = require("../utils/error-handler.js");
+/**
+ * Tool parameter schemas
+ */
+exports.CommonSchemas = {
+    // Room/Channel identification
+    roomId: zod_1.z.string().describe('Unique room/channel ID (e.g., "GENERAL", "x3JG6uXJgE7YNHR3S")'),
+    roomName: zod_1.z.string().describe('Room/channel name for human-readable lookup'),
+    // Pagination
+    limit: zod_1.z.number().min(1).max(100).default(50).describe('Maximum number of items to return (1-100, default: 50)'),
+    offset: zod_1.z.number().min(0).default(0).describe('Number of items to skip for pagination'),
+    // Time expressions
+    timeRange: zod_1.z.string().describe('Time range: relative (1d, 7d, 1w, 1m) or ISO date (2024-01-15) or Unix timestamp'),
+    // Search
+    query: zod_1.z.string().describe('Search query text'),
+    // Thread
+    threadId: zod_1.z.string().describe('Thread parent message ID (tmid)'),
+    // User
+    userId: zod_1.z.string().describe('User ID'),
+    username: zod_1.z.string().describe('Username (without @)')
+};
+/**
+ * Create a successful tool result
+ */
+function createToolResult(data) {
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify(data, null, 2)
+            }]
+    };
+}
+/**
+ * Create an error tool result
+ */
+function createErrorResult(code, message, details, suggestion) {
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify({
+                    success: false,
+                    error: {
+                        code,
+                        message,
+                        details,
+                        suggestion: suggestion || error_handler_js_1.ErrorSuggestions[code]
+                    }
+                }, null, 2)
+            }],
+        isError: true
+    };
+}
+/**
+ * Create an error result from an exception
+ * Automatically extracts message and details from error objects
+ */
+function createErrorResultFromException(code, defaultMessage, error) {
+    const message = (0, error_handler_js_1.extractErrorMessage)(error);
+    const details = (0, error_handler_js_1.extractErrorDetails)(error);
+    return createErrorResult(code, message || defaultMessage, details);
+}
+/**
+ * Wraps an async handler with standardized error handling
+ * Reduces boilerplate try-catch blocks in tool handlers
+ */
+function wrapHandler(handler, errorCode = error_handler_js_1.ErrorCodes.API_ERROR, errorMessage = 'Operation failed') {
+    return async (params) => {
+        try {
+            return await handler(params);
+        }
+        catch (error) {
+            return createErrorResultFromException(errorCode, errorMessage, error);
+        }
+    };
+}
+// Re-export error codes for convenience
+var error_handler_js_2 = require("../utils/error-handler.js");
+Object.defineProperty(exports, "ErrorCodes", { enumerable: true, get: function () { return error_handler_js_2.ErrorCodes; } });
+/**
+ * Helper function to create a type-safe tool definition
+ * Infers the parameter type from the Zod schema
+ */
+function defineTool(name, description, inputSchema, handler) {
+    return {
+        name,
+        description,
+        inputSchema,
+        handler
+    };
+}
+/**
+ * Registry of all tools
+ */
+class ToolRegistry {
+    tools = new Map();
+    register(tool) {
+        // Store as ToolDefinition<unknown> for the registry
+        this.tools.set(tool.name, tool);
+    }
+    get(name) {
+        return this.tools.get(name);
+    }
+    list() {
+        return Array.from(this.tools.values());
+    }
+    getSchemas() {
+        return this.list().map(tool => ({
+            name: tool.name,
+            description: tool.description,
+            inputSchema: zodToJsonSchema(tool.inputSchema)
+        }));
+    }
+}
+exports.ToolRegistry = ToolRegistry;
+/**
+ * Convert Zod schema to JSON Schema for MCP
+ */
+function zodToJsonSchema(schema) {
+    // Basic implementation - in production, use zod-to-json-schema library
+    if (schema instanceof zod_1.z.ZodObject) {
+        const shape = schema.shape;
+        const properties = {};
+        const required = [];
+        for (const [key, value] of Object.entries(shape)) {
+            const zodValue = value;
+            properties[key] = zodToJsonSchema(zodValue);
+            // Check if required (not optional)
+            if (!(zodValue instanceof zod_1.z.ZodOptional) && !(zodValue instanceof zod_1.z.ZodDefault)) {
+                required.push(key);
+            }
+        }
+        return {
+            type: 'object',
+            properties,
+            required: required.length > 0 ? required : undefined
+        };
+    }
+    if (schema instanceof zod_1.z.ZodString) {
+        return { type: 'string', description: schema.description };
+    }
+    if (schema instanceof zod_1.z.ZodNumber) {
+        return { type: 'number', description: schema.description };
+    }
+    if (schema instanceof zod_1.z.ZodBoolean) {
+        return { type: 'boolean', description: schema.description };
+    }
+    if (schema instanceof zod_1.z.ZodOptional) {
+        return zodToJsonSchema(schema.unwrap());
+    }
+    if (schema instanceof zod_1.z.ZodDefault) {
+        const inner = zodToJsonSchema(schema.removeDefault());
+        return { ...inner, default: schema._def.defaultValue() };
+    }
+    if (schema instanceof zod_1.z.ZodArray) {
+        return {
+            type: 'array',
+            items: zodToJsonSchema(schema.element)
+        };
+    }
+    if (schema instanceof zod_1.z.ZodEnum) {
+        return {
+            type: 'string',
+            enum: schema.options
+        };
+    }
+    return { type: 'string' };
+}
+// Global tool registry
+exports.toolRegistry = new ToolRegistry();
+//# sourceMappingURL=base.js.map

package/dist/tools/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/tools/base.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAmDH,4CAOC;AAKD,8CAqBC;AAMD,wEAQC;AAMD,kCAYC;AAqBD,gCAYC;AAiCD,0CA4DC;AAhPD,6BAAwB;AACxB,gEAMmC;AAEnC;;GAEG;AACU,QAAA,aAAa,GAAG;IACzB,8BAA8B;IAC9B,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+DAA+D,CAAC;IAC5F,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;IAE5E,aAAa;IACb,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,wDAAwD,CAAC;IAChH,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,wCAAwC,CAAC;IAEvF,mBAAmB;IACnB,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kFAAkF,CAAC;IAElH,SAAS;IACT,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;IAE/C,SAAS;IACT,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;IAEhE,OAAO;IACP,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC;IACtC,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;CACxD,CAAC;AAaF;;GAEG;AACH,SAAgB,gBAAgB,CAAC,IAAa;IAC1C,OAAO;QACH,OAAO,EAAE,CAAC;gBACN,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;aACtC,CAAC;KACL,CAAC;AACN,CAAC;AAED;;GAEG;AACH,SAAgB,iBAAiB,CAC7B,IAAY,EACZ,OAAe,EACf,OAAgB,EAChB,UAAmB;IAEnB,OAAO;QACH,OAAO,EAAE,CAAC;gBACN,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACjB,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE;wBACH,IAAI;wBACJ,OAAO;wBACP,OAAO;wBACP,UAAU,EAAE,UAAU,IAAI,mCAAgB,CAAC,IAAiB,CAAC;qBAChE;iBACJ,EAAE,IAAI,EAAE,CAAC,CAAC;aACd,CAAC;QACF,OAAO,EAAE,IAAI;KAChB,CAAC;AACN,CAAC;AAED;;;GAGG;AACH,SAAgB,8BAA8B,CAC1C,IAAe,EACf,cAAsB,EACtB,KAAc;IAEd,MAAM,OAAO,GAAG,IAAA,sCAAmB,EAAC,KAAK,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,IAAA,sCAAmB,EAAC,KAAK,CAAC,CAAC;IAC3C,OAAO,iBAAiB,CAAC,IAAI,EAAE,OAAO,IAAI,cAAc,EAAE,OAAO,CAAC,CAAC;AACvE,CAAC;AAED;;;GAGG;AACH,SAAgB,WAAW,CACvB,OAAiD,EACjD,YAAuB,6BAAU,CAAC,SAAS,EAC3C,eAAuB,kBAAkB;IAEzC,OAAO,KAAK,EAAE,MAAe,EAAuB,EAAE;QAClD,IAAI,CAAC;YACD,OAAO,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;QACjC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,OAAO,8BAA8B,CAAC,SAAS,EAAE,YAAY,EAAE,KAAK,CAAC,CAAC;QAC1E,CAAC;IACL,CAAC,CAAC;AACN,CAAC;AAED,wCAAwC;AACxC,8DAAuD;AAA9C,8GAAA,UAAU,OAAA;AAcnB;;;GAGG;AACH,SAAgB,UAAU,CACtB,IAAY,EACZ,WAAmB,EACnB,WAAc,EACd,OAAoD;IAEpD,OAAO;QACH,IAAI;QACJ,WAAW;QACX,WAAW;QACX,OAAO;KACV,CAAC;AACN,CAAC;AAED;;GAEG;AACH,MAAa,YAAY;IACb,KAAK,GAAyC,IAAI,GAAG,EAAE,CAAC;IAEhE,QAAQ,CAAI,IAAuB;QAC/B,oDAAoD;QACpD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAA+B,CAAC,CAAC;IAC/D,CAAC;IAED,GAAG,CAAC,IAAY;QACZ,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,IAAI;QACA,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,UAAU;QACN,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC5B,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,WAAW,EAAE,eAAe,CAAC,IAAI,CAAC,WAAW,CAAC;SACjD,CAAC,CAAC,CAAC;IACR,CAAC;CACJ;AAvBD,oCAuBC;AAED;;GAEG;AACH,SAAgB,eAAe,CAAC,MAA0B;IACtD,uEAAuE;IACvE,IAAI,MAAM,YAAY,OAAC,CAAC,SAAS,EAAE,CAAC;QAChC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC3B,MAAM,UAAU,GAA4B,EAAE,CAAC;QAC/C,MAAM,QAAQ,GAAa,EAAE,CAAC;QAE9B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/C,MAAM,QAAQ,GAAG,KAA2B,CAAC;YAC7C,UAAU,CAAC,GAAG,CAAC,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;YAE5C,mCAAmC;YACnC,IAAI,CAAC,CAAC,QAAQ,YAAY,OAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,QAAQ,YAAY,OAAC,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC9E,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACvB,CAAC;QACL,CAAC;QAED,OAAO;YACH,IAAI,EAAE,QAAQ;YACd,UAAU;YACV,QAAQ,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;SACvD,CAAC;IACN,CAAC;IAED,IAAI,MAAM,YAAY,OAAC,CAAC,SAAS,EAAE,CAAC;QAChC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC;IAC/D,CAAC;IAED,IAAI,MAAM,YAAY,OAAC,CAAC,SAAS,EAAE,CAAC;QAChC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC;IAC/D,CAAC;IAED,IAAI,MAAM,YAAY,OAAC,CAAC,UAAU,EAAE,CAAC;QACjC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC;IAChE,CAAC;IAED,IAAI,MAAM,YAAY,OAAC,CAAC,WAAW,EAAE,CAAC;QAClC,OAAO,eAAe,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,IAAI,MAAM,YAAY,OAAC,CAAC,UAAU,EAAE,CAAC;QACjC,MAAM,KAAK,GAAG,eAAe,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC;QACtD,OAAO,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,CAAC;IAC7D,CAAC;IAED,IAAI,MAAM,YAAY,OAAC,CAAC,QAAQ,EAAE,CAAC;QAC/B,OAAO;YACH,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,eAAe,CAAC,MAAM,CAAC,OAAO,CAAC;SACzC,CAAC;IACN,CAAC;IAED,IAAI,MAAM,YAAY,OAAC,CAAC,OAAO,EAAE,CAAC;QAC9B,OAAO;YACH,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,MAAM,CAAC,OAAO;SACvB,CAAC;IACN,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AAC9B,CAAC;AAED,uBAAuB;AACV,QAAA,YAAY,GAAG,IAAI,YAAY,EAAE,CAAC"}

package/dist/tools/channel-tools.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Channel Tools
+ * Tools for listing and searching channels
+ */
+export declare const listChannelsTool: import("./base.js").ToolDefinition<{
+    offset?: number | undefined;
+    type?: "all" | "joined" | undefined;
+    limit?: number | undefined;
+}>;
+export declare const searchChannelsTool: import("./base.js").ToolDefinition<{
+    query: string;
+    limit?: number | undefined;
+}>;
+export declare const getChannelInfoTool: import("./base.js").ToolDefinition<{
+    roomId?: string | undefined;
+    roomName?: string | undefined;
+}>;
+//# sourceMappingURL=channel-tools.d.ts.map

package/dist/tools/channel-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-tools.d.ts","sourceRoot":"","sources":["../../src/tools/channel-tools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA6BH,eAAO,MAAM,gBAAgB;;;;EAoD5B,CAAC;AAaF,eAAO,MAAM,kBAAkB;;;EAgC9B,CAAC;AAaF,eAAO,MAAM,kBAAkB;;;EA6C9B,CAAC"}

package/dist/tools/channel-tools.js

@@ -0,0 +1,151 @@
+"use strict";
+/**
+ * Channel Tools
+ * Tools for listing and searching channels
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getChannelInfoTool = exports.searchChannelsTool = exports.listChannelsTool = void 0;
+const zod_1 = require("zod");
+const client_js_1 = require("../api/client.js");
+const message_formatter_js_1 = require("../formatters/message-formatter.js");
+const response_builder_js_1 = require("../formatters/response-builder.js");
+const token_counter_js_1 = require("../utils/token-counter.js");
+const base_js_1 = require("./base.js");
+/**
+ * rocketchat_list_channels
+ * List all accessible channels with pagination
+ */
+const listChannelsSchema = zod_1.z.object({
+    limit: zod_1.z.number().min(1).max(100).default(50).optional()
+        .describe('Maximum number of channels to return (1-100, default: 50)'),
+    offset: zod_1.z.number().min(0).default(0).optional()
+        .describe('Number of channels to skip for pagination'),
+    type: zod_1.z.enum(['all', 'joined']).default('joined').optional()
+        .describe('Filter: "all" for all public channels, "joined" for only joined channels')
+});
+exports.listChannelsTool = (0, base_js_1.defineTool)('rocketchat_list_channels', `List all accessible Rocket.Chat channels.
+
+**START HERE** - Use this tool first to discover available channels and get their IDs.
+
+Returns channel information including:
+- Channel ID and name (use ID for other API calls)
+- Type (public/private/direct)
+- Member count and message count
+- Topic and description
+- Last activity timestamp
+
+**Typical Workflow:**
+1. rocketchat_list_channels → Get channel IDs
+2. rocketchat_get_messages or rocketchat_list_threads → Read content
+3. rocketchat_search_messages or rocketchat_search_threads → Find specific content
+
+**Performance Tips:**
+- Default "joined" type is faster than "all"
+- Use pagination (offset) for large channel lists
+
+**No special requirements** - Works without OpenSearch.
+
+Examples:
+- List joined channels: {}
+- List all public channels: { "type": "all" }
+- Paginate results: { "limit": 20, "offset": 40 }`, listChannelsSchema, async (params) => {
+    try {
+        const client = (0, client_js_1.getClient)();
+        const limit = params.limit || 50;
+        const offset = params.offset || 0;
+        const response = params.type === 'all'
+            ? await client.listChannels({ count: limit, offset })
+            : await client.listJoinedChannels({ count: limit, offset });
+        if (!response.success) {
+            return (0, base_js_1.createErrorResult)(base_js_1.ErrorCodes.API_ERROR, 'Failed to list channels');
+        }
+        const formatted = (0, message_formatter_js_1.formatChannels)(response.channels);
+        const { items, truncated } = token_counter_js_1.TokenCounter.truncateToFit(formatted);
+        const result = (0, response_builder_js_1.buildPaginatedResponse)(items, response.total, offset, truncated);
+        return (0, base_js_1.createToolResult)(result);
+    }
+    catch (error) {
+        return (0, base_js_1.createErrorResultFromException)(base_js_1.ErrorCodes.API_ERROR, 'Failed to list channels', error);
+    }
+});
+/**
+ * rocketchat_search_channels
+ * Search channels by name or topic
+ */
+const searchChannelsSchema = zod_1.z.object({
+    query: zod_1.z.string().min(1)
+        .describe('Search query to match against channel names and topics'),
+    limit: zod_1.z.number().min(1).max(50).default(20).optional()
+        .describe('Maximum number of results (1-50, default: 20)')
+});
+exports.searchChannelsTool = (0, base_js_1.defineTool)('rocketchat_search_channels', `Search for Rocket.Chat channels by name or topic.
+
+Use this to find specific channels when you know part of the name.
+
+Examples:
+- Find project channels: { "query": "project" }
+- Find channels by topic: { "query": "support" }`, searchChannelsSchema, async (params) => {
+    try {
+        const client = (0, client_js_1.getClient)();
+        const response = await client.searchChannels(params.query);
+        if (!response.success) {
+            return (0, base_js_1.createErrorResult)(base_js_1.ErrorCodes.API_ERROR, 'Failed to search channels');
+        }
+        const formatted = (0, message_formatter_js_1.formatChannels)(response.channels);
+        const limited = formatted.slice(0, params.limit || 20);
+        const result = (0, response_builder_js_1.buildSuccessResponse)(limited, {
+            count: limited.length,
+            total: response.channels.length
+        });
+        return (0, base_js_1.createToolResult)(result);
+    }
+    catch (error) {
+        return (0, base_js_1.createErrorResultFromException)(base_js_1.ErrorCodes.API_ERROR, 'Failed to search channels', error);
+    }
+});
+/**
+ * rocketchat_get_channel_info
+ * Get detailed information about a specific channel
+ */
+const getChannelInfoSchema = zod_1.z.object({
+    roomId: zod_1.z.string().optional()
+        .describe('Channel ID (provide either roomId or roomName)'),
+    roomName: zod_1.z.string().optional()
+        .describe('Channel name (provide either roomId or roomName)')
+});
+exports.getChannelInfoTool = (0, base_js_1.defineTool)('rocketchat_get_channel_info', `Get detailed information about a specific Rocket.Chat channel.
+
+Returns:
+- Channel ID, name, and display name
+- Type (public/private/direct/livechat)
+- Member and message counts
+- Topic, description, and announcement
+- Read-only status
+- Last activity timestamp
+
+Examples:
+- By ID: { "roomId": "GENERAL" }
+- By name: { "roomName": "general" }`, getChannelInfoSchema, async (params) => {
+    if (!params.roomId && !params.roomName) {
+        return (0, base_js_1.createErrorResult)(base_js_1.ErrorCodes.VALIDATION_ERROR, 'Missing room identifier', 'Either roomId or roomName must be provided');
+    }
+    try {
+        const client = (0, client_js_1.getClient)();
+        const response = await client.getChannelInfo(params.roomId, params.roomName);
+        if (!response.success) {
+            const identifier = params.roomId || params.roomName || '';
+            return (0, base_js_1.createErrorResult)(base_js_1.ErrorCodes.NOT_FOUND, 'Channel not found', `No channel found with identifier "${identifier}"`);
+        }
+        const formatted = (0, message_formatter_js_1.formatChannels)([response.channel])[0];
+        const result = (0, response_builder_js_1.buildSuccessResponse)(formatted);
+        return (0, base_js_1.createToolResult)(result);
+    }
+    catch (error) {
+        return (0, base_js_1.createErrorResultFromException)(base_js_1.ErrorCodes.API_ERROR, 'Failed to get channel info', error);
+    }
+});
+// Register tools
+base_js_1.toolRegistry.register(exports.listChannelsTool);
+base_js_1.toolRegistry.register(exports.searchChannelsTool);
+base_js_1.toolRegistry.register(exports.getChannelInfoTool);
+//# sourceMappingURL=channel-tools.js.map

package/dist/tools/channel-tools.js.map

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

package/dist/tools/handler-utils.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Handler Utilities
+ * Common patterns and utilities for tool handlers to reduce code duplication
+ */
+import { ToolResult } from './base.js';
+/**
+ * Common pagination parameters
+ */
+export interface PaginationParams {
+    limit?: number;
+    offset?: number;
+}
+/**
+ * Default pagination values
+ */
+export declare const DEFAULT_PAGINATION: {
+    readonly limit: 50;
+    readonly offset: 0;
+    readonly maxLimit: 100;
+    readonly minLimit: 1;
+};
+/**
+ * Extract pagination values with defaults
+ */
+export declare function extractPagination(params: PaginationParams): {
+    limit: number;
+    offset: number;
+};
+/**
+ * Process a paginated list response with token truncation
+ */
+export declare function processPaginatedResponse<T>(items: T[], total: number, offset: number): ToolResult;
+/**
+ * Process a single item response
+ */
+export declare function processSingleResponse<T>(item: T): ToolResult;
+/**
+ * Process a success response with metadata
+ */
+export declare function processSuccessResponse<T>(data: T, metadata?: {
+    count?: number;
+    total?: number;
+    truncated?: boolean;
+}): ToolResult;
+/**
+ * Create not found error for common resources
+ */
+export declare function createNotFoundError(resource: string, identifier: string): ToolResult;
+/**
+ * Create validation error for missing required parameters
+ */
+export declare function createValidationError(requirement: string, details?: string): ToolResult;
+/**
+ * Helper to require at least one of multiple optional parameters
+ */
+export declare function requireOneOf(params: Record<string, unknown>, keys: string[]): {
+    valid: boolean;
+    error?: ToolResult;
+};
+/**
+ * Format items with truncation and return result
+ */
+export declare function formatAndTruncate<T, R>(items: T[], formatter: (items: T[]) => R[], total: number, offset: number): ToolResult;
+/**
+ * Check API response success and handle error
+ */
+export declare function checkApiSuccess(response: {
+    success: boolean;
+}, errorMessage: string): {
+    ok: true;
+} | {
+    ok: false;
+    error: ToolResult;
+};
+//# sourceMappingURL=handler-utils.d.ts.map

package/dist/tools/handler-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler-utils.d.ts","sourceRoot":"","sources":["../../src/tools/handler-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAmD,UAAU,EAAE,MAAM,WAAW,CAAC;AAExF;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;CAKrB,CAAC;AAEX;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAQ7F;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,EACtC,KAAK,EAAE,CAAC,EAAE,EACV,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACf,UAAU,CAIZ;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,UAAU,CAG5D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,EACpC,IAAI,EAAE,CAAC,EACP,QAAQ,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GACnE,UAAU,CAGZ;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,UAAU,CAMpF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,UAAU,CAMvF;AAED;;GAEG;AACH,wBAAgB,YAAY,CACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,IAAI,EAAE,MAAM,EAAE,GACf;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,UAAU,CAAA;CAAE,CAexC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,CAAC,EAClC,KAAK,EAAE,CAAC,EAAE,EACV,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,EAC9B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACf,UAAU,CAGZ;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC3B,QAAQ,EAAE;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,EAC9B,YAAY,EAAE,MAAM,GACrB;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,CAQjD"}

package/dist/tools/handler-utils.js

@@ -0,0 +1,105 @@
+"use strict";
+/**
+ * Handler Utilities
+ * Common patterns and utilities for tool handlers to reduce code duplication
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_PAGINATION = void 0;
+exports.extractPagination = extractPagination;
+exports.processPaginatedResponse = processPaginatedResponse;
+exports.processSingleResponse = processSingleResponse;
+exports.processSuccessResponse = processSuccessResponse;
+exports.createNotFoundError = createNotFoundError;
+exports.createValidationError = createValidationError;
+exports.requireOneOf = requireOneOf;
+exports.formatAndTruncate = formatAndTruncate;
+exports.checkApiSuccess = checkApiSuccess;
+const token_counter_js_1 = require("../utils/token-counter.js");
+const response_builder_js_1 = require("../formatters/response-builder.js");
+const base_js_1 = require("./base.js");
+/**
+ * Default pagination values
+ */
+exports.DEFAULT_PAGINATION = {
+    limit: 50,
+    offset: 0,
+    maxLimit: 100,
+    minLimit: 1
+};
+/**
+ * Extract pagination values with defaults
+ */
+function extractPagination(params) {
+    return {
+        limit: Math.min(Math.max(params.limit || exports.DEFAULT_PAGINATION.limit, exports.DEFAULT_PAGINATION.minLimit), exports.DEFAULT_PAGINATION.maxLimit),
+        offset: Math.max(params.offset || exports.DEFAULT_PAGINATION.offset, 0)
+    };
+}
+/**
+ * Process a paginated list response with token truncation
+ */
+function processPaginatedResponse(items, total, offset) {
+    const { items: truncatedItems, truncated } = token_counter_js_1.TokenCounter.truncateToFit(items);
+    const result = (0, response_builder_js_1.buildPaginatedResponse)(truncatedItems, total, offset, truncated);
+    return (0, base_js_1.createToolResult)(result);
+}
+/**
+ * Process a single item response
+ */
+function processSingleResponse(item) {
+    const result = (0, response_builder_js_1.buildSuccessResponse)(item);
+    return (0, base_js_1.createToolResult)(result);
+}
+/**
+ * Process a success response with metadata
+ */
+function processSuccessResponse(data, metadata) {
+    const result = (0, response_builder_js_1.buildSuccessResponse)(data, metadata);
+    return (0, base_js_1.createToolResult)(result);
+}
+/**
+ * Create not found error for common resources
+ */
+function createNotFoundError(resource, identifier) {
+    return (0, base_js_1.createErrorResult)(base_js_1.ErrorCodes.NOT_FOUND, `${resource} not found`, `No ${resource} found with identifier "${identifier}"`);
+}
+/**
+ * Create validation error for missing required parameters
+ */
+function createValidationError(requirement, details) {
+    return (0, base_js_1.createErrorResult)(base_js_1.ErrorCodes.VALIDATION_ERROR, requirement, details);
+}
+/**
+ * Helper to require at least one of multiple optional parameters
+ */
+function requireOneOf(params, keys) {
+    const hasValue = keys.some(key => params[key] !== undefined && params[key] !== null && params[key] !== '');
+    if (!hasValue) {
+        const keysStr = keys.join(' or ');
+        return {
+            valid: false,
+            error: createValidationError(`Missing required parameter`, `Either ${keysStr} must be provided`)
+        };
+    }
+    return { valid: true };
+}
+/**
+ * Format items with truncation and return result
+ */
+function formatAndTruncate(items, formatter, total, offset) {
+    const formatted = formatter(items);
+    return processPaginatedResponse(formatted, total, offset);
+}
+/**
+ * Check API response success and handle error
+ */
+function checkApiSuccess(response, errorMessage) {
+    if (!response.success) {
+        return {
+            ok: false,
+            error: (0, base_js_1.createErrorResult)(base_js_1.ErrorCodes.API_ERROR, errorMessage)
+        };
+    }
+    return { ok: true };
+}
+//# sourceMappingURL=handler-utils.js.map

package/dist/tools/handler-utils.js.map

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