@lambdacurry/arbor 0.1.0 → 0.2.0

package/dist/arbor.js

@@ -26,13 +26,14 @@ var CONFIG_PATH = process.env.ARBOR_CONFIG ?? join(homedir(), ".arbor", "config.
 var DEFAULT_API_URL = process.env.ARBOR_API_URL ?? "http://localhost:8799";
 function loadConfig() {
   const envToken = process.env.ARBOR_TOKEN || undefined;
+  const envUrl = process.env.ARBOR_API_URL || undefined;
   if (existsSync(CONFIG_PATH)) {
     try {
       const cfg = JSON.parse(readFileSync(CONFIG_PATH, "utf8"));
-      return { apiUrl: cfg.apiUrl || DEFAULT_API_URL, token: envToken ?? cfg.token };
+      return { apiUrl: envUrl ?? (cfg.apiUrl || DEFAULT_API_URL), token: envToken ?? cfg.token };
     } catch {}
   }
-  return { apiUrl: DEFAULT_API_URL, token: envToken };
+  return { apiUrl: envUrl ?? DEFAULT_API_URL, token: envToken };
 }
 function saveConfig(cfg) {
   mkdirSync(dirname(CONFIG_PATH), { recursive: true });
@@ -164,6 +165,15 @@ var CONTRIBUTION_TYPES = [
   "correction",
   "decision"
 ];
+var CONTRIBUTION_LINK_RELS = [
+  "fulfills",
+  "cites",
+  "contests",
+  "inReplyTo",
+  "produces",
+  "tracked-as",
+  "delivered-by"
+];
 var STAMP_FACETS = ["quality", "impact", "fit", "originality"];
 // ../../node_modules/.pnpm/drizzle-orm@0.38.4_@cloudflare+workers-types@4.20260529.1_@prisma+client@5.22.0_@types+_885285c61ee4b1c788385eea24f801ee/node_modules/drizzle-orm/entity.js
 var entityKind = Symbol.for("drizzle:entityKind");
@@ -1406,6 +1416,8 @@ var profiles = sqliteTable("profiles", {
   status: text("status").$type().notNull().default("active"),
   betterAuthUserId: text("better_auth_user_id").unique(),
   managedByProfileId: text("managed_by_profile_id"),
+  color: text("color").$type(),
+  emoji: text("emoji"),
   createdAt: ts("created_at").notNull()
 }, (t) => ({ orgIdx: index("profiles_org_idx").on(t.orgId) }));
 var clients = sqliteTable("clients", {
@@ -1533,6 +1545,8 @@ var contributions = sqliteTable("contributions", {
   body: text("body").notNull(),
   confidence: integer("confidence"),
   links: text("links", { mode: "json" }).$type(),
+  mentions: text("mentions", { mode: "json" }).$type(),
+  attachmentIds: text("attachment_ids", { mode: "json" }).$type(),
   createdAt: ts("created_at").notNull()
 }, (t) => ({ threadIdx: index("contributions_thread_idx").on(t.threadId) }));
 var reviews = sqliteTable("reviews", {
@@ -1559,6 +1573,7 @@ var comments = sqliteTable("comments", {
   aboutId: text("about_id"),
   anchor: text("anchor", { mode: "json" }).$type(),
   replyToId: text("reply_to_id"),
+  attachmentIds: text("attachment_ids", { mode: "json" }).$type(),
   editedAt: ts("edited_at"),
   deletedAt: ts("deleted_at"),
   createdAt: ts("created_at").notNull()
@@ -1566,6 +1581,20 @@ var comments = sqliteTable("comments", {
   threadIdx: index("comments_thread_idx").on(t.threadId),
   aboutIdx: index("comments_about_idx").on(t.aboutType, t.aboutId)
 }));
+var attachments = sqliteTable("attachments", {
+  id: text("id").primaryKey(),
+  filename: text("filename").notNull(),
+  mimeType: text("mime_type").notNull(),
+  size: integer("size").notNull(),
+  r2Key: text("r2_key").notNull(),
+  uploadedByProfileId: text("uploaded_by_profile_id").notNull().references(() => profiles.id),
+  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),
+  r2KeyIdx: uniqueIndex("attachments_r2_key_uniq").on(t.r2Key)
+}));
 var reactions = sqliteTable("reactions", {
   id: text("id").primaryKey(),
   actorProfileId: text("actor_profile_id").notNull().references(() => profiles.id),
@@ -1659,10 +1688,33 @@ var notifications = sqliteTable("notifications", {
   createdAt: ts("created_at").notNull()
 }, (t) => ({
   recipientIdx: index("notifications_recipient_idx").on(t.recipientProfileId, t.readAt),
-  groupIdx: index("notifications_group_idx").on(t.groupKey)
+  groupIdx: uniqueIndex("notifications_group_key_uniq").on(t.groupKey)
 }));
+var notificationCursors = sqliteTable("notification_cursors", {
+  profileId: text("profile_id").primaryKey().references(() => profiles.id),
+  lastSeenAt: ts("last_seen_at").notNull()
+});
+// ../core/src/ops/onboarding.ts
+var EMOJI_RE = new RegExp("^\\p{RGI_Emoji}$", "v");
 // ../core/src/ops/agent-pairing.ts
 var PAIRING_TTL_MS = 15 * 60 * 1000;
+// ../core/src/blob/in-memory.ts
+class InMemoryBlobStore {
+  store = new Map;
+  async put(key, bytes, mimeType) {
+    this.store.set(key, { bytes: new Uint8Array(bytes), mimeType });
+  }
+  async get(key) {
+    const blob2 = this.store.get(key);
+    return blob2 ? { bytes: new Uint8Array(blob2.bytes), mimeType: blob2.mimeType } : null;
+  }
+  async delete(key) {
+    this.store.delete(key);
+  }
+  get size() {
+    return this.store.size;
+  }
+}
 // ../core/src/retrieval/in-memory.ts
 function cosine(a, b) {
   let dot = 0;
@@ -12610,10 +12662,10 @@ function _property(property, schema, params) {
     ...normalizeParams(params)
   });
 }
-function _mime(types3, params) {
+function _mime(types4, params) {
   return new $ZodCheckMimeType({
     check: "mime_type",
-    mime: types3,
+    mime: types4,
     ...normalizeParams(params)
   });
 }
@@ -15159,7 +15211,7 @@ var ZodFile = /* @__PURE__ */ $constructor("ZodFile", (inst, def) => {
   inst._zod.processJSONSchema = (ctx, json, params) => fileProcessor(inst, ctx, json, params);
   inst.min = (size, params) => inst.check(_minSize(size, params));
   inst.max = (size, params) => inst.check(_maxSize(size, params));
-  inst.mime = (types3, params) => inst.check(_mime(Array.isArray(types3) ? types3 : [types3], params));
+  inst.mime = (types4, params) => inst.check(_mime(Array.isArray(types4) ? types4 : [types4], params));
 });
 function file(params) {
   return _file(ZodFile, params);
@@ -16035,7 +16087,20 @@ var ACTIONS = [
       threadId: exports_external.string().describe("the thread id, e.g. thr_…"),
       type: exports_external.enum(CONTRIBUTION_TYPES).describe("the contribution type (AD-066 taxonomy)"),
       body: exports_external.string().min(1).describe("the contribution text"),
-      confidence: exports_external.number().int().min(0).max(100).optional().describe("optional 0–100 confidence")
+      confidence: exports_external.number().int().min(0).max(100).optional().describe("optional 0–100 confidence"),
+      mentions: exports_external.array(exports_external.object({ kind: exports_external.enum(["person", "contribution", "artifact"]), id: exports_external.string(), label: exports_external.string() })).optional().describe("inline @-mentions in the body; person mentions notify"),
+      links: exports_external.array(exports_external.union([
+        exports_external.object({ rel: exports_external.enum(CONTRIBUTION_LINK_RELS), targetId: exports_external.string() }),
+        exports_external.object({
+          rel: exports_external.enum(CONTRIBUTION_LINK_RELS),
+          external: exports_external.object({
+            kind: exports_external.enum(["github-pr", "linear-issue", "url"]),
+            ref: exports_external.string().describe("owner/repo#123 | SFR-312 | https url"),
+            url: exports_external.string().optional().describe("explicit https click-through (Linear needs it)"),
+            label: exports_external.string().min(1).max(140).describe("what the chip renders — capture the title here")
+          })
+        })
+      ])).optional().describe("typed links: internal { rel, targetId } (same-space) or external { rel, external: { kind, ref, url?, label } } — e.g. { rel: 'delivered-by', external: { kind: 'github-pr', ref: 'owner/repo#142', label: '#142 — ship chips' } }")
     },
     surfaces: ["mcp", "cli"],
     run: forward("contribution.add")
@@ -16048,7 +16113,7 @@ var ACTIONS = [
       contributionId: exports_external.string().describe("the contribution id, e.g. con_…"),
       facetKey: exports_external.enum(STAMP_FACETS).optional().describe("quality|impact|fit|originality (omit for a neutral stamp)"),
       polarity: exports_external.enum(["positive", "negative"]).optional().describe("required with a facet"),
-      note: exports_external.string().min(1).describe("the one-line 'why'")
+      note: exports_external.string().min(1).optional().describe("the one-line 'why' (required for a signed stamp)")
     },
     surfaces: ["mcp", "cli"],
     run: forward("review.add")
@@ -16062,7 +16127,8 @@ var ACTIONS = [
       body: exports_external.string().min(1),
       aboutType: exports_external.enum(["contribution", "artifact", "comment"]).optional(),
       aboutId: exports_external.string().optional(),
-      replyToId: exports_external.string().optional()
+      replyToId: exports_external.string().optional(),
+      mentions: exports_external.array(exports_external.string()).optional().describe("profile ids to @-mention (they get a notification)")
     },
     surfaces: ["mcp", "cli"],
     run: forward("comment.add")
@@ -16106,6 +16172,27 @@ var ACTIONS = [
     surfaces: ["mcp", "cli"],
     run: forward("artifact.transition")
   },
+  {
+    name: "promote_attachment",
+    title: "Promote a file attachment to an artifact",
+    description: "Turn a file uploaded to a thread into a first-class artifact — the blob becomes the artifact's content, owned by the author of the contribution it hangs off (not necessarily you). Reach for this when an attached file is itself a deliverable worth retaining and citing. The attachment must share the contribution's thread; idempotent — re-promoting the same file returns the same artifact.",
+    inputSchema: {
+      attachmentId: exports_external.string().describe("the uploaded attachment, att_…"),
+      sourceContributionId: exports_external.string().describe("the contribution it's produced by, con_… (must share the attachment's thread)")
+    },
+    surfaces: ["mcp", "cli"],
+    run: forward("attachment.promote")
+  },
+  {
+    name: "set_answer",
+    title: "Set a thread's answer",
+    description: "Promote a contribution to be the thread's ANSWER — it becomes a `promoted` artifact owned by that contribution's author, and the thread pins it as its resolved answer. Reach for this when a thread has reached its conclusion and one contribution captures it; idempotent, and re-setting re-points the answer.",
+    inputSchema: {
+      contributionId: exports_external.string().describe("the contribution to promote as the answer, con_… (its thread + author are derived)")
+    },
+    surfaces: ["mcp", "cli"],
+    run: forward("thread.setAnswer")
+  },
   {
     name: "request",
     title: "Raise a request in a thread",
@@ -16146,6 +16233,32 @@ var ACTIONS = [
     surfaces: ["mcp", "cli"],
     run: forward("inbox.list")
   },
+  {
+    name: "notifications",
+    title: "List your notifications",
+    description: "List the awareness feed of activity involving you — stamps on your work, replies in your threads, @-mentions, and your completed requests — newest first, with an unseen count. This is FYI (no response owed); use `inbox` for what's actually asked of you.",
+    inputSchema: { ...PAGINATION_INPUT },
+    surfaces: ["mcp", "cli"],
+    run: forward("notification.list")
+  },
+  {
+    name: "notification_read",
+    title: "Mark a notification read",
+    description: "Mark ONE of your notifications read by id (from `notifications`). Reach for this to clear a single awareness row you've acted on; it can only touch your own feed, never an inbox obligation.",
+    inputSchema: {
+      notificationId: exports_external.string().describe("the notification id, ntf_…")
+    },
+    surfaces: ["mcp", "cli"],
+    run: forward("notification.markRead")
+  },
+  {
+    name: "notification_read_all",
+    title: "Mark all notifications read",
+    description: "Mark every unread notification in your feed read in one call; returns how many were cleared. Reach for this to zero out your awareness feed after a catch-up.",
+    inputSchema: {},
+    surfaces: ["mcp", "cli"],
+    run: forward("notification.markAllRead")
+  },
   {
     name: "whoami",
     title: "Who am I",
@@ -16154,6 +16267,17 @@ var ACTIONS = [
     surfaces: ["mcp", "cli"],
     run: forward("me.get")
   },
+  {
+    name: "introduce",
+    title: "Introduce yourself",
+    description: "Set your own avatar identity (AD-029/114): an emoji that represents you and/or an identity color from the curated palette (indigo, teal, terracotta, plum, steel, olive, rose, cyan). Do this once when you first connect so people recognize you at a glance; change it anytime. Your display name stays managed by your human.",
+    inputSchema: {
+      emoji: exports_external.string().optional().describe("exactly one emoji that represents you, e.g. \uD83D\uDD2D"),
+      color: exports_external.string().optional().describe("an identity color key from the curated palette")
+    },
+    surfaces: ["mcp", "cli"],
+    run: forward("me.update")
+  },
   {
     name: "thread_get",
     title: "Read a thread",
@@ -16248,26 +16372,26 @@ var ACTIONS = [
   {
     name: "topic_create",
     title: "Create a topic",
-    description: "Create a topic inside a space to group related threads. A setup step run by a human owner/admin; the parent space is tenant-guarded before the write.",
+    description: "Create a topic inside a space to group related threads — any space member may (AD-116), but prefer an EXISTING topic (check tree first); create one only for a genuinely new, durable sub-area, not per-task.",
     inputSchema: {
       spaceId: exports_external.string().min(1).describe("the parent space id"),
       title: exports_external.string().min(1).describe("the topic title"),
       purpose: exports_external.string().optional().describe("optional one-line purpose")
     },
-    surfaces: ["cli"],
+    surfaces: ["mcp", "cli"],
     run: forward("topic.create")
   },
   {
     name: "thread_create",
     title: "Create a thread",
-    description: "Open a new thread under a topic with a stated objective — the unit of collaboration agents contribute to. A setup step run by a human owner/admin; agents work in threads but don't create them.",
+    description: "Open a new thread under a topic with a stated objective — how you initiate work (AD-116). Check tree/recall first so you join existing work instead of duplicating it; the objective should say what done looks like.",
     inputSchema: {
       spaceId: exports_external.string().min(1).describe("the parent space id"),
       topicId: exports_external.string().min(1).describe("the parent topic id"),
       title: exports_external.string().min(1).describe("the thread title"),
       objective: exports_external.string().min(1).describe("what this thread is trying to achieve")
     },
-    surfaces: ["cli"],
+    surfaces: ["mcp", "cli"],
     run: forward("thread.create")
   },
   {
@@ -16542,9 +16666,22 @@ function buildInput(inputSchema, flags) {
         input[spec.field] = n;
         break;
       }
-      case "array":
-        input[spec.field] = String(raw).split(",").map((s) => s.trim()).filter(Boolean);
+      case "array": {
+        const text2 = String(raw).trim();
+        if (text2.startsWith("[")) {
+          try {
+            const parsed = JSON.parse(text2);
+            if (Array.isArray(parsed)) {
+              input[spec.field] = parsed;
+              break;
+            }
+          } catch {
+            throw new UsageError(`--${spec.flag} looks like JSON but failed to parse — check the quoting`);
+          }
+        }
+        input[spec.field] = text2.split(",").map((s) => s.trim()).filter(Boolean);
         break;
+      }
       case "boolean":
         input[spec.field] = raw === true ? true : raw !== "false";
         break;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lambdacurry/arbor",
-  "version": "0.1.0",
-  "description": "The Arbor CLI — a shared workspace for people and agents. The human + headless-agent write path over Arbor's guarded operation surface.",
+  "version": "0.2.0",
+  "description": "The Arbor CLI \u2014 a shared workspace for people and agents. The human + headless-agent write path over Arbor's guarded operation surface.",
   "type": "module",
   "bin": {
     "arbor": "./dist/arbor.js"