vantage-peers-mcp 2.14.2 → 2.15.0

package/README.md

@@ -373,6 +373,12 @@ Same two advisory VP-Sources doctrine paragraphs appended after the existing des
 - `search_components_by_keyword` (alias `search_components`) — keyword search over components
 - `hybrid_search` — RRF-fused vector + BM25 search; VP-Sources doctrine applies
 
+Knowledge Base document upload is a two-step flow (see `docs/cloud/kb-ingest.md`):
+1. `generate_upload_url` — mints a signed Convex storage upload URL (Convex mutation `kbMutations:generateUploadUrl`, requires a Clerk JWT with `org_id`). `POST` the binary to that URL to obtain a `storageId`.
+2. `store_document_chunked` — with the `storageId`, extracts text, chunks (~512 tokens), and schedules RAG embedding per chunk at write time.
+
+Ingested documents are then fully retrievable through `recall`, `text_search`, and `hybrid_search` like any other memory (Day 122 indexing fix + Day 123 `generate_upload_url` — the previously-missing upload entrypoint that made the KB end-to-end usable).
+
 #### `recall` — VP-Sources doctrine (PR-H)
 
 Alias of `search_memories_by_semantic`. Exports `RECALL_TOOL_DESCRIPTION` from `mcp-server/src/tools.ts`.

package/dist/src/tools/kbIngest.d.ts

@@ -58,6 +58,8 @@ export declare const SOFT_DELETE_DOCUMENT_TOOL_DESCRIPTION: string;
 export declare const softDeleteDocumentArgsSchema: z.ZodObject<{
     docId: z.ZodString;
 }, z.core.$strip>;
+export declare const GENERATE_UPLOAD_URL_TOOL_DESCRIPTION: string;
+export declare const generateUploadUrlArgsSchema: z.ZodObject<{}, z.core.$strip>;
 /**
  * Register store_document_chunked + soft_delete_document MCP tools.
  *

package/dist/src/tools/kbIngest.js

@@ -76,6 +76,15 @@ export const softDeleteDocumentArgsSchema = z.object({
         .describe("Document ID returned by store_document_chunked. " +
         "All chunks at namespace team/<orgId>/<docId> will be soft-deleted."),
 });
+export const GENERATE_UPLOAD_URL_TOOL_DESCRIPTION = "Mint a Convex storage upload URL for the Knowledge Base ingest flow. " +
+    "The caller's org (from the Clerk JWT) is bound implicitly — no client args required. " +
+    "POST the file binary to the returned URL to obtain a storageId, then call " +
+    "store_document_chunked with that storageId. " +
+    "Requires Clerk JWT with org_id — no-org bearers are rejected. " +
+    "Default limit: 1 URL per call. cap: 1 URL. " +
+    "Returns the upload URL as plain text. " +
+    "EXAMPLE: generate_upload_url (no args) → 'https://…convex.cloud/api/storage/upload?...'.";
+export const generateUploadUrlArgsSchema = z.object({});
 // ─────────────────────────────────────────────────────────────────────────────
 // Registration
 // ─────────────────────────────────────────────────────────────────────────────
@@ -177,4 +186,33 @@ export function registerKbIngestTools(server, convex, oauthCtx) {
             throw new McpError(ErrorCode.InternalError, message);
         }
     });
+    // ── generate_upload_url ─────────────────────────────────────────────────────
+    server.tool("generate_upload_url", GENERATE_UPLOAD_URL_TOOL_DESCRIPTION, generateUploadUrlArgsSchema.shape, {
+        readOnlyHint: false,
+        openWorldHint: false,
+        destructiveHint: false,
+        title: "Generate Knowledge Base upload URL",
+    }, async () => {
+        try {
+            const { orgId, namespacePrefix } = resolveOrgContext();
+            const url = (await convex.mutation("kbMutations:generateUploadUrl", { orgId, namespace: namespacePrefix }));
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: url,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            if (error instanceof McpError)
+                throw error;
+            const message = error instanceof Error ? error.message : String(error);
+            console.error("[generate_upload_url] mutation failed", {
+                errorMessage: message,
+            });
+            throw new McpError(ErrorCode.InternalError, message);
+        }
+    });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "vantage-peers-mcp",
-	"version": "2.14.2",
+	"version": "2.15.0",
 	"description": "MCP server for VantagePeers — shared memory, messaging, and task coordination for AI agent teams",
 	"type": "module",
 	"main": "./dist/server.js",