mcp-probe-kit 3.6.1 → 3.6.2

package/README.md

@@ -87,8 +87,8 @@ All hard quality rules live in one module (`src/lib/quality-constraints.ts`) and
 - Older projects that already have `project-context.md` but no graph docs are bootstrapped automatically through the `init_project_context` step
 - If GitNexus is unavailable, the server falls back automatically without breaking orchestration
 - Real graph queries read the `.gitnexus` index; `docs/graph-insights/latest.md|json` are readable snapshots for humans and AI agents
-- Graph snapshots are exposed as MCP resources: Cursor lists **2 entries** (`probe://status`, `probe://graph/latest`); `latest` embeds history and file index. On-demand URIs (`probe://graph/history`, `probe://graph/latest.md`, `probe://graph/files`) remain readable via `resources/read`
-- Graph snapshots are also persisted to readable files in `.mcp-probe-kit/graph-snapshots` (customizable via `MCP_GRAPH_SNAPSHOT_DIR`)
+- MCP resources in MCP client settings list **2 entries** (`probe://status`, `probe://project/bootstrap`). Graph runtime snapshots (`probe://graph/latest`, etc.) and `probe://project/skill|agents|context|graph` remain readable via `resources/read` when tools expose URIs
+- Graph snapshots are persisted to `.mcp-probe-kit/graph-snapshots` (customizable via `MCP_GRAPH_SNAPSHOT_DIR`)
 - Tool responses include `_meta.graph` with snapshot URI and local JSON/Markdown file paths
 
 ### 🐛 TBP 8-Step RCA for Bug Workflows
@@ -415,16 +415,13 @@ No installation needed, use the latest version directly.
   "mcpServers": {
     "mcp-probe-kit": {
       "command": "npx",
-      "args": ["-y", "mcp-probe-kit@latest"],
-      "env": {
-        "MCP_PROJECT_ROOT": "${workspaceFolder}"
-      }
+      "args": ["-y", "mcp-probe-kit@latest"]
     }
   }
 }
 ```
 
-> **Skill 自动安装**：任意 MCP 工具调用会在用户项目写入 `.agents/skills/mcp-probe-kit/SKILL.md`。务必设置 `MCP_PROJECT_ROOT`（或 Cursor 注入的 `WORKSPACE_FOLDER_PATHS`），否则可能写到错误目录。需 **v3.6.1+**。
+> **Skill 自动安装**：任意 MCP 工具调用会在用户项目写入 `.agents/skills/mcp-probe-kit/SKILL.md`。工作区根目录**自动识别**（Cursor 注入 `WORKSPACE_FOLDER_PATHS`；OpenCode 等项目级 `opencode.json` 会设置进程 cwd），**无需**在每台客户端配置 `MCP_PROJECT_ROOT`。仅全局 MCP 且无法识别工作区时，可选手动设置 `MCP_PROJECT_ROOT` 或在工具参数传 `project_root`。需 **v3.6.2+**。
 
 #### Claude Desktop Configuration
 
@@ -439,10 +436,7 @@ No installation needed, use the latest version directly.
   "mcpServers": {
     "mcp-probe-kit": {
       "command": "npx",
-      "args": ["-y", "mcp-probe-kit@latest"],
-      "env": {
-        "MCP_PROJECT_ROOT": "${workspaceFolder}"
-      }
+      "args": ["-y", "mcp-probe-kit@latest"]
     }
   }
 }
@@ -706,6 +700,50 @@ npx -y mcp-probe-kit@latest 2>&1 | tee ./mcp-probe-kit.log
 3. Confirm JSON format is correct, no syntax errors
 4. Check client developer tools or logs for error messages
 
+### Q2b: Cursor shows connected but **0 tools** / Agent says **No MCP servers available**?
+
+This is a known [Cursor-side issue](https://forum.cursor.com/t/mcp-server-connected-green-dot-and-tools-discovered-in-logs-but-0-tools-in-ui-and-agent/160620): stderr may log `tools/list` with 30 tools, while **Mcp FileSystem Writer** shows `lease returned 0 tools` and `toolCount=0` — the Agent lease layer silently dropped the tool list.
+
+**Common causes:**
+
+| Symptom in logs | Likely cause |
+|-----------------|--------------|
+| `tools/list ≈ 50+ KB` then `lease returned 0 tools` | Cursor internal payload size limit (whole list dropped silently) |
+| `latched shared-process MCP routing disabled` + `ipcReady` timeout | Windows `mcpProcess` utility failed; legacy fallback discovers tools but Agent lease stays empty |
+| Settings green dot, Agent `No MCP servers available` | Renderer ↔ shared-process MCP routing not wired for this session |
+
+**What we do (v3.6.2+):**  `tools/list` **omits `outputSchema` by default** (~50 KB → ~23 KB). Structured output still works via `structuredContent` on `tools/call`. To restore full schemas: `MCP_INCLUDE_OUTPUT_SCHEMA=1`.
+
+**What you can try:**
+
+1. **Reload MCP** or fully quit Cursor (not just close window) and reopen
+2. Check **Output → MCP** for `lease returned 0 tools` / `ipcReady` / `MessagePort`
+3. In **Composer**, open the tools panel — ensure the server toggle is on (some versions default off)
+4. Upgrade Cursor (3.7.36+ had Windows `ipcReady` regressions; try latest or roll back to a known-good build)
+5. If still broken after server update, report to Cursor with: `connected=true`, stderr tool count, lease `toolCount=0`, and `shared-process MCP routing disabled`
+
+**Diagnostic: `.cursor/projects/<project>/mcps/user-mcp-probe-kit/`**
+
+This folder is **written by Cursor** (Mcp FileSystem Writer), not by mcp-probe-kit. After a successful tool lease you should see:
+
+```text
+mcps/user-mcp-probe-kit/
+├── SERVER_METADATA.json
+├── STATUS.md
+├── tools/           ← one JSON per tool (~30); Agent reads these for CallMcpTool
+│   ├── init_project.json
+│   └── ...
+└── resources/       ← from resources/list (may exist even when tools/ is empty)
+```
+
+| State | Meaning |
+|-------|---------|
+| `resources/` exists, `tools/` missing or empty | `resources/list` OK but **tools lease failed** (matches `lease returned 0 tools`) |
+| `tools/` has some files but not 30 | Partial write or session interrupted; Reload MCP |
+| `STATUS.md` says server errored | Cursor marked the server unhealthy for Agent even if Settings is green |
+
+Healthy session: `tools/` should auto-populate within seconds of MCP connect — no manual setup, no repo config.
+
 ### Q3: How to update to latest version?
 
 **npx method (Recommended):**

package/build/index.js

@@ -9,13 +9,13 @@ import { initProject, gencommit, codeReview, codeInsight, gentest, refactor, ini
 import { VERSION, NAME } from "./version.js";
 import { allToolSchemas } from "./schemas/index.js";
 import { filterTools, getToolsetFromEnv } from "./lib/toolset-manager.js";
-import { withToolAnnotations } from "./lib/tool-annotations.js";
-import { withOutputSchema } from "./lib/output-schema-registry.js";
+import { prepareToolForToolsList } from "./lib/output-schema-registry.js";
 import { shouldAutoEscalateToTask } from "./lib/task-defaults.js";
 import { attachHandles } from "./lib/handles.js";
 import { buildMcpAppHtml, isMcpUiAppTool } from "./lib/mcp-apps.js";
 import { ensureMcpProbeKitBootstrapForToolCall, } from "./lib/workflow-skill-installer.js";
-import { resolveWorkspaceRoot } from "./lib/workspace-root.js";
+import { resolveWorkspaceRoot, resolveWorkspaceRootWithMeta } from "./lib/workspace-root.js";
+import { PROJECT_BOOTSTRAP_URI, discoverProjectResources, readProjectResourceContent, } from "./lib/project-mcp-resources.js";
 import { isAbortError, } from "./lib/tool-execution-context.js";
 const EXTENSIONS_CAPABILITY_KEY = "io.github.mybolide/extensions";
 const MAX_UI_APP_RESOURCES = 30;
@@ -424,10 +424,10 @@ const server = new Server({
 server.setRequestHandler(ListToolsRequestSchema, async () => {
     const toolset = getToolsetFromEnv();
     const filteredTools = filterTools(allToolSchemas, toolset);
-    console.error(`[MCP Probe Kit] 当前工具集: ${toolset} (${filteredTools.length}/${allToolSchemas.length} 个工具)`);
-    return {
-        tools: filteredTools.map((tool) => withOutputSchema(withToolAnnotations(tool))),
-    };
+    const tools = filteredTools.map((tool) => prepareToolForToolsList(tool));
+    const payloadBytes = Buffer.byteLength(JSON.stringify({ tools }), "utf8");
+    console.error(`[MCP Probe Kit] 当前工具集: ${toolset} (${tools.length}/${allToolSchemas.length} 个工具) | tools/list ≈ ${(payloadBytes / 1024).toFixed(1)} KB`);
+    return { tools };
 });
 async function executeTool(name, args, context) {
     const bootstrap = ensureMcpProbeKitBootstrapForToolCall(name, args);
@@ -709,7 +709,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request, extra) => {
         return withTraceMeta(makeToolError(errorMessage), traceMeta);
     }
 });
-// 定义资源列表（Cursor 设置页会展示为条目；仅保留 status + graph/latest，其余 URI 仍可 ReadResource）
+// 定义资源列表（轻量只读；bootstrap 写盘仅在 resources/read probe://project/bootstrap 或工具调用时）
 server.setRequestHandler(ListResourcesRequestSchema, async () => {
     const resources = [
         {
@@ -719,26 +719,32 @@ server.setRequestHandler(ListResourcesRequestSchema, async () => {
             mimeType: "application/json",
         },
         {
-            uri: "probe://graph/latest",
-            name: "图谱快照",
-            description: "最新图谱快照（含历史摘要与落盘索引；Markdown 可读 probe://graph/latest.md）",
+            uri: PROJECT_BOOTSTRAP_URI,
+            name: "项目 MCP 自检",
+            description: "读取时自动补齐 Skill + AGENTS.md，并返回 probe://project/skill|agents|context|graph 入口",
             mimeType: "application/json",
         },
     ];
-    if (uiAppsEnabled) {
-        for (const uri of uiAppResourceOrder.slice().reverse()) {
-            const entry = uiAppResources.get(uri);
-            if (!entry) {
-                continue;
+    try {
+        if (uiAppsEnabled) {
+            for (const uri of uiAppResourceOrder.slice().reverse()) {
+                const entry = uiAppResources.get(uri);
+                if (!entry) {
+                    continue;
+                }
+                resources.push({
+                    uri: entry.uri,
+                    name: entry.name,
+                    description: `${entry.description} (${entry.createdAt})`,
+                    mimeType: entry.mimeType,
+                });
             }
-            resources.push({
-                uri: entry.uri,
-                name: entry.name,
-                description: `${entry.description} (${entry.createdAt})`,
-                mimeType: entry.mimeType,
-            });
         }
     }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        console.error(`[MCP Probe Kit] resources/list UI 资源合并失败: ${message}`);
+    }
     return {
         resources,
     };
@@ -795,11 +801,49 @@ server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
                             })(),
                         },
                         toolCount: allToolSchemas.length,
+                        projectResources: (() => {
+                            try {
+                                const discovered = discoverProjectResources(resolveWorkspaceRoot(""));
+                                return {
+                                    bootstrapUri: PROJECT_BOOTSTRAP_URI,
+                                    projectRoot: toPosixPath(discovered.projectRoot),
+                                    available: discovered.resources
+                                        .filter((item) => item.exists)
+                                        .map((item) => item.uri),
+                                    note: "读取 probe://project/bootstrap 时执行 Skill/AGENTS 自动补齐",
+                                };
+                            }
+                            catch (error) {
+                                const message = error instanceof Error ? error.message : String(error);
+                                return { bootstrapUri: PROJECT_BOOTSTRAP_URI, error: message };
+                            }
+                        })(),
                     }, null, 2),
                 },
             ],
         };
     }
+    if (uri === PROJECT_BOOTSTRAP_URI || uri.startsWith("probe://project/")) {
+        try {
+            const content = readProjectResourceContent(uri, resolveWorkspaceRoot(""));
+            if (!content) {
+                throw new Error(`未知项目 resource: ${uri}`);
+            }
+            return {
+                contents: [
+                    {
+                        uri: content.uri,
+                        mimeType: content.mimeType,
+                        text: content.text,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            throw new Error(`读取项目 resource 失败 (${uri}): ${message}`);
+        }
+    }
     if (uri.startsWith("ui://")) {
         const entry = uiAppResources.get(uri);
         if (!entry) {
@@ -954,8 +998,11 @@ server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
 async function main() {
     const transport = new StdioServerTransport();
     await server.connect(transport);
-    const workspace = resolveWorkspaceRoot("");
-    console.error(`MCP Probe Kit v${VERSION} 已启动 | workspace=${workspace}`);
+    const workspaceMeta = resolveWorkspaceRootWithMeta("");
+    console.error(`MCP Probe Kit v${VERSION} 已启动 | workspace=${workspaceMeta.root} | source=${workspaceMeta.source}`);
+    if (workspaceMeta.warning) {
+        console.error(`[MCP Probe Kit] ${workspaceMeta.warning}`);
+    }
 }
 // 启动服务器
 main().catch((error) => {

package/build/lib/__tests__/custom-mcp-resources.unit.test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/lib/__tests__/custom-mcp-resources.unit.test.js

@@ -0,0 +1,135 @@
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import { afterEach, describe, expect, test } from "vitest";
+import { CUSTOM_RESOURCES_MANIFEST_REL, listCustomResourceDescriptors, loadCustomResourcesManifest, parseCustomResourcesManifest, readCustomResourceContent, resolveCustomResourcesManifestPath, } from "../custom-mcp-resources.js";
+function withTempProject(run) {
+    const root = fs.mkdtempSync(path.join(os.tmpdir(), "mcp-custom-res-"));
+    try {
+        run(root);
+    }
+    finally {
+        fs.rmSync(root, { recursive: true, force: true });
+    }
+}
+function writeManifest(root, body) {
+    const dir = path.join(root, ".mcp-probe-kit");
+    fs.mkdirSync(dir, { recursive: true });
+    fs.writeFileSync(path.join(dir, "resources.json"), JSON.stringify(body, null, 2), "utf-8");
+}
+describe("custom-mcp-resources", () => {
+    const prevEnv = { ...process.env };
+    afterEach(() => {
+        process.env = { ...prevEnv };
+    });
+    test("parseCustomResourcesManifest validates version and uri prefix", () => {
+        const entries = parseCustomResourcesManifest(JSON.stringify({
+            version: 1,
+            resources: [
+                {
+                    uri: "project://guide/readme",
+                    name: "Guide",
+                    mimeType: "text/markdown",
+                    text: "# hello",
+                },
+            ],
+        }));
+        expect(entries).toHaveLength(1);
+        expect(entries[0]?.uri).toBe("project://guide/readme");
+        expect(() => parseCustomResourcesManifest(JSON.stringify({
+            version: 1,
+            resources: [
+                {
+                    uri: "probe://status",
+                    name: "Bad",
+                    mimeType: "text/plain",
+                    text: "x",
+                },
+            ],
+        }))).toThrow(/project:\/\//);
+    });
+    test("listCustomResourceDescriptors respects list flag", () => {
+        withTempProject((root) => {
+            writeManifest(root, {
+                version: 1,
+                resources: [
+                    {
+                        uri: "project://visible",
+                        name: "Visible",
+                        mimeType: "text/plain",
+                        text: "a",
+                        list: true,
+                    },
+                    {
+                        uri: "project://hidden",
+                        name: "Hidden",
+                        mimeType: "text/plain",
+                        text: "b",
+                        list: false,
+                    },
+                ],
+            });
+            const listed = listCustomResourceDescriptors(root);
+            expect(listed.map((item) => item.uri)).toEqual(["project://visible"]);
+        });
+    });
+    test("readCustomResourceContent reads inline text and file", () => {
+        withTempProject((root) => {
+            const docsDir = path.join(root, "docs");
+            fs.mkdirSync(docsDir, { recursive: true });
+            fs.writeFileSync(path.join(docsDir, "note.md"), "# Note", "utf-8");
+            writeManifest(root, {
+                version: 1,
+                resources: [
+                    {
+                        uri: "project://inline",
+                        name: "Inline",
+                        mimeType: "text/plain",
+                        text: "inline-body",
+                    },
+                    {
+                        uri: "project://file/note",
+                        name: "File",
+                        mimeType: "text/markdown",
+                        file: "docs/note.md",
+                    },
+                ],
+            });
+            expect(readCustomResourceContent("project://inline", root)?.text).toBe("inline-body");
+            expect(readCustomResourceContent("project://file/note", root)?.text).toBe("# Note");
+        });
+    });
+    test("readCustomResourceContent rejects path traversal", () => {
+        withTempProject((root) => {
+            writeManifest(root, {
+                version: 1,
+                resources: [
+                    {
+                        uri: "project://escape",
+                        name: "Escape",
+                        mimeType: "text/plain",
+                        file: "../outside.txt",
+                    },
+                ],
+            });
+            expect(() => readCustomResourceContent("project://escape", root)).toThrow(/\.\./);
+        });
+    });
+    test("loadCustomResourcesManifest returns empty when manifest missing", () => {
+        withTempProject((root) => {
+            const result = loadCustomResourcesManifest(root);
+            expect(result.entries).toEqual([]);
+            expect(result.error).toBeNull();
+            expect(result.manifestPath).toBeNull();
+        });
+    });
+    test("resolveCustomResourcesManifestPath honors MCP_CUSTOM_RESOURCES_PATH", () => {
+        withTempProject((root) => {
+            const custom = path.join(root, "cfg", "my-resources.json");
+            process.env.MCP_CUSTOM_RESOURCES_PATH = "cfg/my-resources.json";
+            expect(resolveCustomResourcesManifestPath(root)).toBe(custom);
+            delete process.env.MCP_CUSTOM_RESOURCES_PATH;
+            expect(resolveCustomResourcesManifestPath(root)).toBe(path.join(root, CUSTOM_RESOURCES_MANIFEST_REL));
+        });
+    });
+});

package/build/lib/__tests__/project-mcp-resources.unit.test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/lib/__tests__/project-mcp-resources.unit.test.js

@@ -0,0 +1,49 @@
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import { afterEach, describe, expect, test } from "vitest";
+import { PROJECT_BOOTSTRAP_URI, ensureAndDiscoverProjectResources, readProjectResourceContent, } from "../project-mcp-resources.js";
+import { MCP_PROBE_SKILL_REL_PATH } from "../workflow-skill-template.js";
+function withTempProject(run) {
+    const root = fs.mkdtempSync(path.join(os.tmpdir(), "mcp-proj-res-"));
+    try {
+        run(root);
+    }
+    finally {
+        fs.rmSync(root, { recursive: true, force: true });
+    }
+}
+describe("project-mcp-resources", () => {
+    const prevEnv = { ...process.env };
+    afterEach(() => {
+        process.env = { ...prevEnv };
+    });
+    test("ensureAndDiscoverProjectResources auto-creates skill and agents", () => {
+        withTempProject((root) => {
+            const snapshot = ensureAndDiscoverProjectResources(root);
+            expect(snapshot.bootstrap.skill.created).toBe(true);
+            expect(snapshot.bootstrap.agentsMd.created).toBe(true);
+            expect(fs.existsSync(path.join(root, MCP_PROBE_SKILL_REL_PATH))).toBe(true);
+            expect(fs.existsSync(path.join(root, "AGENTS.md"))).toBe(true);
+            const skill = snapshot.resources.find((item) => item.id === "skill");
+            expect(skill?.exists).toBe(true);
+        });
+    });
+    test("readProjectResourceContent returns bootstrap catalog", () => {
+        withTempProject((root) => {
+            const content = readProjectResourceContent(PROJECT_BOOTSTRAP_URI, root);
+            expect(content?.mimeType).toBe("application/json");
+            const payload = JSON.parse(content?.text ?? "{}");
+            expect(payload.autoBootstrap.skill.path).toBe(MCP_PROBE_SKILL_REL_PATH);
+            expect(Array.isArray(payload.resources)).toBe(true);
+        });
+    });
+    test("readProjectResourceContent reads skill markdown", () => {
+        withTempProject((root) => {
+            ensureAndDiscoverProjectResources(root);
+            const content = readProjectResourceContent("probe://project/skill", root);
+            expect(content?.mimeType).toBe("text/markdown");
+            expect(content?.text).toContain("mcp-probe-kit-skill-version");
+        });
+    });
+});

package/build/lib/__tests__/workspace-root.unit.test.js

@@ -2,7 +2,7 @@ import * as fs from "node:fs";
 import * as os from "node:os";
 import * as path from "node:path";
 import { afterEach, describe, expect, test } from "vitest";
-import { resolveFromWorkspaceFolderPathsEnv, resolveWorkspaceRoot, } from "../workspace-root.js";
+import { resolveFromWorkspaceFolderPathsEnv, resolveWorkspaceRoot, resolveWorkspaceRootWithMeta, } from "../workspace-root.js";
 const original = process.env.WORKSPACE_FOLDER_PATHS;
 const tempDirs = [];
 afterEach(() => {
@@ -28,4 +28,36 @@ describe("workspace-root WORKSPACE_FOLDER_PATHS", () => {
         expect(resolveFromWorkspaceFolderPathsEnv()).toBe(path.resolve(root));
         expect(resolveWorkspaceRoot("")).toBe(path.resolve(root));
     });
+    test("客户端工作区路径不向父级 layout 上爬", () => {
+        const parent = fs.mkdtempSync(path.join(os.tmpdir(), "ws-parent-"));
+        const child = path.join(parent, "my-app");
+        tempDirs.push(parent);
+        fs.mkdirSync(child, { recursive: true });
+        fs.writeFileSync(path.join(child, "package.json"), "{}", "utf8");
+        fs.mkdirSync(path.join(parent, "docs", ".mcp-probe"), { recursive: true });
+        fs.writeFileSync(path.join(parent, "docs", ".mcp-probe", "layout.json"), JSON.stringify({ version: 1, indexPath: "AGENTS.md", contextRoot: "docs" }), "utf8");
+        process.env.WORKSPACE_FOLDER_PATHS = JSON.stringify([child]);
+        const resolution = resolveWorkspaceRootWithMeta("");
+        expect(resolution.root).toBe(path.resolve(child));
+        expect(resolution.source).toBe("workspace-env");
+    });
+});
+describe("workspace-root explicit project_root", () => {
+    test("显式绝对路径优先，不走上级 layout", () => {
+        const parent = fs.mkdtempSync(path.join(os.tmpdir(), "ws-parent-"));
+        const child = path.join(parent, "my-app");
+        tempDirs.push(parent);
+        fs.mkdirSync(child, { recursive: true });
+        fs.mkdirSync(path.join(parent, "docs", ".mcp-probe"), { recursive: true });
+        fs.writeFileSync(path.join(parent, "docs", ".mcp-probe", "layout.json"), JSON.stringify({ version: 1, indexPath: "AGENTS.md", contextRoot: "docs" }), "utf8");
+        const resolution = resolveWorkspaceRootWithMeta(child);
+        expect(resolution.root).toBe(path.resolve(child));
+        expect(resolution.explicitHonored).toBe(true);
+        expect(resolution.source).toBe("explicit");
+    });
+    test("显式路径无效时返回 warning", () => {
+        const resolution = resolveWorkspaceRootWithMeta("not/a/valid/root");
+        expect(resolution.explicitHonored).toBe(false);
+        expect(resolution.warning).toMatch(/未能采用传入的 project_root/);
+    });
 });

package/build/lib/custom-mcp-resources.d.ts

@@ -0,0 +1,39 @@
+export declare const CUSTOM_RESOURCES_MANIFEST_REL = ".mcp-probe-kit/resources.json";
+export declare const CUSTOM_RESOURCE_URI_PREFIX = "project://";
+export interface CustomResourceManifestEntry {
+    uri: string;
+    name: string;
+    description?: string;
+    mimeType: string;
+    /** 相对项目根的文件路径 */
+    file?: string;
+    /** 内联文本（与 file 二选一） */
+    text?: string;
+    /** 是否在 resources/list 中展示，默认 true */
+    list?: boolean;
+}
+export interface CustomResourcesManifestV1 {
+    version: 1;
+    resources: CustomResourceManifestEntry[];
+}
+export interface CustomResourceDescriptor {
+    uri: string;
+    name: string;
+    description: string;
+    mimeType: string;
+}
+export interface CustomResourceContent {
+    uri: string;
+    mimeType: string;
+    text: string;
+}
+export declare function resolveCustomResourcesManifestPath(projectRoot?: string): string;
+export declare function parseCustomResourcesManifest(raw: string): CustomResourceManifestEntry[];
+export declare function loadCustomResourcesManifest(projectRoot?: string): {
+    manifestPath: string | null;
+    entries: CustomResourceManifestEntry[];
+    error: string | null;
+};
+export declare function listCustomResourceDescriptors(projectRoot?: string): CustomResourceDescriptor[];
+export declare function readCustomResourceContent(uri: string, projectRoot?: string): CustomResourceContent | null;
+export declare function buildCustomResourcesManifestExample(): CustomResourcesManifestV1;