@lambdacurry/arbor 0.21.12 → 0.21.14

package/dist/arbor.js

@@ -17211,6 +17211,9 @@ config(en_default());
 var EXTERNAL_DEFAULT_PAGE_SIZE = 50;
 var EXTERNAL_DEFAULT_CONTRIB_LIMIT = 50;
 var EXTERNAL_DEFAULT_THREAD_VIEW = "compact";
+var EXTERNAL_DEFAULT_ARTIFACT_VIEW = "card";
+var ARTIFACT_SOURCE_WINDOW_DEFAULT = 80;
+var ARTIFACT_SOURCE_WINDOW_MAX = 200;
 var EXTERNAL_READ_DEFAULTS_BY_OPERATION = {};
 function recordExternalReadDefaults(operation, defaults) {
   if (!operation || !defaults)
@@ -18020,6 +18023,8 @@ var MCP_OUTPUT_SCHEMAS = {
     space: space3,
     topics: exports_external.array(topic2).optional(),
     members: exports_external.array(member).optional(),
+    total: exports_external.number().int().min(0),
+    nextCursor: exports_external.string().optional(),
     computerConfig: resolvedComputerConfig.nullable().optional()
   }),
   topic_get: exports_external.looseObject({
@@ -18027,6 +18032,8 @@ var MCP_OUTPUT_SCHEMAS = {
     space: space3,
     threads: exports_external.array(thread3).optional(),
     promotedArtifacts: exports_external.array(artifact4).optional(),
+    total: exports_external.number().int().min(0),
+    nextCursor: exports_external.string().optional(),
     computerConfig: resolvedComputerConfig.nullable().optional()
   }),
   goal: exports_external.looseObject({
@@ -18122,21 +18129,19 @@ var MCP_OUTPUT_SCHEMAS = {
     threadId: id.nullable().optional(),
     changed: exports_external.boolean().optional()
   }),
-  artifact_get: exports_external.looseObject({
+  artifact_get: exports_external.object({
     id,
     title: exports_external.string(),
     kind: exports_external.string(),
-    status: exports_external.string(),
-    content: jsonObject,
-    version: exports_external.number().optional(),
-    versions: exports_external.array(jsonObject).optional(),
-    appBundles: exports_external.array(jsonObject),
-    usedByApps: exports_external.array(jsonObject),
-    livePreview: artifactLivePreview.nullable(),
-    snapshot: jsonObject.nullable().optional(),
-    sourceLivePreview: jsonObject.nullable().optional(),
-    watching: exports_external.boolean(),
-    url: exports_external.string()
+    version: exports_external.number().int().nonnegative(),
+    lineCount: exports_external.number().int().nonnegative(),
+    byteLength: exports_external.number().int().nonnegative(),
+    outline: exports_external.array(exports_external.object({ title: exports_external.string(), startLine: exports_external.number().int().min(1) })),
+    source: exports_external.string().optional(),
+    startLine: exports_external.number().int().min(0).optional(),
+    endLine: exports_external.number().int().min(0).optional(),
+    nextLine: exports_external.number().int().min(1).nullable().optional(),
+    totalLines: exports_external.number().int().nonnegative().optional()
   }),
   artifact_transition: exports_external.looseObject({
     artifactId: id,
@@ -19008,6 +19013,15 @@ function runAdminFeedback(ex, input) {
   return Promise.reject(new Error(`unknown verb "${verb ?? ""}" — expected one of: ${ADMIN_FEEDBACK_VERB_HELP}`));
 }
 var NOTIFICATION_TRIAGE_DESCRIPTION = "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 ARTIFACT_GET_INPUT = {
+  artifactId: exports_external.string().describe("the Artifact, art_…"),
+  version: exports_external.number().int().min(1).optional().describe("read this old snapshot instead of the current"),
+  startLine: exports_external.number().int().min(1).optional().describe("1-indexed source window start; omit with heading for a section window"),
+  limit: exports_external.number().int().min(1).max(ARTIFACT_SOURCE_WINDOW_MAX).optional().describe(`source window size when startLine or heading is set (default ${ARTIFACT_SOURCE_WINDOW_DEFAULT}, max ${ARTIFACT_SOURCE_WINDOW_MAX}). This is not a list page size`),
+  heading: exports_external.string().min(1).optional().describe("first ##/### title that matches exactly, else the first prefix match"),
+  all: exports_external.boolean().optional().describe("explicit complete source. Cannot combine with startLine, heading, or limit; prefer a window unless you need every line")
+};
+var ARTIFACT_GET_DESCRIPTION = `Read an Artifact as a compact card (id, title, kind, version, lineCount, byteLength, ##/### outline with startLine) so a plan can be oriented without loading source; pass startLine+limit (default ${ARTIFACT_SOURCE_WINDOW_DEFAULT}, max ${ARTIFACT_SOURCE_WINDOW_MAX}) or heading (first ##/### exact or prefix) for a source window, or all=true/--all for the full source. Pass version for an older snapshot; this read cannot edit content, bind a surface, change lifecycle, or delete.`;
 var PAGINATION_INPUT = {
   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)"),
@@ -19951,11 +19965,9 @@ var ACTION_DEFINITIONS = [
   {
     name: "get_artifact",
     title: "Read an artifact",
-    description: "Read an Artifact's current source/version/history plus its current executable Live Preview surface when bound. READ BEFORE YOU EDIT — the version number you read is the baseVersion your edit must name. Surface binding is current Artifact identity metadata and remains current even when --version reads old content.",
-    inputSchema: {
-      artifactId: exports_external.string().describe("the artifact, art_…"),
-      version: exports_external.number().optional().describe("read this old snapshot instead of the current")
-    },
+    description: ARTIFACT_GET_DESCRIPTION,
+    inputSchema: ARTIFACT_GET_INPUT,
+    externalReadDefaults: { view: EXTERNAL_DEFAULT_ARTIFACT_VIEW },
     surfaces: ["cli"],
     toolset: "artifacts",
     run: forward("artifact.get")
@@ -20536,9 +20548,10 @@ var ACTION_DEFINITIONS = [
   {
     name: "space_get",
     title: "Read a space",
-    description: "Read a Space's durable context: purpose, guidance, contribution lanes, Topics, and full member roster with roles, capabilities, and charters. Use it after tree when you need the room's full norms or collaborator context; it cannot modify membership or guidance.",
+    description: "Read a Space's durable context—purpose, guidance, contribution lanes, Topics—and a paged member roster with roles, capabilities, and charters (default 50; `total` is the full roster size). Continue with `cursor`, or use `all=true` / `--all` only when you need every member; it cannot modify membership or guidance.",
     inputSchema: {
-      spaceId: exports_external.string().min(1).describe("the space id")
+      spaceId: exports_external.string().min(1).describe("the space id"),
+      ...PAGINATION_INPUT
     },
     surfaces: ["mcp", "cli"],
     toolset: "loop",
@@ -20547,9 +20560,10 @@ var ACTION_DEFINITIONS = [
   {
     name: "topic_get",
     title: "Read a topic",
-    description: "Read a Topic's full details, guidance, complete Thread roster, open requests, and promoted artifacts. Use it for intentional Topic-wide context or enumeration; for a concrete question in a large Topic, prefer Topic-scoped recall first.",
+    description: "Read a Topic's durable context, guidance, open requests, promoted artifacts, and a paged Thread roster (default 50; `total` is the full roster size). Continue with `cursor`, or use `all=true` / `--all` only for intentional complete enumeration; for a concrete question in a large Topic, prefer Topic-scoped `recall`.",
     inputSchema: {
-      topicId: exports_external.string().min(1).describe("the topic id")
+      topicId: exports_external.string().min(1).describe("the topic id"),
+      ...PAGINATION_INPUT
     },
     surfaces: ["mcp", "cli"],
     toolset: "loop",
@@ -20858,11 +20872,9 @@ var ACTION_DEFINITIONS = [
   {
     name: "artifact_get",
     title: "Read an Artifact",
-    description: "Read an Artifact's current source, version, immutable history, AppBundle references, and current executable Live Preview surface, or pass version for an older content snapshot. Computer-file Artifacts return snapshot state from set_snapshot (null until set_snapshot, meaning the asleep face is not checkable); this read cannot edit content, bind a surface, change lifecycle, promote an attachment, or delete an Artifact.",
-    inputSchema: {
-      artifactId: exports_external.string().describe("the Artifact, art_…"),
-      version: exports_external.number().optional().describe("read this old snapshot instead of the current")
-    },
+    description: ARTIFACT_GET_DESCRIPTION,
+    inputSchema: ARTIFACT_GET_INPUT,
+    externalReadDefaults: { view: EXTERNAL_DEFAULT_ARTIFACT_VIEW },
     surfaces: ["mcp"],
     toolset: "artifacts",
     run: forward("artifact.get")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lambdacurry/arbor",
-  "version": "0.21.12",
+  "version": "0.21.14",
   "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",