orkestrator 2.26.3-beta → 2.27.0-beta

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "orkestrator",
-  "version": "2.26.3-beta",
+  "version": "2.27.0-beta",
   "description": "Run the Orkestrator backend service without the desktop application",
   "homepage": "https://orkestrator.dev",
   "repository": {
@@ -39,8 +39,8 @@
     "sharp": "0.35.5"
   },
   "devDependencies": {
-    "@orkestrator/protocol": "2.26.3-beta",
-    "@orkestrator/toolchain": "2.26.3-beta"
+    "@orkestrator/protocol": "2.27.0-beta",
+    "@orkestrator/toolchain": "2.27.0-beta"
   },
   "engines": {
     "bun": ">=1.4.3"

package/resources/claude-bridge/dist/index.js

@@ -4243,6 +4243,7 @@ var NATIVE_AGENT_APPROVAL_MODES = Object.freeze({
   ]
 });
 var DISPATCH_OUTCOME_LOST_KIND = "dispatch-outcome-lost";
+var NATIVE_AGENT_RETIRED_DISPATCH_TTL_MS = 24 * 60 * 60 * 1000;
 var SUPPRESSED_COMPOSER_PARAMETERS = Object.freeze({
   claude: Object.freeze(["parameter:thinking", "parameter:context1m"]),
   codex: Object.freeze(["parameter:summary"]),
@@ -4358,6 +4359,7 @@ var PROJECTION_FIELD_SET = new Set([
   "runtimeHealthAuthoritative",
   "notices",
   "recoverableDispatch",
+  "retiredDispatch",
   "backgroundTasks",
   "suggestedPrompt",
   "completionBlockedByBackgroundTasks",
@@ -4381,6 +4383,7 @@ var OPTIONAL_PROJECTION_FIELD_SET = new Set([
   "runtimeHealthAuthoritative",
   "notices",
   "recoverableDispatch",
+  "retiredDispatch",
   "backgroundTasks",
   "suggestedPrompt",
   "completionBlockedByBackgroundTasks",
@@ -5160,7 +5163,15 @@ async function stopBackgroundTask(sessionId, taskId) {
   }
   return { ok: true };
 }
+var backgroundTaskRevisions = new WeakMap;
+function noteBackgroundTasksChanged(session) {
+  backgroundTaskRevisions.set(session, (backgroundTaskRevisions.get(session) ?? 0) + 1);
+}
+function backgroundTaskRevision(session) {
+  return backgroundTaskRevisions.get(session) ?? 0;
+}
 function emitBackgroundTaskSnapshot(session) {
+  noteBackgroundTasksChanged(session);
   eventEmitter.emit({
     type: "session.updated",
     sessionId: session.id,
@@ -6771,6 +6782,34 @@ function getPromptDispatchState(sessionId, requestId) {
   }
   return "new";
 }
+function idleSteerUserMessageId(requestId) {
+  return `idle-steer:${requestId}`;
+}
+function restoredDispatchClaimLost(session, requestId) {
+  if (!session?.restoredDispatchedRequestIds?.has(requestId))
+    return false;
+  const localReplyId = idleSteerUserMessageId(requestId);
+  return !session.localTranscript?.some((message) => message.id === localReplyId);
+}
+async function persistedDispatchClaimLost(sessionId, requestId) {
+  if (sessions.has(sessionId))
+    return false;
+  const sdkSessionId = sdkSessionIdFromBridgeId(sessionId);
+  if (!sdkSessionId)
+    return false;
+  let preferences;
+  try {
+    preferences = await readSessionPreferences(sdkSessionId);
+  } catch {
+    return false;
+  }
+  if (!preferences || sessionPreferencesUnavailable(preferences))
+    return false;
+  if (!preferences.dispatchedRequestIds?.includes(requestId))
+    return false;
+  const localReplyId = idleSteerUserMessageId(requestId);
+  return !preferences.localTranscript?.some((entry) => entry.id === localReplyId);
+}
 async function claimPromptDispatch(sessionId, requestId, startDispatch, testHooks) {
   const session = sessions.get(sessionId);
   if (!session)
@@ -12179,7 +12218,7 @@ function displayCommandName(name) {
 function normalizeAvailability(value) {
   if (!isRecord(value))
     return;
-  if (value.state !== "available" && value.state !== "unavailable")
+  if (typeof value.state !== "string")
     return;
   const reason = typeof value.reason === "string" && UNAVAILABLE_REASONS.has(value.reason) ? value.reason : undefined;
   const message = boundedText(value.message, COMMAND_CATALOGUE_LIMITS.maxAvailabilityMessageBytes);
@@ -12696,7 +12735,10 @@ function idleSteerMessageIds(requestId) {
   if (!requestId) {
     return { userId: generateMessageId(), assistantId: generateMessageId() };
   }
-  return { userId: `idle-steer:${requestId}`, assistantId: `idle-steer-reply:${requestId}` };
+  return {
+    userId: idleSteerUserMessageId(requestId),
+    assistantId: `idle-steer-reply:${requestId}`
+  };
 }
 async function answerIdleSteerPrompt(session, prompt, requestId) {
   const reply = idleSteerPromptReply(prompt, "Claude");
@@ -15405,6 +15447,7 @@ async function handleResultMessage(turn, message) {
 
 // ../../bridges/claude-bridge/src/services/session-manager-prompt-handlers/system-tasks.ts
 function emitBackgroundTasks(turn) {
+  noteBackgroundTasksChanged(turn.session);
   eventEmitter.emit({
     type: "session.updated",
     sessionId: turn.sessionId,
@@ -16871,7 +16914,9 @@ var MCP_MANAGEMENT_LIMITS = {
   operationStoreMaxBytes: 4 * 1024 * 1024,
   runtimesPerOperation: 64,
   runtimesTrackedPerOperation: 256,
-  queuedApplyTargets: 32
+  queuedApplyTargets: 32,
+  overlayRecordMaxBytes: 3 * 1024 * 1024,
+  containerPathProbesMax: 32
 };
 var MCP_SCOPE_LABELS = Object.freeze({
   "backend-user": "Backend user",
@@ -17015,6 +17060,7 @@ var SESSION_ACTIVITY_BATCH_LIMITS = {
   maxResponseBytes: 512 * 1024,
   maxAsyncQuestionItemIds: 64,
   maxAsyncQuestionItemIdLength: 2048,
+  maxContentRevisionLength: 256,
   readConcurrency: 4
 };
 var SESSION_ACTIVITY_STATES = new Set(["idle", "working", "waiting", "missing"]);
@@ -17029,6 +17075,7 @@ function parseSessionActivityObservation(value) {
   if (!isRecord3(value))
     return;
   const { activity, readyForInput, completionPending, asyncQuestionItemIds, closing } = value;
+  const { contentRevision } = value;
   if (typeof activity !== "string" || !SESSION_ACTIVITY_STATES.has(activity))
     return;
   if (readyForInput !== undefined && typeof readyForInput !== "boolean")
@@ -17037,6 +17084,8 @@ function parseSessionActivityObservation(value) {
     return;
   if (closing !== undefined && typeof closing !== "boolean")
     return;
+  if (contentRevision !== undefined && !isContentRevision(contentRevision))
+    return;
   let itemIds;
   if (asyncQuestionItemIds !== undefined) {
     if (!Array.isArray(asyncQuestionItemIds) || asyncQuestionItemIds.length > SESSION_ACTIVITY_BATCH_LIMITS.maxAsyncQuestionItemIds || !asyncQuestionItemIds.every((itemId) => typeof itemId === "string" && itemId.length > 0 && itemId.length <= SESSION_ACTIVITY_BATCH_LIMITS.maxAsyncQuestionItemIdLength)) {
@@ -17049,9 +17098,13 @@ function parseSessionActivityObservation(value) {
     ...readyForInput !== undefined ? { readyForInput } : {},
     ...completionPending !== undefined ? { completionPending } : {},
     ...itemIds !== undefined ? { asyncQuestionItemIds: itemIds } : {},
-    ...closing !== undefined ? { closing } : {}
+    ...closing !== undefined ? { closing } : {},
+    ...contentRevision !== undefined ? { contentRevision } : {}
   };
 }
+function isContentRevision(value) {
+  return typeof value === "string" && value.length > 0 && value.length <= SESSION_ACTIVITY_BATCH_LIMITS.maxContentRevisionLength;
+}
 function parseSessionActivityBatchRequest(value) {
   if (!isRecord3(value))
     return { ok: false, error: "Expected a JSON object" };
@@ -17176,9 +17229,23 @@ async function readSessionActivityObservation(sessionId) {
   const completionPending = resident ? sessionCompletionPending(resident) : undefined;
   return {
     activity: activity === "idle" && completionPending ? "working" : activity,
-    ...resident?.status === "idle" ? { readyForInput: true, completionPending } : {}
+    ...resident?.status === "idle" ? { readyForInput: true, completionPending } : {},
+    ...activity === "missing" ? {} : contentRevisionField(resident)
   };
 }
+function contentRevisionField(resident) {
+  try {
+    return { contentRevision: sessionContentRevision(resident) };
+  } catch {
+    return {};
+  }
+}
+function sessionContentRevision(resident) {
+  if (!resident)
+    return eventEmitter.generation;
+  const transcript = readTranscriptVersion(resident);
+  return `${eventEmitter.generation}:${transcript.epoch}.${transcript.revision}:${backgroundTaskRevision(resident)}`;
+}
 var sessionActivityBatch = new Hono2;
 sessionActivityBatch.post(SESSION_ACTIVITY_BATCH_PATH, async (c) => {
   const answer = await answerSessionActivityBatch(c.req.raw.body, readSessionActivityObservation, {
@@ -18449,13 +18516,20 @@ session.get("/:id/activity", async (c) => {
 session.get("/:id/runtime-health", (c) => {
   return c.json(sessionRuntimeHealthBody(peekSession(c.req.param("id"))));
 });
-session.get("/:id/dispatch", (c) => {
+session.get("/:id/dispatch", async (c) => {
+  const answer = (dispatch) => c.json({ dispatch });
   const requestId = c.req.query("requestId")?.trim();
   if (!requestId)
-    return c.json({ dispatch: "unknown" });
-  const state = getPromptDispatchState(c.req.param("id"), requestId);
-  const dispatched = state === "processing" || state === "already-processed";
-  return c.json({ dispatch: dispatched ? "dispatched" : "unknown" });
+    return answer("unknown");
+  const id = c.req.param("id");
+  const state = getPromptDispatchState(id, requestId);
+  if (state === "processing" || state === "already-processed")
+    return answer("dispatched");
+  if (state === "new") {
+    return answer(restoredDispatchClaimLost(peekSession(id), requestId) ? "lost" : "unknown");
+  }
+  const lost = await persistedDispatchClaimLost(id, requestId).catch(() => false);
+  return answer(lost ? "lost" : "unknown");
 });
 session.get("/:id/questions", (c) => {
   const id = c.req.param("id");
@@ -18869,6 +18943,9 @@ function serializeEventData(event) {
 }
 var MAX_PENDING_SSE_FRAMES = 1000;
 var MAX_PENDING_SSE_BYTES = 16 * 1024 * 1024;
+function observationFrameData(sessionId) {
+  return JSON.stringify(sessionId === undefined ? {} : { sessionId });
+}
 var MAX_REPLAY_SSE_FRAMES = 512;
 var MAX_REPLAY_SSE_BYTES = 4 * 1024 * 1024;
 var REPLAY_IDLE_RETENTION_MS = 60000;
@@ -18885,7 +18962,8 @@ function createReplayBuffer(limits = {}) {
         id: `${generation}:${revision}`,
         event: event.type,
         data,
-        bytes: Buffer.byteLength(data) + Buffer.byteLength(event.type)
+        bytes: Buffer.byteLength(data) + Buffer.byteLength(event.type),
+        ...event.sessionId === undefined ? {} : { sessionId: event.sessionId }
       };
       frames.push(frame);
       bytes += frame.bytes;
@@ -19063,6 +19141,7 @@ function createEventsRouter(limits = {}) {
         if (!isOpen)
           throw new Error("SSE request aborted");
       }, () => closeConnection("write backlog exceeded its cap"), { maxPendingFrames, maxPendingBytes });
+      const observe = c.req.query("observe") === "1";
       const requestedCursorValue = c.req.header("last-event-id") ?? c.req.query("since");
       const requestedCursor = parseReplayCursor(requestedCursorValue);
       const cursorWasSupplied = requestedCursorValue !== undefined;
@@ -19071,12 +19150,12 @@ function createEventsRouter(limits = {}) {
       let replaying = true;
       let keepaliveInterval;
       let unsubscribe = () => {};
-      const releaseReplayRetention = replayRetention.acquire();
+      const releaseReplayRetention = observe ? () => {} : replayRetention.acquire();
       try {
         unsubscribe = eventEmitter.subscribe((event, revision) => {
           if (!isOpen)
             return;
-          const data = serializeEventData(event);
+          const data = observe ? observationFrameData(event.sessionId) : serializeEventData(event);
           const frame = {
             revision,
             id: formatReplayCursor(revision),
@@ -19113,7 +19192,8 @@ function createEventsRouter(limits = {}) {
             status: "connected",
             timestamp: connectedAt,
             replayed: replay.frames.length,
-            resetRequired: replay.resetRequired
+            resetRequired: replay.resetRequired,
+            ...observe ? { observe: true } : {}
           })
         });
         if (replay.resetRequired) {
@@ -19123,8 +19203,9 @@ function createEventsRouter(limits = {}) {
             data: JSON.stringify({ through: formatReplayCursor(replayCeiling) })
           });
         } else {
-          for (const frame of replay.frames)
-            await writeFrame(frame);
+          for (const frame of replay.frames) {
+            await writeFrame(observe ? { ...frame, data: observationFrameData(frame.sessionId) } : frame);
+          }
         }
         const drained = pendingLiveFrames.splice(0);
         pendingLiveBytes = 0;

package/resources/codex-bridge/dist/index.js

@@ -4060,6 +4060,7 @@ var NATIVE_AGENT_APPROVAL_MODES = Object.freeze({
     }
   ]
 });
+var NATIVE_AGENT_RETIRED_DISPATCH_TTL_MS = 24 * 60 * 60 * 1000;
 var SUPPRESSED_COMPOSER_PARAMETERS = Object.freeze({
   claude: Object.freeze(["parameter:thinking", "parameter:context1m"]),
   codex: Object.freeze(["parameter:summary"]),
@@ -4191,6 +4192,7 @@ var PROJECTION_FIELD_SET = new Set([
   "runtimeHealthAuthoritative",
   "notices",
   "recoverableDispatch",
+  "retiredDispatch",
   "backgroundTasks",
   "suggestedPrompt",
   "completionBlockedByBackgroundTasks",
@@ -4214,6 +4216,7 @@ var OPTIONAL_PROJECTION_FIELD_SET = new Set([
   "runtimeHealthAuthoritative",
   "notices",
   "recoverableDispatch",
+  "retiredDispatch",
   "backgroundTasks",
   "suggestedPrompt",
   "completionBlockedByBackgroundTasks",
@@ -5089,6 +5092,7 @@ var SESSION_ACTIVITY_BATCH_LIMITS = {
   maxResponseBytes: 512 * 1024,
   maxAsyncQuestionItemIds: 64,
   maxAsyncQuestionItemIdLength: 2048,
+  maxContentRevisionLength: 256,
   readConcurrency: 4
 };
 var SESSION_ACTIVITY_STATES = new Set(["idle", "working", "waiting", "missing"]);
@@ -5103,6 +5107,7 @@ function parseSessionActivityObservation(value) {
   if (!isRecord(value))
     return;
   const { activity, readyForInput, completionPending, asyncQuestionItemIds, closing } = value;
+  const { contentRevision } = value;
   if (typeof activity !== "string" || !SESSION_ACTIVITY_STATES.has(activity))
     return;
   if (readyForInput !== undefined && typeof readyForInput !== "boolean")
@@ -5111,6 +5116,8 @@ function parseSessionActivityObservation(value) {
     return;
   if (closing !== undefined && typeof closing !== "boolean")
     return;
+  if (contentRevision !== undefined && !isContentRevision(contentRevision))
+    return;
   let itemIds;
   if (asyncQuestionItemIds !== undefined) {
     if (!Array.isArray(asyncQuestionItemIds) || asyncQuestionItemIds.length > SESSION_ACTIVITY_BATCH_LIMITS.maxAsyncQuestionItemIds || !asyncQuestionItemIds.every((itemId) => typeof itemId === "string" && itemId.length > 0 && itemId.length <= SESSION_ACTIVITY_BATCH_LIMITS.maxAsyncQuestionItemIdLength)) {
@@ -5123,9 +5130,13 @@ function parseSessionActivityObservation(value) {
     ...readyForInput !== undefined ? { readyForInput } : {},
     ...completionPending !== undefined ? { completionPending } : {},
     ...itemIds !== undefined ? { asyncQuestionItemIds: itemIds } : {},
-    ...closing !== undefined ? { closing } : {}
+    ...closing !== undefined ? { closing } : {},
+    ...contentRevision !== undefined ? { contentRevision } : {}
   };
 }
+function isContentRevision(value) {
+  return typeof value === "string" && value.length > 0 && value.length <= SESSION_ACTIVITY_BATCH_LIMITS.maxContentRevisionLength;
+}
 function parseSessionActivityBatchRequest(value) {
   if (!isRecord(value))
     return { ok: false, error: "Expected a JSON object" };
@@ -14024,7 +14035,7 @@ async function publishAssistantRows(context, state, turn, options) {
 }
 
 // ../../bridges/codex-bridge/src/app-server-runtime-sessions.ts
-import { createHash as createHash9 } from "node:crypto";
+import { createHash as createHash9, randomUUID as randomUUID6 } from "node:crypto";
 
 // ../protocol/src/agent-mail.ts
 var AGENT_MAIL_MAX_BODY_BYTES = 32 * 1024;
@@ -20092,6 +20103,7 @@ class ThreadRegistry {
 
 // ../../bridges/codex-bridge/src/app-server-runtime-sessions.ts
 var SESSION_CLOSING_ERROR = "Session is closing";
+var ACTIVITY_PROCESS = randomUUID6();
 
 class CodexRuntimeSessions {
   ctx;
@@ -20949,7 +20961,8 @@ class CodexRuntimeSessions {
       return { activity: "missing" };
     return {
       activity,
-      ...session.asyncQuestionItemIds.length > 0 ? { asyncQuestionItemIds: [...session.asyncQuestionItemIds] } : {}
+      ...session.asyncQuestionItemIds.length > 0 ? { asyncQuestionItemIds: [...session.asyncQuestionItemIds] } : {},
+      contentRevision: `${ACTIVITY_PROCESS}:${session.contentEpoch}.${session.messageRevision}:${session.asyncQuestionItemIds.length}`
     };
   }
   hasParkedInput(session) {
@@ -26082,6 +26095,21 @@ var codexPathOverride = process.env.CODEX_PATH || "codex";
 var BRIDGE_VERSION = "1.0.0";
 var execFile4 = promisify2(execFileCallback2);
 var subscribers = new Set;
+var observers = new Set;
+function observationFrameData(sessionId) {
+  return JSON.stringify(sessionId === undefined ? {} : { sessionId });
+}
+function notifyObservers(event, revision) {
+  for (const observer of observers) {
+    try {
+      Promise.resolve(observer(event, revision, "{}")).catch((error) => {
+        console.error("[codex-bridge] Failed to notify SSE observer:", error);
+      });
+    } catch (error) {
+      console.error("[codex-bridge] Failed to notify SSE observer:", error);
+    }
+  }
+}
 var MAX_REPLAY_SSE_BYTES = 4 * 1024 * 1024;
 var REPLAY_IDLE_RETENTION_MS = 60000;
 var SUPERSEDED_FRAME_BYTES = 64;
@@ -26349,7 +26377,7 @@ function retainedMessageId(type, payload) {
 }
 function emit(event) {
   if (!replayRetentionEnabled) {
-    eventRing.advance();
+    notifyObservers(event, eventRing.advance());
     return;
   }
   const sessionId = event.sessionId;
@@ -26376,6 +26404,7 @@ function emit(event) {
     serialize: () => eager ?? serializeSseEventData({ sessionId, data: payload }),
     bytes
   });
+  notifyObservers(event, revision);
   for (const subscriber of subscribers) {
     try {
       Promise.resolve(subscriber(event, revision, eager ?? "{}")).catch((error) => {
@@ -26704,7 +26733,7 @@ app.get("/global/health", (c) => {
       notificationDepth: health.notificationQueueDepth,
       notificationHighWaterMark: health.notificationQueueHighWaterMark
     },
-    events: { ...eventRing.getStats(), subscribers: subscribers.size }
+    events: { ...eventRing.getStats(), subscribers: subscribers.size, observers: observers.size }
   }, terminal ? 503 : 200);
 });
 app.get("/global/auth-check", (c) => {
@@ -27219,6 +27248,7 @@ app.delete("/session/:id", async (c) => {
 app.get("/event/subscribe", (c) => {
   const cursor = parseEventCursor(c.req.query("since")) ?? parseEventCursor(c.req.header("last-event-id"));
   const sessionFilter = c.req.query("sessionId")?.trim() || null;
+  const observe = c.req.query("observe") === "1";
   return streamSSE(c, async (stream) => {
     let open = true;
     let resolveConnectionClosed;
@@ -27244,10 +27274,10 @@ app.get("/event/subscribe", (c) => {
       return {
         event: event.type,
         id: String(revision),
-        data: serializeData()
+        data: observe ? observationFrameData(event.sessionId) : serializeData()
       };
     };
-    const releaseReplayRetention = acquireReplayRetention();
+    const releaseReplayRetention = observe ? () => {} : acquireReplayRetention();
     const anchorRevision = cursor ?? eventRing.latestRevision;
     let buffered = [];
     let highestSent = anchorRevision;
@@ -27269,7 +27299,7 @@ app.get("/event/subscribe", (c) => {
       highestSent = revision;
       await writeWhileOpen(frameFor(event, revision, () => serializedData));
     };
-    subscribers.add(listener);
+    (observe ? observers : subscribers).add(listener);
     let keepalive;
     try {
       if (sseRouteTestHooks?.afterSubscriberRegistered) {
@@ -27283,7 +27313,8 @@ app.get("/event/subscribe", (c) => {
           status: "connected",
           timestamp: new Date().toISOString(),
           revision: replay?.latestRevision ?? anchorRevision,
-          replayed: replay?.complete === true ? replay.events.length : 0
+          replayed: replay?.complete === true ? replay.events.length : 0,
+          ...observe ? { observe: true } : {}
         })
       });
       if (replay && !replay.complete) {
@@ -27329,6 +27360,8 @@ app.get("/event/subscribe", (c) => {
       }
       buffered = null;
       keepalive = startSseKeepalive(writeWhileOpen, 5000, () => {
+        if (observe)
+          return false;
         if (!sessionFilter)
           return true;
         const activity = appServerRuntime.getActivity(sessionFilter);
@@ -27348,6 +27381,7 @@ app.get("/event/subscribe", (c) => {
       if (keepalive)
         clearInterval(keepalive);
       subscribers.delete(listener);
+      observers.delete(listener);
       releaseReplayRetention();
     }
   });