@productbrain/mcp 0.0.1-beta.163 → 0.0.1-beta.167

package/dist/{chunk-EPAHRXLQ.js → chunk-K2GIX46U.js}

@@ -309,17 +309,21 @@ function audit(fn, status, durationMs, errorMsg) {
 function getAuditLog() {
   return auditBuffer;
 }
-async function mcpCall(fn, args = {}) {
-  const cached = getCached(fn, args);
-  if (cached !== void 0) {
-    return cached;
-  }
+var TOUCH_EXCLUDED = /* @__PURE__ */ new Set([
+  "agent.touchSession",
+  "agent.startSession",
+  "agent.markOriented",
+  "agent.recordActivity",
+  "agent.recordWrapup",
+  "agent.closeSession"
+]);
+async function callGateway(fn, args) {
   const siteUrl = getEnv("CONVEX_SITE_URL").replace(/\/$/, "");
   const apiKey = getActiveApiKey();
   const start = Date.now();
   let res;
   try {
-    res = await fetch(`${siteUrl}/api/mcp`, {
+    res = await fetch(`${siteUrl}/api/aki`, {
       method: "POST",
       signal: AbortSignal.timeout(1e4),
       headers: {
@@ -333,38 +337,52 @@ async function mcpCall(fn, args = {}) {
     throw new Error(`MCP call "${fn}" network error: ${err.message}`);
   }
   const json = await res.json();
-  if (!res.ok || json.error) {
-    const msg = json.error ?? "unknown error";
-    audit(fn, "error", Date.now() - start, json.code ? `${msg} [${json.code}]` : msg);
+  if (!res.ok || json.ok === false) {
+    const errJson = json;
+    const msg = errJson.error ?? errJson.message ?? "unknown error";
+    audit(fn, "error", Date.now() - start, errJson.code ? `${msg} [${errJson.code}]` : msg);
     throw new McpCallError(
       `MCP call "${fn}" failed (${res.status}): ${msg}`,
       res.status,
-      json.code,
-      Array.isArray(json.missingRequiredFields) ? json.missingRequiredFields : void 0,
-      Array.isArray(json.fieldErrors) ? json.fieldErrors : void 0
+      errJson.code,
+      Array.isArray(errJson.missingRequiredFields) ? errJson.missingRequiredFields : void 0,
+      Array.isArray(errJson.fieldErrors) ? errJson.fieldErrors : void 0
     );
   }
   audit(fn, "ok", Date.now() - start);
-  const data = json.data;
+  const { data, summary, next, _meta } = json;
+  return {
+    data,
+    summary: summary || fn,
+    next,
+    _meta
+  };
+}
+async function mcpCall(fn, args = {}) {
+  const cached = getCached(fn, args);
+  if (cached !== void 0) {
+    return cached;
+  }
+  const { data } = await callGateway(fn, args);
   if (isWrite(fn)) {
     invalidateReadCache();
   } else {
     setCached(fn, args, data);
   }
   const s = state();
-  const TOUCH_EXCLUDED = /* @__PURE__ */ new Set([
-    "agent.touchSession",
-    "agent.startSession",
-    "agent.markOriented",
-    "agent.recordActivity",
-    "agent.recordWrapup",
-    "agent.closeSession"
-  ]);
   if (s.agentSessionId && !TOUCH_EXCLUDED.has(fn)) {
     touchSessionActivity();
   }
   return data;
 }
+async function mcpCallEnvelope(fn, args = {}) {
+  const { data, summary, next, _meta } = await callGateway(fn, args);
+  const s = state();
+  if (s.agentSessionId && !TOUCH_EXCLUDED.has(fn)) {
+    touchSessionActivity();
+  }
+  return { ok: true, summary, data, next, _meta };
+}
 var resolveInFlightMap = /* @__PURE__ */ new Map();
 async function getWorkspaceId() {
   const s = state();
@@ -2356,7 +2374,10 @@ Or use \`collections action=list\` to see available collections.`
         limit: 5,
         threshold: 2
       }).catch(() => null) : Promise.resolve(null);
-      const groundingRaw = await groundingPromise;
+      const groundingRaw = await Promise.race([
+        groundingPromise,
+        new Promise((r) => setTimeout(() => r(null), 500))
+      ]);
       const groundingElapsedMs = Date.now() - groundingStart;
       const groundingEntry = groundingRaw?.[0] ?? null;
       const groundingRelated = groundingEntry?.related ?? [];
@@ -7454,7 +7475,8 @@ async function runWrapupReview() {
   if (getApiKeyScope() === "read") {
     return { text: "Read-only session \u2014 nothing to review.", data: null, suggestions: [], failureCode: "READONLY_SCOPE" };
   }
-  const data = await mcpCall("agent.getSessionWrapup", { sessionId });
+  const kernelEnvelope = await mcpCallEnvelope("agent.getSessionWrapup", { sessionId });
+  const data = kernelEnvelope.data;
   if (data.wrapupCompletedAt) {
     return { text: "Wrapup already completed this session.", data, suggestions: [], failureCode: "ALREADY_COMPLETED" };
   }
@@ -7593,7 +7615,17 @@ async function runWrapupReview() {
     }
   }
   const gapCount = getSessionGaps().length;
-  return { text: lines.join("\n"), data, suggestions, gapCount, coherenceVerdict, persistentGaps };
+  return {
+    text: lines.join("\n"),
+    data,
+    suggestions,
+    gapCount,
+    coherenceVerdict,
+    persistentGaps,
+    kernelSummary: kernelEnvelope.summary,
+    kernelNext: kernelEnvelope.next,
+    kernelMeta: kernelEnvelope._meta
+  };
 }
 async function runWrapupCommitAll(data, cachedSuggestions) {
   requireWriteAccess();
@@ -7754,7 +7786,7 @@ function registerWrapupTools(server) {
         );
       }
       const useCachedReview = lastReviewSessionId === sessionId;
-      const data2 = useCachedReview && lastReviewData ? lastReviewData : await mcpCall("agent.getSessionWrapup", { sessionId });
+      const data2 = useCachedReview && lastReviewData ? lastReviewData : (await mcpCallEnvelope("agent.getSessionWrapup", { sessionId })).data;
       if (data2.drafts.length === 0) {
         return failureResult("No uncommitted drafts to commit.", "NOT_FOUND", "No uncommitted drafts to commit.", "Nothing to commit.");
       }
@@ -7775,7 +7807,7 @@ function registerWrapupTools(server) {
         }
       );
     }
-    const { text, data, suggestions, failureCode, gapCount, coherenceVerdict, persistentGaps } = await runWrapupReview();
+    const { text, data, suggestions, failureCode, gapCount, coherenceVerdict, persistentGaps, kernelSummary, kernelNext, kernelMeta } = await runWrapupReview();
     lastReviewData = data;
     lastReviewSuggestions = suggestions;
     lastReviewSessionId = getAgentSessionId();
@@ -7785,24 +7817,30 @@ ${text}` : text;
     if (failureCode) {
       return failureResult(fullText, failureCode, text);
     }
-    const next = data.drafts.length > 0 ? [{ tool: "session-wrapup", description: "Commit all drafts", parameters: { action: "commit-all" } }] : void 0;
+    const localNext = data.drafts.length > 0 ? [{ tool: "session-wrapup", description: "Commit all drafts", parameters: { action: "commit-all" } }] : void 0;
+    const next = kernelNext || localNext;
     const gapsSummary = gapCount ? `, ${gapCount} knowledge gaps detected` : "";
     const coherenceSummary = coherenceVerdict ? `, coherence: ${coherenceVerdict}` : "";
     const persistentSummary = persistentGaps?.length ? `, ${persistentGaps.length} persistent coherence gaps` : "";
-    return successResult(
-      fullText,
-      `Session review: ${data.drafts.length} uncommitted, ${data.committed.length} committed, ${suggestions.length} link suggestions${gapsSummary}${coherenceSummary}${persistentSummary}.`,
-      {
-        drafts: data.drafts.length,
-        committed: data.committed.length,
-        uncommitted: data.summary.uncommitted,
-        suggestedLinks: suggestions.length,
-        knowledgeGaps: gapCount ?? 0,
-        ...coherenceVerdict ? { coherenceVerdict } : {},
-        ...persistentGaps?.length ? { persistentCoherenceGaps: persistentGaps.length } : {}
-      },
-      next
-    );
+    const summaryText = `Session review: ${data.drafts.length} uncommitted, ${data.committed.length} committed, ${suggestions.length} link suggestions${gapsSummary}${coherenceSummary}${persistentSummary}.`;
+    return {
+      content: [{ type: "text", text: fullText }],
+      structuredContent: {
+        ok: true,
+        summary: kernelSummary || summaryText,
+        data: {
+          drafts: data.drafts.length,
+          committed: data.committed.length,
+          uncommitted: data.summary.uncommitted,
+          suggestedLinks: suggestions.length,
+          knowledgeGaps: gapCount ?? 0,
+          ...coherenceVerdict ? { coherenceVerdict } : {},
+          ...persistentGaps?.length ? { persistentCoherenceGaps: persistentGaps.length } : {}
+        },
+        next,
+        _meta: kernelMeta
+      }
+    };
   };
   const tool = server.registerTool("session-wrapup", {
     title: "Session Wrapup",
@@ -10075,14 +10113,16 @@ async function handleCommitConstellation(args) {
   }
   const author = getAgentSessionId() ? `agent:${getAgentSessionId()}` : void 0;
   const sessionId = getAgentSessionId() ?? void 0;
+  let kernelEnvelope;
   let result;
   try {
-    result = await mcpMutation("chain.batchCommitConstellation", {
+    kernelEnvelope = await mcpCallEnvelope("chain.batchCommitConstellation", {
       betEntryId: betId,
       author,
       sessionId,
       operationId
     });
+    result = kernelEnvelope.data;
   } catch (err) {
     const msg = err instanceof Error ? err.message : String(err);
     return {
@@ -10168,13 +10208,16 @@ No constellation entries were committed.`
       lines.push(`- \`${f.entryId}\` ${f.name}: ${f.error}`);
     }
   }
-  const summaryText = result.proposalCreated ? `Proposal created for ${betId}. ${result.committedIds.length} entries committed.` : `Published ${result.committedIds.length} entries for ${betId}. ${result.totalRelations} connections preserved.${hasIssues ? ` ${result.failedIds.length} failed, ${result.conflictIds.length} conflicts.` : ""}`;
+  const suggestions = { contradictionWarnings, conflictPreflightSource: preflight.source };
   return {
     content: [{ type: "text", text: lines.join("\n") }],
-    structuredContent: success(
-      summaryText,
-      { ...result, contradictionWarnings, conflictPreflightSource: preflight.source }
-    )
+    structuredContent: {
+      ok: true,
+      summary: kernelEnvelope.summary,
+      data: { result, suggestions },
+      next: kernelEnvelope.next,
+      _meta: kernelEnvelope._meta
+    }
   };
 }
 
@@ -15025,7 +15068,7 @@ These are principles, standards, and rules your team has committed to the Chain.
     "## Core Product Architecture\nThe Chain is a versioned, connected, compounding knowledge base \u2014 the SSOT for a product team.\nEverything on the Chain is one of **three primitives**:\n\n- **Entry** (atom) \u2014 a discrete knowledge unit: target audience, business rule, glossary term, metric, tension. Lives in a collection.\n- **Process** (authored) \u2014 a narrative chain with named links (Strategy Coherence, IDM Proposal). Content is inline text. Collection: `chains`.\n- **Map** (composed) \u2014 a framework assembled by reference (Lean Canvas, Empathy Map). Slots point to ingredient entries. Collection: `maps`.\n\nEntries are atoms. Processes author narrative from atoms. Maps compose frameworks from atoms.\nAll three share the same versioning, branching, gating, and relation system.\n\nThe Chain compounds: each new relation makes entries discoverable from more starting points \u2192 context gathering returns richer results \u2192 AI processes have more context \u2192 quality scores improve \u2192 next commit is smarter than the last."
   );
   sections.push(
-    "## Architecture\n```\nCursor (stdio) \u2192 MCP Server (mcp-server/src/index.ts)\n  \u2192 POST /api/mcp with Bearer token\n  \u2192 Convex HTTP Action (convex/http.ts)\n  \u2192 internalQuery / internalMutation (convex/agentKnowledge/*)\n  \u2192 Convex DB (workspace-scoped)\n```\nSecurity: API key auth on every request, workspace-scoped data, internal functions blocked from external clients.\nKey files: `packages/mcp-server/src/client.ts` (HTTP client + audit), `convex/schema.ts` (schema)."
+    "## Architecture\n```\nCursor (stdio) \u2192 MCP Server (mcp-server/src/index.ts)\n  \u2192 POST /api/aki with Bearer token\n  \u2192 Convex HTTP Action (convex/http.ts)\n  \u2192 internalQuery / internalMutation (convex/agentKnowledge/*)\n  \u2192 Convex DB (workspace-scoped)\n```\nSecurity: API key auth on every request, workspace-scoped data, internal functions blocked from external clients.\nKey files: `packages/mcp-server/src/client.ts` (HTTP client + audit), `convex/schema.ts` (schema)."
   );
   if (collections) {
     const collList = collections.map((c) => {
@@ -15766,4 +15809,4 @@ export {
   SERVER_VERSION,
   createProductBrainServer
 };
-//# sourceMappingURL=chunk-EPAHRXLQ.js.map
+//# sourceMappingURL=chunk-K2GIX46U.js.map