@productbrain/mcp 0.0.1-beta.179 → 0.0.1-beta.180

package/dist/{chunk-IOEZLNTK.js → chunk-XPFSARXP.js}

@@ -49,7 +49,8 @@ function newKeyState() {
     apiKeyScope: "readwrite",
     sessionOriented: false,
     sessionClosed: false,
-    lastAccess: Date.now()
+    lastAccess: Date.now(),
+    deploymentUrl: null
   };
 }
 function getKeyState(apiKey) {
@@ -152,7 +153,8 @@ var _stdioState = {
   apiKeyScope: "readwrite",
   sessionOriented: false,
   sessionClosed: false,
-  lastAccess: 0
+  lastAccess: 0,
+  deploymentUrl: null
 };
 function state() {
   const reqKey = getRequestApiKey();
@@ -278,10 +280,44 @@ function bootstrap() {
 function bootstrapHttp() {
   process.env.CONVEX_SITE_URL ??= process.env.PRODUCTBRAIN_URL ?? DEFAULT_CLOUD_URL;
 }
-function getEnv(key) {
-  const value = process.env[key];
-  if (!value) throw new Error(`${key} environment variable is required`);
-  return value;
+function parseFallbackUrls() {
+  const raw = process.env.CONVEX_FALLBACK_URLS;
+  if (!raw) return [];
+  return raw.split(",").map((u) => u.trim()).filter(Boolean);
+}
+async function resolveDeploymentUrl() {
+  const s = state();
+  if (s.deploymentUrl) return s.deploymentUrl;
+  const primaryUrl = (process.env.CONVEX_SITE_URL ?? DEFAULT_CLOUD_URL).replace(/\/$/, "");
+  const fallbacks = parseFallbackUrls();
+  if (fallbacks.length === 0) {
+    return primaryUrl;
+  }
+  const candidates = [primaryUrl, ...fallbacks.map((u) => u.replace(/\/$/, ""))];
+  let apiKey;
+  try {
+    apiKey = getActiveApiKey();
+  } catch {
+    return primaryUrl;
+  }
+  for (const candidate of candidates) {
+    try {
+      const probeRes = await fetch(`${candidate}/api/key-check`, {
+        method: "POST",
+        headers: { "Authorization": `Bearer ${apiKey}`, "Content-Type": "application/json" },
+        signal: AbortSignal.timeout(3e3)
+      });
+      if (probeRes.ok) {
+        const data = await probeRes.json();
+        if (data.ok) {
+          s.deploymentUrl = candidate;
+          return candidate;
+        }
+      }
+    } catch {
+    }
+  }
+  return candidates[0];
 }
 function shouldLogAudit(status) {
   return status === "error" || process.env.MCP_DEBUG === "1";
@@ -318,7 +354,7 @@ var TOUCH_EXCLUDED = /* @__PURE__ */ new Set([
   "agent.closeSession"
 ]);
 async function callGateway(fn, args) {
-  const siteUrl = getEnv("CONVEX_SITE_URL").replace(/\/$/, "");
+  const siteUrl = await resolveDeploymentUrl();
   const apiKey = getActiveApiKey();
   const start = Date.now();
   let res;
@@ -1878,7 +1914,7 @@ Reason: ${resolved.reasoning || "low signal"}
 Choose one of these and retry with \`collection\`:
 ${suggestions}
 
-Correction path: rerun with your chosen \`collection\`, or capture and use \`entries action=move\` later.`;
+Correction path: rerun with your chosen \`collection\`, or capture and use \`move-entry\` later.`;
   return {
     content: [{ type: "text", text: textBody }],
     structuredContent: failure(
@@ -3334,7 +3370,7 @@ Use \`entries action=get\` to inspect the existing entry, or \`update-entry\` to
             lines.push(`- **${r.entryId}**: ${r.name} [${r.collection}] \u2014 \`${r.status}\` (${r.classifiedBy} ${r.confidence}%)${linkNote}`);
           }
           lines.push(`
-_Use \`entries action=move\` to correct any misclassified entries._`);
+_Use \`move-entry\` to correct any misclassified entries._`);
         }
       }
       if (skippedLowConfidence.length > 0) {
@@ -4160,20 +4196,23 @@ function sanitizeEntryData(data) {
   );
   return Object.keys(filtered).length > 0 ? filtered : void 0;
 }
-var ENTRIES_ACTIONS = ["list", "get", "batch", "search", "move"];
+var ENTRIES_ACTIONS = ["list", "get", "batch", "search"];
 var entriesSchema = z4.object({
   action: z4.enum(ENTRIES_ACTIONS).describe(
-    "'list': browse entries with filters. 'get': fetch one entry by ID. 'batch': fetch multiple entries. 'search': full-text search. 'move': move entry to a different collection."
+    "'list': browse entries with filters. 'get': fetch one entry by ID. 'batch': fetch multiple entries. 'search': full-text search."
   ),
-  entryId: z4.string().optional().describe("Entry ID for get/move action, e.g. 'DEC-42', 'BR-001'"),
+  entryId: z4.string().optional().describe("Entry ID for get action, e.g. 'DEC-42', 'BR-001'"),
   entryIds: z4.array(z4.string()).min(1).max(20).optional().describe("Entry IDs for batch action, e.g. ['TYPE-strategy', 'STR-jljeg7']"),
   collection: z4.string().optional().describe("Collection slug for list/search, e.g. 'glossary', 'tracking-events', 'business-rules'"),
-  toCollection: z4.string().optional().describe("Target collection slug for move action, e.g. 'decisions', 'architecture'"),
   status: z4.string().optional().describe("Filter: draft | active | deprecated | archived"),
   tag: z4.string().optional().describe("Filter by internal tag for list"),
   label: z4.string().optional().describe("Filter by label slug for list \u2014 matches entries across all collections"),
   query: z4.string().optional().describe("Search text for search action (min 2 characters)")
 });
+var moveEntrySchema = z4.object({
+  entryId: z4.string().describe("Entry ID to move, e.g. 'DEC-42', 'BR-001'"),
+  toCollection: z4.string().describe("Target collection slug, e.g. 'decisions', 'architecture'")
+});
 var entriesGetOutputSchema = z4.object({
   entryId: z4.string(),
   name: z4.string(),
@@ -4235,14 +4274,14 @@ function registerEntriesTools(server) {
     "entries",
     {
       title: "Entries",
-      description: 'Read entries from the Chain. One tool for all entry reading.\n\n- **list**: Browse entries with optional filters (collection, status, tag, label). Use collections action=list first to discover slugs.\n- **get**: Fetch a single entry by ID \u2014 full record with data, labels, relations, history.\n- **batch**: Fetch multiple entries (max 20) in one call. Same shape as get per entry.\n- **search**: Full-text search across entries. Scope by collection or filter by status.\n- **move**: Move an entry to a different collection. Use when classifier misrouted or user wants to reclassify.\n\nUse `entries action=get entryId="..."` to fetch one. Use `entries action=search query="..."` to discover.',
+      description: 'Read entries from the Chain. One tool for all entry reading.\n\n- **list**: Browse entries with optional filters (collection, status, tag, label). Use collections action=list first to discover slugs.\n- **get**: Fetch a single entry by ID \u2014 full record with data, labels, relations, history.\n- **batch**: Fetch multiple entries (max 20) in one call. Same shape as get per entry.\n- **search**: Full-text search across entries. Scope by collection or filter by status.\n\nUse `entries action=get entryId="..."` to fetch one. Use `entries action=search query="..."` to discover. To reclassify, use `move-entry`.',
       inputSchema: entriesSchema,
-      annotations: { idempotentHint: false, openWorldHint: false }
+      annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false }
     },
     thinWrapper(async (args) => {
       const parsed = parseOrFail(entriesSchema, args);
       if (!parsed.ok) return parsed.result;
-      const { action, entryId, entryIds, collection, toCollection, status, tag, label, query } = parsed.data;
+      const { action, entryId, entryIds, collection, status, tag, label, query } = parsed.data;
       return runWithToolContext({ tool: "entries", action }, async () => {
         if (action === "get") {
           if (!entryId) {
@@ -4265,15 +4304,27 @@ function registerEntriesTools(server) {
         if (action === "list") {
           return handleList(collection, status, tag, label);
         }
-        if (action === "move") {
-          if (!entryId) return validationResult("entryId is required when action is 'move'.");
-          if (!toCollection) return validationResult("toCollection is required when action is 'move'.");
-          return handleMove(entryId, toCollection);
-        }
         return unknownAction(action, ENTRIES_ACTIONS);
       });
     })
   );
+  server.registerTool(
+    "move-entry",
+    {
+      title: "Move Entry",
+      description: 'Move an entry to a different collection. Use when the classifier misrouted or the user wants to reclassify.\n\nExample: `move-entry entryId="DEC-42" toCollection="tensions"` reclassifies DEC-42 into the tensions collection.',
+      inputSchema: moveEntrySchema,
+      annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false }
+    },
+    thinWrapper(async (args) => {
+      const parsed = parseOrFail(moveEntrySchema, args);
+      if (!parsed.ok) return parsed.result;
+      return runWithToolContext(
+        { tool: "move-entry", action: "move" },
+        () => handleMove(parsed.data.entryId, parsed.data.toCollection)
+      );
+    })
+  );
 }
 async function handleGet(entryId) {
   const entry = await kernelQuery("chain.getEntry", { entryId });
@@ -4953,37 +5004,6 @@ async function handleCreate(from, to, type, score, preview) {
     sessionId: agentSessionId ?? void 0,
     ...preview ? { preview: true } : {}
   });
-  if (result?.chainDebtPrevented) {
-    const alts = result.suggestedAlternatives ?? [];
-    const altList = alts.map((a) => `  \u2022 \`${a.type}\`: ${a.reason}`).join("\n");
-    return {
-      content: [{
-        type: "text",
-        text: `# Chain Debt Prevented
-
-**"${result.originalType ?? type}"** was intercepted as a common misuse for this entry pair and converted to an agent sign-off proposal.
-
-**Proposal ID:** \`${result.proposalId}\`
-
-**Suggested alternatives:**
-${altList}
-
-Review at /review in Cortex UI.`
-      }],
-      structuredContent: success(
-        `Chain debt prevented: "${result.originalType ?? type}" was intercepted and converted to an agent sign-off proposal.`,
-        {
-          chainDebtPrevented: true,
-          proposalId: result.proposalId,
-          originalType: result.originalType ?? type,
-          suggestedAlternatives: result.suggestedAlternatives
-        },
-        [
-          { tool: "relations", description: "Use correct type (e.g. informed_by)", parameters: { action: "create", from, to, type: alts[0]?.type ?? "informed_by" } }
-        ]
-      )
-    };
-  }
   if (result?.preview) {
     const suggested2 = result.suggestedType;
     const suggestedWithPosture2 = suggested2 ? { ...suggested2, governancePosture: suggested2.type === "governs" ? "requires_consent" : "direct" } : void 0;
@@ -9800,7 +9820,7 @@ var facilitateSchema = z14.object({
   betEntryId: z14.string().optional().describe("Bet entry ID. Required for both actions."),
   operationId: z14.string().optional().describe("Optional idempotency key for commit-constellation retries.")
 });
-function buildCortexUrl(workspaceSlug, entryId) {
+function buildStudioUrl(workspaceSlug, entryId) {
   const appUrl = process.env.PRODUCTBRAIN_APP_URL ?? "https://work.productbrain.io";
   return `${appUrl}/${workspaceSlug}/legacy/entries/${entryId}`;
 }
@@ -9851,7 +9871,7 @@ async function handleResume(args) {
   });
   const enrichedData = {
     ...envelope.data,
-    cortexUrl: buildCortexUrl(workspaceSlug, betId)
+    studioUrl: buildStudioUrl(workspaceSlug, betId)
   };
   const bet = enrichedData.betEntry;
   const cx = enrichedData.constellation;
@@ -9867,7 +9887,7 @@ async function handleResume(args) {
     `# ${bet.name}`,
     "",
     `**ID:** \`${bet.betEntryId}\` \xB7 **Status:** ${bet.status}`,
-    enrichedData.cortexUrl ? `**Cortex:** ${enrichedData.cortexUrl}` : "",
+    enrichedData.studioUrl ? `**Cortex:** ${enrichedData.studioUrl}` : "",
     "",
     `**Constellation:** ${constellationSummary}`,
     ...draftLines.length > 0 ? ["", "**Session drafts:**", ...draftLines] : []
@@ -15670,6 +15690,8 @@ function initFeatureFlags(_posthogClient) {
 export {
   hashKey,
   runWithAuth,
+  getKeyState,
+  DEFAULT_CLOUD_URL,
   getAgentSessionId,
   orphanAgentSession,
   bootstrap,
@@ -15680,4 +15702,4 @@ export {
   createProductBrainServer,
   initFeatureFlags
 };
-//# sourceMappingURL=chunk-IOEZLNTK.js.map
+//# sourceMappingURL=chunk-XPFSARXP.js.map