@crypto512/jicon-mcp 0.6.1 → 0.7.1

package/dist/utils/buffer-tools.js

@@ -0,0 +1,312 @@
+/**
+ * Buffer management tools for MCP Server
+ *
+ * Provides tools to retrieve chunks from buffered content,
+ * list active buffers, clear buffers, search content, and edit content.
+ */
+import { z } from "zod";
+import { contentBuffer } from "./content-buffer.js";
+import { formatSuccess, formatError, getMaxOutputSize } from "./response-formatter.js";
+/**
+ * Format grep results as text output similar to grep CLI
+ */
+function formatGrepOutput(result, showLineNumbers) {
+    const lines = [];
+    for (let i = 0; i < result.matches.length; i++) {
+        const match = result.matches[i];
+        // Add separator between matches (except for first)
+        if (i > 0) {
+            lines.push("--");
+        }
+        // Before context
+        for (let j = 0; j < match.before.length; j++) {
+            const lineNum = match.lineNumber - match.before.length + j;
+            if (showLineNumbers) {
+                lines.push(`${lineNum}-${match.before[j]}`);
+            }
+            else {
+                lines.push(match.before[j]);
+            }
+        }
+        // Matched line
+        if (showLineNumbers) {
+            lines.push(`${match.lineNumber}:${match.line}`);
+        }
+        else {
+            lines.push(match.line);
+        }
+        // After context
+        for (let j = 0; j < match.after.length; j++) {
+            const lineNum = match.lineNumber + 1 + j;
+            if (showLineNumbers) {
+                lines.push(`${lineNum}-${match.after[j]}`);
+            }
+            else {
+                lines.push(match.after[j]);
+            }
+        }
+    }
+    return lines.join("\n");
+}
+export function createBufferTools() {
+    return {
+        buffer_get_chunk: {
+            description: `Retrieve a chunk of buffered content by buffer ID. Use after receiving a bufferId from tools. Returns content, offset, totalSize, and hasMore flag.`,
+            inputSchema: z.object({
+                bufferId: z.string().describe("Buffer ID from previous tool response"),
+                offset: z
+                    .number()
+                    .optional()
+                    .default(0)
+                    .describe("Character offset to start from (default: 0)"),
+                limit: z
+                    .number()
+                    .optional()
+                    .default(5000)
+                    .describe("Maximum characters to return (default: 5000)"),
+            }),
+            handler: async (args) => {
+                try {
+                    const chunk = contentBuffer.getChunk(args.bufferId, args.offset ?? 0, args.limit ?? 5000);
+                    if (!chunk) {
+                        return formatError({
+                            error: true,
+                            message: `Buffer not found or expired: ${args.bufferId}`,
+                            statusCode: 404,
+                        });
+                    }
+                    return formatSuccess({
+                        bufferId: chunk.bufferId,
+                        content: chunk.chunk,
+                        offset: chunk.offset,
+                        limit: chunk.limit,
+                        totalSize: chunk.totalSize,
+                        hasMore: chunk.hasMore,
+                        metadata: chunk.metadata,
+                    });
+                }
+                catch (error) {
+                    return formatError(error instanceof Error ? error : new Error(String(error)));
+                }
+            },
+        },
+        buffer_list: {
+            description: `List all active buffers with metadata. Buffers expire after 10 minutes.`,
+            inputSchema: z.object({}),
+            handler: async () => {
+                try {
+                    const buffers = contentBuffer.list();
+                    return formatSuccess({
+                        count: buffers.length,
+                        buffers: buffers.map((b) => ({
+                            ...b,
+                            createdAt: new Date(b.createdAt).toISOString(),
+                            expiresAt: new Date(b.expiresAt).toISOString(),
+                        })),
+                    });
+                }
+                catch (error) {
+                    return formatError(error instanceof Error ? error : new Error(String(error)));
+                }
+            },
+        },
+        buffer_clear: {
+            description: `Clear a specific buffer or all buffers. Omit bufferId to clear all.`,
+            inputSchema: z.object({
+                bufferId: z
+                    .string()
+                    .optional()
+                    .describe("Buffer ID to clear, or omit to clear all buffers"),
+            }),
+            handler: async (args) => {
+                try {
+                    if (args.bufferId) {
+                        const deleted = contentBuffer.clear(args.bufferId);
+                        if (!deleted) {
+                            return formatError({
+                                error: true,
+                                message: `Buffer not found: ${args.bufferId}`,
+                                statusCode: 404,
+                            });
+                        }
+                        return formatSuccess({
+                            message: `Buffer ${args.bufferId} cleared`,
+                            cleared: 1,
+                        });
+                    }
+                    const count = contentBuffer.size();
+                    contentBuffer.clear();
+                    return formatSuccess({
+                        message: "All buffers cleared",
+                        cleared: count,
+                    });
+                }
+                catch (error) {
+                    return formatError(error instanceof Error ? error : new Error(String(error)));
+                }
+            },
+        },
+        buffer_grep: {
+            description: `Search buffered content for patterns. Supports regex, context lines (-A/-B/-C), and case-insensitive (-i). Large results are buffered.`,
+            inputSchema: z.object({
+                bufferId: z.string().describe("Buffer ID from previous tool response"),
+                pattern: z.string().describe("Regex pattern to search for"),
+                "-A": z
+                    .number()
+                    .optional()
+                    .describe("Number of lines to show after each match"),
+                "-B": z
+                    .number()
+                    .optional()
+                    .describe("Number of lines to show before each match"),
+                "-C": z
+                    .number()
+                    .optional()
+                    .describe("Number of lines to show before AND after each match (overrides -A/-B)"),
+                "-i": z
+                    .boolean()
+                    .optional()
+                    .describe("Case insensitive search"),
+                "-n": z
+                    .boolean()
+                    .optional()
+                    .default(true)
+                    .describe("Show line numbers in output (default: true)"),
+                output_mode: z
+                    .enum(["content", "count"])
+                    .optional()
+                    .default("content")
+                    .describe("Output mode: 'content' shows matching lines, 'count' shows match count"),
+                multiline: z
+                    .boolean()
+                    .optional()
+                    .default(false)
+                    .describe("Enable multiline mode where . matches newlines"),
+                head_limit: z
+                    .number()
+                    .optional()
+                    .describe("Limit to first N matches"),
+                offset: z
+                    .number()
+                    .optional()
+                    .default(0)
+                    .describe("Skip first N matches"),
+            }),
+            handler: async (args) => {
+                try {
+                    // Handle -C overriding -A/-B
+                    const before = args["-C"] ?? args["-B"] ?? 0;
+                    const after = args["-C"] ?? args["-A"] ?? 0;
+                    const result = contentBuffer.grep(args.bufferId, args.pattern, {
+                        caseInsensitive: args["-i"] ?? false,
+                        before,
+                        after,
+                        multiline: args.multiline ?? false,
+                        countOnly: args.output_mode === "count",
+                        headLimit: args.head_limit,
+                        offset: args.offset ?? 0,
+                    });
+                    if (!result) {
+                        return formatError({
+                            error: true,
+                            message: `Buffer not found or expired: ${args.bufferId}`,
+                            statusCode: 404,
+                        });
+                    }
+                    // Count mode returns structured JSON
+                    if ("count" in result) {
+                        return formatSuccess(result);
+                    }
+                    // Content mode - format as text if -n, else JSON
+                    const showLineNumbers = args["-n"] ?? true;
+                    const maxSize = getMaxOutputSize();
+                    if (showLineNumbers) {
+                        const textOutput = formatGrepOutput(result, true);
+                        const fullText = `# Search Results: ${result.totalMatches} matches found${result.truncated ? " (truncated)" : ""}\n\n${textOutput || "No matches found."}`;
+                        // Check if exceeds max size - if so, buffer it
+                        if (fullText.length > maxSize) {
+                            const newBufferId = contentBuffer.store(fullText, {
+                                type: "grep_result",
+                                sourceBufferId: args.bufferId,
+                                pattern: args.pattern,
+                                totalMatches: result.totalMatches,
+                            });
+                            return {
+                                content: [
+                                    {
+                                        type: "text",
+                                        text: JSON.stringify({
+                                            _pagination: true,
+                                            status: "SUCCESS - Search results buffered",
+                                            bufferId: newBufferId,
+                                            totalSize: fullText.length,
+                                            totalMatches: result.totalMatches,
+                                            hasMore: true,
+                                            next_action: {
+                                                tool: "buffer_get_chunk",
+                                                args: { bufferId: newBufferId, offset: 0, limit: 5000 },
+                                            },
+                                        }, null, 2),
+                                    },
+                                ],
+                            };
+                        }
+                        // Within limit - return directly
+                        return {
+                            content: [
+                                {
+                                    type: "text",
+                                    text: fullText,
+                                },
+                            ],
+                        };
+                    }
+                    // JSON mode - use formatSuccess which handles buffering automatically
+                    return formatSuccess(result);
+                }
+                catch (error) {
+                    return formatError(error instanceof Error ? error : new Error(String(error)));
+                }
+            },
+        },
+        buffer_edit: {
+            description: `Exact string replacement in buffered content. Fails if old_string is not unique (use replace_all=true for all occurrences). Changes are in-memory only - call update API to persist.`,
+            inputSchema: z.object({
+                bufferId: z.string().describe("Buffer ID to modify"),
+                old_string: z.string().describe("Exact text to replace"),
+                new_string: z.string().describe("Replacement text"),
+                replace_all: z
+                    .boolean()
+                    .optional()
+                    .default(false)
+                    .describe("Replace all occurrences (default: false, fails if not unique)"),
+            }),
+            handler: async (args) => {
+                try {
+                    const result = contentBuffer.edit(args.bufferId, args.old_string, args.new_string, args.replace_all ?? false);
+                    if (!result) {
+                        return formatError({
+                            error: true,
+                            message: `Buffer not found or expired: ${args.bufferId}`,
+                            statusCode: 404,
+                        });
+                    }
+                    // Check if it's an error result
+                    if ("error" in result && result.error) {
+                        return formatError({
+                            error: true,
+                            message: result.message,
+                            statusCode: 400,
+                            details: { occurrences: result.occurrences },
+                        });
+                    }
+                    return formatSuccess(result);
+                }
+                catch (error) {
+                    return formatError(error instanceof Error ? error : new Error(String(error)));
+                }
+            },
+        },
+    };
+}
+//# sourceMappingURL=buffer-tools.js.map

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

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

package/dist/utils/content-buffer.d.ts

@@ -0,0 +1,144 @@
+/**
+ * Content Buffer for MCP Server
+ *
+ * Provides in-memory buffering with pagination support for large content
+ * that needs to be returned in chunks to MCP clients.
+ */
+export interface BufferEntry {
+    content: string;
+    totalSize: number;
+    createdAt: number;
+    modifiedAt?: number;
+    ttl: number;
+    metadata?: Record<string, unknown>;
+}
+export interface ChunkResult {
+    bufferId: string;
+    chunk: string;
+    offset: number;
+    limit: number;
+    totalSize: number;
+    hasMore: boolean;
+    metadata?: Record<string, unknown>;
+}
+export interface BufferInfo {
+    bufferId: string;
+    totalSize: number;
+    createdAt: number;
+    expiresAt: number;
+    metadata?: Record<string, unknown>;
+}
+export interface GrepMatch {
+    lineNumber: number;
+    line: string;
+    before: string[];
+    after: string[];
+}
+export interface GrepResult {
+    bufferId: string;
+    pattern: string;
+    totalMatches: number;
+    matches: GrepMatch[];
+    truncated: boolean;
+    metadata?: Record<string, unknown>;
+}
+export interface GrepCountResult {
+    bufferId: string;
+    pattern: string;
+    count: number;
+    metadata?: Record<string, unknown>;
+}
+export interface GrepOptions {
+    caseInsensitive?: boolean;
+    before?: number;
+    after?: number;
+    multiline?: boolean;
+    countOnly?: boolean;
+    headLimit?: number;
+    offset?: number;
+}
+export interface EditResult {
+    bufferId: string;
+    success: boolean;
+    replacements: number;
+    oldSize: number;
+    newSize: number;
+    metadata?: Record<string, unknown>;
+}
+export interface EditError {
+    error: true;
+    message: string;
+    occurrences: number;
+}
+export declare class ContentBuffer {
+    private buffers;
+    private defaultTTL;
+    private modifiedTTL;
+    private cleanupInterval;
+    private defaultChunkSize;
+    constructor(options?: {
+        defaultTTL?: number;
+        modifiedTTL?: number;
+        defaultChunkSize?: number;
+        cleanupIntervalMs?: number;
+    });
+    /**
+     * Check if a buffer entry is expired
+     * Modified buffers use modifiedAt as the reference time
+     */
+    private isExpired;
+    /**
+     * Get the expiration timestamp for a buffer entry
+     */
+    private getExpiresAt;
+    /**
+     * Store content in the buffer and return a unique buffer ID
+     */
+    store(content: string, metadata?: Record<string, unknown>, ttl?: number): string;
+    /**
+     * Get a chunk of content from the buffer
+     */
+    getChunk(bufferId: string, offset?: number, limit?: number): ChunkResult | null;
+    /**
+     * Check if a buffer exists and is valid
+     */
+    has(bufferId: string): boolean;
+    /**
+     * Get buffer info without content
+     */
+    getInfo(bufferId: string): BufferInfo | null;
+    /**
+     * List all active buffers
+     */
+    list(): BufferInfo[];
+    /**
+     * Clear a specific buffer or all buffers
+     */
+    clear(bufferId?: string): boolean;
+    /**
+     * Get the number of active buffers
+     */
+    size(): number;
+    /**
+     * Search buffer content for a pattern with context lines
+     */
+    grep(bufferId: string, pattern: string, options?: GrepOptions): GrepResult | GrepCountResult | null;
+    /**
+     * Edit buffer content by replacing old_string with new_string
+     */
+    edit(bufferId: string, oldString: string, newString: string, replaceAll?: boolean): EditResult | EditError | null;
+    /**
+     * Clean up expired buffers
+     */
+    private cleanup;
+    /**
+     * Generate a unique buffer ID
+     */
+    private generateId;
+    /**
+     * Stop the cleanup interval (for graceful shutdown)
+     */
+    destroy(): void;
+}
+export declare const contentBuffer: ContentBuffer;
+//# sourceMappingURL=content-buffer.d.ts.map

package/dist/utils/content-buffer.d.ts.map

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