experimental-ash 0.26.0 → 0.27.0

package/dist/src/execution/workflow-runtime.js

@@ -1,161 +1,3 @@
-import { HookNotFoundError } from "#compiled/@workflow/errors/index.js";
-import { getHookByToken, getRun, resumeHook, start } from "#compiled/@workflow/core/runtime.js";
-import { serializeContext } from "#context/serialize.js";
-import { resolveInstalledPackageInfo } from "#internal/application/package.js";
-import { getCompiledRuntimeAgentBundle } from "#runtime/sessions/compiled-agent-cache.js";
-import { buildRunContext } from "#execution/runtime-context.js";
-import { RuntimeNoActiveSessionError } from "#execution/runtime-errors.js";
-const WORKFLOW_ENTRY_NAME = "workflowEntry";
-const TURN_WORKFLOW_NAME = "turnWorkflow";
-const ASH_PACKAGE_INFO = resolveInstalledPackageInfo();
-export const LATEST_DEPLOYMENT_UNSUPPORTED_MESSAGE = "deploymentId 'latest' requires a World that implements resolveLatestDeploymentId()";
-/**
- * Workflow function names whose bundled id is stable across deployments
- * (no `@<pkg.version>` stamp). The bundler reads this set when emitting
- * the workflow id so cross-deployment routing — `start(ref, args, {
- * deploymentId: "latest" })` — finds the same workflow on a newer
- * deployment even when the ash version differs.
- *
- * Both halves of the contract (bundler output and runtime reference
- * template) read this single set so they cannot drift.
- */
-export const STABLE_WORKFLOW_NAMES = new Set([
-    WORKFLOW_ENTRY_NAME,
-    TURN_WORKFLOW_NAME,
-]);
-const STABLE_ID_BASE = ASH_PACKAGE_INFO.name;
-/**
- * Stable workflow reference used by `start()` to locate the workflow
- * entrypoint registered by the Workflow DevKit builder. The id omits
- * the package version stamp so the long-lived driver can rotate across
- * deployments without rewriting the registry key.
- */
-export const workflowEntryReference = {
-    workflowId: `workflow//${STABLE_ID_BASE}//${WORKFLOW_ENTRY_NAME}`,
-};
-/**
- * Stable workflow reference used by the driver to dispatch per-turn
- * child workflow runs. The id omits the package version stamp so
- * `start(turnWorkflowReference, args, { deploymentId: "latest" })`
- * routes to the latest deployment's turn workflow even when the ash
- * version differs from the caller's deployment.
- */
-export const turnWorkflowReference = {
-    workflowId: `workflow//${STABLE_ID_BASE}//${TURN_WORKFLOW_NAME}`,
-};
-/**
- * Creates a workflow-backed runtime whose long-lived driver owns the
- * session stream and dispatches each turn as a child workflow run.
- */
-export function createWorkflowRuntime(config) {
-    return {
-        async run(input) {
-            const bundle = await getCompiledRuntimeAgentBundle({
-                compiledArtifactsSource: config.compiledArtifactsSource,
-                nodeId: config.nodeId,
-            });
-            const ctx = buildRunContext({ bundle, run: input });
-            const serializedContext = serializeContext(ctx);
-            const run = await startWorkflowPreferLatest(workflowEntryReference, [
-                {
-                    input: input.input,
-                    serializedContext,
-                },
-            ]);
-            return {
-                continuationToken: input.continuationToken ?? run.runId,
-                events: parseNdjsonStream(getRun(run.runId).getReadable()),
-                sessionId: run.runId,
-            };
-        },
-        async deliver(input) {
-            const hookPayload = {
-                auth: input.auth,
-                kind: "deliver",
-                payloads: [input.payload],
-            };
-            try {
-                const hook = normalizeWorkflowHook(await getHookByToken(input.continuationToken));
-                await resumeHook(input.continuationToken, hookPayload);
-                return { sessionId: hook.runId };
-            }
-            catch (error) {
-                // Normalize the workflow-library "no hook" error so callers
-                // depend on the ash-owned class instead of `@workflow/errors`.
-                if (HookNotFoundError.is(error)) {
-                    throw new RuntimeNoActiveSessionError(input.continuationToken);
-                }
-                throw error;
-            }
-        },
-        async getEventStream(sessionId, options) {
-            return parseNdjsonStream(getRun(sessionId).getReadable({ startIndex: options?.startIndex }));
-        },
-    };
-}
-/**
- * Starts a workflow on the latest deployment when the active world supports
- * it, while preserving local/dev worlds that do not implement latest routing.
- */
-export async function startWorkflowPreferLatest(workflow, args) {
-    try {
-        return await start(workflow, args, { deploymentId: "latest" });
-    }
-    catch (error) {
-        if (!isLatestDeploymentUnsupportedError(error)) {
-            throw error;
-        }
-        return await start(workflow, args);
-    }
-}
-function isLatestDeploymentUnsupportedError(error) {
-    return error instanceof Error && error.message.includes(LATEST_DEPLOYMENT_UNSUPPORTED_MESSAGE);
-}
-function normalizeWorkflowHook(value) {
-    if (value === null || typeof value !== "object" || !("runId" in value)) {
-        throw new Error("Workflow hook did not include a run id.");
-    }
-    const runId = value.runId;
-    if (typeof runId !== "string" || runId.length === 0) {
-        throw new Error("Workflow hook did not include a run id.");
-    }
-    return {
-        runId,
-    };
-}
-function parseNdjsonStream(byteStream) {
-    const decoder = new TextDecoder();
-    let buffer = "";
-    return new ReadableStream({
-        async start(controller) {
-            const reader = byteStream.getReader();
-            try {
-                while (true) {
-                    const { value, done } = await reader.read();
-                    if (done) {
-                        const trailing = buffer.trim();
-                        if (trailing.length > 0) {
-                            controller.enqueue(JSON.parse(trailing));
-                        }
-                        controller.close();
-                        return;
-                    }
-                    buffer += decoder.decode(value, { stream: true });
-                    for (let newlineIndex = buffer.indexOf("\n"); newlineIndex !== -1; newlineIndex = buffer.indexOf("\n")) {
-                        const line = buffer.slice(0, newlineIndex).trim();
-                        buffer = buffer.slice(newlineIndex + 1);
-                        if (line.length > 0) {
-                            controller.enqueue(JSON.parse(line));
-                        }
-                    }
-                }
-            }
-            catch (error) {
-                controller.error(error);
-            }
-            finally {
-                reader.releaseLock();
-            }
-        },
-    });
-}
+import{RuntimeNoActiveSessionError}from"#execution/runtime-errors.js";import{resolveInstalledPackageInfo}from"#internal/application/package.js";import{getCompiledRuntimeAgentBundle}from"#runtime/sessions/compiled-agent-cache.js";import{serializeContext}from"#context/serialize.js";import{getHookByToken,getRun,resumeHook,start}from"#compiled/@workflow/core/runtime.js";import{HookNotFoundError}from"#compiled/@workflow/errors/index.js";import{buildRunContext}from"#execution/runtime-context.js";var WORKFLOW_ENTRY_NAME=`workflowEntry`,TURN_WORKFLOW_NAME=`turnWorkflow`,ASH_PACKAGE_INFO=resolveInstalledPackageInfo(),LATEST_DEPLOYMENT_UNSUPPORTED_MESSAGE=`deploymentId 'latest' requires a World that implements resolveLatestDeploymentId()`,STABLE_WORKFLOW_NAMES=new Set([WORKFLOW_ENTRY_NAME,TURN_WORKFLOW_NAME]),STABLE_ID_BASE=ASH_PACKAGE_INFO.name,workflowEntryReference={workflowId:`workflow//${STABLE_ID_BASE}//${WORKFLOW_ENTRY_NAME}`},turnWorkflowReference={workflowId:`workflow//${STABLE_ID_BASE}//${TURN_WORKFLOW_NAME}`};function createWorkflowRuntime(t){return{async run(e){let i=serializeContext(buildRunContext({bundle:await getCompiledRuntimeAgentBundle({compiledArtifactsSource:t.compiledArtifactsSource,nodeId:t.nodeId}),run:e})),o=await startWorkflowPreferLatest(workflowEntryReference,[{input:e.input,serializedContext:i}]);return{continuationToken:e.continuationToken??o.runId,events:parseNdjsonStream(getRun(o.runId).getReadable()),sessionId:o.runId}},async deliver(t){let n={auth:t.auth,kind:`deliver`,payloads:[t.payload]};try{let e=normalizeWorkflowHook(await getHookByToken(t.continuationToken));return await resumeHook(t.continuationToken,n),{sessionId:e.runId}}catch(n){throw HookNotFoundError.is(n)?new RuntimeNoActiveSessionError(t.continuationToken):n}},async getEventStream(e,t){return parseNdjsonStream(getRun(e).getReadable({startIndex:t?.startIndex}))}}}async function startWorkflowPreferLatest(e,t){try{return await start(e,t,{deploymentId:`latest`})}catch(n){if(!isLatestDeploymentUnsupportedError(n))throw n;return await start(e,t)}}function isLatestDeploymentUnsupportedError(e){return e instanceof Error&&e.message.includes(`deploymentId 'latest' requires a World that implements resolveLatestDeploymentId()`)}function normalizeWorkflowHook(e){if(typeof e!=`object`||!e||!(`runId`in e))throw Error(`Workflow hook did not include a run id.`);let t=e.runId;if(typeof t!=`string`||t.length===0)throw Error(`Workflow hook did not include a run id.`);return{runId:t}}function parseNdjsonStream(e){let t=new TextDecoder,n=``;return new ReadableStream({async start(r){let i=e.getReader();try{for(;;){let{value:e,done:a}=await i.read();if(a){let e=n.trim();e.length>0&&r.enqueue(JSON.parse(e)),r.close();return}n+=t.decode(e,{stream:!0});for(let e=n.indexOf(`
+`);e!==-1;e=n.indexOf(`
+`)){let t=n.slice(0,e).trim();n=n.slice(e+1),t.length>0&&r.enqueue(JSON.parse(t))}}}catch(e){r.error(e)}finally{i.releaseLock()}}})}export{LATEST_DEPLOYMENT_UNSUPPORTED_MESSAGE,STABLE_WORKFLOW_NAMES,createWorkflowRuntime,startWorkflowPreferLatest,turnWorkflowReference,workflowEntryReference};

package/dist/src/execution/workflow-steps.js

@@ -1,467 +1 @@
-import { buildAdapterContext } from "#channel/adapter-context.js";
-import { callAdapterEventHandler, defaultDeliverResult } from "#channel/adapter.js";
-import { dispatchStreamEventHooks, runHookLifecycleStep } from "#context/hook-lifecycle.js";
-import { AuthKey, BundleKey, CapabilitiesKey, ChannelKey, ContinuationTokenKey, InitiatorAuthKey, ModeKey, } from "#context/keys.js";
-import { runStep } from "#context/run-step.js";
-import { deserializeContext, serializeContext } from "#context/serialize.js";
-import { isHarnessBetweenTurns } from "#harness/emission.js";
-import { coalesceTurnInputs } from "#harness/messages.js";
-import { upsertProxyInputRequests } from "#harness/proxy-input-requests.js";
-import { getPendingRuntimeActionBatch, recordPendingSubagentChildToken, } from "#harness/runtime-actions.js";
-import { createLogger, formatError } from "#internal/logging.js";
-import { createSessionFailedEvent, createSubagentCalledEvent, encodeMessageStreamEvent, timestampHandleMessageStreamEvent, } from "#protocol/message.js";
-import { PendingConnectionToolCallsKey, } from "#runtime/framework-tools/pending-connection-tool-calls.js";
-import { getCompiledRuntimeAgentBundle } from "#runtime/sessions/compiled-agent-cache.js";
-import { createExecutionNodeStep } from "#execution/node-step.js";
-import { resolveRemoteAgentForAction, startRemoteAgentSession, } from "#execution/remote-agent-dispatch.js";
-import { emitProxiedInputRequest, routeDeliverPayload } from "#execution/subagent-hitl-proxy.js";
-import { createSession, refreshSessionFromTurnAgent } from "#execution/session.js";
-import { buildSubagentRunInput } from "#execution/subagent-tool.js";
-import { turnWorkflow } from "#execution/turn-workflow.js";
-import { createWorkflowRuntime, startWorkflowPreferLatest, workflowEntryReference, } from "#execution/workflow-runtime.js";
-import { toErrorMessage } from "#shared/errors.js";
-/**
- * Runs one atomic harness step inside a durable `"use step"` boundary.
- */
-export async function turnStep(input) {
-    "use step";
-    const ctx = await deserializeContext(input.serializedContext);
-    const adapter = ctx.require(ChannelKey);
-    // Apply deliver-time auth if present. The auth traveled through
-    // resumeHook as JSON on the HookPayload. On the first turn (from
-    // run()), input carries no auth because it was already seeded by
-    // buildRunContext.
-    if (input.input?.kind === "deliver" && input.input.auth !== undefined) {
-        ctx.set(AuthKey, input.input.auth ?? null);
-    }
-    // Build the adapter context for deliver and event handlers.
-    // Slack adapters override this to inject ctx.thread and ctx.slack.
-    const adapterCtx = buildAdapterContext(adapter, ctx);
-    // Run the adapter's deliver hook for each queued payload — sets
-    // custom context keys and optionally transforms the message.
-    // Coalesces the resulting StepInput values.
-    let resolved;
-    if (input.input?.kind === "deliver") {
-        const results = [];
-        for (const payload of input.input.payloads) {
-            const result = adapter.deliver
-                ? await adapter.deliver(payload, adapterCtx)
-                : defaultDeliverResult(payload);
-            if (result !== undefined && result !== null) {
-                results.push(result);
-            }
-        }
-        resolved = results.length === 0 ? undefined : results.reduce(coalesceTurnInputs);
-    }
-    else if (input.input?.kind === "runtime-action-result") {
-        resolved = { runtimeActionResults: input.input.results };
-    }
-    // Update adapter state on context after deliver mutations.
-    if (input.input?.kind === "deliver") {
-        const updatedAdapter = { ...adapter, state: { ...adapterCtx.state } };
-        ctx.set(ChannelKey, updatedAdapter);
-    }
-    // Adapter handled the delivery inline (e.g. a Slack interaction that
-    // only edits a message). Persist any context mutations and re-park
-    // without running a model turn.
-    if (input.input?.kind === "deliver" && resolved === undefined) {
-        const rekeyed = reconcileSessionContinuationToken(ctx, input.session);
-        const nextSerializedContext = serializeContext(ctx);
-        return {
-            action: "park",
-            serializedContext: nextSerializedContext,
-            session: rekeyed,
-        };
-    }
-    const writer = input.parentWritable.getWriter();
-    const hookRegistry = ctx.require(BundleKey).hookRegistry;
-    const emit = async (event) => {
-        const toEmit = await callAdapterEventHandler(adapter, event, adapterCtx);
-        ctx.set(ChannelKey, { ...adapter, state: { ...adapterCtx.state } });
-        await writer.write(encodeMessageStreamEvent(timestampHandleMessageStreamEvent(toEmit)));
-        await dispatchStreamEventHooks({ ctx, registry: hookRegistry, event: toEmit });
-    };
-    let stepResult = await runStep(ctx, input.session, async (enrichedSession) => {
-        const bundle = ctx.require(BundleKey);
-        const capabilities = ctx.get(CapabilitiesKey);
-        const mode = ctx.require(ModeKey);
-        const runHarnessStep = async (lifecycleSession, stepInput) => {
-            const refreshedSession = refreshSessionFromTurnAgent({
-                compactionOverrides: {
-                    thresholdPercent: bundle.resolvedAgent.config.compaction?.thresholdPercent,
-                },
-                session: lifecycleSession,
-                turnAgent: bundle.turnAgent,
-            });
-            const step = createExecutionNodeStep({
-                capabilities,
-                compiledArtifactsSource: bundle.compiledArtifactsSource,
-                createRuntime: createWorkflowRuntime,
-                emit,
-                mode,
-                node: bundle.graph.root,
-            });
-            return step(refreshedSession, stepInput);
-        };
-        // Lifecycle hooks fire only at the start of a new turn — when the
-        // workflow has freshly delivered input and the harness is between
-        // turns. Tool-loop continuations and runtime-action resumes
-        // (where the harness still owns an active turn) skip the
-        // lifecycle stack.
-        if (resolved !== undefined && isHarnessBetweenTurns(enrichedSession)) {
-            return runHookLifecycleStep({
-                ctx,
-                emit,
-                input: resolved,
-                mode,
-                registry: bundle.hookRegistry,
-                session: enrichedSession,
-            }, runHarnessStep);
-        }
-        return runHarnessStep(enrichedSession, resolved);
-    });
-    // Reconcile the session's continuation token with `ContinuationTokenKey`
-    // in case a handler called `session.setContinuationToken(...)` during
-    // the turn (e.g. Slack's auto-anchor on first post). Idempotent when
-    // the token is unchanged.
-    const rekeyed = reconcileSessionContinuationToken(ctx, stepResult.session);
-    const nextSerializedContext = serializeContext(ctx);
-    stepResult = { ...stepResult, session: rekeyed };
-    // Interactive OAuth. When the step left one or more pending
-    // connection tool calls (placeholders written to history) and at
-    // least one matching pending authorization, the workflow body owns
-    // the next action: mint webhooks, run startAuthorization /
-    // completeAuthorization in steps, retry the pending calls, and
-    // splice real results over placeholders. The pending entries stay
-    // on the context so the orchestrator can read them from the
-    // serialized context; the resolve step clears them after
-    // successful retry.
-    const pendingToolCalls = ctx.get(PendingConnectionToolCallsKey) ?? [];
-    if (pendingToolCalls.length > 0) {
-        writer.releaseLock();
-        return {
-            action: "await-authorization",
-            pendingToolCalls,
-            serializedContext: nextSerializedContext,
-            session: stepResult.session,
-        };
-    }
-    if (stepResult.next !== null &&
-        typeof stepResult.next === "object" &&
-        "done" in stepResult.next) {
-        await writer.close();
-        return {
-            action: "done",
-            output: stepResult.next.output,
-            serializedContext: nextSerializedContext,
-            session: stepResult.session,
-        };
-    }
-    if (stepResult.next === null) {
-        writer.releaseLock();
-        return {
-            action: "park",
-            serializedContext: nextSerializedContext,
-            session: stepResult.session,
-        };
-    }
-    writer.releaseLock();
-    return {
-        action: "continue",
-        serializedContext: nextSerializedContext,
-        session: stepResult.session,
-    };
-}
-/**
- * Reconciles `session.continuationToken` with the live
- * `ContinuationTokenKey` value in context.
- *
- * Channels mutate the token by calling
- * `ctx.session.setContinuationToken(...)`, which writes through to
- * `ContinuationTokenKey`. The serialized context picks the new value
- * up automatically, but the in-memory {@link HarnessSession} the
- * workflow body carries needs to be re-stamped so its `parkToken`
- * read after the step reflects the re-key.
- *
- * Exported for unit testing; the workflow runtime is the only
- * production caller.
- */
-export function reconcileSessionContinuationToken(ctx, session) {
-    const next = ctx.get(ContinuationTokenKey);
-    if (next === undefined || next === session.continuationToken)
-        return session;
-    return { ...session, continuationToken: next };
-}
-/**
- * Starts every pending runtime action for the parked parent session.
- *
- * This currently supports delegated subagent calls only. Each child run starts
- * in task mode, emits a parent `subagent.called` control-plane event, and then
- * runs independently on its own public child stream.
- */
-export async function dispatchPendingRuntimeActionsStep(input) {
-    "use step";
-    const batch = getPendingRuntimeActionBatch(input.session);
-    if (batch === undefined || batch.actions.length === 0) {
-        return { results: [], session: input.session };
-    }
-    const ctx = await deserializeContext(input.serializedContext);
-    const bundle = ctx.require(BundleKey);
-    const adapter = ctx.require(ChannelKey);
-    const auth = ctx.get(AuthKey) ?? null;
-    const capabilities = ctx.get(CapabilitiesKey);
-    const initiatorAuth = ctx.get(InitiatorAuthKey) ?? null;
-    const writer = input.parentWritable.getWriter();
-    const adapterCtx = buildAdapterContext(adapter, ctx);
-    let nextSession = input.session;
-    const results = [];
-    try {
-        for (const action of batch.actions) {
-            let childSessionId;
-            let name;
-            let remote;
-            let toolName;
-            switch (action.kind) {
-                case "subagent-call": {
-                    const childRuntime = createWorkflowRuntime({
-                        compiledArtifactsSource: bundle.compiledArtifactsSource,
-                        nodeId: action.nodeId,
-                    });
-                    const { childContinuationToken, runInput } = buildSubagentRunInput({
-                        action,
-                        auth,
-                        batchEvent: batch.event,
-                        capabilities,
-                        initiatorAuth,
-                        session: input.session,
-                    });
-                    const handle = await childRuntime.run(runInput);
-                    nextSession = recordPendingSubagentChildToken({
-                        callId: action.callId,
-                        childContinuationToken,
-                        session: nextSession,
-                    });
-                    childSessionId = handle.sessionId;
-                    name = action.name;
-                    toolName = action.subagentName;
-                    break;
-                }
-                case "remote-agent-call": {
-                    let resolvedRemote;
-                    try {
-                        resolvedRemote = resolveRemoteAgentForAction({
-                            nodeId: action.nodeId,
-                            remoteAgentName: action.remoteAgentName,
-                            registry: bundle.subagentRegistry.subagentsByNodeId,
-                        });
-                        childSessionId = await startRemoteAgentSession({
-                            action,
-                            callbackBaseUrl: input.callbackBaseUrl,
-                            remote: resolvedRemote,
-                            session: input.session,
-                        });
-                    }
-                    catch (error) {
-                        results.push(createRemoteAgentStartFailureResult({ action, error }));
-                        continue;
-                    }
-                    name = action.name;
-                    remote = { url: resolvedRemote.url };
-                    toolName = action.remoteAgentName;
-                    break;
-                }
-                default:
-                    throw new Error(`Unsupported runtime action kind "${action.kind}" in workflow runtime.`);
-            }
-            const parentEvent = await callAdapterEventHandler(adapter, createSubagentCalledEvent({
-                callId: action.callId,
-                childSessionId,
-                name,
-                remote,
-                sequence: batch.event.sequence,
-                sessionId: input.session.sessionId,
-                toolName,
-                turnId: batch.event.turnId,
-                workflowId: workflowEntryReference.workflowId,
-            }), adapterCtx);
-            await writer.write(encodeMessageStreamEvent(timestampHandleMessageStreamEvent(parentEvent)));
-        }
-    }
-    finally {
-        writer.releaseLock();
-    }
-    return { results, session: nextSession };
-}
-function createRemoteAgentStartFailureResult(input) {
-    return {
-        callId: input.action.callId,
-        isError: true,
-        kind: "subagent-result",
-        output: {
-            code: "REMOTE_AGENT_START_FAILED",
-            message: toErrorMessage(input.error),
-        },
-        subagentName: input.action.remoteAgentName,
-    };
-}
-const log = createLogger("execution.workflow-entry");
-/**
- * Emits a terminal `session.failed` event and delivers it to the
- * adapter before the workflow run tears down.
- */
-export async function emitTerminalSessionFailureStep(input) {
-    "use step";
-    const details = formatError(input.error);
-    const code = typeof details.name === "string" ? details.name : "WORKFLOW_EXECUTION_FAILED";
-    const message = typeof details.message === "string" ? details.message : String(input.error);
-    const sessionId = input.serializedContext["ash.sessionId"] ?? "";
-    log.error("workflow loop threw — emitting terminal session.failed", {
-        sessionId,
-        errorId: typeof details.errorId === "string" ? details.errorId : undefined,
-        code,
-        message,
-    });
-    const event = createSessionFailedEvent({ code, details, message, sessionId });
-    // Best-effort: invoke the adapter's handler so Slack posts the
-    // fatal message. Any failure here is logged but not rethrown so
-    // the outer workflow throw still reaches the run handle.
-    try {
-        const ctx = await deserializeContext(input.serializedContext);
-        const adapter = ctx.get(ChannelKey);
-        if (adapter !== undefined) {
-            const adapterCtx = buildAdapterContext(adapter, ctx);
-            await callAdapterEventHandler(adapter, event, adapterCtx);
-        }
-    }
-    catch (notificationError) {
-        log.error("adapter failed to handle terminal session.failed event", {
-            errorId: typeof details.errorId === "string" ? details.errorId : undefined,
-            sessionId,
-            error: notificationError,
-        });
-    }
-    // Always write the event to the durable stream so downstream
-    // consumers (client SDK readers, event-stream replays, dashboards)
-    // see a canonical terminal event instead of an abrupt stream close.
-    try {
-        const writer = input.parentWritable.getWriter();
-        try {
-            await writer.write(encodeMessageStreamEvent(timestampHandleMessageStreamEvent(event)));
-        }
-        finally {
-            writer.releaseLock();
-        }
-    }
-    catch (writeError) {
-        log.error("failed to write terminal session.failed event to durable stream", {
-            errorId: typeof details.errorId === "string" ? details.errorId : undefined,
-            sessionId,
-            error: writeError,
-        });
-    }
-}
-/**
- * Emits a proxied `input.requested` event through the parent's adapter
- * and records the proxy routing entries on the parent session.
- */
-export async function runProxyInputRequestStep(input) {
-    "use step";
-    const ctx = await deserializeContext(input.serializedContext);
-    const adapter = ctx.require(ChannelKey);
-    const adapterCtx = buildAdapterContext(adapter, ctx);
-    const mode = ctx.require(ModeKey);
-    const writer = input.parentWritable.getWriter();
-    let proxyResult;
-    try {
-        const emit = async (event) => {
-            const transformed = await callAdapterEventHandler(adapter, event, adapterCtx);
-            await writer.write(encodeMessageStreamEvent(timestampHandleMessageStreamEvent(transformed)));
-        };
-        proxyResult = await emitProxiedInputRequest({
-            emit,
-            hookPayload: input.hookPayload,
-            mode,
-            session: input.session,
-        });
-    }
-    finally {
-        writer.releaseLock();
-    }
-    // Persist adapter-state mutations (e.g. Slack's `pendingRequests`
-    // cache populated by the `input.requested` handler) so the next
-    // `turnStep` observes them across the serialized context
-    // boundary. Without this the workflow runtime rehydrates a stale
-    // adapter and later text-reply deliveries miss the cached batch.
-    ctx.set(ChannelKey, { ...adapter, state: { ...adapterCtx.state } });
-    const nextSerializedContext = serializeContext(ctx);
-    const sessionWithProxyEntries = upsertProxyInputRequests({
-        entries: proxyResult.entries,
-        forChildContinuationToken: input.hookPayload.childContinuationToken,
-        session: proxyResult.session,
-    });
-    const nextSession = reconcileSessionContinuationToken(ctx, sessionWithProxyEntries);
-    return {
-        serializedContext: nextSerializedContext,
-        session: nextSession,
-    };
-}
-/**
- * Splits an inbound deliver payload into parent-local and
- * proxied-child buckets and forwards the child buckets to the
- * descendants that raised the original HITL batch.
- *
- * Runs inside a `"use step"` boundary so the per-descendant
- * `resumeHook` calls are durably recorded. Returns the residual
- * payload (if any) for the parent's own harness to process.
- */
-export async function routeProxiedDeliverStep(input) {
-    "use step";
-    const routed = routeDeliverPayload({
-        payload: input.payload,
-        session: input.session,
-    });
-    const { resumeHook } = await import("#compiled/@workflow/core/runtime.js");
-    for (const forChild of routed.forChildren) {
-        await resumeHook(forChild.childContinuationToken, {
-            auth: input.auth,
-            kind: "deliver",
-            payloads: [forChild.payload],
-        });
-    }
-    return { remainder: routed.forSelf };
-}
-/**
- * Starts a per-turn child workflow for the current driver session.
- *
- * `parentWritable` is forwarded to the child in the workflow input so
- * the child's step writes land directly on the driver run's stream —
- * no copier, no double-store.
- */
-export async function dispatchTurnStep(input) {
-    "use step";
-    const run = await startWorkflowPreferLatest(turnWorkflow, [input]);
-    return { runId: run.runId };
-}
-/**
- * Creates the durable session state inside a step boundary before the
- * workflow enters its long-lived turn loop.
- *
- * The optional `nodeId` targets a specific node in the compiled
- * agent graph (used for subagent child workflows). When omitted, the
- * root agent is used.
- */
-export async function createSessionStep(input) {
-    "use step";
-    const bundle = await getCompiledRuntimeAgentBundle({
-        compiledArtifactsSource: input.compiledArtifactsSource,
-        nodeId: input.nodeId,
-    });
-    return createSession({
-        compactionOverrides: {
-            thresholdPercent: bundle.resolvedAgent.config.compaction?.thresholdPercent,
-        },
-        continuationToken: input.continuationToken,
-        sessionId: input.sessionId,
-        turnAgent: bundle.turnAgent,
-    });
-}
+import{createLogger,formatError}from"#internal/logging.js";import{toErrorMessage}from"#shared/errors.js";import{createSessionFailedEvent,createSubagentCalledEvent,encodeMessageStreamEvent,timestampHandleMessageStreamEvent}from"#protocol/message.js";import{AuthKey,BundleKey,CapabilitiesKey,ChannelKey,ContinuationTokenKey,InitiatorAuthKey,ModeKey}from"#context/keys.js";import{callAdapterEventHandler,defaultDeliverResult}from"#channel/adapter.js";import{getCompiledRuntimeAgentBundle}from"#runtime/sessions/compiled-agent-cache.js";import{isHarnessBetweenTurns}from"#harness/emission.js";import{PendingConnectionToolCallsKey}from"#runtime/framework-tools/pending-connection-tool-calls.js";import{buildAdapterContext}from"#channel/adapter-context.js";import{deserializeContext,serializeContext}from"#context/serialize.js";import{upsertProxyInputRequests}from"#harness/proxy-input-requests.js";import{createSession,refreshSessionFromTurnAgent}from"#execution/session.js";import{getPendingRuntimeActionBatch,recordPendingSubagentChildToken}from"#harness/runtime-actions.js";import{coalesceTurnInputs}from"#harness/messages.js";import{dispatchStreamEventHooks,runHookLifecycleStep}from"#context/hook-lifecycle.js";import{runStep}from"#context/run-step.js";import{createExecutionNodeStep}from"#execution/node-step.js";import{resolveRemoteAgentForAction,startRemoteAgentSession}from"#execution/remote-agent-dispatch.js";import{emitProxiedInputRequest,routeDeliverPayload}from"#execution/subagent-hitl-proxy.js";import{buildSubagentRunInput}from"#execution/subagent-tool.js";import{turnWorkflow}from"#execution/turn-workflow.js";import{createWorkflowRuntime,startWorkflowPreferLatest,workflowEntryReference}from"#execution/workflow-runtime.js";async function turnStep(e){"use step";let t=await deserializeContext(e.serializedContext),n=t.require(ChannelKey);e.input?.kind===`deliver`&&e.input.auth!==void 0&&t.set(AuthKey,e.input.auth??null);let r=buildAdapterContext(n,t),i;if(e.input?.kind===`deliver`){let t=[];for(let i of e.input.payloads){let e=n.deliver?await n.deliver(i,r):defaultDeliverResult(i);e!=null&&t.push(e)}i=t.length===0?void 0:t.reduce(coalesceTurnInputs)}else e.input?.kind===`runtime-action-result`&&(i={runtimeActionResults:e.input.results});if(e.input?.kind===`deliver`){let e={...n,state:{...r.state}};t.set(ChannelKey,e)}if(e.input?.kind===`deliver`&&i===void 0){let n=reconcileSessionContinuationToken(t,e.session);return{action:`park`,serializedContext:serializeContext(t),session:n}}let d=e.parentWritable.getWriter(),f=t.require(BundleKey).hookRegistry,emit=async e=>{let i=await callAdapterEventHandler(n,e,r);t.set(ChannelKey,{...n,state:{...r.state}}),await d.write(encodeMessageStreamEvent(timestampHandleMessageStreamEvent(i))),await dispatchStreamEventHooks({ctx:t,registry:f,event:i})},h=await runStep(t,e.session,async e=>{let n=t.require(BundleKey),r=t.get(CapabilitiesKey),a=t.require(ModeKey),runHarnessStep=async(e,t)=>{let i=refreshSessionFromTurnAgent({compactionOverrides:{thresholdPercent:n.resolvedAgent.config.compaction?.thresholdPercent},session:e,turnAgent:n.turnAgent});return createExecutionNodeStep({capabilities:r,compiledArtifactsSource:n.compiledArtifactsSource,createRuntime:createWorkflowRuntime,emit,mode:a,node:n.graph.root})(i,t)};return i!==void 0&&isHarnessBetweenTurns(e)?runHookLifecycleStep({ctx:t,emit,input:i,mode:a,registry:n.hookRegistry,session:e},runHarnessStep):runHarnessStep(e,i)}),y=reconcileSessionContinuationToken(t,h.session),b=serializeContext(t);h={...h,session:y};let x=t.get(PendingConnectionToolCallsKey)??[];return x.length>0?(d.releaseLock(),{action:`await-authorization`,pendingToolCalls:x,serializedContext:b,session:h.session}):h.next!==null&&typeof h.next==`object`&&`done`in h.next?(await d.close(),{action:`done`,output:h.next.output,serializedContext:b,session:h.session}):h.next===null?(d.releaseLock(),{action:`park`,serializedContext:b,session:h.session}):(d.releaseLock(),{action:`continue`,serializedContext:b,session:h.session})}function reconcileSessionContinuationToken(e,t){let n=e.get(ContinuationTokenKey);return n===void 0||n===t.continuationToken?t:{...t,continuationToken:n}}async function dispatchPendingRuntimeActionsStep(e){"use step";let t=getPendingRuntimeActionBatch(e.session);if(t===void 0||t.actions.length===0)return{results:[],session:e.session};let n=await deserializeContext(e.serializedContext),r=n.require(BundleKey),d=n.require(ChannelKey),p=n.get(AuthKey)??null,m=n.get(CapabilitiesKey),h=n.get(InitiatorAuthKey)??null,g=e.parentWritable.getWriter(),_=buildAdapterContext(d,n),v=e.session,y=[];try{for(let n of t.actions){let s,c,l,u;switch(n.kind){case`subagent-call`:{let i=createWorkflowRuntime({compiledArtifactsSource:r.compiledArtifactsSource,nodeId:n.nodeId}),{childContinuationToken:a,runInput:o}=buildSubagentRunInput({action:n,auth:p,batchEvent:t.event,capabilities:m,initiatorAuth:h,session:e.session}),l=await i.run(o);v=recordPendingSubagentChildToken({callId:n.callId,childContinuationToken:a,session:v}),s=l.sessionId,c=n.name,u=n.subagentName;break}case`remote-agent-call`:{let t;try{t=resolveRemoteAgentForAction({nodeId:n.nodeId,remoteAgentName:n.remoteAgentName,registry:r.subagentRegistry.subagentsByNodeId}),s=await startRemoteAgentSession({action:n,callbackBaseUrl:e.callbackBaseUrl,remote:t,session:e.session})}catch(e){y.push(createRemoteAgentStartFailureResult({action:n,error:e}));continue}c=n.name,l={url:t.url},u=n.remoteAgentName;break}default:throw Error(`Unsupported runtime action kind "${n.kind}" in workflow runtime.`)}let f=await callAdapterEventHandler(d,createSubagentCalledEvent({callId:n.callId,childSessionId:s,name:c,remote:l,sequence:t.event.sequence,sessionId:e.session.sessionId,toolName:u,turnId:t.event.turnId,workflowId:workflowEntryReference.workflowId}),_);await g.write(encodeMessageStreamEvent(timestampHandleMessageStreamEvent(f)))}}finally{g.releaseLock()}return{results:y,session:v}}function createRemoteAgentStartFailureResult(e){return{callId:e.action.callId,isError:!0,kind:`subagent-result`,output:{code:`REMOTE_AGENT_START_FAILED`,message:toErrorMessage(e.error)},subagentName:e.action.remoteAgentName}}var log=createLogger(`execution.workflow-entry`);async function emitTerminalSessionFailureStep(e){"use step";let n=formatError(e.error),i=typeof n.name==`string`?n.name:`WORKFLOW_EXECUTION_FAILED`,s=typeof n.message==`string`?n.message:String(e.error),c=e.serializedContext[`ash.sessionId`]??``;log.error(`workflow loop threw — emitting terminal session.failed`,{sessionId:c,errorId:typeof n.errorId==`string`?n.errorId:void 0,code:i,message:s});let l=createSessionFailedEvent({code:i,details:n,message:s,sessionId:c});try{let t=await deserializeContext(e.serializedContext),n=t.get(ChannelKey);n!==void 0&&await callAdapterEventHandler(n,l,buildAdapterContext(n,t))}catch(e){log.error(`adapter failed to handle terminal session.failed event`,{errorId:typeof n.errorId==`string`?n.errorId:void 0,sessionId:c,error:e})}try{let t=e.parentWritable.getWriter();try{await t.write(encodeMessageStreamEvent(timestampHandleMessageStreamEvent(l)))}finally{t.releaseLock()}}catch(e){log.error(`failed to write terminal session.failed event to durable stream`,{errorId:typeof n.errorId==`string`?n.errorId:void 0,sessionId:c,error:e})}}async function runProxyInputRequestStep(e){"use step";let t=await deserializeContext(e.serializedContext),n=t.require(ChannelKey),r=buildAdapterContext(n,t),i=t.require(ModeKey),s=e.parentWritable.getWriter(),c;try{c=await emitProxiedInputRequest({emit:async e=>{let t=await callAdapterEventHandler(n,e,r);await s.write(encodeMessageStreamEvent(timestampHandleMessageStreamEvent(t)))},hookPayload:e.hookPayload,mode:i,session:e.session})}finally{s.releaseLock()}return t.set(ChannelKey,{...n,state:{...r.state}}),{serializedContext:serializeContext(t),session:reconcileSessionContinuationToken(t,upsertProxyInputRequests({entries:c.entries,forChildContinuationToken:e.hookPayload.childContinuationToken,session:c.session}))}}async function routeProxiedDeliverStep(e){"use step";let t=routeDeliverPayload({payload:e.payload,session:e.session}),{resumeHook:n}=await import(`#compiled/@workflow/core/runtime.js`);for(let r of t.forChildren)await n(r.childContinuationToken,{auth:e.auth,kind:`deliver`,payloads:[r.payload]});return{remainder:t.forSelf}}async function dispatchTurnStep(e){"use step";return{runId:(await startWorkflowPreferLatest(turnWorkflow,[e])).runId}}async function createSessionStep(e){"use step";let t=await getCompiledRuntimeAgentBundle({compiledArtifactsSource:e.compiledArtifactsSource,nodeId:e.nodeId});return createSession({compactionOverrides:{thresholdPercent:t.resolvedAgent.config.compaction?.thresholdPercent},continuationToken:e.continuationToken,sessionId:e.sessionId,turnAgent:t.turnAgent})}export{createSessionStep,dispatchPendingRuntimeActionsStep,dispatchTurnStep,emitTerminalSessionFailureStep,reconcileSessionContinuationToken,routeProxiedDeliverStep,runProxyInputRequestStep,turnStep};