@lambdacurry/arbor 0.22.13 → 0.22.15

package/dist/arbor.js

@@ -2,7 +2,7 @@
 // package.json
 var package_default = {
   name: "@lambdacurry/arbor",
-  version: "0.22.13",
+  version: "0.22.15",
   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",
@@ -8382,13 +8382,13 @@ var MCP_OUTPUT_SCHEMAS = {
     reacted: boolean2(),
     reactions: array(reactionCount)
   }),
-  create_topic: looseObject({ topicId: id }),
+  create_topic: looseObject({ topicId: id, url: string2().optional() }),
   topic_update: looseObject({
     id,
     title: string2().optional(),
     purpose: nullableString.optional()
   }),
-  create_thread: looseObject({ threadId: id }),
+  create_thread: looseObject({ threadId: id, url: string2().optional() }),
   thread_update: looseObject({
     id,
     title: string2().optional(),
@@ -8684,6 +8684,7 @@ var MCP_OUTPUT_SCHEMAS = {
   artifact_get: object({
     id,
     title: string2(),
+    url: string2().optional(),
     kind: string2(),
     version: number2().int().nonnegative(),
     lineCount: number2().int().nonnegative(),
@@ -8695,6 +8696,16 @@ var MCP_OUTPUT_SCHEMAS = {
     nextLine: number2().int().min(1).nullable().optional(),
     totalLines: number2().int().nonnegative().optional()
   }),
+  tldraw_create: looseObject({
+    artifactId: id,
+    artifactVersionId: id,
+    version: number2().int().min(1),
+    sourceAttachmentId: id,
+    sourceSha256: string2(),
+    documentClock: number2().int().min(0),
+    replayed: boolean2(),
+    url: string2().optional()
+  }),
   tldraw_import: looseObject({
     artifactId: id,
     artifactVersionId: id,
@@ -8717,7 +8728,8 @@ var MCP_OUTPUT_SCHEMAS = {
     source: jsonObject,
     current: jsonObject,
     versionRefs: array(jsonObject),
-    script: jsonObject
+    script: jsonObject,
+    url: string2().optional()
   }),
   tldraw_workbench: looseObject({
     artifactId: id,
@@ -9302,8 +9314,14 @@ var OUTPUT_SHAPERS = {
     ["reacted", result.reacted],
     ["reactions", result.reactions]
   ]),
-  create_topic: (result) => defined([["topicId", result.id]]),
-  create_thread: (result) => defined([["threadId", result.id]]),
+  create_topic: (result) => defined([
+    ["topicId", result.id],
+    ["url", result.url]
+  ]),
+  create_thread: (result) => defined([
+    ["threadId", result.id],
+    ["url", result.url]
+  ]),
   space_create: (result) => defined([
     ["spaceId", result.id],
     ["visibility", result.visibility]
@@ -9618,6 +9636,7 @@ var MCP_TOOL_ANNOTATIONS = {
   curation: additive,
   artifact: additive,
   artifact_get: readOnly,
+  tldraw_create: idempotent,
   tldraw_import: idempotent,
   tldraw_get: readOnly,
   tldraw_workbench: destructive,
@@ -11300,12 +11319,12 @@ var ACTION_DEFINITIONS = [
   {
     name: "tree",
     title: "Navigate the workspace tree",
-    description: `Map Spaces to Topics to Threads for orientation; external reads page ${TREE_EXTERNAL_DEFAULT_PAGE_SIZE} roots by default, while all=true is explicit complete retrieval. Topic activeThreadCount is the current working set; status is area attention, not personal obligation (inbox); scope depth=threads to a Space or Topic unless complete enumeration is intentional.`,
+    description: `Map Spaces to Topics to Threads for orientation; external reads page ${TREE_EXTERNAL_DEFAULT_PAGE_SIZE} roots by default, while all=true is explicit complete retrieval: unscoped tree pages Spaces, Space-scoped tree pages Topics, and Topic-scoped depth=threads pages Threads. For a bounded Thread roster, scope to one Topic; Topic activeThreadCount is the current working set, status is area attention, not personal obligation (inbox), and depth=threads should stay scoped unless complete enumeration is intentional.`,
     inputSchema: {
       space: string2().optional().describe("scope to one space id (spc_…)"),
       topic: string2().optional().describe("scope to one topic id (top_…)"),
       depth: _enum(["spaces", "topics", "threads"]).optional().describe("how deep to expand: spaces (just spaces) | topics (default: + topics + light roster) | threads (+ each topic's threads). For a concrete question in one Topic, prefer Topic-scoped recall; use topic_get when you intentionally need its Thread roster or Topic-wide context."),
-      limit: number2().int().min(1).optional().describe(`max roots to return; MCP/CLI/API default to ${TREE_EXTERNAL_DEFAULT_PAGE_SIZE} and return nextCursor when more remain`),
+      limit: number2().int().min(1).optional().describe(`max page roots to return; unscoped tree pages Spaces, Space-scoped tree pages Topics, and Topic-scoped depth=threads pages Threads. MCP/CLI/API default to ${TREE_EXTERNAL_DEFAULT_PAGE_SIZE} and return nextCursor when more remain; scope to one Topic for a bounded Thread roster`),
       cursor: PAGINATION_INPUT.cursor,
       all: PAGINATION_INPUT.all
     },
@@ -11926,10 +11945,24 @@ var ACTION_DEFINITIONS = [
     toolset: "artifacts",
     run: forward("artifact.transition")
   },
+  {
+    name: "tldraw_create",
+    title: "Create a blank tldraw board",
+    description: "Create a durable blank native tldraw Artifact on a Thread, entering the same source/version/room/checkpoint lifecycle as an imported board. Retries with the same idempotencyKey return the original Artifact; observe before editing.",
+    inputSchema: {
+      title: string2().min(1).max(200).describe("the board title"),
+      summary: string2().min(1).max(500).describe("one-line description of the board"),
+      sourceThreadId: string2().describe("Thread that owns the board, thr_…"),
+      idempotencyKey: string2().min(1).max(200).describe("stable key for this create request")
+    },
+    surfaces: ["mcp", "cli"],
+    toolset: "artifacts",
+    run: forward("tldraw.create")
+  },
   {
     name: "tldraw_import",
     title: "Import a tldraw board",
-    description: "Create a durable tldraw Artifact from one uploaded .tldr source after Arbor validates the stored bytes and source thread. Retries with the same idempotencyKey return the original Artifact version.",
+    description: "Import an external .tldr into a durable tldraw Artifact after Arbor validates the stored bytes and source Thread. For a new blank board use tldraw_create; retries with the same idempotencyKey return the original Artifact version, then observe before editing.",
     inputSchema: {
       sourceAttachmentId: string2().describe("uploaded .tldr Attachment, att_…"),
       title: string2().min(1).max(200).describe("the board title"),

package/package.json

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