@jacques-ai/server 0.0.7-alpha.1

package/dist/handlers/ws-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-utils.d.ts","sourceRoot":"","sources":["../../src/handlers/ws-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAE/B;;GAEG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,CAIlE"}

package/dist/handlers/ws-utils.js

@@ -0,0 +1,16 @@
+/**
+ * WebSocket Utilities
+ *
+ * Shared response helpers to eliminate the repeated
+ * `if (ws.readyState === WebSocket.OPEN) { ws.send(...) }` pattern.
+ */
+import { WebSocket } from 'ws';
+/**
+ * Send a JSON response to a WebSocket client if the connection is still open.
+ */
+export function sendWsResponse(ws, response) {
+    if (ws.readyState === WebSocket.OPEN) {
+        ws.send(JSON.stringify(response));
+    }
+}
+//# sourceMappingURL=ws-utils.js.map

package/dist/handlers/ws-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-utils.js","sourceRoot":"","sources":["../../src/handlers/ws-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAE/B;;GAEG;AACH,MAAM,UAAU,cAAc,CAAI,EAAa,EAAE,QAAW;IAC1D,IAAI,EAAE,CAAC,UAAU,KAAK,SAAS,CAAC,IAAI,EAAE,CAAC;QACrC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;IACpC,CAAC;AACH,CAAC"}

package/dist/http-api.d.ts

@@ -0,0 +1,26 @@
+/**
+ * HTTP API Server — Thin Orchestrator
+ *
+ * Creates an HTTP server and chains domain-specific route handlers.
+ * Each handler returns true if it handled the request, false to pass.
+ * Runs on port 4243 by default.
+ */
+import type { NotificationService } from './services/notification-service.js';
+export interface ApiLog {
+    method: string;
+    path: string;
+    status: number;
+    durationMs: number;
+    timestamp: number;
+}
+export interface HttpApiOptions {
+    port?: number;
+    silent?: boolean;
+    onApiLog?: (log: ApiLog) => void;
+    notificationService?: NotificationService;
+}
+export interface HttpApiServer {
+    stop: () => Promise<void>;
+}
+export declare function createHttpApi(options?: HttpApiOptions): Promise<HttpApiServer>;
+//# sourceMappingURL=http-api.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"http-api.d.ts","sourceRoot":"","sources":["../src/http-api.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAkB9E,MAAM,WAAW,MAAM;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;CAC3C;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAgBD,wBAAsB,aAAa,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,aAAa,CAAC,CA8HxF"}

package/dist/http-api.js

@@ -0,0 +1,148 @@
+/**
+ * HTTP API Server — Thin Orchestrator
+ *
+ * Creates an HTTP server and chains domain-specific route handlers.
+ * Each handler returns true if it handled the request, false to pass.
+ * Runs on port 4243 by default.
+ */
+import { createServer } from 'http';
+import { statSync } from 'fs';
+import { join } from 'path';
+import { sendJson, handleCors } from './routes/http-utils.js';
+import { isGuiAvailable, getGuiDistPath } from './routes/static-routes.js';
+import { usageRoutes, configRoutes, notificationRoutes, claudeRoutes, sourceRoutes, archiveRoutes, tileRoutes, syncRoutes, sessionRoutes, projectRoutes, staticRoutes, } from './routes/index.js';
+const handlers = [
+    usageRoutes,
+    sourceRoutes,
+    configRoutes,
+    sessionRoutes,
+    projectRoutes,
+    archiveRoutes,
+    notificationRoutes,
+    syncRoutes,
+    claudeRoutes,
+    tileRoutes,
+    staticRoutes,
+];
+export async function createHttpApi(options = {}) {
+    const { port = 4243, silent = false, onApiLog, notificationService } = options;
+    const log = silent ? (() => { }) : console.log.bind(console);
+    const guiAvailable = isGuiAvailable();
+    const guiDistPath = getGuiDistPath();
+    if (!guiAvailable && !silent) {
+        log('[HTTP API] GUI not built. Run: npm run build:gui');
+    }
+    else if (guiAvailable && !silent) {
+        const guiIndexPath = join(guiDistPath, 'index.html');
+        const guiSrcApp = join(guiDistPath, '..', 'src', 'App.tsx');
+        try {
+            const distMtime = statSync(guiIndexPath).mtimeMs;
+            const srcMtime = statSync(guiSrcApp).mtimeMs;
+            if (srcMtime > distMtime) {
+                log('[HTTP API] GUI build is stale. Run: npm run build:gui');
+            }
+        }
+        catch { /* ignore - source file may not exist in production */ }
+    }
+    const server = createServer(async (req, res) => {
+        const rawUrl = req.url || '/';
+        const method = req.method || 'GET';
+        const startTime = Date.now();
+        // API request logging
+        const logApiRequest = (status) => {
+            if (onApiLog && rawUrl.startsWith('/api/')) {
+                onApiLog({
+                    method,
+                    path: rawUrl.split('?')[0],
+                    status,
+                    durationMs: Date.now() - startTime,
+                    timestamp: Date.now(),
+                });
+            }
+        };
+        const originalWriteHead = res.writeHead.bind(res);
+        let responseStatus = 200;
+        res.writeHead = (statusCode, ...args) => {
+            responseStatus = statusCode;
+            // @ts-expect-error - TypeScript doesn't handle rest args well here
+            return originalWriteHead(statusCode, ...args);
+        };
+        res.on('finish', () => logApiRequest(responseStatus));
+        // CORS preflight
+        if (method === 'OPTIONS') {
+            handleCors(res);
+            return;
+        }
+        // Parse URL for route context
+        const parsedUrl = new URL(rawUrl, `http://${req.headers.host || 'localhost'}`);
+        const ctx = {
+            req,
+            res,
+            url: parsedUrl.pathname,
+            rawUrl,
+            method,
+            query: parsedUrl.searchParams,
+            notificationService,
+            log,
+        };
+        // Chain handlers — first match wins
+        for (const handler of handlers) {
+            if (await handler(ctx))
+                return;
+        }
+        // 404 fallback
+        if (rawUrl.startsWith('/api/')) {
+            sendJson(res, 404, { error: 'Not found' });
+        }
+        else if (guiAvailable) {
+            // SPA fallback for unknown GUI routes
+            const { serveStaticFile } = await import('./routes/http-utils.js');
+            const indexPath = join(guiDistPath, 'index.html');
+            if (!serveStaticFile(res, indexPath)) {
+                res.writeHead(404, { 'Content-Type': 'text/plain' });
+                res.end('Not found');
+            }
+        }
+        else {
+            res.writeHead(503, { 'Content-Type': 'text/html' });
+            res.end(`
+        <html>
+          <head><title>Jacques GUI</title></head>
+          <body style="font-family: sans-serif; padding: 40px; background: #1a1a1a; color: #fff;">
+            <h1>Jacques GUI Not Built</h1>
+            <p>Run <code style="background: #333; padding: 4px 8px; border-radius: 4px;">npm run build:gui</code> to build the GUI.</p>
+            <p>Then restart <code style="background: #333; padding: 4px 8px; border-radius: 4px;">jacques</code>.</p>
+          </body>
+        </html>
+      `);
+        }
+    });
+    return new Promise((resolve, reject) => {
+        server.on('error', (err) => {
+            if (err.code === 'EADDRINUSE') {
+                log(`[HTTP API] Port ${port} is already in use`);
+            }
+            reject(err);
+        });
+        server.listen(port, () => {
+            log(`[HTTP API] Listening on http://localhost:${port}`);
+            if (guiAvailable) {
+                log(`[HTTP API] GUI available at http://localhost:${port}`);
+            }
+            resolve({
+                stop: () => new Promise((resolveStop, rejectStop) => {
+                    server.close((err) => {
+                        if (err) {
+                            rejectStop(err);
+                        }
+                        else {
+                            log('[HTTP API] Stopped');
+                            resolveStop();
+                        }
+                    });
+                }),
+            });
+        });
+    });
+}
+//# sourceMappingURL=http-api.js.map

package/dist/http-api.js.map

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

package/dist/logger.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Logger Module
+ *
+ * Provides console interception and WebSocket broadcasting for server logs.
+ * Allows GUI to display real-time server logs.
+ */
+import type { ServerLogMessage } from './types.js';
+type LogCallback = (message: ServerLogMessage) => void;
+/**
+ * Log directly to the original console, bypassing interception.
+ * Use this for logging that should NOT be broadcast to WebSocket clients
+ * (e.g., broadcast confirmation messages, to prevent feedback loops).
+ */
+export declare function logDirect(...args: unknown[]): void;
+/**
+ * Start intercepting console output.
+ * @param options.silent When true, suppress writing to stdout/stderr
+ *   (still broadcasts to WebSocket listeners). Use in embedded/TUI mode
+ *   to prevent core module console.error calls from leaking onto the
+ *   alternate screen buffer and causing visual flickering.
+ */
+export declare function startLogInterception(options?: {
+    silent?: boolean;
+}): void;
+/**
+ * Stop intercepting console output
+ */
+export declare function stopLogInterception(): void;
+/**
+ * Add a log listener
+ */
+export declare function addLogListener(callback: LogCallback): () => void;
+/**
+ * Get log history
+ */
+export declare function getLogHistory(): ServerLogMessage[];
+/**
+ * Clear log history
+ */
+export declare function clearLogHistory(): void;
+export {};
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAGnD,KAAK,WAAW,GAAG,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC;AAevD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAElD;AAmED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAuBzE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAI1C;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,WAAW,GAAG,MAAM,IAAI,CAGhE;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,gBAAgB,EAAE,CAElD;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAEtC"}

package/dist/logger.js

@@ -0,0 +1,147 @@
+/**
+ * Logger Module
+ *
+ * Provides console interception and WebSocket broadcasting for server logs.
+ * Allows GUI to display real-time server logs.
+ */
+// Store original console methods
+const originalConsole = {
+    log: console.log.bind(console),
+    warn: console.warn.bind(console),
+    error: console.error.bind(console),
+};
+// Log listeners
+const listeners = new Set();
+// Re-entrancy guard: prevents infinite loop when broadcast() logs via console.log
+let isBroadcasting = false;
+/**
+ * Log directly to the original console, bypassing interception.
+ * Use this for logging that should NOT be broadcast to WebSocket clients
+ * (e.g., broadcast confirmation messages, to prevent feedback loops).
+ */
+export function logDirect(...args) {
+    originalConsole.log(...args);
+}
+// Max log history for new clients
+const LOG_HISTORY_SIZE = 100;
+const logHistory = [];
+/**
+ * Create a log message
+ */
+function createLogMessage(level, args, source) {
+    const message = args
+        .map(arg => {
+        if (typeof arg === 'string')
+            return arg;
+        if (arg instanceof Error)
+            return arg.message;
+        try {
+            return JSON.stringify(arg);
+        }
+        catch {
+            return String(arg);
+        }
+    })
+        .join(' ');
+    return {
+        type: 'server_log',
+        level,
+        message,
+        timestamp: Date.now(),
+        source,
+    };
+}
+/**
+ * Parse source from log message (e.g., "[Server]" or "[HTTP API]")
+ */
+function parseSource(message) {
+    const match = message.match(/^\[([^\]]+)\]/);
+    return match ? match[1] : 'Server';
+}
+/**
+ * Broadcast log to all listeners
+ */
+function broadcastLog(logMessage) {
+    // Prevent infinite recursion: broadcast() → console.log → broadcastLog → broadcast()
+    if (isBroadcasting)
+        return;
+    // Add to history
+    logHistory.push(logMessage);
+    if (logHistory.length > LOG_HISTORY_SIZE) {
+        logHistory.shift();
+    }
+    // Notify listeners (with re-entrancy guard)
+    isBroadcasting = true;
+    try {
+        for (const listener of listeners) {
+            try {
+                listener(logMessage);
+            }
+            catch {
+                // Ignore listener errors
+            }
+        }
+    }
+    finally {
+        isBroadcasting = false;
+    }
+}
+/**
+ * Start intercepting console output.
+ * @param options.silent When true, suppress writing to stdout/stderr
+ *   (still broadcasts to WebSocket listeners). Use in embedded/TUI mode
+ *   to prevent core module console.error calls from leaking onto the
+ *   alternate screen buffer and causing visual flickering.
+ */
+export function startLogInterception(options) {
+    const suppressConsole = options?.silent ?? false;
+    console.log = (...args) => {
+        if (!suppressConsole)
+            originalConsole.log(...args);
+        const firstArg = String(args[0] || '');
+        const source = parseSource(firstArg);
+        broadcastLog(createLogMessage('info', args, source));
+    };
+    console.warn = (...args) => {
+        if (!suppressConsole)
+            originalConsole.warn(...args);
+        const firstArg = String(args[0] || '');
+        const source = parseSource(firstArg);
+        broadcastLog(createLogMessage('warn', args, source));
+    };
+    console.error = (...args) => {
+        if (!suppressConsole)
+            originalConsole.error(...args);
+        const firstArg = String(args[0] || '');
+        const source = parseSource(firstArg);
+        broadcastLog(createLogMessage('error', args, source));
+    };
+}
+/**
+ * Stop intercepting console output
+ */
+export function stopLogInterception() {
+    console.log = originalConsole.log;
+    console.warn = originalConsole.warn;
+    console.error = originalConsole.error;
+}
+/**
+ * Add a log listener
+ */
+export function addLogListener(callback) {
+    listeners.add(callback);
+    return () => listeners.delete(callback);
+}
+/**
+ * Get log history
+ */
+export function getLogHistory() {
+    return [...logHistory];
+}
+/**
+ * Clear log history
+ */
+export function clearLogHistory() {
+    logHistory.length = 0;
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

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

package/dist/logging/logger-factory.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Logger Factory
+ *
+ * Provides injectable logging for server components.
+ * Replaces duplicated logging boilerplate across modules.
+ */
+/**
+ * Logger interface for dependency injection
+ */
+export interface Logger {
+    log: (...args: unknown[]) => void;
+    warn: (...args: unknown[]) => void;
+    error: (...args: unknown[]) => void;
+}
+/**
+ * Options for creating a logger
+ */
+export interface LoggerOptions {
+    /** Suppress all output */
+    silent?: boolean;
+    /** Optional prefix prepended to all log messages */
+    prefix?: string;
+}
+/**
+ * Create a logger instance
+ *
+ * @param options Logger configuration options
+ * @returns Logger instance
+ *
+ * @example
+ * // Silent logger (no output)
+ * const logger = createLogger({ silent: true });
+ *
+ * @example
+ * // Logger with prefix
+ * const logger = createLogger({ prefix: 'MyComponent' });
+ * logger.log('Hello'); // Output: [MyComponent] Hello
+ */
+export declare function createLogger(options?: LoggerOptions): Logger;
+/**
+ * Create a logger from a silent flag (backward compatibility helper)
+ *
+ * This allows components to accept either a Logger or a silent boolean
+ * for backward compatibility during the migration.
+ *
+ * @param silentOrLogger Either a boolean (silent flag) or a Logger instance
+ * @param prefix Optional prefix if creating from boolean
+ * @returns Logger instance
+ */
+export declare function resolveLogger(silentOrLogger: boolean | Logger | undefined, prefix?: string): Logger;
+//# sourceMappingURL=logger-factory.d.ts.map

package/dist/logging/logger-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger-factory.d.ts","sourceRoot":"","sources":["../../src/logging/logger-factory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,GAAG,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IAClC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACnC,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,0BAA0B;IAC1B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,oDAAoD;IACpD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,aAAkB,GAAG,MAAM,CAuBhE;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAC3B,cAAc,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,EAC5C,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,CAKR"}

package/dist/logging/logger-factory.js

@@ -0,0 +1,59 @@
+/**
+ * Logger Factory
+ *
+ * Provides injectable logging for server components.
+ * Replaces duplicated logging boilerplate across modules.
+ */
+/**
+ * Create a logger instance
+ *
+ * @param options Logger configuration options
+ * @returns Logger instance
+ *
+ * @example
+ * // Silent logger (no output)
+ * const logger = createLogger({ silent: true });
+ *
+ * @example
+ * // Logger with prefix
+ * const logger = createLogger({ prefix: 'MyComponent' });
+ * logger.log('Hello'); // Output: [MyComponent] Hello
+ */
+export function createLogger(options = {}) {
+    const { silent = false, prefix } = options;
+    if (silent) {
+        return {
+            log: () => { },
+            warn: () => { },
+            error: () => { },
+        };
+    }
+    const formatArgs = (args) => {
+        if (prefix) {
+            return [`[${prefix}]`, ...args];
+        }
+        return args;
+    };
+    return {
+        log: (...args) => console.log(...formatArgs(args)),
+        warn: (...args) => console.warn(...formatArgs(args)),
+        error: (...args) => console.error(...formatArgs(args)),
+    };
+}
+/**
+ * Create a logger from a silent flag (backward compatibility helper)
+ *
+ * This allows components to accept either a Logger or a silent boolean
+ * for backward compatibility during the migration.
+ *
+ * @param silentOrLogger Either a boolean (silent flag) or a Logger instance
+ * @param prefix Optional prefix if creating from boolean
+ * @returns Logger instance
+ */
+export function resolveLogger(silentOrLogger, prefix) {
+    if (typeof silentOrLogger === 'object' && silentOrLogger !== null) {
+        return silentOrLogger;
+    }
+    return createLogger({ silent: silentOrLogger, prefix });
+}
+//# sourceMappingURL=logger-factory.js.map

package/dist/logging/logger-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger-factory.js","sourceRoot":"","sources":["../../src/logging/logger-factory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAqBH;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,YAAY,CAAC,UAAyB,EAAE;IACtD,MAAM,EAAE,MAAM,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAE3C,IAAI,MAAM,EAAE,CAAC;QACX,OAAO;YACL,GAAG,EAAE,GAAG,EAAE,GAAE,CAAC;YACb,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;YACd,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;SAChB,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,CAAC,IAAe,EAAa,EAAE;QAChD,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,CAAC,IAAI,MAAM,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;IAEF,OAAO;QACL,GAAG,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;QAClD,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;QACpD,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;KACvD,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAC3B,cAA4C,EAC5C,MAAe;IAEf,IAAI,OAAO,cAAc,KAAK,QAAQ,IAAI,cAAc,KAAK,IAAI,EAAE,CAAC;QAClE,OAAO,cAAc,CAAC;IACxB,CAAC;IACD,OAAO,YAAY,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,CAAC,CAAC;AAC1D,CAAC"}

package/dist/mcp/search-tool.d.ts

@@ -0,0 +1,65 @@
+/**
+ * MCP Search Tool
+ *
+ * Implements the search_conversations tool for the MCP server.
+ */
+import { z } from "zod";
+interface SearchResult {
+    rank: number;
+    id: string;
+    score: number;
+    title: string;
+    project: string;
+    date: string;
+    preview: string;
+    filesModified: string[];
+    technologies: string[];
+    messageCount: number;
+    durationMinutes: number;
+}
+interface SearchOutput {
+    query: string;
+    filters: {
+        project?: string;
+        dateFrom?: string;
+        dateTo?: string;
+        technologies?: string[];
+    };
+    totalMatches: number;
+    showing: {
+        from: number;
+        to: number;
+    };
+    hasMore: boolean;
+    results: SearchResult[];
+}
+export declare const searchConversationsSchema: z.ZodObject<{
+    query: z.ZodString;
+    project: z.ZodOptional<z.ZodString>;
+    dateFrom: z.ZodOptional<z.ZodString>;
+    dateTo: z.ZodOptional<z.ZodString>;
+    technologies: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    query: string;
+    limit: number;
+    offset: number;
+    project?: string | undefined;
+    dateFrom?: string | undefined;
+    dateTo?: string | undefined;
+    technologies?: string[] | undefined;
+}, {
+    query: string;
+    project?: string | undefined;
+    dateFrom?: string | undefined;
+    dateTo?: string | undefined;
+    technologies?: string[] | undefined;
+    limit?: number | undefined;
+    offset?: number | undefined;
+}>;
+export type SearchConversationsInput = z.infer<typeof searchConversationsSchema>;
+export declare function searchConversations(input: SearchConversationsInput): Promise<SearchOutput>;
+export declare function handleSearchConversations(args: unknown): Promise<string>;
+export {};
+//# sourceMappingURL=search-tool.d.ts.map

package/dist/mcp/search-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-tool.d.ts","sourceRoot":"","sources":["../../src/mcp/search-tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAsDxB,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,UAAU,YAAY;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE;QACP,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;KACzB,CAAC;IACF,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB;AAMD,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;EAQpC,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AA4FjF,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,wBAAwB,GAC9B,OAAO,CAAC,YAAY,CAAC,CA8EvB;AAMD,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC,MAAM,CAAC,CAYjB"}