@axiom-lattice/core 4.2.9 → 4.2.11

package/dist/index.mjs

@@ -2763,6 +2763,40 @@ function validDate2(value) {
   }
 }
 
+// src/store_lattice/InMemoryUserPushSubscriptionStore.ts
+var InMemoryUserPushSubscriptionStore = class {
+  constructor() {
+    this.entries = /* @__PURE__ */ new Map();
+  }
+  /** Lists defensive copies of every subscription for a user. */
+  async list(tenantId2, userId) {
+    return [...this.entries.values()].filter((entry) => entry.tenantId === tenantId2 && entry.userId === userId).map((entry) => structuredClone(entry));
+  }
+  /** Saves (upserts) a subscription keyed by tenant + user + endpoint. */
+  async save(input) {
+    const key5 = entryKey(input.tenantId, input.userId, input.endpoint);
+    const existing = this.entries.get(key5);
+    const next = {
+      id: existing?.id ?? crypto.randomUUID(),
+      tenantId: input.tenantId,
+      userId: input.userId,
+      endpoint: input.endpoint,
+      keys: { p256dh: input.keys.p256dh, auth: input.keys.auth },
+      ...input.userAgent === void 0 ? {} : { userAgent: input.userAgent },
+      createdAt: existing?.createdAt ?? (/* @__PURE__ */ new Date()).toISOString()
+    };
+    this.entries.set(key5, next);
+    return structuredClone(next);
+  }
+  /** Deletes a subscription by endpoint. Returns whether a row was removed. */
+  async delete(tenantId2, userId, endpoint) {
+    return this.entries.delete(entryKey(tenantId2, userId, endpoint));
+  }
+};
+function entryKey(tenantId2, userId, endpoint) {
+  return JSON.stringify([tenantId2, userId, endpoint]);
+}
+
 // src/store_lattice/InMemoryUserStore.ts
 var InMemoryUserStore = class {
   constructor() {
@@ -4392,6 +4426,7 @@ var defaultProjectMembershipStore = new InMemoryProjectMembershipStore(defaultPr
 var defaultProjectBotMembershipStore = new InMemoryProjectBotMembershipStore(defaultProjectRoomCoordinator);
 var defaultProjectRoomMessageStore = new InMemoryProjectRoomMessageStore(defaultProjectRoomCoordinator);
 var defaultProjectRoomReadStateStore = new InMemoryProjectRoomReadStateStore();
+var defaultUserPushSubscriptionStore = new InMemoryUserPushSubscriptionStore();
 storeLatticeManager.registerLattice("default", "thread", defaultThreadStore);
 storeLatticeManager.registerLattice(
   "default",
@@ -4411,6 +4446,7 @@ storeLatticeManager.registerLattice("default", "projectMembership", defaultProje
 storeLatticeManager.registerLattice("default", "projectBotMembership", defaultProjectBotMembershipStore);
 storeLatticeManager.registerLattice("default", "projectRoomMessage", defaultProjectRoomMessageStore);
 storeLatticeManager.registerLattice("default", "projectRoomReadState", defaultProjectRoomReadStateStore);
+storeLatticeManager.registerLattice("default", "userPushSubscription", defaultUserPushSubscriptionStore);
 var defaultUserStore = new InMemoryUserStore();
 var defaultTenantStore = new InMemoryTenantStore();
 var defaultUserTenantLinkStore = new InMemoryUserTenantLinkStore();
@@ -13549,7 +13585,7 @@ function hasExplicitAllowedTools(policy) {
   return Object.prototype.hasOwnProperty.call(policy, "allowedTools");
 }
 function hasActiveRuntimePolicy(runtime) {
-  return runtime.revision.trim().length > 0 || Object.keys(runtime.middleware).length > 0;
+  return Object.keys(runtime.middleware).length > 0;
 }
 function tenantIdFromRequest(request) {
   if (!isRecord8(request) || !isRecord8(request.runtime)) return void 0;
@@ -14719,6 +14755,17 @@ var ChunkBuffer = class {
 
 // src/chunk_buffer_lattice/InMemoryChunkBuffer.ts
 import { MessageChunkTypes } from "@axiom-lattice/protocols";
+
+// src/chunk_buffer_lattice/types.ts
+var ThreadEndError = class extends Error {
+  constructor(message, code) {
+    super(message);
+    this.name = "ThreadEndError";
+    this.code = code;
+  }
+};
+
+// src/chunk_buffer_lattice/InMemoryChunkBuffer.ts
 import {
   ReplaySubject,
   observeOn,
@@ -14836,12 +14883,12 @@ var InMemoryChunkBuffer = class extends ChunkBuffer {
       buffer2.chunks$.complete();
     }
   }
-  async abortThread(threadId) {
+  async abortThread(threadId, message, code = "aborted") {
     const buffer2 = this.getBufferIfValid(threadId);
     if (buffer2) {
       buffer2.status = "aborted" /* ABORTED */;
       buffer2.updatedAt = Date.now();
-      buffer2.chunks$.error(new Error("Thread aborted"));
+      buffer2.chunks$.error(new ThreadEndError(message ?? "Thread aborted", code));
     }
   }
   async isThreadActive(threadId) {
@@ -15793,6 +15840,17 @@ var CapabilityBundleMerger = class {
 };
 
 // src/capability/CapabilityRuntimeResolver.ts
+var EMPTY_CAPABILITY_RUNTIME_REVISION = createCapabilityRevision([], {});
+function emptyCapabilityRuntime(expectedRevision) {
+  if (expectedRevision !== void 0 && expectedRevision !== "" && expectedRevision !== EMPTY_CAPABILITY_RUNTIME_REVISION) {
+    throw new CapabilityRuntimeResolutionError(
+      "CAPABILITY_RUNTIME_REVISION_MISMATCH",
+      "Capability runtime revision no longer matches the checkpoint",
+      { expectedRevision, actualRevision: EMPTY_CAPABILITY_RUNTIME_REVISION }
+    );
+  }
+  return { revision: EMPTY_CAPABILITY_RUNTIME_REVISION, middleware: {} };
+}
 var CapabilityRuntimeResolutionError = class extends Error {
   /**
    * Creates a runtime resolution error.
@@ -15973,14 +16031,7 @@ var CapabilityRuntimeResolver = class {
     };
   }
   emptyRuntime(expectedRevision) {
-    if (expectedRevision) {
-      throw new CapabilityRuntimeResolutionError(
-        "CAPABILITY_RUNTIME_REVISION_MISMATCH",
-        "Capability runtime revision no longer matches the checkpoint",
-        { expectedRevision, actualRevision: "" }
-      );
-    }
-    return { revision: "", middleware: {} };
+    return emptyCapabilityRuntime(expectedRevision);
   }
 };
 
@@ -16219,6 +16270,10 @@ function requireTrustedCapabilityRevision(value) {
   }
   return value;
 }
+function trustedCapabilityRevision(value) {
+  if (value === "") return void 0;
+  return requireTrustedCapabilityRevision(value);
+}
 function finalAiMessageMarker(state) {
   if (!isPlainRecord(state) || !isPlainRecord(state.values) || !Array.isArray(state.values.messages)) {
     return void 0;
@@ -16434,7 +16489,9 @@ var Agent = class {
           throw error;
         }
       } catch (error) {
-        await this.chunkBuffer.abortThread(this.thread_id);
+        const endCode = signal?.aborted ? "aborted" : "stream_error";
+        const endMessage = endCode === "stream_error" ? error instanceof Error ? error.message : "Stream processing error" : "Thread aborted";
+        await this.chunkBuffer.abortThread(this.thread_id, endMessage, endCode);
         throw error;
       }
     };
@@ -16493,7 +16550,7 @@ var Agent = class {
             const interruptedExecutionContext = commandRunStatus === "interrupted" /* INTERRUPTED */ ? this.processingExecutionContext(interruptedMessages, true) : void 0;
             const interruptedConfig = interruptedExecutionContext?.customRunConfig;
             const queuedCapabilityRevision = typeof interruptedConfig === "object" && interruptedConfig !== null ? interruptedConfig.capabilityRuntimeRevision : void 0;
-            const expectedCapabilityRevision = interruptedExecutionContext?.trustedRunContext !== void 0 ? requireTrustedCapabilityRevision(queuedCapabilityRevision) : typeof queuedCapabilityRevision === "string" ? queuedCapabilityRevision : void 0;
+            const expectedCapabilityRevision = interruptedExecutionContext?.trustedRunContext !== void 0 ? trustedCapabilityRevision(queuedCapabilityRevision) : typeof queuedCapabilityRevision === "string" ? queuedCapabilityRevision : void 0;
             try {
               const preRunMarker = finalAiMessageMarker(preRunState);
               await this.agentStreamExecutor({
@@ -16859,7 +16916,8 @@ var Agent = class {
         consumedInputMessageIds: rows.map(({ id }) => id)
       };
     }
-    if (rows.length !== 1 || markedRows.length !== 1) {
+    const unmarkedCommandRows = rows.filter((row2) => row2.trusted_run_context === void 0 && row2.execution_mode === void 0 && row2.command !== void 0);
+    if (markedRows.length !== 1 || markedRows.length + unmarkedCommandRows.length !== rows.length) {
       throw new TrustedRunContextRecoveryError("Trusted processing rows are inconsistent");
     }
     const row = markedRows[0];
@@ -17018,14 +17076,7 @@ var Agent = class {
     });
     let capabilityRuntime;
     if (this.queue_project_id === null) {
-      if (expectedRevision) {
-        throw new CapabilityRuntimeResolutionError(
-          "CAPABILITY_RUNTIME_REVISION_MISMATCH",
-          "Capability runtime revision no longer matches the checkpoint",
-          { expectedRevision, actualRevision: "" }
-        );
-      }
-      capabilityRuntime = { revision: "", middleware: {} };
+      capabilityRuntime = emptyCapabilityRuntime(expectedRevision);
     } else {
       capabilityRuntime = await resolver.resolve({
         tenantId: this.tenant_id,
@@ -17156,7 +17207,7 @@ var Agent = class {
     const persistedConfig = recoveryContext?.customRunConfig;
     const queuedRevision = typeof persistedConfig === "object" && persistedConfig !== null ? persistedConfig.capabilityRuntimeRevision : void 0;
     if (recoveryContext?.trustedRunContext !== void 0) {
-      return requireTrustedCapabilityRevision(queuedRevision);
+      return trustedCapabilityRevision(queuedRevision);
     }
     const persistedRevision = typeof queuedRevision === "string" && queuedRevision.length > 0 ? queuedRevision : void 0;
     if (persistedRevision !== void 0 && recoveryContext.checkpointCapabilityRevision !== void 0 && persistedRevision !== recoveryContext.checkpointCapabilityRevision) {
@@ -17175,7 +17226,7 @@ var Agent = class {
     const emittedToolCallIds = /* @__PURE__ */ new Set();
     for await (const chunk of agentStream) {
       if (signal?.aborted) {
-        await this.chunkBuffer.abortThread(this.thread_id);
+        await this.chunkBuffer.abortThread(this.thread_id, "Thread aborted", "aborted");
         throw new Error("Agent execution was aborted");
       }
       let data;
@@ -17293,6 +17344,7 @@ var Agent = class {
       this.abortController.abort();
       this.abortController = null;
     }
+    void this.chunkBuffer.abortThread(this.thread_id, "Thread superseded", "superseded");
   }
   /**
    * Enqueue a message for this thread.
@@ -17675,16 +17727,18 @@ var Agent = class {
     }
     if (runStatus === "busy" /* BUSY */) {
       this.abortController = new AbortController();
+      const resumeSignal = this.abortController.signal;
       try {
         const executionContext = this.processingExecutionContext(processingMessages, true);
         const customRunConfig = executionContext.customRunConfig;
-        if (typeof customRunConfig.capabilityRuntimeRevision !== "string" || executionContext.trustedRunContext !== void 0 && customRunConfig.capabilityRuntimeRevision.length === 0) {
+        if (typeof customRunConfig.capabilityRuntimeRevision !== "string") {
           throw new Error("Capability runtime revision is missing from the checkpoint message");
         }
+        const resumeRunConfig = executionContext.trustedRunContext !== void 0 && customRunConfig.capabilityRuntimeRevision === "" ? { ...customRunConfig, capabilityRuntimeRevision: void 0 } : customRunConfig;
         await this.resumeGraphFromCheckpoint(
-          customRunConfig,
+          resumeRunConfig,
           executionContext.trustedRunContext,
-          this.abortController.signal
+          resumeSignal
         );
         const state = await this.getCurrentState();
         const resumedStatus = await this.getRunStatus(state);
@@ -17728,7 +17782,12 @@ var Agent = class {
         };
       } catch (error) {
         console.error(`[Agent] Failed to resume graph for thread ${this.thread_id}:`, error);
-        await this.chunkBuffer.abortThread(this.thread_id);
+        const endCode = resumeSignal.aborted ? "aborted" : "stream_error";
+        await this.chunkBuffer.abortThread(
+          this.thread_id,
+          endCode === "aborted" ? "Thread aborted" : error instanceof Error ? error.message : "Resume failed",
+          endCode
+        );
         throw error;
       } finally {
         this.abortController = null;
@@ -17778,7 +17837,7 @@ var Agent = class {
       this.abortController.abort();
       this.abortController = null;
     }
-    await this.chunkBuffer.abortThread(this.thread_id);
+    await this.chunkBuffer.abortThread(this.thread_id, "Thread aborted", "aborted");
     const store = this.getQueueStore();
     await store.clearMessages(this.thread_id, this.queueScope());
   }
@@ -25761,6 +25820,13 @@ When a bot is @mentioned, that bot answers; you stay silent unless asked.
 - Someone @mentions a bot \u2192 let that bot respond. Only correct or summarize when the bot fails or the user asks you.
 - @team mention \u2192 treat as addressed to you; you may summarize and optionally propose task work.
 
+## Clarifying questions
+When you need more information before acting, ask the user directly in your room
+reply text and then stop. Do NOT use HITL/approval tools such as
+\`ask_user_to_clarify\`: project rooms are asynchronous and have no interactive
+approval UI, so an interrupt would stall the room with no visible prompt. The
+user's next room message continues the conversation.
+
 ## Task policy
 - Turn actionable, verifiable room requests into persistent Project Tasks (task middleware), UNLESS they are simple, immediate, single-response work handled conversationally per the Delegation decision below.
 - A task must have an owner. Prefer assigning to a room bot via Project Task assignment.
@@ -28453,14 +28519,6 @@ var roomCoordinatorConfig = {
       enabled: true,
       config: { readAll: true }
     },
-    {
-      id: "ask_user_to_clarify",
-      type: "ask_user_to_clarify",
-      name: "Ask User",
-      description: "Wait for user input at approval gates",
-      enabled: true,
-      config: {}
-    },
     {
       id: "project_room",
       type: "project_room",
@@ -33926,6 +33984,7 @@ var INPUT_KEYS = [
   "idempotencyKey"
 ];
 var REPLY_INPUT_KEYS = ["tenantId", "membershipId", "text", "sourceRoomMessageId", "inputMessageId", "sourceId", "idempotencyKey"];
+var INTERRUPT_INPUT_KEYS = ["tenantId", "membershipId", "text", "sourceRoomMessageId", "inputMessageId"];
 var RoomAgentMessageService = class {
   /**
    * Creates a room writer over the durable membership and message stores.
@@ -33958,6 +34017,21 @@ var RoomAgentMessageService = class {
     }
     return this.persistDerived(snapshot);
   }
+  /**
+   * Persists a pending HITL interrupt (question/notice) as an Agent-authored room message.
+   *
+   * @param input Exact correlation IDs, target membership, and question text.
+   * @returns A deep clone of the canonical idempotent room message.
+   */
+  postInterrupt(input) {
+    const snapshot = exactStringRecord(input, INTERRUPT_INPUT_KEYS, "Invalid project room interrupt input");
+    const sourceId = `interrupt:${snapshot.inputMessageId}`;
+    return this.persistDerived({
+      ...snapshot,
+      sourceId,
+      idempotencyKey: `room-interrupt:${snapshot.sourceRoomMessageId}:${snapshot.membershipId}:${sourceId}`
+    });
+  }
   async persistDerived(input) {
     const source = snapshotSource(await this.deps.messages.findById(input.tenantId, input.sourceRoomMessageId));
     if (!source || source.id !== input.sourceRoomMessageId || source.tenantId !== input.tenantId) throw new Error("Invalid project room message");
@@ -34036,24 +34110,37 @@ function date(value) {
 }
 function snapshotSource(value) {
   const values = exactValues(value, ["id", "tenantId", "workspaceId", "projectId", "roomId", "author", "content", "mentions", "source", "createdAt"], ["replyToMessageId", "sourceId", "idempotencyKey"]);
-  const author = exactValues(values?.author, ["type", "userId"]);
+  const author = snapshotSourceAuthor(values?.author);
   const content = exactValues(values?.content, ["type", "text"]);
   const createdAt = date(values?.createdAt);
   const mentions = snapshotMentions(values?.mentions);
-  if (!values || values.source !== "user" || author?.type !== "human" || typeof author.userId !== "string" || !author.userId || content?.type !== "text" || typeof content.text !== "string" || !mentions || !createdAt || ["id", "tenantId", "workspaceId", "projectId", "roomId"].some((key5) => typeof values[key5] !== "string" || !values[key5])) return void 0;
+  if (!values || !author || !sourceOriginMatches(author, values.source) || content?.type !== "text" || typeof content.text !== "string" || !mentions || !createdAt || ["id", "tenantId", "workspaceId", "projectId", "roomId"].some((key5) => typeof values[key5] !== "string" || !values[key5])) return void 0;
   return {
     id: values.id,
     tenantId: values.tenantId,
     workspaceId: values.workspaceId,
     projectId: values.projectId,
     roomId: values.roomId,
-    author: { type: "human", userId: author.userId },
+    author,
     content: { type: "text", text: content.text },
     mentions,
-    source: "user",
+    source: values.source,
     createdAt
   };
 }
+function snapshotSourceAuthor(value) {
+  const human = exactValues(value, ["type", "userId"]);
+  if (human?.type === "human" && typeof human.userId === "string" && human.userId.length > 0) {
+    return { type: "human", userId: human.userId };
+  }
+  const system = exactValues(value, ["type"]);
+  return system?.type === "system" ? { type: "system" } : void 0;
+}
+function sourceOriginMatches(author, source) {
+  if (author.type === "human") return source === "user";
+  if (author.type === "system") return source === "task";
+  return false;
+}
 function snapshotMentions(value) {
   const rows = snapshotExactArray(value);
   if (!rows) return void 0;
@@ -39681,6 +39768,17 @@ function createAskUserToClarifyTool() {
 }
 
 // src/middlewares/askUserClarifyMiddleware.ts
+function isRecord9(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isProjectRoomRun(request) {
+  if (!isRecord9(request) || !isRecord9(request.runtime)) return false;
+  const runtime = request.runtime;
+  const configurable = isRecord9(runtime.configurable) ? runtime.configurable.runConfig : void 0;
+  const context = isRecord9(runtime.context) ? runtime.context.runConfig : void 0;
+  const runConfig = isRecord9(configurable) ? configurable : isRecord9(context) ? context : void 0;
+  return isRecord9(runConfig?.projectRoom);
+}
 function createAskUserClarifyMiddleware() {
   return createMiddleware22({
     name: "AskUserClarifyMiddleware",
@@ -39691,6 +39789,13 @@ function createAskUserClarifyMiddleware() {
       if (toolName2 !== "ask_user_to_clarify") {
         return handler(request);
       }
+      if (isProjectRoomRun(request)) {
+        return new ToolMessage10({
+          content: "You are replying inside a project room, which has no interactive clarification UI. Ask your clarifying questions directly in your reply text and stop; the user's next room message will continue the conversation.",
+          tool_call_id: toolCall?.id,
+          name: toolName2
+        });
+      }
       const parsed = inputSchema.safeParse(toolCall?.args);
       if (!parsed.success) {
         return new ToolMessage10({
@@ -41756,12 +41861,20 @@ function createTaskMiddleware(options = {}) {
             sourceId: trustedProject?.projectRoom?.sourceRoomMessageId ?? trustedProject?.projectTask?.inputMessageId ?? input.sourceId,
             context: trustedProject?.projectTask ? {
               ...trustedSharedContext(input.context),
-              source: "project_task"
+              source: "project_task",
+              created_by: {
+                assistantId: trustedProject.projectTask.assistantId,
+                membershipId: trustedProject.projectTask.membershipId
+              }
             } : trustedProject?.projectRoom ? {
               ...trustedSharedContext(input.context),
               source: "project_room",
               room_id: trustedProject.projectRoom.roomId,
-              source_message_id: trustedProject.projectRoom.sourceRoomMessageId
+              source_message_id: trustedProject.projectRoom.sourceRoomMessageId,
+              created_by: {
+                assistantId: trustedProject.projectRoom.assistantId,
+                membershipId: trustedProject.projectRoom.membershipId
+              }
             } : input.context,
             requireReview: input.requireReview,
             dependencies: input.dependencies,
@@ -42584,6 +42697,15 @@ function createTaskMiddleware(options = {}) {
           if (!needsReview) {
             const callerError2 = await revalidateCaller();
             if (callerError2) return callerError2;
+            if (existing.status === "interrupted" && !reviewInterruption(existing)) {
+              const resumed = await lifecycle.resumeInterruption({
+                tenantId: tenantId2,
+                taskId: input.id,
+                actor,
+                threadId: statusThreadId
+              });
+              if (!resumed.success) return lifecycleMutationResponse(resumed);
+            }
             const result = existing.status === "completed" ? await lifecycle.repairCompletion(completionInput) : await lifecycle.completeAgentTask(completionInput);
             return lifecycleMutationResponse(result);
           }
@@ -45358,6 +45480,7 @@ export {
   InMemoryTenantStore,
   InMemoryThreadMessageQueueStore,
   InMemoryThreadStore,
+  InMemoryUserPushSubscriptionStore,
   InMemoryUserStore,
   InMemoryUserTenantLinkStore,
   LINE_NUMBER_WIDTH,
@@ -45399,6 +45522,7 @@ export {
   Protocols,
   QueueLatticeManager,
   QueueMode,
+  ROOM_COORDINATOR_KEY,
   RemoteSandboxInstance,
   RemoteSandboxProvider,
   RoomAgentMessageService,
@@ -45427,6 +45551,7 @@ export {
   TaskStatus,
   TeamAgentGraphBuilder,
   TenantPluginCatalog,
+  ThreadEndError,
   ThreadStatus2 as ThreadStatus,
   TokenCache,
   ToolLatticeManager,
@@ -45624,6 +45749,7 @@ export {
   resolvePath,
   resolveSandboxPluginConnections,
   resolveTenantPluginSkill,
+  roomCoordinatorConfig,
   runRemotePackDirectory,
   safeTaskResponseId,
   sandboxLatticeManager,