@copilotkit/pathfinder 1.1.0 → 1.5.0

package/dist/webhooks/slack.js

@@ -0,0 +1,106 @@
+// Slack Events API webhook handler for emoji-triggered reindexing.
+// Handles URL verification challenges and reaction_added events.
+import crypto from 'node:crypto';
+import { getConfig, getServerConfig } from '../config.js';
+import { isSlackSourceConfig } from '../types.js';
+// ── Signature verification ───────────────────────────────────────────────────
+export function verifySlackSignature(rawBody, timestamp, signature, signingSecret) {
+    if (!timestamp || !signature)
+        return false;
+    // Reject requests older than 5 minutes (replay protection)
+    const now = Math.floor(Date.now() / 1000);
+    if (Math.abs(now - parseInt(timestamp, 10)) > 300)
+        return false;
+    const sigBasestring = `v0:${timestamp}:${rawBody.toString('utf-8')}`;
+    const expected = 'v0=' + crypto
+        .createHmac('sha256', signingSecret)
+        .update(sigBasestring)
+        .digest('hex');
+    if (signature.length !== expected.length)
+        return false;
+    return crypto.timingSafeEqual(Buffer.from(signature, 'utf-8'), Buffer.from(expected, 'utf-8'));
+}
+// ── Factory ──────────────────────────────────────────────────────────────────
+/**
+ * Create a Slack webhook handler wired to a specific orchestrator instance.
+ */
+export function createSlackWebhookHandler(orchestrator) {
+    return async function handleSlackWebhook(req, res) {
+        const cfg = getConfig();
+        // -- Raw body check ------------------------------------------------
+        const rawBody = Buffer.isBuffer(req.body) ? req.body : null;
+        if (!rawBody) {
+            console.error('[slack-webhook] req.body is not a Buffer — ensure the route uses express.raw()');
+            res.status(500).json({ error: 'Server misconfiguration: raw body not available' });
+            return;
+        }
+        // -- Parse payload -------------------------------------------------
+        let payload;
+        try {
+            payload = JSON.parse(rawBody.toString('utf-8'));
+        }
+        catch {
+            res.status(400).json({ error: 'Malformed JSON payload' });
+            return;
+        }
+        // -- URL verification challenge ------------------------------------
+        // Slack sends this during app setup; no signature verification needed
+        if (payload.type === 'url_verification') {
+            res.status(200).json({ challenge: payload.challenge });
+            return;
+        }
+        // -- Signature verification ----------------------------------------
+        if (!cfg.slackSigningSecret?.trim()) {
+            console.log('[slack-webhook] Rejecting request — signing secret not configured');
+            res.status(403).json({ error: 'Forbidden' });
+            return;
+        }
+        const timestamp = req.headers['x-slack-request-timestamp'];
+        const signature = req.headers['x-slack-signature'];
+        if (!verifySlackSignature(rawBody, timestamp, signature, cfg.slackSigningSecret)) {
+            res.status(401).json({ error: 'Invalid or missing Slack signature' });
+            return;
+        }
+        // -- Event routing -------------------------------------------------
+        if (payload.type !== 'event_callback' || !payload.event) {
+            res.status(200).json({ ok: true, ignored: true, reason: 'not an event_callback' });
+            return;
+        }
+        const event = payload.event;
+        if (event.type === 'reaction_added') {
+            const reactionEvent = event;
+            handleReactionAdded(reactionEvent, orchestrator);
+            // Respond immediately (Slack requires <3s)
+            res.status(200).json({ ok: true });
+            return;
+        }
+        // Unknown event type — acknowledge but ignore
+        res.status(200).json({ ok: true, ignored: true, reason: `unhandled event type: ${event.type}` });
+    };
+}
+// ── Event handlers ───────────────────────────────────────────────────────────
+function handleReactionAdded(event, orchestrator) {
+    const serverCfg = getServerConfig();
+    // Find Slack sources where this reaction matches the trigger emoji
+    // and the channel is in the configured channel list
+    const matchingSources = serverCfg.sources.filter(s => {
+        if (!isSlackSourceConfig(s))
+            return false;
+        if (s.trigger_emoji !== event.reaction)
+            return false;
+        if (!s.channels.includes(event.item.channel))
+            return false;
+        return true;
+    });
+    if (matchingSources.length === 0) {
+        console.log(`[slack-webhook] Reaction :${event.reaction}: on ${event.item.channel} ` +
+            `— no matching Slack source configured, ignoring`);
+        return;
+    }
+    for (const source of matchingSources) {
+        console.log(`[slack-webhook] Reaction :${event.reaction}: on ${event.item.channel} ` +
+            `— queuing reindex for source "${source.name}"`);
+        orchestrator.queueSourceReindex(source.name);
+    }
+}
+//# sourceMappingURL=slack.js.map

package/dist/webhooks/slack.js.map

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

package/dist/workspace.d.ts

@@ -0,0 +1,13 @@
+export declare class WorkspaceManager {
+    private baseDir;
+    private maxBytesPerSession;
+    private trackers;
+    constructor(baseDir: string, maxBytesPerSession?: number);
+    ensureSession(sessionId: string): string;
+    writeFile(sessionId: string, filename: string, content: string): boolean;
+    readFile(sessionId: string, filename: string): string | null;
+    listFiles(sessionId: string, subdir?: string): string[];
+    cleanup(sessionId: string): void;
+    cleanupAll(): void;
+}
+//# sourceMappingURL=workspace.d.ts.map

package/dist/workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../src/workspace.ts"],"names":[],"mappings":"AAIA,qBAAa,gBAAgB;IACzB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAuC;gBAE3C,OAAO,EAAE,MAAM,EAAE,kBAAkB,GAAE,MAAoB;IAYrE,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAexC,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;IAuBxE,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAc5D,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE;IAgBvD,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAWhC,UAAU,IAAI,IAAI;CAiBrB"}

package/dist/workspace.js

@@ -0,0 +1,118 @@
+import fs from 'fs';
+import path from 'path';
+import { WorkspaceTracker } from './mcp/tools/bash-session.js';
+export class WorkspaceManager {
+    baseDir;
+    maxBytesPerSession;
+    trackers = new Map();
+    constructor(baseDir, maxBytesPerSession = 1024 * 1024) {
+        this.baseDir = baseDir;
+        this.maxBytesPerSession = maxBytesPerSession;
+        try {
+            fs.mkdirSync(baseDir, { recursive: true });
+        }
+        catch (err) {
+            const detail = err instanceof Error ? err.message : String(err);
+            console.error(`[workspace] Failed to create base directory ${baseDir}: ${detail}`);
+            throw new Error(`WorkspaceManager: cannot create base directory: ${detail}`);
+        }
+    }
+    ensureSession(sessionId) {
+        const dir = path.join(this.baseDir, sessionId);
+        try {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        catch (err) {
+            const detail = err instanceof Error ? err.message : String(err);
+            console.error(`[workspace] Failed to create session directory ${dir}: ${detail}`);
+            throw new Error(`WorkspaceManager: cannot create session directory: ${detail}`);
+        }
+        if (!this.trackers.has(sessionId)) {
+            this.trackers.set(sessionId, new WorkspaceTracker(this.maxBytesPerSession));
+        }
+        return dir;
+    }
+    writeFile(sessionId, filename, content) {
+        const tracker = this.trackers.get(sessionId);
+        if (!tracker)
+            return false;
+        const bytes = Buffer.byteLength(content, 'utf-8');
+        if (!tracker.trackWrite(bytes))
+            return false;
+        const filePath = path.join(this.baseDir, sessionId, filename);
+        const sessionDir = path.resolve(this.baseDir, sessionId);
+        if (!path.resolve(filePath).startsWith(sessionDir + path.sep) && path.resolve(filePath) !== sessionDir) {
+            return false;
+        }
+        try {
+            fs.mkdirSync(path.dirname(filePath), { recursive: true });
+            fs.writeFileSync(filePath, content, 'utf-8');
+        }
+        catch (err) {
+            const detail = err instanceof Error ? err.message : String(err);
+            console.error(`[workspace] Failed to write file ${filePath}: ${detail}`);
+            return false;
+        }
+        return true;
+    }
+    readFile(sessionId, filename) {
+        const filePath = path.join(this.baseDir, sessionId, filename);
+        const sessionDir = path.resolve(this.baseDir, sessionId);
+        if (!path.resolve(filePath).startsWith(sessionDir + path.sep) && path.resolve(filePath) !== sessionDir) {
+            return null;
+        }
+        try {
+            return fs.readFileSync(filePath, 'utf-8');
+        }
+        catch {
+            return null;
+        }
+    }
+    listFiles(sessionId, subdir) {
+        let dir = path.join(this.baseDir, sessionId);
+        if (subdir) {
+            dir = path.join(dir, subdir);
+            const sessionDir = path.resolve(this.baseDir, sessionId);
+            if (!path.resolve(dir).startsWith(sessionDir + path.sep) && path.resolve(dir) !== sessionDir) {
+                return [];
+            }
+        }
+        try {
+            return fs.readdirSync(dir);
+        }
+        catch {
+            return [];
+        }
+    }
+    cleanup(sessionId) {
+        const dir = path.join(this.baseDir, sessionId);
+        try {
+            fs.rmSync(dir, { recursive: true, force: true });
+        }
+        catch (err) {
+            const detail = err instanceof Error ? err.message : String(err);
+            console.error(`[workspace] Failed to cleanup session ${sessionId}: ${detail}`);
+        }
+        this.trackers.delete(sessionId);
+    }
+    cleanupAll() {
+        let entries;
+        try {
+            entries = fs.readdirSync(this.baseDir);
+        }
+        catch {
+            entries = [];
+        }
+        for (const entry of entries) {
+            try {
+                fs.rmSync(path.join(this.baseDir, entry), { recursive: true, force: true });
+            }
+            catch (err) {
+                const detail = err instanceof Error ? err.message : String(err);
+                console.error(`[workspace] Failed to cleanup entry ${entry}: ${detail}`);
+            }
+        }
+        this.trackers.clear();
+    }
+}
+//# sourceMappingURL=workspace.js.map

package/dist/workspace.js.map

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

package/package.json

@@ -1,9 +1,28 @@
 {
     "name": "@copilotkit/pathfinder",
-    "version": "1.1.0",
-    "description": "Pathfinder — agentic docs retrieval for AI agents",
+    "version": "1.5.0",
+    "description": "Agentic docs retrieval for AI agents — semantic search and filesystem exploration over your documentation and code via MCP.",
     "type": "module",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/CopilotKit/pathfinder"
+    },
+    "homepage": "https://pathfinder.copilotkit.dev",
+    "keywords": [
+        "mcp",
+        "ai",
+        "agents",
+        "documentation",
+        "search",
+        "rag",
+        "embeddings",
+        "copilotkit"
+    ],
+    "license": "MIT",
     "main": "dist/index.js",
+    "bin": {
+        "pathfinder": "dist/cli.js"
+    },
     "publishConfig": {
         "access": "public"
     },
@@ -23,8 +42,14 @@
         "test": "vitest run"
     },
     "dependencies": {
+        "@discordjs/rest": "^2.6.1",
         "@modelcontextprotocol/sdk": "^1.25.2",
+        "@slack/web-api": "^7.15.0",
+        "cheerio": "^1.2.0",
+        "commander": "^14.0.3",
         "cors": "^2.8.5",
+        "discord-api-types": "^0.38.44",
+        "discord-interactions": "^4.4.0",
         "dotenv": "^17.3.1",
         "express": "^5.2.1",
         "just-bash": "^2.14.0",

package/pathfinder-docs.yaml

@@ -0,0 +1,54 @@
+server:
+  name: pathfinder-docs
+  version: "1.4.0"
+
+sources:
+  - name: pathfinder-docs
+    type: html
+    repo: https://github.com/CopilotKit/pathfinder.git
+    path: docs/
+    base_url: https://pathfinder.copilotkit.dev/
+    url_derivation:
+      strip_prefix: "docs/"
+      strip_suffix: ".html"
+    file_patterns:
+      - "**/*.html"
+    chunk:
+      target_tokens: 600
+      overlap_tokens: 50
+
+tools:
+  - name: search-docs
+    type: search
+    description: "Search Pathfinder documentation for configuration, deployment, client setup, and usage guides."
+    source: pathfinder-docs
+    default_limit: 5
+    max_limit: 20
+    result_format: docs
+
+  - name: explore-docs
+    type: bash
+    description: "Explore Pathfinder documentation files using bash commands (find, grep, cat, ls, head)."
+    sources: [pathfinder-docs]
+    bash:
+      session_state: true
+      grep_strategy: hybrid
+      virtual_files: true
+
+embedding:
+  provider: openai
+  model: text-embedding-3-small
+  dimensions: 1536
+
+indexing:
+  auto_reindex: true
+  reindex_hour_utc: 3
+  stale_threshold_hours: 24
+
+webhook:
+  repo_sources:
+    "CopilotKit/pathfinder":
+      - pathfinder-docs
+  path_triggers:
+    pathfinder-docs:
+      - "docs/"

package/pathfinder.example.yaml

@@ -0,0 +1,48 @@
+# Pathfinder — agentic docs retrieval for AI agents
+# Copy this file to pathfinder.yaml and customize for your project.
+# Full documentation: https://pathfinder.copilotkit.dev
+
+server:
+  name: my-project-docs
+  version: "1.0.0"
+
+sources:
+  - name: docs
+    type: markdown
+    repo: https://github.com/your-org/your-repo.git
+    path: docs/
+    file_patterns: ["**/*.mdx", "**/*.md"]
+    chunk:
+      target_tokens: 600
+      overlap_tokens: 50
+
+tools:
+  # Semantic search (RAG) — requires embedding config below
+  - name: search-docs
+    type: search
+    description: "Search documentation for relevant information."
+    source: docs
+    default_limit: 5
+    max_limit: 20
+    result_format: docs
+
+  # Filesystem exploration — no database or API keys needed
+  - name: explore-docs
+    type: bash
+    description: "Explore documentation files using bash commands (find, grep, cat, ls, head)."
+    sources: [docs]
+    bash:
+      session_state: true
+      grep_strategy: hybrid  # memory | vector | hybrid
+      virtual_files: true
+
+# Required for search tools (omit for bash-only mode)
+embedding:
+  provider: openai
+  model: text-embedding-3-small
+  dimensions: 1536
+
+indexing:
+  auto_reindex: true
+  reindex_hour_utc: 3
+  stale_threshold_hours: 24