risc0-mcp-server 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 RISC Zero Community
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,218 @@
+# RISC Zero MCP Documentation Server
+
+Model Context Protocol (MCP) server that provides programmatic access to [RISC Zero](https://risczero.com) documentation, enabling AI assistants like Claude to help developers build zkVM applications.
+
+## Features
+
+- 🔍 **Full-text search** across all RISC Zero documentation
+- 📚 **Documentation retrieval** for specific topics and tutorials
+- 💡 **Example browser** with 25+ zkVM example applications
+- 🔧 **API reference** access to Rust crate documentation
+- ❓ **FAQ lookup** for common questions
+- 📖 **Terminology** definitions for zkVM concepts
+- ⚡ **Fast caching** for improved performance
+- 🔒 **No API keys required** for basic usage
+
+## Available Tools
+
+1. `search_docs` - Search documentation by keyword
+2. `get_documentation` - Get specific doc pages
+3. `list_examples` - Browse all examples
+4. `get_example` - Get detailed example info
+5. `get_api_reference` - Access API docs
+6. `get_faq` - Query FAQs
+7. `get_terminology` - Look up terms
+
+## Installation
+
+**Using npm:**
+
+```bash
+npm install -g risc0-mcp-server
+# or run directly
+npx risc0-mcp-server
+```
+
+**Using Bun (faster):**
+
+```bash
+bun install -g risc0-mcp-server
+# or run directly
+bunx risc0-mcp-server
+```
+
+## Usage
+
+### Claude Desktop
+
+Add to your Claude Desktop configuration file:
+
+**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
+**Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "risc0-docs": {
+      "command": "npx",
+      "args": ["-y", "risc0-mcp-server"]
+    }
+  }
+}
+```
+
+Then restart Claude Desktop.
+
+### Claude Code
+
+```bash
+claude mcp add risc0-docs -- npx -y risc0-mcp-server
+```
+
+### OpenCode
+
+Add to your `opencode.json` configuration:
+
+```json
+{
+  "mcp": {
+    "risc0-docs": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "risc0-mcp-server"]
+    }
+  }
+}
+```
+
+### Cursor
+
+Open **Cursor Settings > MCP** and add a new server:
+
+```json
+{
+  "mcpServers": {
+    "risc0-docs": {
+      "command": "npx",
+      "args": ["-y", "risc0-mcp-server"]
+    }
+  }
+}
+```
+
+### Windsurf
+
+Open **Windsurf Settings > MCP** and add:
+
+```json
+{
+  "mcpServers": {
+    "risc0-docs": {
+      "command": "npx",
+      "args": ["-y", "risc0-mcp-server"]
+    }
+  }
+}
+```
+
+### Any MCP-compatible client
+
+This server uses **stdio transport**. Run it with any MCP client by executing:
+
+```bash
+npx -y risc0-mcp-server
+```
+
+### Example Queries
+
+Once connected, ask your AI assistant:
+
+- "Search RISC Zero docs for zkVM quickstart guide"
+- "Show me the password checker example"
+- "What is a receipt in RISC Zero?"
+- "List all available zkVM examples"
+- "Get API reference for risc0-zkvm crate"
+
+## Development
+
+**Using Bun (recommended - faster):**
+
+```bash
+# Clone repository
+git clone https://github.com/ELDEVODE/risc0-mcp-server.git
+cd risc0-mcp-server
+
+# Install dependencies
+bun install
+
+# Build
+bun run build
+
+# Run in development mode (with hot reload)
+bun run dev
+
+# Lint and format
+bun run lint
+bun run format
+```
+
+**Using npm:**
+
+```bash
+# Clone repository
+git clone https://github.com/ELDEVODE/risc0-mcp-server.git
+cd risc0-mcp-server
+
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Run in development mode
+npm run dev:npm
+
+# Lint and format
+npm run lint
+npm run format
+```
+
+## Architecture
+
+- **Runtime:** Compatible with both Bun and Node.js 18+
+- **Package Manager:** Works with both bun and npm
+- **Server:** MCP protocol implementation with stdio transport
+- **Tools:** 7 specialized documentation tools
+- **Fetcher:** GitHub API integration for fetching docs
+- **Indexer:** In-memory search index
+- **Parser:** Markdown and frontmatter parsing
+- **Cache:** TTL-based caching layer
+
+## Environment Variables
+
+- `GITHUB_TOKEN` (optional): GitHub personal access token for higher API rate limits (60/hour unauthenticated, 5000/hour authenticated)
+
+## Contributing
+
+Contributions welcome! Please:
+
+1. Fork the repository
+2. Create a feature branch
+3. Make your changes
+4. Add tests if applicable
+5. Submit a pull request
+
+## License
+
+MIT License - see LICENSE file
+
+## Links
+
+- [RISC Zero](https://risczero.com)
+- [RISC Zero Docs](https://dev.risczero.com)
+- [GitHub](https://github.com/risc0/risc0)
+- [Discord](https://discord.gg/risczero)
+
+---
+
+Built with ❤️ by the RISC Zero Community

package/dist/config.d.ts

@@ -0,0 +1,12 @@
+export declare const CONFIG: {
+    RISC0_REPO: string;
+    RISC0_BRANCH: string;
+    DOCS_BASE_PATH: string;
+    CACHE_TTL: number;
+    GITHUB_API_BASE: string;
+    GITHUB_RAW_BASE: string;
+    MAX_SEARCH_RESULTS: number;
+    MAX_EXAMPLE_FILES: number;
+    EXAMPLES_PATH: string;
+};
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,MAAM;;;;;;;;;;CAUlB,CAAC"}

package/dist/config.js

@@ -0,0 +1,12 @@
+export const CONFIG = {
+    RISC0_REPO: 'risc0/risc0',
+    RISC0_BRANCH: 'main',
+    DOCS_BASE_PATH: 'website',
+    CACHE_TTL: 3600000, // 1 hour in ms
+    GITHUB_API_BASE: 'https://api.github.com',
+    GITHUB_RAW_BASE: 'https://raw.githubusercontent.com',
+    MAX_SEARCH_RESULTS: 20,
+    MAX_EXAMPLE_FILES: 10, // Limit files returned to avoid overwhelming responses
+    EXAMPLES_PATH: 'examples',
+};
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,UAAU,EAAE,aAAa;IACzB,YAAY,EAAE,MAAM;IACpB,cAAc,EAAE,SAAS;IACzB,SAAS,EAAE,OAAO,EAAE,eAAe;IACnC,eAAe,EAAE,wBAAwB;IACzC,eAAe,EAAE,mCAAmC;IACpD,kBAAkB,EAAE,EAAE;IACtB,iBAAiB,EAAE,EAAE,EAAE,uDAAuD;IAC9E,aAAa,EAAE,UAAU;CAC1B,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { createRisc0DocsServer } from './server.js';
+async function main() {
+    const server = createRisc0DocsServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('RISC Zero MCP Documentation Server running on stdio');
+}
+main().catch((error) => {
+    console.error('Fatal error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEpD,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,qBAAqB,EAAE,CAAC;IACvC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAE7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,OAAO,CAAC,KAAK,CAAC,qDAAqD,CAAC,CAAC;AACvE,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,3 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+export declare function createRisc0DocsServer(): Server;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAkBnE,wBAAgB,qBAAqB,IAAI,MAAM,CA4Q9C"}

package/dist/server.js

@@ -0,0 +1,254 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { GitHubFetcher } from './utils/github-fetcher.js';
+import { FileReader } from './utils/file-reader.js';
+import { DocIndexer } from './utils/doc-indexer.js';
+import { searchDocs, getDocumentation, listExamples, getExample, getApiReference, getFaq, getTerminology, } from './tools/index.js';
+export function createRisc0DocsServer() {
+    const server = new Server({
+        name: 'risc0-docs-server',
+        version: '1.0.0',
+    }, {
+        capabilities: {
+            tools: {},
+        },
+    });
+    // Initialize services
+    const fetcher = new GitHubFetcher();
+    const fileReader = new FileReader(fetcher);
+    const indexer = new DocIndexer(fetcher);
+    // Initialize index on first use
+    let indexInitialized = false;
+    async function ensureIndexInitialized() {
+        if (!indexInitialized) {
+            console.error('Initializing documentation index...');
+            await indexer.buildIndex();
+            indexInitialized = true;
+            console.error('Documentation index ready');
+        }
+    }
+    // List available tools
+    server.setRequestHandler(ListToolsRequestSchema, async () => {
+        return {
+            tools: [
+                {
+                    name: 'search_docs',
+                    description: 'Search RISC Zero documentation by keyword. Returns relevant documentation pages with excerpts and relevance scores.',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            query: {
+                                type: 'string',
+                                description: 'Search query string',
+                            },
+                            section: {
+                                type: 'string',
+                                description: 'Filter by section (api, education, faq, terminology, examples)',
+                                enum: ['api', 'education', 'faq', 'terminology', 'examples'],
+                            },
+                            limit: {
+                                type: 'number',
+                                description: 'Maximum number of results to return',
+                                default: 20,
+                            },
+                        },
+                        required: ['query'],
+                    },
+                },
+                {
+                    name: 'get_documentation',
+                    description: 'Get the full content of a specific documentation page by path. Returns markdown content with metadata.',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            path: {
+                                type: 'string',
+                                description: 'Path to the documentation file (e.g., "website/docs/quickstart.md")',
+                            },
+                            version: {
+                                type: 'string',
+                                description: 'Git branch or tag (defaults to "main")',
+                                default: 'main',
+                            },
+                        },
+                        required: ['path'],
+                    },
+                },
+                {
+                    name: 'list_examples',
+                    description: 'List all available RISC Zero example applications with descriptions and categories.',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {},
+                    },
+                },
+                {
+                    name: 'get_example',
+                    description: 'Get detailed information about a specific RISC Zero example, including README and optionally source files.',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            name: {
+                                type: 'string',
+                                description: 'Name of the example (e.g., "password-checker")',
+                            },
+                            includeFiles: {
+                                type: 'boolean',
+                                description: 'Include source code files in the response',
+                                default: false,
+                            },
+                        },
+                        required: ['name'],
+                    },
+                },
+                {
+                    name: 'get_api_reference',
+                    description: 'Get API reference documentation for a RISC Zero Rust crate from docs.rs and crates.io.',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            crate: {
+                                type: 'string',
+                                description: 'Crate name (e.g., "risc0-zkvm")',
+                            },
+                            version: {
+                                type: 'string',
+                                description: 'Crate version (defaults to "latest")',
+                                default: 'latest',
+                            },
+                        },
+                        required: ['crate'],
+                    },
+                },
+                {
+                    name: 'get_faq',
+                    description: 'Get frequently asked questions from RISC Zero documentation. Optionally filter by keyword.',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            keyword: {
+                                type: 'string',
+                                description: 'Optional keyword to filter FAQs',
+                            },
+                        },
+                    },
+                },
+                {
+                    name: 'get_terminology',
+                    description: 'Get RISC Zero terminology and glossary definitions. Optionally search for a specific term.',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            term: {
+                                type: 'string',
+                                description: 'Optional term to search for (supports fuzzy matching)',
+                            },
+                        },
+                    },
+                },
+            ],
+        };
+    });
+    // Handle tool calls
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        try {
+            const { name, arguments: args } = request.params;
+            switch (name) {
+                case 'search_docs': {
+                    await ensureIndexInitialized();
+                    const result = await searchDocs(indexer, args);
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: JSON.stringify(result, null, 2),
+                            },
+                        ],
+                    };
+                }
+                case 'get_documentation': {
+                    const result = await getDocumentation(fileReader, args);
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: JSON.stringify(result, null, 2),
+                            },
+                        ],
+                    };
+                }
+                case 'list_examples': {
+                    const result = await listExamples(fetcher);
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: JSON.stringify(result, null, 2),
+                            },
+                        ],
+                    };
+                }
+                case 'get_example': {
+                    const result = await getExample(fetcher, args);
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: JSON.stringify(result, null, 2),
+                            },
+                        ],
+                    };
+                }
+                case 'get_api_reference': {
+                    const result = await getApiReference(args);
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: JSON.stringify(result, null, 2),
+                            },
+                        ],
+                    };
+                }
+                case 'get_faq': {
+                    const result = await getFaq(fileReader, args);
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: JSON.stringify(result, null, 2),
+                            },
+                        ],
+                    };
+                }
+                case 'get_terminology': {
+                    const result = await getTerminology(fileReader, args);
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: JSON.stringify(result, null, 2),
+                            },
+                        ],
+                    };
+                }
+                default:
+                    throw new Error(`Unknown tool: ${name}`);
+            }
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({ error: errorMessage }, null, 2),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/tools/get-api-reference.d.ts

@@ -0,0 +1,12 @@
+export declare function getApiReference(args: {
+    crate: string;
+    version?: string;
+}): Promise<{
+    crate: string;
+    version: string;
+    description: string;
+    docsUrl: string;
+    modules?: string[];
+    examples?: string[];
+}>;
+//# sourceMappingURL=get-api-reference.d.ts.map

package/dist/tools/get-api-reference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-api-reference.d.ts","sourceRoot":"","sources":["../../src/tools/get-api-reference.ts"],"names":[],"mappings":"AAEA,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB,CAAC,CA0CD"}

package/dist/tools/get-api-reference.js

@@ -0,0 +1,31 @@
+import fetch from 'node-fetch';
+export async function getApiReference(args) {
+    const { crate, version = 'latest' } = args;
+    if (!crate || crate.trim().length === 0) {
+        throw new Error('Crate parameter is required');
+    }
+    try {
+        // Fetch crate metadata from crates.io
+        const cratesUrl = `https://crates.io/api/v1/crates/${crate}`;
+        const response = await fetch(cratesUrl);
+        if (!response.ok) {
+            throw new Error(`Crate ${crate} not found on crates.io`);
+        }
+        const data = (await response.json());
+        const crateData = data.crate;
+        const actualVersion = version === 'latest' ? crateData.newest_version : version;
+        const docsUrl = crateData.documentation || `https://docs.rs/${crate}/${actualVersion}`;
+        return {
+            crate: crateData.name,
+            version: actualVersion,
+            description: crateData.description || 'No description available',
+            docsUrl,
+            modules: [],
+            examples: [],
+        };
+    }
+    catch (error) {
+        throw new Error(`Failed to get API reference for ${crate}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+//# sourceMappingURL=get-api-reference.js.map

package/dist/tools/get-api-reference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-api-reference.js","sourceRoot":"","sources":["../../src/tools/get-api-reference.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,YAAY,CAAC;AAE/B,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAGrC;IAQC,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,QAAQ,EAAE,GAAG,IAAI,CAAC;IAE3C,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACjD,CAAC;IAED,IAAI,CAAC;QACH,sCAAsC;QACtC,MAAM,SAAS,GAAG,mCAAmC,KAAK,EAAE,CAAC;QAC7D,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,CAAC;QAExC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,SAAS,KAAK,yBAAyB,CAAC,CAAC;QAC3D,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAOlC,CAAC;QAEF,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC;QAC7B,MAAM,aAAa,GAAG,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC,CAAC,OAAO,CAAC;QAChF,MAAM,OAAO,GAAG,SAAS,CAAC,aAAa,IAAI,mBAAmB,KAAK,IAAI,aAAa,EAAE,CAAC;QAEvF,OAAO;YACL,KAAK,EAAE,SAAS,CAAC,IAAI;YACrB,OAAO,EAAE,aAAa;YACtB,WAAW,EAAE,SAAS,CAAC,WAAW,IAAI,0BAA0B;YAChE,OAAO;YACP,OAAO,EAAE,EAAE;YACX,QAAQ,EAAE,EAAE;SACb,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,mCAAmC,KAAK,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACtG,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/tools/get-documentation.d.ts

@@ -0,0 +1,13 @@
+import { FileReader } from '../utils/file-reader.js';
+export declare function getDocumentation(fileReader: FileReader, args: {
+    path: string;
+    version?: string;
+}): Promise<{
+    title: string;
+    content: string;
+    path: string;
+    version: string;
+    metadata: Record<string, any>;
+    lastUpdated?: string;
+}>;
+//# sourceMappingURL=get-documentation.d.ts.map

package/dist/tools/get-documentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-documentation.d.ts","sourceRoot":"","sources":["../../src/tools/get-documentation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAIrD,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,UAAU,EACtB,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GACvC,OAAO,CAAC;IACT,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC,CA2BD"}

package/dist/tools/get-documentation.js

@@ -0,0 +1,26 @@
+import { MarkdownParser } from '../utils/markdown-parser.js';
+import { CONFIG } from '../config.js';
+export async function getDocumentation(fileReader, args) {
+    const { path, version = CONFIG.RISC0_BRANCH } = args;
+    if (!path || path.trim().length === 0) {
+        throw new Error('Path parameter is required');
+    }
+    try {
+        const content = await fileReader.readFile(path);
+        const parser = new MarkdownParser();
+        const { data, content: markdownContent } = parser.parse(content);
+        const title = data.title || path.split('/').pop()?.replace(/\.(md|mdx)$/, '') || 'Untitled';
+        return {
+            title,
+            content: markdownContent,
+            path,
+            version,
+            metadata: data,
+            lastUpdated: data.lastUpdated,
+        };
+    }
+    catch (error) {
+        throw new Error(`Failed to get documentation for ${path}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+//# sourceMappingURL=get-documentation.js.map