@moxt-ai/mobius 0.0.387 → 0.0.388

package/dist/{chunk-A62FEGIN.js → chunk-7BSIM5AK.js}

@@ -3,7 +3,7 @@ import {
   __export,
   __using,
   package_default
-} from "./chunk-S7PKNDIS.js";
+} from "./chunk-Z4WUPVBL.js";
 
 // src/engine/runtime/relay/runtime-revocation.ts
 var runtimeRevocationCloseCode = 1008;
@@ -20760,6 +20760,27 @@ var lifecycleMetadataSchema = external_exports.discriminatedUnion("kind", [
     message: external_exports.string().min(1).max(500)
   }).readonly()
 ]);
+var isPromptTerminal = (payload) => {
+  switch (payload.kind) {
+    case "prompt.completed":
+    case "prompt.failed":
+    case "prompt.failed-before-start":
+      return true;
+    case "prompt.requested":
+    case "prompt.started":
+    case "session.queue.changed":
+    case "session.permission.requested":
+    case "session.permission.resolved":
+    case "session.elicitation.requested":
+    case "session.elicitation.resolved":
+      return false;
+    default: {
+      const unknownKind = payload;
+      void unknownKind;
+      return false;
+    }
+  }
+};
 var sessionEventPayloadSchema = external_exports.discriminatedUnion("type", [
   external_exports.object({ payload: acpSessionUpdateSchema, type: external_exports.literal("acp") }).readonly(),
   external_exports.object({ payload: lifecycleMetadataSchema, type: external_exports.literal("lifecycle-metadata") }).readonly()
@@ -86672,9 +86693,6 @@ var AgentSession = class _AgentSession {
     additionalDirectories: this.#additionalDirectories
   });
   prompt = async (options) => {
-    if (this.#turn.running) {
-      throw new AcpExecutionError("Another prompt is already running in this conversation", {}, "session_busy");
-    }
     if (!this.#capabilities.loadSession && this.#sessionLoad.kind === "not-requested") {
       this.#sessionLoad = {
         kind: "loaded",
@@ -86693,6 +86711,7 @@ var AgentSession = class _AgentSession {
       await this.#completedHistory(options.signal);
     }
     validatePromptContent(options, this.#capabilities);
+    options.signal.throwIfAborted();
     if (this.#sessionTitle === null || this.#sessionTitle.length === 0) {
       this.#sessionTitle = conversationTitleFromText(options.prompt);
     }
@@ -86773,6 +86792,7 @@ var AgentSession = class _AgentSession {
       throw new AcpExecutionError("The target turn is no longer active", {}, "steering_target_unavailable");
     }
     validatePromptContent(options, this.#capabilities);
+    options.signal.throwIfAborted();
     const lifecycle = options.lifecycle;
     if (lifecycle !== void 0) {
       await this.recordLifecycleEvent({
@@ -87018,9 +87038,6 @@ var ActiveExecutions = class {
   };
   isBusy = (id) => this.#entries.has(id);
   begin = (id, commandId) => {
-    if (this.#entries.has(id)) {
-      throw new AcpExecutionError("Another prompt is already running in this conversation", {}, "session_busy");
-    }
     this.#entries.set(id, { kind: "running", commandId });
   };
   cancel = (id, commandId, stop) => {
@@ -88351,16 +88368,17 @@ function promptContent(command) {
 }
 var PromptLifecycle = class {
   #sink;
+  /** Terminal events held until their command's admission and execution state are released. */
   #terminal = /* @__PURE__ */ new Map();
   #publications = /* @__PURE__ */ new Map();
   #queued = /* @__PURE__ */ new Map();
   #recordActiveTurn;
-  #hasStarted;
+  #executions;
   #recordLifecycle;
-  constructor(sink, recordLifecycle, recordActiveTurn, hasStarted) {
+  constructor(sink, recordLifecycle, recordActiveTurn, executions) {
     this.#recordLifecycle = recordLifecycle;
     this.#recordActiveTurn = recordActiveTurn;
-    this.#hasStarted = hasStarted;
+    this.#executions = executions;
     this.#sink = sink;
   }
   requested = (command) => {
@@ -88377,8 +88395,8 @@ var PromptLifecycle = class {
       ...command.targetCommandId.length === 0 ? {} : { targetCommandId: command.targetCommandId }
     });
   };
-  /** Metadata for an execution already claimed by the receipt owner. */
-  started = (sessionId, commandId, attemptId, epoch, disposition) => {
+  /** The lifecycle metadata the Agent session records when it starts this claimed command. */
+  lifecycle = (sessionId, commandId, attemptId, epoch, disposition) => {
     const request = this.#queued.get(commandId);
     if (request?.sessionId === sessionId) {
       return {
@@ -88395,7 +88413,7 @@ var PromptLifecycle = class {
   record = (recorded) => {
     this.#recordActiveTurn(recorded);
     const sessionId = recorded.sessionId;
-    if (recorded.type === "lifecycle-metadata" && (recorded.payload.kind === "prompt.completed" || recorded.payload.kind === "prompt.failed" || recorded.payload.kind === "prompt.failed-before-start")) {
+    if (recorded.type === "lifecycle-metadata" && isPromptTerminal(recorded.payload)) {
       this.#terminal.set(recorded.payload.commandId, recorded);
       const pending2 = this.#publications.get(sessionId) ?? [];
       pending2.push(recorded);
@@ -88446,7 +88464,7 @@ var PromptLifecycle = class {
   };
   completed = async (sessionId, commandId, stopReason) => {
     const request = this.#queued.get(commandId);
-    if (request?.sessionId !== sessionId || this.#terminal.has(commandId)) {
+    if (request?.sessionId !== sessionId || this.#executions.isTerminalExecution(commandId, sessionId)) {
       return;
     }
     const recorded = await this.#recordLifecycle(sessionId, {
@@ -88455,7 +88473,7 @@ var PromptLifecycle = class {
         kind: "prompt.completed",
         commandId,
         stopReason,
-        ...this.#hasStarted(commandId, sessionId) ? {} : { execution: "not-started" }
+        ...this.#executions.hasStarted(commandId, sessionId) ? {} : { execution: "not-started" }
       }
     });
     if (!recorded) {
@@ -88467,21 +88485,24 @@ var PromptLifecycle = class {
       );
     }
   };
-  failed = async (sessionId, commandId, code, message) => {
+  /** Settles a failed command; whether it failed before or after starting is its receipt's fact. */
+  failed = async (sessionId, commandId, attemptId, code, message) => {
     const request = this.#queued.get(commandId);
-    if (request?.sessionId !== sessionId || this.#terminal.has(commandId)) {
+    if (request?.sessionId !== sessionId || this.#executions.isTerminalExecution(commandId, sessionId)) {
       return;
     }
     const recorded = await this.#recordLifecycle(sessionId, {
       type: "lifecycle-metadata",
-      payload: { kind: "prompt.failed-before-start", commandId, code, message }
+      payload: this.#executions.hasStarted(commandId, sessionId) ? { kind: "prompt.failed", attemptId, commandId, code, message } : { kind: "prompt.failed-before-start", commandId, code, message }
     });
     if (!recorded || code === SESSION_CLOSED_ERROR_CODE) {
       this.#sink.publishOperationFailure(sessionId, commandId, code, message);
     }
   };
   promptRequestRecovery = (sessionId) => ({
-    queuedPromptRequests: [...this.#queued.values()].filter((request) => request.sessionId === sessionId && !this.#hasStarted(request.commandId, sessionId)).map(({ commandId, content, disposition, targetCommandId }) => ({
+    queuedPromptRequests: [...this.#queued.values()].filter(
+      (request) => request.sessionId === sessionId && !this.#executions.hasStarted(request.commandId, sessionId)
+    ).map(({ commandId, content, disposition, targetCommandId }) => ({
       commandId,
       content,
       ...disposition === void 0 ? {} : { disposition },
@@ -88503,6 +88524,7 @@ async function settleAbandonedTurn(projection, operations, cancellation) {
   await projection.failed(
     cancellation.sessionId,
     cancellation.commandId,
+    attemptId,
     "agent_execution_abandoned",
     "The local Agent execution was abandoned before it completed"
   );
@@ -88614,7 +88636,7 @@ var ExecutionReceipts = class {
       return { state: "accepted" };
     }
     const outcome = this.outcome(commandId);
-    if (outcome?.type !== "lifecycle-metadata") {
+    if (outcome?.type !== "lifecycle-metadata" || !isPromptTerminal(outcome.payload)) {
       return { state: "expired" };
     }
     switch (outcome.payload.kind) {
@@ -88623,8 +88645,6 @@ var ExecutionReceipts = class {
       case "prompt.failed":
       case "prompt.failed-before-start":
         return { code: outcome.payload.code, state: "failed" };
-      default:
-        return { state: "expired" };
     }
   };
   /**
@@ -88647,7 +88667,7 @@ var ExecutionReceipts = class {
       }
     }
     const outcome = last === void 0 ? void 0 : this.outcome(last);
-    if (last === void 0 || outcome?.type !== "lifecycle-metadata") {
+    if (last === void 0 || outcome?.type !== "lifecycle-metadata" || !isPromptTerminal(outcome.payload)) {
       return void 0;
     }
     switch (outcome.payload.kind) {
@@ -88661,8 +88681,6 @@ var ExecutionReceipts = class {
           message: outcome.payload.message,
           state: "failed"
         };
-      default:
-        return void 0;
     }
   };
   /** Started identities remain authoritative after their detailed receipt is evicted. */
@@ -88706,12 +88724,24 @@ var ExecutionReceipts = class {
     });
     return outcome;
   };
-  recordOutcome = (event) => {
+  /**
+   * Receipts follow their command's recorded lifecycle. `prompt.started` is recorded where the command is handed
+   * to the Agent, so the started mark and the event clients see are one transition; a terminal event settles the
+   * receipt. Nothing else marks a command started.
+   */
+  record = (event) => {
     if (event.type !== "lifecycle-metadata") {
       return;
     }
     const payload = event.payload;
-    if (payload.kind !== "prompt.completed" && payload.kind !== "prompt.failed" && payload.kind !== "prompt.failed-before-start") {
+    if (payload.kind === "prompt.started") {
+      const receipt2 = this.#executions.get(payload.commandId);
+      if (receipt2?.state.kind === "pending") {
+        this.#save(payload.commandId, { ...receipt2, state: { kind: "started" } });
+      }
+      return;
+    }
+    if (!isPromptTerminal(payload)) {
       return;
     }
     const receipt = this.#executions.get(payload.commandId);
@@ -88794,27 +88824,6 @@ var ExecutionReceipts = class {
     });
     return { attemptId, commandId, kind: "accepted" };
   };
-  markExecutionStarted = (commandId) => {
-    const current = this.#executions.get(commandId);
-    if (current === void 0) {
-      throw new Error("The runtime execution receipt does not exist");
-    }
-    const state = current.state;
-    switch (state.kind) {
-      case "pending":
-        this.#save(commandId, { ...current, state: { kind: "started" } });
-        return;
-      case "started":
-        return;
-      case "settled-before-start":
-      case "settled-after-start":
-        throw new Error("The runtime execution transition is invalid");
-      default: {
-        const unreachable2 = state;
-        throw new Error("Unexpected execution state", { cause: unreachable2 });
-      }
-    }
-  };
   /** Only commands without a terminal result can still be cancelled. */
   findUnsettledAttemptId = (commandId, sessionId) => {
     const receipt = this.#executions.get(commandId);
@@ -88922,69 +88931,79 @@ import { randomUUID as randomUUID16 } from "node:crypto";
 var ActiveRuntimeTurn = class {
   attemptId;
   command;
+  epoch = decodeIdentifier(randomUUID16());
   #controller;
   #finished = Promise.withResolvers();
+  #started;
   #cancellationRequested = false;
-  #dispatch;
+  #admission = { kind: "waiting" };
   #sequence = 0;
   #interaction = null;
-  #epoch = decodeIdentifier(randomUUID16());
-  constructor(command, attemptId) {
+  /** `started` reads the command's execution receipt, the single owner of whether the command started. */
+  constructor(command, attemptId, started) {
     this.attemptId = attemptId;
     this.command = command;
     this.#controller = new AbortController();
-    this.#dispatch = { kind: "pending" };
+    this.#started = started;
   }
   enqueue = () => {
-    if (this.#dispatch.kind !== "pending") {
-      throw new Error("Only a pending prompt can enter the queue");
+    if (this.#admission.kind !== "waiting") {
+      throw new Error("Only a waiting prompt can enter the queue");
     }
-    this.#dispatch = { kind: "queued", promotion: Promise.withResolvers() };
+    this.#admission = { kind: "queued", promotion: Promise.withResolvers() };
   };
-  isQueued = () => (this.#dispatch.kind === "queued" || this.#dispatch.kind === "admitted" && this.#dispatch.disposition === SessionPromptDisposition.Queue) && !this.#controller.signal.aborted;
+  isQueued = () => (this.#admission.kind === "queued" || this.#admission.kind === "admitted" && this.#admission.disposition === SessionPromptDisposition.Queue) && !this.#started() && !this.#controller.signal.aborted;
+  /** Whether the command's execution was handed to the Agent. */
+  hasStarted = () => this.#started();
   abortRuntime = () => {
     this.#controller.abort();
   };
   finish = () => {
     this.#finished.resolve();
   };
-  activate = (execution) => {
-    this.#dispatch = { kind: "running", execution };
-    return { epoch: this.#epoch, sequence: 0 };
-  };
   promoteQueuedPrompt = (command) => {
     if (command.commandId !== this.command.commandId || command.sessionId !== this.command.sessionId || this.#controller.signal.aborted) {
       return "unavailable";
     }
-    switch (this.#dispatch.kind) {
+    switch (this.#admission.kind) {
       case "queued": {
-        const promotion = this.#dispatch.promotion;
-        this.#dispatch = { kind: "promoted" };
+        const promotion = this.#admission.promotion;
+        this.#admission = { kind: "promoted" };
         promotion.resolve();
         return "accepted";
       }
       case "promoted":
         return "accepted";
       case "admitted":
-        return this.#dispatch.disposition === SessionPromptDisposition.Steer ? "accepted" : "already-started";
-      case "running":
-        return "already-started";
-      case "pending":
+        return this.#admission.disposition === SessionPromptDisposition.Steer ? "accepted" : "already-started";
+      case "waiting":
         return "unavailable";
     }
   };
   admit = () => {
     const disposition = this.effectiveDisposition();
-    this.#dispatch = { kind: "admitted", disposition };
+    this.#admission = { kind: "admitted", disposition };
     return disposition;
   };
   queuePromotion = () => {
-    if (this.#dispatch.kind === "queued") {
-      return this.#dispatch.promotion.promise;
+    if (this.#admission.kind === "queued") {
+      return this.#admission.promotion.promise;
     }
-    return this.#dispatch.kind === "promoted" ? Promise.resolve() : null;
+    return this.#admission.kind === "promoted" ? Promise.resolve() : null;
   };
-  effectiveDisposition = () => this.#dispatch.kind === "promoted" ? SessionPromptDisposition.Steer : this.command.disposition;
+  effectiveDisposition = () => {
+    switch (this.#admission.kind) {
+      case "waiting":
+      case "queued":
+        return this.command.disposition;
+      case "promoted":
+        return SessionPromptDisposition.Steer;
+      case "admitted":
+        return this.#admission.disposition;
+    }
+  };
+  /** A steering prompt joins the execution of the turn it steers; every other prompt owns its execution. */
+  execution = () => this.effectiveDisposition() === SessionPromptDisposition.Steer ? this.command.targetCommandId : this.command.commandId;
   recordEvent = (event) => {
     if (event.sessionId !== this.command.sessionId || "commandId" in event && event.commandId !== this.command.commandId) {
       return event;
@@ -88996,33 +89015,33 @@ var ActiveRuntimeTurn = class {
     }
     return event;
   };
-  recordSteeringPrompt = (command) => {
-    return this.#dispatch.kind === "running" && command.sessionId === this.command.sessionId && command.targetCommandId === this.command.commandId;
-  };
   snapshot = () => {
-    if (this.#dispatch.kind !== "running") {
+    if (!this.#started()) {
       return null;
     }
     return {
       commandId: decodeIdentifier(this.command.commandId),
-      epoch: this.#epoch,
+      epoch: this.epoch,
       interaction: this.#interaction,
       sequence: this.#sequence,
       state: "running"
     };
   };
-  matches = (cancellation) => cancellation.commandId === this.command.commandId && cancellation.sessionId === this.command.sessionId;
   matchesInteraction = (interactionId, sessionId) => this.command.sessionId === sessionId && this.#interaction?.interactionId === interactionId;
+  /**
+   * Before the command starts, cancellation withdraws it by aborting its own admission and preparation. Once it
+   * started, the Agent execution it belongs to must be asked to stop.
+   */
   requestCancellation = () => {
     if (this.#cancellationRequested) {
       return { kind: "already-requested" };
     }
     this.#cancellationRequested = true;
-    if (this.#dispatch.kind !== "running") {
-      this.#controller.abort(new Error("The queued Agent turn was cancelled"));
+    if (!this.#started()) {
+      this.#controller.abort(new Error("The Agent turn was cancelled before it started"));
       return { kind: "pending" };
     }
-    return { kind: "running", execution: this.#dispatch.execution };
+    return { kind: "running", execution: this.execution() };
   };
   cancellationRequested = () => this.#cancellationRequested;
   get signal() {
@@ -89068,7 +89087,11 @@ var SessionExecutionState = class {
   }
   isEmpty = () => this.#turnsByCommandId.size === 0;
   start = (command, attemptId) => {
-    const turn = new ActiveRuntimeTurn(command, attemptId);
+    const turn = new ActiveRuntimeTurn(
+      command,
+      attemptId,
+      () => this.#operations.hasStarted(command.commandId, this.#sessionId)
+    );
     this.#turnsByCommandId.set(command.commandId, turn);
     return turn;
   };
@@ -89093,10 +89116,8 @@ var SessionExecutionState = class {
     }
     return event;
   };
-  recordSteeringPrompt = (command) => {
-    const target = this.#turnsByCommandId.get(command.targetCommandId);
-    return target?.recordSteeringPrompt(command) ?? false;
-  };
+  /** A steering prompt can join only a target whose execution already started. */
+  steerTargetStarted = (command) => this.#turnsByCommandId.get(command.targetCommandId)?.hasStarted() ?? false;
   turns = () => [...this.#turnsByCommandId.values()];
   close = async () => {
     const turns = [...this.#turnsByCommandId.values()];
@@ -89109,7 +89130,7 @@ var SessionExecutionState = class {
     const command = turn.command;
     waitSignal.throwIfAborted();
     const head = () => [...this.#turnsByCommandId.values()].find(
-      (turn2) => turn2.command.disposition !== SessionPromptDisposition.Steer
+      (turn2) => turn2.effectiveDisposition() !== SessionPromptDisposition.Steer
     );
     if (command.disposition === SessionPromptDisposition.Queue) {
       const target = head();
@@ -89181,7 +89202,7 @@ var SessionTurns = class {
       this.recordEvent(event.payload.event);
     }
   };
-  recordSteeringPrompt = (command) => this.#bySessionId.get(command.sessionId)?.recordSteeringPrompt(command) ?? false;
+  steerTargetStarted = (command) => this.#bySessionId.get(command.sessionId)?.steerTargetStarted(command) ?? false;
   executionSnapshot = async (matches) => {
     for (const session of this.#bySessionId.values()) {
       const matching = [];
@@ -89431,7 +89452,7 @@ function buildSessionLayer(options) {
   const manager = new SessionManager2({
     observer: new SessionLayerObserver(
       (event) => {
-        operations.recordOutcome(event);
+        operations.record(event);
         eventProjection.record(event);
       },
       sink.publishInfo,
@@ -89454,12 +89475,12 @@ function buildSessionLayer(options) {
         return true;
       }
       const recorded = events.append(sessionId, event);
-      operations.recordOutcome(recorded);
+      operations.record(recorded);
       eventProjection.record(recorded);
       return true;
     },
     activeSessions.recordSessionEvent,
-    operations.hasStarted
+    operations
   );
   const nativeSessions = new NativeSessionService(
     bindingId,
@@ -91742,7 +91763,6 @@ function warnIgnoredSetting(event, commandId, sessionId, agentId, selection, cat
 
 // src/engine/session/prompt/execute-prompt.ts
 async function executePrompt({
-  operations,
   eventProjection,
   command,
   resolveAgent,
@@ -91751,10 +91771,10 @@ async function executePrompt({
   directories,
   sessions,
   attemptId,
-  activateAttempt,
+  epoch,
   waitForSessionAvailability,
   signal,
-  recordSteeringPrompt,
+  steerTargetStarted,
   cancellationRequested
 }) {
   try {
@@ -91812,24 +91832,14 @@ async function executePrompt({
       prepared = await sessions.prepareExecutionSession(preparation);
     }
     signal.throwIfAborted();
-    operations.markExecutionStarted(command.commandId);
-    if (availability.disposition === SessionPromptDisposition.Steer) {
-      if (!recordSteeringPrompt()) {
-        throw new AcpExecutionError(
-          "The steering target is unavailable",
-          {},
-          "prompt_queue_target_unavailable"
-        );
-      }
+    if (availability.disposition === SessionPromptDisposition.Steer && !steerTargetStarted()) {
+      throw new AcpExecutionError("The steering target is unavailable", {}, "prompt_queue_target_unavailable");
     }
-    const stream = activateAttempt(
-      availability.disposition === SessionPromptDisposition.Steer ? command.targetCommandId : command.commandId
-    );
-    const lifecycle = eventProjection.started(
+    const lifecycle = eventProjection.lifecycle(
       command.sessionId,
       command.commandId,
       attemptId,
-      stream.epoch,
+      epoch,
       availability.disposition
     );
     const attachments = await resolvePromptArtifacts(readArtifact, command.attachments, signal);
@@ -91888,7 +91898,7 @@ async function executePrompt({
     const code = operationErrorCode(error62);
     const failureCode = code === "session_operation_failed" ? "agent_execution_failed" : code;
     const failureMessage = code === "session_operation_failed" ? "The local agent could not complete the request" : operationErrorMessage(error62);
-    await eventProjection.failed(command.sessionId, command.commandId, failureCode, failureMessage);
+    await eventProjection.failed(command.sessionId, command.commandId, attemptId, failureCode, failureMessage);
     reportFailure("session_prompt_failed", command.commandId, {
       agentId: command.agentId,
       code: failureCode,
@@ -91958,7 +91968,6 @@ var sessionPromptCommand = {
       });
     };
     void executePrompt({
-      operations: context.operations,
       eventProjection: context.eventProjection,
       command: message,
       resolveAgent: context.resolveAgent,
@@ -91977,12 +91986,12 @@ var sessionPromptCommand = {
       directories: context.directories,
       sessions: context.sessions,
       attemptId: receipt.attemptId,
-      activateAttempt: turn.activate,
+      epoch: turn.epoch,
       waitForSessionAvailability: (signal) => context.sessionTurns.admitAndWait(turn, signal, () => {
         queueChanged();
       }),
       signal: turn.signal,
-      recordSteeringPrompt: () => context.sessionTurns.recordSteeringPrompt(message),
+      steerTargetStarted: () => context.sessionTurns.steerTargetStarted(message),
       cancellationRequested: turn.cancellationRequested
     }).catch((error62) => {
       console.error("Mobius daemon turn failed", error62);
@@ -93082,7 +93091,7 @@ var RuntimeSessionEventPublisher = class {
           commandId: payload.commandId,
           generationId: event.sessionGenerationId
         });
-      } else if ((payload.kind === "prompt.completed" || payload.kind === "prompt.failed" || payload.kind === "prompt.failed-before-start") && this.#awaitingFirstAnswer.get(event.sessionId)?.commandId === payload.commandId && this.#awaitingFirstAnswer.get(event.sessionId)?.generationId === event.sessionGenerationId) {
+      } else if (isPromptTerminal(payload) && this.#awaitingFirstAnswer.get(event.sessionId)?.commandId === payload.commandId && this.#awaitingFirstAnswer.get(event.sessionId)?.generationId === event.sessionGenerationId) {
         this.#awaitingFirstAnswer.delete(event.sessionId);
       }
       return false;
@@ -93587,4 +93596,4 @@ export {
   * MIT Licensed
   *)
 */
-//# sourceMappingURL=chunk-A62FEGIN.js.map
+//# sourceMappingURL=chunk-7BSIM5AK.js.map