@copilotkit/pathfinder 1.1.0 → 1.5.0

package/dist/indexing/providers/slack.js

@@ -0,0 +1,192 @@
+// SlackDataProvider — Slack thread acquisition via Web API + LLM distillation.
+// Implements DataProvider: fetches threads from configured channels, distills
+// them into Q&A pairs, and returns ContentItems for the indexing pipeline.
+import OpenAI from 'openai';
+import { SlackApiClient } from './slack-api.js';
+import { distillThread } from '../distiller.js';
+import { getConfig } from '../../config.js';
+export class SlackDataProvider {
+    config;
+    apiClient;
+    openaiClient;
+    logPrefix;
+    constructor(config, options) {
+        if (config.type !== 'slack') {
+            throw new Error('SlackDataProvider requires a slack source config');
+        }
+        this.config = config;
+        const token = options.slackBotToken;
+        if (!token) {
+            throw new Error('SlackDataProvider requires a slackBotToken in provider options');
+        }
+        this.apiClient = new SlackApiClient({ token });
+        this.openaiClient = new OpenAI({ apiKey: getConfig().openaiApiKey });
+        this.logPrefix = `[slack-provider:${config.name}]`;
+    }
+    async fullAcquire() {
+        console.log(`${this.logPrefix} Starting full acquire for ${this.config.channels.length} channel(s)`);
+        const allItems = [];
+        let maxTimestamp = '0';
+        let failedChannels = 0;
+        for (const channelId of this.config.channels) {
+            try {
+                const { items, latestTs } = await this.processChannel(channelId);
+                allItems.push(...items);
+                if (latestTs > maxTimestamp)
+                    maxTimestamp = latestTs;
+            }
+            catch (err) {
+                failedChannels++;
+                const msg = err instanceof Error ? err.message : String(err);
+                console.error(`${this.logPrefix} Failed to process channel ${channelId}: ${msg}`);
+            }
+        }
+        if (failedChannels === this.config.channels.length) {
+            throw new Error(`All ${failedChannels} channel(s) failed during acquire`);
+        }
+        console.log(`${this.logPrefix} Full acquire complete: ${allItems.length} Q&A pairs from ${this.config.channels.length} channel(s)`);
+        return {
+            items: allItems,
+            removedIds: [],
+            stateToken: maxTimestamp,
+        };
+    }
+    async incrementalAcquire(lastStateToken) {
+        console.log(`${this.logPrefix} Starting incremental acquire since ${lastStateToken}`);
+        const allItems = [];
+        let maxTimestamp = lastStateToken;
+        let failedChannels = 0;
+        for (const channelId of this.config.channels) {
+            try {
+                const { items, latestTs } = await this.processChannel(channelId, lastStateToken);
+                allItems.push(...items);
+                if (latestTs > maxTimestamp)
+                    maxTimestamp = latestTs;
+            }
+            catch (err) {
+                failedChannels++;
+                const msg = err instanceof Error ? err.message : String(err);
+                console.error(`${this.logPrefix} Failed to process channel ${channelId}: ${msg}`);
+            }
+        }
+        if (failedChannels === this.config.channels.length) {
+            throw new Error(`All ${failedChannels} channel(s) failed during acquire`);
+        }
+        console.log(`${this.logPrefix} Incremental acquire complete: ${allItems.length} Q&A pairs`);
+        return {
+            items: allItems,
+            removedIds: [], // Slack API doesn't surface deletions; caught on next full acquire
+            stateToken: maxTimestamp,
+        };
+    }
+    async getCurrentStateToken() {
+        let maxTimestamp = '0';
+        for (const channelId of this.config.channels) {
+            try {
+                const messages = await this.apiClient.fetchChannelHistory(channelId, undefined, 1);
+                if (messages.length > 0) {
+                    // Messages are returned newest-first by Slack
+                    const latest = messages[0].ts;
+                    if (latest > maxTimestamp)
+                        maxTimestamp = latest;
+                }
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                console.warn(`${this.logPrefix} Failed to check channel ${channelId}: ${msg}`);
+            }
+        }
+        return maxTimestamp === '0' ? null : maxTimestamp;
+    }
+    // -----------------------------------------------------------------------
+    // Private helpers
+    // -----------------------------------------------------------------------
+    /**
+     * Process a single channel: fetch threads, distill, return items.
+     */
+    async processChannel(channelId, oldest) {
+        const messages = await this.apiClient.fetchChannelHistory(channelId, oldest);
+        const items = [];
+        let latestTs = oldest ?? '0';
+        // Filter to threaded messages with sufficient replies
+        const threads = messages.filter(m => m.thread_ts === m.ts && (m.reply_count ?? 0) >= this.config.min_thread_replies);
+        console.log(`${this.logPrefix} Channel ${channelId}: ${messages.length} messages, ${threads.length} qualifying threads`);
+        // Process threads sequentially to avoid OpenAI rate limits
+        for (const thread of threads) {
+            try {
+                const threadItems = await this.processThread(channelId, thread);
+                items.push(...threadItems);
+                if (thread.ts > latestTs)
+                    latestTs = thread.ts;
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                console.error(`${this.logPrefix} Failed to distill thread ${thread.ts}: ${msg}`);
+            }
+        }
+        return { items, latestTs };
+    }
+    /**
+     * Process a single thread: fetch replies, resolve users, distill, create items.
+     */
+    async processThread(channelId, parentMessage) {
+        const replies = await this.apiClient.fetchThreadReplies(channelId, parentMessage.ts);
+        // Resolve user display names
+        const threadMessages = [];
+        for (const reply of replies) {
+            let author = reply.user ?? 'unknown';
+            try {
+                if (reply.user) {
+                    const user = await this.apiClient.fetchUserInfo(reply.user);
+                    author = user.displayName;
+                }
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                console.warn(`${this.logPrefix} Failed to resolve user ${reply.user}: ${msg}`);
+            }
+            threadMessages.push({
+                author,
+                content: reply.text ?? '',
+                timestamp: reply.ts,
+                reactions: reply.reactions,
+            });
+        }
+        // Distill the thread
+        const distillerResult = await distillThread(threadMessages, {
+            model: this.config.distiller_model,
+            client: this.openaiClient,
+        });
+        // Create ContentItems for ALL pairs — confidence filtering happens at query time
+        const items = [];
+        let permalink;
+        if (distillerResult.pairs.length > 0) {
+            try {
+                permalink = await this.apiClient.getChannelPermalink(channelId, parentMessage.ts);
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                console.warn(`${this.logPrefix} Failed to get permalink for ${channelId}/${parentMessage.ts}: ${msg}`);
+                permalink = undefined;
+            }
+        }
+        const participants = [...new Set(threadMessages.map(m => m.author))];
+        for (let i = 0; i < distillerResult.pairs.length; i++) {
+            const pair = distillerResult.pairs[i];
+            items.push({
+                id: `${channelId}:${parentMessage.ts}:${i}`,
+                content: `Q: ${pair.question}\n\nA: ${pair.answer}`,
+                title: pair.question,
+                sourceUrl: permalink,
+                metadata: {
+                    channel: channelId,
+                    participants,
+                    confidence: pair.confidence,
+                    emojiTriggered: false,
+                },
+            });
+        }
+        return items;
+    }
+}
+//# sourceMappingURL=slack.js.map

package/dist/indexing/providers/slack.js.map

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

package/dist/indexing/providers/types.d.ts

@@ -0,0 +1,56 @@
+import type { SourceConfig } from '../../types.js';
+/** A single content item to be indexed. */
+export interface ContentItem {
+    /** Unique identifier within the source (file path, thread ID, page ID, etc.) */
+    id: string;
+    /** Raw content to be chunked */
+    content: string;
+    /** Human-readable title (optional — chunker may derive one) */
+    title?: string;
+    /** URL to the original content (optional) */
+    sourceUrl?: string;
+    /** Additional metadata passed through to chunk records */
+    metadata?: Record<string, unknown>;
+}
+/** Result of a data acquisition run. */
+export interface AcquisitionResult {
+    /** Items to index (full list for full acquire, changed items for incremental) */
+    items: ContentItem[];
+    /**
+     * Item IDs to remove from the index.
+     * Full acquire: always empty — deleted-file detection is not performed during
+     * full acquire, so chunks from files no longer in the source persist until the
+     * next incremental acquire or manual cleanup.
+     * Incremental acquire: IDs of items deleted since lastStateToken.
+     */
+    removedIds: string[];
+    /** Opaque state token to persist (commit SHA, API cursor, timestamp) */
+    stateToken: string;
+}
+/** Interface that all data providers implement. */
+export interface DataProvider {
+    /**
+     * Full acquisition — return all indexable items.
+     * Providers must apply their own content filtering before returning items.
+     */
+    fullAcquire(): Promise<AcquisitionResult>;
+    /**
+     * Incremental acquisition — only items changed since lastStateToken.
+     */
+    incrementalAcquire(lastStateToken: string): Promise<AcquisitionResult>;
+    /**
+     * Get the current state token without acquiring items (for staleness checks).
+     * Returns null if the source is unavailable (e.g., clone dir missing).
+     */
+    getCurrentStateToken(): Promise<string | null>;
+}
+/** Options passed to provider factories. */
+export interface ProviderOptions {
+    cloneDir: string;
+    githubToken?: string;
+    slackBotToken?: string;
+    discordBotToken?: string;
+}
+/** Factory function that creates a DataProvider for a given source config. */
+export type DataProviderFactory = (config: SourceConfig, options: ProviderOptions) => DataProvider;
+//# sourceMappingURL=types.d.ts.map

package/dist/indexing/providers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/indexing/providers/types.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,2CAA2C;AAC3C,MAAM,WAAW,WAAW;IACxB,gFAAgF;IAChF,EAAE,EAAE,MAAM,CAAC;IACX,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,+DAA+D;IAC/D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,wCAAwC;AACxC,MAAM,WAAW,iBAAiB;IAC9B,iFAAiF;IACjF,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB;;;;;;OAMG;IACH,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,wEAAwE;IACxE,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,mDAAmD;AACnD,MAAM,WAAW,YAAY;IACzB;;;OAGG;IACH,WAAW,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAE1C;;OAEG;IACH,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAEvE;;;OAGG;IACH,oBAAoB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAClD;AAED,4CAA4C;AAC5C,MAAM,WAAW,eAAe;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,8EAA8E;AAC9E,MAAM,MAAM,mBAAmB,GAAG,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,eAAe,KAAK,YAAY,CAAC"}

package/dist/indexing/providers/types.js

@@ -0,0 +1,3 @@
+// Data provider interfaces — the contract between data acquisition and indexing.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/indexing/providers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/indexing/providers/types.ts"],"names":[],"mappings":"AAAA,iFAAiF"}

package/dist/indexing/url-derivation.d.ts

@@ -1,7 +1,7 @@
-import type { SourceConfig } from '../types.js';
+import type { FileSourceConfig } from '../types.js';
 /**
  * Derive a public URL from a relative file path using the source's URL derivation rules.
  * Returns null if the source has no base_url or url_derivation configured.
  */
-export declare function deriveUrl(filePath: string, sourceConfig: SourceConfig): string | null;
+export declare function deriveUrl(filePath: string, sourceConfig: FileSourceConfig): string | null;
 //# sourceMappingURL=url-derivation.d.ts.map

package/dist/indexing/url-derivation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"url-derivation.d.ts","sourceRoot":"","sources":["../../src/indexing/url-derivation.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,GAAG,MAAM,GAAG,IAAI,CAsBrF"}
+{"version":3,"file":"url-derivation.d.ts","sourceRoot":"","sources":["../../src/indexing/url-derivation.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,gBAAgB,GAAG,MAAM,GAAG,IAAI,CAsBzF"}

package/dist/indexing/url-derivation.js.map

@@ -1 +1 @@
-{"version":3,"file":"url-derivation.js","sourceRoot":"","sources":["../../src/indexing/url-derivation.ts"],"names":[],"mappings":"AAAA,sEAAsE;AAItE;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,QAAgB,EAAE,YAA0B;IAClE,IAAI,CAAC,YAAY,CAAC,QAAQ,IAAI,CAAC,YAAY,CAAC,cAAc;QAAE,OAAO,IAAI,CAAC;IAExE,MAAM,CAAC,GAAG,YAAY,CAAC,cAAc,CAAC;IACtC,IAAI,IAAI,GAAG,QAAQ,CAAC;IAEpB,IAAI,CAAC,CAAC,YAAY,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC;QACpD,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IAC7C,CAAC;IACD,IAAI,CAAC,CAAC,YAAY,EAAE,CAAC;QACjB,MAAM,EAAE,GAAG,IAAI,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,YAAY,CAAC,GAAG,GAAG,CAAC,CAAC;QACzD,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IAChC,CAAC;IACD,IAAI,CAAC,CAAC,kBAAkB,EAAE,CAAC;QACvB,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;IAC5C,CAAC;IACD,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;QAChB,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QACpC,IAAI,IAAI,KAAK,OAAO;YAAE,IAAI,GAAG,EAAE,CAAC;IACpC,CAAC;IAED,OAAO,YAAY,CAAC,QAAQ,GAAG,IAAI,CAAC;AACxC,CAAC;AAED,SAAS,WAAW,CAAC,CAAS;IAC1B,OAAO,CAAC,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AACpD,CAAC"}
+{"version":3,"file":"url-derivation.js","sourceRoot":"","sources":["../../src/indexing/url-derivation.ts"],"names":[],"mappings":"AAAA,sEAAsE;AAItE;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,QAAgB,EAAE,YAA8B;IACtE,IAAI,CAAC,YAAY,CAAC,QAAQ,IAAI,CAAC,YAAY,CAAC,cAAc;QAAE,OAAO,IAAI,CAAC;IAExE,MAAM,CAAC,GAAG,YAAY,CAAC,cAAc,CAAC;IACtC,IAAI,IAAI,GAAG,QAAQ,CAAC;IAEpB,IAAI,CAAC,CAAC,YAAY,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC;QACpD,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IAC7C,CAAC;IACD,IAAI,CAAC,CAAC,YAAY,EAAE,CAAC;QACjB,MAAM,EAAE,GAAG,IAAI,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,YAAY,CAAC,GAAG,GAAG,CAAC,CAAC;QACzD,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IAChC,CAAC;IACD,IAAI,CAAC,CAAC,kBAAkB,EAAE,CAAC;QACvB,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;IAC5C,CAAC;IACD,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;QAChB,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QACpC,IAAI,IAAI,KAAK,OAAO;YAAE,IAAI,GAAG,EAAE,CAAC;IACpC,CAAC;IAED,OAAO,YAAY,CAAC,QAAQ,GAAG,IAAI,CAAC;AACxC,CAAC;AAED,SAAS,WAAW,CAAC,CAAS;IAC1B,OAAO,CAAC,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AACpD,CAAC"}

package/dist/indexing/utils.d.ts

@@ -0,0 +1,19 @@
+import type { FileSourceConfig } from '../types.js';
+/**
+ * Check if file content has low semantic value (SVG paths, base64, minified code).
+ * Samples the first 8KB and checks the ratio of digits, dots, commas, semicolons,
+ * and equals signs. If >30% of characters are these low-value tokens, the file
+ * is likely SVG path data, base64, or minified code with no search value.
+ */
+export declare function hasLowSemanticValue(content: string): boolean;
+/**
+ * Convert a glob pattern to a RegExp.
+ * Supports: ** (any path), * (any segment), ? (any char)
+ */
+export declare function globToRegex(pattern: string): RegExp;
+/**
+ * Check if a relative file path matches the source's file_patterns (include)
+ * and does not match exclude_patterns.
+ */
+export declare function matchesPatterns(relPath: string, sourceConfig: FileSourceConfig): boolean;
+//# sourceMappingURL=utils.d.ts.map

package/dist/indexing/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/indexing/utils.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAqB5D;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAWnD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,gBAAgB,GAAG,OAAO,CAmBxF"}

package/dist/indexing/utils.js

@@ -0,0 +1,63 @@
+// Shared indexing utilities — used by providers, bash-fs, and test scripts.
+/**
+ * Check if file content has low semantic value (SVG paths, base64, minified code).
+ * Samples the first 8KB and checks the ratio of digits, dots, commas, semicolons,
+ * and equals signs. If >30% of characters are these low-value tokens, the file
+ * is likely SVG path data, base64, or minified code with no search value.
+ */
+export function hasLowSemanticValue(content) {
+    if (content.length < 500)
+        return false;
+    const sample = content.slice(0, 8192);
+    let lowValueChars = 0;
+    for (let i = 0; i < sample.length; i++) {
+        const c = sample.charCodeAt(i);
+        if ((c >= 48 && c <= 57) || // 0-9
+            c === 46 || // .
+            c === 44 || // ,
+            c === 59 || // ;
+            c === 61 // =
+        ) {
+            lowValueChars++;
+        }
+    }
+    const ratio = lowValueChars / sample.length;
+    return ratio > 0.3;
+}
+/**
+ * Convert a glob pattern to a RegExp.
+ * Supports: ** (any path), * (any segment), ? (any char)
+ */
+export function globToRegex(pattern) {
+    let re = pattern
+        .replace(/[.+^${}()|[\]\\]/g, '\\$&') // escape regex chars (except * and ?)
+        .replace(/\*\*\//g, '{{GLOBSTAR_SLASH}}') // **/ = any path prefix (including empty)
+        .replace(/\*\*/g, '{{GLOBSTAR}}') // ** alone = anything
+        .replace(/\*/g, '[^/]*') // * = anything except /
+        .replace(/\?/g, '[^/]') // ? = single char except /
+        .replace(/\{\{GLOBSTAR_SLASH\}\}/g, '(?:.*/)?') // **/ = optional path prefix
+        .replace(/\{\{GLOBSTAR\}\}/g, '.*'); // ** = anything including /
+    return new RegExp(`^${re}$`);
+}
+/**
+ * Check if a relative file path matches the source's file_patterns (include)
+ * and does not match exclude_patterns.
+ */
+export function matchesPatterns(relPath, sourceConfig) {
+    const normalized = relPath.replace(/\\/g, '/');
+    // Check excludes first (takes precedence)
+    const excludes = sourceConfig.exclude_patterns ?? [];
+    for (const pattern of excludes) {
+        if (globToRegex(pattern).test(normalized)) {
+            return false;
+        }
+    }
+    // Must match at least one include pattern
+    for (const pattern of sourceConfig.file_patterns) {
+        if (globToRegex(pattern).test(normalized)) {
+            return true;
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=utils.js.map

package/dist/indexing/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/indexing/utils.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAI5E;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAe;IAC/C,IAAI,OAAO,CAAC,MAAM,GAAG,GAAG;QAAE,OAAO,KAAK,CAAC;IAEvC,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IACtC,IAAI,aAAa,GAAG,CAAC,CAAC;IAEtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAC/B,IACI,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,IAAK,MAAM;YAC/B,CAAC,KAAK,EAAE,IAAkB,IAAI;YAC9B,CAAC,KAAK,EAAE,IAAkB,IAAI;YAC9B,CAAC,KAAK,EAAE,IAAkB,IAAI;YAC9B,CAAC,KAAK,EAAE,CAAkB,IAAI;UAChC,CAAC;YACC,aAAa,EAAE,CAAC;QACpB,CAAC;IACL,CAAC;IAED,MAAM,KAAK,GAAG,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC;IAC5C,OAAO,KAAK,GAAG,GAAG,CAAC;AACvB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe;IACvC,IAAI,EAAE,GAAG,OAAO;SACX,OAAO,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC,sCAAsC;SAC3E,OAAO,CAAC,SAAS,EAAE,oBAAoB,CAAC,CAAC,0CAA0C;SACnF,OAAO,CAAC,OAAO,EAAE,cAAc,CAAC,CAAU,sBAAsB;SAChE,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAoB,wBAAwB;SACnE,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAqB,2BAA2B;SACtE,OAAO,CAAC,yBAAyB,EAAE,UAAU,CAAC,CAAC,6BAA6B;SAC5E,OAAO,CAAC,mBAAmB,EAAE,IAAI,CAAC,CAAC,CAAa,4BAA4B;IAEjF,OAAO,IAAI,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AACjC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,OAAe,EAAE,YAA8B;IAC3E,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAE/C,0CAA0C;IAC1C,MAAM,QAAQ,GAAG,YAAY,CAAC,gBAAgB,IAAI,EAAE,CAAC;IACrD,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC7B,IAAI,WAAW,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YACxC,OAAO,KAAK,CAAC;QACjB,CAAC;IACL,CAAC;IAED,0CAA0C;IAC1C,KAAK,MAAM,OAAO,IAAI,YAAY,CAAC,aAAa,EAAE,CAAC;QAC/C,IAAI,WAAW,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YACxC,OAAO,IAAI,CAAC;QAChB,CAAC;IACL,CAAC;IAED,OAAO,KAAK,CAAC;AACjB,CAAC"}

package/dist/ip-limiter.d.ts

@@ -0,0 +1,11 @@
+export declare class IpSessionLimiter {
+    private maxPerIp;
+    private ipToSessions;
+    private sessionToIp;
+    constructor(maxPerIp: number);
+    tryAdd(ip: string, sessionId: string): boolean;
+    remove(sessionId: string): void;
+    getSessionCount(ip: string): number;
+    getMax(): number;
+}
+//# sourceMappingURL=ip-limiter.d.ts.map

package/dist/ip-limiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ip-limiter.d.ts","sourceRoot":"","sources":["../src/ip-limiter.ts"],"names":[],"mappings":"AAAA,qBAAa,gBAAgB;IACzB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,YAAY,CAAkC;IACtD,OAAO,CAAC,WAAW,CAA6B;gBAEpC,QAAQ,EAAE,MAAM;IAI5B,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO;IAa9C,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAW/B,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM;IAInC,MAAM,IAAI,MAAM;CAGnB"}

package/dist/ip-limiter.js

@@ -0,0 +1,40 @@
+export class IpSessionLimiter {
+    maxPerIp;
+    ipToSessions = new Map();
+    sessionToIp = new Map();
+    constructor(maxPerIp) {
+        this.maxPerIp = maxPerIp;
+    }
+    tryAdd(ip, sessionId) {
+        const sessions = this.ipToSessions.get(ip);
+        if (sessions && sessions.size >= this.maxPerIp)
+            return false;
+        if (!sessions) {
+            this.ipToSessions.set(ip, new Set([sessionId]));
+        }
+        else {
+            sessions.add(sessionId);
+        }
+        this.sessionToIp.set(sessionId, ip);
+        return true;
+    }
+    remove(sessionId) {
+        const ip = this.sessionToIp.get(sessionId);
+        if (!ip)
+            return;
+        this.sessionToIp.delete(sessionId);
+        const sessions = this.ipToSessions.get(ip);
+        if (sessions) {
+            sessions.delete(sessionId);
+            if (sessions.size === 0)
+                this.ipToSessions.delete(ip);
+        }
+    }
+    getSessionCount(ip) {
+        return this.ipToSessions.get(ip)?.size ?? 0;
+    }
+    getMax() {
+        return this.maxPerIp;
+    }
+}
+//# sourceMappingURL=ip-limiter.js.map

package/dist/ip-limiter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ip-limiter.js","sourceRoot":"","sources":["../src/ip-limiter.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,gBAAgB;IACjB,QAAQ,CAAS;IACjB,YAAY,GAAG,IAAI,GAAG,EAAuB,CAAC;IAC9C,WAAW,GAAG,IAAI,GAAG,EAAkB,CAAC;IAEhD,YAAY,QAAgB;QACxB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC7B,CAAC;IAED,MAAM,CAAC,EAAU,EAAE,SAAiB;QAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC3C,IAAI,QAAQ,IAAI,QAAQ,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO,KAAK,CAAC;QAE7D,IAAI,CAAC,QAAQ,EAAE,CAAC;YACZ,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QACpD,CAAC;aAAM,CAAC;YACJ,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC5B,CAAC;QACD,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QACpC,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,MAAM,CAAC,SAAiB;QACpB,MAAM,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC3C,IAAI,CAAC,EAAE;YAAE,OAAO;QAChB,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC3C,IAAI,QAAQ,EAAE,CAAC;YACX,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAC3B,IAAI,QAAQ,CAAC,IAAI,KAAK,CAAC;gBAAE,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC1D,CAAC;IACL,CAAC;IAED,eAAe,CAAC,EAAU;QACtB,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,IAAI,IAAI,CAAC,CAAC;IAChD,CAAC;IAED,MAAM;QACF,OAAO,IAAI,CAAC,QAAQ,CAAC;IACzB,CAAC;CACJ"}

package/dist/llms-txt.d.ts

@@ -0,0 +1,11 @@
+interface ChunkForLlms {
+    source_name: string;
+    file_path: string;
+    title: string | null;
+    content: string;
+    chunk_index: number;
+}
+export declare function generateLlmsTxt(chunks: ChunkForLlms[], serverName: string): string;
+export declare function generateLlmsFullTxt(chunks: ChunkForLlms[]): string;
+export {};
+//# sourceMappingURL=llms-txt.d.ts.map

package/dist/llms-txt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llms-txt.d.ts","sourceRoot":"","sources":["../src/llms-txt.ts"],"names":[],"mappings":"AAAA,UAAU,YAAY;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CA2BlF;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,CAgBlE"}

package/dist/llms-txt.js

@@ -0,0 +1,43 @@
+export function generateLlmsTxt(chunks, serverName) {
+    const lines = [
+        `# ${serverName}`,
+        '',
+        '> Documentation index for AI agents',
+        '',
+    ];
+    // Group by source, deduplicate by file_path, use first chunk's title
+    const bySource = new Map();
+    for (const c of chunks) {
+        if (!bySource.has(c.source_name))
+            bySource.set(c.source_name, new Map());
+        const files = bySource.get(c.source_name);
+        if (!files.has(c.file_path)) {
+            files.set(c.file_path, c.title || c.file_path);
+        }
+    }
+    for (const [source, files] of bySource) {
+        lines.push(`## ${source}`, '');
+        for (const [filePath, title] of files) {
+            lines.push(`- ${filePath} — ${title}`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+export function generateLlmsFullTxt(chunks) {
+    // Group chunks by file_path, sort by chunk_index, join content
+    const byFile = new Map();
+    for (const c of chunks) {
+        if (!byFile.has(c.file_path))
+            byFile.set(c.file_path, []);
+        byFile.get(c.file_path).push(c);
+    }
+    const sections = [];
+    for (const [filePath, fileChunks] of byFile) {
+        fileChunks.sort((a, b) => a.chunk_index - b.chunk_index);
+        const content = fileChunks.map(c => c.content).join('\n');
+        sections.push(`---\nfile: ${filePath}\n---\n\n${content}`);
+    }
+    return sections.join('\n\n');
+}
+//# sourceMappingURL=llms-txt.js.map

package/dist/llms-txt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llms-txt.js","sourceRoot":"","sources":["../src/llms-txt.ts"],"names":[],"mappings":"AAQA,MAAM,UAAU,eAAe,CAAC,MAAsB,EAAE,UAAkB;IACtE,MAAM,KAAK,GAAa;QACpB,KAAK,UAAU,EAAE;QACjB,EAAE;QACF,qCAAqC;QACrC,EAAE;KACL,CAAC;IAEF,qEAAqE;IACrE,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA+B,CAAC;IACxD,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACrB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC;YAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;QACzE,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,CAAE,CAAC;QAC3C,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC;YAC1B,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC;QACnD,CAAC;IACL,CAAC;IAED,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,QAAQ,EAAE,CAAC;QACrC,KAAK,CAAC,IAAI,CAAC,MAAM,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;QAC/B,KAAK,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,KAAK,EAAE,CAAC;YACpC,KAAK,CAAC,IAAI,CAAC,KAAK,QAAQ,MAAM,KAAK,EAAE,CAAC,CAAC;QAC3C,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACnB,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,MAAsB;IACtD,+DAA+D;IAC/D,MAAM,MAAM,GAAG,IAAI,GAAG,EAA0B,CAAC;IACjD,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACrB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;YAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QAC1D,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACrC,CAAC;IAED,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,KAAK,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC,IAAI,MAAM,EAAE,CAAC;QAC1C,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC;QACzD,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1D,QAAQ,CAAC,IAAI,CAAC,cAAc,QAAQ,YAAY,OAAO,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACjC,CAAC"}

package/dist/mcp/server.d.ts

@@ -1,10 +1,12 @@
 import type { Bash } from 'just-bash';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { SessionStateManager } from './tools/bash-session.js';
+import type { BashTelemetry } from './tools/bash-telemetry.js';
+import type { WorkspaceManager } from '../workspace.js';
 /**
  * Creates a new McpServer instance with all tools registered.
  * Each MCP session gets its own server instance. Each bash tool gets its own
  * virtual filesystem instance, shared across all MCP sessions for that tool.
  */
-export declare function createMcpServer(bashInstances?: Map<string, Bash>, sessionStateManager?: SessionStateManager, getSessionId?: () => string | undefined): McpServer;
+export declare function createMcpServer(bashInstances?: Map<string, Bash>, sessionStateManager?: SessionStateManager, getSessionId?: () => string | undefined, telemetry?: BashTelemetry, workspace?: WorkspaceManager): McpServer;
 //# sourceMappingURL=server.d.ts.map

package/dist/mcp/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAE9D;;;;GAIG;AACH,wBAAgB,eAAe,CAC3B,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,EACjC,mBAAmB,CAAC,EAAE,mBAAmB,EACzC,YAAY,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,GACxC,SAAS,CA8DX"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAOpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD;;;;GAIG;AACH,wBAAgB,eAAe,CAC3B,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,EACjC,mBAAmB,CAAC,EAAE,mBAAmB,EACzC,YAAY,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,EACvC,SAAS,CAAC,EAAE,aAAa,EACzB,SAAS,CAAC,EAAE,gBAAgB,GAC7B,SAAS,CAqEX"}

package/dist/mcp/server.js

@@ -3,13 +3,14 @@ import { EmbeddingClient } from '../indexing/embeddings.js';
 import { getConfig, getServerConfig } from '../config.js';
 import { registerSearchTool } from './tools/search.js';
 import { registerCollectTool } from './tools/collect.js';
+import { registerKnowledgeTool } from './tools/knowledge.js';
 import { registerBashTool } from './tools/bash.js';
 /**
  * Creates a new McpServer instance with all tools registered.
  * Each MCP session gets its own server instance. Each bash tool gets its own
  * virtual filesystem instance, shared across all MCP sessions for that tool.
  */
-export function createMcpServer(bashInstances, sessionStateManager, getSessionId) {
+export function createMcpServer(bashInstances, sessionStateManager, getSessionId, telemetry, workspace) {
     const cfg = getConfig();
     const serverCfg = getServerConfig();
     // Lazily created — only when a RAG tool needs it
@@ -49,13 +50,20 @@ export function createMcpServer(bashInstances, sessionStateManager, getSessionId
                 const grepStrategy = tool.bash?.grep_strategy;
                 const needsEmbedding = grepStrategy === 'vector' || grepStrategy === 'hybrid';
                 const searchToolNames = serverCfg.tools.filter(t => t.type === 'search').map(t => t.name);
+                const needsWorkspace = tool.bash?.workspace === true;
                 registerBashTool(server, tool, bash, {
                     getSessionState,
                     embeddingClient: needsEmbedding ? getEmbeddingClient() : undefined,
                     searchToolNames,
+                    telemetry,
+                    workspace: needsWorkspace ? workspace : undefined,
+                    getSessionId: needsWorkspace ? getSessionId : undefined,
                 });
                 break;
             }
+            case 'knowledge':
+                registerKnowledgeTool(server, getEmbeddingClient(), tool);
+                break;
             default: {
                 const _exhaustive = tool;
                 throw new Error(`Unknown tool type: ${_exhaustive.type}`);

package/dist/mcp/server.js.map

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

package/dist/mcp/tools/bash-fs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bash-fs.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/bash-fs.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAqCnD,MAAM,WAAW,mBAAmB;IAChC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAsB,iBAAiB,CACnC,OAAO,EAAE,YAAY,EAAE,EACvB,OAAO,CAAC,EAAE,mBAAmB,GAC9B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CA8CjC;AAED,MAAM,WAAW,YAAY;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAU7F;AAED,wBAAgB,YAAY,CACxB,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAAE,EAClB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,GACvC,MAAM,CA+BR;AAED,wBAAsB,mBAAmB,CACrC,OAAO,EAAE,YAAY,EAAE,EACvB,OAAO,CAAC,EAAE,mBAAmB,GAC9B,OAAO,CAAC;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAM5C"}
+{"version":3,"file":"bash-fs.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/bash-fs.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAqCnD,MAAM,WAAW,mBAAmB;IAChC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAsB,iBAAiB,CACnC,OAAO,EAAE,YAAY,EAAE,EACvB,OAAO,CAAC,EAAE,mBAAmB,GAC9B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CA+CjC;AAED,MAAM,WAAW,YAAY;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAU7F;AAED,wBAAgB,YAAY,CACxB,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAAE,EAClB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,GACvC,MAAM,CA+BR;AAED,wBAAsB,mBAAmB,CACrC,OAAO,EAAE,YAAY,EAAE,EACvB,OAAO,CAAC,EAAE,mBAAmB,GAC9B,OAAO,CAAC;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAM5C"}

package/dist/mcp/tools/bash-fs.js

@@ -1,7 +1,8 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import { Bash } from 'just-bash';
-import { matchesPatterns } from '../../indexing/source-indexer.js';
+import { matchesPatterns } from '../../indexing/utils.js';
+import { isFileSourceConfig } from '../../types.js';
 import { generateIndexMd, generateSearchTipsMd } from './bash-virtual-files.js';
 const DEFAULT_SKIP_DIRS = new Set(['node_modules', 'dist', 'build', '.git']);
 const DEFAULT_MAX_FILE_SIZE = 102400; // 100KB
@@ -40,6 +41,8 @@ export async function buildBashFilesMap(sources, options) {
     const files = {};
     const multiSource = sources.length > 1;
     for (const source of sources) {
+        if (!isFileSourceConfig(source))
+            continue; // Slack sources don't have filesystem paths
         let rootDir;
         if (source.repo && options?.cloneDir) {
             // Git-based source: the orchestrator clones into cloneDir/<repoName>/