@lambdacurry/arbor 0.23.26 → 0.23.28

package/dist/arbor.js

@@ -2,7 +2,7 @@
 // package.json
 var package_default = {
   name: "@lambdacurry/arbor",
-  version: "0.23.26",
+  version: "0.23.28",
   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",
@@ -2232,6 +2232,112 @@ function handleIntersectionResults(result, left, right) {
   result.value = merged.data;
   return result;
 }
+var $ZodTuple = /* @__PURE__ */ $constructor("$ZodTuple", (inst, def) => {
+  $ZodType.init(inst, def);
+  const items = def.items;
+  inst._zod.parse = (payload, ctx) => {
+    const input = payload.value;
+    if (!Array.isArray(input)) {
+      payload.issues.push({
+        input,
+        inst,
+        expected: "tuple",
+        code: "invalid_type"
+      });
+      return payload;
+    }
+    payload.value = [];
+    const proms = [];
+    const optinStart = getTupleOptStart(items, "optin");
+    const optoutStart = getTupleOptStart(items, "optout");
+    if (!def.rest) {
+      if (input.length < optinStart) {
+        payload.issues.push({
+          code: "too_small",
+          minimum: optinStart,
+          inclusive: true,
+          input,
+          inst,
+          origin: "array"
+        });
+        return payload;
+      }
+      if (input.length > items.length) {
+        payload.issues.push({
+          code: "too_big",
+          maximum: items.length,
+          inclusive: true,
+          input,
+          inst,
+          origin: "array"
+        });
+      }
+    }
+    const itemResults = new Array(items.length);
+    for (let i = 0;i < items.length; i++) {
+      const r = items[i]._zod.run({ value: input[i], issues: [] }, ctx);
+      if (r instanceof Promise) {
+        proms.push(r.then((rr) => {
+          itemResults[i] = rr;
+        }));
+      } else {
+        itemResults[i] = r;
+      }
+    }
+    if (def.rest) {
+      let i = items.length - 1;
+      const rest = input.slice(items.length);
+      for (const el of rest) {
+        i++;
+        const result = def.rest._zod.run({ value: el, issues: [] }, ctx);
+        if (result instanceof Promise) {
+          proms.push(result.then((r) => handleTupleResult(r, payload, i)));
+        } else {
+          handleTupleResult(result, payload, i);
+        }
+      }
+    }
+    if (proms.length) {
+      return Promise.all(proms).then(() => handleTupleResults(itemResults, payload, items, input, optoutStart));
+    }
+    return handleTupleResults(itemResults, payload, items, input, optoutStart);
+  };
+});
+function getTupleOptStart(items, key) {
+  for (let i = items.length - 1;i >= 0; i--) {
+    if (items[i]._zod[key] !== "optional")
+      return i + 1;
+  }
+  return 0;
+}
+function handleTupleResult(result, final, index) {
+  if (result.issues.length) {
+    final.issues.push(...prefixIssues(index, result.issues));
+  }
+  final.value[index] = result.value;
+}
+function handleTupleResults(itemResults, final, items, input, optoutStart) {
+  for (let i = 0;i < items.length; i++) {
+    const r = itemResults[i];
+    const isPresent = i < input.length;
+    if (r.issues.length) {
+      if (!isPresent && i >= optoutStart) {
+        final.value.length = i;
+        break;
+      }
+      final.issues.push(...prefixIssues(i, r.issues));
+    }
+    final.value[i] = r.value;
+  }
+  for (let i = final.value.length - 1;i >= input.length; i--) {
+    if (items[i]._zod.optout === "optional" && final.value[i] === undefined) {
+      final.value.length = i;
+    } else {
+      break;
+    }
+  }
+  return final;
+}
 var $ZodRecord = /* @__PURE__ */ $constructor("$ZodRecord", (inst, def) => {
   $ZodType.init(inst, def);
   inst._zod.parse = (payload, ctx) => {
@@ -3875,6 +3981,48 @@ var intersectionProcessor = (schema, ctx, json, params) => {
   ];
   json.allOf = allOf;
 };
+var tupleProcessor = (schema, ctx, _json, params) => {
+  const json = _json;
+  const def = schema._zod.def;
+  json.type = "array";
+  const prefixPath = ctx.target === "draft-2020-12" ? "prefixItems" : "items";
+  const restPath = ctx.target === "draft-2020-12" ? "items" : ctx.target === "openapi-3.0" ? "items" : "additionalItems";
+  const prefixItems = def.items.map((x, i) => process2(x, ctx, {
+    ...params,
+    path: [...params.path, prefixPath, i]
+  }));
+  const rest = def.rest ? process2(def.rest, ctx, {
+    ...params,
+    path: [...params.path, restPath, ...ctx.target === "openapi-3.0" ? [def.items.length] : []]
+  }) : null;
+  if (ctx.target === "draft-2020-12") {
+    json.prefixItems = prefixItems;
+    if (rest) {
+      json.items = rest;
+    }
+  } else if (ctx.target === "openapi-3.0") {
+    json.items = {
+      anyOf: prefixItems
+    };
+    if (rest) {
+      json.items.anyOf.push(rest);
+    }
+    json.minItems = prefixItems.length;
+    if (!rest) {
+      json.maxItems = prefixItems.length;
+    }
+  } else {
+    json.items = prefixItems;
+    if (rest) {
+      json.additionalItems = rest;
+    }
+  }
+  const { minimum, maximum } = schema._zod.bag;
+  if (typeof minimum === "number")
+    json.minItems = minimum;
+  if (typeof maximum === "number")
+    json.maxItems = maximum;
+};
 var recordProcessor = (schema, ctx, _json, params) => {
   const json = _json;
   const def = schema._zod.def;
@@ -4629,6 +4777,26 @@ function intersection(left, right) {
     right
   });
 }
+var ZodTuple = /* @__PURE__ */ $constructor("ZodTuple", (inst, def) => {
+  $ZodTuple.init(inst, def);
+  ZodType.init(inst, def);
+  inst._zod.processJSONSchema = (ctx, json, params) => tupleProcessor(inst, ctx, json, params);
+  inst.rest = (rest) => inst.clone({
+    ...inst._zod.def,
+    rest
+  });
+});
+function tuple(items, _paramsOrRest, _params) {
+  const hasRest = _paramsOrRest instanceof $ZodType;
+  const params = hasRest ? _params : _paramsOrRest;
+  const rest = hasRest ? _paramsOrRest : null;
+  return new ZodTuple({
+    type: "tuple",
+    items,
+    rest,
+    ...normalizeParams(params)
+  });
+}
 var ZodRecord = /* @__PURE__ */ $constructor("ZodRecord", (inst, def) => {
   $ZodRecord.init(inst, def);
   ZodType.init(inst, def);
@@ -6457,12 +6625,13 @@ var workflows = sqliteTable("workflows", {
   name: text("name").notNull(),
   summary: text("summary").notNull(),
   labels: text("labels", { mode: "json" }).$type().notNull(),
+  derivedFromBuiltin: text("derived_from_builtin").$type(),
   createdAt: ts("created_at").notNull(),
   updatedAt: ts("updated_at").notNull()
 }, (t) => ({ orgIdx: index("workflows_org_idx").on(t.orgId) }));
 var spaceWorkflows = sqliteTable("space_workflows", {
   spaceId: text("space_id").notNull().references(() => spaces.id),
-  workflowId: text("workflow_id").notNull().references(() => workflows.id),
+  workflowId: text("workflow_id").notNull(),
   isDefault: integer2("is_default", { mode: "boolean" }).notNull().default(false)
 }, (t) => ({
   pk: primaryKey({ columns: [t.spaceId, t.workflowId] }),
@@ -6476,7 +6645,7 @@ var topics = sqliteTable("topics", {
   purpose: text("purpose"),
   guidance: text("guidance", { mode: "json" }).$type().notNull().default([]),
   contributionLanes: text("contribution_lanes", { mode: "json" }).$type().notNull().default([]),
-  workflowId: text("workflow_id").references(() => workflows.id),
+  workflowId: text("workflow_id"),
   archivedAt: ts("archived_at"),
   createdAt: ts("created_at").notNull()
 }, (t) => ({
@@ -7751,7 +7920,26 @@ var notificationCursors = sqliteTable("notification_cursors", {
 var recallIndex = sqliteTable("recall_index", {
   objectId: text("object_id").primaryKey(),
   indexedAt: ts("indexed_at").notNull(),
-  chunks: integer2("chunks")
+  chunks: integer2("chunks"),
+  pendingToken: text("pending_token"),
+  vectorRevision: text("vector_revision")
+}, (t) => ({ pendingIdx: index("recall_index_pending_idx").on(t.pendingToken) }));
+var recallLifecycleRefreshes = sqliteTable("recall_lifecycle_refreshes", {
+  threadId: text("thread_id").primaryKey().references(() => threads.id, { onDelete: "cascade" }),
+  targetType: text("target_type").$type().notNull(),
+  generation: text("generation").notNull(),
+  cursorType: text("cursor_type").$type(),
+  cursorId: text("cursor_id"),
+  leaseToken: text("lease_token"),
+  leaseUntil: ts("lease_until"),
+  updatedAt: ts("updated_at").notNull()
+}, (t) => ({
+  pendingIdx: index("recall_lifecycle_refreshes_pending_idx").on(t.updatedAt)
+}));
+var recallVectorLeases = sqliteTable("recall_vector_leases", {
+  threadId: text("thread_id").primaryKey().references(() => threads.id, { onDelete: "cascade" }),
+  token: text("token").notNull(),
+  leaseUntil: ts("lease_until").notNull()
 });
 var watches = sqliteTable("watches", {
   id: text("id").primaryKey(),
@@ -7833,6 +8021,7 @@ var BUILTIN_WORKFLOW_IDS = [
   "experiment",
   "funnel"
 ];
+var BUILTIN_WORKFLOW_ID_SET = new Set(BUILTIN_WORKFLOW_IDS);
 var col = (key, name, type, order, extra) => ({ key, name, type, order, ...extra });
 var STANDARD = {
   id: "standard",
@@ -8179,6 +8368,9 @@ var recallFts = sqliteTable("recall_fts", {
   thread: text("thread")
 });
 
+// ../core/src/retrieval/vector-lease.ts
+var LEASE_MS = 5 * 60000;
+
 // ../core/src/retrieval/index-consumer.ts
 var INDEX_ON = new Set([
   "contribution.added",
@@ -8193,6 +8385,9 @@ var INDEX_ON = new Set([
   "contribution.restored"
 ]);
 var PURGE_ON = new Set(["contribution.deleted"]);
+// ../core/src/retrieval/lifecycle-refresh.ts
+var LEASE_MS2 = 2 * 60000;
+var MISSING_VECTOR_GRACE_MS = 5 * 60000;
 // ../actions/src/external-read-defaults.ts
 var EXTERNAL_DEFAULT_PAGE_SIZE = 50;
 var TREE_EXTERNAL_DEFAULT_PAGE_SIZE = 4;
@@ -8734,6 +8929,8 @@ var workflowSummary = looseObject({
   name: string2(),
   summary: string2(),
   origin: string2().optional(),
+  selectedBy: string2().optional(),
+  derivedFromBuiltin: nullableString.optional(),
   isDefault: boolean2().optional(),
   labels: array(jsonObject).optional(),
   createdAt: string2().optional(),
@@ -11082,13 +11279,19 @@ var ACTION_DEFINITIONS = [
   {
     name: "recall",
     title: "Recall existing knowledge",
-    description: "Search Arbor semantically for existing contributions, artifacts, and decisions. Use `tree` for lifecycle/attention routing; once you know the area, pass space/topic/thread to keep recall inside that working set before targeted reads.",
+    description: "Search Arbor semantically for existing contributions, artifacts, and decisions. Use `tree` for lifecycle/attention routing; pass space/topic/thread to narrow the working set, status: current for work awaiting conclusion, or lifecycle types for another slice; omit status for broad prior art.",
     inputSchema: {
       query: string2().min(1).describe("what you want to recall, in natural language"),
       space: string2().optional().describe("optional space id to scope the search"),
       topic: string2().optional().describe("optional topic id to scope the search"),
       thread: string2().optional().describe("optional thread id to scope the search"),
       topK: number2().int().min(1).optional().describe("how many results to return (default 10)"),
+      status: union([
+        literal("current"),
+        _enum(LIFECYCLE_TYPES),
+        tuple([literal("current")]),
+        array(_enum(LIFECYCLE_TYPES)).min(1).max(8)
+      ]).optional().describe("current = active + needs-review + stuck; or one or more protocol lifecycle types. Omit for broad prior art. Explicit status excludes Topic hits; archived includes archived Thread content without includeHistorical."),
       includeHistorical: boolean2().optional().describe("include superseded/archived knowledge (default false)")
     },
     surfaces: ["mcp", "cli"],
@@ -11389,7 +11592,7 @@ var ACTION_DEFINITIONS = [
       spaceId: string2().describe("the space to create the topic in, spc_…"),
       title: string2().min(1).describe("the topic's name — an area of work, not a question"),
       purpose: string2().optional().describe("what this Topic accomplishes and what belongs here, leading with its primary role — Direction, Delivery, Operations, Intake, Coordination, or Learning; name an external or split source of truth or a handoff boundary only when it materially matters"),
-      workflow: string2().optional().describe("catalog id from `space_get.workflows` (pick by summary); must already be attached to this Space")
+      workflow: string2().optional().describe("a workflow id from `space_get.workflows` (pick by summary) — a built-in such as `queue` or a catalog `wfl_…`; must already be attached to this Space")
     },
     surfaces: ["mcp", "cli"],
     toolset: "structure",
@@ -11403,7 +11606,7 @@ var ACTION_DEFINITIONS = [
       topicId: string2().describe("the topic to edit, top_…"),
       title: string2().min(1).optional().describe("a new title — an area of work, not a question"),
       purpose: string2().optional().describe("a new purpose — what this Topic accomplishes and what belongs here, leading with its primary role (Direction, Delivery, Operations, Intake, Coordination, or Learning); name an external or split source of truth or a handoff boundary only when it materially matters"),
-      workflow: string2().nullable().optional().describe("catalog id from `space_get.workflows` (pick by summary); must be attached to the Space; blank or null inherits the Space default")
+      workflow: string2().nullable().optional().describe("a workflow id from `space_get.workflows` (pick by summary) — a built-in such as `queue` or a catalog `wfl_…`; must be attached to the Space; blank or null inherits the Space default")
     },
     surfaces: ["mcp", "cli"],
     toolset: "spaces",
@@ -12631,15 +12834,15 @@ var ACTION_DEFINITIONS = [
   {
     name: "space_update",
     title: "Edit a space's config",
-    description: "Edit a Space's purpose, title, or visibility; org owner/admin or that Space's admin only, and only supplied fields are patched. Use this for factual room metadata, including open/private, or org-admin `--attach-workflow` / `--detach-workflow` / `--default-workflow`; collaboration norms belong in Space guidance.",
+    description: "Edit a Space's purpose, title, visibility, or offered workflows (`--attach-workflow` / `--detach-workflow` / `--default-workflow` take a built-in id like `queue` or a catalog `wfl_…`); org owner/admin or that Space's admin only, patching only supplied fields. Norms belong in Space guidance.",
     inputSchema: {
       spaceId: string2().describe("the space, spc_…"),
       purpose: string2().optional().describe("why this boundary exists and what it is around — commonly a Product/System, Program/Function, Portfolio/Network, or Practice/Community — plus its dominant work modes (Build, Operate, Coordinate, Discuss, Share) when that helps; plain prose, not metadata syntax"),
       title: string2().optional().describe("a new title for the space"),
       visibility: _enum(["open", "private"]).optional().describe("open or private (invite-only)"),
-      attachWorkflow: string2().optional().describe("org-admin: attach this catalog workflow id to the Space allowlist"),
-      detachWorkflow: string2().optional().describe("org-admin: detach this catalog workflow; rejected if a Topic still selects it"),
-      defaultWorkflow: string2().optional().describe("org-admin: name which attached workflow new Topics inherit")
+      attachWorkflow: string2().optional().describe("add a workflow to this Space's list: a built-in id (`standard`, `queue`, `content`, `experiment`, `funnel`) or a catalog `wfl_…` from `workflow_list`"),
+      detachWorkflow: string2().optional().describe("remove a workflow (built-in id or `wfl_…`) from this Space's list; rejected while a Topic still selects it"),
+      defaultWorkflow: string2().optional().describe("name which attached workflow (built-in id or `wfl_…`) new Topics inherit; with none, Standard")
     },
     surfaces: ["mcp", "cli"],
     toolset: "spaces",
@@ -12648,7 +12851,7 @@ var ACTION_DEFINITIONS = [
   {
     name: "workflow_create",
     title: "Create a catalog workflow",
-    description: "Copy a built-in into the org catalog (`--from-builtin`) or author name, summary, and labels. Org-admin; copy-then-edit — the built-in constant is never mutated in place.",
+    description: "Customize a built-in by copying it into the org catalog (`--from-builtin`), or author name, summary, and labels. Org-admin; to use a built-in unchanged, attach it by id with `space_update`.",
     inputSchema: {
       fromBuiltin: _enum(BUILTIN_WORKFLOW_IDS).optional().describe("copy this built-in template into the catalog"),
       name: string2().min(1).optional().describe("catalog name; defaults from the built-in"),
@@ -12676,7 +12879,7 @@ var ACTION_DEFINITIONS = [
   {
     name: "workflow_list",
     title: "List org workflows",
-    description: "List built-in templates and this org's catalog copies, each with its required summary. Org-admin; members read the Space allowlist on `space_get`.",
+    description: "List the built-in workflows (attach by id) and this org's catalog (`wfl_…`), each with its summary and `origin`. Pick one to attach with `space_update`; a Space's own list is on `space_get`.",
     inputSchema: {},
     surfaces: ["mcp", "cli"],
     toolset: "structure",

package/package.json

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