@lambdacurry/arbor 0.22.36 → 0.22.38

package/dist/arbor.js

@@ -2,7 +2,7 @@
 // package.json
 var package_default = {
   name: "@lambdacurry/arbor",
-  version: "0.22.36",
+  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",
@@ -4933,6 +4933,41 @@ var CONTRIBUTION_TYPES = [
   "decision"
 ];
 var STAMP_FACETS = ["quality", "impact", "fit", "originality"];
+var ARTIFACT_TYPES = [
+  "markdown",
+  "concept",
+  "decision",
+  "research-brief",
+  "summary",
+  "plan",
+  "json",
+  "yaml",
+  "schema",
+  "table",
+  "rubric",
+  "profile-snapshot",
+  "image",
+  "diagram",
+  "mockup",
+  "canvas",
+  "html-bundle",
+  "dashboard",
+  "prototype",
+  "audio",
+  "video",
+  "transcript",
+  "diff",
+  "pr-reference",
+  "script",
+  "api-spec",
+  "test-plan",
+  "prompt",
+  "tool-spec",
+  "workflow",
+  "routing-rule",
+  "eval-rubric",
+  "external-reference"
+];
 // ../core/src/feedback/constants.ts
 var ARBOR_FEEDBACK_TYPES = [
   "comment",
@@ -8865,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(),
@@ -10162,6 +10213,7 @@ var TLDRAW_EXEC_OPERATIONS_SCHEMA = array(TLDRAW_EXEC_OPERATION_SCHEMA).min(1).m
   });
 }).describe("preferred declarative edits, applied in order; mutually exclusive with code");
 // ../actions/src/index.ts
+var ARTIFACT_TYPE_DESCRIPTION = `semantic type (one of: ${ARTIFACT_TYPES.join(", ")})`;
 var ARBOR_FEEDBACK_INPUT_TYPES = [...ARBOR_FEEDBACK_TYPES, "friction"];
 var CONTRIBUTION_ADD_LINK_RELS = [
   "cites",
@@ -10301,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)"),
@@ -11318,7 +11370,7 @@ var ACTION_DEFINITIONS = [
     title: "Create an artifact",
     description: "Promote durable output — a decision, summary, plan, or research brief — into a first-class artifact you own. Give it a concise summary of what the Artifact is or accomplishes; this is the skim and retrieval description, not a repeat of its title. Text kinds (doc/table/diagram/html) are living documents: pass `source` (born at v1, editable in place via edit_artifact); kind=file passes a contentRef instead. The artifact is AUTOMATICALLY listed on its source thread (no link post needed). When it came from a Thread Computer, pass its producing computerSessionId when available so the artifact cites the reproducible session. Reach for this when a thread has produced something worth retaining and citing beyond the conversation — especially a table or doc the team will UPDATE, which beats pasting it into a prose contribution.",
     inputSchema: {
-      type: string2().describe("semantic type, e.g. decision|summary|plan|markdown|table|research-brief"),
+      type: _enum(ARTIFACT_TYPES).describe(ARTIFACT_TYPE_DESCRIPTION),
       kind: _enum(["doc", "table", "diagram", "html", "file"]).optional().describe("structural kind (default file). doc/table/diagram/html are editable, versioned text"),
       title: string2().min(1),
       source: string2().optional().describe("text kinds: the initial content (v1)"),
@@ -12271,7 +12323,7 @@ var ACTION_DEFINITIONS = [
       verb: _enum(["create", "edit", "set_live_preview", "set_snapshot", "promote_attachment"]).describe("which artifact move"),
       title: string2().optional().describe("create: the artifact's title"),
       kind: _enum(["doc", "table", "diagram", "html", "file"]).optional().describe("create: structural kind (default file). doc/table/diagram/html are editable text"),
-      type: string2().optional().describe("create: semantic type, e.g. decision|summary|plan|markdown|table|research-brief"),
+      type: _enum(ARTIFACT_TYPES).optional().describe(`create: ${ARTIFACT_TYPE_DESCRIPTION}`),
       source: string2().optional().describe("create (text kinds): the initial content · edit verb=replace: the full new content"),
       contentRef: string2().optional().describe("create (kind=file): where the content lives, e.g. inline://… or a URL"),
       editPolicy: _enum(["owner", "members", "anyone"]).optional().describe("create: who may edit (default members)"),
@@ -12973,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";
@@ -13025,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.36",
+  "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",