@copilotkit/pathfinder 1.1.0

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,163 @@
+// Unified type definitions for mcp-docs server configuration and data models.
+// Zod schemas provide runtime validation; TypeScript types are inferred from them.
+import { z } from 'zod';
+// ── Source configuration schemas ──────────────────────────────────────────────
+export const UrlDerivationConfigSchema = z.object({
+    strip_prefix: z.string().optional(),
+    strip_suffix: z.string().optional(),
+    strip_route_groups: z.boolean().optional(),
+    strip_index: z.boolean().optional(),
+});
+// ChunkConfig field applicability by source type:
+//   markdown/raw-text: target_tokens, overlap_tokens
+//   code:              target_lines, overlap_lines
+export const ChunkConfigSchema = z.object({
+    target_tokens: z.number().int().positive().optional(),
+    overlap_tokens: z.number().int().nonnegative().optional(),
+    target_lines: z.number().int().positive().optional(),
+    overlap_lines: z.number().int().nonnegative().optional(),
+});
+export const SourceConfigSchema = z.object({
+    name: z.string().min(1),
+    type: z.enum(['markdown', 'code', 'raw-text']),
+    repo: z.string().url().optional(),
+    branch: z.string().optional(),
+    path: z.string().min(1),
+    base_url: z.string().url().optional(),
+    url_derivation: UrlDerivationConfigSchema.optional(),
+    file_patterns: z.array(z.string()).min(1),
+    exclude_patterns: z.array(z.string()).optional(),
+    skip_dirs: z.array(z.string()).optional(),
+    max_file_size: z.number().int().positive().optional(),
+    chunk: ChunkConfigSchema,
+});
+// ── Tool configuration schemas ────────────────────────────────────────────────
+const SearchToolConfigObjectSchema = z.object({
+    name: z.string().min(1),
+    type: z.literal('search'),
+    description: z.string().min(1),
+    source: z.string().min(1),
+    default_limit: z.number().int().positive(),
+    max_limit: z.number().int().positive(),
+    result_format: z.enum(['docs', 'code', 'raw']),
+});
+// SearchToolConfig type is inferred from the object schema directly.
+// Cross-field validation (default_limit <= max_limit) lives in ServerConfigSchema.superRefine.
+export const SearchToolConfigSchema = SearchToolConfigObjectSchema;
+export const BashCacheConfigSchema = z.object({
+    max_entries: z.number().int().positive(),
+    ttl_seconds: z.number().int().positive(),
+});
+export const BashOptionsSchema = z.object({
+    session_state: z.boolean(),
+    grep_strategy: z.enum(['memory', 'vector', 'hybrid']),
+    workspace: z.boolean(),
+    virtual_files: z.boolean(),
+    max_file_size: z.number().int().positive(),
+    cache: BashCacheConfigSchema,
+}).partial();
+export const BashToolConfigSchema = z.object({
+    name: z.string().min(1),
+    type: z.literal('bash'),
+    description: z.string().min(1),
+    sources: z.array(z.string().min(1)).min(1),
+    bash: BashOptionsSchema.optional(),
+});
+export const CollectToolConfigSchema = z.object({
+    name: z.string().min(1),
+    type: z.literal('collect'),
+    description: z.string().min(1),
+    response: z.string().min(1),
+    schema: z.record(z.string(), z.object({
+        type: z.enum(['string', 'number', 'enum']),
+        description: z.string().optional(),
+        required: z.boolean().optional(),
+        values: z.array(z.string()).optional(),
+    }).refine(f => f.type !== 'enum' || (f.values && f.values.length > 0), {
+        message: 'enum fields must have a non-empty values array',
+    }).refine(f => f.type === 'enum' || !f.values, {
+        message: 'values is only valid for enum fields',
+    })).refine(s => Object.keys(s).length > 0, { message: 'collect tool schema must define at least one field' }),
+});
+// Cross-field constraints (e.g. default_limit <= max_limit for search tools)
+// are enforced in ServerConfigSchema.superRefine, not here.
+export const AnyToolConfigSchema = z.discriminatedUnion('type', [
+    SearchToolConfigObjectSchema,
+    CollectToolConfigSchema,
+    BashToolConfigSchema,
+]);
+// ── Embedding configuration schemas ───────────────────────────────────────────
+export const EmbeddingConfigSchema = z.object({
+    provider: z.enum(['openai']),
+    model: z.string().min(1),
+    dimensions: z.number().int().positive(),
+});
+// ── Indexing configuration schemas ────────────────────────────────────────────
+export const IndexingConfigSchema = z.object({
+    auto_reindex: z.boolean(),
+    reindex_hour_utc: z.number().int().min(0).max(23),
+    stale_threshold_hours: z.number().int().positive(),
+});
+// ── Webhook configuration schemas ─────────────────────────────────────────────
+export const WebhookConfigSchema = z.object({
+    repo_sources: z.record(z.string(), z.array(z.string())),
+    path_triggers: z.record(z.string(), z.array(z.string())),
+});
+// ── Top-level server configuration schema ─────────────────────────────────────
+export const ServerConfigSchema = z.object({
+    server: z.object({
+        name: z.string().min(1),
+        version: z.string().min(1),
+    }),
+    sources: z.array(SourceConfigSchema).min(1),
+    tools: z.array(AnyToolConfigSchema).min(1),
+    embedding: EmbeddingConfigSchema.optional(),
+    indexing: IndexingConfigSchema.optional(),
+    webhook: WebhookConfigSchema.optional(),
+}).superRefine((cfg, ctx) => {
+    const hasRag = cfg.tools.some(t => t.type === 'search');
+    if (hasRag && !cfg.embedding) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: 'embedding config is required when search tools are configured.',
+            path: ['embedding'],
+        });
+    }
+    if (hasRag && !cfg.indexing) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: 'indexing config is required when search tools are configured.',
+            path: ['indexing'],
+        });
+    }
+    const sourceNames = new Set(cfg.sources.map(s => s.name));
+    for (const tool of cfg.tools) {
+        if (tool.type === 'search' && tool.default_limit > tool.max_limit) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: `Tool "${tool.name}": default_limit must not exceed max_limit`,
+                path: ['tools'],
+            });
+        }
+        if (tool.type === 'bash') {
+            for (const src of tool.sources) {
+                if (!sourceNames.has(src)) {
+                    ctx.addIssue({
+                        code: z.ZodIssueCode.custom,
+                        message: `Bash tool "${tool.name}" references source "${src}" which is not defined in sources.`,
+                        path: ['tools'],
+                    });
+                }
+            }
+            const grepStrategy = tool.bash?.grep_strategy;
+            if ((grepStrategy === 'vector' || grepStrategy === 'hybrid') && !cfg.embedding) {
+                ctx.addIssue({
+                    code: z.ZodIssueCode.custom,
+                    message: `Bash tool "${tool.name}" uses grep_strategy "${grepStrategy}" which requires embedding config.`,
+                    path: ['embedding'],
+                });
+            }
+        }
+    }
+});
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/dist/webhooks/github.d.ts

@@ -0,0 +1,12 @@
+import type { Request, Response } from "express";
+/**
+ * Minimal interface for the orchestrator dependency.  The full
+ * IndexingOrchestrator lives in ../indexing/orchestrator.ts — we only
+ * depend on the subset we actually call so the webhook handler can function
+ * independently.
+ */
+export interface ReindexOrchestrator {
+    queueIncrementalReindex(repoUrl: string): void;
+}
+export declare function createWebhookHandler(orchestrator: ReindexOrchestrator): (req: Request, res: Response) => Promise<void>;
+//# sourceMappingURL=github.d.ts.map

package/dist/webhooks/github.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.d.ts","sourceRoot":"","sources":["../../src/webhooks/github.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAyBjD;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAChC,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAClD;AAiDD,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,mBAAmB,IACxB,KAAK,OAAO,EAAE,KAAK,QAAQ,KAAG,OAAO,CAAC,IAAI,CAAC,CAwFxF"}

package/dist/webhooks/github.js

@@ -0,0 +1,117 @@
+// GitHub webhook handler for push-event-driven incremental re-indexing.
+// Fully config-driven: uses webhook.repo_sources and webhook.path_triggers
+// from mcp-docs.yaml to determine which pushes trigger reindexing.
+import crypto from "node:crypto";
+import { getConfig, getServerConfig } from "../config.js";
+// ---------------------------------------------------------------------------
+// Signature verification
+// ---------------------------------------------------------------------------
+function verifySignature(rawBody, signatureHeader, secret) {
+    if (!signatureHeader)
+        return false;
+    const expected = "sha256=" + crypto.createHmac("sha256", secret).update(rawBody).digest("hex");
+    // Both strings must be the same length for timingSafeEqual
+    if (signatureHeader.length !== expected.length)
+        return false;
+    return crypto.timingSafeEqual(Buffer.from(signatureHeader, "utf-8"), Buffer.from(expected, "utf-8"));
+}
+// ---------------------------------------------------------------------------
+// Push-event helpers
+// ---------------------------------------------------------------------------
+function isDefaultBranchPush(payload) {
+    const branch = payload.ref.replace("refs/heads/", "");
+    return branch === payload.repository.default_branch;
+}
+/**
+ * Check if any committed files match any of the given path prefixes.
+ * An empty prefixes array means "match everything" (no path filtering).
+ */
+function touchesPaths(payload, prefixes) {
+    if (prefixes.length === 0)
+        return true;
+    for (const commit of payload.commits) {
+        const allPaths = [...commit.added, ...commit.modified, ...commit.removed];
+        if (allPaths.some((p) => prefixes.some((prefix) => p.startsWith(prefix)))) {
+            return true;
+        }
+    }
+    return false;
+}
+// ---------------------------------------------------------------------------
+// Factory: create a handler wired to a specific orchestrator instance
+// ---------------------------------------------------------------------------
+export function createWebhookHandler(orchestrator) {
+    return async function handleGithubWebhook(req, res) {
+        const cfg = getConfig();
+        // -- Signature verification ----------------------------------------
+        // The route MUST be configured with express.raw() so req.body is a
+        // Buffer.  If it isn't, bail out — we cannot safely verify the HMAC.
+        const rawBody = Buffer.isBuffer(req.body) ? req.body : null;
+        if (!rawBody) {
+            console.error("[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;
+        }
+        if (!cfg.githubWebhookSecret?.trim()) {
+            console.log("[webhook] Rejecting request — webhook secret not configured");
+            res.status(403).json({ error: "Forbidden" });
+            return;
+        }
+        const signature = req.headers["x-hub-signature-256"];
+        if (!verifySignature(rawBody, signature, cfg.githubWebhookSecret)) {
+            res.status(401).json({ error: "Invalid or missing webhook signature" });
+            return;
+        }
+        // -- Event routing -------------------------------------------------
+        const event = req.headers["x-github-event"];
+        if (event !== "push") {
+            res.status(200).json({ ignored: true, reason: "not a push event" });
+            return;
+        }
+        // -- Parse payload -------------------------------------------------
+        let payload;
+        try {
+            payload = JSON.parse(rawBody.toString("utf-8"));
+        }
+        catch {
+            res.status(400).json({ error: "Malformed JSON payload" });
+            return;
+        }
+        if (!isDefaultBranchPush(payload)) {
+            res.status(200).json({ ignored: true, reason: "not the default branch" });
+            return;
+        }
+        const repoFullName = payload.repository.full_name;
+        const repoUrl = payload.repository.clone_url;
+        const sha = payload.after;
+        // -- Config-driven dispatch ----------------------------------------
+        const webhookCfg = getServerConfig().webhook;
+        const sourceNames = webhookCfg?.repo_sources?.[repoFullName] ?? [];
+        if (sourceNames.length === 0) {
+            console.log(`[webhook] Push to ${repoFullName} at ${sha.slice(0, 8)} — repo not in webhook config, ignoring`);
+            res.status(200).json({ ignored: true, reason: "repo not in webhook config" });
+            return;
+        }
+        // Check path triggers for each source. If any source's triggers match
+        // (or it has no triggers, meaning "match all"), queue a reindex.
+        let shouldReindex = false;
+        for (const sourceName of sourceNames) {
+            const triggers = webhookCfg?.path_triggers?.[sourceName] ?? [];
+            if (touchesPaths(payload, triggers)) {
+                shouldReindex = true;
+                break; // one reindex covers all sources from the same repo
+            }
+        }
+        if (!shouldReindex) {
+            console.log(`[webhook] Push to ${repoFullName} at ${sha.slice(0, 8)} — ` +
+                `no path triggers matched, ignoring`);
+            res.status(200).json({ ignored: true, reason: "no path triggers matched" });
+            return;
+        }
+        console.log(`[webhook] Push to ${repoFullName} ` +
+            `(${payload.repository.default_branch}) at ${sha.slice(0, 8)} — queuing reindex`);
+        orchestrator.queueIncrementalReindex(repoUrl);
+        res.status(200).json({ queued: true });
+    };
+}
+//# sourceMappingURL=github.js.map

package/dist/webhooks/github.js.map

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

package/package.json

@@ -0,0 +1,48 @@
+{
+    "name": "@copilotkit/pathfinder",
+    "version": "1.1.0",
+    "description": "Pathfinder — agentic docs retrieval for AI agents",
+    "type": "module",
+    "main": "dist/index.js",
+    "publishConfig": {
+        "access": "public"
+    },
+    "scripts": {
+        "build": "tsc",
+        "start": "node dist/index.js",
+        "dev": "tsx watch src/index.ts",
+        "seed-index": "tsx scripts/seed-index.ts",
+        "test-search": "tsx scripts/test-search.ts",
+        "integration-test": "tsx scripts/integration-test.ts",
+        "fixture:breeze-api": "node fixtures/breeze-api/server.js",
+        "fixture:breeze-docs": "DATABASE_URL=pglite:///tmp/breeze-docs PATHFINDER_CONFIG=fixtures/breeze-api/mcp-docs.yaml tsx src/index.ts",
+        "fixture:breeze-docs:bash": "DATABASE_URL=pglite:///tmp/breeze-docs-bash PATHFINDER_CONFIG=fixtures/breeze-api/mcp-docs-bash.yaml tsx src/index.ts",
+        "fixture:breeze-broken-docs": "DATABASE_URL=pglite:///tmp/breeze-broken-docs PATHFINDER_CONFIG=fixtures/breeze-api/mcp-docs-broken.yaml tsx src/index.ts",
+        "fixture:breeze-broken-docs:bash": "DATABASE_URL=pglite:///tmp/breeze-broken-docs-bash PATHFINDER_CONFIG=fixtures/breeze-api/mcp-docs-broken-bash.yaml tsx src/index.ts",
+        "claude": "_MCP_PORT=${PORT:-3001} && _MCP_TMPDIR=$(mktemp -d) && echo \"{\\\"mcpServers\\\":{\\\"mcp-docs\\\":{\\\"type\\\":\\\"http\\\",\\\"url\\\":\\\"http://localhost:${_MCP_PORT}/mcp\\\",\\\"headers\\\":{}}}}\" > \"$_MCP_TMPDIR/mcp.json\" && (cd \"$_MCP_TMPDIR\" && claude --strict-mcp-config --mcp-config \"$_MCP_TMPDIR/mcp.json\"); rm -rf \"$_MCP_TMPDIR\"",
+        "test": "vitest run"
+    },
+    "dependencies": {
+        "@modelcontextprotocol/sdk": "^1.25.2",
+        "cors": "^2.8.5",
+        "dotenv": "^17.3.1",
+        "express": "^5.2.1",
+        "just-bash": "^2.14.0",
+        "openai": "^4.80.0",
+        "pg": "^8.13.0",
+        "pgvector": "^0.2.0",
+        "simple-git": "^3.27.0",
+        "yaml": "^2.8.3",
+        "zod": "^3.23.8"
+    },
+    "devDependencies": {
+        "@electric-sql/pglite": "^0.4.2",
+        "@types/cors": "^2.8.19",
+        "@types/express": "^5.0.6",
+        "@types/node": "^25.0.6",
+        "@types/pg": "^8.11.10",
+        "tsx": "^4.21.0",
+        "typescript": "^5.9.3",
+        "vitest": "^4.1.2"
+    }
+}