@stigmer/server 3.14.0-dev.20260910084630

package/dist/domain/agentexecution/lifecycle.js

@@ -0,0 +1,570 @@
+/**
+ * The lifecycle RPCs — ports cancel.go, terminate.go, pause.go,
+ * resume.go, recover.go, recreate_execution_context_step.go, and
+ * lifecycle_steps.go: the five phase-transition commands over one shared
+ * step vocabulary.
+ *
+ * Every Temporal touchpoint rides the engine seam. With the engine
+ * disconnected (pre-#18) the Temporal steps refuse
+ * FailedPrecondition("Temporal is not available") — Go's nil-client arm,
+ * asserted by the Class A conformance lifecycle negatives. With a
+ * connected engine, workflow-not-found is warn-and-proceed (the local
+ * state update still applies; the workflow may simply have completed).
+ *
+ * The phase transition + persist is ONE atomic read-modify-write under
+ * the store's per-resource write lock — the lifecycle counterpart of the
+ * UpdateStatus merge chokepoint (pause/cancel/terminate are reachable
+ * from WAITING_FOR_APPROVAL, so the concurrent-SubmitApproval window is
+ * real); lifecycle simply authors no approval events.
+ */
+import { create } from "@bufbuild/protobuf";
+import { ConnectError } from "@connectrpc/connect";
+import { AgentExecutionSchema, AgentExecutionStatusSchema, } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/api_pb";
+import { AgentExecutionCommandController } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/command_pb";
+import { ExecutionPhase, ExecutionPhaseSchema, SubAgentStatus, } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
+import { ExecutionContextSchema } from "@stigmer/protos/ai/stigmer/agentic/executioncontext/v1/api_pb";
+import { ApiResourceKind } from "@stigmer/protos/ai/stigmer/commons/apiresource/apiresourcekind/api_resource_kind_pb";
+import { enumToJson } from "@bufbuild/protobuf";
+import { stepsForSlot } from "../../extensions/gate-slots.js";
+import { failedPreconditionError, internalError, invalidArgumentError, notFoundError, } from "../../pipeline/errors.js";
+import { newPipeline } from "../../pipeline/pipeline.js";
+import { LOADED_EXECUTION_KEY, RequestContext, } from "../../pipeline/request-context.js";
+import { newAuthorizeStep } from "../../pipeline/steps/authorize.js";
+import { ResourceNotFoundError } from "../../store/interface.js";
+import { ensureSessionSandboxForExecution } from "../../sandbox/steps.js";
+import { buildAndPersistExecutionContext } from "./create-execution-context-step.js";
+import { EngineDispatchError, EngineWorkflowNotFoundError } from "./engine.js";
+import { notifyStatusObservers } from "./status-observers.js";
+import { settleInterruptedToolCalls } from "./tool-call-settle.js";
+// Context keys — Go's key strings, verbatim. The loaded-execution key is
+// the shared pipeline constant (request-context.ts): extension gate steps
+// in the recover slot read the loaded execution through it.
+const REASON_KEY = "reason";
+const ALREADY_IN_TARGET_STATE_KEY = "alreadyInTargetState";
+/** The pinned no-engine refusal (Go "Temporal is not available"). */
+export const TEMPORAL_UNAVAILABLE_MESSAGE = "Temporal is not available";
+// ---------------------------------------------------------------------------
+// Shared steps (lifecycle_steps.go).
+// ---------------------------------------------------------------------------
+function newLoadExecutionByIdStep(deps) {
+    return {
+        name: "LoadExecutionById",
+        async execute(ctx) {
+            const executionId = ctx.newState.id;
+            if (executionId === "") {
+                throw invalidArgumentError("execution id is required");
+            }
+            let execution;
+            try {
+                execution = await deps.store.getResource(ApiResourceKind.agent_execution, executionId, AgentExecutionSchema);
+            }
+            catch {
+                // Go converts every load failure here to the same NotFound.
+                throw notFoundError("agent_execution", executionId);
+            }
+            ctx.set(LOADED_EXECUTION_KEY, execution);
+        },
+    };
+}
+function loadedExecution(ctx) {
+    return ctx.get(LOADED_EXECUTION_KEY);
+}
+function phaseName(phase) {
+    return enumToJson(ExecutionPhaseSchema, phase);
+}
+/**
+ * The five phase-validation steps share one shape: an already-in-target
+ * phase is idempotent success (skips the remaining steps), a phase
+ * outside the allowed set refuses FailedPrecondition with the pinned
+ * per-verb copy.
+ */
+function newValidatePhaseStep(config) {
+    return {
+        name: config.name,
+        execute(ctx) {
+            const execution = loadedExecution(ctx);
+            const phase = execution.status?.phase ?? ExecutionPhase.EXECUTION_PHASE_UNSPECIFIED;
+            if (phase === config.targetPhase) {
+                config.logger.debug("Execution already in target state, returning success (idempotent)", { executionId: execution.metadata?.id ?? "" });
+                ctx.set(ALREADY_IN_TARGET_STATE_KEY, true);
+                return;
+            }
+            if (!config.allowed.includes(phase)) {
+                throw failedPreconditionError(config.refusal(phase));
+            }
+        },
+    };
+}
+/**
+ * The engine-facing lifecycle steps: skip when already in target state,
+ * refuse FailedPrecondition when disconnected (Go's nil temporalClient),
+ * warn-and-proceed on workflow-not-found (the workflow may have already
+ * completed; the local state update still applies).
+ */
+function newEngineLifecycleStep(config) {
+    return {
+        name: config.name,
+        async execute(ctx) {
+            if (ctx.get(ALREADY_IN_TARGET_STATE_KEY) === true) {
+                return;
+            }
+            const engine = config.deps.engineState();
+            if (!engine.connected) {
+                throw failedPreconditionError(TEMPORAL_UNAVAILABLE_MESSAGE);
+            }
+            const execution = loadedExecution(ctx);
+            const executionId = execution.metadata?.id ?? "";
+            try {
+                await config.invoke(engine, executionId, ctx);
+            }
+            catch (error) {
+                if (error instanceof EngineWorkflowNotFoundError) {
+                    config.deps.logger.warn("Temporal workflow not found, may have already completed", { executionId });
+                    return;
+                }
+                throw internalError(error, config.failureMessage);
+            }
+        },
+    };
+}
+/**
+ * Applies a lifecycle phase transition in place: target phase +
+ * phase-dependent fields (completed_at, error, the terminal sub-agent
+ * cascade, the terminal tool-call settle #207, the terminal
+ * pending_approvals clear). The body run inside the updateResource
+ * closure — the transition is computed against the very snapshot that
+ * will be persisted (Go applyLifecyclePhaseTransition, exercised directly
+ * by the lifecycle unit tests).
+ */
+export function applyLifecyclePhaseTransition(execution, targetPhase, setError, clearError, reason) {
+    execution.status ??= create(AgentExecutionStatusSchema);
+    const status = execution.status;
+    status.phase = targetPhase;
+    // completed_at for terminal phases; PAUSED is NOT terminal.
+    if (targetPhase === ExecutionPhase.EXECUTION_CANCELLED ||
+        targetPhase === ExecutionPhase.EXECUTION_TERMINATED) {
+        const now = new Date().toISOString().replace(/\.\d{3}Z$/, "Z");
+        status.completedAt = now;
+        // Cascade to in-flight sub-agents: a cancelled/terminated parent
+        // leaves no live delegation, so IN_PROGRESS/PENDING sub-agents move
+        // to CANCELLED — never a permanent "Running" zombie. Authoritative
+        // here: the runner's own cancellation persist is best-effort and can
+        // be lost to the cancellation race.
+        cancelInProgressSubAgents(status.subAgentExecutions, now);
+        // Same cascade for in-flight tool calls (issue #207) — authoritative
+        // for force-kill, where the runner never gets a finalize.
+        settleInterruptedToolCalls(status, now);
+        // A terminal execution has no actionable approvals; this blind clear
+        // keeps the invariant on the bypass paths too, edition-consistently
+        // with the Cloud terminal handlers (the graceful-cancel case is also
+        // cleared later by the workflow cleanup running the seam).
+        status.pendingApprovals = [];
+    }
+    // Clear completed_at for recovery / resume back to IN_PROGRESS.
+    if (targetPhase === ExecutionPhase.EXECUTION_IN_PROGRESS) {
+        status.completedAt = "";
+    }
+    if (setError) {
+        status.error =
+            reason !== "" ? `Terminated: ${reason}` : "Terminated by user";
+    }
+    if (clearError) {
+        status.error = "";
+    }
+}
+/**
+ * Transitions non-terminal sub-agents (IN_PROGRESS/PENDING) to CANCELLED
+ * with a completion timestamp (only when empty, preserving any
+ * runner-recorded one) — Go cancelInProgressSubAgents.
+ */
+export function cancelInProgressSubAgents(subAgents, completedAt) {
+    for (const sa of subAgents) {
+        // Go skips nil elements (lifecycle_cancel_cascade_test.go NilSafe);
+        // the defensive twin for a hole smuggled past the type system.
+        if (sa === undefined) {
+            continue;
+        }
+        if (sa.status === SubAgentStatus.SUB_AGENT_IN_PROGRESS ||
+            sa.status === SubAgentStatus.SUB_AGENT_PENDING) {
+            sa.status = SubAgentStatus.SUB_AGENT_CANCELLED;
+            if (sa.completedAt === "") {
+                sa.completedAt = completedAt;
+            }
+        }
+    }
+}
+/**
+ * The atomic phase-transition persist (Go
+ * UpdateExecutionPhaseAndPersistStep): one read-modify-write under the
+ * per-resource write lock, so an approval event a concurrent
+ * SubmitApproval appends between the earlier load and this persist can
+ * never be lost. UpdateResource requires existence (no upsert): a
+ * lifecycle op racing a delete returns NOT_FOUND rather than resurrecting
+ * a half-built document.
+ */
+function newUpdateExecutionPhaseAndPersistStep(deps, targetPhase, setError, clearError) {
+    return {
+        name: "UpdateExecutionPhaseAndPersist",
+        async execute(ctx) {
+            if (ctx.get(ALREADY_IN_TARGET_STATE_KEY) === true) {
+                return;
+            }
+            const execution = loadedExecution(ctx);
+            const executionId = execution.metadata?.id ?? "";
+            const reasonValue = ctx.get(REASON_KEY);
+            const reason = typeof reasonValue === "string" ? reasonValue : "";
+            let updated;
+            let oldPhase = ExecutionPhase.EXECUTION_PHASE_UNSPECIFIED;
+            try {
+                updated = await deps.store.updateResource(ApiResourceKind.agent_execution, executionId, AgentExecutionSchema, (loaded) => {
+                    oldPhase =
+                        loaded.status?.phase ??
+                            ExecutionPhase.EXECUTION_PHASE_UNSPECIFIED;
+                    applyLifecyclePhaseTransition(loaded, targetPhase, setError, clearError, reason);
+                });
+            }
+            catch (error) {
+                if (error instanceof ResourceNotFoundError) {
+                    throw notFoundError("agent_execution", executionId);
+                }
+                throw internalError(error, "failed to persist execution");
+            }
+            // O4 site 2 of 5 (status-observers.ts): observers see the persisted
+            // transition before LifecycleBroadcast runs — broadcast stays last.
+            await notifyStatusObservers(deps, updated, oldPhase, targetPhase);
+            // Hand the persisted result to the broadcast step and the handler's
+            // return value (both read the same key).
+            ctx.set(LOADED_EXECUTION_KEY, updated);
+        },
+    };
+}
+/** Publishes the transition to live subscribers (Go LifecycleBroadcastStep). */
+function newLifecycleBroadcastStep(deps) {
+    return {
+        name: "LifecycleBroadcast",
+        execute(ctx) {
+            if (ctx.get(ALREADY_IN_TARGET_STATE_KEY) === true) {
+                return;
+            }
+            deps.broker.broadcast(loadedExecution(ctx));
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// The five RPCs.
+// ---------------------------------------------------------------------------
+async function runLifecyclePipeline(deps, pipelineName, schema, input, method, identity, steps) {
+    const reqCtx = new RequestContext(schema, input, identity, ApiResourceKind.agent_execution);
+    const builder = newPipeline(pipelineName, deps.logger);
+    builder.addStep(newAuthorizeStep(method, deps.authorizer));
+    for (const step of steps) {
+        builder.addStep(step);
+    }
+    await builder.build().execute(reqCtx);
+    const execution = reqCtx.get(LOADED_EXECUTION_KEY);
+    if (execution === undefined) {
+        throw internalError(new Error(`execution not found in context after ${pipelineName}`), `execution not found in context after ${pipelineName.replace("agentexecution-", "")} pipeline`);
+    }
+    return execution;
+}
+/**
+ * Cancel — graceful cancellation via the workflow's cancel signal; the
+ * agent can save checkpoint and clean up before CANCELLED.
+ */
+export async function cancelExecution(deps, input, identity) {
+    deps.logger.info("Cancel agent execution request", {
+        executionId: input.id,
+        reason: input.reason,
+    });
+    return runLifecyclePipeline(deps, "agentexecution-cancel", AgentExecutionCommandController.method.cancel.input, input, AgentExecutionCommandController.method.cancel, identity, [
+        newLoadExecutionByIdStep(deps),
+        newValidatePhaseStep({
+            name: "ValidateCancellable",
+            targetPhase: ExecutionPhase.EXECUTION_CANCELLED,
+            allowed: [
+                ExecutionPhase.EXECUTION_PENDING,
+                ExecutionPhase.EXECUTION_IN_PROGRESS,
+            ],
+            refusal: (phase) => `cannot cancel execution in phase ${phaseName(phase)}; only PENDING or IN_PROGRESS can be cancelled`,
+            logger: deps.logger,
+        }),
+        newEngineLifecycleStep({
+            name: "CancelTemporalWorkflow",
+            deps,
+            invoke: (engine, executionId) => engine.engine.cancelWorkflow(executionId),
+            failureMessage: "failed to cancel Temporal workflow",
+        }),
+        newUpdateExecutionPhaseAndPersistStep(deps, ExecutionPhase.EXECUTION_CANCELLED, false, false),
+        newLifecycleBroadcastStep(deps),
+    ]);
+}
+/** Terminate — the forceful sibling: terminates the workflow, sets error. */
+export async function terminateExecution(deps, input, identity) {
+    deps.logger.info("Terminate agent execution request", {
+        executionId: input.id,
+        reason: input.reason,
+    });
+    return runLifecyclePipeline(deps, "agentexecution-terminate", AgentExecutionCommandController.method.terminate.input, input, AgentExecutionCommandController.method.terminate, identity, [
+        newLoadExecutionByIdStep(deps),
+        newValidatePhaseStep({
+            name: "ValidateTerminable",
+            targetPhase: ExecutionPhase.EXECUTION_TERMINATED,
+            allowed: [
+                ExecutionPhase.EXECUTION_PENDING,
+                ExecutionPhase.EXECUTION_IN_PROGRESS,
+            ],
+            refusal: (phase) => `cannot terminate execution in phase ${phaseName(phase)}; only PENDING or IN_PROGRESS can be terminated`,
+            logger: deps.logger,
+        }),
+        newEngineLifecycleStep({
+            name: "TerminateTemporalWorkflow",
+            deps,
+            invoke: async (engine, executionId, ctx) => {
+                const reason = ctx.newState.reason ||
+                    "Terminated by user";
+                await engine.engine.terminateWorkflow(executionId, reason);
+                // Store the resolved reason for the phase update's error text.
+                ctx.set(REASON_KEY, reason);
+            },
+            failureMessage: "failed to terminate Temporal workflow",
+        }),
+        newUpdateExecutionPhaseAndPersistStep(deps, ExecutionPhase.EXECUTION_TERMINATED, true, false),
+        newLifecycleBroadcastStep(deps),
+    ]);
+}
+/** Pause — signals the workflow's pause gate; PAUSED is resumable. */
+export async function pauseExecution(deps, input, identity) {
+    deps.logger.info("Pause agent execution request", {
+        executionId: input.id,
+        reason: input.reason,
+    });
+    return runLifecyclePipeline(deps, "agentexecution-pause", AgentExecutionCommandController.method.pause.input, input, AgentExecutionCommandController.method.pause, identity, [
+        newLoadExecutionByIdStep(deps),
+        newValidatePhaseStep({
+            name: "ValidatePausable",
+            targetPhase: ExecutionPhase.EXECUTION_PAUSED,
+            allowed: [
+                ExecutionPhase.EXECUTION_PENDING,
+                ExecutionPhase.EXECUTION_IN_PROGRESS,
+            ],
+            refusal: (phase) => `cannot pause execution in phase ${phaseName(phase)}; only PENDING or IN_PROGRESS can be paused`,
+            logger: deps.logger,
+        }),
+        newEngineLifecycleStep({
+            name: "SignalPauseToTemporal",
+            deps,
+            invoke: async (engine, executionId, ctx) => {
+                const reason = ctx.newState.reason ||
+                    "Paused by user";
+                await engine.engine.signalPause(executionId, reason);
+                ctx.set(REASON_KEY, reason);
+            },
+            failureMessage: "failed to send pause signal to Temporal workflow",
+        }),
+        newUpdateExecutionPhaseAndPersistStep(deps, ExecutionPhase.EXECUTION_PAUSED, false, false),
+        newLifecycleBroadcastStep(deps),
+    ]);
+}
+/** Resume — signals the pause gate open; PAUSED → IN_PROGRESS. */
+export async function resumeExecution(deps, input, identity) {
+    deps.logger.info("Resume agent execution request", {
+        executionId: input.id,
+    });
+    return runLifecyclePipeline(deps, "agentexecution-resume", AgentExecutionCommandController.method.resume.input, input, AgentExecutionCommandController.method.resume, identity, [
+        newLoadExecutionByIdStep(deps),
+        newValidatePhaseStep({
+            name: "ValidateResumable",
+            targetPhase: ExecutionPhase.EXECUTION_IN_PROGRESS,
+            allowed: [ExecutionPhase.EXECUTION_PAUSED],
+            refusal: (phase) => `cannot resume execution in phase ${phaseName(phase)}; only PAUSED executions can be resumed`,
+            logger: deps.logger,
+        }),
+        newEngineLifecycleStep({
+            name: "SignalResumeToTemporal",
+            deps,
+            invoke: (engine, executionId) => engine.engine.signalResume(executionId),
+            failureMessage: "failed to send resume signal to Temporal workflow",
+        }),
+        newUpdateExecutionPhaseAndPersistStep(deps, ExecutionPhase.EXECUTION_IN_PROGRESS, false, false),
+        newLifecycleBroadcastStep(deps),
+    ]);
+}
+/**
+ * Recover — terminate-and-start-fresh for FAILED executions (deliberately
+ * NOT Temporal reset: the runner activity RETURNS its FAILED result, so a
+ * reset replays the preserved failure instead of re-dispatching, issue
+ * #200; continuity is carried by the harness state, not Temporal
+ * history). Order rationale: terminate BEFORE EC recreation (a still-live
+ * old workflow's cleanup must not delete the new EC); recreate EC BEFORE
+ * workflow start (the runner's setup needs env); start BEFORE the phase
+ * update (a failed start leaves the execution FAILED — recover retries).
+ */
+export async function recoverExecution(deps, input, identity) {
+    deps.logger.info("Recover agent execution request", {
+        executionId: input.id,
+    });
+    return runLifecyclePipeline(deps, "agentexecution-recover", AgentExecutionCommandController.method.recover.input, input, AgentExecutionCommandController.method.recover, identity, [
+        newLoadExecutionByIdStep(deps),
+        newValidatePhaseStep({
+            name: "ValidateRecoverable",
+            targetPhase: ExecutionPhase.EXECUTION_IN_PROGRESS,
+            allowed: [ExecutionPhase.EXECUTION_FAILED],
+            refusal: (phase) => `cannot recover execution in phase ${phaseName(phase)}; only FAILED executions can be recovered`,
+            logger: deps.logger,
+        }),
+        // TerminateExistingWorkflow: a FAILED execution's workflow has
+        // normally already completed (NOT_FOUND = success); termination
+        // matters for the rarer DB-says-FAILED-but-workflow-live state —
+        // the workflow ID must be terminal before the fresh start reuses
+        // it.
+        newEngineLifecycleStep({
+            name: "TerminateExistingWorkflow",
+            deps,
+            invoke: (engine, executionId) => engine.engine.terminateWorkflow(executionId, "Recovery: terminating before fresh workflow start"),
+            failureMessage: "failed to terminate previous workflow during recovery",
+        }),
+        // The ratified pre-side-effect gate slot (blueprint 03 §3a; O4):
+        // after workflow termination, before re-launch side effects — the
+        // verified RearmBillingStep ordering (a terminated workflow issues
+        // no new settles). Empty in OSS.
+        ...stepsForSlot(deps.gateSteps, "agent-execution-recover:pre-side-effect-gate"),
+        newRecreateExecutionContextStep(deps),
+        newStartFreshWorkflowStep(deps),
+        // The session-lane sandbox ensure (§6d, O6) — same position and
+        // non-critical posture as the create chain's step: after the
+        // workflow start, never failing the recover (the shared body
+        // pre-stamps failures onto status.error instead).
+        {
+            name: "EnsureSessionSandbox",
+            async execute(ctx) {
+                if (ctx.get(ALREADY_IN_TARGET_STATE_KEY) === true) {
+                    return;
+                }
+                await ensureSessionSandboxForExecution({
+                    store: deps.store,
+                    logger: deps.logger,
+                    lane: deps.sandboxLane,
+                    temporalConfig: deps.temporalConfig,
+                }, loadedExecution(ctx), ctx.callerIdentity.identityId);
+            },
+        },
+        newUpdateExecutionPhaseAndPersistStep(deps, ExecutionPhase.EXECUTION_IN_PROGRESS, false, true),
+        newLifecycleBroadcastStep(deps),
+    ]);
+}
+/**
+ * Rebuilds the ExecutionContext for a recovered execution (Go
+ * recreateExecutionContextStep): the failed run's workflow cleanup
+ * deleted the EC, so a fresh start would hydrate with an empty
+ * environment. Re-resolving from CURRENT configuration is the point
+ * ("fix the API key, then recover"). DELIBERATE divergence from
+ * WorkflowExecution's graceful recreate: a failure here FAILS the
+ * recover RPC — the agent EC carries OAuth tokens and declared env vars
+ * the run genuinely needs; the execution stays FAILED and recover can be
+ * retried. Stale-EC delete first (best-effort): the failure-path cleanup
+ * is itself best-effort, and the EC name derives from the execution id.
+ */
+function newRecreateExecutionContextStep(deps) {
+    return {
+        name: "RecreateExecutionContext",
+        async execute(ctx) {
+            if (ctx.get(ALREADY_IN_TARGET_STATE_KEY) === true) {
+                return;
+            }
+            const execution = loadedExecution(ctx);
+            const executionId = execution.metadata?.id ?? "";
+            await deleteStaleExecutionContext(deps, executionId);
+            // No pre-resolved instance id on the recover path: a persisted
+            // execution always carries session_id (the create pipeline
+            // guarantees it), so the builder resolves via the session. Go wraps
+            // with %w — the inner status code survives to the wire (notably the
+            // FailedPrecondition OAuth pre-flight refusal and NotFound loads,
+            // exactly as the same failure surfaces on the create path); plain
+            // errors chain to the pipeline's Internal fallback.
+            try {
+                await buildAndPersistExecutionContext(deps.executionContextBuilder, execution, "");
+            }
+            catch (error) {
+                if (error instanceof ConnectError) {
+                    throw new ConnectError(`recreate execution context for recovered execution ${executionId}: ${error.rawMessage}`, error.code);
+                }
+                throw new Error(`recreate execution context for recovered execution ${executionId}: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        },
+    };
+}
+/** Best-effort stale-EC removal before recreation. */
+async function deleteStaleExecutionContext(deps, executionId) {
+    let existing;
+    try {
+        existing = await deps.store.findByField(ApiResourceKind.execution_context, "spec.executionId", executionId, ExecutionContextSchema);
+    }
+    catch {
+        return;
+    }
+    const ecId = existing.metadata?.id ?? "";
+    if (ecId === "") {
+        return;
+    }
+    deps.logger.info("Deleting stale ExecutionContext before recreation", {
+        executionContextId: ecId,
+        executionId,
+    });
+    try {
+        await deps.store.deleteResource(ApiResourceKind.execution_context, ecId);
+    }
+    catch (error) {
+        deps.logger.warn("Failed to delete stale ExecutionContext (proceeding anyway)", {
+            executionContextId: ecId,
+            error: error instanceof Error ? error.message : String(error),
+        });
+    }
+}
+/**
+ * Starts a brand-new workflow for the recovered execution (Go
+ * StartFreshWorkflowStep): Temporal allows workflow-id reuse after the
+ * previous run reached a terminal state. Dispatch is re-resolved with an
+ * EMPTY activity_task_queue override and the parent-coupled coordinates
+ * (callback_token, parent_workflow_id) are deliberately NOT carried — a
+ * recovered execution is a standalone rerun (the single-use token was
+ * already completed with the failure; the parent already observed the
+ * failure; the parent's sandbox queue loses its poller when the parent
+ * completes). Known documented limitation: a durable (http) LangGraph
+ * checkpointer would duplicate the user message; the OSS default memory
+ * checkpointer replays from scratch, so this is moot here.
+ */
+function newStartFreshWorkflowStep(deps) {
+    return {
+        name: "StartFreshWorkflow",
+        async execute(ctx) {
+            if (ctx.get(ALREADY_IN_TARGET_STATE_KEY) === true) {
+                return;
+            }
+            const engine = deps.engineState();
+            if (!engine.connected) {
+                throw failedPreconditionError("Temporal is not available (workflow creator not set)");
+            }
+            const execution = loadedExecution(ctx);
+            const executionId = execution.metadata?.id ?? "";
+            try {
+                await engine.engine.startInvokeWorkflow({
+                    executionId,
+                    sessionId: execution.spec?.sessionId ?? "",
+                    agentId: execution.spec?.agentId ?? "",
+                    callbackToken: new Uint8Array(),
+                    autoApproveAll: execution.spec?.autoApproveAll ?? false,
+                    parentWorkflowId: "",
+                    activityTaskQueueOverride: "",
+                });
+            }
+            catch (error) {
+                if (error instanceof EngineDispatchError) {
+                    throw failedPreconditionError(error.message);
+                }
+                throw internalError(error, "failed to start fresh Temporal workflow for recovered execution");
+            }
+            deps.logger.info("Started fresh Temporal workflow for recovered execution", { executionId });
+        },
+    };
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/domain/agentexecution/lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../../../src/domain/agentexecution/lifecycle.ts"],"names":[],"mappings":"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"}

package/dist/domain/agentexecution/phases.d.ts

@@ -0,0 +1,22 @@
+/**
+ * The domain's TWO deliberately-distinct terminal-phase predicates —
+ * package-level functions in Go (subscribe.go / tool_call_settle.go),
+ * shared here so every consumer names the same sets.
+ *
+ * isTerminalExecutionPhase answers "will this execution ever run again?"
+ * — COMPLETED / FAILED / CANCELLED / TERMINATED. TERMINATED executions
+ * will not run, so their in-flight tool calls must settle and their
+ * phase latches.
+ *
+ * isTranscriptTerminalPhase (Go subscribe.go isTerminalPhase) OMITS
+ * TERMINATED: the transcript regression guard uses it so a terminated
+ * execution's committed transcript stays protected from free rewrites,
+ * and the subscribe stream uses it as its close set (the disclosed
+ * never-closes-on-TERMINATED quirk, ported faithfully). Do NOT
+ * "harmonize" the two — the difference is deliberate and documented in
+ * Go.
+ */
+import { ExecutionPhase } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
+export declare function isTerminalExecutionPhase(phase: ExecutionPhase): boolean;
+export declare function isTranscriptTerminalPhase(phase: ExecutionPhase): boolean;
+//# sourceMappingURL=phases.d.ts.map

package/dist/domain/agentexecution/phases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phases.d.ts","sourceRoot":"","sources":["../../../src/domain/agentexecution/phases.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,8DAA8D,CAAC;AAE9F,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAUvE;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAMxE"}

package/dist/domain/agentexecution/phases.js

@@ -0,0 +1,36 @@
+/**
+ * The domain's TWO deliberately-distinct terminal-phase predicates —
+ * package-level functions in Go (subscribe.go / tool_call_settle.go),
+ * shared here so every consumer names the same sets.
+ *
+ * isTerminalExecutionPhase answers "will this execution ever run again?"
+ * — COMPLETED / FAILED / CANCELLED / TERMINATED. TERMINATED executions
+ * will not run, so their in-flight tool calls must settle and their
+ * phase latches.
+ *
+ * isTranscriptTerminalPhase (Go subscribe.go isTerminalPhase) OMITS
+ * TERMINATED: the transcript regression guard uses it so a terminated
+ * execution's committed transcript stays protected from free rewrites,
+ * and the subscribe stream uses it as its close set (the disclosed
+ * never-closes-on-TERMINATED quirk, ported faithfully). Do NOT
+ * "harmonize" the two — the difference is deliberate and documented in
+ * Go.
+ */
+import { ExecutionPhase } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
+export function isTerminalExecutionPhase(phase) {
+    switch (phase) {
+        case ExecutionPhase.EXECUTION_COMPLETED:
+        case ExecutionPhase.EXECUTION_FAILED:
+        case ExecutionPhase.EXECUTION_CANCELLED:
+        case ExecutionPhase.EXECUTION_TERMINATED:
+            return true;
+        default:
+            return false;
+    }
+}
+export function isTranscriptTerminalPhase(phase) {
+    return (phase === ExecutionPhase.EXECUTION_COMPLETED ||
+        phase === ExecutionPhase.EXECUTION_FAILED ||
+        phase === ExecutionPhase.EXECUTION_CANCELLED);
+}
+//# sourceMappingURL=phases.js.map