@copilotkit/pathfinder 1.1.0 → 1.5.0

package/dist/skill-md.js

@@ -0,0 +1,75 @@
+export function generateSkillMd(config) {
+    const searchTools = config.tools.filter(t => t.type === 'search').map(t => t.name);
+    const bashTools = config.tools.filter(t => t.type === 'bash').map(t => t.name);
+    const collectTools = config.tools.filter(t => t.type === 'collect').map(t => t.name);
+    const sources = config.sources.map(s => `${s.name} (${s.type})`);
+    const hasWorkspace = config.tools.some(t => t.type === 'bash' && t.bash?.workspace === true);
+    const hasQmd = config.tools.some(t => t.type === 'bash' && t.bash?.grep_strategy && t.bash.grep_strategy !== 'memory');
+    const lines = [
+        `# ${config.server.name}`,
+        '',
+        'Pathfinder is an MCP server providing semantic search and filesystem exploration over documentation and code.',
+        '',
+        '## Available Tools',
+        '',
+    ];
+    if (searchTools.length > 0) {
+        lines.push('### Semantic Search');
+        for (const name of searchTools)
+            lines.push(`- **${name}**: Search indexed content by meaning. Use for conceptual queries like "how does auth work?"`);
+        lines.push('');
+    }
+    if (bashTools.length > 0) {
+        lines.push('### Filesystem Exploration');
+        for (const name of bashTools)
+            lines.push(`- **${name}**: Run bash commands (find, grep, cat, ls, head, tail, cd) over a virtual filesystem of docs/code`);
+        lines.push('');
+        lines.push('#### Supported Commands');
+        lines.push('- `find / -name "*.mdx"` — find files by pattern');
+        lines.push('- `grep -rl "pattern" /path` — search file contents (standard grep, all flags work)');
+        lines.push('- `cat /path/to/file.mdx` — read file contents');
+        lines.push('- `ls /path/` — list directory contents');
+        lines.push('- `cd /path/` — change working directory (persists across calls)');
+        if (hasQmd) {
+            lines.push('- `qmd "natural language query"` — semantic search via embeddings (returns file:line:content)');
+        }
+        lines.push('- `related /path/to/file.mdx` — find semantically similar files');
+        if (hasWorkspace) {
+            lines.push('');
+            lines.push('#### Workspace');
+            lines.push('- `/workspace/` is a writable area for saving intermediate results');
+            lines.push('- Use `echo "content" > /workspace/notes.md` to save files');
+            lines.push('- Workspace is session-scoped and size-limited');
+        }
+        lines.push('');
+    }
+    if (collectTools.length > 0) {
+        lines.push('### Data Collection');
+        for (const name of collectTools)
+            lines.push(`- **${name}**: Submit structured data`);
+        lines.push('');
+    }
+    lines.push('## When to Use Search vs Explore');
+    lines.push('');
+    lines.push('| Need | Tool |');
+    lines.push('|------|------|');
+    lines.push('| Conceptual question ("how does X work?") | search |');
+    lines.push('| Find exact code or config | explore (grep) |');
+    lines.push('| Browse directory structure | explore (find, ls) |');
+    lines.push('| Read a specific file | explore (cat) |');
+    if (hasQmd)
+        lines.push('| Semantic code search | explore (qmd) |');
+    lines.push('');
+    lines.push('## Sources');
+    lines.push('');
+    for (const s of sources)
+        lines.push(`- ${s}`);
+    lines.push('');
+    lines.push('## Limitations');
+    lines.push('');
+    lines.push('- Filesystem is read-only (except /workspace/)');
+    lines.push('- File content is from the last index update, not real-time');
+    lines.push('- Pipes in bash commands are limited to basic patterns');
+    return lines.join('\n');
+}
+//# sourceMappingURL=skill-md.js.map

package/dist/skill-md.js.map

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