tiddlywiki-mcp-server 1.0.0

package/dist/logger.js

@@ -0,0 +1,33 @@
+// ABOUTME: Logging utility with timestamps and debug mode support
+// ABOUTME: Set LOG_DEBUG=true to enable verbose debug logging
+const DEBUG_ENABLED = process.env.LOG_DEBUG === 'true';
+function getTimestamp() {
+    return new Date().toISOString();
+}
+/**
+ * Log informational messages (always shown)
+ */
+export function log(message, ...args) {
+    console.log(`[${getTimestamp()}]`, message, ...args);
+}
+/**
+ * Log error messages (always shown)
+ */
+export function error(message, ...args) {
+    console.error(`[${getTimestamp()}]`, message, ...args);
+}
+/**
+ * Log warning messages (always shown)
+ */
+export function warn(message, ...args) {
+    console.warn(`[${getTimestamp()}]`, message, ...args);
+}
+/**
+ * Log debug messages (only shown when LOG_DEBUG=true)
+ */
+export function debug(message, ...args) {
+    if (DEBUG_ENABLED) {
+        console.log(`[${getTimestamp()}] [DEBUG]`, message, ...args);
+    }
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,8DAA8D;AAE9D,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,KAAK,MAAM,CAAC;AAEvD,SAAS,YAAY;IACnB,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,GAAG,CAAC,OAAe,EAAE,GAAG,IAAe;IACrD,OAAO,CAAC,GAAG,CAAC,IAAI,YAAY,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;AACvD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;IACvD,OAAO,CAAC,KAAK,CAAC,IAAI,YAAY,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;AACzD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;IACtD,OAAO,CAAC,IAAI,CAAC,IAAI,YAAY,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;AACxD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;IACvD,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO,CAAC,GAAG,CAAC,IAAI,YAAY,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IAC/D,CAAC;AACH,CAAC"}

package/dist/service-discovery.d.ts

@@ -0,0 +1,24 @@
+export interface ServiceEndpoint {
+    host: string;
+    port: number;
+}
+/**
+ * Resolve a Consul service name to host and port via SRV record
+ * @param serviceName - Consul service name (e.g., "wiki.service.consul")
+ * @returns Service endpoint with host and port
+ */
+export declare function resolveConsulService(serviceName: string): Promise<ServiceEndpoint>;
+/**
+ * Build HTTP URL from a service URL, Consul service name, or hostname:port
+ *
+ * Supports three formats:
+ * - Full URL: "http://localhost:8080" or "https://wiki.example.com" -> used directly
+ * - Consul service: "wiki.service.consul" -> resolved via SRV DNS
+ * - Hostname:port: "localhost:8080" -> prepended with http://
+ *
+ * @param serviceOrUrl - URL, Consul service name, or hostname:port
+ * @param path - Optional path to append
+ * @returns Full HTTP URL
+ */
+export declare function getServiceUrl(serviceOrUrl: string, path?: string): Promise<string>;
+//# sourceMappingURL=service-discovery.d.ts.map

package/dist/service-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-discovery.d.ts","sourceRoot":"","sources":["../src/service-discovery.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAYD;;;;GAIG;AACH,wBAAsB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAgDxF;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,GAAE,MAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAiB5F"}

package/dist/service-discovery.js

@@ -0,0 +1,82 @@
+// ABOUTME: Service discovery module for resolving TiddlyWiki server URLs
+// ABOUTME: Supports direct URLs, Consul SRV DNS, and hostname:port formats
+import { promises as dns } from 'dns';
+import * as logger from './logger.js';
+// DNS resolution timeout (10 seconds)
+const DNS_TIMEOUT = 10000;
+/**
+ * Wrap a promise with a timeout
+ */
+async function withTimeout(promise, ms, errorMsg) {
+    const timeout = new Promise((_, reject) => setTimeout(() => reject(new Error(errorMsg)), ms));
+    return Promise.race([promise, timeout]);
+}
+/**
+ * Resolve a Consul service name to host and port via SRV record
+ * @param serviceName - Consul service name (e.g., "wiki.service.consul")
+ * @returns Service endpoint with host and port
+ */
+export async function resolveConsulService(serviceName) {
+    try {
+        logger.debug(`[ServiceDiscovery] Resolving SRV record for ${serviceName}...`);
+        // Resolve SRV record using Node.js DNS with timeout
+        const srvRecords = await withTimeout(dns.resolveSrv(serviceName), DNS_TIMEOUT, `DNS SRV resolution timed out for ${serviceName} after ${DNS_TIMEOUT}ms`);
+        if (!srvRecords || srvRecords.length === 0) {
+            throw new Error(`No SRV records found for ${serviceName}`);
+        }
+        // Use the first SRV record (could be enhanced with priority/weight sorting)
+        const srv = srvRecords[0];
+        const port = srv.port;
+        const hostname = srv.name;
+        // Resolve the hostname to IP address with timeout
+        try {
+            const addresses = await withTimeout(dns.resolve4(hostname), DNS_TIMEOUT, `DNS A record resolution timed out for ${hostname} after ${DNS_TIMEOUT}ms`);
+            if (!addresses || addresses.length === 0) {
+                // If A record resolution fails, try using the hostname as-is
+                logger.warn(`[ServiceDiscovery] Could not resolve ${hostname}, using as-is`);
+                return { host: hostname, port };
+            }
+            const host = addresses[0];
+            logger.debug(`[ServiceDiscovery] Resolved ${serviceName} -> ${host}:${port}`);
+            return { host, port };
+        }
+        catch (addrError) {
+            // If A record resolution fails (including timeout), try using the hostname as-is
+            const errMsg = addrError instanceof Error ? addrError.message : String(addrError);
+            logger.warn(`[ServiceDiscovery] Could not resolve ${hostname}: ${errMsg}, using as-is`);
+            return { host: hostname, port };
+        }
+    }
+    catch (error) {
+        const err = error;
+        throw new Error(`Failed to resolve Consul service ${serviceName}: ${err.message}`);
+    }
+}
+/**
+ * Build HTTP URL from a service URL, Consul service name, or hostname:port
+ *
+ * Supports three formats:
+ * - Full URL: "http://localhost:8080" or "https://wiki.example.com" -> used directly
+ * - Consul service: "wiki.service.consul" -> resolved via SRV DNS
+ * - Hostname:port: "localhost:8080" -> prepended with http://
+ *
+ * @param serviceOrUrl - URL, Consul service name, or hostname:port
+ * @param path - Optional path to append
+ * @returns Full HTTP URL
+ */
+export async function getServiceUrl(serviceOrUrl, path = '') {
+    const basePath = path ? (path.startsWith('/') ? path : `/${path}`) : '';
+    // If already a full URL, use it directly
+    if (serviceOrUrl.startsWith('http://') || serviceOrUrl.startsWith('https://')) {
+        const base = serviceOrUrl.replace(/\/$/, ''); // trim trailing slash
+        return `${base}${basePath}`;
+    }
+    // If it looks like a Consul service name, resolve via SRV
+    if (serviceOrUrl.includes('.service.consul')) {
+        const endpoint = await resolveConsulService(serviceOrUrl);
+        return `http://${endpoint.host}:${endpoint.port}${basePath}`;
+    }
+    // Otherwise treat as hostname:port
+    return `http://${serviceOrUrl}${basePath}`;
+}
+//# sourceMappingURL=service-discovery.js.map

package/dist/service-discovery.js.map

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

package/dist/tiddlywiki-http.d.ts

@@ -0,0 +1,55 @@
+export interface Tiddler {
+    title: string;
+    text?: string;
+    type?: string;
+    tags?: string;
+    created?: string;
+    creator?: string;
+    modified?: string;
+    modifier?: string;
+    revision?: number;
+    bag?: string;
+    [key: string]: any;
+}
+export interface TiddlyWikiConfig {
+    tiddlywikiUrl: string;
+    authHeader: string;
+    authUser: string;
+}
+/**
+ * Initialize the TiddlyWiki HTTP client
+ */
+export declare function initTiddlyWiki(cfg: TiddlyWikiConfig): void;
+/**
+ * Get the configured auth user
+ */
+export declare function getAuthUser(): string;
+/**
+ * Query tiddlers using filter syntax
+ */
+export declare function queryTiddlers(filter: string, includeText?: boolean, offset?: number, limit?: number): Promise<Tiddler[]>;
+/**
+ * Get a single tiddler by title
+ */
+export declare function getTiddler(title: string): Promise<Tiddler | null>;
+/**
+ * Create or update a tiddler
+ */
+export declare function putTiddler(tiddler: Tiddler): Promise<void>;
+/**
+ * Delete a tiddler
+ */
+export declare function deleteTiddler(title: string): Promise<void>;
+/**
+ * Generate a TiddlyWiki timestamp (YYYYMMDDhhmmssSSS format)
+ */
+export declare function generateTimestamp(date?: Date): string;
+/**
+ * Create a new tiddler with proper defaults
+ */
+export declare function createTiddlerObject(title: string, text: string, tags: string | undefined, type: string | undefined, creator: string): Tiddler;
+/**
+ * Update an existing tiddler while preserving metadata
+ */
+export declare function updateTiddlerObject(current: Tiddler, updates: Partial<Tiddler>, modifier: string): Tiddler;
+//# sourceMappingURL=tiddlywiki-http.d.ts.map

package/dist/tiddlywiki-http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tiddlywiki-http.d.ts","sourceRoot":"","sources":["../src/tiddlywiki-http.ts"],"names":[],"mappings":"AAsCA,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAUD;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,gBAAgB,GAAG,IAAI,CAG1D;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAKpC;AA6DD;;GAEG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,EACd,WAAW,GAAE,OAAe,EAC5B,MAAM,GAAE,MAAU,EAClB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,OAAO,EAAE,CAAC,CAyDpB;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CA8BvE;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAoChE;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA6BhE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,GAAE,IAAiB,GAAG,MAAM,CAYjE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,YAAK,EACjB,IAAI,EAAE,MAAM,YAAkB,EAC9B,OAAO,EAAE,MAAM,GACd,OAAO,CAST;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,EACzB,QAAQ,EAAE,MAAM,GACf,OAAO,CAeT"}

package/dist/tiddlywiki-http.js

@@ -0,0 +1,253 @@
+// ABOUTME: HTTP client for TiddlyWiki server communication
+// ABOUTME: Handles tiddler CRUD operations with proper metadata preservation
+import { getServiceUrl } from './service-discovery.js';
+import * as logger from './logger.js';
+// Timeout configuration (in milliseconds)
+const TIMEOUT_READ = 30000; // 30 seconds for read operations
+const TIMEOUT_WRITE = 60000; // 60 seconds for write operations
+/**
+ * Fetch with timeout using AbortController
+ */
+async function fetchWithTimeout(url, options, timeoutMs, operationName) {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => {
+        logger.warn(`[TiddlyWiki HTTP] ${operationName} timed out after ${timeoutMs}ms`);
+        controller.abort();
+    }, timeoutMs);
+    try {
+        const response = await fetch(url, { ...options, signal: controller.signal });
+        return response;
+    }
+    catch (error) {
+        if (error instanceof Error && error.name === 'AbortError') {
+            throw new Error(`${operationName} timed out after ${timeoutMs}ms`);
+        }
+        throw error;
+    }
+    finally {
+        clearTimeout(timeoutId);
+    }
+}
+let config = null;
+let baseUrlCache = null;
+let cacheTime = 0;
+const CACHE_TTL = 60000; // 1 minute
+// Mutex for base URL resolution to prevent duplicate DNS lookups
+let pendingResolution = null;
+/**
+ * Initialize the TiddlyWiki HTTP client
+ */
+export function initTiddlyWiki(cfg) {
+    config = cfg;
+    logger.log('[TiddlyWiki HTTP] Initialized with URL:', cfg.tiddlywikiUrl);
+}
+/**
+ * Get the configured auth user
+ */
+export function getAuthUser() {
+    if (!config) {
+        throw new Error('TiddlyWiki client not initialized');
+    }
+    return config.authUser;
+}
+/**
+ * Get the base URL for TiddlyWiki API, with caching and mutex.
+ *
+ * Uses a mutex to prevent duplicate DNS lookups when multiple concurrent
+ * requests arrive while the cache is stale. The first request initiates
+ * resolution, subsequent requests await the same promise.
+ */
+async function getBaseUrl() {
+    if (!config) {
+        throw new Error('TiddlyWiki client not initialized');
+    }
+    const now = Date.now();
+    // Return cached value if still valid
+    if (baseUrlCache && now - cacheTime < CACHE_TTL) {
+        return baseUrlCache;
+    }
+    // If resolution is already in progress, wait for it
+    if (pendingResolution) {
+        return pendingResolution;
+    }
+    // Start new resolution with mutex
+    pendingResolution = (async () => {
+        try {
+            const url = await getServiceUrl(config.tiddlywikiUrl, '');
+            baseUrlCache = url;
+            cacheTime = Date.now();
+            return url;
+        }
+        finally {
+            pendingResolution = null;
+        }
+    })();
+    return pendingResolution;
+}
+/**
+ * Get common headers for TiddlyWiki API requests
+ */
+function getHeaders(includeJson = false) {
+    if (!config) {
+        throw new Error('TiddlyWiki client not initialized');
+    }
+    const headers = {
+        [config.authHeader]: config.authUser,
+    };
+    if (includeJson) {
+        headers['Content-Type'] = 'application/json';
+        headers['x-requested-with'] = 'TiddlyWiki';
+    }
+    return headers;
+}
+/**
+ * Query tiddlers using filter syntax
+ */
+export async function queryTiddlers(filter, includeText = false, offset = 0, limit) {
+    const baseUrl = await getBaseUrl();
+    const encodedFilter = encodeURIComponent(filter);
+    const url = `${baseUrl}/recipes/default/tiddlers.json?filter=${encodedFilter}`;
+    const filterPreview = filter.length > 80 ? filter.substring(0, 80) + '...' : filter;
+    logger.debug(`[TiddlyWiki HTTP] queryTiddlers: filter="${filterPreview}" includeText=${includeText}`);
+    const response = await fetchWithTimeout(url, { method: 'GET', headers: getHeaders() }, TIMEOUT_READ, `queryTiddlers(filter="${filterPreview}")`);
+    if (!response.ok) {
+        const errorBody = await response.text().catch(() => '(no body)');
+        logger.error(`[TiddlyWiki HTTP] queryTiddlers failed: ${response.status} ${response.statusText} - ${errorBody}`);
+        throw new Error(`Failed to query tiddlers: ${response.status} ${response.statusText}`);
+    }
+    let tiddlers = (await response.json());
+    logger.debug(`[TiddlyWiki HTTP] queryTiddlers: ${tiddlers.length} tiddlers matched`);
+    // Apply offset and limit BEFORE fetching full content (optimization)
+    const endIndex = limit !== undefined ? offset + limit : undefined;
+    tiddlers = tiddlers.slice(offset, endIndex);
+    // If includeText is false, the API already excludes text by default
+    // If includeText is true, we need to fetch each tiddler individually
+    if (includeText && tiddlers.length > 0) {
+        logger.debug(`[TiddlyWiki HTTP] Fetching full content for ${tiddlers.length} tiddlers...`);
+        // Use Promise.allSettled to avoid cascade failures
+        const results = await Promise.allSettled(tiddlers.map((t) => getTiddler(t.title)));
+        const successful = results
+            .filter((r) => r.status === 'fulfilled')
+            .map((r) => r.value)
+            .filter((t) => t !== null);
+        const failed = results.filter((r) => r.status === 'rejected').length;
+        if (failed > 0) {
+            logger.warn(`[TiddlyWiki HTTP] ${failed}/${tiddlers.length} tiddlers failed to fetch`);
+        }
+        logger.debug(`[TiddlyWiki HTTP] Successfully fetched ${successful.length} tiddlers with content`);
+        return successful;
+    }
+    return tiddlers;
+}
+/**
+ * Get a single tiddler by title
+ */
+export async function getTiddler(title) {
+    const baseUrl = await getBaseUrl();
+    const encodedTitle = encodeURIComponent(title);
+    const url = `${baseUrl}/recipes/default/tiddlers/${encodedTitle}`;
+    const titlePreview = title.length > 50 ? title.substring(0, 50) + '...' : title;
+    logger.debug(`[TiddlyWiki HTTP] getTiddler: "${titlePreview}"`);
+    const response = await fetchWithTimeout(url, { method: 'GET', headers: getHeaders() }, TIMEOUT_READ, `getTiddler("${titlePreview}")`);
+    if (response.status === 404) {
+        logger.debug(`[TiddlyWiki HTTP] getTiddler: "${titlePreview}" not found (404)`);
+        return null;
+    }
+    if (!response.ok) {
+        const errorBody = await response.text().catch(() => '(no body)');
+        logger.error(`[TiddlyWiki HTTP] getTiddler failed: ${response.status} ${response.statusText} - ${errorBody}`);
+        throw new Error(`Failed to get tiddler "${title}": ${response.status} ${response.statusText}`);
+    }
+    logger.debug(`[TiddlyWiki HTTP] getTiddler: "${titlePreview}" OK`);
+    return (await response.json());
+}
+/**
+ * Create or update a tiddler
+ */
+export async function putTiddler(tiddler) {
+    const baseUrl = await getBaseUrl();
+    const encodedTitle = encodeURIComponent(tiddler.title);
+    const url = `${baseUrl}/recipes/default/tiddlers/${encodedTitle}`;
+    // Remove server-managed fields (but keep modified/modifier which we set explicitly)
+    const { revision, bag, ...tiddlerFields } = tiddler;
+    const titlePreview = tiddler.title.length > 50 ? tiddler.title.substring(0, 50) + '...' : tiddler.title;
+    logger.debug(`[TiddlyWiki HTTP] putTiddler: "${titlePreview}" (${JSON.stringify(tiddlerFields).length} bytes)`);
+    const response = await fetchWithTimeout(url, {
+        method: 'PUT',
+        headers: getHeaders(true),
+        body: JSON.stringify(tiddlerFields),
+    }, TIMEOUT_WRITE, `putTiddler("${titlePreview}")`);
+    if (!response.ok) {
+        const errorBody = await response.text().catch(() => '(no body)');
+        logger.error(`[TiddlyWiki HTTP] putTiddler failed: ${response.status} ${response.statusText} - ${errorBody}`);
+        throw new Error(`Failed to put tiddler "${tiddler.title}": ${response.status} ${response.statusText} - ${errorBody}`);
+    }
+    logger.debug(`[TiddlyWiki HTTP] putTiddler: "${titlePreview}" OK (${response.status})`);
+}
+/**
+ * Delete a tiddler
+ */
+export async function deleteTiddler(title) {
+    const baseUrl = await getBaseUrl();
+    const encodedTitle = encodeURIComponent(title);
+    const url = `${baseUrl}/bags/default/tiddlers/${encodedTitle}`;
+    const titlePreview = title.length > 50 ? title.substring(0, 50) + '...' : title;
+    logger.debug(`[TiddlyWiki HTTP] deleteTiddler: "${titlePreview}"`);
+    const response = await fetchWithTimeout(url, {
+        method: 'DELETE',
+        headers: getHeaders(true),
+    }, TIMEOUT_WRITE, `deleteTiddler("${titlePreview}")`);
+    if (!response.ok) {
+        const errorBody = await response.text().catch(() => '(no body)');
+        logger.error(`[TiddlyWiki HTTP] deleteTiddler failed: ${response.status} ${response.statusText} - ${errorBody}`);
+        throw new Error(`Failed to delete tiddler "${title}": ${response.status} ${response.statusText} - ${errorBody}`);
+    }
+    logger.debug(`[TiddlyWiki HTTP] deleteTiddler: "${titlePreview}" OK (${response.status})`);
+}
+/**
+ * Generate a TiddlyWiki timestamp (YYYYMMDDhhmmssSSS format)
+ */
+export function generateTimestamp(date = new Date()) {
+    const pad = (n, width = 2) => n.toString().padStart(width, '0');
+    const year = date.getUTCFullYear();
+    const month = pad(date.getUTCMonth() + 1);
+    const day = pad(date.getUTCDate());
+    const hours = pad(date.getUTCHours());
+    const minutes = pad(date.getUTCMinutes());
+    const seconds = pad(date.getUTCSeconds());
+    const millis = pad(date.getUTCMilliseconds(), 3);
+    return `${year}${month}${day}${hours}${minutes}${seconds}${millis}`;
+}
+/**
+ * Create a new tiddler with proper defaults
+ */
+export function createTiddlerObject(title, text, tags = '', type = 'text/markdown', creator) {
+    return {
+        title,
+        text,
+        type,
+        tags,
+        created: generateTimestamp(),
+        creator,
+    };
+}
+/**
+ * Update an existing tiddler while preserving metadata
+ */
+export function updateTiddlerObject(current, updates, modifier) {
+    return {
+        ...current,
+        ...updates,
+        // Always preserve these fields from the current tiddler
+        title: current.title,
+        created: current.created,
+        creator: current.creator,
+        // Set modification metadata
+        modified: generateTimestamp(),
+        modifier,
+        // Remove server-managed fields
+        revision: undefined,
+        bag: undefined,
+    };
+}
+//# sourceMappingURL=tiddlywiki-http.js.map

package/dist/tiddlywiki-http.js.map

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

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

@@ -0,0 +1,15 @@
+import { type Tiddler } from '../tiddlywiki-http.js';
+import type { ToolResult } from './types.js';
+import { CreateTiddlerInput } from './types.js';
+/**
+ * Format a tiddler for preview display.
+ * Exported for use by delete-tiddler handler.
+ */
+export declare function formatTiddlerPreview(tiddler: Tiddler): string;
+/**
+ * Handle create_tiddler tool requests.
+ * Checks for duplicates, creates the tiddler, and returns a preview.
+ */
+export declare function handleCreateTiddler(args: unknown): Promise<ToolResult>;
+export { CreateTiddlerInput };
+//# sourceMappingURL=create-tiddler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-tiddler.d.ts","sourceRoot":"","sources":["../../src/tools/create-tiddler.ts"],"names":[],"mappings":"AAGA,OAAO,EAKL,KAAK,OAAO,EACb,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAa7D;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,CA0C5E;AAGD,OAAO,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/tools/create-tiddler.js

@@ -0,0 +1,61 @@
+// ABOUTME: Handler for the create_tiddler MCP tool
+// ABOUTME: Creates new tiddlers with preview and custom field support
+import { getTiddler, putTiddler, createTiddlerObject, getAuthUser, } from '../tiddlywiki-http.js';
+import { CreateTiddlerInput } from './types.js';
+/**
+ * Format a tiddler for preview display.
+ * Exported for use by delete-tiddler handler.
+ */
+export function formatTiddlerPreview(tiddler) {
+    const lines = [];
+    lines.push(`**Title:** ${tiddler.title}`);
+    lines.push(`**Type:** ${tiddler.type || 'text/vnd.tiddlywiki'}`);
+    lines.push(`**Tags:** ${tiddler.tags || '(none)'}`);
+    lines.push('');
+    lines.push('**Content:**');
+    lines.push('```');
+    lines.push(tiddler.text || '(empty)');
+    lines.push('```');
+    return lines.join('\n');
+}
+/**
+ * Handle create_tiddler tool requests.
+ * Checks for duplicates, creates the tiddler, and returns a preview.
+ */
+export async function handleCreateTiddler(args) {
+    const input = CreateTiddlerInput.parse(args);
+    // Check if tiddler already exists
+    const existing = await getTiddler(input.title);
+    if (existing) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({ error: `Tiddler already exists: ${input.title}. Use update_tiddler to modify it.` }, null, 2),
+                },
+            ],
+            isError: true,
+        };
+    }
+    // Create new tiddler object with custom fields
+    const { title, text, tags, type, ...customFields } = input;
+    const newTiddler = {
+        ...createTiddlerObject(title, text, tags || '', type || 'text/markdown', getAuthUser()),
+        ...customFields, // Add any custom fields
+    };
+    // Generate preview
+    const preview = formatTiddlerPreview(newTiddler);
+    // Create the tiddler
+    await putTiddler(newTiddler);
+    return {
+        content: [
+            {
+                type: 'text',
+                text: `## Created: "${input.title}"\n\n${preview}`,
+            },
+        ],
+    };
+}
+// Re-export the input schema for use in tool registration
+export { CreateTiddlerInput };
+//# sourceMappingURL=create-tiddler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-tiddler.js","sourceRoot":"","sources":["../../src/tools/create-tiddler.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,sEAAsE;AAEtE,OAAO,EACL,UAAU,EACV,UAAU,EACV,mBAAmB,EACnB,WAAW,GAEZ,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAgB;IACnD,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,cAAc,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IAC1C,KAAK,CAAC,IAAI,CAAC,aAAa,OAAO,CAAC,IAAI,IAAI,qBAAqB,EAAE,CAAC,CAAC;IACjE,KAAK,CAAC,IAAI,CAAC,aAAa,OAAO,CAAC,IAAI,IAAI,QAAQ,EAAE,CAAC,CAAC;IACpD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,SAAS,CAAC,CAAC;IACtC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAElB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,IAAa;IACrD,MAAM,KAAK,GAAG,kBAAkB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAE7C,kCAAkC;IAClC,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC/C,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB,EAAE,KAAK,EAAE,2BAA2B,KAAK,CAAC,KAAK,oCAAoC,EAAE,EACrF,IAAI,EACJ,CAAC,CACF;iBACF;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,+CAA+C;IAC/C,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,YAAY,EAAE,GAAG,KAAK,CAAC;IAC3D,MAAM,UAAU,GAAG;QACjB,GAAG,mBAAmB,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,IAAI,EAAE,EAAE,IAAI,IAAI,eAAe,EAAE,WAAW,EAAE,CAAC;QACvF,GAAG,YAAY,EAAE,wBAAwB;KAC1C,CAAC;IAEF,mBAAmB;IACnB,MAAM,OAAO,GAAG,oBAAoB,CAAC,UAAU,CAAC,CAAC;IAEjD,qBAAqB;IACrB,MAAM,UAAU,CAAC,UAAU,CAAC,CAAC;IAE7B,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,gBAAgB,KAAK,CAAC,KAAK,QAAQ,OAAO,EAAE;aACnD;SACF;KACF,CAAC;AACJ,CAAC;AAED,0DAA0D;AAC1D,OAAO,EAAE,kBAAkB,EAAE,CAAC"}

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

@@ -0,0 +1,9 @@
+import type { ToolResult } from './types.js';
+import { DeleteTiddlerInput } from './types.js';
+/**
+ * Handle delete_tiddler tool requests.
+ * Shows a preview of the tiddler content before deletion.
+ */
+export declare function handleDeleteTiddler(args: unknown): Promise<ToolResult>;
+export { DeleteTiddlerInput };
+//# sourceMappingURL=delete-tiddler.d.ts.map

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

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

package/dist/tools/delete-tiddler.js

@@ -0,0 +1,40 @@
+// ABOUTME: Handler for the delete_tiddler MCP tool
+// ABOUTME: Deletes tiddlers with preview of what will be deleted
+import { getTiddler, deleteTiddler } from '../tiddlywiki-http.js';
+import { DeleteTiddlerInput } from './types.js';
+import { formatTiddlerPreview } from './create-tiddler.js';
+/**
+ * Handle delete_tiddler tool requests.
+ * Shows a preview of the tiddler content before deletion.
+ */
+export async function handleDeleteTiddler(args) {
+    const input = DeleteTiddlerInput.parse(args);
+    // Get current tiddler to show what will be deleted
+    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,
+        };
+    }
+    // Generate preview of what will be deleted
+    const preview = formatTiddlerPreview(current);
+    // Delete the tiddler
+    await deleteTiddler(input.title);
+    return {
+        content: [
+            {
+                type: 'text',
+                text: `## Deleted: "${input.title}"\n\n${preview}`,
+            },
+        ],
+    };
+}
+// Re-export the input schema for use in tool registration
+export { DeleteTiddlerInput };
+//# sourceMappingURL=delete-tiddler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"delete-tiddler.js","sourceRoot":"","sources":["../../src/tools/delete-tiddler.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,iEAAiE;AAEjE,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAElE,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE3D;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,IAAa;IACrD,MAAM,KAAK,GAAG,kBAAkB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAE7C,mDAAmD;IACnD,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC9C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,sBAAsB,KAAK,CAAC,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;iBAC9E;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,2CAA2C;IAC3C,MAAM,OAAO,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAE9C,qBAAqB;IACrB,MAAM,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAEjC,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,gBAAgB,KAAK,CAAC,KAAK,QAAQ,OAAO,EAAE;aACnD;SACF;KACF,CAAC;AACJ,CAAC;AAED,0DAA0D;AAC1D,OAAO,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/tools/index.d.ts

@@ -0,0 +1,6 @@
+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';
+export type { ToolResult, ToolDependencies, SearchTiddlersInputType, UpdateTiddlerInputType, CreateTiddlerInputType, DeleteTiddlerInputType, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAGA,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;AAC9E,YAAY,EACV,UAAU,EACV,gBAAgB,EAChB,uBAAuB,EACvB,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,YAAY,CAAC"}