@axiom-lattice/gateway 4.6.1 → 4.7.0

package/dist/index.mjs

@@ -14,6 +14,19 @@ import "./chunk-WKNZ7GBC.mjs";
 import {
   CollectionService
 } from "./chunk-PWHUWFXL.mjs";
+import {
+  createOrphanRecoveryRuntime,
+  isProjectLifecycleTask,
+  isRosterExemptProject,
+  recoverTask,
+  recoverTopCaller,
+  resolveTaskOwnerMembership,
+  resolveTopCaller,
+  runOrphanRecovery
+} from "./chunk-KDQKTU3N.mjs";
+import {
+  createRecoveryCallerDeps
+} from "./chunk-NOXGKYUV.mjs";
 import {
   Logger,
   getQrCode,
@@ -710,7 +723,7 @@ var getAgentGraph = async (request, reply) => {
   try {
     const { assistantId } = request.params;
     const tenant_id = getTenantId(request);
-    const agent = agentInstanceManager.getAgent({ assistant_id: assistantId, tenant_id, thread_id: "" });
+    const agent = agentInstanceManager.getAgentForRead({ assistant_id: assistantId, tenant_id, thread_id: "" });
     const imageData = await agent.get_draw_graph();
     reply.header("Content-Type", "application/json").send({
       image: imageData
@@ -849,6 +862,21 @@ import {
 } from "@axiom-lattice/core";
 import { MessageChunkTypes } from "@axiom-lattice/protocols";
 
+// src/utils/agentScope.ts
+function headerValue(value) {
+  if (Array.isArray(value)) return value[0];
+  return value;
+}
+function resolveAgentScope(request) {
+  const workspace = headerValue(request.headers["x-workspace-id"]);
+  const project = headerValue(request.headers["x-project-id"]);
+  return {
+    tenant_id: headerValue(request.headers["x-tenant-id"]),
+    workspace_id: workspace || "default",
+    project_id: project || void 0
+  };
+}
+
 // src/services/agents/ScopedAgentExecution.ts
 async function executeScopedAgentMessage(agent, request, stopTypes, options) {
   const { messageId } = options === void 0 ? await agent.addMessage(request) : await agent.addMessage(request, options.queueMode);
@@ -950,9 +978,7 @@ var createRun = async (request, reply) => {
       mode,
       ...input
     } = request.body;
-    const tenant_id = request.headers["x-tenant-id"];
-    const workspace_id = request.headers["x-workspace-id"];
-    const project_id = request.headers["x-project-id"];
+    const { tenant_id, workspace_id, project_id } = resolveAgentScope(request);
     const x_request_id = request.headers["x-request-id"] || v4();
     const user_id = getUserId2(request);
     const mergedConfig = {
@@ -1051,9 +1077,7 @@ var createRun = async (request, reply) => {
 var resumeStream = async (request, reply) => {
   try {
     const { thread_id, message_id, assistant_id, known_content, poll_interval } = request.body;
-    const tenant_id = request.headers["x-tenant-id"];
-    const workspace_id = request.headers["x-workspace-id"];
-    const project_id = request.headers["x-project-id"];
+    const { tenant_id, workspace_id, project_id } = resolveAgentScope(request);
     if (!thread_id || !message_id || !assistant_id || known_content === void 0) {
       reply.status(400).send({
         success: false,
@@ -1111,9 +1135,7 @@ var resumeStream = async (request, reply) => {
 var abortRun = async (request, reply) => {
   try {
     const { assistantId, threadId } = request.params;
-    const tenant_id = request.headers["x-tenant-id"];
-    const workspace_id = request.headers["x-workspace-id"] || "default";
-    const project_id = request.headers["x-project-id"] || "default";
+    const { tenant_id, workspace_id, project_id } = resolveAgentScope(request);
     const agent = agentInstanceManager2.getAgent({
       assistant_id: assistantId,
       thread_id: threadId,
@@ -1136,9 +1158,7 @@ var abortRun = async (request, reply) => {
 var recoverRun = async (request, reply) => {
   try {
     const { assistantId, threadId } = request.params;
-    const tenant_id = request.headers["x-tenant-id"];
-    const workspace_id = request.headers["x-workspace-id"] || "default";
-    const project_id = request.headers["x-project-id"];
+    const { tenant_id, workspace_id, project_id } = resolveAgentScope(request);
     const agent = agentInstanceManager2.getAgent({
       assistant_id: assistantId,
       thread_id: threadId,
@@ -1226,7 +1246,7 @@ var getAllMemoryItems = async (request, reply) => {
       });
       return;
     }
-    const agent = agentInstanceManager3.getAgent({ assistant_id: assistantId, tenant_id, thread_id });
+    const agent = agentInstanceManager3.getAgentForRead({ assistant_id: assistantId, tenant_id, thread_id });
     const result = await agent.getCurrentMessages();
     if (!result) {
       reply.status(500).send(result);
@@ -1258,7 +1278,7 @@ var getAgentState = async (request, reply) => {
       return;
     }
     const tenant_id = request.headers["x-tenant-id"];
-    const agent = agentInstanceManager3.getAgent({ assistant_id: assistantId, tenant_id, thread_id });
+    const agent = agentInstanceManager3.getAgentForRead({ assistant_id: assistantId, tenant_id, thread_id });
     const result = await agent.getCurrentState();
     const pendingMessages = await agent.getPendingMessages();
     if (!result) {
@@ -3079,7 +3099,7 @@ async function getInboxItems(request, reply) {
           store.getRunSteps(r.id).catch(() => []),
           (async () => {
             try {
-              return agentInstanceManager4.getAgent({
+              return agentInstanceManager4.getAgentForRead({
                 assistant_id: r.assistantId,
                 thread_id: r.threadId,
                 tenant_id: r.tenantId
@@ -10331,7 +10351,7 @@ function verifyLarkParsedBody(body, config) {
   }
   return extractVerificationToken(body) === config.verificationToken;
 }
-function headerValue(request, name) {
+function headerValue2(request, name) {
   const value = request.headers[name];
   return Array.isArray(value) ? value[0] : value;
 }
@@ -10339,9 +10359,9 @@ function verifyLarkRequestSignature(request, config) {
   if (!config.encryptKey) {
     return true;
   }
-  const timestamp = headerValue(request, "x-lark-request-timestamp");
-  const nonce = headerValue(request, "x-lark-request-nonce");
-  const signature = headerValue(request, "x-lark-signature");
+  const timestamp = headerValue2(request, "x-lark-request-timestamp");
+  const nonce = headerValue2(request, "x-lark-request-nonce");
+  const signature = headerValue2(request, "x-lark-signature");
   if (!timestamp || !nonce || !signature) {
     return false;
   }
@@ -11975,39 +11995,6 @@ function isTaskFileRef(value) {
   return !!row && typeof row.uri === "string" && !!row.uri && (row.name === void 0 || typeof row.name === "string") && (row.mimeType === void 0 || typeof row.mimeType === "string") && (row.addedBy === void 0 || row.addedBy === "user" || row.addedBy === "agent");
 }
 
-// src/services/collaboration/projectTaskScope.ts
-function isProjectLifecycleTask(task) {
-  const source = task.context?.source;
-  return typeof task.workspaceId === "string" && task.workspaceId.length > 0 && typeof task.projectId === "string" && task.projectId.length > 0 && (source === "project_room" || source === "project_task" || source === "user");
-}
-function isRosterExemptProject(project) {
-  return project?.kind === "public";
-}
-function resolveTaskOwnerMembership(task, project, room, membership) {
-  const active = membership && membership.status === "active" && membership.tenantId === task.tenantId && membership.workspaceId === task.workspaceId && membership.projectId === task.projectId && membership.assistantId === task.ownerId && membership.roomId === room.id;
-  if (active) return membership;
-  if (!isRosterExemptProject(project)) return void 0;
-  return syntheticPublicProjectOwnerMembership(task, room);
-}
-function syntheticPublicProjectOwnerMembership(task, room) {
-  const threadId = typeof task.context?.thread_id === "string" && task.context.thread_id.length > 0 ? task.context.thread_id : task.ownerId;
-  return {
-    id: `public-project-owner:${task.projectId}:${task.ownerId}`,
-    tenantId: task.tenantId,
-    workspaceId: task.workspaceId,
-    projectId: task.projectId,
-    roomId: room.id,
-    assistantId: task.ownerId,
-    role: "specialist",
-    title: task.ownerId,
-    mentionName: task.ownerId,
-    status: "active",
-    roomThreadId: threadId,
-    joinedAt: task.createdAt,
-    updatedAt: task.updatedAt
-  };
-}
-
 // src/services/collaboration/ProjectTaskThreadService.ts
 var ProjectTaskThreadError = class extends Error {
   /**
@@ -19470,7 +19457,7 @@ var ProjectTaskObserver = class {
         try {
           await this.requireActiveOwner(task);
         } catch (error) {
-          await this.convergeInterrupted(task, `No active executor: ${errorMessage3(error)}`);
+          await this.convergeFailed(task, `No active executor: ${errorMessage3(error)}`);
           return;
         }
       }
@@ -19569,7 +19556,7 @@ var ProjectTaskObserver = class {
         const classification = await this.deps.execution.classifyRecovery(current, ensured.thread);
         if (signal?.aborted || this.disposed) return;
         if (classification.kind === "invalid") {
-          await this.convergeInterrupted(
+          await this.convergeFailed(
             current,
             `Task execution state is not recoverable: ${classification.reason}`
           );
@@ -19836,25 +19823,26 @@ var ProjectTaskObserver = class {
     }
   }
   /**
-   * Converges an unexecutable task to a durable interruption.
+   * Converges a mechanically unexecutable task to a durable failure.
    *
    * @param task Exact task snapshot that cannot make progress through automation.
-   * @param summary Human-readable reason recorded with the interruption.
+   * @param failureReason Human-readable reason recorded with the failure.
    * @remarks Never leaves a task silently pending behind a warning; an `in_progress`
    * task with no dispatched queue rows is intentionally left untouched by recovery.
-   * The interruption is visible and resumable once an executor is available.
+   * A no-executor/unrecoverable state is a mechanical failure (`failed`), not HITL
+   * (ADR-143); `failed` remains retryable.
    */
-  async convergeInterrupted(task, summary) {
+  async convergeFailed(task, failureReason) {
     if (this.disposed) return;
     try {
       const result = await this.runBridge.settleRun({
         tenantId: task.tenantId,
         task,
         actor: SYSTEM_ACTOR2,
-        outcome: { kind: "interrupted", summary }
+        outcome: { kind: "failed", lifecycleHandled: false, error: failureReason }
       });
       if (!result.success && result.code !== "TASK_STATUS_CONFLICT") {
-        await this.safeWarning(task, "converge", `${result.code ?? "LIFECYCLE_REJECTED"}: ${result.error ?? summary}`);
+        await this.safeWarning(task, "converge", `${result.code ?? "LIFECYCLE_REJECTED"}: ${result.error ?? failureReason}`);
       }
     } catch (error) {
       await this.safeWarning(task, "converge", error);
@@ -22462,7 +22450,7 @@ var registerLatticeRoutes = (app2, channelDeps, options = {}) => {
         label: (key) => key
       },
       messageReader: {
-        getCurrentMessages: ({ tenantId, assistantId, threadId, workspaceId, projectId }) => agentInstanceManager6.getAgent({
+        getCurrentMessages: ({ tenantId, assistantId, threadId, workspaceId, projectId }) => agentInstanceManager6.getAgentForRead({
           tenant_id: tenantId,
           assistant_id: assistantId,
           thread_id: threadId,
@@ -24508,6 +24496,7 @@ var configureSwagger = async (app2, customSwaggerConfig, customSwaggerUiConfig)
 // src/services/agent_task_consumer.ts
 import { randomUUID as randomUUID26 } from "crypto";
 import { eventBus as eventBus3, AGENT_TASK_EVENT, agentInstanceManager as agentInstanceManager7, QueueMode as QueueMode2 } from "@axiom-lattice/core";
+import { resolveRunScope } from "@axiom-lattice/protocols";
 var handleAgentTask = async (taskRequest, retryCount = 0) => {
   const {
     assistant_id,
@@ -24525,7 +24514,8 @@ var handleAgentTask = async (taskRequest, retryCount = 0) => {
     console.log(
       `\u5F00\u59CB\u5904\u7406\u4EFB\u52A1 [assistant_id: ${assistant_id}, thread_id: ${thread_id}]`
     );
-    const agent = agentInstanceManager7.getAgent({ assistant_id, thread_id, tenant_id, workspace_id: runConfig?.workspaceId, project_id: runConfig?.projectId, custom_run_config: runConfig });
+    const scope = resolveRunScope(runConfig);
+    const agent = agentInstanceManager7.getAgent({ assistant_id, thread_id, tenant_id, workspace_id: scope.workspaceId, project_id: scope.projectId, custom_run_config: runConfig });
     if (callback_event) {
       const callbackEvent = callback_event;
       const messageId = typeof input?.id === "string" && input.id !== "" ? input.id : randomUUID26();
@@ -24556,8 +24546,8 @@ var handleAgentTask = async (taskRequest, retryCount = 0) => {
                 assistant_id: main_assistant_id ?? assistant_id,
                 thread_id: main_thread_id,
                 tenant_id: main_tenant_id,
-                workspace_id: runConfig?.workspaceId,
-                project_id: runConfig?.projectId
+                workspace_id: scope.workspaceId,
+                project_id: scope.projectId
               });
               if (mainAgent) {
                 const messages = evt.state?.values?.messages;
@@ -25744,7 +25734,7 @@ var start = async (config) => {
     });
     try {
       const { A2AAuthService, parseEnvKeys } = await import("./A2AAuthService-7UGQ7GMW.mjs");
-      const { registerA2AStandardRoutes } = await import("./a2a-standard-PIOKEHPS.mjs");
+      const { registerA2AStandardRoutes } = await import("./a2a-standard-PBYPNHOA.mjs");
       const a2a = await import("./a2a-FGYX2HH3.mjs");
       const a2aKeyStore = getStoreLattice28("default", "a2aApiKey").store;
       const assistantStore = getStoreLattice28("default", "assistant").store;
@@ -25774,12 +25764,12 @@ var start = async (config) => {
       });
     }
     try {
-      const { registerOpenRoutes } = await import("./open-AMEMJOFJ.mjs");
-      const { registerOpenSessionRoutes } = await import("./open-session-LBTCU3AE.mjs");
+      const { registerOpenRoutes } = await import("./open-STFMNRO5.mjs");
+      const { registerOpenSessionRoutes } = await import("./open-session-IHDGAXL3.mjs");
       const { registerOpenCatalogRoutes } = await import("./open-catalog-SZQ435AY.mjs");
-      const { registerOpenFilesRoutes } = await import("./open-files-EJ6O2SGX.mjs");
+      const { registerOpenFilesRoutes } = await import("./open-files-NPNQQ6TY.mjs");
       const { registerOpenAuditRoutes } = await import("./open-audit-UJ3NXCGW.mjs");
-      const { registerOpenExposureRoutes } = await import("./open-exposure-I44Q4M3T.mjs");
+      const { registerOpenExposureRoutes } = await import("./open-exposure-VU227IO3.mjs");
       const { openLattice } = await import("./openLattice-Q6M5S6CY.mjs");
       const { createKbProvider } = await import("./kbProvider-2D6DZ34N.mjs");
       const { createOpenSandboxProvider } = await import("./sandboxProvider-I3P66VXT.mjs");
@@ -25850,6 +25840,25 @@ var start = async (config) => {
     if (routes.projectTaskRuntime) {
       await prepareProjectTaskRuntime(routes.projectTaskRuntime, logger6);
     }
+    if (process.env.AXIOM_TASK_ORPHAN_RECOVERY === "true") {
+      try {
+        const { createOrphanRecoveryRuntime: createOrphanRecoveryRuntime2 } = await import("./OrphanRecoveryRuntime-MQDEJX3M.mjs");
+        const { createRecoveryCallerDeps: createRecoveryCallerDeps2 } = await import("./RecoveryCallerDeps-6SJUYJ5S.mjs");
+        const taskStore = getStoreLattice28("default", "task").store;
+        const workItemStore = getStoreLattice28("default", "taskWorkItem").store;
+        const tenantStore = getStoreLattice28("default", "tenant").store;
+        const runtime = createOrphanRecoveryRuntime2({
+          taskStore,
+          workItemStore,
+          tenantStore,
+          ...createRecoveryCallerDeps2(),
+          log: logger6
+        });
+        await runtime.recoverAll();
+      } catch (err) {
+        logger6.warn("Task orphan recovery failed", { error: err instanceof Error ? err.message : String(err) });
+      }
+    }
     await app.listen({ port: target_port, host: "0.0.0.0" });
     logger6.info(`Lattice Gateway is running on port: ${target_port}`);
     const queueServiceConfig = config?.queueServiceConfig;
@@ -25860,13 +25869,6 @@ var start = async (config) => {
         agentTaskConsumer.startPollingQueue();
       }
     }
-    if (process.env.AXIOM_RESTORE_PENDING_ON_STARTUP === "true") {
-      agentInstanceManager9.restore().then((stats) => {
-        logger6.info(`Agent recovery complete: ${stats.restored} threads restored, ${stats.errors} errors`);
-      }).catch((error) => {
-        logger6.error("Agent recovery failed", { error });
-      });
-    }
     restoreMcpConnections().catch((error) => {
       logger6.error("MCP connection restoration failed", { error });
     });
@@ -25883,6 +25885,12 @@ var LatticeGateway = {
   AgentTaskConsumer
 };
 export {
-  LatticeGateway
+  LatticeGateway,
+  createOrphanRecoveryRuntime,
+  createRecoveryCallerDeps,
+  recoverTask,
+  recoverTopCaller,
+  resolveTopCaller,
+  runOrphanRecovery
 };
 //# sourceMappingURL=index.mjs.map