@lambdacurry/arbor 0.21.10 → 0.21.11

package/dist/arbor.js

@@ -17207,6 +17207,17 @@ function date4(params) {
 
 // ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/classic/external.js
 config(en_default());
+// ../actions/src/external-read-defaults.ts
+var EXTERNAL_DEFAULT_PAGE_SIZE = 50;
+var EXTERNAL_DEFAULT_CONTRIB_LIMIT = 50;
+var EXTERNAL_DEFAULT_THREAD_VIEW = "compact";
+var EXTERNAL_READ_DEFAULTS_BY_OPERATION = {};
+function recordExternalReadDefaults(operation, defaults) {
+  if (!operation || !defaults)
+    return;
+  EXTERNAL_READ_DEFAULTS_BY_OPERATION[operation] = defaults;
+}
+
 // ../actions/src/output-schemas.ts
 var id = exports_external.string();
 var timestamp = exports_external.string();
@@ -18507,7 +18518,6 @@ var MCP_OUTPUT_SCHEMAS = {
 function outputSchemaFor(actionName) {
   return MCP_OUTPUT_SCHEMAS[actionName];
 }
-
 // ../actions/src/output-shaping.ts
 function record2(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value) ? value : null;
@@ -18935,7 +18945,15 @@ function isProseList(schema) {
   return PROSE_LISTS.has(schema);
 }
 function forward(operation) {
-  return (ex, input) => ex.call(operation, input);
+  const run = (ex, input) => ex.call(operation, input);
+  run.operation = operation;
+  return run;
+}
+function forwardedOperation(run) {
+  if (!("operation" in run))
+    return;
+  const value = run.operation;
+  return typeof value === "string" ? value : undefined;
 }
 function dispatch(map2, reshape) {
   return (ex, input) => {
@@ -18991,8 +19009,9 @@ function runAdminFeedback(ex, input) {
 }
 var NOTIFICATION_TRIAGE_DESCRIPTION = "READ ONLY: List your awareness feed newest first with unseen count and derived triage class: `settled-context` = settled Thread context; `owed-by-me` = an open request pointing to `inbox`; `judgment-available` = live engagement inviting judgment; `closed-loop` = your request completed; `room-motion` = ambient activity. Notifications are FYI, not a second obligation surface: `inbox` alone contains work owed by you; this cannot mark notifications read or modify inbox obligations.";
 var PAGINATION_INPUT = {
-  limit: exports_external.number().int().min(1).optional().describe("max items to return — enables pagination"),
-  cursor: exports_external.string().optional().describe("opaque cursor from a prior response's nextCursor (use with --limit)")
+  limit: exports_external.number().int().min(1).optional().describe(`max items to return. MCP/CLI/API default to ${EXTERNAL_DEFAULT_PAGE_SIZE} and return nextCursor when more remain; pass all=true/--all for the complete list. In-process web omit is still a compatibility full read`),
+  cursor: exports_external.string().optional().describe("opaque cursor from a prior response's nextCursor (use with --limit)"),
+  all: exports_external.boolean().optional().describe("explicit complete retrieval — skip the bounded default page. Prefer limit+cursor unless you need the whole collection")
 };
 var LIVE_PREVIEW_CONFIG_INPUT = {
   livePreview: exports_external.object({
@@ -20216,14 +20235,19 @@ var ACTION_DEFINITIONS = [
   {
     name: "thread_get",
     title: "Read a thread",
-    description: "READ ONLY: Read one Thread; full view returns transcript, requests, and artifacts, while compact returns bounded decision-ready context with distillate/recent items and supports cursored unchanged checks. Read it before contributing so you can answer open requests correctly; use contribution pagination only for full history.",
+    description: "READ ONLY: Read one Thread as compact current context (distillate, requests, artifacts, recent tail, cursored unchanged checks) — not the durable transcript; pass view=full to page history (contribLimit default 50) or all=true for the complete transcript. Read it before contributing so you can answer open requests correctly.",
     inputSchema: {
       threadId: exports_external.string().describe("the thread id, e.g. thr_…"),
-      view: exports_external.enum(["full", "compact"]).optional().describe("full (default) = complete transcript; compact = bounded decision-ready context packet for recurring checks"),
+      view: exports_external.enum(["full", "compact"]).optional().describe("MCP/CLI/API default compact = bounded decision-ready context; full = transcript page"),
       cursor: exports_external.string().optional().describe("compact reads only: cursor from the previous compact response; if context is unchanged the response collapses to a tiny unchanged envelope"),
       recentLimit: exports_external.number().int().min(1).max(20).optional().describe("compact reads only: latest contributions to include (default 6, max 20)"),
-      contribLimit: exports_external.number().int().positive().optional().describe("full reads only: max contributions to return (AD-151 keyset paging) — omit to load the whole thread"),
-      contribCursor: exports_external.string().optional().describe("full reads only: continuation cursor from a previous page's contributionPage.nextCursor")
+      contribLimit: exports_external.number().int().positive().optional().describe(`full reads only: max contributions to return (AD-151 keyset paging). MCP/CLI/API default to ${EXTERNAL_DEFAULT_CONTRIB_LIMIT}; pass all=true for the whole thread`),
+      contribCursor: exports_external.string().optional().describe("full reads only: continuation cursor from a previous page's contributionPage.nextCursor"),
+      all: exports_external.boolean().optional().describe("explicit complete transcript on view=full — skip the bounded contribLimit. Prefer contribLimit+contribCursor unless you need every contribution")
+    },
+    externalReadDefaults: {
+      view: EXTERNAL_DEFAULT_THREAD_VIEW,
+      contribLimit: EXTERNAL_DEFAULT_CONTRIB_LIMIT
     },
     surfaces: ["mcp", "cli"],
     toolset: "loop",
@@ -21333,15 +21357,17 @@ var ACTIONS = ACTION_DEFINITIONS.map((action) => {
   if (action.requiresCapability && !action.surfaces.includes("mcp")) {
     throw new Error(`${action.name}: requiresCapability is an MCP catalog gate`);
   }
+  const externalReadDefaults = action.inputSchema.limit === PAGINATION_INPUT.limit ? { ...action.externalReadDefaults, limit: EXTERNAL_DEFAULT_PAGE_SIZE } : action.externalReadDefaults;
+  recordExternalReadDefaults(forwardedOperation(action.run), externalReadDefaults);
   if (!action.surfaces.some((surface) => surface === "mcp" || surface === "computer-mcp")) {
-    return action;
+    return externalReadDefaults ? { ...action, externalReadDefaults } : action;
   }
   const outputSchema = outputSchemaFor(action.name);
   if (!outputSchema)
     throw new Error(`${action.name}: MCP action is missing an output schema`);
   const annotations = mcpAnnotationsFor(action.name);
   const description = annotations.readOnlyHint && !action.description.startsWith("READ ONLY") ? `READ ONLY: ${action.description}` : action.description;
-  return { ...action, description, outputSchema, annotations };
+  return { ...action, externalReadDefaults, description, outputSchema, annotations };
 });
 
 // src/config.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lambdacurry/arbor",
-  "version": "0.21.10",
+  "version": "0.21.11",
   "description": "The Arbor CLI — a shared workspace for people and agents. The human + headless-agent write path over Arbor's guarded operation surface.",
   "keywords": [
     "agents",