@lambdacurry/arbor 0.21.25 → 0.21.27

package/dist/arbor.js

@@ -17403,7 +17403,7 @@ var computerRunPublication = exports_external.looseObject({
   remoteRef: exports_external.string().optional()
 });
 var computerRunRuntime = exports_external.looseObject({
-  state: exports_external.enum(["shared", "live", "suspended", "released"]),
+  state: exports_external.enum(["shared", "live", "suspended", "releasing", "released"]),
   currentSnapshotId: id.nullable(),
   updatedAt: exports_external.string().nullable()
 });
@@ -19052,7 +19052,7 @@ ${ARBOR_FEEDBACK_GUIDANCE}
 
 1. ORIENT, CONFIGURE, AND AUTHORIZE. Start with get_computer(threadId) to inspect the effective inherited recipe, repository authorization, compatibility, and durable lineage. Use set_organization_computer, set_space_computer, set_topic_computer, or set_thread_computer only when the corresponding complete sparse layer must be replaced; use github_repositories then github_connect_repository to authorize repositories at the narrowest scope that should inherit them. If github_repositories looks stale, github_refresh_installation reconciles the cached inventory from GitHub. attach_computer mints durable protocol identity without starting a runtime; computer_open attaches as needed and starts or resumes the project environment. Each returned repository entry includes verified root instruction pointers when that repo has an AGENTS.md: read surfaced repository instructions before substantial edits or verification, then check for a nearer nested AGENTS.md once the target path is known. Repo-local instructions/scripts/config beat guessed formatter, test, lint, or build commands.
 2. READ THE CAPABILITIES CARD, NOT THE BACKEND. computer_open and computer_status describe the live PARENT Thread Computer and return the exact computerSessionId for parent filesystem, command, checkpoint, Preview, bundle, and stop operations. computer_status does not establish isolated Run activity; use computer_run_receipt(runId) and computer_process_read for Run-owned work. Command-line utilities, including Git and package managers, run through computer_exec; check unfamiliar binaries with command -v.
-3. ONE RUN PER TASK. A write Run defaults to an isolated execution environment with its own filesystem, processes, ports, and /tmp while preserving /workspace paths; a read Run shares the parent. Pass runId to Run-aware tools. If a response is lost, recover the durable operation/process identity from computer_run_receipt and read it before retrying. Once every operation is settled, computer_run_suspend publishes the exact workspace and releases the provider during an external wait; the next Run-aware operation restores that checkpoint under the same runId automatically. Suspension refuses active processes or unsettled outcomes and never replays unknown work, so reconcile process and Git/publication evidence first. An isolated local commit or Preview is not Git publication; push coherent work and prove it with computer_repo_work_status before computer_run_finish destroys the final placement. discard=true is the explicit choice to destroy proven non-durable work.
+3. ONE RUN PER TASK. A write Run defaults to an isolated execution environment with its own filesystem, processes, ports, and /tmp while preserving /workspace paths; a read Run shares the parent. Pass runId to Run-aware tools. If a response is lost, recover the durable operation/process identity from computer_run_receipt and read it before retrying. Once every operation is settled, computer_run_suspend publishes the exact workspace and releases the provider during an external wait; the next Run-aware operation restores that checkpoint under the same runId automatically. Suspension refuses active processes or unsettled outcomes and never replays unknown work, so reconcile process and Git/publication evidence first. An isolated local commit or Preview is not Git publication; push coherent work and prove it with computer_repo_work_status before computer_run_finish destroys the final placement. discard=true with outcome failed or cancelled is the explicit choice to abandon unknown or proven non-durable work without replaying it.
 4. CHECKPOINT COMPLETE PARENT UNITS. computer_checkpoint advances immutable parent lineage after an intermediate complete unit; computer_stop performs the final checkpoint before teardown. An isolated Run Preview is durable review output, not adoption or a checkpoint. The internal provider-handle publication operations are not agent tools.
 5. GIT AND GITHUB ARE ORDINARY COMMANDS AFTER AUTHORIZATION. Clone, fetch, pull, push, and gh run through computer_exec using a connected human's just-in-time ambient GitHub identity. Credentials never enter argv, workspace files, Git config, checkpoints, Events, logs, or receipts. A restored Computer deliberately keeps the checkout age of its snapshot, so fetch/pull before trusting remote state.
 6. VERIFY, PREVIEW, AND EXPORT. computer_verify captures a public URL directly without opening a project runtime. computer_publish_preview preserves immutable static output from either the parent or an active isolated write Run. computer_export moves bounded files into durable Thread Attachments; for a computer:// file Artifact asleep face, export the exact locator path .tldr and a same-Thread PNG, then use artifact set_snapshot. computer_export itself does not call set_snapshot; place returned Markdown exactly where the media belongs and cite the matching attachment ids.
@@ -19768,12 +19768,12 @@ var ACTION_DEFINITIONS = [
   {
     name: "computer_run_finish",
     title: "Finish a run",
-    description: "Finish a Run with an explicit terminal outcome after its work is complete or intentionally abandoned. Ordinary finish succeeds unless Arbor proves isolated WRITE work non-durable; use discard=true only to intentionally destroy that proven non-durable work; publication can remain unknown, repeating the same outcome is a safe no-op, and the receipt preserves the durability assessment.",
+    description: "Finish a Run with an explicit terminal outcome; ordinary finish refuses unsettled operations and proven non-durable isolated WRITE work. To abandon an unknown or non-durable disposable Run without replaying it, pass discard=true with outcome failed or cancelled; the receipt preserves unknown operation and durability evidence, and repeating the same outcome is a safe no-op.",
     inputSchema: {
       runId: exports_external.string().describe("the runId returned by computer_run_start, run_…"),
       outcome: exports_external.enum(["finished", "failed", "cancelled"]).optional().describe("terminal outcome; defaults to finished"),
       reason: exports_external.string().max(500).optional().describe("one factual line on how this unit of work ended, e.g. what shipped or what broke"),
-      discard: exports_external.boolean().optional().describe("explicitly allow teardown when Arbor proved current Run work is not durable")
+      discard: exports_external.boolean().optional().describe("explicitly abandon unknown or proven non-durable Run work; unsettled operations also require outcome failed or cancelled")
     },
     surfaces: ["computer-mcp", "computer-cli"],
     toolset: "loop",
@@ -20281,6 +20281,7 @@ var ACTION_DEFINITIONS = [
       requestId: exports_external.string().describe("the request id, req_…"),
       type: exports_external.enum(CONTRIBUTION_TYPES).describe("the contribution type"),
       body: exports_external.string().min(1).describe("your response"),
+      summary: exports_external.string().max(500).optional().describe("optional gist, 1-2 short sentences (HARD LIMIT 500 characters)"),
       confidence: exports_external.number().int().min(0).max(100).optional(),
       computerSessionId: exports_external.string().optional().describe("computer receipt to cite when the response came from computer work, cms_…"),
       attachmentIds: exports_external.array(exports_external.string()).max(10).optional().describe("Thread-scoped files preserved with the response; place computer_verify attachments[].markdown in the body for exact inline image placement")
@@ -22208,11 +22209,29 @@ var COMMAND_WORD_OVERRIDES = {
   feedback_thread_get: "feedback thread",
   feedback_status: "feedback status"
 };
+var MCP_COMMAND_ALIASES = {
+  artifact_get: "get_artifact",
+  artifact_transition: "transition_artifact",
+  goal_delete: "delete_goal",
+  goal_get: "get_goal",
+  goal_list: "list_goals",
+  notification_list: "notifications",
+  space_invitation_list: "my_space_invites",
+  space_leave: "leave_space",
+  space_list_open: "list_open_spaces",
+  watch_list: "watches"
+};
 function commandWords(action) {
   return COMMAND_WORD_OVERRIDES[action.name] ?? action.name.replace(/_/g, " ");
 }
 var CLI_ACTIONS = ACTIONS.filter((a) => a.surfaces.includes("cli") || a.surfaces.includes("computer-cli"));
+var BY_ACTION_NAME = new Map(CLI_ACTIONS.map((action) => [action.name, action]));
 var BY_COMMAND = new Map(CLI_ACTIONS.map((a) => [commandWords(a), a]));
+for (const [alias2, actionName] of Object.entries(MCP_COMMAND_ALIASES)) {
+  const action = BY_ACTION_NAME.get(actionName);
+  if (action)
+    BY_COMMAND.set(alias2, action);
+}
 var MAX_WORDS = Math.max(1, ...CLI_ACTIONS.map((a) => commandWords(a).split(" ").length));
 var POSITIONAL_FIELDS = {
   contribute_arbor_feedback: ["body"],
@@ -22296,8 +22315,11 @@ function matchCommand(positionals) {
   }
   return;
 }
-function toolNameAlias(action) {
-  return action.name.includes("_") ? action.name : "";
+function toolNameAliases(action) {
+  return [
+    ...action.name.includes("_") ? [action.name] : [],
+    ...Object.entries(MCP_COMMAND_ALIASES).filter(([, actionName]) => actionName === action.name).map(([alias2]) => alias2)
+  ];
 }
 function helpLine(action) {
   const positionals = positionalSpecs(action);
@@ -22307,8 +22329,8 @@ function helpLine(action) {
     const token = f.kind === "boolean" ? `--${f.flag}` : `--${f.flag} <>`;
     return f.required ? token : `[${token}]`;
   }).join(" ");
-  const alias2 = toolNameAlias(action);
-  const head = `  ${commandWords(action)}${alias2 ? ` (${alias2})` : ""}${args}${flags ? `  ${flags}` : ""}`;
+  const aliases = toolNameAliases(action);
+  const head = `  ${commandWords(action)}${aliases.length ? ` (${aliases.join(", ")})` : ""}${args}${flags ? `  ${flags}` : ""}`;
   return `${head}
       ${action.description}`;
 }
@@ -22347,11 +22369,13 @@ A single bare argument fills --${primary.flag} (e.g. \`arbor ${commandWords(acti
   const explicitNote = explicitPositionals.length > 0 ? `
 
 Bare arguments fill ${explicitPositionals.map((spec) => `--${spec.flag}`).join(" then ")}; the equivalent flags remain accepted.` : "";
-  const alias2 = toolNameAlias(action);
-  const aliasNote = alias2 ? `
+  const aliases = toolNameAliases(action);
+  const aliasNote = aliases.length === 1 ? `
+
+Alias: \`arbor ${aliases[0]}\` (the tool-name form) resolves to this same command.` : aliases.length > 1 ? `
 
-Alias: \`arbor ${alias2}\` (the tool-name form) resolves to this same command.` : "";
-  const heading = `${commandWords(action)}${alias2 ? ` (alias: ${alias2})` : ""}`;
+Aliases: ${aliases.map((alias2) => `\`arbor ${alias2}\``).join(", ")} (tool-name forms) resolve to this same command.` : "";
+  const heading = `${commandWords(action)}${aliases.length === 1 ? ` (alias: ${aliases[0]})` : aliases.length > 1 ? ` (aliases: ${aliases.join(", ")})` : ""}`;
   const waitLines = action.name === "computer_exec" ? [
     "  --no-wait [<boolean>]  [optional] — return a running processId immediately instead of polling computer_process_read"
   ] : [];

package/package.json

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