@lambdacurry/arbor 0.22.8 → 0.22.10

package/dist/arbor.js

@@ -2,7 +2,7 @@
 // package.json
 var package_default = {
   name: "@lambdacurry/arbor",
-  version: "0.22.8",
+  version: "0.22.10",
   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",
@@ -9252,6 +9252,13 @@ var MCP_OUTPUT_SCHEMAS = {
 function outputSchemaFor(actionName) {
   return MCP_OUTPUT_SCHEMAS[actionName];
 }
+
+// ../actions/src/agent-guides.ts
+var AGENT_GUIDE_URLS = {
+  tldraw: "https://arborthreads.com/docs/agents/tldraw",
+  computer: "https://arborthreads.com/docs/agents/computer",
+  apps: "https://arborthreads.com/docs/agents/apps"
+};
 // ../actions/src/output-shaping.ts
 function record2(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value) ? value : null;
@@ -9675,6 +9682,54 @@ function mcpAnnotationsFor(name) {
   return annotations;
 }
 
+// ../actions/src/skill.ts
+var ARBOR_SKILL_NAME = "arbor";
+var ARBOR_SKILL_DESCRIPTION = "Work in Arbor (arborthreads.com), the team's deliberation room and shared memory for people and agents. " + "Use when you need to decide something with teammates or agents, record what was settled, check what you owe (inbox, requests, reviews), " + "recall prior decisions before re-deriving them, post evidence or a proposal to a Thread, keep a durable output as an Artifact, " + "or run software work on a Thread's Computer. Reach Arbor through its MCP tools or the arbor CLI (npx -y @lambdacurry/arbor@latest).";
+var ARBOR_SKILL_FRONTMATTER = {
+  name: ARBOR_SKILL_NAME,
+  description: ARBOR_SKILL_DESCRIPTION,
+  license: "MIT"
+};
+var ORIGIN = "https://arborthreads.com";
+function renderArborSkill(orientation) {
+  const base = ORIGIN;
+  const fm = ARBOR_SKILL_FRONTMATTER;
+  return `---
+name: ${fm.name}
+description: "${fm.description}"
+license: ${fm.license}
+---
+
+# Arbor
+
+Arbor is the team's deliberation room and shared memory: people and agents settle typed work in
+Spaces → Topics → Threads, review each other's contributions, and promote the durable ones into
+Artifacts Arbor keeps current. Use it to decide things with others and to remember what was decided.
+
+## Reaching Arbor
+
+- **MCP** — two servers over one identity. \`${base}/mcp\` is collaboration + durable knowledge
+  (Spaces, Topics, Threads, contributions, requests, reviews, Goals, Artifacts, recall, inbox).
+  \`${base}/computer/mcp\` is Arbor Computer, the software workflow (open, run, verify, package,
+  deploy, operate). If the tools are already connected in this session, use them directly.
+- **CLI** — \`npx -y @lambdacurry/arbor@latest <command>\` (or \`arbor <command>\` when installed). The
+  same actions as MCP; \`arbor help\` lists every command with a when-to-use and an example, and
+  \`arbor <command> --help\` gives that command's flags. Long bodies go in via \`--body-file -\` (stdin).
+  Add \`--json\` for a structured envelope.
+- **Auth** — a personal access token (acts as its human) or an agent key (acts as the agent), sent as
+  a Bearer header to MCP or as \`ARBOR_TOKEN\` / \`arbor auth <token>\` for the CLI. Identity is resolved
+  server-side from the credential; never assert who you are. Not connected yet? \`${base}/connect.md\`
+  walks the setup for each client.
+- **Start** with \`whoami\` (confirm who you are acting as) and \`inbox\` (what you owe). Then follow the
+  etiquette below — it is the same text Arbor sends as MCP \`instructions\` at connect and prints from
+  \`arbor orient\`.
+
+## How to work well in Arbor
+
+${orientation}
+`;
+}
+
 // ../actions/src/tldraw-agent.ts
 var TLDRAW_EXEC_MAX_OPERATIONS = 100;
 var shapeId = string2().regex(/^shape:[A-Za-z0-9_-]{1,128}$/).describe("stable tldraw shape id, shape:…");
@@ -9755,61 +9810,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 — read skill://arbor/references/tldraw.md before first use");
-
-// ../actions/src/skill.ts
-var ARBOR_SKILL_NAME = "arbor";
-var ARBOR_SKILL_DESCRIPTION = "Work in Arbor (arborthreads.com), the team's deliberation room and shared memory for people and agents. " + "Use when you need to decide something with teammates or agents, record what was settled, check what you owe (inbox, requests, reviews), " + "recall prior decisions before re-deriving them, post evidence or a proposal to a Thread, keep a durable output as an Artifact, " + "or run software work on a Thread's Computer. Reach Arbor through its MCP tools or the arbor CLI (npx -y @lambdacurry/arbor@latest).";
-var ARBOR_SKILL_FRONTMATTER = {
-  name: ARBOR_SKILL_NAME,
-  description: ARBOR_SKILL_DESCRIPTION,
-  license: "MIT"
-};
-var ORIGIN = "https://arborthreads.com";
-function renderArborSkill(orientation) {
-  const base = ORIGIN;
-  const fm = ARBOR_SKILL_FRONTMATTER;
-  return `---
-name: ${fm.name}
-description: "${fm.description}"
-license: ${fm.license}
----
-
-# Arbor
-
-Arbor is the team's deliberation room and shared memory: people and agents settle typed work in
-Spaces → Topics → Threads, review each other's contributions, and promote the durable ones into
-Artifacts Arbor keeps current. Use it to decide things with others and to remember what was decided.
-
-## Reaching Arbor
-
-- **MCP** — two servers over one identity. \`${base}/mcp\` is collaboration + durable knowledge
-  (Spaces, Topics, Threads, contributions, requests, reviews, Goals, Artifacts, recall, inbox).
-  \`${base}/computer/mcp\` is Arbor Computer, the software workflow (open, run, verify, package,
-  deploy, operate). If the tools are already connected in this session, use them directly.
-- **CLI** — \`npx -y @lambdacurry/arbor@latest <command>\` (or \`arbor <command>\` when installed). The
-  same actions as MCP; \`arbor help\` lists every command with a when-to-use and an example, and
-  \`arbor <command> --help\` gives that command's flags. Long bodies go in via \`--body-file -\` (stdin).
-  Add \`--json\` for a structured envelope.
-- **Auth** — a personal access token (acts as its human) or an agent key (acts as the agent), sent as
-  a Bearer header to MCP or as \`ARBOR_TOKEN\` / \`arbor auth <token>\` for the CLI. Identity is resolved
-  server-side from the credential; never assert who you are. Not connected yet? \`${base}/connect.md\`
-  walks the setup for each client.
-- **Start** with \`whoami\` (confirm who you are acting as) and \`inbox\` (what you owe). Then follow the
-  etiquette below — it is the same text Arbor sends as MCP \`instructions\` at connect and prints from
-  \`arbor orient\`.
-
-## How to work well in Arbor
-
-${orientation}
-
-## Native tldraw
-
-Before creating or modifying a native tldraw Artifact, read the bundled
-references/tldraw.md. Over MCP it is skill://arbor/references/tldraw.md; when only the CLI or web is
-available, read ${base}/skill/tldraw.md.
-`;
-}
+}).describe("preferred declarative edits, applied in order; mutually exclusive with code");
 // ../actions/src/index.ts
 var ARBOR_FEEDBACK_INPUT_TYPES = [...ARBOR_FEEDBACK_TYPES, "friction"];
 var CONTRIBUTION_ADD_LINK_RELS = [
@@ -10582,7 +10583,7 @@ var ACTION_DEFINITIONS = [
   {
     name: "computer_run_start",
     title: "Start a run",
-    description: "Start one bounded unit of work on a Thread's Computer by threadId, no computer_open first: an isolated write Run (the default) restores its own environment from the Thread's snapshot without booting the parent; shared and read Runs use the live parent. The caller-owned idempotencyKey makes a lost response recover zero-or-one Run, and failures return the exact runId for computer_run_receipt.",
+    description: `Start one bounded unit of work by threadId, no computer_open first: write defaults to an isolated Run from the Thread snapshot without booting the parent; shared/read Runs use the live parent; idempotencyKey recovers zero-or-one Run after response loss, and failures return runId for computer_run_receipt. First use: read the Computer guide at ${AGENT_GUIDE_URLS.computer}.`,
     inputSchema: {
       threadId: string2().optional().describe("the Thread whose Computer this Run works in, thr_…; the front door — no computer_open first"),
       computerSessionId: string2().optional().describe("alternative to threadId: an existing computerSessionId from computer_open, cms_… (parent already open)"),
@@ -10861,7 +10862,7 @@ var ACTION_DEFINITIONS = [
   {
     name: "computer_publish_app_bundle",
     title: "Publish an immutable AppBundle",
-    description: "Publish an immutable AppBundle from the parent Computer behind a shared write Run (runId) after a green build when an ArtifactVersion is ready; Arbor acquires compatible bun-typescript-v1 execution internally. Verifies entry bytes against the ArtifactVersion, captures source/Git provenance and static assets, and returns bundleId; isolated Runs are refused, so push and start a shared Run first.",
+    description: `Publish an immutable AppBundle from parent bytes behind a shared write Run after a green build; Arbor acquires compatible bun-typescript-v1 execution, verifies bytes against ArtifactVersion, captures provenance/assets, and returns bundleId; isolated Runs are refused, so push then start shared first. First use: read the Apps guide at ${AGENT_GUIDE_URLS.apps}.`,
     inputSchema: {
       runId: string2().optional().describe("an active shared write Run on the parent whose bytes to publish, run_…"),
       computerSessionId: string2().optional().describe("legacy alternative to runId: a computerSessionId on that Computer, cms_…"),
@@ -12024,7 +12025,7 @@ var ACTION_DEFINITIONS = [
   {
     name: "tldraw_observe",
     title: "Observe a tldraw board",
-    description: "Capture a fresh bounded tldraw scene, lint result, document clock and digest, plus a PNG attachment for visual review. Observe before editing; first-time agents should read skill://arbor/references/tldraw.md (or https://arborthreads.com/skill/tldraw.md).",
+    description: `Capture a fresh bounded tldraw scene, lint result, document clock and digest, plus a PNG attachment for visual review; observe before editing. First use: read the tldraw guide at ${AGENT_GUIDE_URLS.tldraw}.`,
     inputSchema: {
       artifactId: string2().describe("the tldraw Artifact, art_…"),
       pageId: string2().min(1).max(200).optional().describe("optional page to observe"),
@@ -12038,7 +12039,7 @@ var ACTION_DEFINITIONS = [
   {
     name: "tldraw_exec",
     title: "Run a one-shot tldraw program",
-    description: "Modify the current live tldraw board with preferred declarative operations or bounded JavaScript, then return a durable execution receipt. Observe first and read skill://arbor/references/tldraw.md (or https://arborthreads.com/skill/tldraw.md); an unknown result is never replayed automatically.",
+    description: `Modify the current live tldraw board with preferred declarative operations or bounded JavaScript, then return a durable execution receipt; observe first, and never replay an unknown result automatically. First use: read the tldraw guide at ${AGENT_GUIDE_URLS.tldraw}.`,
     inputSchema: {
       artifactId: string2().describe("the tldraw Artifact, art_…"),
       code: string2().min(1).max(1e5).optional().describe("advanced script source; mutually exclusive with operations"),
@@ -12320,7 +12321,7 @@ var ACTION_DEFINITIONS = [
   {
     name: "app_create",
     title: "Create an App",
-    description: "Create a stable first-class App identity in a Space before deploying code. Public Apps are stateless and start public+unlisted+none; durable Apps are always space+durable with membership authorization and isolated SQLite state.",
+    description: `Create a stable first-class App identity in a Space before deploying code; public Apps are stateless and start public+unlisted+none, while durable Apps are always space+durable with membership authorization and isolated SQLite state. First use: read the Apps guide at ${AGENT_GUIDE_URLS.apps}.`,
     inputSchema: {
       spaceId: string2().describe("owning Space, spc_…"),
       title: string2().min(1).max(160).describe("short factual App title"),

package/package.json

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