@productbrain/mcp 0.0.1-beta.197 → 0.0.1-beta.199

package/dist/{chunk-EL6FYD2Q.js → chunk-4J2IMFS7.js}

@@ -13479,7 +13479,10 @@ var VALID_TASK_DOMAINS = [
   "general"
 ];
 var orientSchema = z22.object({
-  mode: z22.enum(["full", "brief"]).optional().default("full").describe("full = full context (default). brief = compact summary for mid-session re-orientation."),
+  mode: z22.enum(["full", "brief"]).optional().default("full").describe("full = full context (default). brief = compact summary for mid-session re-orientation. Prefer using the `tier` param for depth control."),
+  tier: z22.enum(["summary", "standard", "full"]).optional().describe(
+    "Payload depth. summary = ~10 KB compact. standard = ~256 KB default. full = complete payload (large). Defaults to standard."
+  ),
   task: z22.string().optional().describe("Natural-language task description for task-scoped context. When provided, orient returns scored, relevant entries for the task."),
   scope: z22.enum(VALID_TASK_DOMAINS).optional().describe(`Optional domain scope to filter governance to entries relevant for this domain. Valid values: ${VALID_TASK_DOMAINS.join(", ")}.`)
 });
@@ -13507,12 +13510,13 @@ function registerOrientTool(server) {
     "orient",
     {
       title: "Orient \u2014 Start Here",
-      description: "The single entry point for starting a session. Returns workspace context with a single recommended next action for low-readiness workspaces, or a standup-style briefing for established workspaces.\n\nUse this FIRST. One call to orient replaces 3\u20135 individual tool calls.\n\nCompleting orientation unlocks write tools for the active session.\n\n**mode:** `full` (default) returns full context. `brief` returns only vision, bet/tension counts, readiness, active bet names, and last-session summary \u2014 use for mid-session re-orientation.\n\n**task:** Optional natural-language task description. When provided, returns task-scoped context (scored, relevant entries) in addition to standard orient sections.\n\n**scope:** Optional domain scope. Filters governance entries to those relevant for the specified domain. Authority roots include strategy, product, product-design, engineering, architecture, data, governance, and go-to-market. Child scopes such as product-design/ux, engineering/frontend, data/analytics, and governance/principles are accepted. Legacy internal scopes remain accepted.",
+      description: "The single entry point for starting a session. Returns workspace context with a single recommended next action for low-readiness workspaces, or a standup-style briefing for established workspaces.\n\nUse this FIRST. One call to orient replaces 3\u20135 individual tool calls.\n\nCompleting orientation unlocks write tools for the active session.\n\n**tier:** Controls payload depth. `standard` (default, ~256 KB) is the recommended default. `summary` (~10 KB) for quick mid-session re-orientation. `full` for complete payload when deep context is needed.\n\n**mode:** `full` (default) returns full context. `brief` returns compact summary \u2014 mapped to tier=summary internally. Prefer `tier` for explicit depth control.\n\n**task:** Optional natural-language task description. When provided, returns task-scoped context (scored, relevant entries) in addition to standard orient sections.\n\n**scope:** Optional domain scope. Filters governance entries to those relevant for the specified domain. Authority roots include strategy, product, product-design, engineering, architecture, data, governance, and go-to-market. Child scopes such as product-design/ux, engineering/frontend, data/analytics, and governance/principles are accepted. Legacy internal scopes remain accepted.",
       inputSchema: orientSchema,
       annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false }
     },
-    thinWrapper(async ({ mode = "full", task, scope }) => {
+    thinWrapper(async ({ mode = "full", tier, task, scope }) => {
       const errors = [];
+      const effectiveTier = tier ?? (mode === "brief" ? "summary" : "standard");
       if (scope && !task) {
         errors.push("--scope requires --task to filter governance. Scope was ignored.");
       }
@@ -13559,6 +13563,7 @@ function registerOrientTool(server) {
         if (scope) orientArgs.scope = scope;
         if (sessionEntryIds.length > 0) orientArgs.sessionEntryIds = sessionEntryIds;
         if (lastSessionOnly.length > 0) orientArgs.lastSessionEntryIds = lastSessionOnly;
+        orientArgs.tier = effectiveTier;
         orientEntries = await kernelQuery("chain.getOrientEntries", orientArgs);
       } catch {
       }
@@ -13761,6 +13766,16 @@ function registerOrientTool(server) {
           lines.push("---");
           lines.push("_No active agent session. Call `session action=start` to begin._");
         }
+        const briefTruncated = orientEntries?._budget?.truncated ?? orientEntries?._truncated ?? false;
+        if (briefTruncated) {
+          const reasons = orientEntries?._budget?.truncationReasons;
+          lines.push("");
+          if (reasons && reasons.length > 0) {
+            lines.push(`_Context truncated to fit tier budget: ${reasons.join(", ")}. Use tier=full for complete payload._`);
+          } else {
+            lines.push("_Context truncated to fit tier budget. Use tier=full for complete payload._");
+          }
+        }
         if (errors.length > 0) {
           lines.push("");
           for (const err of errors) lines.push(`- ${err}`);
@@ -13781,7 +13796,7 @@ function registerOrientTool(server) {
             }
           )
         };
-        reportOrientWrapperBytes(briefResult, orientEntries?._truncated === true);
+        reportOrientWrapperBytes(briefResult, briefTruncated);
         return briefResult;
       }
       const orientStage = readiness?.stage ?? "seeded";
@@ -14150,6 +14165,16 @@ function registerOrientTool(server) {
         lines.push("---");
         lines.push("_No active agent session. Call `session action=start` to begin a tracked session._");
       }
+      const fullTruncated = orientEntries?._budget?.truncated ?? orientEntries?._truncated ?? false;
+      if (fullTruncated) {
+        const reasons = orientEntries?._budget?.truncationReasons;
+        lines.push("");
+        if (reasons && reasons.length > 0) {
+          lines.push(`_Context truncated to fit tier budget: ${reasons.join(", ")}. Use tier=full for complete payload._`);
+        } else {
+          lines.push("_Context truncated to fit tier budget. Use tier=full for complete payload._");
+        }
+      }
       const fullResult = {
         content: [{ type: "text", text: lines.join("\n") }],
         structuredContent: success(
@@ -14167,7 +14192,7 @@ function registerOrientTool(server) {
           }
         )
       };
-      reportOrientWrapperBytes(fullResult, orientEntries?._truncated === true);
+      reportOrientWrapperBytes(fullResult, fullTruncated);
       return fullResult;
     })
   );
@@ -15919,4 +15944,4 @@ export {
   createProductBrainServer,
   initFeatureFlags
 };
-//# sourceMappingURL=chunk-EL6FYD2Q.js.map
+//# sourceMappingURL=chunk-4J2IMFS7.js.map