tiddlywiki-mcp-server 1.0.0

package/dist/tools/index.js

@@ -0,0 +1,7 @@
+// ABOUTME: Barrel export for MCP tool handlers
+// ABOUTME: Re-exports all tool handlers and their input schemas
+export { handleSearchTiddlers, SearchTiddlersInput } from './search-tiddlers.js';
+export { handleUpdateTiddler, UpdateTiddlerInput } from './update-tiddler.js';
+export { handleCreateTiddler, CreateTiddlerInput, formatTiddlerPreview } from './create-tiddler.js';
+export { handleDeleteTiddler, DeleteTiddlerInput } from './delete-tiddler.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,gEAAgE;AAEhE,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AACjF,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9E,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AACpG,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/tools/search-tiddlers.d.ts

@@ -0,0 +1,12 @@
+import type { ToolResult, ToolDependencies } from './types.js';
+import { SearchTiddlersInput } from './types.js';
+/**
+ * Handle search_tiddlers tool requests.
+ * Supports three modes:
+ * - Filter-only: Pure TiddlyWiki filter expressions
+ * - Semantic-only: Similarity search on indexed tiddlers
+ * - Hybrid: Filter results, then re-rank by semantic similarity
+ */
+export declare function handleSearchTiddlers(args: unknown, deps: ToolDependencies): Promise<ToolResult>;
+export { SearchTiddlersInput };
+//# sourceMappingURL=search-tiddlers.d.ts.map

package/dist/tools/search-tiddlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-tiddlers.d.ts","sourceRoot":"","sources":["../../src/tools/search-tiddlers.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAmDjD;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,OAAO,EACb,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,UAAU,CAAC,CAwKrB;AAGD,OAAO,EAAE,mBAAmB,EAAE,CAAC"}

package/dist/tools/search-tiddlers.js

@@ -0,0 +1,189 @@
+// ABOUTME: Handler for the search_tiddlers MCP tool
+// ABOUTME: Supports filter-based, semantic, and hybrid search modes with pagination
+import { encode } from 'gpt-tokenizer';
+import { queryTiddlers, getTiddler } from '../tiddlywiki-http.js';
+import { SearchTiddlersInput } from './types.js';
+// Token counting and response size validation
+const MAX_RESPONSE_TOKENS = 23000; // Safe threshold below ~25k limit
+/**
+ * Count tokens in a string using gpt-tokenizer
+ */
+function countTokens(text) {
+    return encode(text).length;
+}
+/**
+ * Validate response size and suggest pagination if needed.
+ * Returns null if response is OK, or an error message if too large.
+ */
+function validateResponseSize(results, filter, includeText) {
+    const responseJson = JSON.stringify(results, null, 2);
+    const tokenCount = countTokens(responseJson);
+    if (tokenCount <= MAX_RESPONSE_TOKENS) {
+        return null; // Response is fine
+    }
+    // Calculate how many items would fit
+    const avgTokensPerItem = tokenCount / results.length;
+    const suggestedLimit = Math.floor(MAX_RESPONSE_TOKENS / avgTokensPerItem);
+    const errorMessage = `Query matched ${results.length} tiddlers but response would be ${tokenCount.toLocaleString()} tokens (exceeds ${MAX_RESPONSE_TOKENS.toLocaleString()} token limit).
+
+To retrieve results, use the limit parameter with offset for pagination.
+
+**Suggested query:**
+\`\`\`
+query_tiddlers({
+  filter: "${filter}",
+  includeText: ${includeText},
+  limit: ${suggestedLimit},
+  offset: 0
+})
+\`\`\`
+
+Then increment offset by ${suggestedLimit} for subsequent batches (offset: ${suggestedLimit}, offset: ${suggestedLimit * 2}, etc.) until you've retrieved all ${results.length} tiddlers.`;
+    return errorMessage;
+}
+/**
+ * Handle search_tiddlers tool requests.
+ * Supports three modes:
+ * - Filter-only: Pure TiddlyWiki filter expressions
+ * - Semantic-only: Similarity search on indexed tiddlers
+ * - Hybrid: Filter results, then re-rank by semantic similarity
+ */
+export async function handleSearchTiddlers(args, deps) {
+    const input = SearchTiddlersInput.parse(args);
+    const includeText = input.includeText ?? false;
+    const hasSemantic = input.semantic !== undefined;
+    const hasFilter = input.filter !== undefined;
+    // Filter-only mode
+    if (hasFilter && !hasSemantic) {
+        const offset = input.offset ?? 0;
+        const limit = input.limit;
+        const filter = input.filter;
+        const results = await queryTiddlers(filter, includeText, offset, limit);
+        // Validate response size
+        const sizeError = validateResponseSize(results, filter, includeText);
+        if (sizeError) {
+            return {
+                content: [{ type: 'text', text: sizeError }],
+                isError: true,
+            };
+        }
+        return {
+            content: [{ type: 'text', text: JSON.stringify(results, null, 2) }],
+        };
+    }
+    // Semantic mode (with optional filter)
+    if (hasSemantic) {
+        const { embeddingsDB, ollamaClient, syncWorker } = deps;
+        // Check if embeddings infrastructure is available
+        if (!embeddingsDB || !ollamaClient) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: 'Semantic search is not available',
+                            reason: 'Embeddings database or Ollama client not initialized',
+                            suggestion: 'Check server logs for initialization errors',
+                        }, null, 2),
+                    },
+                ],
+                isError: true,
+            };
+        }
+        // Check if any tiddlers have been indexed
+        const indexedCount = embeddingsDB.getIndexedTiddlersCount();
+        if (indexedCount === 0) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: 'No tiddlers have been indexed yet',
+                            suggestion: 'The sync worker is still indexing entries. Please wait a few minutes and try again.',
+                            status: syncWorker?.getStatus() || 'unknown',
+                        }, null, 2),
+                    },
+                ],
+                isError: true,
+            };
+        }
+        // Generate embedding for the query with search_query prefix
+        const semantic = input.semantic;
+        const queryEmbedding = await ollamaClient.generateQueryEmbedding(semantic);
+        // Search for similar entries
+        const limit = input.limit || 10;
+        const results = embeddingsDB.searchSimilar(queryEmbedding, limit);
+        // Apply optional TiddlyWiki filter for hybrid search
+        let filteredResults = results;
+        if (hasFilter) {
+            const filter = input.filter;
+            const filterMatches = await queryTiddlers(filter, false);
+            const filterTitles = new Set(filterMatches.map((t) => t.title));
+            filteredResults = results.filter((r) => filterTitles.has(r.tiddler_title));
+        }
+        // Fetch full tiddlers if includeText is true
+        const formattedResults = await Promise.all(filteredResults.map(async (r) => {
+            const result = {
+                tiddler_title: r.tiddler_title,
+                chunk_id: r.chunk_id,
+                similarity_score: (1 - r.distance).toFixed(4), // Convert distance to similarity
+                created: r.created,
+                modified: r.modified,
+                tags: r.tags,
+            };
+            // Fetch full tiddler text if requested
+            if (includeText) {
+                const fullTiddler = await getTiddler(r.tiddler_title);
+                if (fullTiddler) {
+                    result.text = fullTiddler.text;
+                    result.type = fullTiddler.type;
+                }
+            }
+            return result;
+        }));
+        // Validate response size
+        const responseJson = JSON.stringify(formattedResults, null, 2);
+        const tokenCount = countTokens(responseJson);
+        if (tokenCount > MAX_RESPONSE_TOKENS) {
+            const avgTokensPerItem = tokenCount / formattedResults.length;
+            const suggestedLimit = Math.floor(MAX_RESPONSE_TOKENS / avgTokensPerItem);
+            const filterParam = hasFilter ? `,\n  filter: "${input.filter}"` : '';
+            const errorMessage = `Semantic search matched ${formattedResults.length} results but response would be ${tokenCount.toLocaleString()} tokens (exceeds ${MAX_RESPONSE_TOKENS.toLocaleString()} token limit).
+
+To retrieve results, use the limit parameter.
+
+**Suggested query:**
+\`\`\`
+search_tiddlers({
+  semantic: "${semantic}",
+  includeText: ${includeText},
+  limit: ${suggestedLimit}${filterParam}
+})
+\`\`\`
+
+Note: Semantic search returns results ordered by similarity, so using a lower limit will return the most relevant matches.`;
+            return {
+                content: [{ type: 'text', text: errorMessage }],
+                isError: true,
+            };
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        query: semantic,
+                        total_results: formattedResults.length,
+                        indexed_tiddlers: indexedCount,
+                        results: formattedResults,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    // Should never reach here due to Zod validation
+    throw new Error('Either semantic or filter must be provided');
+}
+// Re-export the input schema for use in tool registration
+export { SearchTiddlersInput };
+//# sourceMappingURL=search-tiddlers.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search-tiddlers.js","sourceRoot":"","sources":["../../src/tools/search-tiddlers.ts"],"names":[],"mappings":"AAAA,oDAAoD;AACpD,oFAAoF;AAEpF,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAElE,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEjD,8CAA8C;AAC9C,MAAM,mBAAmB,GAAG,KAAK,CAAC,CAAC,kCAAkC;AAErE;;GAEG;AACH,SAAS,WAAW,CAAC,IAAY;IAC/B,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;AAC7B,CAAC;AAED;;;GAGG;AACH,SAAS,oBAAoB,CAC3B,OAAkB,EAClB,MAAc,EACd,WAAoB;IAEpB,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACtD,MAAM,UAAU,GAAG,WAAW,CAAC,YAAY,CAAC,CAAC;IAE7C,IAAI,UAAU,IAAI,mBAAmB,EAAE,CAAC;QACtC,OAAO,IAAI,CAAC,CAAC,mBAAmB;IAClC,CAAC;IAED,qCAAqC;IACrC,MAAM,gBAAgB,GAAG,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IACrD,MAAM,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,mBAAmB,GAAG,gBAAgB,CAAC,CAAC;IAE1E,MAAM,YAAY,GAAG,iBAAiB,OAAO,CAAC,MAAM,mCAAmC,UAAU,CAAC,cAAc,EAAE,oBAAoB,mBAAmB,CAAC,cAAc,EAAE;;;;;;;aAO/J,MAAM;iBACF,WAAW;WACjB,cAAc;;;;;2BAKE,cAAc,oCAAoC,cAAc,aAAa,cAAc,GAAG,CAAC,sCAAsC,OAAO,CAAC,MAAM,YAAY,CAAC;IAEzL,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,IAAa,EACb,IAAsB;IAEtB,MAAM,KAAK,GAAG,mBAAmB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC9C,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC;IAC/C,MAAM,WAAW,GAAG,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC;IACjD,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC;IAE7C,mBAAmB;IACnB,IAAI,SAAS,IAAI,CAAC,WAAW,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;QACjC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;QAC1B,MAAM,MAAM,GAAG,KAAK,CAAC,MAAO,CAAC;QAC7B,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;QAExE,yBAAyB;QACzB,MAAM,SAAS,GAAG,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QACrE,IAAI,SAAS,EAAE,CAAC;YACd,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;gBAC5C,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SACpE,CAAC;IACJ,CAAC;IAED,uCAAuC;IACvC,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;QAExD,kDAAkD;QAClD,IAAI,CAAC,YAAY,IAAI,CAAC,YAAY,EAAE,CAAC;YACnC,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;4BACE,KAAK,EAAE,kCAAkC;4BACzC,MAAM,EAAE,sDAAsD;4BAC9D,UAAU,EAAE,6CAA6C;yBAC1D,EACD,IAAI,EACJ,CAAC,CACF;qBACF;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,0CAA0C;QAC1C,MAAM,YAAY,GAAG,YAAY,CAAC,uBAAuB,EAAE,CAAC;QAC5D,IAAI,YAAY,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;4BACE,KAAK,EAAE,mCAAmC;4BAC1C,UAAU,EACR,qFAAqF;4BACvF,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,IAAI,SAAS;yBAC7C,EACD,IAAI,EACJ,CAAC,CACF;qBACF;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,4DAA4D;QAC5D,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAS,CAAC;QACjC,MAAM,cAAc,GAAG,MAAM,YAAY,CAAC,sBAAsB,CAAC,QAAQ,CAAC,CAAC;QAE3E,6BAA6B;QAC7B,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;QAChC,MAAM,OAAO,GAAG,YAAY,CAAC,aAAa,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;QAElE,qDAAqD;QACrD,IAAI,eAAe,GAAG,OAAO,CAAC;QAC9B,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,MAAM,GAAG,KAAK,CAAC,MAAO,CAAC;YAC7B,MAAM,aAAa,GAAG,MAAM,aAAa,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;YACzD,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;YAChE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC;QAC7E,CAAC;QAED,6CAA6C;QAC7C,MAAM,gBAAgB,GAAG,MAAM,OAAO,CAAC,GAAG,CACxC,eAAe,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;YAC9B,MAAM,MAAM,GAA4B;gBACtC,aAAa,EAAE,CAAC,CAAC,aAAa;gBAC9B,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,gBAAgB,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,iCAAiC;gBAChF,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,IAAI,EAAE,CAAC,CAAC,IAAI;aACb,CAAC;YAEF,uCAAuC;YACvC,IAAI,WAAW,EAAE,CAAC;gBAChB,MAAM,WAAW,GAAG,MAAM,UAAU,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;gBACtD,IAAI,WAAW,EAAE,CAAC;oBAChB,MAAM,CAAC,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC;oBAC/B,MAAM,CAAC,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC;gBACjC,CAAC;YACH,CAAC;YAED,OAAO,MAAM,CAAC;QAChB,CAAC,CAAC,CACH,CAAC;QAEF,yBAAyB;QACzB,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,gBAAgB,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAC/D,MAAM,UAAU,GAAG,WAAW,CAAC,YAAY,CAAC,CAAC;QAE7C,IAAI,UAAU,GAAG,mBAAmB,EAAE,CAAC;YACrC,MAAM,gBAAgB,GAAG,UAAU,GAAG,gBAAgB,CAAC,MAAM,CAAC;YAC9D,MAAM,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,mBAAmB,GAAG,gBAAgB,CAAC,CAAC;YAE1E,MAAM,WAAW,GAAG,SAAS,CAAC,CAAC,CAAC,iBAAiB,KAAK,CAAC,MAAO,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACvE,MAAM,YAAY,GAAG,2BAA2B,gBAAgB,CAAC,MAAM,kCAAkC,UAAU,CAAC,cAAc,EAAE,oBAAoB,mBAAmB,CAAC,cAAc,EAAE;;;;;;;eAOnL,QAAQ;iBACN,WAAW;WACjB,cAAc,GAAG,WAAW;;;;2HAIoF,CAAC;YAEtH,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;gBAC/C,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;wBACE,KAAK,EAAE,QAAQ;wBACf,aAAa,EAAE,gBAAgB,CAAC,MAAM;wBACtC,gBAAgB,EAAE,YAAY;wBAC9B,OAAO,EAAE,gBAAgB;qBAC1B,EACD,IAAI,EACJ,CAAC,CACF;iBACF;aACF;SACF,CAAC;IACJ,CAAC;IAED,gDAAgD;IAChD,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;AAChE,CAAC;AAED,0DAA0D;AAC1D,OAAO,EAAE,mBAAmB,EAAE,CAAC"}

package/dist/tools/types.d.ts

@@ -0,0 +1,101 @@
+import { z } from 'zod';
+import type { EmbeddingsDB } from '../embeddings/database.js';
+import type { OllamaClient } from '../embeddings/ollama-client.js';
+import type { SyncWorker } from '../embeddings/sync-worker.js';
+/**
+ * Standard result type returned by all tool handlers.
+ * Matches the MCP SDK's expected response format.
+ * Uses index signature to allow additional properties the SDK may expect.
+ */
+export interface ToolResult {
+    [key: string]: unknown;
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}
+/**
+ * Dependencies injected into tool handlers that need embeddings functionality.
+ * All fields are nullable since embeddings may be disabled.
+ */
+export interface ToolDependencies {
+    embeddingsDB: EmbeddingsDB | null;
+    ollamaClient: OllamaClient | null;
+    syncWorker: SyncWorker | null;
+}
+export declare const SearchTiddlersInput: z.ZodEffects<z.ZodObject<{
+    semantic: z.ZodOptional<z.ZodString>;
+    filter: z.ZodOptional<z.ZodString>;
+    includeText: z.ZodOptional<z.ZodBoolean>;
+    offset: z.ZodOptional<z.ZodNumber>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    filter?: string | undefined;
+    semantic?: string | undefined;
+    includeText?: boolean | undefined;
+    offset?: number | undefined;
+    limit?: number | undefined;
+}, {
+    filter?: string | undefined;
+    semantic?: string | undefined;
+    includeText?: boolean | undefined;
+    offset?: number | undefined;
+    limit?: number | undefined;
+}>, {
+    filter?: string | undefined;
+    semantic?: string | undefined;
+    includeText?: boolean | undefined;
+    offset?: number | undefined;
+    limit?: number | undefined;
+}, {
+    filter?: string | undefined;
+    semantic?: string | undefined;
+    includeText?: boolean | undefined;
+    offset?: number | undefined;
+    limit?: number | undefined;
+}>;
+export type SearchTiddlersInputType = z.infer<typeof SearchTiddlersInput>;
+export declare const UpdateTiddlerInput: z.ZodObject<{
+    title: z.ZodString;
+    text: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodString>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    title: z.ZodString;
+    text: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    title: z.ZodString;
+    text: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">>;
+export type UpdateTiddlerInputType = z.infer<typeof UpdateTiddlerInput>;
+export declare const CreateTiddlerInput: z.ZodObject<{
+    title: z.ZodString;
+    text: z.ZodString;
+    tags: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodString>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    title: z.ZodString;
+    text: z.ZodString;
+    tags: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    title: z.ZodString;
+    text: z.ZodString;
+    tags: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">>;
+export type CreateTiddlerInputType = z.infer<typeof CreateTiddlerInput>;
+export declare const DeleteTiddlerInput: z.ZodObject<{
+    title: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    title: string;
+}, {
+    title: string;
+}>;
+export type DeleteTiddlerInputType = z.infer<typeof DeleteTiddlerInput>;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAE/D;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;IAClC,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;IAClC,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;CAC/B;AAID,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoC5B,CAAC;AAEL,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAE1E,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;gCAOf,CAAC;AAEjB,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAExE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;gCAOf,CAAC;AAEjB,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAExE,eAAO,MAAM,kBAAkB;;;;;;EAE7B,CAAC;AAEH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC"}

package/dist/tools/types.js

@@ -0,0 +1,55 @@
+// ABOUTME: Shared types for MCP tool handlers
+// ABOUTME: Defines ToolResult, ToolDependencies, and Zod schemas for tool inputs
+import { z } from 'zod';
+// Zod schemas for tool inputs
+export const SearchTiddlersInput = z
+    .object({
+    semantic: z
+        .string()
+        .optional()
+        .describe('Natural language semantic search query (e.g., "times I felt anxious about parenting")'),
+    filter: z
+        .string()
+        .optional()
+        .describe('TiddlyWiki filter expression (e.g., "[tag[Journal]prefix[2025-11]]"). Can be used alone for filter-based search, or combined with semantic for hybrid search.'),
+    includeText: z
+        .boolean()
+        .optional()
+        .describe('Include text content in results (default: false)'),
+    offset: z
+        .number()
+        .int()
+        .min(0)
+        .optional()
+        .describe('Number of results to skip (default: 0). Only applies to filter-based search.'),
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(100)
+        .optional()
+        .describe('Maximum number of results to return (default: 10 for semantic, unlimited for filter, max: 100)'),
+})
+    .refine((data) => data.semantic !== undefined || data.filter !== undefined, {
+    message: 'At least one of semantic or filter must be provided',
+});
+export const UpdateTiddlerInput = z
+    .object({
+    title: z.string().describe('Title of the tiddler to update'),
+    text: z.string().optional().describe('New text content'),
+    tags: z.string().optional().describe('New tags (space-separated)'),
+    type: z.string().optional().describe('Content type (e.g., text/markdown)'),
+})
+    .passthrough(); // Allow additional custom fields
+export const CreateTiddlerInput = z
+    .object({
+    title: z.string().describe('Title of the new tiddler'),
+    text: z.string().describe('Text content'),
+    tags: z.string().optional().describe('Tags (space-separated)'),
+    type: z.string().optional().describe('Content type (default: text/markdown)'),
+})
+    .passthrough(); // Allow additional custom fields
+export const DeleteTiddlerInput = z.object({
+    title: z.string().describe('Title of the tiddler to delete'),
+});
+//# sourceMappingURL=types.js.map

package/dist/tools/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,iFAAiF;AAEjF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA0BxB,8BAA8B;AAE9B,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC;KACjC,MAAM,CAAC;IACN,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,uFAAuF,CACxF;IACH,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,+JAA+J,CAChK;IACH,WAAW,EAAE,CAAC;SACX,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CAAC,kDAAkD,CAAC;IAC/D,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,EAAE;SACV,QAAQ,CAAC,8EAA8E,CAAC;IAC3F,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,gGAAgG,CACjG;CACJ,CAAC;KACD,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE;IAC1E,OAAO,EAAE,qDAAqD;CAC/D,CAAC,CAAC;AAIL,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC;KAChC,MAAM,CAAC;IACN,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;IAC5D,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;IACxD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;IAClE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;CAC3E,CAAC;KACD,WAAW,EAAE,CAAC,CAAC,iCAAiC;AAInD,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC;KAChC,MAAM,CAAC;IACN,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;IACtD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;IACzC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;IAC9D,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;CAC9E,CAAC;KACD,WAAW,EAAE,CAAC,CAAC,iCAAiC;AAInD,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;CAC7D,CAAC,CAAC"}

package/dist/tools/update-tiddler.d.ts

@@ -0,0 +1,9 @@
+import type { ToolResult } from './types.js';
+import { UpdateTiddlerInput } from './types.js';
+/**
+ * Handle update_tiddler tool requests.
+ * Gets the current tiddler, applies updates, generates a diff, and saves.
+ */
+export declare function handleUpdateTiddler(args: unknown): Promise<ToolResult>;
+export { UpdateTiddlerInput };
+//# sourceMappingURL=update-tiddler.d.ts.map

package/dist/tools/update-tiddler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-tiddler.d.ts","sourceRoot":"","sources":["../../src/tools/update-tiddler.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AA4DhD;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,CAwC5E;AAGD,OAAO,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/tools/update-tiddler.js

@@ -0,0 +1,90 @@
+// ABOUTME: Handler for the update_tiddler MCP tool
+// ABOUTME: Updates existing tiddlers with diff preview and custom field support
+import { createTwoFilesPatch } from 'diff';
+import { getTiddler, putTiddler, updateTiddlerObject, getAuthUser, } from '../tiddlywiki-http.js';
+import { UpdateTiddlerInput } from './types.js';
+/**
+ * Generate a readable diff between two tiddlers
+ */
+function generateTiddlerDiff(oldTiddler, newTiddler) {
+    const lines = [];
+    // Text diff
+    const oldText = oldTiddler.text || '';
+    const newText = newTiddler.text || '';
+    if (oldText !== newText) {
+        const patch = createTwoFilesPatch(oldTiddler.title, newTiddler.title, oldText, newText, 'Before', 'After', { context: 1 } // Reduce context to 1 line for more compact diffs
+        );
+        // Add a concise summary
+        const oldLines = oldText.split('\n').length;
+        const newLines = newText.split('\n').length;
+        const delta = newLines - oldLines;
+        const summary = delta > 0
+            ? `+${delta} line${delta === 1 ? '' : 's'}`
+            : delta < 0
+                ? `${delta} line${delta === -1 ? '' : 's'}`
+                : 'modified';
+        lines.push(`**Content:** ${summary}`);
+        lines.push('```diff');
+        lines.push(patch);
+        lines.push('```');
+    }
+    // Metadata changes
+    const metadataChanges = [];
+    if (oldTiddler.tags !== newTiddler.tags) {
+        metadataChanges.push(`  tags: "${oldTiddler.tags || ''}" → "${newTiddler.tags || ''}"`);
+    }
+    if (oldTiddler.type !== newTiddler.type) {
+        metadataChanges.push(`  type: "${oldTiddler.type}" → "${newTiddler.type}"`);
+    }
+    if (metadataChanges.length > 0) {
+        lines.push('');
+        lines.push('**Metadata:**');
+        lines.push(...metadataChanges);
+    }
+    return lines.join('\n');
+}
+/**
+ * Handle update_tiddler tool requests.
+ * Gets the current tiddler, applies updates, generates a diff, and saves.
+ */
+export async function handleUpdateTiddler(args) {
+    const input = UpdateTiddlerInput.parse(args);
+    // Get current tiddler
+    const current = await getTiddler(input.title);
+    if (!current) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({ error: `Tiddler not found: ${input.title}` }, null, 2),
+                },
+            ],
+            isError: true,
+        };
+    }
+    // Build updated tiddler - include all custom fields from input
+    const { title: _title, text, tags, type, ...customFields } = input;
+    const updates = { ...customFields };
+    if (text !== undefined)
+        updates.text = text;
+    if (tags !== undefined)
+        updates.tags = tags;
+    if (type !== undefined)
+        updates.type = type;
+    const updated = updateTiddlerObject(current, updates, getAuthUser());
+    // Generate diff
+    const diff = generateTiddlerDiff(current, updated);
+    // Apply the change
+    await putTiddler(updated);
+    return {
+        content: [
+            {
+                type: 'text',
+                text: `## Updated: "${input.title}"\n\n${diff}`,
+            },
+        ],
+    };
+}
+// Re-export the input schema for use in tool registration
+export { UpdateTiddlerInput };
+//# sourceMappingURL=update-tiddler.js.map

package/dist/tools/update-tiddler.js.map

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

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "tiddlywiki-mcp-server",
+  "version": "1.0.0",
+  "description": "MCP server for TiddlyWiki with stdio and HTTP transport support",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "tiddlywiki-mcp-server": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ppetru/tiddlywiki-mcp.git"
+  },
+  "scripts": {
+    "build": "tsc",
+    "watch": "tsc --watch",
+    "start": "node dist/index.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint src/**/*.ts",
+    "lint:fix": "eslint src/**/*.ts --fix",
+    "format": "prettier --write 'src/**/*.ts'",
+    "format:check": "prettier --check 'src/**/*.ts'",
+    "typecheck": "tsc --noEmit",
+    "prepare": "lefthook install"
+  },
+  "keywords": [
+    "mcp",
+    "tiddlywiki",
+    "model-context-protocol"
+  ],
+  "author": "Petru Paler <petru@paler.net> (https://petru.paler.net)",
+  "license": "MIT",
+  "engines": {
+    "node": ">=22"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.1",
+    "better-sqlite3": "^12.4.1",
+    "diff": "^5.2.0",
+    "express": "^4.21.2",
+    "gpt-tokenizer": "^3.4.0",
+    "sqlite-vec": "^0.1.7-alpha.2",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.2",
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/diff": "^5.2.0",
+    "@types/express": "^5.0.0",
+    "@types/node": "^22.0.0",
+    "@typescript-eslint/eslint-plugin": "^8.18.2",
+    "@typescript-eslint/parser": "^8.18.2",
+    "@vitest/coverage-v8": "^2.1.8",
+    "eslint": "^9.17.0",
+    "eslint-config-prettier": "^10.1.8",
+    "lefthook": "^2.0.13",
+    "prettier": "^3.4.2",
+    "typescript": "^5.6.0",
+    "typescript-eslint": "^8.50.1",
+    "vitest": "^2.1.8"
+  }
+}