@lambdacurry/arbor 0.22.37 → 0.22.38

package/dist/arbor.js

@@ -2,7 +2,7 @@
 // package.json
 var package_default = {
   name: "@lambdacurry/arbor",
-  version: "0.22.37",
+  version: "0.22.38",
   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",
@@ -8900,6 +8900,22 @@ var MCP_OUTPUT_SCHEMAS = {
     lineCount: number2().int().nonnegative(),
     byteLength: number2().int().nonnegative(),
     outline: array(object({ title: string2(), startLine: number2().int().min(1) })),
+    sourceMetrics: _enum(["not-loaded-file", "file-text-projection"]).optional(),
+    file: object({
+      mimeType: string2().nullable(),
+      editableSource: literal(false),
+      textProjection: object({
+        status: _enum(["available", "probe", "unavailable"]),
+        reason: _enum([
+          "trusted-text-mime",
+          "unknown-mime",
+          "validated-utf8",
+          "unsupported-mime",
+          "not-stored-blob"
+        ]),
+        nextAction: string2()
+      })
+    }).optional(),
     source: string2().optional(),
     startLine: number2().int().min(0).optional(),
     endLine: number2().int().min(0).optional(),
@@ -10337,9 +10353,9 @@ var ARTIFACT_GET_INPUT = {
   startLine: number2().int().min(1).optional().describe("1-indexed source window start; omit with heading for a section window"),
   limit: number2().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: string2().min(1).optional().describe("first ##/### title that matches exactly, else the first prefix match"),
-  all: boolean2().optional().describe("explicit complete source. Cannot combine with startLine, heading, or limit; prefer a window unless you need every line")
+  all: boolean2().optional().describe("explicit complete editable source. File Artifacts stay bounded and require startLine + limit. Cannot combine with startLine, heading, or limit")
 };
-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 ARTIFACT_GET_DESCRIPTION = `Read an Artifact as a compact card without loading its body. Editable text Artifacts report source line/byte counts and ##/### outline; use startLine+limit (default ${ARTIFACT_SOURCE_WINDOW_DEFAULT}, max ${ARTIFACT_SOURCE_WINDOW_MAX}), heading, or explicit all=true/--all. File Artifacts remain files and non-editable: their card reports stored MIME, whether bounded UTF-8 text projection is available/probeable, and the next action. For text-like files use startLine+limit and continue with nextLine; all=true and heading stay unavailable for files. Binary/unsupported files remain valid and should be inspected through the Artifact URL/download/media surface. Pass version only for editable historical snapshots; this read cannot edit content, bind a surface, change lifecycle, or delete.`;
 var PAGINATION_INPUT = {
   limit: number2().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: string2().optional().describe("opaque cursor from a prior response's nextCursor (use with --limit)"),
@@ -13009,6 +13025,7 @@ var ACTIONS = ACTION_DEFINITIONS.map((action) => {
 var historyPolicySchema = _enum(["full", "checkpoint"]).optional().describe("text Artifacts: future history retention policy; full retains every source snapshot, checkpoint keeps metadata for every revision and source only when explicitly retained");
 var retainSourceSchema = boolean2().optional().describe("edit: in checkpoint mode, retain this newly minted content revision's source");
 var checkpointSchema = boolean2().optional().describe("edit: retain the exact current version source without incrementing content version");
+var ARTIFACT_GET_PUBLIC_DESCRIPTION = "Read one Artifact as a compact card without loading its body; editable text supports its outline plus bounded startLine+limit or heading windows and explicit all=true; File Artifacts remain files and report whether bounded UTF-8 text projection is available. For text-like files use startLine+limit and nextLine; all=true and heading stay unavailable for files, binary/unsupported files use the Artifact URL/download/media surface, and editable historical reads retain exact artifactVersionId.";
 function artifactEditInput(input) {
   const patches = Array.isArray(input.patches);
   const hasSource = typeof input.source === "string";
@@ -13061,11 +13078,8 @@ function retentionAction(action) {
       run: (ex, input) => ex.call("artifact.edit", artifactEditInput(input))
     };
   }
-  if (action.name === "artifact_get") {
-    return {
-      ...action,
-      description: "Read one Artifact. Text responses project artifactVersionId for the exact version represented by the response, including --version historical reads, so the returned artv_ can be passed directly to computer_publish_app_bundle."
-    };
+  if (action.name === "get_artifact" || action.name === "artifact_get") {
+    return { ...action, description: ARTIFACT_GET_PUBLIC_DESCRIPTION };
   }
   if (action.name === "artifact") {
     return {

package/package.json

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