vantage-peers-mcp 2.15.0 → 2.16.0

package/dist/src/tools.d.ts

@@ -30,6 +30,18 @@ export declare function capListResponseBytes(items: unknown, rawText: string, to
 export declare const convexIdPattern: RegExp;
 export declare const receiptIdSchema: z.ZodString;
 export declare const memoryIdSchema: z.ZodString;
+export declare const taskIdSchema: z.ZodString;
+export declare const missionIdSchema: z.ZodString;
+export declare const messageIdSchema: z.ZodString;
+export declare const noteIdSchema: z.ZodString;
+export declare const componentIdSchema: z.ZodString;
+export declare const mandateIdSchema: z.ZodString;
+export declare const patternIdSchema: z.ZodString;
+export declare const errorIdSchema: z.ZodString;
+export declare const recurringTaskIdSchema: z.ZodString;
+export declare const buIdSchema: z.ZodString;
+export declare const episodeIdSchema: z.ZodString;
+export declare const diaryIdSchema: z.ZodString;
 export declare const creatorSchema: z.ZodString;
 export declare const severitySchema: z.ZodEnum<{
     critical: "critical";

package/dist/src/tools.js

@@ -143,6 +143,20 @@ export const receiptIdSchema = z
 export const memoryIdSchema = z
     .string()
     .regex(convexIdPattern, "Invalid memory ID format (expected 32-char Convex ID)");
+/** Build a strict Convex document-ID schema with a field-named error message. */
+const convexIdSchema = (field) => z.string().regex(convexIdPattern, `${field} must be a 32-char lowercase alphanumeric Convex ID`);
+export const taskIdSchema = convexIdSchema("taskId");
+export const missionIdSchema = convexIdSchema("missionId");
+export const messageIdSchema = convexIdSchema("messageId");
+export const noteIdSchema = convexIdSchema("noteId");
+export const componentIdSchema = convexIdSchema("componentId");
+export const mandateIdSchema = convexIdSchema("mandateId");
+export const patternIdSchema = convexIdSchema("patternId");
+export const errorIdSchema = convexIdSchema("errorId");
+export const recurringTaskIdSchema = convexIdSchema("recurringTaskId");
+export const buIdSchema = convexIdSchema("buId");
+export const episodeIdSchema = convexIdSchema("episodeId");
+export const diaryIdSchema = convexIdSchema("diaryId");
 const memoryTypeSchema = z
     .enum(["user", "feedback", "project", "reference", "episode"])
     .describe("Memory classification type");
@@ -347,9 +361,7 @@ export const updateBriefingNoteDescription = "Update an existing briefing note;
     "WHEN: use to add decisions, fix content, or relink memories — RBAC: caller must be createdBy or system. " +
     "EXAMPLE: update_briefing_note noteId='j57aaaaa...' callerOrchestrator='alpha' decisions=['Use hybrid_search first'].";
 export const updateBriefingNoteSchema = z.object({
-    noteId: z
-        .string()
-        .describe("Convex document ID of the briefing note to update"),
+    noteId: noteIdSchema.describe("Convex document ID of the briefing note to update"),
     callerOrchestrator: creatorSchema.describe("Orchestrator role making the update — must match createdBy or be 'system' (RBAC deny-by-default)"),
     title: z.string().optional().describe("Optional new title — full replace"),
     topic: z.string().optional().describe("Optional new topic — full replace"),
@@ -597,7 +609,21 @@ export function parseConvexError(rawMessage) {
  * used by `mcpError`.
  */
 export function mcpConvexError(error) {
-    const rawMessage = error instanceof Error ? error.message : String(error);
+    // Empirical probe (Day 127, 2026-07-10 — Sigma): Convex redacts
+    // `error.message` to a bare "[Request ID: ...] Server Error" string for
+    // ConvexError throws, but the ACTUAL actionable payload passed to
+    // `throw new ConvexError(...)` server-side survives on `error.data`
+    // (string or arbitrary JSON-serialisable value). Prefer `.data` when
+    // present so callers see e.g. "TASK_START_BLOCKED: ..." instead of the
+    // opaque redacted message.
+    const data = error?.data;
+    const rawMessage = data !== undefined && data !== null
+        ? typeof data === "string"
+            ? data
+            : JSON.stringify(data)
+        : error instanceof Error
+            ? error.message
+            : String(error);
     const parsed = parseConvexError(rawMessage);
     // For ArgumentValidationError and other known Convex codes, return structured JSON
     if (parsed.code !== "ServerError") {
@@ -1179,9 +1205,7 @@ export function registerTools(server, convex, oauthCtx) {
         createdBy: creatorSchema,
         relatesTo: z
             .object({
-            targetId: z
-                .string()
-                .describe("ID of the memory this relates to (Convex document ID)"),
+            targetId: memoryIdSchema.describe("ID of the memory this relates to (Convex document ID)"),
             type: z
                 .enum(["updates", "extends", "derives"])
                 .describe("Relation type: updates=supersedes, extends=adds detail, derives=inference"),
@@ -1244,9 +1268,7 @@ export function registerTools(server, convex, oauthCtx) {
     server.tool("soft_delete_memory", "Soft-delete a memory so it stops appearing in recall results while remaining in the audit log. " +
         "WHEN: use to retire an outdated fact or superseded rule without permanent data loss. " +
         "EXAMPLE: soft_delete_memory memoryId='j57dy3049btafda9m2f5d2ggk987ph3f'.", {
-        memoryId: z
-            .string()
-            .describe("Convex document ID of the memory to soft-delete"),
+        memoryId: memoryIdSchema.describe("Convex document ID of the memory to soft-delete"),
     }, {
         readOnlyHint: false,
         openWorldHint: false,
@@ -1277,7 +1299,7 @@ export function registerTools(server, convex, oauthCtx) {
     server.tool("get_memory", "Fetch a single memory by its Convex document ID, including relations and episode metadata. " +
         "WHEN: use when you have a specific memoryId from a prior recall/store and need the full record. " +
         "EXAMPLE: get_memory memoryId='j57dy3049btafda9m2f5d2ggk987ph3f'.", {
-        memoryId: z.string().describe("Memory document ID"),
+        memoryId: memoryIdSchema.describe("Memory document ID"),
     }, {
         readOnlyHint: true,
         openWorldHint: false,
@@ -1632,7 +1654,7 @@ export function registerTools(server, convex, oauthCtx) {
     server.tool("get_episode", "Fetch a single episode by its memory document ID. Episodes are memories with type='episode' carrying context/goal/action/outcome/insight + severity. " +
         "WHEN: use when you have an episodeId from store_episode or a prior search and need the full record. " +
         "EXAMPLE: get_episode episodeId='j57dy3049btafda9m2f5d2ggk987ph3f'.", {
-        episodeId: z.string().describe("Episode (memory) document ID"),
+        episodeId: episodeIdSchema.describe("Episode (memory) document ID"),
     }, {
         readOnlyHint: true,
         openWorldHint: false,
@@ -2266,9 +2288,7 @@ export function registerTools(server, convex, oauthCtx) {
     server.tool("delete_message", "Delete a message and all its receipts; only the original sender or system may delete. " +
         "WHEN: use to retract a mistaken broadcast or sensitive content before recipients read it. " +
         "EXAMPLE: delete_message messageId='j57dy3049btafda9m2f5d2ggk987ph3f' callerOrchestrator='alpha'.", {
-        messageId: z
-            .string()
-            .describe("Convex document ID of the message to delete"),
+        messageId: messageIdSchema.describe("Convex document ID of the message to delete"),
         callerOrchestrator: creatorSchema
             .optional()
             .describe("Optional RBAC — must be the sender or system"),
@@ -2586,9 +2606,7 @@ export function registerTools(server, convex, oauthCtx) {
         "WHEN: use after send_message to confirm all recipients acknowledged a critical announcement. " +
         "EXAMPLE: list_broadcast_status messageId='j57dy3049btafda9m2f5d2ggk987ph3f'. " +
         "Default limit 20. cap 200.", {
-        messageId: z
-            .string()
-            .describe("Convex document ID of the broadcast message"),
+        messageId: messageIdSchema.describe("Convex document ID of the broadcast message"),
         limit: z
             .number()
             .int()
@@ -2646,11 +2664,10 @@ export function registerTools(server, convex, oauthCtx) {
         priority: prioritySchema,
         status: taskStatusSchema.default("todo"),
         dependsOn: z
-            .array(z.string())
+            .array(taskIdSchema)
             .optional()
             .describe("Task IDs that must be completed before this task can start"),
-        missionId: z
-            .string()
+        missionId: missionIdSchema
             .optional()
             .describe("Convex document ID of the parent mission"),
         estimatedMinutes: z
@@ -2821,7 +2838,7 @@ export function registerTools(server, convex, oauthCtx) {
             .optional()
             .describe("Filter by status"),
         project: z.string().optional().describe("Filter by project name"),
-        missionId: z.string().optional().describe("Filter by mission Convex ID"),
+        missionId: missionIdSchema.optional().describe("Filter by mission Convex ID"),
         limit: z
             .number()
             .int()
@@ -2861,7 +2878,7 @@ export function registerTools(server, convex, oauthCtx) {
     server.tool("update_task", "Update any mutable field on a task; only provided fields are patched, updatedAt auto-set. " +
         "WHEN: use to reassign, reprioritize, or add context to an existing task without recreating it. " +
         "EXAMPLE: update_task taskId='k178d3ns...' status='review' callerOrchestrator='alpha'.", {
-        taskId: z.string().describe("Convex document ID of the task to update"),
+        taskId: taskIdSchema.describe("Convex document ID of the task to update"),
         title: z.string().optional().describe("New title"),
         description: z.string().optional().describe("New description"),
         project: z.string().optional().describe("New project"),
@@ -2870,11 +2887,10 @@ export function registerTools(server, convex, oauthCtx) {
         priority: prioritySchema.optional().describe("New priority"),
         status: taskStatusSchema.optional().describe("New status"),
         dependsOn: z
-            .array(z.string())
+            .array(taskIdSchema)
             .optional()
             .describe("Task IDs that must be completed before this task can start"),
-        missionId: z
-            .string()
+        missionId: missionIdSchema
             .optional()
             .describe("Link to a mission (Convex document ID)"),
         estimatedMinutes: z
@@ -2946,7 +2962,7 @@ export function registerTools(server, convex, oauthCtx) {
     server.tool("complete_task", "Mark a task as done with a mandatory completionNote; always notify the creator via send_message after. " +
         "WHEN: call when all deliverables are committed or verified — never complete without a proof token in the note. " +
         "EXAMPLE: complete_task taskId='k178d3ns...' completionNote='PR #667 merged, 86 descriptions updated' callerOrchestrator='beta'.", {
-        taskId: z.string().describe("Convex document ID of the task to complete"),
+        taskId: taskIdSchema.describe("Convex document ID of the task to complete"),
         completionNote: z
             .string()
             .describe("What was actually done — summary of work completed"),
@@ -2987,7 +3003,7 @@ export function registerTools(server, convex, oauthCtx) {
     server.tool("start_task", "Set a task to in_progress and record the startedAt timestamp for duration tracking. " +
         "WHEN: call as the first action when picking up a task to signal activity and enable metrics. " +
         "EXAMPLE: start_task taskId='k178d3ns...' callerOrchestrator='gamma'.", {
-        taskId: z.string().describe("Convex document ID of the task to start"),
+        taskId: taskIdSchema.describe("Convex document ID of the task to start"),
         callerOrchestrator: creatorSchema
             .optional()
             .describe("Optional RBAC — if provided, must be creator or assignee"),
@@ -3024,7 +3040,7 @@ export function registerTools(server, convex, oauthCtx) {
     server.tool("checkout_task", "Atomically claim a todo task, preventing race conditions when multiple orchestrators compete. " +
         "WHEN: use before start_task in multi-orchestrator queues to ensure exclusive ownership. " +
         "EXAMPLE: checkout_task taskId='k178d3ns...' callerOrchestrator='alpha' callerInstance='alpha-vps'.", {
-        taskId: z.string().describe("Convex document ID of the task to claim"),
+        taskId: taskIdSchema.describe("Convex document ID of the task to claim"),
         callerOrchestrator: creatorSchema.describe("Orchestrator claiming the task (e.g. sigma, pi)"),
         callerInstance: z
             .string()
@@ -3062,7 +3078,7 @@ export function registerTools(server, convex, oauthCtx) {
     server.tool("delete_task", "Permanently delete a task; only the creator or system role may delete. " +
         "WHEN: use to remove erroneously created tasks or test artifacts — prefer complete_task for real work. " +
         "EXAMPLE: delete_task taskId='k178d3ns...' callerOrchestrator='alpha'.", {
-        taskId: z.string().describe("Convex document ID of the task to delete"),
+        taskId: taskIdSchema.describe("Convex document ID of the task to delete"),
         callerOrchestrator: creatorSchema
             .optional()
             .describe("Optional RBAC — must be creator or system"),
@@ -3099,10 +3115,10 @@ export function registerTools(server, convex, oauthCtx) {
     server.tool("block_task", "Mark a task as blocked with an optional reason and blocking task IDs, setting status to blocked. " +
         "WHEN: use when external dependency or missing input prevents progress — record the specific blocker. " +
         "EXAMPLE: block_task taskId='k178d3ns...' reason='Waiting for B2 PR#667 merge' callerOrchestrator='beta'.", {
-        taskId: z.string().describe("Convex document ID of the task to block"),
+        taskId: taskIdSchema.describe("Convex document ID of the task to block"),
         reason: z.string().optional().describe("Why the task is blocked"),
         blockedBy: z
-            .array(z.string())
+            .array(taskIdSchema)
             .optional()
             .describe("Task IDs that are blocking this task"),
         callerOrchestrator: creatorSchema
@@ -3148,11 +3164,9 @@ export function registerTools(server, convex, oauthCtx) {
     server.tool("add_task_dependency", "Add dependency task IDs to a task so it cannot start until all listed tasks complete. " +
         "WHEN: use when creating a task that depends on prior work not yet captured in dependsOn. " +
         "EXAMPLE: create_task_dependency taskId='k178d3ns...' dependsOn=['k17bbbbb...'] callerOrchestrator='alpha'.", {
-        taskId: z
-            .string()
-            .describe("Convex document ID of the task that depends on others"),
+        taskId: taskIdSchema.describe("Convex document ID of the task that depends on others"),
         dependsOn: z
-            .array(z.string())
+            .array(taskIdSchema)
             .describe("Task IDs that must complete first"),
         callerOrchestrator: creatorSchema
             .optional()
@@ -3194,7 +3208,7 @@ export function registerTools(server, convex, oauthCtx) {
         "WHEN: use to review mission progress or find blocked/open tasks within a specific mission. " +
         "EXAMPLE: list_tasks_by_mission missionId='k57a36y8...' status='in_progress' limit=20. " +
         "Default limit 20. cap 200.", {
-        missionId: z.string().describe("Convex document ID of the mission"),
+        missionId: missionIdSchema.describe("Convex document ID of the mission"),
         status: taskStatusFilterSchema
             .optional()
             .describe("Filter by task status (single, alias, or array)"),
@@ -3435,7 +3449,7 @@ export function registerTools(server, convex, oauthCtx) {
     server.tool("get_mission", "Fetch a single mission by Convex ID with full details: status, pilot, agents, progress, and dates. " +
         "WHEN: use before assigning tasks or reporting to get the canonical mission state. " +
         "EXAMPLE: get_mission missionId='k57a36y8w5t085bqr23dsmvb2d882506'.", {
-        missionId: z.string().describe("Convex document ID of the mission"),
+        missionId: missionIdSchema.describe("Convex document ID of the mission"),
     }, {
         readOnlyHint: true,
         openWorldHint: false,
@@ -3465,9 +3479,7 @@ export function registerTools(server, convex, oauthCtx) {
     server.tool("update_mission", "Update any mutable field on a mission; only provided fields are patched, updatedAt auto-set. " +
         "WHEN: use to advance status, update progress percentage, or change pilot/agents mid-flight. " +
         "EXAMPLE: update_mission missionId='k57a36y8...' progress=75 status='validate'.", {
-        missionId: z
-            .string()
-            .describe("Convex document ID of the mission to update"),
+        missionId: missionIdSchema.describe("Convex document ID of the mission to update"),
         name: z.string().optional().describe("New name"),
         description: z.string().optional().describe("New description"),
         project: z.string().optional().describe("New project"),
@@ -3522,7 +3534,7 @@ export function registerTools(server, convex, oauthCtx) {
     server.tool("update_mission_status", "Change a mission's lifecycle status in a single call without touching other fields. " +
         "WHEN: use as a lightweight alternative to update_mission when only the status changes. " +
         "EXAMPLE: update_mission_status missionId='k57a36y8...' status='complete'.", {
-        missionId: z.string().describe("Convex document ID of the mission"),
+        missionId: missionIdSchema.describe("Convex document ID of the mission"),
         status: missionStatusSchema.describe("New status"),
     }, {
         readOnlyHint: false,
@@ -3860,7 +3872,7 @@ export function registerTools(server, convex, oauthCtx) {
     server.tool("get_briefing_note", "Fetch a single briefing note by ID with all fields: title, topic, participants, content, decisions, and links. " +
         "WHEN: use when you have a specific noteId and need the full structured record for a handoff or recap. " +
         "EXAMPLE: get_briefing_note noteId='j57dy3049btafda9m2f5d2ggk987ph3f'.", {
-        noteId: z.string().describe("Briefing note document ID"),
+        noteId: noteIdSchema.describe("Briefing note document ID"),
     }, {
         readOnlyHint: true,
         openWorldHint: false,
@@ -4213,7 +4225,7 @@ export function registerTools(server, convex, oauthCtx) {
     server.tool("update_component", "Update a component's content, version, or team; only provided fields are patched. " +
         "WHEN: use to bump a skill version or fix content without re-registering from scratch. " +
         "EXAMPLE: update_component componentId='j57aaaaa...' version='1.3.0' content='...'.", {
-        componentId: z.string().describe("Convex document ID of the component"),
+        componentId: componentIdSchema.describe("Convex document ID of the component"),
         name: z.string().optional().describe("New component name"),
         team: z.string().optional().describe("New team name"),
         content: z.string().optional().describe("New content/source code"),
@@ -4262,9 +4274,7 @@ export function registerTools(server, convex, oauthCtx) {
     server.tool("delete_component", "Permanently delete a component from the registry by Convex document ID. " +
         "WHEN: use to remove deprecated or test components that should no longer be discoverable. " +
         "EXAMPLE: delete_component componentId='j57aaaaa...'.", {
-        componentId: z
-            .string()
-            .describe("Convex document ID of the component to delete"),
+        componentId: componentIdSchema.describe("Convex document ID of the component to delete"),
     }, {
         readOnlyHint: false,
         openWorldHint: false,
@@ -4529,7 +4539,7 @@ export function registerTools(server, convex, oauthCtx) {
     server.tool("pause_recurring_task", "Pause a recurring task template to stop auto-creating tasks until explicitly resumed. " +
         "WHEN: use during holidays, freezes, or when the assignee is unavailable for a period. " +
         "EXAMPLE: pause_recurring_task taskId='j57aaaaa...'.", {
-        taskId: z.string().describe("Recurring task ID"),
+        taskId: recurringTaskIdSchema.describe("Recurring task ID"),
     }, {
         readOnlyHint: false,
         openWorldHint: false,
@@ -4556,7 +4566,7 @@ export function registerTools(server, convex, oauthCtx) {
     server.tool("resume_recurring_task", "Resume a paused recurring task template and recalculate its next scheduled run time. " +
         "WHEN: use after a pause period ends to re-enable automatic task generation. " +
         "EXAMPLE: resume_recurring_task taskId='j57aaaaa...'.", {
-        taskId: z.string().describe("Recurring task ID"),
+        taskId: recurringTaskIdSchema.describe("Recurring task ID"),
     }, {
         readOnlyHint: false,
         openWorldHint: false,
@@ -4583,7 +4593,7 @@ export function registerTools(server, convex, oauthCtx) {
     server.tool("delete_recurring_task", "Permanently delete a recurring task template, stopping all future scheduled task generation. " +
         "WHEN: use when a recurring process is retired and should never generate tasks again. " +
         "EXAMPLE: delete_recurring_task taskId='j57aaaaa...'.", {
-        taskId: z.string().describe("Recurring task ID"),
+        taskId: recurringTaskIdSchema.describe("Recurring task ID"),
     }, {
         readOnlyHint: false,
         openWorldHint: false,
@@ -4610,9 +4620,7 @@ export function registerTools(server, convex, oauthCtx) {
     server.tool("update_recurring_task", "Update a recurring task template's fields; cronExpression change auto-recalculates nextRunAt. " +
         "WHEN: use to change assignee, schedule, or priority of an active recurring template. " +
         "EXAMPLE: update_recurring_task recurringTaskId='j57aaaaa...' cronExpression='0 10 * * 1' priority='high'.", {
-        recurringTaskId: z
-            .string()
-            .describe("Convex document ID of the recurring task"),
+        recurringTaskId: recurringTaskIdSchema.describe("Convex document ID of the recurring task"),
         title: z.string().optional().describe("New title"),
         description: z.string().optional().describe("New description"),
         assignedTo: creatorSchema.optional().describe("New assignee"),
@@ -4715,9 +4723,7 @@ export function registerTools(server, convex, oauthCtx) {
     server.tool("accept_mandate", "Accept a mandate by the fulfilledBy orchestrator, advancing status from requested to accepted. " +
         "WHEN: call when the fulfiller confirms they can deliver the service within the agreed budget. " +
         "EXAMPLE: accept_mandate mandateId='j57aaaaa...' callerOrchestrator='beta'.", {
-        mandateId: z
-            .string()
-            .describe("Convex document ID of the mandate to accept"),
+        mandateId: mandateIdSchema.describe("Convex document ID of the mandate to accept"),
         callerOrchestrator: creatorSchema.describe("Must be the fulfilledBy orchestrator or system"),
     }, {
         readOnlyHint: false,
@@ -4750,9 +4756,7 @@ export function registerTools(server, convex, oauthCtx) {
     server.tool("update_mandate", "Update a mandate's status, tokensCost, or linkedTaskIds; only fulfilledBy or system may update. " +
         "WHEN: use to record spend progress, link created tasks, or advance status to delivered. " +
         "EXAMPLE: update_mandate mandateId='j57aaaaa...' callerOrchestrator='beta' tokensCost=1200 status='delivered'.", {
-        mandateId: z
-            .string()
-            .describe("Convex document ID of the mandate to update"),
+        mandateId: mandateIdSchema.describe("Convex document ID of the mandate to update"),
         callerOrchestrator: creatorSchema.describe("Must be the fulfilledBy orchestrator or system"),
         status: mandateStatusSchema.optional().describe("New status"),
         tokensCost: z.number().optional().describe("Tokens consumed so far"),
@@ -4794,9 +4798,7 @@ export function registerTools(server, convex, oauthCtx) {
     server.tool("settle_mandate", "Settle a mandate by confirming delivery and recording the final token cost; sets status to settled. " +
         "WHEN: call after verifying the delivered work meets the mandate scope — closes the billing cycle. " +
         "EXAMPLE: settle_mandate mandateId='j57aaaaa...' callerOrchestrator='alpha' finalCost=4800.", {
-        mandateId: z
-            .string()
-            .describe("Convex document ID of the mandate to settle"),
+        mandateId: mandateIdSchema.describe("Convex document ID of the mandate to settle"),
         callerOrchestrator: creatorSchema.describe("Must be the requestedBy orchestrator or system"),
         finalCost: z.number().describe("Final actual token cost to record"),
     }, {
@@ -4831,7 +4833,7 @@ export function registerTools(server, convex, oauthCtx) {
     server.tool("validate_mandate_spending", "Check whether a proposed token spend is within a mandate's AP2 spending limits. " +
         "WHEN: call before each service transaction to prevent over-spend and get within/exceeded status. " +
         "EXAMPLE: check_mandate_spending mandateId='j57aaaaa...' proposedAmount=500.", {
-        mandateId: z.string().describe("Mandate ID to validate against"),
+        mandateId: mandateIdSchema.describe("Mandate ID to validate against"),
         proposedAmount: z
             .number()
             .describe("Proposed token spend amount to validate"),
@@ -5015,9 +5017,7 @@ export function registerTools(server, convex, oauthCtx) {
     server.tool("update_bu", "Update any mutable field on a business unit; only provided fields are patched, updatedAt auto-set. " +
         "WHEN: use to update status, revenue projections, or team composition as the BU evolves. " +
         "EXAMPLE: update_bu buId='j57aaaaa...' status='live' revenueProjections={y1:10000,y2:80000,y3:300000}.", {
-        buId: z
-            .string()
-            .describe("Convex document ID of the business unit to update"),
+        buId: buIdSchema.describe("Convex document ID of the business unit to update"),
         name: z.string().optional().describe("New name"),
         description: z.string().optional().describe("New description"),
         purpose: z.string().optional().describe("New purpose"),
@@ -5084,7 +5084,7 @@ export function registerTools(server, convex, oauthCtx) {
     server.tool("get_bu", "Fetch a single business unit by Convex document ID, returning null if not found. " +
         "WHEN: use before updating or reporting on a BU to get the current canonical state. " +
         "EXAMPLE: get_bu buId='j57dy3049btafda9m2f5d2ggk987ph3f'.", {
-        buId: z.string().describe("Convex document ID of the business unit"),
+        buId: buIdSchema.describe("Convex document ID of the business unit"),
     }, {
         readOnlyHint: true,
         openWorldHint: false,
@@ -5204,9 +5204,7 @@ export function registerTools(server, convex, oauthCtx) {
     server.tool("delete_bu", "Permanently delete a business unit by Convex document ID — this action is irreversible. " +
         "WHEN: use only for test BUs or entities created in error; prefer status update for real BUs. " +
         "EXAMPLE: delete_bu buId='j57aaaaa...'.", {
-        buId: z
-            .string()
-            .describe("Convex document ID of the business unit to delete"),
+        buId: buIdSchema.describe("Convex document ID of the business unit to delete"),
     }, {
         readOnlyHint: false,
         openWorldHint: false,
@@ -5773,7 +5771,7 @@ export function registerTools(server, convex, oauthCtx) {
     server.tool("add_fix_attempt", "Add a fix attempt record to a pattern with description, outcome, and optional commit reference. " +
         "WHEN: use after each fix attempt (successful or not) to build a complete fix history. " +
         "EXAMPLE: create_fix_attempt patternId='j57aaaaa...' description='Added suppressHydrationWarning' worked=true why='Prevents mismatches' createdBy='beta'.", {
-        patternId: z.string().describe("ID of the fix pattern"),
+        patternId: patternIdSchema.describe("ID of the fix pattern"),
         description: z.string().describe("What was tried — the fix approach"),
         worked: z.boolean().describe("Did this fix the issue?"),
         why: z.string().describe("Why it worked or didn't — the reasoning"),
@@ -5814,7 +5812,7 @@ export function registerTools(server, convex, oauthCtx) {
     server.tool("validate_fix", "Set or update the validated fix description on a fix pattern after confirming it works. " +
         "WHEN: use after a fix attempt succeeds to promote it as the canonical solution on the pattern. " +
         "EXAMPLE: check_fix patternId='j57aaaaa...' validatedFix='Add suppressHydrationWarning to date elements'.", {
-        patternId: z.string().describe("ID of the fix pattern"),
+        patternId: patternIdSchema.describe("ID of the fix pattern"),
         validatedFix: z.string().describe("Description of the validated fix"),
     }, {
         readOnlyHint: false,
@@ -6046,7 +6044,7 @@ export function registerTools(server, convex, oauthCtx) {
     server.tool("link_issue_to_pattern", "Link a VantagePeers issue to a fix pattern creating a bidirectional reference. " +
         "WHEN: use after creating a fix pattern for an issue to connect the symptom record with the bug tracker. " +
         "EXAMPLE: link_issue_to_pattern patternId='j57aaaaa...' issueId='j57bbbbb...'.", {
-        patternId: z.string().describe("ID of the fix pattern"),
+        patternId: patternIdSchema.describe("ID of the fix pattern"),
         issueId: z.string().describe("VantagePeers issue ID to link"),
     }, {
         readOnlyHint: false,
@@ -6179,9 +6177,7 @@ export function registerTools(server, convex, oauthCtx) {
         templateName: z
             .string()
             .describe("Name of the mission template to instantiate"),
-        missionId: z
-            .string()
-            .describe("Convex document ID of the target mission"),
+        missionId: missionIdSchema.describe("Convex document ID of the target mission"),
         context: z
             .record(z.string(), z.string())
             .optional()
@@ -6399,7 +6395,7 @@ export function registerTools(server, convex, oauthCtx) {
     server.tool("get_error", "Fetch a single error log entry by Convex document ID, including full stack trace and issue linkage. " +
         "WHEN: use after list_errors to retrieve the full stack trace for a specific error entry. " +
         "EXAMPLE: get_error errorId='j57dy3049btafda9m2f5d2ggk987ph3f'.", {
-        errorId: z.string().describe("Convex document ID of the errorLogs entry"),
+        errorId: errorIdSchema.describe("Convex document ID of the errorLogs entry"),
     }, {
         readOnlyHint: true,
         openWorldHint: false,
@@ -6668,7 +6664,7 @@ export function registerTools(server, convex, oauthCtx) {
     server.tool("check_mandate_spending", "[ALIAS of validate_mandate_spending] Check whether a proposed token spend is within a mandate's AP2 spending limits. " +
         "WHEN: call before each service transaction to prevent over-spend and get within/exceeded status. " +
         "EXAMPLE: check_mandate_spending mandateId='j57aaaaa...' proposedAmount=500.", {
-        mandateId: z.string(),
+        mandateId: mandateIdSchema,
         proposedAmount: z.number(),
     }, {
         readOnlyHint: true,
@@ -6693,7 +6689,7 @@ export function registerTools(server, convex, oauthCtx) {
     server.tool("check_fix", "[ALIAS of validate_fix] Set or update the validated fix description on a fix pattern after confirming it works. " +
         "WHEN: use after a fix attempt succeeds to promote it as the canonical solution on the pattern. " +
         "EXAMPLE: check_fix patternId='j57aaaaa...' validatedFix='Add suppressHydrationWarning to date elements'.", {
-        patternId: z.string(),
+        patternId: patternIdSchema,
         validatedFix: z.string(),
     }, {
         readOnlyHint: false,
@@ -6721,7 +6717,7 @@ export function registerTools(server, convex, oauthCtx) {
     server.tool("create_fix_attempt", "[ALIAS of add_fix_attempt] Add a fix attempt record to a pattern with description, outcome, and optional commit reference. " +
         "WHEN: use after each fix attempt (successful or not) to build a complete fix history. " +
         "EXAMPLE: create_fix_attempt patternId='j57aaaaa...' description='Added suppressHydrationWarning' worked=true why='Prevents mismatches' createdBy='beta'.", {
-        patternId: z.string(),
+        patternId: patternIdSchema,
         description: z.string(),
         worked: z.boolean(),
         why: z.string().optional(),
@@ -6757,8 +6753,8 @@ export function registerTools(server, convex, oauthCtx) {
     server.tool("create_task_dependency", "[ALIAS of add_task_dependency] Add dependency task IDs to a task so it cannot start until all listed tasks complete. " +
         "WHEN: use when creating a task that depends on prior work not yet captured in dependsOn. " +
         "EXAMPLE: create_task_dependency taskId='k178d3ns...' dependsOn=['k17bbbbb...'] callerOrchestrator='alpha'.", {
-        taskId: z.string(),
-        dependsOn: z.array(z.string()),
+        taskId: taskIdSchema,
+        dependsOn: z.array(taskIdSchema),
         callerOrchestrator: z.string(),
     }, {
         readOnlyHint: false,
@@ -6848,7 +6844,7 @@ export function registerTools(server, convex, oauthCtx) {
     server.tool("get_task", "Fetch a single task by its Convex document ID with all fields: title, description, status, priority, assignment, dependencies, mission link, completion note. " +
         "WHEN: use when you have a specific taskId from list_tasks/create_task and need the full record (brief, VERIFICATION block, completionNote). " +
         "EXAMPLE: get_task taskId='k172735brsw6bc3j2dkkkfxqrx88kkjq'.", {
-        taskId: z.string().describe("Task document ID"),
+        taskId: taskIdSchema.describe("Task document ID"),
     }, {
         readOnlyHint: true,
         openWorldHint: false,
@@ -6874,7 +6870,7 @@ export function registerTools(server, convex, oauthCtx) {
     server.tool("get_fix_pattern", "Fetch a single fix pattern by its Convex document ID, including all linked fix attempts. " +
         "WHEN: use when you have a patternId from list_fix_patterns/search_fix_patterns and need the full record with attempts history. " +
         "EXAMPLE: get_fix_pattern patternId='m9748paffd0emrbwyskj868e1x88kvhj'.", {
-        patternId: z.string().describe("Fix pattern document ID"),
+        patternId: patternIdSchema.describe("Fix pattern document ID"),
     }, {
         readOnlyHint: true,
         openWorldHint: false,
@@ -6900,7 +6896,7 @@ export function registerTools(server, convex, oauthCtx) {
     server.tool("get_mandate", "Fetch a single spending mandate by its Convex document ID with limits, current spend, and approver chain. " +
         "WHEN: use when you have a mandateId from list_mandates and need the full record before validateSpending/settleMandate. " +
         "EXAMPLE: get_mandate mandateId='k57dy3049btafda9m2f5d2ggk987ph3f'.", {
-        mandateId: z.string().describe("Mandate document ID"),
+        mandateId: mandateIdSchema.describe("Mandate document ID"),
     }, {
         readOnlyHint: true,
         openWorldHint: false,
@@ -6960,7 +6956,7 @@ export function registerTools(server, convex, oauthCtx) {
     server.tool("get_message", "Fetch a single peer message by its Convex document ID with full body, channel, sender, sessionDay, and tenant scope. " +
         "WHEN: use when you have a messageId from list_messages/check_messages and need the raw row (e.g. for read-receipt audit, delete confirmation, or referencing in a fix pattern). " +
         "EXAMPLE: get_message messageId='jn7eg21wdaxzdcpdxwkvhaxqnh88jqg2'.", {
-        messageId: z.string().describe("Message document ID"),
+        messageId: messageIdSchema.describe("Message document ID"),
     }, {
         readOnlyHint: true,
         openWorldHint: false,
@@ -6989,7 +6985,7 @@ export function registerTools(server, convex, oauthCtx) {
     server.tool("get_recurring_task", "Fetch a single recurring task definition by its Convex document ID with cron schedule, prompt, assignee, and last-fire metadata. " +
         "WHEN: use when you have a recurringTaskId from list_recurring_tasks and need the full row before pause_recurring_task / update_recurring_task / delete_recurring_task. " +
         "EXAMPLE: get_recurring_task recurringTaskId='k57dy3049btafda9m2f5d2ggk987ph3f'.", {
-        recurringTaskId: z.string().describe("Recurring task document ID"),
+        recurringTaskId: recurringTaskIdSchema.describe("Recurring task document ID"),
     }, {
         readOnlyHint: true,
         openWorldHint: false,

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "vantage-peers-mcp",
-	"version": "2.15.0",
+	"version": "2.16.0",
 	"description": "MCP server for VantagePeers — shared memory, messaging, and task coordination for AI agent teams",
 	"type": "module",
 	"main": "./dist/server.js",
@@ -89,7 +89,6 @@
 		"node": ">=20"
 	},
 	"publishConfig": {
-		"access": "public",
-		"provenance": true
+		"access": "public"
 	}
 }