@lambdacurry/arbor 0.21.2 → 0.21.3

package/dist/arbor.js

@@ -2297,6 +2297,16 @@ var artifacts = sqliteTable("artifacts", {
   tierIdx: index("artifacts_tier_idx").on(t.retrievalTier),
   ownerIdx: index("artifacts_owner_idx").on(t.ownerProfileId)
 }));
+var artifactLivePreviewSurfaces = sqliteTable("artifact_live_preview_surfaces", {
+  artifactId: text("artifact_id").primaryKey().references(() => artifacts.id),
+  threadId: text("thread_id").notNull().references(() => threads.id),
+  boundByProfileId: text("bound_by_profile_id").notNull().references(() => profiles.id),
+  executionContextId: text("execution_context_id").notNull().references(() => executionContexts.id),
+  revision: integer("revision").notNull().default(1),
+  boundAt: ts("bound_at").notNull()
+}, (t) => ({
+  threadUq: uniqueIndex("artifact_live_preview_surfaces_thread_uniq").on(t.threadId)
+}));
 var artifactVersions = sqliteTable("artifact_versions", {
   id: text("id").primaryKey(),
   artifactId: text("artifact_id").notNull().references(() => artifacts.id),
@@ -17163,6 +17173,24 @@ var recallHit = exports_external.looseObject({
   url: nullableString,
   createdAt: timestamp
 });
+var artifactLivePreviewThread = exports_external.looseObject({
+  id,
+  title: exports_external.string()
+});
+var artifactLivePreview = exports_external.discriminatedUnion("status", [
+  exports_external.looseObject({
+    thread: artifactLivePreviewThread,
+    boundAt: timestamp,
+    status: exports_external.literal("configured"),
+    url: exports_external.string()
+  }),
+  exports_external.looseObject({
+    thread: artifactLivePreviewThread,
+    boundAt: timestamp,
+    status: exports_external.literal("unavailable"),
+    url: exports_external.never().optional()
+  })
+]);
 var contributionRef = exports_external.looseObject({
   id,
   objectType: exports_external.string(),
@@ -17984,7 +18012,10 @@ var MCP_OUTPUT_SCHEMAS = {
     url: exports_external.string().optional(),
     versions: exports_external.array(jsonObject).optional(),
     appBundles: exports_external.array(jsonObject).optional(),
-    usedByApps: exports_external.array(jsonObject).optional()
+    usedByApps: exports_external.array(jsonObject).optional(),
+    livePreview: artifactLivePreview.nullable().optional(),
+    threadId: id.nullable().optional(),
+    changed: exports_external.boolean().optional()
   }),
   artifact_get: exports_external.looseObject({
     id,
@@ -17996,6 +18027,7 @@ var MCP_OUTPUT_SCHEMAS = {
     versions: exports_external.array(jsonObject).optional(),
     appBundles: exports_external.array(jsonObject),
     usedByApps: exports_external.array(jsonObject),
+    livePreview: artifactLivePreview.nullable(),
     watching: exports_external.boolean(),
     url: exports_external.string()
   }),
@@ -19687,7 +19719,7 @@ var ACTION_DEFINITIONS = [
   {
     name: "get_artifact",
     title: "Read an artifact",
-    description: "Read an artifact: current source + version + immutable versions[].id (artv_…), plus who edited and via what. READ BEFORE YOU EDIT — the version number you read is the baseVersion your edit must name. Use the matching versions[].id as artifactVersionId when publishing an AppBundle. Pass --version to read an old snapshot.",
+    description: "Read an Artifact's current source/version/history plus its current executable Live Preview surface when bound. READ BEFORE YOU EDIT — the version number you read is the baseVersion your edit must name. Surface binding is current Artifact identity metadata and remains current even when --version reads old content.",
     inputSchema: {
       artifactId: exports_external.string().describe("the artifact, art_…"),
       version: exports_external.number().optional().describe("read this old snapshot instead of the current")
@@ -19714,6 +19746,18 @@ var ACTION_DEFINITIONS = [
       verb: Array.isArray(input.patches) ? "patch" : "replace"
     })
   },
+  {
+    name: "set_artifact_live_preview",
+    title: "Set an Artifact's live Thread surface",
+    description: "Bind one Artifact to an existing same-Space Thread Live Preview, making the Artifact the durable entry point for that executable surface. Omit --thread-id to clear the binding; this changes no Artifact source/version and does not create or reconfigure a Computer.",
+    inputSchema: {
+      artifactId: exports_external.string().describe("the Artifact, art_…"),
+      threadId: exports_external.string().optional().describe("the configured Thread Live Preview to bind, thr_…; omit to clear")
+    },
+    surfaces: ["cli"],
+    toolset: "artifacts",
+    run: forward("artifact.setLivePreview")
+  },
   {
     name: "transition_artifact",
     title: "Transition an artifact's lifecycle",
@@ -20529,9 +20573,9 @@ var ACTION_DEFINITIONS = [
   {
     name: "artifact",
     title: "Create or edit an Artifact",
-    description: "Create or edit a durable versioned Artifact, or promote a Thread attachment; read artifact_get and its baseVersion before editing, while lifecycle/removal stay in artifact_transition and artifact_delete. Text edits replace source or apply exact-match patches atomically, file artifacts use contentRef, and computer-produced artifacts may cite computerSessionId.",
+    description: "Create or edit a durable versioned Artifact, bind its executable Thread Live Preview, or promote a Thread attachment; read artifact_get before changing it, while lifecycle/removal stay in artifact_transition and artifact_delete. Live-surface binding changes Artifact identity metadata, not source/version content.",
     inputSchema: {
-      verb: exports_external.enum(["create", "edit", "promote_attachment"]).describe("which artifact move"),
+      verb: exports_external.enum(["create", "edit", "set_live_preview", "promote_attachment"]).describe("which artifact move"),
       title: exports_external.string().optional().describe("create: the artifact's title"),
       kind: exports_external.enum(["doc", "table", "diagram", "html", "file"]).optional().describe("create: structural kind (default file). doc/table/diagram/html are editable text"),
       type: exports_external.string().optional().describe("create: semantic type, e.g. decision|summary|plan|markdown|table|research-brief"),
@@ -20542,7 +20586,8 @@ var ACTION_DEFINITIONS = [
       sourceThreadId: exports_external.string().optional().describe("create: the thread it came from"),
       computerSessionId: exports_external.string().optional().describe("create: the attached computer session that produced it, cms_…"),
       sourceContributionIds: exports_external.array(exports_external.string()).optional().describe("create: contributions it distills"),
-      artifactId: exports_external.string().optional().describe("edit: the Artifact, art_…"),
+      artifactId: exports_external.string().optional().describe("edit/set_live_preview: the Artifact, art_…"),
+      threadId: exports_external.string().optional().describe("set_live_preview: the configured Thread Live Preview, thr_…; omit to clear the binding"),
       baseVersion: exports_external.number().optional().describe("edit: the version you READ (from get/create) — stale base is rejected with the current source"),
       patches: exports_external.array(exports_external.object({ old: exports_external.string(), new: exports_external.string() })).optional().describe("edit: exact-match hunks applied in order, atomically; each old must match exactly once"),
       note: exports_external.string().optional().describe("edit: one-line summary of what changed"),
@@ -20553,13 +20598,14 @@ var ACTION_DEFINITIONS = [
     run: dispatch({
       create: "artifact.create",
       edit: "artifact.edit",
+      set_live_preview: "artifact.setLivePreview",
       promote_attachment: "attachment.promote"
     }, (verb, input) => verb === "edit" ? { ...input, verb: Array.isArray(input.patches) ? "patch" : "replace" } : input)
   },
   {
     name: "artifact_get",
     title: "Read an Artifact",
-    description: "Read an Artifact's current source, version, immutable history, and AppBundle references, or pass version for an older snapshot. It cannot edit content, change lifecycle, promote an attachment, or delete an Artifact.",
+    description: "Read an Artifact's current source, version, immutable history, AppBundle references, and current executable Live Preview surface, or pass version for an older content snapshot. It cannot edit content, bind a surface, change lifecycle, promote an attachment, or delete an Artifact.",
     inputSchema: {
       artifactId: exports_external.string().describe("the Artifact, art_…"),
       version: exports_external.number().optional().describe("read this old snapshot instead of the current")

package/package.json

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