@plusplusoneplusplus/coc 1.0.0

package/dist/server/wiki/context-builder.js

@@ -0,0 +1,284 @@
+"use strict";
+/**
+ * Context Builder
+ *
+ * TF-IDF indexing and context retrieval for the AI Q&A feature.
+ * Builds an in-memory index of component articles on startup and
+ * retrieves the most relevant components for a given question.
+ *
+ * No external dependencies — TF-IDF is ~100 lines.
+ *
+ * Cross-platform compatible (Linux/Mac/Windows).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContextBuilder = void 0;
+exports.tokenize = tokenize;
+// ============================================================================
+// Stop Words
+// ============================================================================
+/** Boost factor applied when a component name matches a query term */
+const NAME_MATCH_BOOST = 1.5;
+const STOP_WORDS = new Set([
+    'the', 'a', 'an', 'and', 'or', 'but', 'in', 'on', 'at', 'to', 'for',
+    'of', 'with', 'by', 'from', 'is', 'are', 'was', 'were', 'be', 'been',
+    'being', 'have', 'has', 'had', 'do', 'does', 'did', 'will', 'would',
+    'could', 'should', 'may', 'might', 'shall', 'can', 'this', 'that',
+    'these', 'those', 'it', 'its', 'i', 'we', 'you', 'he', 'she', 'they',
+    'me', 'us', 'him', 'her', 'them', 'my', 'our', 'your', 'his', 'their',
+    'what', 'which', 'who', 'whom', 'how', 'when', 'where', 'why', 'not',
+    'no', 'if', 'then', 'else', 'so', 'as', 'just', 'also', 'than',
+    'very', 'too', 'more', 'most', 'each', 'every', 'all', 'any', 'some',
+    'about', 'up', 'out', 'into', 'over', 'after', 'before', 'between',
+]);
+// ============================================================================
+// ContextBuilder Class
+// ============================================================================
+/**
+ * Builds a TF-IDF index from component articles and retrieves relevant context.
+ */
+class ContextBuilder {
+    constructor(graph, markdownData, themeMarkdownData) {
+        this.documents = [];
+        this.inverseDocFreq = new Map();
+        this.graph = graph;
+        this.markdownData = markdownData;
+        this.themeMarkdownData = themeMarkdownData || {};
+        this.buildIndex();
+    }
+    /**
+     * Retrieve the most relevant components for a question.
+     *
+     * @param question - The user's question
+     * @param maxComponents - Maximum number of components to return (default: 5)
+     * @param maxThemes - Maximum number of theme articles to return (default: 3)
+     * @returns Retrieved context with component IDs, markdown, and graph summary
+     */
+    retrieve(question, maxComponents = 5, maxThemes = 3) {
+        const queryTerms = tokenize(question);
+        // Score each document
+        const componentScores = [];
+        const themeScores = [];
+        for (const doc of this.documents) {
+            let score = 0;
+            for (const term of queryTerms) {
+                const tf = doc.termFrequencies.get(term) || 0;
+                const idf = this.inverseDocFreq.get(term) || 0;
+                score += tf * idf;
+            }
+            // Boost if component name matches a query term
+            const nameLower = doc.name.toLowerCase();
+            for (const term of queryTerms) {
+                if (nameLower.includes(term)) {
+                    score *= NAME_MATCH_BOOST;
+                }
+            }
+            if (score > 0) {
+                if (doc.source === 'theme') {
+                    themeScores.push({ docId: doc.componentId, score });
+                }
+                else {
+                    componentScores.push({ componentId: doc.componentId, score });
+                }
+            }
+        }
+        // Sort by score descending
+        componentScores.sort((a, b) => b.score - a.score);
+        themeScores.sort((a, b) => b.score - a.score);
+        // Select top-K components
+        const topComponents = componentScores.slice(0, maxComponents);
+        const selectedIds = topComponents.map(s => s.componentId);
+        // Expand with 1-hop dependency neighbors if we have room
+        const expandedIds = new Set(selectedIds);
+        if (selectedIds.length < maxComponents) {
+            for (const componentId of selectedIds) {
+                const mod = this.graph.components.find(m => m.id === componentId);
+                if (mod) {
+                    for (const dep of mod.dependencies) {
+                        if (expandedIds.size >= maxComponents)
+                            break;
+                        expandedIds.add(dep);
+                    }
+                    for (const dep of mod.dependents) {
+                        if (expandedIds.size >= maxComponents)
+                            break;
+                        expandedIds.add(dep);
+                    }
+                }
+            }
+        }
+        const finalIds = Array.from(expandedIds);
+        // Build context text for components
+        const contextParts = [];
+        for (const componentId of finalIds) {
+            const markdown = this.markdownData[componentId];
+            if (markdown) {
+                contextParts.push(`## Component: ${componentId}\n\n${markdown}`);
+            }
+        }
+        // Select top-K theme articles
+        const selectedThemes = themeScores.slice(0, maxThemes);
+        const themeContexts = [];
+        const themes = this.graph.themes || [];
+        for (const { docId } of selectedThemes) {
+            // docId format: theme:{themeId}:{slug}
+            const parts = docId.split(':');
+            if (parts.length < 3)
+                continue;
+            const themeId = parts[1];
+            const slug = parts.slice(2).join(':');
+            const meta = themes.find(t => t.id === themeId);
+            if (!meta)
+                continue;
+            const articleMeta = meta.articles.find(a => a.slug === slug);
+            const content = this.themeMarkdownData[docId] || '';
+            if (!content)
+                continue;
+            themeContexts.push({
+                themeId,
+                slug,
+                title: articleMeta?.title || slug,
+                content,
+            });
+            contextParts.push(`## Theme Article: ${articleMeta?.title || slug}\n\nSource: themes/${themeId}/${slug}.md\n\n${content}`);
+        }
+        // Build graph summary
+        const graphSummary = this.buildGraphSummary();
+        return {
+            componentIds: finalIds,
+            contextText: contextParts.join('\n\n---\n\n'),
+            graphSummary,
+            themeContexts,
+        };
+    }
+    /**
+     * Get the number of indexed documents.
+     */
+    get documentCount() {
+        return this.documents.length;
+    }
+    /**
+     * Get the vocabulary size.
+     */
+    get vocabularySize() {
+        return this.inverseDocFreq.size;
+    }
+    // ========================================================================
+    // Private: Index Building
+    // ========================================================================
+    buildIndex() {
+        // Index each component article
+        for (const mod of this.graph.components) {
+            const markdown = this.markdownData[mod.id] || '';
+            // Combine component metadata with markdown content for better matching
+            const text = [
+                mod.name,
+                mod.purpose,
+                mod.category,
+                mod.path,
+                mod.keyFiles.join(' '),
+                markdown,
+            ].join(' ');
+            const terms = tokenize(text);
+            const termFrequencies = new Map();
+            for (const term of terms) {
+                termFrequencies.set(term, (termFrequencies.get(term) || 0) + 1);
+            }
+            // Normalize term frequencies
+            const termCount = terms.length;
+            if (termCount > 0) {
+                for (const [term, count] of termFrequencies) {
+                    termFrequencies.set(term, count / termCount);
+                }
+            }
+            this.documents.push({
+                componentId: mod.id,
+                name: mod.name,
+                category: mod.category,
+                source: 'component',
+                termFrequencies,
+                termCount,
+            });
+        }
+        // Index theme articles
+        const themes = this.graph.themes || [];
+        for (const theme of themes) {
+            for (const article of theme.articles) {
+                const docId = `theme:${theme.id}:${article.slug}`;
+                const markdown = this.themeMarkdownData[docId] || '';
+                const involvedComponentNames = theme.involvedComponentIds
+                    .map(id => this.graph.components.find(m => m.id === id)?.name || '')
+                    .filter(Boolean);
+                const text = [
+                    theme.title,
+                    theme.description,
+                    article.title,
+                    involvedComponentNames.join(' '),
+                    markdown,
+                ].join(' ');
+                const terms = tokenize(text);
+                const termFrequencies = new Map();
+                for (const term of terms) {
+                    termFrequencies.set(term, (termFrequencies.get(term) || 0) + 1);
+                }
+                const termCount = terms.length;
+                if (termCount > 0) {
+                    for (const [term, count] of termFrequencies) {
+                        termFrequencies.set(term, count / termCount);
+                    }
+                }
+                this.documents.push({
+                    componentId: docId,
+                    name: article.title || theme.title,
+                    category: 'theme',
+                    source: 'theme',
+                    termFrequencies,
+                    termCount,
+                });
+            }
+        }
+        // Compute IDF for each term
+        const N = this.documents.length;
+        const docFreq = new Map();
+        for (const doc of this.documents) {
+            for (const term of doc.termFrequencies.keys()) {
+                docFreq.set(term, (docFreq.get(term) || 0) + 1);
+            }
+        }
+        for (const [term, df] of docFreq) {
+            // IDF = log(N / df) + 1 (smoothed)
+            this.inverseDocFreq.set(term, Math.log(N / df) + 1);
+        }
+    }
+    buildGraphSummary() {
+        const lines = [];
+        lines.push(`Project: ${this.graph.project.name}`);
+        lines.push(`Description: ${this.graph.project.description}`);
+        lines.push(`Language: ${this.graph.project.language}`);
+        lines.push(`Components: ${this.graph.components.length}`);
+        lines.push('');
+        lines.push('Component Graph:');
+        for (const mod of this.graph.components) {
+            const deps = mod.dependencies.length > 0
+                ? ` → depends on: ${mod.dependencies.join(', ')}`
+                : '';
+            lines.push(`  - ${mod.name} (${mod.id}): ${mod.purpose}${deps}`);
+        }
+        return lines.join('\n');
+    }
+}
+exports.ContextBuilder = ContextBuilder;
+// ============================================================================
+// Tokenization
+// ============================================================================
+/**
+ * Tokenize text into lowercase terms, removing stop words and short words.
+ */
+function tokenize(text) {
+    return text
+        .toLowerCase()
+        .replace(/[^a-z0-9\s-_]/g, ' ')
+        .split(/\s+/)
+        .filter(word => word.length >= 2 &&
+        !STOP_WORDS.has(word));
+}
+//# sourceMappingURL=context-builder.js.map

package/dist/server/wiki/context-builder.js.map

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

package/dist/server/wiki/conversation-session-manager.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Conversation Session Manager
+ *
+ * Manages server-side conversation sessions for the Ask AI feature.
+ * Each session wraps an AskAIFunction and tracks turn history so
+ * follow-up questions can reuse the same AI context.
+ *
+ * Features:
+ *   - Session creation with auto-generated IDs
+ *   - Session lookup and reuse for multi-turn conversations
+ *   - Auto-cleanup of idle sessions (configurable timeout)
+ *   - Max concurrent sessions limit
+ *   - Per-session mutex to prevent concurrent sends
+ */
+import type { AskAIFunction } from './types';
+/** A single conversation session. */
+export interface ConversationSession {
+    /** Unique session identifier */
+    sessionId: string;
+    /** Number of AI turns completed */
+    turnCount: number;
+    /** Timestamp of last activity */
+    lastUsedAt: number;
+    /** Timestamp of session creation */
+    createdAt: number;
+    /** Whether a send is currently in progress */
+    busy: boolean;
+}
+/** Options for creating the ConversationSessionManager. */
+export interface ConversationSessionManagerOptions {
+    /** The AI send function to use for all sessions */
+    sendMessage: AskAIFunction;
+    /** Max idle time in ms before auto-cleanup (default: 600000 = 10 minutes) */
+    idleTimeoutMs?: number;
+    /** Max concurrent sessions (default: 5) */
+    maxSessions?: number;
+    /** Cleanup interval in ms (default: 60000 = 1 minute) */
+    cleanupIntervalMs?: number;
+}
+/** Result of sending a message through a session. */
+export interface SessionSendResult {
+    /** The AI response */
+    response: string;
+    /** The session ID (same as input, or new if created) */
+    sessionId: string;
+}
+/**
+ * Manages conversation sessions for multi-turn AI Q&A.
+ *
+ * Each session tracks its turn count and last-used time. Sessions are
+ * automatically cleaned up when idle for too long. A per-session mutex
+ * prevents concurrent AI calls on the same session.
+ */
+export declare class ConversationSessionManager {
+    private readonly sessions;
+    private readonly sendMessage;
+    private readonly idleTimeoutMs;
+    private readonly maxSessions;
+    private cleanupTimer;
+    constructor(options: ConversationSessionManagerOptions);
+    /**
+     * Create a new conversation session.
+     * @returns The new session, or null if max sessions reached.
+     */
+    create(): ConversationSession | null;
+    /**
+     * Get an existing session by ID.
+     * @returns The session, or undefined if not found.
+     */
+    get(sessionId: string): ConversationSession | undefined;
+    /**
+     * Send a message using a session.
+     * If the session is busy, rejects with an error.
+     */
+    send(sessionId: string, prompt: string, options?: {
+        model?: string;
+        workingDirectory?: string;
+        onStreamingChunk?: (chunk: string) => void;
+    }): Promise<SessionSendResult>;
+    /**
+     * Destroy a specific session.
+     */
+    destroy(sessionId: string): boolean;
+    /**
+     * Destroy all sessions and stop the cleanup timer.
+     */
+    destroyAll(): void;
+    /**
+     * Get the number of active sessions.
+     */
+    get size(): number;
+    /**
+     * Get all session IDs.
+     */
+    get sessionIds(): string[];
+    /**
+     * Remove sessions that have been idle for longer than idleTimeoutMs.
+     */
+    private cleanupIdleSessions;
+    /**
+     * Evict the oldest idle session to make room for a new one.
+     * @returns true if a session was evicted.
+     */
+    private evictOldestIdle;
+}
+//# sourceMappingURL=conversation-session-manager.d.ts.map

package/dist/server/wiki/conversation-session-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-session-manager.d.ts","sourceRoot":"","sources":["../../../src/server/wiki/conversation-session-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAM7C,qCAAqC;AACrC,MAAM,WAAW,mBAAmB;IAChC,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,IAAI,EAAE,OAAO,CAAC;CACjB;AAED,2DAA2D;AAC3D,MAAM,WAAW,iCAAiC;IAC9C,mDAAmD;IACnD,WAAW,EAAE,aAAa,CAAC;IAC3B,6EAA6E;IAC7E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,qDAAqD;AACrD,MAAM,WAAW,iBAAiB;IAC9B,sBAAsB;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC;CACrB;AAcD;;;;;;GAMG;AACH,qBAAa,0BAA0B;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA0C;IACnE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAgB;IAC5C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,YAAY,CAA+C;gBAEvD,OAAO,EAAE,iCAAiC;IAatD;;;OAGG;IACH,MAAM,IAAI,mBAAmB,GAAG,IAAI;IAsBpC;;;OAGG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS;IAIvD;;;OAGG;IACG,IAAI,CACN,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;QACN,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;KAC9C,GACF,OAAO,CAAC,iBAAiB,CAAC;IA2B7B;;OAEG;IACH,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAInC;;OAEG;IACH,UAAU,IAAI,IAAI;IAQlB;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,MAAM,EAAE,CAEzB;IAED;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAS3B;;;OAGG;IACH,OAAO,CAAC,eAAe;CAiB1B"}

package/dist/server/wiki/conversation-session-manager.js

@@ -0,0 +1,179 @@
+"use strict";
+/**
+ * Conversation Session Manager
+ *
+ * Manages server-side conversation sessions for the Ask AI feature.
+ * Each session wraps an AskAIFunction and tracks turn history so
+ * follow-up questions can reuse the same AI context.
+ *
+ * Features:
+ *   - Session creation with auto-generated IDs
+ *   - Session lookup and reuse for multi-turn conversations
+ *   - Auto-cleanup of idle sessions (configurable timeout)
+ *   - Max concurrent sessions limit
+ *   - Per-session mutex to prevent concurrent sends
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConversationSessionManager = void 0;
+// ============================================================================
+// Constants
+// ============================================================================
+const DEFAULT_IDLE_TIMEOUT_MS = 10 * 60 * 1000; // 10 minutes
+const DEFAULT_MAX_SESSIONS = 5;
+const DEFAULT_CLEANUP_INTERVAL_MS = 60 * 1000; // 1 minute
+// ============================================================================
+// Manager
+// ============================================================================
+/**
+ * Manages conversation sessions for multi-turn AI Q&A.
+ *
+ * Each session tracks its turn count and last-used time. Sessions are
+ * automatically cleaned up when idle for too long. A per-session mutex
+ * prevents concurrent AI calls on the same session.
+ */
+class ConversationSessionManager {
+    constructor(options) {
+        this.sessions = new Map();
+        this.cleanupTimer = null;
+        this.sendMessage = options.sendMessage;
+        this.idleTimeoutMs = options.idleTimeoutMs ?? DEFAULT_IDLE_TIMEOUT_MS;
+        this.maxSessions = options.maxSessions ?? DEFAULT_MAX_SESSIONS;
+        const cleanupIntervalMs = options.cleanupIntervalMs ?? DEFAULT_CLEANUP_INTERVAL_MS;
+        this.cleanupTimer = setInterval(() => this.cleanupIdleSessions(), cleanupIntervalMs);
+        // Don't prevent Node.js from exiting
+        if (this.cleanupTimer.unref) {
+            this.cleanupTimer.unref();
+        }
+    }
+    /**
+     * Create a new conversation session.
+     * @returns The new session, or null if max sessions reached.
+     */
+    create() {
+        if (this.sessions.size >= this.maxSessions) {
+            // Try to evict the oldest idle session
+            const evicted = this.evictOldestIdle();
+            if (!evicted) {
+                return null;
+            }
+        }
+        const sessionId = generateSessionId();
+        const session = {
+            sessionId,
+            turnCount: 0,
+            lastUsedAt: Date.now(),
+            createdAt: Date.now(),
+            busy: false,
+        };
+        this.sessions.set(sessionId, session);
+        return session;
+    }
+    /**
+     * Get an existing session by ID.
+     * @returns The session, or undefined if not found.
+     */
+    get(sessionId) {
+        return this.sessions.get(sessionId);
+    }
+    /**
+     * Send a message using a session.
+     * If the session is busy, rejects with an error.
+     */
+    async send(sessionId, prompt, options) {
+        const session = this.sessions.get(sessionId);
+        if (!session) {
+            throw new Error(`Session not found: ${sessionId}`);
+        }
+        if (session.busy) {
+            throw new Error(`Session is busy: ${sessionId}`);
+        }
+        session.busy = true;
+        try {
+            const response = await this.sendMessage(prompt, {
+                model: options?.model,
+                workingDirectory: options?.workingDirectory,
+                onStreamingChunk: options?.onStreamingChunk,
+            });
+            session.turnCount++;
+            session.lastUsedAt = Date.now();
+            return { response, sessionId };
+        }
+        finally {
+            session.busy = false;
+        }
+    }
+    /**
+     * Destroy a specific session.
+     */
+    destroy(sessionId) {
+        return this.sessions.delete(sessionId);
+    }
+    /**
+     * Destroy all sessions and stop the cleanup timer.
+     */
+    destroyAll() {
+        this.sessions.clear();
+        if (this.cleanupTimer) {
+            clearInterval(this.cleanupTimer);
+            this.cleanupTimer = null;
+        }
+    }
+    /**
+     * Get the number of active sessions.
+     */
+    get size() {
+        return this.sessions.size;
+    }
+    /**
+     * Get all session IDs.
+     */
+    get sessionIds() {
+        return Array.from(this.sessions.keys());
+    }
+    /**
+     * Remove sessions that have been idle for longer than idleTimeoutMs.
+     */
+    cleanupIdleSessions() {
+        const now = Date.now();
+        for (const [id, session] of this.sessions) {
+            if (!session.busy && (now - session.lastUsedAt) > this.idleTimeoutMs) {
+                this.sessions.delete(id);
+            }
+        }
+    }
+    /**
+     * Evict the oldest idle session to make room for a new one.
+     * @returns true if a session was evicted.
+     */
+    evictOldestIdle() {
+        let oldestId = null;
+        let oldestTime = Infinity;
+        for (const [id, session] of this.sessions) {
+            if (!session.busy && session.lastUsedAt < oldestTime) {
+                oldestTime = session.lastUsedAt;
+                oldestId = id;
+            }
+        }
+        if (oldestId) {
+            this.sessions.delete(oldestId);
+            return true;
+        }
+        return false;
+    }
+}
+exports.ConversationSessionManager = ConversationSessionManager;
+// ============================================================================
+// Helpers
+// ============================================================================
+/**
+ * Generate a random session ID.
+ */
+function generateSessionId() {
+    const chars = 'abcdefghijklmnopqrstuvwxyz0123456789';
+    let id = '';
+    for (let i = 0; i < 12; i++) {
+        id += chars[Math.floor(Math.random() * chars.length)];
+    }
+    return id;
+}
+//# sourceMappingURL=conversation-session-manager.js.map

package/dist/server/wiki/conversation-session-manager.js.map

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

package/dist/server/wiki/explore-handler.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Wiki Explore Handler
+ *
+ * POST /api/wikis/:wikiId/explore/:componentId — On-demand deep-dive.
+ * Adapted from deep-wiki's explore-handler for multi-wiki CoC server.
+ *
+ * The shared core logic lives in `handleExploreCore()`, which is also used by
+ * the deep-wiki standalone handler (`dw-explore-handler.ts`).
+ *
+ * Cross-platform compatible (Linux/Mac/Windows).
+ */
+import type { IncomingMessage, ServerResponse } from 'http';
+import type { WikiManager } from './wiki-manager';
+import type { AskAIFunction } from './types';
+import type { ResolvedExploreContext } from './wiki-backend';
+/** Request body for POST /api/wikis/:wikiId/explore/:componentId. */
+export interface ExploreRequest {
+    question?: string;
+    depth?: 'normal' | 'deep';
+}
+/** Options for the explore handler. */
+export interface WikiExploreHandlerOptions {
+    wikiManager: WikiManager;
+    aiSendMessage?: AskAIFunction;
+    aiModel?: string;
+    aiWorkingDirectory?: string;
+}
+/**
+ * Handle POST /api/wikis/:wikiId/explore/:componentId — streamed as SSE.
+ */
+export declare function handleWikiExploreRequest(req: IncomingMessage, res: ServerResponse, wikiId: string, componentId: string, options: WikiExploreHandlerOptions): Promise<void>;
+/**
+ * Core explore handler logic — shared between the multi-wiki handler
+ * (`handleWikiExploreRequest`) and the standalone deep-wiki handler
+ * (`handleExploreRequest` in `dw-explore-handler.ts`).
+ *
+ * The caller is responsible for:
+ *   - Validating wiki access and AI availability
+ *   - Resolving the explore context
+ *
+ * This function handles:
+ *   - Component lookup and validation
+ *   - Body parsing
+ *   - SSE header setup and streaming
+ *   - Prompt building and AI invocation
+ *   - `res.end()`
+ */
+export declare function handleExploreCore(req: IncomingMessage, res: ServerResponse, componentId: string, context: ResolvedExploreContext): Promise<void>;
+/**
+ * Build the AI prompt for deep-dive exploration.
+ */
+export declare function buildExplorePrompt(mod: {
+    id: string;
+    name: string;
+    category: string;
+    path: string;
+    purpose: string;
+    keyFiles: string[];
+    dependencies: string[];
+    dependents: string[];
+}, existingMarkdown: string, graph: {
+    project: {
+        name: string;
+        description: string;
+        language: string;
+    };
+    components: Array<{
+        id: string;
+        name: string;
+        purpose: string;
+        dependencies: string[];
+    }>;
+}, request: ExploreRequest): string;
+//# sourceMappingURL=explore-handler.d.ts.map