veryfront 0.1.255 → 0.1.257

package/esm/deno.js

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

package/esm/src/agent/conversation-hosted-terminal.d.ts

@@ -0,0 +1,29 @@
+import { type ConversationRunProjection } from "./durable.js";
+import type { HostedLifecycleTerminalState } from "./hosted-lifecycle.js";
+export interface ConversationHostedTerminalStateInput {
+    status: HostedLifecycleTerminalState["status"];
+    metadata?: HostedLifecycleTerminalState["metadata"];
+    terminalErrorCode?: string | null;
+    terminalErrorMessage?: string | null;
+}
+export interface CreateConversationHostedTerminalAdapterOptions {
+    authToken: string;
+    apiUrl: string;
+    run: ConversationRunProjection | null;
+    fallbackModelId: string;
+    resolveProvider: (modelId: string) => string;
+    onTerminalState?: (terminalState: HostedLifecycleTerminalState) => Promise<void> | void;
+}
+export interface ConversationHostedTerminalAdapter {
+    toTerminalState: (state: ConversationHostedTerminalStateInput) => HostedLifecycleTerminalState;
+    finalizeRun: (terminalState: HostedLifecycleTerminalState) => Promise<void>;
+    cancelRun: (terminalState: HostedLifecycleTerminalState) => Promise<void>;
+    onTerminalState: (terminalState: HostedLifecycleTerminalState) => Promise<void>;
+    dispatch: (state: ConversationHostedTerminalStateInput) => Promise<HostedLifecycleTerminalState>;
+}
+export declare function toConversationHostedTerminalState(input: {
+    fallbackModelId: string;
+    state: ConversationHostedTerminalStateInput;
+}): HostedLifecycleTerminalState;
+export declare function createConversationHostedTerminalAdapter(options: CreateConversationHostedTerminalAdapterOptions): ConversationHostedTerminalAdapter;
+//# sourceMappingURL=conversation-hosted-terminal.d.ts.map

package/esm/src/agent/conversation-hosted-terminal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-hosted-terminal.d.ts","sourceRoot":"","sources":["../../../src/src/agent/conversation-hosted-terminal.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,yBAAyB,EAE/B,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AAE1E,MAAM,WAAW,oCAAoC;IACnD,MAAM,EAAE,4BAA4B,CAAC,QAAQ,CAAC,CAAC;IAC/C,QAAQ,CAAC,EAAE,4BAA4B,CAAC,UAAU,CAAC,CAAC;IACpD,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;AAED,MAAM,WAAW,8CAA8C;IAC7D,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,yBAAyB,GAAG,IAAI,CAAC;IACtC,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;IAC7C,eAAe,CAAC,EAAE,CAAC,aAAa,EAAE,4BAA4B,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACzF;AAED,MAAM,WAAW,iCAAiC;IAChD,eAAe,EAAE,CAAC,KAAK,EAAE,oCAAoC,KAAK,4BAA4B,CAAC;IAC/F,WAAW,EAAE,CAAC,aAAa,EAAE,4BAA4B,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5E,SAAS,EAAE,CAAC,aAAa,EAAE,4BAA4B,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1E,eAAe,EAAE,CAAC,aAAa,EAAE,4BAA4B,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChF,QAAQ,EAAE,CAAC,KAAK,EAAE,oCAAoC,KAAK,OAAO,CAAC,4BAA4B,CAAC,CAAC;CAClG;AAqCD,wBAAgB,iCAAiC,CAAC,KAAK,EAAE;IACvD,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,oCAAoC,CAAC;CAC7C,GAAG,4BAA4B,CAqB/B;AAED,wBAAgB,uCAAuC,CACrD,OAAO,EAAE,8CAA8C,GACtD,iCAAiC,CAsDnC"}

package/esm/src/agent/conversation-hosted-terminal.js

@@ -0,0 +1,93 @@
+import { finalizeConversationAgentRun, } from "./durable.js";
+function buildConversationHostedLifecycleUsage(usage) {
+    if (!usage) {
+        return undefined;
+    }
+    return {
+        ...(usage.inputTokens !== undefined ? { inputTokens: usage.inputTokens } : {}),
+        ...(usage.outputTokens !== undefined ? { outputTokens: usage.outputTokens } : {}),
+        ...(usage.cachedInputTokens !== undefined
+            ? { cachedInputTokens: usage.cachedInputTokens }
+            : {}),
+    };
+}
+function buildConversationAgentRunUsage(usage) {
+    if (!usage) {
+        return undefined;
+    }
+    const inputTokens = usage.inputTokens ?? 0;
+    const outputTokens = usage.outputTokens ?? 0;
+    return {
+        inputTokens,
+        outputTokens,
+        totalTokens: inputTokens + outputTokens,
+    };
+}
+export function toConversationHostedTerminalState(input) {
+    const modelId = input.state.metadata?.modelId ?? input.fallbackModelId;
+    const usage = buildConversationHostedLifecycleUsage(input.state.metadata?.usage);
+    return {
+        status: input.state.status,
+        ...(modelId || usage
+            ? {
+                metadata: {
+                    ...(modelId ? { modelId } : {}),
+                    ...(usage ? { usage } : {}),
+                },
+            }
+            : {}),
+        ...(input.state.terminalErrorCode !== undefined
+            ? { terminalErrorCode: input.state.terminalErrorCode }
+            : {}),
+        ...(input.state.terminalErrorMessage !== undefined
+            ? { terminalErrorMessage: input.state.terminalErrorMessage }
+            : {}),
+    };
+}
+export function createConversationHostedTerminalAdapter(options) {
+    let durableRunFinalized = false;
+    const finalizeDurableRun = async (terminalState, status) => {
+        if (!options.run || durableRunFinalized) {
+            return;
+        }
+        durableRunFinalized = true;
+        const modelId = terminalState.metadata?.modelId ?? options.fallbackModelId;
+        await finalizeConversationAgentRun({
+            authToken: options.authToken,
+            apiUrl: options.apiUrl,
+            conversationId: options.run.conversationId,
+            runId: options.run.runId,
+            status,
+            model: modelId,
+            provider: options.resolveProvider(modelId),
+            usage: buildConversationAgentRunUsage(terminalState.metadata?.usage),
+            terminalErrorCode: terminalState.terminalErrorCode,
+            terminalErrorMessage: terminalState.terminalErrorMessage,
+        });
+    };
+    return {
+        toTerminalState: (state) => toConversationHostedTerminalState({
+            fallbackModelId: options.fallbackModelId,
+            state,
+        }),
+        finalizeRun: (terminalState) => finalizeDurableRun(terminalState, terminalState.status),
+        cancelRun: (terminalState) => finalizeDurableRun(terminalState, "cancelled"),
+        onTerminalState: async (terminalState) => {
+            await options.onTerminalState?.(terminalState);
+        },
+        dispatch: async (state) => {
+            const terminalState = toConversationHostedTerminalState({
+                fallbackModelId: options.fallbackModelId,
+                state,
+            });
+            if (terminalState.status === "cancelled") {
+                await finalizeDurableRun(terminalState, "cancelled");
+            }
+            else {
+                await finalizeDurableRun(terminalState, terminalState.status);
+            }
+            await options.onTerminalState?.(terminalState);
+            return terminalState;
+        },
+    };
+}

package/esm/src/agent/conversation-root-run-lifecycle.d.ts

@@ -0,0 +1,22 @@
+import { type ConversationRootRunContext } from "./conversation-root-run-context.js";
+import type { ConversationRunProjection } from "./durable.js";
+export interface ConversationRootRunLifecycle<TMirror> extends ConversationRootRunContext {
+    mirror: TMirror | null;
+}
+export interface PrepareConversationRootRunLifecycleOptions<TMirror> {
+    startRun: (input: {
+        abortSignal: AbortSignal;
+    }) => Promise<{
+        run: ConversationRunProjection | null;
+    }> | {
+        run: ConversationRunProjection | null;
+    };
+    parentRunId?: string;
+    parentMessageId?: string;
+    appendParentRunEvents?: ((events: unknown[]) => Promise<void> | void) | undefined;
+    createMirror?: (run: ConversationRunProjection) => Promise<TMirror> | TMirror;
+}
+export declare function prepareConversationRootRunLifecycle<TMirror>(input: PrepareConversationRootRunLifecycleOptions<TMirror>, options: {
+    abortSignal: AbortSignal;
+}): Promise<ConversationRootRunLifecycle<TMirror>>;
+//# sourceMappingURL=conversation-root-run-lifecycle.d.ts.map

package/esm/src/agent/conversation-root-run-lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-root-run-lifecycle.d.ts","sourceRoot":"","sources":["../../../src/src/agent/conversation-root-run-lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,0BAA0B,EAEhC,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAE9D,MAAM,WAAW,4BAA4B,CAAC,OAAO,CAAE,SAAQ,0BAA0B;IACvF,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,0CAA0C,CAAC,OAAO;IACjE,QAAQ,EAAE,CACR,KAAK,EAAE;QAAE,WAAW,EAAE,WAAW,CAAA;KAAE,KAChC,OAAO,CAAC;QAAE,GAAG,EAAE,yBAAyB,GAAG,IAAI,CAAA;KAAE,CAAC,GAAG;QACxD,GAAG,EAAE,yBAAyB,GAAG,IAAI,CAAC;KACvC,CAAC;IACF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,qBAAqB,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,SAAS,CAAC;IAClF,YAAY,CAAC,EAAE,CACb,GAAG,EAAE,yBAAyB,KAC3B,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CACjC;AAED,wBAAsB,mCAAmC,CAAC,OAAO,EAC/D,KAAK,EAAE,0CAA0C,CAAC,OAAO,CAAC,EAC1D,OAAO,EAAE;IAAE,WAAW,EAAE,WAAW,CAAA;CAAE,GACpC,OAAO,CAAC,4BAA4B,CAAC,OAAO,CAAC,CAAC,CAahD"}

package/esm/src/agent/conversation-root-run-lifecycle.js

@@ -0,0 +1,14 @@
+import { createConversationRootRunContext, } from "./conversation-root-run-context.js";
+export async function prepareConversationRootRunLifecycle(input, options) {
+    const { run } = await input.startRun({ abortSignal: options.abortSignal });
+    const context = createConversationRootRunContext({
+        run,
+        parentRunId: input.parentRunId,
+        parentMessageId: input.parentMessageId,
+        appendParentRunEvents: input.appendParentRunEvents,
+    });
+    return {
+        ...context,
+        mirror: run && input.createMirror ? await input.createMirror(run) : null,
+    };
+}

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

@@ -91,8 +91,10 @@ export { type AgUiBrowserEncodedEvent, type AgUiBrowserEncoderState, type AgUiBr
 export { type AgUiBrowserResponseEncoder, type AgUiBrowserResponseExecution, type AgUiBrowserResponseRequestState, createAgUiBrowserResponseStream, type CreateAgUiBrowserResponseStreamInput, } from "./ag-ui-browser-response-stream.js";
 export { type ConversationRunContext, createConversationRunContext, } from "./conversation-run-context.js";
 export { type ConversationRootRunContext, type ConversationRootRunDescriptor, createConversationRootRunContext, createConversationRootRunStartAdapter, prepareConversationRootRunContext, startConversationRootRun, } from "./conversation-root-run-context.js";
+export { type ConversationRootRunLifecycle, prepareConversationRootRunLifecycle, type PrepareConversationRootRunLifecycleOptions, } from "./conversation-root-run-lifecycle.js";
 export { bootstrapConversationAgentRun, type BootstrapConversationAgentRunResult, type ConversationMessageRecord, ConversationMessageRecordSchema, type ConversationRecord, ConversationRecordSchema, createConversationMessage, createConversationRecord, ensureConversationProjectLink, fetchConversationRecord, } from "./conversation-bootstrap.js";
 export { type ConversationChildLifecycleContext, type ConversationHostedLifecycleFinalizeInput, createConversationChildLifecycleAdapter, createConversationHostedLifecycleAdapter, type CreateConversationHostedLifecycleAdapterOptions, createConversationHostedStreamLifecycleAdapter, } from "./conversation-hosted-lifecycle.js";
+export { type ConversationHostedTerminalAdapter, type ConversationHostedTerminalStateInput, createConversationHostedTerminalAdapter, type CreateConversationHostedTerminalAdapterOptions, toConversationHostedTerminalState, } from "./conversation-hosted-terminal.js";
 export { getConversationRunEventJsonByteLength, normalizeConversationRunEvent, normalizeConversationRunEvents, } from "./conversation-run-event-normalization.js";
 export { type ConversationRunEvent, ConversationRunEventEncoder, ConversationRunEventSchema, conversationRunEventTypes, encodeConversationRunEvents, normalizeEncodedConversationRunEvents, } from "./conversation-run-events.js";
 export { prepareConversationRunExternalEvents, prepareConversationRunStreamEvents, } from "./conversation-run-event-preparation.js";

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

@@ -90,8 +90,10 @@ export { buildAgUiBrowserFinalizeResponse, createAgUiBrowserEncoderState, finali
 export { createAgUiBrowserResponseStream, } from "./ag-ui-browser-response-stream.js";
 export { createConversationRunContext, } from "./conversation-run-context.js";
 export { createConversationRootRunContext, createConversationRootRunStartAdapter, prepareConversationRootRunContext, startConversationRootRun, } from "./conversation-root-run-context.js";
+export { prepareConversationRootRunLifecycle, } from "./conversation-root-run-lifecycle.js";
 export { bootstrapConversationAgentRun, ConversationMessageRecordSchema, ConversationRecordSchema, createConversationMessage, createConversationRecord, ensureConversationProjectLink, fetchConversationRecord, } from "./conversation-bootstrap.js";
 export { createConversationChildLifecycleAdapter, createConversationHostedLifecycleAdapter, createConversationHostedStreamLifecycleAdapter, } from "./conversation-hosted-lifecycle.js";
+export { createConversationHostedTerminalAdapter, toConversationHostedTerminalState, } from "./conversation-hosted-terminal.js";
 export { getConversationRunEventJsonByteLength, normalizeConversationRunEvent, normalizeConversationRunEvents, } from "./conversation-run-event-normalization.js";
 export { ConversationRunEventEncoder, ConversationRunEventSchema, conversationRunEventTypes, encodeConversationRunEvents, normalizeEncodedConversationRunEvents, } from "./conversation-run-events.js";
 export { prepareConversationRunExternalEvents, prepareConversationRunStreamEvents, } from "./conversation-run-event-preparation.js";

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

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.1.255";
+export declare const VERSION = "0.1.257";
 //# 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.255";
+export const VERSION = "0.1.257";

package/package.json

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

package/src/src/agent/conversation-hosted-terminal.ts

@@ -0,0 +1,149 @@
+import {
+  type ConversationAgentRunUsage,
+  type ConversationRunProjection,
+  finalizeConversationAgentRun,
+} from "./durable.js";
+import type { HostedLifecycleTerminalState } from "./hosted-lifecycle.js";
+
+export interface ConversationHostedTerminalStateInput {
+  status: HostedLifecycleTerminalState["status"];
+  metadata?: HostedLifecycleTerminalState["metadata"];
+  terminalErrorCode?: string | null;
+  terminalErrorMessage?: string | null;
+}
+
+export interface CreateConversationHostedTerminalAdapterOptions {
+  authToken: string;
+  apiUrl: string;
+  run: ConversationRunProjection | null;
+  fallbackModelId: string;
+  resolveProvider: (modelId: string) => string;
+  onTerminalState?: (terminalState: HostedLifecycleTerminalState) => Promise<void> | void;
+}
+
+export interface ConversationHostedTerminalAdapter {
+  toTerminalState: (state: ConversationHostedTerminalStateInput) => HostedLifecycleTerminalState;
+  finalizeRun: (terminalState: HostedLifecycleTerminalState) => Promise<void>;
+  cancelRun: (terminalState: HostedLifecycleTerminalState) => Promise<void>;
+  onTerminalState: (terminalState: HostedLifecycleTerminalState) => Promise<void>;
+  dispatch: (state: ConversationHostedTerminalStateInput) => Promise<HostedLifecycleTerminalState>;
+}
+
+type HostedLifecycleUsage = NonNullable<HostedLifecycleTerminalState["metadata"]>["usage"];
+
+function buildConversationHostedLifecycleUsage(
+  usage: HostedLifecycleUsage | undefined,
+): HostedLifecycleUsage | undefined {
+  if (!usage) {
+    return undefined;
+  }
+
+  return {
+    ...(usage.inputTokens !== undefined ? { inputTokens: usage.inputTokens } : {}),
+    ...(usage.outputTokens !== undefined ? { outputTokens: usage.outputTokens } : {}),
+    ...(usage.cachedInputTokens !== undefined
+      ? { cachedInputTokens: usage.cachedInputTokens }
+      : {}),
+  };
+}
+
+function buildConversationAgentRunUsage(
+  usage: HostedLifecycleUsage | undefined,
+): ConversationAgentRunUsage | undefined {
+  if (!usage) {
+    return undefined;
+  }
+
+  const inputTokens = usage.inputTokens ?? 0;
+  const outputTokens = usage.outputTokens ?? 0;
+
+  return {
+    inputTokens,
+    outputTokens,
+    totalTokens: inputTokens + outputTokens,
+  };
+}
+
+export function toConversationHostedTerminalState(input: {
+  fallbackModelId: string;
+  state: ConversationHostedTerminalStateInput;
+}): HostedLifecycleTerminalState {
+  const modelId = input.state.metadata?.modelId ?? input.fallbackModelId;
+  const usage = buildConversationHostedLifecycleUsage(input.state.metadata?.usage);
+
+  return {
+    status: input.state.status,
+    ...(modelId || usage
+      ? {
+        metadata: {
+          ...(modelId ? { modelId } : {}),
+          ...(usage ? { usage } : {}),
+        },
+      }
+      : {}),
+    ...(input.state.terminalErrorCode !== undefined
+      ? { terminalErrorCode: input.state.terminalErrorCode }
+      : {}),
+    ...(input.state.terminalErrorMessage !== undefined
+      ? { terminalErrorMessage: input.state.terminalErrorMessage }
+      : {}),
+  };
+}
+
+export function createConversationHostedTerminalAdapter(
+  options: CreateConversationHostedTerminalAdapterOptions,
+): ConversationHostedTerminalAdapter {
+  let durableRunFinalized = false;
+
+  const finalizeDurableRun = async (
+    terminalState: HostedLifecycleTerminalState,
+    status: HostedLifecycleTerminalState["status"],
+  ): Promise<void> => {
+    if (!options.run || durableRunFinalized) {
+      return;
+    }
+
+    durableRunFinalized = true;
+    const modelId = terminalState.metadata?.modelId ?? options.fallbackModelId;
+
+    await finalizeConversationAgentRun({
+      authToken: options.authToken,
+      apiUrl: options.apiUrl,
+      conversationId: options.run.conversationId,
+      runId: options.run.runId,
+      status,
+      model: modelId,
+      provider: options.resolveProvider(modelId),
+      usage: buildConversationAgentRunUsage(terminalState.metadata?.usage),
+      terminalErrorCode: terminalState.terminalErrorCode,
+      terminalErrorMessage: terminalState.terminalErrorMessage,
+    });
+  };
+
+  return {
+    toTerminalState: (state) =>
+      toConversationHostedTerminalState({
+        fallbackModelId: options.fallbackModelId,
+        state,
+      }),
+    finalizeRun: (terminalState) => finalizeDurableRun(terminalState, terminalState.status),
+    cancelRun: (terminalState) => finalizeDurableRun(terminalState, "cancelled"),
+    onTerminalState: async (terminalState) => {
+      await options.onTerminalState?.(terminalState);
+    },
+    dispatch: async (state) => {
+      const terminalState = toConversationHostedTerminalState({
+        fallbackModelId: options.fallbackModelId,
+        state,
+      });
+
+      if (terminalState.status === "cancelled") {
+        await finalizeDurableRun(terminalState, "cancelled");
+      } else {
+        await finalizeDurableRun(terminalState, terminalState.status);
+      }
+      await options.onTerminalState?.(terminalState);
+      return terminalState;
+    },
+  };
+}

package/src/src/agent/conversation-root-run-lifecycle.ts

@@ -0,0 +1,41 @@
+import {
+  type ConversationRootRunContext,
+  createConversationRootRunContext,
+} from "./conversation-root-run-context.js";
+import type { ConversationRunProjection } from "./durable.js";
+
+export interface ConversationRootRunLifecycle<TMirror> extends ConversationRootRunContext {
+  mirror: TMirror | null;
+}
+
+export interface PrepareConversationRootRunLifecycleOptions<TMirror> {
+  startRun: (
+    input: { abortSignal: AbortSignal },
+  ) => Promise<{ run: ConversationRunProjection | null }> | {
+    run: ConversationRunProjection | null;
+  };
+  parentRunId?: string;
+  parentMessageId?: string;
+  appendParentRunEvents?: ((events: unknown[]) => Promise<void> | void) | undefined;
+  createMirror?: (
+    run: ConversationRunProjection,
+  ) => Promise<TMirror> | TMirror;
+}
+
+export async function prepareConversationRootRunLifecycle<TMirror>(
+  input: PrepareConversationRootRunLifecycleOptions<TMirror>,
+  options: { abortSignal: AbortSignal },
+): Promise<ConversationRootRunLifecycle<TMirror>> {
+  const { run } = await input.startRun({ abortSignal: options.abortSignal });
+  const context = createConversationRootRunContext({
+    run,
+    parentRunId: input.parentRunId,
+    parentMessageId: input.parentMessageId,
+    appendParentRunEvents: input.appendParentRunEvents,
+  });
+
+  return {
+    ...context,
+    mirror: run && input.createMirror ? await input.createMirror(run) : null,
+  };
+}

package/src/src/agent/index.ts

@@ -192,6 +192,11 @@ export {
   prepareConversationRootRunContext,
   startConversationRootRun,
 } from "./conversation-root-run-context.js";
+export {
+  type ConversationRootRunLifecycle,
+  prepareConversationRootRunLifecycle,
+  type PrepareConversationRootRunLifecycleOptions,
+} from "./conversation-root-run-lifecycle.js";
 export {
   bootstrapConversationAgentRun,
   type BootstrapConversationAgentRunResult,
@@ -212,6 +217,13 @@ export {
   type CreateConversationHostedLifecycleAdapterOptions,
   createConversationHostedStreamLifecycleAdapter,
 } from "./conversation-hosted-lifecycle.js";
+export {
+  type ConversationHostedTerminalAdapter,
+  type ConversationHostedTerminalStateInput,
+  createConversationHostedTerminalAdapter,
+  type CreateConversationHostedTerminalAdapterOptions,
+  toConversationHostedTerminalState,
+} from "./conversation-hosted-terminal.js";
 export {
   getConversationRunEventJsonByteLength,
   normalizeConversationRunEvent,

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.255";
+export const VERSION = "0.1.257";