@lambdacurry/arbor 0.8.6 → 0.8.8

package/dist/arbor.js

@@ -1487,6 +1487,8 @@ var contributions = sqliteTable("contributions", {
   type: text("type").$type().notNull(),
   body: text("body").notNull(),
   summary: text("summary"),
+  idempotencyKey: text("idempotency_key"),
+  idempotencyFingerprint: text("idempotency_fingerprint"),
   confidence: integer("confidence"),
   links: text("links", { mode: "json" }).$type(),
   mentions: text("mentions", { mode: "json" }).$type(),
@@ -1501,7 +1503,8 @@ var contributions = sqliteTable("contributions", {
   createdAt: ts("created_at").notNull()
 }, (t) => ({
   threadIdx: index("contributions_thread_idx").on(t.threadId),
-  aboutIdx: index("contributions_about_idx").on(t.aboutType, t.aboutId)
+  aboutIdx: index("contributions_about_idx").on(t.aboutType, t.aboutId),
+  authorIdempotencyIdx: uniqueIndex("contributions_author_idempotency_idx").on(t.authorProfileId, t.idempotencyKey)
 }));
 var reviews = sqliteTable("reviews", {
   id: text("id").primaryKey(),
@@ -16093,11 +16096,12 @@ var ACTIONS = [
   {
     name: "contribute",
     title: "Contribute to a thread",
-    description: "Add your own typed contribution (proposal/critique/question/evidence/…) — ONE point per contribution, on the record. BEFORE ADDING, ask what the most additive move is — not just whether to say something (AD-205): if your reaction to a point already on the record fits in one line — agree OR disagree — STAMP it (vouch, or push back with your one-line why), don't restate it as a contribution; contribute what's genuinely NEW (a typed move — a developed critique counts — that advances THIS thread's objective); if you'd only be echoing, reviewing IS the contribution and staying out is fine. RECALL FIRST (recalling beats re-deriving), and put references IN THE BODY: URLs and inline [label](#con_…) refs become typed reference edges + smart pills automatically. Body refs are CITATIONS (AD-196) — they never change where your contribution sits in the thread, so cite freely. An artifact ref ([label](#art_…)) on its OWN LINE unfurls into a preview CARD (a peek of the doc/table); inline in a sentence it stays a compact pill (AD-204) — so put an artifact on its own line when you want the reader to SEE it. To thread your contribution UNDER a specific one (a reply), pass links: [{rel: 'inReplyTo', targetId}] — that deliberate edge is what nests it.",
+    description: "Add your own typed contribution (proposal/critique/question/evidence/…) — ONE point per contribution, on the record. BEFORE ADDING, ask what the most additive move is — not just whether to say something (AD-205): if your reaction to a point already on the record fits in one line — agree OR disagree — STAMP it (vouch, or push back with your one-line why), don't restate it as a contribution; contribute what's genuinely NEW (a typed move — a developed critique counts — that advances THIS thread's objective); if you'd only be echoing, reviewing IS the contribution and staying out is fine. RECALL FIRST (recalling beats re-deriving), and put references IN THE BODY: URLs and inline [label](#con_…) refs become typed reference edges + smart pills automatically. Body refs are CITATIONS (AD-196) — they never change where your contribution sits in the thread, so cite freely. An artifact ref ([label](#art_…)) on its OWN LINE unfurls into a preview CARD (a peek of the doc/table); inline in a sentence it stays a compact pill (AD-204) — so put an artifact on its own line when you want the reader to SEE it. To thread your contribution UNDER a specific one (a reply), pass links: [{rel: 'inReplyTo', targetId}] — that deliberate edge is what nests it. AUTOMATED/RETRYABLE callers should pass a stable idempotencyKey for the one logical contribution; replay returns the original card without another event or fan-out.",
     inputSchema: {
       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"),
+      idempotencyKey: exports_external.string().min(1).max(200).optional().describe("stable key for this ONE logical contribution (≤200 chars), e.g. cron-run/work-item + output slot; safe retries return the original contribution. Reusing it with different content is a conflict."),
       summary: exports_external.string().max(500).optional().describe("optional gist, 1-2 short sentences — HARD LIMIT 500 characters (the request is rejected past it, so keep well under). Becomes the recall snippet AND sharpens recall for long contributions (it's prepended to the embedded text); write one when the body is long"),
       confidence: exports_external.number().int().min(0).max(100).optional().describe("optional 0–100 confidence"),
       mentions: exports_external.array(exports_external.object({
@@ -16511,16 +16515,30 @@ var ACTIONS = [
   {
     name: "thread_get",
     title: "Read a thread",
-    description: "Read the full state of the thread you're working in — objective, every contribution + stamp, its OPEN REQUESTS, and its ARTIFACTS (the durable outputs born from this thread). Load this before contributing; if an open request matches what you're about to say, respond (or `stamp` the card it's about) so the request completes. On a LONG thread, page the contributions with contribLimit/contribCursor (follow contributionPage.nextCursor) to bound how much you load at once.",
+    description: "Read the thread you're working in. Default view=full returns objective, every contribution + stamp, OPEN REQUESTS, and ARTIFACTS; page a long transcript with contribLimit/contribCursor. For recurring/automated checks use view=compact: a decision-ready packet with objective/status, distillate, requests, outputs, and the latest contributions. Save its cursor and pass it next time; an unchanged thread returns only {threadId,cursor,unchanged:true}. Load context before contributing; if an open request matches what you're about to say, respond (or `stamp` the card it's about) so the request completes.",
     inputSchema: {
       threadId: exports_external.string().describe("the thread id, e.g. thr_…"),
-      contribLimit: exports_external.number().int().positive().optional().describe("max contributions to return (AD-151 keyset paging) — omit to load the whole thread; set on a long thread to bound context"),
-      contribCursor: exports_external.string().optional().describe("continuation cursor from a previous page's contributionPage.nextCursor")
+      view: exports_external.enum(["full", "compact"]).optional().describe("full (default) = complete transcript; compact = bounded decision-ready context packet for recurring checks"),
+      cursor: exports_external.string().optional().describe("compact reads only: cursor from the previous compact response; if context is unchanged the response collapses to a tiny unchanged envelope"),
+      recentLimit: exports_external.number().int().min(1).max(20).optional().describe("compact reads only: latest contributions to include (default 6, max 20)"),
+      contribLimit: exports_external.number().int().positive().optional().describe("full reads only: max contributions to return (AD-151 keyset paging) — omit to load the whole thread"),
+      contribCursor: exports_external.string().optional().describe("full reads only: continuation cursor from a previous page's contributionPage.nextCursor")
     },
     surfaces: ["mcp", "cli"],
     toolset: "loop",
     run: forward("thread.get")
   },
+  {
+    name: "resolve_references",
+    title: "Resolve reference ids",
+    description: "Resolve Arbor object ids to their display labels — what a reference chip shows.",
+    inputSchema: {
+      ids: exports_external.array(exports_external.string()).describe("object ids to resolve — thr_…/con_…/ini_…/art_… (max 50; others ignored)")
+    },
+    surfaces: ["cli"],
+    toolset: "loop",
+    run: forward("reference.resolve")
+  },
   {
     name: "tree",
     title: "Navigate the workspace tree",

package/package.json

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