@lambdacurry/arbor 0.12.2 → 0.12.5

package/dist/arbor.js

@@ -1572,6 +1572,8 @@ var previewVersions = sqliteTable("preview_versions", {
   computerSessionId: text("computer_session_id").notNull().references(() => computerSessions.id),
   snapshotId: text("snapshot_id").notNull().references(() => computerSnapshots.id),
   publishedByProfileId: text("published_by_profile_id").notNull().references(() => profiles.id),
+  idempotencyKey: text("idempotency_key"),
+  idempotencyFingerprint: text("idempotency_fingerprint"),
   publishedExecutionContextId: text("published_execution_context_id").notNull().references(() => executionContexts.id),
   failureCode: text("failure_code"),
   createdAt: ts("created_at").notNull(),
@@ -1580,8 +1582,18 @@ var previewVersions = sqliteTable("preview_versions", {
   previewVersionIdx: uniqueIndex("preview_versions_preview_version_idx").on(t.previewId, t.version),
   hostIdx: uniqueIndex("preview_versions_host_idx").on(t.hostLabel),
   sessionIdx: index("preview_versions_session_idx").on(t.computerSessionId, t.createdAt),
+  idempotencyIdx: uniqueIndex("preview_versions_idempotency_idx").on(t.computerSessionId, t.publishedByProfileId, t.idempotencyKey),
   snapshotIdx: index("preview_versions_snapshot_idx").on(t.snapshotId)
 }));
+var previewVersionFiles = sqliteTable("preview_version_files", {
+  versionId: text("version_id").notNull().references(() => previewVersions.id),
+  path: text("path").notNull(),
+  size: integer("size").notNull(),
+  mimeType: text("mime_type").notNull(),
+  sha256: text("sha256").notNull()
+}, (t) => ({
+  pk: primaryKey({ columns: [t.versionId, t.path] })
+}));
 var previewVersionFinalizations = sqliteTable("preview_version_finalizations", {
   versionId: text("version_id").primaryKey().references(() => previewVersions.id),
   finalizedAt: ts("finalized_at").notNull()
@@ -1646,15 +1658,21 @@ var reviews = sqliteTable("reviews", {
 var attachments = sqliteTable("attachments", {
   id: text("id").primaryKey(),
   filename: text("filename").notNull(),
+  description: text("description").notNull().default(""),
   mimeType: text("mime_type").notNull(),
   size: integer("size").notNull(),
   r2Key: text("r2_key").notNull(),
   uploadedByProfileId: text("uploaded_by_profile_id").notNull().references(() => profiles.id),
+  computerSessionId: text("computer_session_id").references(() => computerSessions.id),
+  idempotencyKey: text("idempotency_key"),
+  idempotencyFingerprint: text("idempotency_fingerprint"),
+  sha256: text("sha256"),
   threadId: text("thread_id").notNull().references(() => threads.id),
   createdAt: ts("created_at").notNull()
 }, (t) => ({
   threadIdx: index("attachments_thread_idx").on(t.threadId),
   uploaderIdx: index("attachments_uploader_idx").on(t.uploadedByProfileId),
+  computerExportIdempotencyIdx: uniqueIndex("attachments_computer_export_idempotency_idx").on(t.computerSessionId, t.uploadedByProfileId, t.idempotencyKey),
   r2KeyIdx: uniqueIndex("attachments_r2_key_uniq").on(t.r2Key)
 }));
 var reactions = sqliteTable("reactions", {
@@ -1781,6 +1799,11 @@ var notificationCursors = sqliteTable("notification_cursors", {
   profileId: text("profile_id").primaryKey().references(() => profiles.id),
   lastSeenAt: ts("last_seen_at").notNull()
 });
+var recallIndex = sqliteTable("recall_index", {
+  objectId: text("object_id").primaryKey(),
+  indexedAt: ts("indexed_at").notNull(),
+  chunks: integer("chunks")
+});
 var watches = sqliteTable("watches", {
   id: text("id").primaryKey(),
   watcherProfileId: text("watcher_profile_id").notNull().references(() => profiles.id),
@@ -1832,6 +1855,28 @@ class InMemoryBlobStore {
   async put(key, bytes, mimeType) {
     this.store.set(key, { bytes: new Uint8Array(bytes), mimeType });
   }
+  async putStream(key, stream, size, mimeType) {
+    const reader = stream.getReader();
+    const bytes = new Uint8Array(size);
+    let offset = 0;
+    try {
+      while (true) {
+        const { done, value } = await reader.read();
+        if (done)
+          break;
+        if (offset + value.byteLength > size) {
+          throw new Error(`Blob stream exceeded its declared ${size} bytes`);
+        }
+        bytes.set(value, offset);
+        offset += value.byteLength;
+      }
+    } finally {
+      reader.releaseLock();
+    }
+    if (offset !== size)
+      throw new Error(`Blob stream ended at ${offset} of ${size} bytes`);
+    this.store.set(key, { bytes, mimeType });
+  }
   async get(key, range) {
     const blob2 = this.store.get(key);
     if (!blob2)
@@ -1884,6 +1929,8 @@ class InMemoryVectorStore {
   async query(vector, q) {
     const scored = [];
     for (const r of this.records.values()) {
+      if ((r.namespace ?? null) !== (q.namespace ?? null))
+        continue;
       if (!matchesFilter(r.metadata, q.filter))
         continue;
       scored.push({ id: r.id, score: cosine(vector, r.vector), metadata: r.metadata });
@@ -1906,6 +1953,7 @@ class InMemoryVectorStore {
 var recallFts = sqliteTable("recall_fts", {
   id: text("id"),
   body: text("body"),
+  org: text("org"),
   space: text("space"),
   topic: text("topic"),
   thread: text("thread")
@@ -1920,8 +1968,10 @@ var INDEX_ON = new Set([
   "review.added",
   "thread.created",
   "topic.created",
-  "topic.edited"
+  "topic.edited",
+  "contribution.restored"
 ]);
+var PURGE_ON = new Set(["contribution.deleted"]);
 // ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/classic/external.js
 var exports_external = {};
 __export(exports_external, {
@@ -16555,10 +16605,12 @@ var ACTIONS = [
   {
     name: "computer_export",
     title: "Export a Thread file",
-    description: "Move one bounded image, MP4/WebM video, or supported file from an opened computer into a durable Thread Attachment. Returns attachmentIds and ready-to-place attachments[].markdown; put the Markdown where the media belongs and bind those ids when contributing or responding.",
+    description: "Move one bounded image, MP4/WebM video, or supported file from an opened computer into a durable Thread Attachment. Describe what it shows so the returned attachments[].markdown has meaningful image alt text or a video/file label; put that Markdown where the media belongs and bind those ids when contributing or responding. Supply one stable idempotencyKey per logical export: safe retries return the original Attachment, while reusing the key for another path or description conflicts.",
     inputSchema: {
       computerSessionId: exports_external.string().describe("the computerSessionId returned by computer_open, cms_…"),
-      path: exports_external.string().describe("absolute path to one supported file under /workspace")
+      path: exports_external.string().describe("absolute path to one supported file under /workspace"),
+      description: exports_external.string().min(1).max(500).describe("concise description of what the file shows or contains; becomes image alt text, a video caption, and the Artifact summary"),
+      idempotencyKey: exports_external.string().min(1).max(200).describe("stable key for this ONE logical export (≤200 chars); reuse it only to retry the same path")
     },
     surfaces: ["computer-mcp", "computer-cli"],
     toolset: "loop",
@@ -16567,11 +16619,12 @@ var ACTIONS = [
   {
     name: "computer_write",
     title: "Write a project file",
-    description: "Write one file under /workspace. Prefer normal editing tools for code changes; reach for this when the MCP/CLI computer surface is the only filesystem path.",
+    description: "Write one file under /workspace. Content is UTF-8 by default; pass encoding=base64 only for binary bytes. Prefer normal editing tools for code changes; reach for this when the MCP/CLI computer surface is the only filesystem path.",
     inputSchema: {
       computerSessionId: exports_external.string().describe("the computerSessionId returned by computer_open, cms_…"),
       path: exports_external.string().describe("absolute path under /workspace"),
-      content: exports_external.string().describe("complete UTF-8 file content")
+      content: exports_external.string().describe("complete UTF-8 content, or base64 bytes when encoding=base64"),
+      encoding: exports_external.enum(["utf8", "base64"]).optional().describe("content encoding; defaults to utf8, use base64 for binary files")
     },
     surfaces: ["computer-mcp", "computer-cli"],
     toolset: "loop",
@@ -16605,11 +16658,12 @@ var ACTIONS = [
   {
     name: "computer_publish_preview",
     title: "Publish an immutable static Preview",
-    description: "Publish one checked HTML file or bounded static build directory as a private immutable Preview after checkpointing its source. The returned arborthreads.dev URL survives computer teardown; put it on its own line to show the interactive Preview card. A directory must contain index.html, use relative local asset URLs, and cannot include dotfiles, source maps, secrets, symlinks, or server code.",
+    description: "Publish one checked HTML file or bounded static build directory as a private immutable Preview after checkpointing its source. The returned arborthreads.dev URL survives computer teardown; put it on its own line to show the interactive Preview card. A directory must contain index.html, use relative local asset URLs, and cannot include dotfiles, source maps, secrets, symlinks, or server code. Supply one stable idempotencyKey per logical publication: safe retries return the original immutable URL, while reusing the key for another path/title conflicts.",
     inputSchema: {
       computerSessionId: exports_external.string().describe("the computerSessionId returned by computer_open, cms_…"),
       path: exports_external.string().describe("absolute path to one HTML file or static build directory under /workspace"),
-      title: exports_external.string().min(1).max(160).describe("short factual Preview title")
+      title: exports_external.string().min(1).max(160).describe("short factual Preview title"),
+      idempotencyKey: exports_external.string().min(1).max(200).describe("stable key for this ONE logical publication (≤200 chars); reuse it only to retry the same path and title")
     },
     surfaces: ["computer-mcp", "computer-cli"],
     toolset: "loop",
@@ -16693,7 +16747,7 @@ var ACTIONS = [
   {
     name: "create_artifact",
     title: "Create an artifact",
-    description: "Promote durable output — a decision, summary, plan, or research brief — into a first-class artifact you own. 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 an attached Thread computer, pass that attach_computer receipt as computerSessionId 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.",
+    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 an attached Thread computer, pass that attach_computer receipt as computerSessionId 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: exports_external.string().describe("semantic type, e.g. decision|summary|plan|markdown|table|research-brief"),
       kind: exports_external.enum(["doc", "table", "diagram", "html", "file"]).optional().describe("structural kind (default file). doc/table/diagram/html are editable, versioned text"),
@@ -16701,7 +16755,7 @@ var ACTIONS = [
       source: exports_external.string().optional().describe("text kinds: the initial content (v1)"),
       contentRef: exports_external.string().optional().describe("kind=file: where the content lives, e.g. inline://… or a URL"),
       editPolicy: exports_external.enum(["owner", "members", "anyone"]).optional().describe("who may edit (default members)"),
-      summary: exports_external.string().optional(),
+      summary: exports_external.string().min(1).max(500).describe("required one-line description of what this durable Artifact is or accomplishes"),
       sourceThreadId: exports_external.string().optional(),
       sourceContributionIds: exports_external.array(exports_external.string()).optional(),
       computerSessionId: exports_external.string().optional().describe("the attached computer session that produced this artifact, cms_…")
@@ -17499,7 +17553,7 @@ var ACTIONS = [
   {
     name: "artifact",
     title: "Durable artifacts",
-    description: "Durable, versioned artifacts — the team's living documents (AD-201). Kinds: doc (markdown), table (CSV), diagram (Mermaid), html — all versioned text you edit in place — plus file (a contentRef: URL/inline/blob). " + "verb=create (kind+type+title, source for text kinds / contentRef for file; a text artifact is born at v1 and is AUTOMATICALLY listed on its sourceThreadId thread — no link post needed). " + "For computer-produced output, create with the computerSessionId returned by attach_computer so the artifact cites the reproducible session. " + "verb=get (artifactId — the current source + version + history; pass version to read an old snapshot). " + "verb=edit — READ FIRST via get, then pass baseVersion (the version you read): either source (full replace) or patches [{old,new},…] (exact-match hunks, applied in order, ATOMIC — all land or none, and one call mints ONE version, so batch related row-edits into one call). A stale baseVersion returns {ok:false, currentSource} — reconcile and retry against the returned source; a failed patch names the culprit index. " + "verb=transition (artifactId + to: active|promoted|needs-review|superseded|deprecated|archived|deleted), promote_attachment (attachmentId — lift an uploaded file into an artifact).",
+    description: "Durable, versioned artifacts — the team's living documents (AD-201). Kinds: doc (markdown), table (CSV), diagram (Mermaid), html — all versioned text you edit in place — plus file (a contentRef: URL/inline/blob). " + "verb=create (kind+type+title+summary, source for text kinds / contentRef for file; summary is the required one-line skim/retrieval description; a text artifact is born at v1 and is AUTOMATICALLY listed on its sourceThreadId thread — no link post needed). " + "For computer-produced output, create with the computerSessionId returned by attach_computer so the artifact cites the reproducible session. " + "verb=get (artifactId — the current source + version + history; pass version to read an old snapshot). " + "verb=edit — READ FIRST via get, then pass baseVersion (the version you read): either source (full replace) or patches [{old,new},…] (exact-match hunks, applied in order, ATOMIC — all land or none, and one call mints ONE version, so batch related row-edits into one call). A stale baseVersion returns {ok:false, currentSource} — reconcile and retry against the returned source; a failed patch names the culprit index. " + "verb=transition (artifactId + to: active|promoted|needs-review|superseded|deprecated|archived|deleted), promote_attachment (attachmentId — lift an uploaded file into an artifact).",
     inputSchema: {
       verb: exports_external.enum(["create", "get", "edit", "transition", "promote_attachment"]).describe("which artifact move"),
       title: exports_external.string().optional().describe("create: the artifact's title"),
@@ -17508,7 +17562,7 @@ var ACTIONS = [
       source: exports_external.string().optional().describe("create (text kinds): the initial content · edit verb=replace: the full new content"),
       contentRef: exports_external.string().optional().describe("create (kind=file): where the content lives, e.g. inline://… or a URL"),
       editPolicy: exports_external.enum(["owner", "members", "anyone"]).optional().describe("create: who may edit (default members)"),
-      summary: exports_external.string().optional().describe("create: a short summary"),
+      summary: exports_external.string().min(1).max(500).optional().describe("create: REQUIRED one-line description of what this Artifact is or accomplishes"),
       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"),

package/package.json

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