veryfront 0.1.469 → 0.1.471

package/esm/src/server/service-server.d.ts

@@ -0,0 +1,43 @@
+export type VeryfrontServiceServerFetch = (request: Request) => Response | Promise<Response>;
+export type VeryfrontServiceServerModuleResponse = Response | null | undefined;
+export type VeryfrontServiceServerModule = {
+    name: string;
+    handle: (request: Request) => VeryfrontServiceServerModuleResponse | Promise<VeryfrontServiceServerModuleResponse>;
+    setShuttingDown?: () => void;
+    stop?: () => void | Promise<void>;
+};
+export type VeryfrontServiceServerLogger = {
+    debug?: (message: string, metadata?: Record<string, unknown>) => void;
+    info?: (message: string, metadata?: Record<string, unknown>) => void;
+    warn?: (message: string, metadata?: Record<string, unknown>) => void;
+    error?: (message: string, metadata?: Record<string, unknown>) => void;
+};
+export type CreateVeryfrontServerOptions = {
+    modules: readonly VeryfrontServiceServerModule[];
+    notFound?: (request: Request) => Response | Promise<Response>;
+    onError?: (error: unknown, request: Request) => Response | Promise<Response>;
+    logger?: VeryfrontServiceServerLogger;
+};
+export type VeryfrontServiceServerRuntime = {
+    fetch: VeryfrontServiceServerFetch;
+    setShuttingDown: () => void;
+    stop: () => Promise<void>;
+};
+export type StartNodeVeryfrontServerOptions = {
+    runtime: VeryfrontServiceServerRuntime;
+    port: number;
+    bindAddress?: string;
+    logger?: VeryfrontServiceServerLogger;
+    signals?: readonly NodeJS.Signals[];
+    hardShutdownTimeoutMs?: number;
+};
+export type NodeVeryfrontServiceServer = {
+    server: import("node:http").Server;
+    ready: Promise<void>;
+    stop: () => Promise<void>;
+    port: number;
+    url: string;
+};
+export declare function createVeryfrontServer(options: CreateVeryfrontServerOptions): VeryfrontServiceServerRuntime;
+export declare function startNodeVeryfrontServer(options: StartNodeVeryfrontServerOptions): Promise<NodeVeryfrontServiceServer>;
+//# sourceMappingURL=service-server.d.ts.map

package/esm/src/server/service-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-server.d.ts","sourceRoot":"","sources":["../../../src/src/server/service-server.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,2BAA2B,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;AAC7F,MAAM,MAAM,oCAAoC,GAAG,QAAQ,GAAG,IAAI,GAAG,SAAS,CAAC;AAE/E,MAAM,MAAM,4BAA4B,GAAG;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,CACN,OAAO,EAAE,OAAO,KACb,oCAAoC,GAAG,OAAO,CAAC,oCAAoC,CAAC,CAAC;IAC1F,eAAe,CAAC,EAAE,MAAM,IAAI,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IACzC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACtE,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACrE,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACrE,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CACvE,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IACzC,OAAO,EAAE,SAAS,4BAA4B,EAAE,CAAC;IACjD,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC9D,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,KAAK,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC7E,MAAM,CAAC,EAAE,4BAA4B,CAAC;CACvC,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG;IAC1C,KAAK,EAAE,2BAA2B,CAAC;IACnC,eAAe,EAAE,MAAM,IAAI,CAAC;IAC5B,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,+BAA+B,GAAG;IAC5C,OAAO,EAAE,6BAA6B,CAAC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,4BAA4B,CAAC;IACtC,OAAO,CAAC,EAAE,SAAS,MAAM,CAAC,OAAO,EAAE,CAAC;IACpC,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,MAAM,EAAE,OAAO,WAAW,EAAE,MAAM,CAAC;IACnC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACrB,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAkBF,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,4BAA4B,GACpC,6BAA6B,CAgC/B;AAeD,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,+BAA+B,GACvC,OAAO,CAAC,0BAA0B,CAAC,CAkErC"}

package/esm/src/server/service-server.js

@@ -0,0 +1,116 @@
+import * as dntShim from "../../_dnt.shims.js";
+import { serverLogger } from "../utils/index.js";
+import { toNodeHandler } from "./node-handler.js";
+function defaultNotFound() {
+    return new Response("Not Found", { status: 404 });
+}
+function defaultErrorResponse(error, request, logger) {
+    logger.error?.("Veryfront service request failed", {
+        url: request.url,
+        error: error instanceof Error ? error.message : String(error),
+    });
+    return new Response("Internal Server Error", { status: 500 });
+}
+export function createVeryfrontServer(options) {
+    const logger = options.logger ?? serverLogger.component("service-server");
+    const notFound = options.notFound ?? defaultNotFound;
+    const onError = options.onError ??
+        ((error, request) => defaultErrorResponse(error, request, logger));
+    return {
+        fetch: async (request) => {
+            try {
+                for (const module of options.modules) {
+                    const response = await module.handle(request);
+                    if (response) {
+                        return response;
+                    }
+                }
+                return await notFound(request);
+            }
+            catch (error) {
+                return await onError(error, request);
+            }
+        },
+        setShuttingDown: () => {
+            for (const module of options.modules) {
+                module.setShuttingDown?.();
+            }
+        },
+        stop: async () => {
+            for (const module of options.modules) {
+                await module.stop?.();
+            }
+        },
+    };
+}
+function closeNodeServer(server) {
+    return new Promise((resolve, reject) => {
+        server.close((error) => {
+            if (error) {
+                reject(error);
+                return;
+            }
+            resolve();
+        });
+    });
+}
+export async function startNodeVeryfrontServer(options) {
+    const { createServer } = await import("node:http");
+    const logger = options.logger ?? serverLogger.component("service-server");
+    const bindAddress = options.bindAddress ?? "0.0.0.0";
+    const hardShutdownTimeoutMs = options.hardShutdownTimeoutMs ?? 20_000;
+    const server = createServer(toNodeHandler(options.runtime.fetch));
+    let shutdownStarted = false;
+    const stop = async () => {
+        if (shutdownStarted) {
+            return;
+        }
+        shutdownStarted = true;
+        options.runtime.setShuttingDown();
+        await closeNodeServer(server);
+        await options.runtime.stop();
+    };
+    const ready = new Promise((resolve, reject) => {
+        server.once("error", reject);
+        server.listen(options.port, bindAddress, () => {
+            server.off("error", reject);
+            logger.info?.("Veryfront service server listening", {
+                port: options.port,
+                bindAddress,
+            });
+            resolve();
+        });
+    });
+    for (const signal of options.signals ?? ["SIGTERM"]) {
+        process.on(signal, () => {
+            if (shutdownStarted) {
+                return;
+            }
+            logger.info?.("Veryfront service server received shutdown signal", { signal });
+            const hardTimeout = dntShim.setTimeout(() => {
+                logger.error?.("Veryfront service server graceful shutdown timed out", { signal });
+                process.exit(1);
+            }, hardShutdownTimeoutMs);
+            void stop()
+                .then(() => {
+                clearTimeout(hardTimeout);
+                process.exit(0);
+            })
+                .catch((error) => {
+                clearTimeout(hardTimeout);
+                logger.error?.("Veryfront service server shutdown failed", {
+                    signal,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+                process.exit(1);
+            });
+        });
+    }
+    return {
+        server,
+        ready,
+        stop,
+        port: options.port,
+        url: `http://${bindAddress}:${options.port}`,
+    };
+}

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

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.1.469";
+export declare const VERSION = "0.1.471";
 //# 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.469";
+export const VERSION = "0.1.471";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "veryfront",
-  "version": "0.1.469",
+  "version": "0.1.471",
   "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.469",
+  "version": "0.1.471",
   "license": "Apache-2.0",
   "nodeModulesDir": "auto",
   "workspace": [

package/src/deps/esm.sh/@types/react-dom@19.2.3/client.d.ts

@@ -4,7 +4,7 @@
 
 // See https://github.com/facebook/react/blob/main/packages/react-dom/client.js to see how the exports are declared,
 
-import React = require("https://esm.sh/@types/react@19.2.14/index.d.ts");
+import React = require("https://esm.sh/@types/react@19.2.3/index.d.ts");
 
 export {};
 

package/src/deps/esm.sh/@types/{react@19.2.14 → react@19.2.3}/global.d.ts

@@ -18,7 +18,6 @@ interface KeyboardEvent extends Event {}
 interface MouseEvent extends Event {}
 interface TouchEvent extends Event {}
 interface PointerEvent extends Event {}
-interface SubmitEvent extends Event {}
 interface ToggleEvent extends Event {}
 interface TransitionEvent extends Event {}
 interface UIEvent extends Event {}

package/src/deps/esm.sh/@types/{react@19.2.14 → react@19.2.3}/index.d.ts

@@ -16,7 +16,6 @@ type NativeKeyboardEvent = KeyboardEvent;
 type NativeMouseEvent = MouseEvent;
 type NativeTouchEvent = TouchEvent;
 type NativePointerEvent = PointerEvent;
-type NativeSubmitEvent = SubmitEvent;
 type NativeToggleEvent = ToggleEvent;
 type NativeTransitionEvent = TransitionEvent;
 type NativeUIEvent = UIEvent;
@@ -226,20 +225,12 @@ declare namespace React {
 
     type ComponentState = any;
 
-    interface DO_NOT_USE_OR_YOU_WILL_BE_FIRED_EXPERIMENTAL_KEY_TYPES {}
-
     /**
      * A value which uniquely identifies a node among items in an array.
      *
      * @see {@link https://react.dev/learn/rendering-lists#keeping-list-items-in-order-with-key React Docs}
      */
-    type Key =
-        | string
-        | number
-        | bigint
-        | DO_NOT_USE_OR_YOU_WILL_BE_FIRED_EXPERIMENTAL_KEY_TYPES[
-            keyof DO_NOT_USE_OR_YOU_WILL_BE_FIRED_EXPERIMENTAL_KEY_TYPES
-        ];
+    type Key = string | number | bigint;
 
     /**
      * @internal The props any component can receive.
@@ -1893,7 +1884,7 @@ declare namespace React {
      *
      * @param callback A synchronous, void callback that will execute as a single, complete React commit.
      *
-     * @see {@link https://reactjs.org/blog/2019/02/06/react-v16.8.0.html#testing-hooks}
+     * @see https://reactjs.org/blog/2019/02/06/react-v16.8.0.html#testing-hooks
      */
     // NOTES
     // - the order of these signatures matters - typescript will check the signatures in source order.
@@ -1935,31 +1926,7 @@ declare namespace React {
         reducer: (state: State, action: Action) => State,
     ): [State, (action: Action) => void];
 
-    interface UntrackedReactPromise<T> extends PromiseLike<T> {
-        status?: void;
-    }
-
-    export interface PendingReactPromise<T> extends PromiseLike<T> {
-        status: "pending";
-    }
-
-    export interface FulfilledReactPromise<T> extends PromiseLike<T> {
-        status: "fulfilled";
-        value: T;
-    }
-
-    export interface RejectedReactPromise<T> extends PromiseLike<T> {
-        status: "rejected";
-        reason: unknown;
-    }
-
-    export type ReactPromise<T> =
-        | UntrackedReactPromise<T>
-        | PendingReactPromise<T>
-        | FulfilledReactPromise<T>
-        | RejectedReactPromise<T>;
-
-    export type Usable<T> = ReactPromise<T> | Context<T>;
+    export type Usable<T> = PromiseLike<T> | Context<T>;
 
     export function use<T>(usable: Usable<T>): T;
 
@@ -2074,28 +2041,15 @@ declare namespace React {
         target: EventTarget & Target;
     }
 
-    /**
-     * @deprecated FormEvent doesn't actually exist.
-     *             You probably meant to use {@link ChangeEvent}, {@link InputEvent}, {@link SubmitEvent}, or just {@link SyntheticEvent} instead
-     *             depending on the event type.
-     */
     interface FormEvent<T = Element> extends SyntheticEvent<T> {
     }
 
     interface InvalidEvent<T = Element> extends SyntheticEvent<T> {
+        target: EventTarget & T;
     }
 
-    /**
-     * change events bubble in React so their target is generally unknown.
-     * Only for form elements we know their target type because form events can't
-     * be nested.
-     * This type exists purely to narrow `target` for form elements. It doesn't
-     * reflect a DOM event. Change events are just fired as standard {@link SyntheticEvent}.
-     */
-    interface ChangeEvent<CurrentTarget = Element, Target = Element> extends SyntheticEvent<CurrentTarget> {
-        // TODO: This is wrong for change event handlers on arbitrary. Should
-        // be EventTarget & Target, but kept for backward compatibility until React 20.
-        target: EventTarget & CurrentTarget;
+    interface ChangeEvent<T = Element> extends SyntheticEvent<T> {
+        target: EventTarget & T;
     }
 
     interface InputEvent<T = Element> extends SyntheticEvent<T, NativeInputEvent> {
@@ -2165,13 +2119,6 @@ declare namespace React {
         shiftKey: boolean;
     }
 
-    interface SubmitEvent<T = Element> extends SyntheticEvent<T, NativeSubmitEvent> {
-        // `submitter` is available in react@canary
-        // submitter: HTMLElement | null;
-        // SubmitEvents are always targetted at HTMLFormElements.
-        target: EventTarget & HTMLFormElement;
-    }
-
     interface TouchEvent<T = Element> extends UIEvent<T, NativeTouchEvent> {
         altKey: boolean;
         changedTouches: TouchList;
@@ -2227,19 +2174,11 @@ declare namespace React {
     type CompositionEventHandler<T = Element> = EventHandler<CompositionEvent<T>>;
     type DragEventHandler<T = Element> = EventHandler<DragEvent<T>>;
     type FocusEventHandler<T = Element> = EventHandler<FocusEvent<T>>;
-    /**
-     * @deprecated FormEventHandler doesn't actually exist.
-     *             You probably meant to use {@link ChangeEventHandler}, {@link InputEventHandler}, {@link SubmitEventHandler}, or just {@link EventHandler} instead
-     *             depending on the event type.
-     */
     type FormEventHandler<T = Element> = EventHandler<FormEvent<T>>;
-    type ChangeEventHandler<CurrentTarget = Element, Target = Element> = EventHandler<
-        ChangeEvent<CurrentTarget, Target>
-    >;
+    type ChangeEventHandler<T = Element> = EventHandler<ChangeEvent<T>>;
     type InputEventHandler<T = Element> = EventHandler<InputEvent<T>>;
     type KeyboardEventHandler<T = Element> = EventHandler<KeyboardEvent<T>>;
     type MouseEventHandler<T = Element> = EventHandler<MouseEvent<T>>;
-    type SubmitEventHandler<T = Element> = EventHandler<SubmitEvent<T>>;
     type TouchEventHandler<T = Element> = EventHandler<TouchEvent<T>>;
     type PointerEventHandler<T = Element> = EventHandler<PointerEvent<T>>;
     type UIEventHandler<T = Element> = EventHandler<UIEvent<T>>;
@@ -2293,19 +2232,19 @@ declare namespace React {
         onBlur?: FocusEventHandler<T> | undefined;
         onBlurCapture?: FocusEventHandler<T> | undefined;
 
-        // form related Events
-        onChange?: ChangeEventHandler<T> | undefined;
-        onChangeCapture?: ChangeEventHandler<T> | undefined;
+        // Form Events
+        onChange?: FormEventHandler<T> | undefined;
+        onChangeCapture?: FormEventHandler<T> | undefined;
         onBeforeInput?: InputEventHandler<T> | undefined;
-        onBeforeInputCapture?: InputEventHandler<T> | undefined;
-        onInput?: InputEventHandler<T> | undefined;
-        onInputCapture?: InputEventHandler<T> | undefined;
-        onReset?: ReactEventHandler<T> | undefined;
-        onResetCapture?: ReactEventHandler<T> | undefined;
-        onSubmit?: SubmitEventHandler<T> | undefined;
-        onSubmitCapture?: SubmitEventHandler<T> | undefined;
-        onInvalid?: ReactEventHandler<T> | undefined;
-        onInvalidCapture?: ReactEventHandler<T> | undefined;
+        onBeforeInputCapture?: FormEventHandler<T> | undefined;
+        onInput?: FormEventHandler<T> | undefined;
+        onInputCapture?: FormEventHandler<T> | undefined;
+        onReset?: FormEventHandler<T> | undefined;
+        onResetCapture?: FormEventHandler<T> | undefined;
+        onSubmit?: FormEventHandler<T> | undefined;
+        onSubmitCapture?: FormEventHandler<T> | undefined;
+        onInvalid?: FormEventHandler<T> | undefined;
+        onInvalidCapture?: FormEventHandler<T> | undefined;
 
         // Image Events
         onLoad?: ReactEventHandler<T> | undefined;
@@ -2849,7 +2788,7 @@ declare namespace React {
 
         // Living Standard
         /**
-         * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/inert}
+         * @see https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/inert
          */
         inert?: boolean | undefined;
         /**
@@ -3312,9 +3251,7 @@ declare namespace React {
         value?: string | readonly string[] | number | undefined;
         width?: number | string | undefined;
 
-        // No other element dispatching change events can be nested in a <input>
-        // so we know the target will be a HTMLInputElement.
-        onChange?: ChangeEventHandler<T, HTMLInputElement> | undefined;
+        onChange?: ChangeEventHandler<T> | undefined;
     }
 
     interface KeygenHTMLAttributes<T> extends HTMLAttributes<T> {
@@ -3479,9 +3416,7 @@ declare namespace React {
         required?: boolean | undefined;
         size?: number | undefined;
         value?: string | readonly string[] | number | undefined;
-        // No other element dispatching change events can be nested in a <select>
-        // so we know the target will be a HTMLSelectElement.
-        onChange?: ChangeEventHandler<T, HTMLSelectElement> | undefined;
+        onChange?: ChangeEventHandler<T> | undefined;
     }
 
     interface SourceHTMLAttributes<T> extends HTMLAttributes<T> {
@@ -3533,9 +3468,7 @@ declare namespace React {
         value?: string | readonly string[] | number | undefined;
         wrap?: string | undefined;
 
-        // No other element dispatching change events can be nested in a <textarea>
-        // so we know the target will be a HTMLTextAreaElement.
-        onChange?: ChangeEventHandler<T, HTMLTextAreaElement> | undefined;
+        onChange?: ChangeEventHandler<T> | undefined;
     }
 
     interface TdHTMLAttributes<T> extends HTMLAttributes<T> {
@@ -3607,9 +3540,6 @@ declare namespace React {
         method?: string | undefined;
         min?: number | string | undefined;
         name?: string | undefined;
-        nonce?: string | undefined;
-        part?: string | undefined;
-        slot?: string | undefined;
         style?: CSSProperties | undefined;
         target?: string | undefined;
         type?: string | undefined;
@@ -4127,6 +4057,7 @@ declare namespace React {
          * Captures which component contained the exception, and its ancestors.
          */
         componentStack?: string | null;
+        digest?: string | null;
     }
 
     // Keep in sync with JSX namespace in ./jsx-runtime.d.ts and ./jsx-dev-runtime.d.ts

package/src/deps/esm.sh/react-dom@19.2.4/client.d.ts

@@ -4,7 +4,7 @@
 
 // See https://github.com/facebook/react/blob/main/packages/react-dom/client.js to see how the exports are declared,
 
-import React = require("https://esm.sh/@types/react@19.2.14/index.d.ts");
+import React = require("https://esm.sh/@types/react@19.2.3/index.d.ts");
 
 export {};
 

package/src/src/agent/hosted-chat-execution-runtime.ts

@@ -1,10 +1,17 @@
-import * as dntShim from "../../_dnt.shims.js";
 import {
   buildChatStreamChunkMessageMetadata,
   extractChatMessageMetadata,
 } from "../chat/chat-ui-message-helpers.js";
 import { getLastStreamStep } from "../chat/final-step-fallback.js";
 import type { ChatUiMessage, ChatUiMessageChunk, MessageMetadata } from "../chat/types.js";
+import type { HostedConversationRootRunContext } from "./conversation-root-run-lifecycle.js";
+import {
+  createHostedAgentRunSpanController,
+  createHostedRootRunLifecycleRuntimeAdapter,
+  type CreateHostedRootRunLifecycleRuntimeAdapterInput,
+  type HostedAgentRunSpanController,
+  type HostedAgentRunTracer,
+} from "./hosted-agent-run-lifecycle.js";
 import {
   buildDetachedFallbackChunks,
   buildDetachedFallbackMessageState,
@@ -112,6 +119,44 @@ export interface CreateHostedChatExecutionRuntimeInput {
   incompleteToolCallsPartErrorText?: string;
 }
 
+export interface CreateBootstrappedHostedChatExecutionRuntimeInput {
+  authToken: string;
+  apiUrl: string;
+  agent: HostedChatRuntimeAgent;
+  agentId: string;
+  modelId: string;
+  cleanup: () => Promise<void>;
+  messages: ChatUiMessage[];
+  finalMessages: HostedChatRuntimeStreamInput["messages"];
+  conversationId?: string;
+  projectId: string | null;
+  userId: string;
+  rootRunContext: HostedConversationRootRunContext;
+  abortSignal: AbortSignal;
+  responseMessageId?: string;
+  upstreamParentConversationId?: string;
+  upstreamParentRunId?: string;
+  spawnedFromToolCallId?: string;
+  tracer: HostedAgentRunTracer;
+  resolveProvider: (modelId: string) => string;
+  traceStream?: CreateHostedChatExecutionRuntimeBootstrapInput["traceStream"];
+  logger?: HostedChatExecutionRuntimeLogger;
+  spanName?: string;
+  terminalErrorCode?: string;
+  incompleteToolCallsPartErrorText?: string;
+  createRootStreamWatchdog?: CreateHostedChatExecutionRuntimeBootstrapInput[
+    "createRootStreamWatchdog"
+  ];
+  createTerminalAdapter?: CreateHostedRootRunLifecycleRuntimeAdapterInput[
+    "createTerminalAdapter"
+  ];
+}
+
+export interface BootstrappedHostedChatExecutionRuntime {
+  agentRunSpan: HostedAgentRunSpanController;
+  execution: HostedChatExecutionRuntime;
+}
+
 type SharedFinalizationHooks = Pick<
   FinalizeHostedResponseOptions<ChatUiMessage, ChatUiMessageChunk<MessageMetadata>>,
   | "resolveEmptyTerminalError"
@@ -157,10 +202,7 @@ function createHostedChatExecutionCleanup(cleanup: () => Promise<void>): () => P
 }
 
 function createDefaultHostedChatExecutionRootStreamWatchdog(): HostedChatExecutionRootStreamWatchdog {
-  return createChatStreamWatchdog({
-    setTimeoutFn: dntShim.dntGlobalThis["setTimeout"],
-    clearTimeoutFn: globalThis["clearTimeout"],
-  });
+  return createChatStreamWatchdog();
 }
 
 function traceHostedChatRuntimeStream<T>(
@@ -188,14 +230,20 @@ export async function createHostedChatExecutionRuntimeBootstrap(
     : createDefaultHostedChatExecutionRootStreamWatchdog();
   const streamAbortSignal = AbortSignal.any([input.abortSignal, rootStreamWatchdog.signal]);
 
-  const streamResult = await traceHostedChatRuntimeStream(
-    input.traceStream,
-    () =>
-      input.agent.stream({
-        messages: input.finalMessages,
-        abortSignal: streamAbortSignal,
-      }),
-  );
+  let streamResult: HostedChatRuntimeStreamResult;
+  try {
+    streamResult = await traceHostedChatRuntimeStream(
+      input.traceStream,
+      () =>
+        input.agent.stream({
+          messages: input.finalMessages,
+          abortSignal: streamAbortSignal,
+        }),
+    );
+  } catch (error) {
+    rootStreamWatchdog.dispose();
+    throw error;
+  }
 
   return {
     cleanup,
@@ -209,6 +257,79 @@ export async function createHostedChatExecutionRuntimeBootstrap(
   };
 }
 
+async function createBootstrappedHostedChatRuntime(
+  input: CreateBootstrappedHostedChatExecutionRuntimeInput,
+  agentRunSpan: HostedAgentRunSpanController,
+): Promise<HostedChatExecutionRuntime> {
+  const lifecycleAdapter = createHostedRootRunLifecycleRuntimeAdapter({
+    authToken: input.authToken,
+    apiUrl: input.apiUrl,
+    modelId: input.modelId,
+    durableRootRun: input.rootRunContext.durableRootRun,
+    durableRunMirror: input.rootRunContext.durableRunMirror,
+    agentRunSpan,
+    resolveProvider: input.resolveProvider,
+    ...(input.createTerminalAdapter ? { createTerminalAdapter: input.createTerminalAdapter } : {}),
+  });
+  const bootstrap = await createHostedChatExecutionRuntimeBootstrap({
+    agent: input.agent,
+    cleanup: input.cleanup,
+    lifecycleAdapter,
+    finalMessages: input.finalMessages,
+    conversationId: input.conversationId,
+    abortSignal: input.abortSignal,
+    traceStream: input.traceStream,
+    ...(input.createRootStreamWatchdog
+      ? { createRootStreamWatchdog: input.createRootStreamWatchdog }
+      : {}),
+  });
+
+  return createHostedChatExecutionRuntime({
+    agentId: input.agentId,
+    modelId: input.modelId,
+    originalMessages: input.messages,
+    responseMessageId: input.responseMessageId,
+    runContext: agentRunSpan,
+    abortSignal: input.abortSignal,
+    bootstrap,
+    logger: input.logger,
+    incompleteToolCallsPartErrorText: input.incompleteToolCallsPartErrorText,
+  });
+}
+
+export async function createBootstrappedHostedChatExecutionRuntime(
+  input: CreateBootstrappedHostedChatExecutionRuntimeInput,
+): Promise<BootstrappedHostedChatExecutionRuntime> {
+  const agentRunSpan = createHostedAgentRunSpanController({
+    tracer: input.tracer,
+    spanName: input.spanName,
+    operationName: "chat",
+    conversationId: input.conversationId,
+    projectId: input.projectId,
+    userId: input.userId,
+    agentId: input.agentId,
+    rootRun: input.rootRunContext.durableRootRun,
+    upstreamParentConversationId: input.upstreamParentConversationId,
+    upstreamParentRunId: input.upstreamParentRunId,
+    spawnedFromToolCallId: input.spawnedFromToolCallId,
+  });
+
+  try {
+    const execution = await agentRunSpan.withContext(() =>
+      createBootstrappedHostedChatRuntime(input, agentRunSpan)
+    );
+    return { agentRunSpan, execution };
+  } catch (error) {
+    agentRunSpan.finalize({
+      status: "failed",
+      modelId: input.modelId,
+      terminalErrorCode: input.terminalErrorCode ?? "STREAM_ERROR",
+      terminalErrorMessage: error instanceof Error ? error.message : String(error),
+    });
+    throw error;
+  }
+}
+
 export function createHostedChatStreamFinalizationHooks(input: {
   lifecycleAdapter: HostedChatExecutionLifecycleAdapter;
   cleanup: () => Promise<void>;

package/src/src/agent/index.ts

@@ -174,6 +174,9 @@ export {
 } from "./hosted-child-fork-tool-sources.js";
 
 export {
+  createRuntimeAgentSystemMessages,
+  type CreateRuntimeAgentSystemMessagesInput,
+  DEFAULT_RUNTIME_AGENT_CONTEXT_MARKER,
   parseRuntimeAgentMarkdownDefinition,
   type ParseRuntimeAgentMarkdownDefinitionInput,
   parseRuntimeAgentMarkdownDefinitionInputSchema,
@@ -1022,7 +1025,10 @@ export {
   type FinalizedMessageState,
 } from "./hosted-finalized-message.js";
 export {
+  type BootstrappedHostedChatExecutionRuntime,
   cleanupAfterHostedChatExecutionFinalization,
+  createBootstrappedHostedChatExecutionRuntime,
+  type CreateBootstrappedHostedChatExecutionRuntimeInput,
   createHostedChatExecutionRuntime,
   createHostedChatExecutionRuntimeBootstrap,
   type CreateHostedChatExecutionRuntimeBootstrapInput,