@opvs-ai/mcp 2.10.0 → 2.11.0

package/README.md

@@ -1,6 +1,9 @@
 # @opvs-ai/mcp
 
-OPVS MCP server for the **on-demand model** — 16 tools that give any MCP host (Claude Desktop, Cursor, Antigravity, Windsurf, Claude Code) the same surface OPVS-hosted agents see: 10 always-on marketplace tools, `sandbox_chat` (a vendor test mode), and 5 **fleet** tools for machines and slots. Everything else is reached through `tool_call` indirection so the package fits under the ~100-tool cap every current MCP client enforces.
+OPVS MCP server for the **on-demand model** — native marketplace, board, fleet,
+typed-memory, and code-index tools for any MCP host (Claude Desktop, Cursor,
+Antigravity, Windsurf, Claude Code). Marketplace skills remain reachable through
+`tool_call` indirection, keeping the package under the tool cap enforced by MCP clients.
 
 | Tool | Wraps | Purpose |
 |------|-------|---------|
@@ -15,6 +18,35 @@ OPVS MCP server for the **on-demand model** — 16 tools that give any MCP host
 | `whoami` | `/auth/me` | Session probe — brand, agent, workspace |
 | `board_as_markdown` | `/board/boards/{id}/export?format=md` | A whole AgentBoard as a Markdown plan in one call (`detail` summary/standard/full, `columns` filter). A board over the server's 1 MiB export ceiling is **refused, not truncated** — the refusal carries `actual_bytes`/`limit_bytes`/`retry_with` as fields. It does **not** silently retry at a lower detail: the tool promises these exact bytes, so substituting a different document is the caller's decision |
 
+### Code index — read-only
+
+Every code tool requires an AgentBoard `project_id`. The PAT pins the brand;
+there is no `brand_id` input. If the index is unavailable, the tools explicitly
+tell the caller to continue without it and do not retry.
+
+| Tool | Route | Use |
+|------|-------|-----|
+| `code_context` | `GET /code/{project_id}/context` | Pre-write symbol and concept search |
+| `code_summary` | `GET /code/{project_id}/summary` | Languages, entry points, tests, and counts |
+| `code_tree` | `GET /code/{project_id}/tree` | Directory structure and freshness |
+| `code_files` | `GET /code/{project_id}/files` | Files beneath a directory, including path paging |
+| `code_symbols` | `GET /code/{project_id}/symbols` | Declarations in one file |
+| `code_resolve` | `POST /code/{project_id}/nodes/resolve` | Stable anchors to current nodes |
+| `code_changes` | `GET /code/{project_id}/nodes/changes` | Stable-node history in ascending or descending order |
+| `code_graph` | `GET /code/{project_id}/graph` | One node's IMPORTS neighbourhood (Python and TS/JS only) |
+| `code_graph_folders` | `GET /code/{project_id}/graph/folders` | Folder IMPORTS, hubs, and mutual pairs (Python and TS/JS only) |
+
+### Typed memory — read-only
+
+| Tool | Route | Use |
+|------|-------|-----|
+| `memory_search` | `GET /memory/entries/search` | Search typed memories |
+| `memory_context` | `GET /memory/entries/search` | Bounded repository-aware context |
+| `memory_request_pin` | `GET /memory/entries/{id}` | Verify and prepare a human pin request |
+| `memory_near` | `POST /memory/entries:near` | Lessons on code and its nearby graph |
+| `memory_similar` | `POST /memory/entries:similar` | Near-duplicate check before writing a lesson |
+| `memory_anchors` | `POST /memory/anchors:lookup` | Lessons attached to known stable node ids |
+
 ### Fleet — machines and slots
 
 The environment layer had **no agent-reachable surface at all** until these landed, so

package/dist/.build-stamp.json

@@ -1,9 +1,9 @@
 {
   "stamp_version": 1,
   "package": "@opvs-ai/mcp",
-  "version": "2.10.0",
-  "source_digest": "b67e93f0d74035a1b1bf423e033385474691de3e7b75878f7284281a0cc71b91",
-  "source_files": 9,
-  "built_at": "2026-10-04T07:29:28.584Z",
+  "version": "2.11.0",
+  "source_digest": "53fde4d1149f048d0d91d84a40211a268e6bcf6c765598663927810f9b313478",
+  "source_files": 10,
+  "built_at": "2026-10-11T16:55:53.573Z",
   "node": "v22.23.3"
 }

package/dist/code.d.ts

@@ -0,0 +1,466 @@
+import { type ToolResult } from "./http.js";
+type Args = Record<string, unknown> & {
+    project_id?: string;
+};
+export declare const CODE_TOOLS: ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            project_id: {
+                type: string;
+                description: string;
+            };
+            query: {
+                type: string;
+                minLength: number;
+                maxLength: number;
+                description: string;
+            };
+            kind: {
+                type: string;
+                maxLength: number;
+                description: string;
+            };
+            branch: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                minimum: number;
+                description: string;
+            };
+            format: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            depth?: undefined;
+            directory?: undefined;
+            direct?: undefined;
+            order?: undefined;
+            after?: undefined;
+            file_path?: undefined;
+            anchors?: undefined;
+            before?: undefined;
+            node_id?: undefined;
+            path_prefix?: undefined;
+            direction?: undefined;
+            dir?: undefined;
+        };
+        required: string[];
+        additionalProperties: boolean;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            project_id: {
+                type: string;
+                description: string;
+            };
+            branch: {
+                type: string;
+                description: string;
+            };
+            format: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            query?: undefined;
+            kind?: undefined;
+            limit?: undefined;
+            depth?: undefined;
+            directory?: undefined;
+            direct?: undefined;
+            order?: undefined;
+            after?: undefined;
+            file_path?: undefined;
+            anchors?: undefined;
+            before?: undefined;
+            node_id?: undefined;
+            path_prefix?: undefined;
+            direction?: undefined;
+            dir?: undefined;
+        };
+        required: string[];
+        additionalProperties: boolean;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            project_id: {
+                type: string;
+                description: string;
+            };
+            branch: {
+                type: string;
+                description: string;
+            };
+            depth: {
+                type: string;
+                minimum: number;
+                maximum: number;
+                description: string;
+            };
+            format: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            query?: undefined;
+            kind?: undefined;
+            limit?: undefined;
+            directory?: undefined;
+            direct?: undefined;
+            order?: undefined;
+            after?: undefined;
+            file_path?: undefined;
+            anchors?: undefined;
+            before?: undefined;
+            node_id?: undefined;
+            path_prefix?: undefined;
+            direction?: undefined;
+            dir?: undefined;
+        };
+        required: string[];
+        additionalProperties: boolean;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            project_id: {
+                type: string;
+                description: string;
+            };
+            directory: {
+                type: string;
+                maxLength: number;
+                description: string;
+            };
+            direct: {
+                type: string;
+                description: string;
+            };
+            branch: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                minimum: number;
+                description: string;
+            };
+            order: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            after: {
+                type: string;
+                minLength: number;
+                maxLength: number;
+                description: string;
+                minimum?: undefined;
+            };
+            format: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            query?: undefined;
+            kind?: undefined;
+            depth?: undefined;
+            file_path?: undefined;
+            anchors?: undefined;
+            before?: undefined;
+            node_id?: undefined;
+            path_prefix?: undefined;
+            direction?: undefined;
+            dir?: undefined;
+        };
+        required: string[];
+        additionalProperties: boolean;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            project_id: {
+                type: string;
+                description: string;
+            };
+            file_path: {
+                type: string;
+                minLength: number;
+                maxLength: number;
+                description: string;
+            };
+            branch: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                minimum: number;
+                description: string;
+            };
+            format: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            query?: undefined;
+            kind?: undefined;
+            depth?: undefined;
+            directory?: undefined;
+            direct?: undefined;
+            order?: undefined;
+            after?: undefined;
+            anchors?: undefined;
+            before?: undefined;
+            node_id?: undefined;
+            path_prefix?: undefined;
+            direction?: undefined;
+            dir?: undefined;
+        };
+        required: string[];
+        additionalProperties: boolean;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            project_id: {
+                type: string;
+                description: string;
+            };
+            anchors: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                maxItems: number;
+                description: string;
+            };
+            format: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            query?: undefined;
+            kind?: undefined;
+            branch?: undefined;
+            limit?: undefined;
+            depth?: undefined;
+            directory?: undefined;
+            direct?: undefined;
+            order?: undefined;
+            after?: undefined;
+            file_path?: undefined;
+            before?: undefined;
+            node_id?: undefined;
+            path_prefix?: undefined;
+            direction?: undefined;
+            dir?: undefined;
+        };
+        required: string[];
+        additionalProperties: boolean;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            project_id: {
+                type: string;
+                description: string;
+            };
+            order: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            before: {
+                type: string;
+                minimum: number;
+                description: string;
+            };
+            after: {
+                type: string;
+                minimum: number;
+                description: string;
+                minLength?: undefined;
+                maxLength?: undefined;
+            };
+            node_id: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                maxItems: number;
+                description: string;
+            };
+            path_prefix: {
+                type: string;
+                maxLength: number;
+                description: string;
+            };
+            limit: {
+                type: string;
+                minimum: number;
+                description: string;
+            };
+            format: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            query?: undefined;
+            kind?: undefined;
+            branch?: undefined;
+            depth?: undefined;
+            directory?: undefined;
+            direct?: undefined;
+            file_path?: undefined;
+            anchors?: undefined;
+            direction?: undefined;
+            dir?: undefined;
+        };
+        required: string[];
+        additionalProperties: boolean;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            project_id: {
+                type: string;
+                description: string;
+            };
+            node_id: {
+                type: string;
+                description: string;
+                items?: undefined;
+                maxItems?: undefined;
+            };
+            direction: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            depth: {
+                type: string;
+                minimum: number;
+                maximum: number;
+                description: string;
+            };
+            limit: {
+                type: string;
+                minimum: number;
+                description: string;
+            };
+            branch: {
+                type: string;
+                description: string;
+            };
+            format: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            query?: undefined;
+            kind?: undefined;
+            directory?: undefined;
+            direct?: undefined;
+            order?: undefined;
+            after?: undefined;
+            file_path?: undefined;
+            anchors?: undefined;
+            before?: undefined;
+            path_prefix?: undefined;
+            dir?: undefined;
+        };
+        required: string[];
+        additionalProperties: boolean;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            project_id: {
+                type: string;
+                description: string;
+            };
+            dir: {
+                type: string;
+                maxLength: number;
+                description: string;
+            };
+            depth: {
+                type: string;
+                minimum: number;
+                maximum: number;
+                description: string;
+            };
+            limit: {
+                type: string;
+                minimum: number;
+                description: string;
+            };
+            branch: {
+                type: string;
+                description: string;
+            };
+            format: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            query?: undefined;
+            kind?: undefined;
+            directory?: undefined;
+            direct?: undefined;
+            order?: undefined;
+            after?: undefined;
+            file_path?: undefined;
+            anchors?: undefined;
+            before?: undefined;
+            node_id?: undefined;
+            path_prefix?: undefined;
+            direction?: undefined;
+        };
+        required: string[];
+        additionalProperties: boolean;
+    };
+})[];
+export declare function handleCodeContext(args: Args): Promise<ToolResult>;
+export declare function handleCodeSummary(args: Args): Promise<ToolResult>;
+export declare function handleCodeTree(args: Args): Promise<ToolResult>;
+export declare function handleCodeFiles(args: Args): Promise<ToolResult>;
+export declare function handleCodeSymbols(args: Args): Promise<ToolResult>;
+export declare function handleCodeResolve(args: Args): Promise<ToolResult>;
+export declare function handleCodeChanges(args: Args): Promise<ToolResult>;
+export declare function handleCodeGraph(args: Args): Promise<ToolResult>;
+export declare function handleCodeGraphFolders(args: Args): Promise<ToolResult>;
+export {};