veryfront 0.1.334 → 0.1.336

package/esm/deno.js

@@ -1,6 +1,6 @@
 export default {
     "name": "veryfront",
-    "version": "0.1.334",
+    "version": "0.1.336",
     "license": "Apache-2.0",
     "nodeModulesDir": "auto",
     "workspace": [

package/esm/src/agent/hosted-child-lifecycle.d.ts

@@ -1,3 +1,4 @@
+import { type ChildRunExecutionResult, type ChildRunExecutionSnapshot } from "./child-run-execution-snapshot.js";
 export interface HostedChildLifecycleTerminalState {
     status: "completed" | "failed" | "cancelled";
     usage?: {
@@ -37,5 +38,25 @@ export type HostedChildLifecycleRunResult<TResult> = {
     error: unknown;
     terminalState: HostedChildLifecycleTerminalState;
 };
+export type HostedChildExecutionLifecycleResult<TLocalResult extends ChildRunExecutionResult> = {
+    status: "completed";
+    result: TLocalResult;
+    snapshot: ChildRunExecutionSnapshot;
+    terminalState: HostedChildLifecycleTerminalState;
+} | {
+    status: "failed" | "cancelled";
+    error: unknown;
+    terminalState: HostedChildLifecycleTerminalState;
+};
+export interface HostedChildExecutionLifecycleOptions<TLocalResult extends ChildRunExecutionResult> {
+    adapter: HostedChildLifecycleAdapter;
+    executionFailedCode: string;
+    abortSignal?: AbortSignal | undefined;
+    execute: () => Promise<TLocalResult> | TLocalResult;
+    getExecutionSnapshot: () => ChildRunExecutionSnapshot | null;
+    onLifecycleError?: (error: unknown) => Promise<void> | void;
+    skipTerminalPersistence?: (terminalState: HostedChildLifecycleTerminalState) => boolean;
+}
 export declare function runHostedChildLifecycle<TResult>(options: HostedChildLifecycleRunnerOptions<TResult>): Promise<HostedChildLifecycleRunResult<TResult>>;
+export declare function runHostedChildExecutionLifecycle<TLocalResult extends ChildRunExecutionResult>(options: HostedChildExecutionLifecycleOptions<TLocalResult>): Promise<HostedChildExecutionLifecycleResult<TLocalResult>>;
 //# sourceMappingURL=hosted-child-lifecycle.d.ts.map

package/esm/src/agent/hosted-child-lifecycle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hosted-child-lifecycle.d.ts","sourceRoot":"","sources":["../../../src/src/agent/hosted-child-lifecycle.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iCAAiC;IAChD,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;IAC7C,KAAK,CAAC,EAAE;QACN,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;AAED,MAAM,WAAW,kCACf,SAAQ,IAAI,CAAC,iCAAiC,EAAE,QAAQ,CAAC;IACzD,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,MAAM,WAAW,2BAA2B;IAC1C,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACrC,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACrC,SAAS,CAAC,EAAE,CACV,aAAa,EAAE,iCAAiC,KAC7C,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC1B,MAAM,CAAC,EAAE,CACP,aAAa,EAAE,iCAAiC,KAC7C,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC1B,SAAS,CAAC,EAAE,CACV,aAAa,EAAE,iCAAiC,KAC7C,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,8BACf,SAAQ,IAAI,CAAC,iCAAiC,EAAE,QAAQ,CAAC;IACzD,MAAM,EAAE,QAAQ,GAAG,WAAW,CAAC;CAChC;AAED,MAAM,WAAW,iCAAiC,CAAC,OAAO;IACxD,OAAO,EAAE,2BAA2B,CAAC;IACrC,OAAO,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IAC1C,qBAAqB,CAAC,EAAE,CACtB,MAAM,EAAE,OAAO,KAEb,OAAO,CAAC,kCAAkC,CAAC,GAC3C,kCAAkC,CAAC;IACvC,iBAAiB,EAAE,CACjB,KAAK,EAAE,OAAO,KAEZ,OAAO,CAAC,8BAA8B,CAAC,GACvC,8BAA8B,CAAC;IACnC,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC7D;AAED,MAAM,MAAM,6BAA6B,CAAC,OAAO,IAC7C;IACA,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,aAAa,EAAE,iCAAiC,CAAC;CAClD,GACC;IACA,MAAM,EAAE,QAAQ,GAAG,WAAW,CAAC;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,aAAa,EAAE,iCAAiC,CAAC;CAClD,CAAC;AAmBJ,wBAAsB,uBAAuB,CAAC,OAAO,EACnD,OAAO,EAAE,iCAAiC,CAAC,OAAO,CAAC,GAClD,OAAO,CAAC,6BAA6B,CAAC,OAAO,CAAC,CAAC,CAsCjD"}
+{"version":3,"file":"hosted-child-lifecycle.d.ts","sourceRoot":"","sources":["../../../src/src/agent/hosted-child-lifecycle.ts"],"names":[],"mappings":"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"}

package/esm/src/agent/hosted-child-lifecycle.js

@@ -1,3 +1,14 @@
+import { buildChildRunExecutionSnapshot, getChildRunSnapshotUsage, } from "./child-run-execution-snapshot.js";
+import { isChildRunAbortError } from "./child-run-execution-support.js";
+import { HostedChildTerminalStateError, resolveHostedChildTerminalErrorCode, } from "./hosted-child-status.js";
+class HostedChildExecutionFailure extends Error {
+    usage;
+    constructor(message, usage) {
+        super(message);
+        this.usage = usage;
+        this.name = "HostedChildExecutionFailure";
+    }
+}
 async function dispatchTerminalState(adapter, terminalState) {
     if (terminalState.status === "cancelled") {
         await adapter.cancelled?.(terminalState);
@@ -45,3 +56,134 @@ export async function runHostedChildLifecycle(options) {
         terminalState,
     };
 }
+function toHostedChildLifecycleUsage(usage) {
+    if (!usage) {
+        return undefined;
+    }
+    return {
+        inputTokens: usage.inputTokens,
+        outputTokens: usage.outputTokens,
+        totalTokens: usage.totalTokens,
+    };
+}
+function wrapSkippableTerminalPersistence(adapter, skipTerminalPersistence) {
+    if (!skipTerminalPersistence) {
+        return adapter;
+    }
+    return {
+        ...adapter,
+        failed: async (terminalState) => {
+            if (skipTerminalPersistence(terminalState)) {
+                return;
+            }
+            await adapter.failed?.(terminalState);
+        },
+        cancelled: async (terminalState) => {
+            if (skipTerminalPersistence(terminalState)) {
+                return;
+            }
+            await adapter.cancelled?.(terminalState);
+        },
+    };
+}
+function resolveHostedChildExecutionErrorState(error, input) {
+    if (error instanceof HostedChildTerminalStateError) {
+        if (error.status === "completed") {
+            throw error;
+        }
+        return {
+            status: error.status,
+            terminalErrorCode: resolveHostedChildTerminalErrorCode(error.status),
+            terminalErrorMessage: error.message,
+        };
+    }
+    if (error instanceof HostedChildExecutionFailure) {
+        return {
+            status: "failed",
+            terminalErrorCode: input.executionFailedCode,
+            terminalErrorMessage: error.message,
+            usage: toHostedChildLifecycleUsage(error.usage),
+        };
+    }
+    if (isChildRunAbortError(error) || input.abortSignal?.aborted) {
+        return {
+            status: "cancelled",
+            terminalErrorCode: "CANCELLED",
+            terminalErrorMessage: "Child run cancelled",
+            usage: toHostedChildLifecycleUsage(getChildRunSnapshotUsage(input.getExecutionSnapshot())),
+        };
+    }
+    return {
+        status: "failed",
+        terminalErrorCode: input.executionFailedCode,
+        terminalErrorMessage: error instanceof Error ? error.message : String(error),
+        usage: toHostedChildLifecycleUsage(getChildRunSnapshotUsage(input.getExecutionSnapshot())),
+    };
+}
+export async function runHostedChildExecutionLifecycle(options) {
+    const adapter = wrapSkippableTerminalPersistence(options.adapter, options.skipTerminalPersistence);
+    try {
+        const lifecycleResult = await runHostedChildLifecycle({
+            adapter,
+            execute: async () => {
+                const result = await options.execute();
+                const snapshot = options.getExecutionSnapshot() ?? buildChildRunExecutionSnapshot(result);
+                if (!snapshot.success) {
+                    throw new HostedChildExecutionFailure(snapshot.error ?? "Unknown error", snapshot.usage);
+                }
+                return {
+                    result,
+                    snapshot,
+                };
+            },
+            resolveCompletedState: ({ snapshot }) => ({
+                status: "completed",
+                usage: toHostedChildLifecycleUsage(snapshot.usage),
+            }),
+            resolveErrorState: (error) => resolveHostedChildExecutionErrorState(error, {
+                executionFailedCode: options.executionFailedCode,
+                abortSignal: options.abortSignal,
+                getExecutionSnapshot: options.getExecutionSnapshot,
+            }),
+            onLifecycleError: options.onLifecycleError,
+        });
+        if (lifecycleResult.status !== "completed") {
+            return lifecycleResult;
+        }
+        return {
+            status: "completed",
+            result: lifecycleResult.result.result,
+            snapshot: lifecycleResult.result.snapshot,
+            terminalState: lifecycleResult.terminalState,
+        };
+    }
+    catch (error) {
+        if (error instanceof HostedChildTerminalStateError) {
+            return {
+                status: error.status === "cancelled" ? "cancelled" : "failed",
+                error,
+                terminalState: {
+                    status: error.status,
+                    terminalErrorCode: resolveHostedChildTerminalErrorCode(error.status),
+                    terminalErrorMessage: error.message,
+                },
+            };
+        }
+        const terminalState = resolveHostedChildExecutionErrorState(error, {
+            executionFailedCode: options.executionFailedCode,
+            abortSignal: options.abortSignal,
+            getExecutionSnapshot: options.getExecutionSnapshot,
+        });
+        try {
+            await dispatchTerminalState(adapter, terminalState);
+        }
+        catch (lifecycleError) {
+            await options.onLifecycleError?.(lifecycleError);
+        }
+        return {
+            status: terminalState.status,
+            error,
+            terminalState,
+        };
+    }
+}

package/esm/src/agent/human-input.d.ts

@@ -274,10 +274,33 @@ export type HumanInputRequest = z.infer<typeof HumanInputRequestSchema>;
 export type HumanInputRequestInput = z.input<typeof HumanInputRequestSchema>;
 export type HumanInputResult = z.infer<typeof HumanInputResultSchema>;
 export type HumanInputPendingRequest = z.infer<typeof HumanInputPendingRequestSchema>;
-type HumanInputResumeValue = {
+export type HumanInputResumeValue = {
     result: unknown;
     isError: boolean;
 };
+export type DurableHumanInputFlowResult<TCreatedRequest> = {
+    result: HumanInputResult;
+    createdRequest: TCreatedRequest;
+};
+export interface ExecuteDurableHumanInputFlowOptions<TCreatedRequest, TSnapshot> {
+    sessionManager?: RunResumeSessionManager<HumanInputResumeValue> | undefined;
+    runId: string;
+    threadId: string;
+    toolCallId: string;
+    request: HumanInputRequestInput;
+    timeoutMs: number;
+    pollIntervalMs: number;
+    onRequest: (request: HumanInputPendingRequest) => TCreatedRequest | Promise<TCreatedRequest>;
+    onCreatedRequest?: ((request: TCreatedRequest) => void | Promise<void>) | undefined;
+    getSnapshot: (request: TCreatedRequest) => TSnapshot | Promise<TSnapshot>;
+    resolveSnapshot: (snapshot: TSnapshot) => HumanInputResult | undefined;
+}
+export interface WaitForDurableHumanInputResolutionOptions<TSnapshot> {
+    deadline: number;
+    pollIntervalMs: number;
+    getSnapshot: () => TSnapshot | Promise<TSnapshot>;
+    resolveSnapshot: (snapshot: TSnapshot) => HumanInputResult | undefined;
+}
 export interface WaitForHumanInputOptions {
     sessionManager: RunResumeSessionManager<HumanInputResumeValue>;
     runId: string;
@@ -293,6 +316,7 @@ export declare class InvalidHumanInputResultError extends Error {
     readonly detail: z.ZodIssue[];
     constructor(detail: z.ZodIssue[]);
 }
+export declare function executeDurableHumanInputFlow<TCreatedRequest, TSnapshot>(options: ExecuteDurableHumanInputFlowOptions<TCreatedRequest, TSnapshot>): Promise<DurableHumanInputFlowResult<TCreatedRequest>>;
 export declare function waitForHumanInput(options: WaitForHumanInputOptions): Promise<HumanInputResult>;
-export {};
+export declare function waitForDurableHumanInputResolution<TSnapshot>(options: WaitForDurableHumanInputResolutionOptions<TSnapshot>): Promise<HumanInputResult>;
 //# sourceMappingURL=human-input.d.ts.map

package/esm/src/agent/human-input.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"human-input.d.ts","sourceRoot":"","sources":["../../../src/src/agent/human-input.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAI7D,eAAO,MAAM,sBAAsB;;;;;iBAKjC,CAAC;AAUH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAuChC,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAMlC,CAAC;AAEH,eAAO,MAAM,8BAA8B,oGAG1C,CAAC;AAEF,eAAO,MAAM,sBAAsB;;;;;;gCASjC,CAAC;AAEH,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAIzC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACzE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAC7E,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAEtF,KAAK,qBAAqB,GAAG;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,MAAM,WAAW,wBAAwB;IACvC,cAAc,EAAE,uBAAuB,CAAC,qBAAqB,CAAC,CAAC;IAC/D,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,sBAAsB,CAAC;IAChC,SAAS,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,wBAAwB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,SAAS,CAAC;CACvF;AAED,qBAAa,qBAAsB,SAAQ,KAAK;IAClC,QAAQ,CAAC,MAAM,EAAE,OAAO;gBAAf,MAAM,EAAE,OAAO;CAMrC;AAED,qBAAa,4BAA6B,SAAQ,KAAK;IACzC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;gBAApB,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CAI1C;AAED,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,gBAAgB,CAAC,CAqB3B"}
+{"version":3,"file":"human-input.d.ts","sourceRoot":"","sources":["../../../src/src/agent/human-input.ts"],"names":[],"mappings":"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"}

package/esm/src/agent/human-input.js

@@ -1,5 +1,7 @@
+import * as dntShim from "../../_dnt.shims.js";
 import { z } from "zod";
 import { AgUiRuntimeRunIdSchema } from "./runtime-ag-ui-contract.js";
+import { RunResumeSessionManager } from "./runtime/index.js";
 const TOOL_CALL_ID_SCHEMA = z.string().min(1).max(128);
 export const HumanInputOptionSchema = z.object({
     value: z.string(),
@@ -93,6 +95,54 @@ export class InvalidHumanInputResultError extends Error {
         this.name = "InvalidHumanInputResultError";
     }
 }
+export async function executeDurableHumanInputFlow(options) {
+    const sessionManager = options.sessionManager ??
+        new RunResumeSessionManager();
+    sessionManager.startRun({
+        runId: options.runId,
+        threadId: options.threadId,
+    });
+    let resolveCreatedRequest = null;
+    const createdRequestPromise = new Promise((resolve) => {
+        resolveCreatedRequest = resolve;
+    });
+    try {
+        const result = await waitForHumanInput({
+            sessionManager,
+            runId: options.runId,
+            toolCallId: options.toolCallId,
+            request: options.request,
+            onRequest: async (pendingRequest) => {
+                const currentRequest = await options.onRequest(pendingRequest);
+                if (!resolveCreatedRequest) {
+                    throw new Error("Durable human input flow could not track the created request");
+                }
+                resolveCreatedRequest(currentRequest);
+                await options.onCreatedRequest?.(currentRequest);
+                void bridgeDurableHumanInputRequest({
+                    sessionManager,
+                    runId: options.runId,
+                    toolCallId: options.toolCallId,
+                    createdRequest: currentRequest,
+                    timeoutMs: options.timeoutMs,
+                    pollIntervalMs: options.pollIntervalMs,
+                    getSnapshot: options.getSnapshot,
+                    resolveSnapshot: options.resolveSnapshot,
+                });
+            },
+        });
+        const createdRequest = await createdRequestPromise;
+        sessionManager.completeRun(options.runId);
+        return {
+            result,
+            createdRequest,
+        };
+    }
+    catch (error) {
+        sessionManager.failRun(options.runId);
+        throw error;
+    }
+}
 export async function waitForHumanInput(options) {
     options.sessionManager.prepareForSignal(options.runId, options.toolCallId);
     const pendingRequest = HumanInputPendingRequestSchema.parse({
@@ -111,3 +161,51 @@ export async function waitForHumanInput(options) {
     }
     return parsed.data;
 }
+export async function waitForDurableHumanInputResolution(options) {
+    while (Date.now() < options.deadline) {
+        const snapshot = await options.getSnapshot();
+        const result = options.resolveSnapshot(snapshot);
+        if (result) {
+            return result;
+        }
+        await delay(options.pollIntervalMs);
+    }
+    throw new Error("Timed out while waiting for durable human input resolution");
+}
+async function bridgeDurableHumanInputRequest(input) {
+    try {
+        const resolved = await waitForDurableHumanInputResolution({
+            deadline: Date.now() + input.timeoutMs,
+            pollIntervalMs: input.pollIntervalMs,
+            getSnapshot: () => input.getSnapshot(input.createdRequest),
+            resolveSnapshot: input.resolveSnapshot,
+        });
+        submitHumanInputResumeValue(input.sessionManager, input.runId, input.toolCallId, {
+            result: resolved,
+            isError: false,
+        });
+    }
+    catch (error) {
+        submitHumanInputResumeValue(input.sessionManager, input.runId, input.toolCallId, {
+            result: error instanceof Error ? error.message : String(error),
+            isError: true,
+        });
+    }
+}
+function submitHumanInputResumeValue(sessionManager, runId, toolCallId, value) {
+    try {
+        sessionManager.submitSignal(runId, {
+            waitKey: toolCallId,
+            value,
+        });
+    }
+    catch {
+        // Ignore late resume submissions once the local wait has already completed
+        // or the ephemeral session has been finalized.
+    }
+}
+function delay(ms) {
+    return new Promise((resolve) => {
+        dntShim.setTimeout(resolve, ms);
+    });
+}

package/esm/src/agent/index.d.ts

@@ -128,7 +128,7 @@ export { type ConversationRunStreamMirror, createConversationRunStreamMirror, }
 export { finalizeHostedDetached, type FinalizeHostedDetachedOptions, finalizeHostedResponse, type FinalizeHostedResponseOptions, type HostedDetachedFinalizationState, type HostedResponseFinalizationState, type HostedTerminalError, } from "./hosted-stream-finalization.js";
 export { type ActiveConversationRunStatus, appendConversationRunEvents, AppendConversationRunEventsError, type AppendConversationRunEventsResponse, AppendConversationRunEventsResponseSchema, CompleteConversationRunResponseSchema, type ConversationAgentRunUsage, type ConversationRunAppendCursorResyncResult, type ConversationRunAppendExecutionOutcome, type ConversationRunAppendFailureOutcome, type ConversationRunAppendRecoveryOutcome, type ConversationRunBatchFlushOutcome, type ConversationRunEventQueueController, type ConversationRunProjection, ConversationRunProjectionSchema, type ConversationRunQueueFlushOutcome, ConversationRunStatusSchema, type ConversationRunTargets, ConversationRunTargetsSchema, ConversationRunTerminalStateError, createConversationAgentRun, createConversationRunEventQueueController, finalizeConversationAgentRun, flushConversationRunEventBatches, flushConversationRunEventQueue, getConversationRun, isActiveConversationRunStatus, isAppendableConversationRunProjection, isCursorMismatchConversationRunAppendError, isIgnorableConversationRunAppendError, monitorConversationRunStatus, parseAppendConversationRunEventsErrorBody, recoverConversationRunAppendExecution, recoverConversationRunAppendFailure, recoverConversationRunCursorMismatch, resolveConversationRunTargets, resyncConversationRunAppendCursor, type TerminalConversationRunStatus, } from "./durable.js";
 export { buildInvokeAgentChildRunLifecycleCustomEvent, buildInvokeAgentChildRunProgressEvents, buildInvokeAgentChildRunStateDelta, type InvokeAgentChildRunLifecycleCustomEvent, InvokeAgentChildRunLifecycleCustomEventSchema, type InvokeAgentChildRunLifecycleValue, InvokeAgentChildRunLifecycleValueSchema, type InvokeAgentChildRunProgressEvent, type InvokeAgentChildRunProgressInput, type InvokeAgentChildRunStateDelta, InvokeAgentChildRunStateDeltaSchema, publishInvokeAgentChildRunProgress, } from "./invoke-agent-child-runs.js";
-export { type HostedChildLifecycleAdapter, type HostedChildLifecycleRunnerOptions, type HostedChildLifecycleRunResult, type HostedChildLifecycleTerminalState, runHostedChildLifecycle, } from "./hosted-child-lifecycle.js";
+export { type HostedChildExecutionLifecycleOptions, type HostedChildExecutionLifecycleResult, type HostedChildLifecycleAdapter, type HostedChildLifecycleRunnerOptions, type HostedChildLifecycleRunResult, type HostedChildLifecycleTerminalState, runHostedChildExecutionLifecycle, runHostedChildLifecycle, } from "./hosted-child-lifecycle.js";
 export { appendHostedChildMirrorChunk, closeHostedChildReasoningSegment, closeHostedChildTextSegment, createHostedChildMirrorContext, type HostedChildChunkMirror, type HostedChildMirrorContext, type HostedChildMirrorPart, type HostedChildMirrorState, isAlreadyMirroredHostedChunk, toMirroredHostedStreamPart, } from "./hosted-child-mirror.js";
 export { type HostedChildRunIdentifiers, HostedChildTerminalStateError, type HostedChildTerminalStatus, monitorHostedChildRunStatus, resolveHostedChildTerminalErrorCode, } from "./hosted-child-status.js";
 export { type HostedLifecycleAdapter, type HostedLifecycleExecution, type HostedLifecycleRunnerOptions, type HostedLifecycleRunResult, type HostedLifecycleTerminalState, runHostedLifecycle, } from "./hosted-lifecycle.js";
@@ -143,7 +143,7 @@ export { createDetachedRunTracker, type DetachedRunDrainResult, type DetachedRun
 export { type AgUiCancelHandlerOptions, type AgUiResumeHandlerOptions, type AgUiResumeSignal, AgUiResumeSignalSchema, createAgUiCancelHandler, createAgUiResumeHandler, } from "./ag-ui-run-control.js";
 export { type AgUiSseEvent, createAgUiRunErrorEvent, createAgUiSseErrorResponse, createAgUiSseResponse, normalizeAgUiMessages, parseAgUiRequest, parseAgUiRequestOrError, } from "./ag-ui-host-support.js";
 export { type AgUiContextItem, type AgUiHandlerConfigWithAgent, type AgUiHandlerOptions, type AgUiInjectedTool, type AgUiRequest, AgUiRequestSchema, createAgUiHandler, } from "./ag-ui-handler.js";
-export { type HumanInputField, type HumanInputFieldInput, HumanInputFieldSchema, type HumanInputOption, HumanInputOptionSchema, type HumanInputPendingRequest, HumanInputPendingRequestSchema, type HumanInputRequest, type HumanInputRequestInput, HumanInputRequestSchema, type HumanInputResult, HumanInputResultSchema, HumanInputResumeError, InvalidHumanInputResultError, waitForHumanInput, type WaitForHumanInputOptions, } from "./human-input.js";
+export { type DurableHumanInputFlowResult, executeDurableHumanInputFlow, type ExecuteDurableHumanInputFlowOptions, type HumanInputField, type HumanInputFieldInput, HumanInputFieldSchema, type HumanInputOption, HumanInputOptionSchema, type HumanInputPendingRequest, HumanInputPendingRequestSchema, type HumanInputRequest, type HumanInputRequestInput, HumanInputRequestSchema, type HumanInputResult, HumanInputResultSchema, HumanInputResumeError, type HumanInputResumeValue, InvalidHumanInputResultError, waitForDurableHumanInputResolution, type WaitForDurableHumanInputResolutionOptions, waitForHumanInput, type WaitForHumanInputOptions, } from "./human-input.js";
 export { type ChatHandlerBeforeStream, type ChatHandlerBeforeStreamContext, type ChatHandlerBeforeStreamResult, type ChatHandlerConfigWithAgent, type ChatHandlerMessageInput, type ChatHandlerOptions, createChatHandler, } from "./chat-handler.js";
 export { AgentRuntime, RunAlreadyExistsError, RunCancelledError, RunNotActiveError, RunResumeSessionManager, type RunResumeSessionManagerOptions, type RunSessionStatus, type SubmitResumeValueOutcome, WaitConflictError, WaitNotPendingError, } from "./runtime/index.js";
 //# sourceMappingURL=index.d.ts.map

package/esm/src/agent/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/src/agent/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/src/agent/index.ts"],"names":[],"mappings":"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"}

package/esm/src/agent/index.js

@@ -127,7 +127,7 @@ export { createConversationRunStreamMirror, } from "./conversation-run-stream-mi
 export { finalizeHostedDetached, finalizeHostedResponse, } from "./hosted-stream-finalization.js";
 export { appendConversationRunEvents, AppendConversationRunEventsError, AppendConversationRunEventsResponseSchema, CompleteConversationRunResponseSchema, ConversationRunProjectionSchema, ConversationRunStatusSchema, ConversationRunTargetsSchema, ConversationRunTerminalStateError, createConversationAgentRun, createConversationRunEventQueueController, finalizeConversationAgentRun, flushConversationRunEventBatches, flushConversationRunEventQueue, getConversationRun, isActiveConversationRunStatus, isAppendableConversationRunProjection, isCursorMismatchConversationRunAppendError, isIgnorableConversationRunAppendError, monitorConversationRunStatus, parseAppendConversationRunEventsErrorBody, recoverConversationRunAppendExecution, recoverConversationRunAppendFailure, recoverConversationRunCursorMismatch, resolveConversationRunTargets, resyncConversationRunAppendCursor, } from "./durable.js";
 export { buildInvokeAgentChildRunLifecycleCustomEvent, buildInvokeAgentChildRunProgressEvents, buildInvokeAgentChildRunStateDelta, InvokeAgentChildRunLifecycleCustomEventSchema, InvokeAgentChildRunLifecycleValueSchema, InvokeAgentChildRunStateDeltaSchema, publishInvokeAgentChildRunProgress, } from "./invoke-agent-child-runs.js";
-export { runHostedChildLifecycle, } from "./hosted-child-lifecycle.js";
+export { runHostedChildExecutionLifecycle, runHostedChildLifecycle, } from "./hosted-child-lifecycle.js";
 export { appendHostedChildMirrorChunk, closeHostedChildReasoningSegment, closeHostedChildTextSegment, createHostedChildMirrorContext, isAlreadyMirroredHostedChunk, toMirroredHostedStreamPart, } from "./hosted-child-mirror.js";
 export { HostedChildTerminalStateError, monitorHostedChildRunStatus, resolveHostedChildTerminalErrorCode, } from "./hosted-child-status.js";
 export { runHostedLifecycle, } from "./hosted-lifecycle.js";
@@ -141,6 +141,6 @@ export { createDetachedRunTracker, } from "./detached-run-tracker.js";
 export { AgUiResumeSignalSchema, createAgUiCancelHandler, createAgUiResumeHandler, } from "./ag-ui-run-control.js";
 export { createAgUiRunErrorEvent, createAgUiSseErrorResponse, createAgUiSseResponse, normalizeAgUiMessages, parseAgUiRequest, parseAgUiRequestOrError, } from "./ag-ui-host-support.js";
 export { AgUiRequestSchema, createAgUiHandler, } from "./ag-ui-handler.js";
-export { HumanInputFieldSchema, HumanInputOptionSchema, HumanInputPendingRequestSchema, HumanInputRequestSchema, HumanInputResultSchema, HumanInputResumeError, InvalidHumanInputResultError, waitForHumanInput, } from "./human-input.js";
+export { executeDurableHumanInputFlow, HumanInputFieldSchema, HumanInputOptionSchema, HumanInputPendingRequestSchema, HumanInputRequestSchema, HumanInputResultSchema, HumanInputResumeError, InvalidHumanInputResultError, waitForDurableHumanInputResolution, waitForHumanInput, } from "./human-input.js";
 export { createChatHandler, } from "./chat-handler.js";
 export { AgentRuntime, RunAlreadyExistsError, RunCancelledError, RunNotActiveError, RunResumeSessionManager, WaitConflictError, WaitNotPendingError, } from "./runtime/index.js";

package/esm/src/utils/version-constant.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.1.334";
+export declare const VERSION = "0.1.336";
 //# sourceMappingURL=version-constant.d.ts.map

package/esm/src/utils/version-constant.js

@@ -1,3 +1,3 @@
 // Keep in sync with deno.json version.
 // scripts/release.ts updates this constant during releases.
-export const VERSION = "0.1.334";
+export const VERSION = "0.1.336";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "veryfront",
-  "version": "0.1.334",
+  "version": "0.1.336",
   "description": "The simplest way to build AI-powered apps",
   "keywords": [
     "react",

package/src/deno.js

@@ -1,6 +1,6 @@
 export default {
   "name": "veryfront",
-  "version": "0.1.334",
+  "version": "0.1.336",
   "license": "Apache-2.0",
   "nodeModulesDir": "auto",
   "workspace": [

package/src/src/agent/hosted-child-lifecycle.ts

@@ -1,3 +1,15 @@
+import {
+  buildChildRunExecutionSnapshot,
+  type ChildRunExecutionResult,
+  type ChildRunExecutionSnapshot,
+  getChildRunSnapshotUsage,
+} from "./child-run-execution-snapshot.js";
+import { isChildRunAbortError } from "./child-run-execution-support.js";
+import {
+  HostedChildTerminalStateError,
+  resolveHostedChildTerminalErrorCode,
+} from "./hosted-child-status.js";
+
 export interface HostedChildLifecycleTerminalState {
   status: "completed" | "failed" | "cancelled";
   usage?: {
@@ -61,6 +73,47 @@ export type HostedChildLifecycleRunResult<TResult> =
     terminalState: HostedChildLifecycleTerminalState;
   };
 
+export type HostedChildExecutionLifecycleResult<
+  TLocalResult extends ChildRunExecutionResult,
+> =
+  | {
+    status: "completed";
+    result: TLocalResult;
+    snapshot: ChildRunExecutionSnapshot;
+    terminalState: HostedChildLifecycleTerminalState;
+  }
+  | {
+    status: "failed" | "cancelled";
+    error: unknown;
+    terminalState: HostedChildLifecycleTerminalState;
+  };
+
+export interface HostedChildExecutionLifecycleOptions<
+  TLocalResult extends ChildRunExecutionResult,
+> {
+  adapter: HostedChildLifecycleAdapter;
+  executionFailedCode: string;
+  abortSignal?: AbortSignal | undefined;
+  execute: () => Promise<TLocalResult> | TLocalResult;
+  getExecutionSnapshot: () => ChildRunExecutionSnapshot | null;
+  onLifecycleError?: (error: unknown) => Promise<void> | void;
+  skipTerminalPersistence?: (terminalState: HostedChildLifecycleTerminalState) => boolean;
+}
+
+class HostedChildExecutionFailure extends Error {
+  constructor(
+    message: string,
+    readonly usage?: {
+      inputTokens: number;
+      outputTokens: number;
+      totalTokens: number;
+    },
+  ) {
+    super(message);
+    this.name = "HostedChildExecutionFailure";
+  }
+}
+
 async function dispatchTerminalState(
   adapter: HostedChildLifecycleAdapter,
   terminalState: HostedChildLifecycleTerminalState,
@@ -119,3 +172,174 @@ export async function runHostedChildLifecycle<TResult>(
     terminalState,
   };
 }
+
+function toHostedChildLifecycleUsage(
+  usage: ChildRunExecutionSnapshot["usage"] | undefined,
+): HostedChildLifecycleTerminalState["usage"] {
+  if (!usage) {
+    return undefined;
+  }
+
+  return {
+    inputTokens: usage.inputTokens,
+    outputTokens: usage.outputTokens,
+    totalTokens: usage.totalTokens,
+  };
+}
+
+function wrapSkippableTerminalPersistence(
+  adapter: HostedChildLifecycleAdapter,
+  skipTerminalPersistence: HostedChildExecutionLifecycleOptions<
+    ChildRunExecutionResult
+  >["skipTerminalPersistence"],
+): HostedChildLifecycleAdapter {
+  if (!skipTerminalPersistence) {
+    return adapter;
+  }
+
+  return {
+    ...adapter,
+    failed: async (terminalState) => {
+      if (skipTerminalPersistence(terminalState)) {
+        return;
+      }
+
+      await adapter.failed?.(terminalState);
+    },
+    cancelled: async (terminalState) => {
+      if (skipTerminalPersistence(terminalState)) {
+        return;
+      }
+
+      await adapter.cancelled?.(terminalState);
+    },
+  };
+}
+
+function resolveHostedChildExecutionErrorState(
+  error: unknown,
+  input: {
+    executionFailedCode: string;
+    abortSignal?: AbortSignal | undefined;
+    getExecutionSnapshot: () => ChildRunExecutionSnapshot | null;
+  },
+): HostedChildLifecycleErrorState {
+  if (error instanceof HostedChildTerminalStateError) {
+    if (error.status === "completed") {
+      throw error;
+    }
+
+    return {
+      status: error.status,
+      terminalErrorCode: resolveHostedChildTerminalErrorCode(error.status),
+      terminalErrorMessage: error.message,
+    };
+  }
+
+  if (error instanceof HostedChildExecutionFailure) {
+    return {
+      status: "failed",
+      terminalErrorCode: input.executionFailedCode,
+      terminalErrorMessage: error.message,
+      usage: toHostedChildLifecycleUsage(error.usage),
+    };
+  }
+
+  if (isChildRunAbortError(error) || input.abortSignal?.aborted) {
+    return {
+      status: "cancelled",
+      terminalErrorCode: "CANCELLED",
+      terminalErrorMessage: "Child run cancelled",
+      usage: toHostedChildLifecycleUsage(getChildRunSnapshotUsage(input.getExecutionSnapshot())),
+    };
+  }
+
+  return {
+    status: "failed",
+    terminalErrorCode: input.executionFailedCode,
+    terminalErrorMessage: error instanceof Error ? error.message : String(error),
+    usage: toHostedChildLifecycleUsage(getChildRunSnapshotUsage(input.getExecutionSnapshot())),
+  };
+}
+
+export async function runHostedChildExecutionLifecycle<
+  TLocalResult extends ChildRunExecutionResult,
+>(
+  options: HostedChildExecutionLifecycleOptions<TLocalResult>,
+): Promise<HostedChildExecutionLifecycleResult<TLocalResult>> {
+  const adapter = wrapSkippableTerminalPersistence(
+    options.adapter,
+    options.skipTerminalPersistence,
+  );
+
+  try {
+    const lifecycleResult = await runHostedChildLifecycle({
+      adapter,
+      execute: async () => {
+        const result = await options.execute();
+        const snapshot = options.getExecutionSnapshot() ?? buildChildRunExecutionSnapshot(result);
+
+        if (!snapshot.success) {
+          throw new HostedChildExecutionFailure(snapshot.error ?? "Unknown error", snapshot.usage);
+        }
+
+        return {
+          result,
+          snapshot,
+        };
+      },
+      resolveCompletedState: ({ snapshot }) => ({
+        status: "completed",
+        usage: toHostedChildLifecycleUsage(snapshot.usage),
+      }),
+      resolveErrorState: (error) =>
+        resolveHostedChildExecutionErrorState(error, {
+          executionFailedCode: options.executionFailedCode,
+          abortSignal: options.abortSignal,
+          getExecutionSnapshot: options.getExecutionSnapshot,
+        }),
+      onLifecycleError: options.onLifecycleError,
+    });
+
+    if (lifecycleResult.status !== "completed") {
+      return lifecycleResult;
+    }
+
+    return {
+      status: "completed",
+      result: lifecycleResult.result.result,
+      snapshot: lifecycleResult.result.snapshot,
+      terminalState: lifecycleResult.terminalState,
+    };
+  } catch (error) {
+    if (error instanceof HostedChildTerminalStateError) {
+      return {
+        status: error.status === "cancelled" ? "cancelled" : "failed",
+        error,
+        terminalState: {
+          status: error.status,
+          terminalErrorCode: resolveHostedChildTerminalErrorCode(error.status),
+          terminalErrorMessage: error.message,
+        },
+      };
+    }
+
+    const terminalState = resolveHostedChildExecutionErrorState(error, {
+      executionFailedCode: options.executionFailedCode,
+      abortSignal: options.abortSignal,
+      getExecutionSnapshot: options.getExecutionSnapshot,
+    });
+
+    try {
+      await dispatchTerminalState(adapter, terminalState);
+    } catch (lifecycleError) {
+      await options.onLifecycleError?.(lifecycleError);
+    }
+
+    return {
+      status: terminalState.status,
+      error,
+      terminalState,
+    };
+  }
+}

package/src/src/agent/human-input.ts

@@ -1,3 +1,4 @@
+import * as dntShim from "../../_dnt.shims.js";
 import { z } from "zod";
 import { AgUiRuntimeRunIdSchema } from "./runtime-ag-ui-contract.js";
 import { RunResumeSessionManager } from "./runtime/index.js";
@@ -98,11 +99,42 @@ export type HumanInputRequestInput = z.input<typeof HumanInputRequestSchema>;
 export type HumanInputResult = z.infer<typeof HumanInputResultSchema>;
 export type HumanInputPendingRequest = z.infer<typeof HumanInputPendingRequestSchema>;
 
-type HumanInputResumeValue = {
+export type HumanInputResumeValue = {
   result: unknown;
   isError: boolean;
 };
 
+export type DurableHumanInputFlowResult<TCreatedRequest> = {
+  result: HumanInputResult;
+  createdRequest: TCreatedRequest;
+};
+
+export interface ExecuteDurableHumanInputFlowOptions<
+  TCreatedRequest,
+  TSnapshot,
+> {
+  sessionManager?: RunResumeSessionManager<HumanInputResumeValue> | undefined;
+  runId: string;
+  threadId: string;
+  toolCallId: string;
+  request: HumanInputRequestInput;
+  timeoutMs: number;
+  pollIntervalMs: number;
+  onRequest: (
+    request: HumanInputPendingRequest,
+  ) => TCreatedRequest | Promise<TCreatedRequest>;
+  onCreatedRequest?: ((request: TCreatedRequest) => void | Promise<void>) | undefined;
+  getSnapshot: (request: TCreatedRequest) => TSnapshot | Promise<TSnapshot>;
+  resolveSnapshot: (snapshot: TSnapshot) => HumanInputResult | undefined;
+}
+
+export interface WaitForDurableHumanInputResolutionOptions<TSnapshot> {
+  deadline: number;
+  pollIntervalMs: number;
+  getSnapshot: () => TSnapshot | Promise<TSnapshot>;
+  resolveSnapshot: (snapshot: TSnapshot) => HumanInputResult | undefined;
+}
+
 export interface WaitForHumanInputOptions {
   sessionManager: RunResumeSessionManager<HumanInputResumeValue>;
   runId: string;
@@ -127,6 +159,64 @@ export class InvalidHumanInputResultError extends Error {
   }
 }
 
+export async function executeDurableHumanInputFlow<
+  TCreatedRequest,
+  TSnapshot,
+>(
+  options: ExecuteDurableHumanInputFlowOptions<TCreatedRequest, TSnapshot>,
+): Promise<DurableHumanInputFlowResult<TCreatedRequest>> {
+  const sessionManager = options.sessionManager ??
+    new RunResumeSessionManager<HumanInputResumeValue>();
+  sessionManager.startRun({
+    runId: options.runId,
+    threadId: options.threadId,
+  });
+
+  let resolveCreatedRequest: ((request: TCreatedRequest) => void) | null = null;
+  const createdRequestPromise = new Promise<TCreatedRequest>((resolve) => {
+    resolveCreatedRequest = resolve;
+  });
+
+  try {
+    const result = await waitForHumanInput({
+      sessionManager,
+      runId: options.runId,
+      toolCallId: options.toolCallId,
+      request: options.request,
+      onRequest: async (pendingRequest) => {
+        const currentRequest = await options.onRequest(pendingRequest);
+        if (!resolveCreatedRequest) {
+          throw new Error("Durable human input flow could not track the created request");
+        }
+        resolveCreatedRequest(currentRequest);
+        await options.onCreatedRequest?.(currentRequest);
+
+        void bridgeDurableHumanInputRequest({
+          sessionManager,
+          runId: options.runId,
+          toolCallId: options.toolCallId,
+          createdRequest: currentRequest,
+          timeoutMs: options.timeoutMs,
+          pollIntervalMs: options.pollIntervalMs,
+          getSnapshot: options.getSnapshot,
+          resolveSnapshot: options.resolveSnapshot,
+        });
+      },
+    });
+
+    const createdRequest = await createdRequestPromise;
+
+    sessionManager.completeRun(options.runId);
+    return {
+      result,
+      createdRequest,
+    };
+  } catch (error) {
+    sessionManager.failRun(options.runId);
+    throw error;
+  }
+}
+
 export async function waitForHumanInput(
   options: WaitForHumanInputOptions,
 ): Promise<HumanInputResult> {
@@ -151,3 +241,76 @@ export async function waitForHumanInput(
 
   return parsed.data;
 }
+
+export async function waitForDurableHumanInputResolution<TSnapshot>(
+  options: WaitForDurableHumanInputResolutionOptions<TSnapshot>,
+): Promise<HumanInputResult> {
+  while (Date.now() < options.deadline) {
+    const snapshot = await options.getSnapshot();
+    const result = options.resolveSnapshot(snapshot);
+
+    if (result) {
+      return result;
+    }
+
+    await delay(options.pollIntervalMs);
+  }
+
+  throw new Error("Timed out while waiting for durable human input resolution");
+}
+
+async function bridgeDurableHumanInputRequest<
+  TCreatedRequest,
+  TSnapshot,
+>(input: {
+  sessionManager: RunResumeSessionManager<HumanInputResumeValue>;
+  runId: string;
+  toolCallId: string;
+  createdRequest: TCreatedRequest;
+  timeoutMs: number;
+  pollIntervalMs: number;
+  getSnapshot: (request: TCreatedRequest) => TSnapshot | Promise<TSnapshot>;
+  resolveSnapshot: (snapshot: TSnapshot) => HumanInputResult | undefined;
+}): Promise<void> {
+  try {
+    const resolved = await waitForDurableHumanInputResolution({
+      deadline: Date.now() + input.timeoutMs,
+      pollIntervalMs: input.pollIntervalMs,
+      getSnapshot: () => input.getSnapshot(input.createdRequest),
+      resolveSnapshot: input.resolveSnapshot,
+    });
+
+    submitHumanInputResumeValue(input.sessionManager, input.runId, input.toolCallId, {
+      result: resolved,
+      isError: false,
+    });
+  } catch (error) {
+    submitHumanInputResumeValue(input.sessionManager, input.runId, input.toolCallId, {
+      result: error instanceof Error ? error.message : String(error),
+      isError: true,
+    });
+  }
+}
+
+function submitHumanInputResumeValue(
+  sessionManager: RunResumeSessionManager<HumanInputResumeValue>,
+  runId: string,
+  toolCallId: string,
+  value: HumanInputResumeValue,
+) {
+  try {
+    sessionManager.submitSignal(runId, {
+      waitKey: toolCallId,
+      value,
+    });
+  } catch {
+    // Ignore late resume submissions once the local wait has already completed
+    // or the ephemeral session has been finalized.
+  }
+}
+
+function delay(ms: number): Promise<void> {
+  return new Promise((resolve) => {
+    dntShim.setTimeout(resolve, ms);
+  });
+}

package/src/src/agent/index.ts

@@ -527,10 +527,13 @@ export {
   publishInvokeAgentChildRunProgress,
 } from "./invoke-agent-child-runs.js";
 export {
+  type HostedChildExecutionLifecycleOptions,
+  type HostedChildExecutionLifecycleResult,
   type HostedChildLifecycleAdapter,
   type HostedChildLifecycleRunnerOptions,
   type HostedChildLifecycleRunResult,
   type HostedChildLifecycleTerminalState,
+  runHostedChildExecutionLifecycle,
   runHostedChildLifecycle,
 } from "./hosted-child-lifecycle.js";
 export {
@@ -644,6 +647,9 @@ export {
   createAgUiHandler,
 } from "./ag-ui-handler.js";
 export {
+  type DurableHumanInputFlowResult,
+  executeDurableHumanInputFlow,
+  type ExecuteDurableHumanInputFlowOptions,
   type HumanInputField,
   type HumanInputFieldInput,
   HumanInputFieldSchema,
@@ -657,7 +663,10 @@ export {
   type HumanInputResult,
   HumanInputResultSchema,
   HumanInputResumeError,
+  type HumanInputResumeValue,
   InvalidHumanInputResultError,
+  waitForDurableHumanInputResolution,
+  type WaitForDurableHumanInputResolutionOptions,
   waitForHumanInput,
   type WaitForHumanInputOptions,
 } from "./human-input.js";

package/src/src/utils/version-constant.ts

@@ -1,3 +1,3 @@
 // Keep in sync with deno.json version.
 // scripts/release.ts updates this constant during releases.
-export const VERSION = "0.1.334";
+export const VERSION = "0.1.336";