veryfront 0.1.257 → 0.1.258

package/esm/deno.js

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

package/esm/src/agent/hosted-stream-finalization.d.ts

@@ -0,0 +1,61 @@
+import type { HostedLifecycleTerminalState } from "./hosted-lifecycle.js";
+export interface HostedTerminalError {
+    code: string;
+    message: string;
+}
+export interface HostedResponseFinalizationState<TMessage, TChunk> {
+    persistedMessage: TMessage;
+    finalizedMessage: TMessage;
+    fallbackChunks: readonly TChunk[];
+    hasIncompleteToolParts: boolean;
+    metadata?: HostedLifecycleTerminalState["metadata"];
+}
+export interface HostedDetachedFinalizationState<TChunk> {
+    hasContent: boolean;
+    fallbackChunks: readonly TChunk[];
+    hasIncompleteToolParts: boolean;
+}
+export interface FinalizeHostedResponseOptions<TMessage, TChunk> {
+    isAborted: boolean;
+    getFinalStep: () => Promise<unknown>;
+    buildState: (finalStep: unknown) => Promise<HostedResponseFinalizationState<TMessage, TChunk>> | HostedResponseFinalizationState<TMessage, TChunk>;
+    shouldFailEmptyMessage: (input: {
+        isAborted: boolean;
+        message: TMessage;
+    }) => boolean;
+    resolveEmptyTerminalError: (input: {
+        finalStep: unknown;
+        streamError?: unknown | null;
+    }) => HostedTerminalError | Promise<HostedTerminalError>;
+    appendFallbackChunk: (chunk: TChunk) => Promise<void> | void;
+    flushMirror: () => Promise<void> | void;
+    dispatchTerminalState: (state: HostedLifecycleTerminalState) => Promise<void> | void;
+    resolveTerminalState: (input: {
+        isAborted: boolean;
+        hasIncompleteToolParts: boolean;
+    }) => HostedLifecycleTerminalState;
+    cleanup: () => Promise<void> | void;
+    streamError?: unknown | null;
+}
+export interface FinalizeHostedDetachedOptions<TChunk> {
+    isAborted: boolean;
+    mirroredDurableOutput: boolean;
+    getFinalStep: () => Promise<unknown>;
+    buildState: (finalStep: unknown) => Promise<HostedDetachedFinalizationState<TChunk>> | HostedDetachedFinalizationState<TChunk>;
+    resolveEmptyTerminalError: (input: {
+        finalStep: unknown;
+        streamError?: unknown | null;
+    }) => HostedTerminalError | Promise<HostedTerminalError>;
+    appendFallbackChunk: (chunk: TChunk) => Promise<void> | void;
+    flushMirror: () => Promise<void> | void;
+    dispatchTerminalState: (state: HostedLifecycleTerminalState) => Promise<void> | void;
+    resolveTerminalState: (input: {
+        isAborted: boolean;
+        hasIncompleteToolParts: boolean;
+    }) => HostedLifecycleTerminalState;
+    cleanup: () => Promise<void> | void;
+    streamError?: unknown | null;
+}
+export declare function finalizeHostedResponse<TMessage, TChunk>(options: FinalizeHostedResponseOptions<TMessage, TChunk>): Promise<void>;
+export declare function finalizeHostedDetached<TChunk>(options: FinalizeHostedDetachedOptions<TChunk>): Promise<void>;
+//# sourceMappingURL=hosted-stream-finalization.d.ts.map

package/esm/src/agent/hosted-stream-finalization.d.ts.map

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

package/esm/src/agent/hosted-stream-finalization.js

@@ -0,0 +1,66 @@
+async function appendFallbackChunks(chunks, appendFallbackChunk) {
+    for (const chunk of chunks) {
+        await appendFallbackChunk(chunk);
+    }
+}
+async function cleanupAfterFinalization(cleanup) {
+    await cleanup();
+}
+export async function finalizeHostedResponse(options) {
+    const finalStep = await options.getFinalStep();
+    const state = await options.buildState(finalStep);
+    if (options.shouldFailEmptyMessage({
+        isAborted: options.isAborted,
+        message: state.finalizedMessage,
+    })) {
+        const terminalError = await options.resolveEmptyTerminalError({
+            finalStep,
+            streamError: options.streamError,
+        });
+        await options.flushMirror();
+        await options.dispatchTerminalState({
+            status: "failed",
+            metadata: state.metadata,
+            terminalErrorCode: terminalError.code,
+            terminalErrorMessage: terminalError.message,
+        });
+        await cleanupAfterFinalization(options.cleanup);
+        return;
+    }
+    await appendFallbackChunks(state.fallbackChunks, options.appendFallbackChunk);
+    await options.flushMirror();
+    const terminalState = options.resolveTerminalState({
+        isAborted: options.isAborted,
+        hasIncompleteToolParts: state.hasIncompleteToolParts,
+    });
+    await options.dispatchTerminalState({
+        ...terminalState,
+        ...(state.metadata !== undefined ? { metadata: state.metadata } : {}),
+    });
+    await cleanupAfterFinalization(options.cleanup);
+}
+export async function finalizeHostedDetached(options) {
+    const finalStep = await options.getFinalStep();
+    const state = await options.buildState(finalStep);
+    if (!options.isAborted && !options.mirroredDurableOutput && !state.hasContent) {
+        const terminalError = await options.resolveEmptyTerminalError({
+            finalStep,
+            streamError: options.streamError,
+        });
+        await options.flushMirror();
+        await options.dispatchTerminalState({
+            status: "failed",
+            terminalErrorCode: terminalError.code,
+            terminalErrorMessage: terminalError.message,
+        });
+        await cleanupAfterFinalization(options.cleanup);
+        return;
+    }
+    await appendFallbackChunks(state.fallbackChunks, options.appendFallbackChunk);
+    await options.flushMirror();
+    await options.dispatchTerminalState(options.resolveTerminalState({
+        isAborted: options.isAborted,
+        hasIncompleteToolParts: state.hasIncompleteToolParts,
+    }));
+    await cleanupAfterFinalization(options.cleanup);
+}

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

@@ -100,6 +100,7 @@ export { type ConversationRunEvent, ConversationRunEventEncoder, ConversationRun
 export { prepareConversationRunExternalEvents, prepareConversationRunStreamEvents, } from "./conversation-run-event-preparation.js";
 export { type ConversationRunMirror, type ConversationRunMirrorRetryScheduledState, type ConversationRunMirrorSnapshot, type ConversationRunMirrorStoppedState, createConversationRunMirror, } from "./conversation-run-mirror.js";
 export { type ConversationRunStreamMirror, createConversationRunStreamMirror, } from "./conversation-run-stream-mirror.js";
+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";

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

@@ -99,6 +99,7 @@ export { ConversationRunEventEncoder, ConversationRunEventSchema, conversationRu
 export { prepareConversationRunExternalEvents, prepareConversationRunStreamEvents, } from "./conversation-run-event-preparation.js";
 export { createConversationRunMirror, } from "./conversation-run-mirror.js";
 export { createConversationRunStreamMirror, } from "./conversation-run-stream-mirror.js";
+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";

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

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

package/package.json

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

package/src/src/agent/hosted-stream-finalization.ts

@@ -0,0 +1,151 @@
+import type { HostedLifecycleTerminalState } from "./hosted-lifecycle.js";
+
+export interface HostedTerminalError {
+  code: string;
+  message: string;
+}
+
+export interface HostedResponseFinalizationState<TMessage, TChunk> {
+  persistedMessage: TMessage;
+  finalizedMessage: TMessage;
+  fallbackChunks: readonly TChunk[];
+  hasIncompleteToolParts: boolean;
+  metadata?: HostedLifecycleTerminalState["metadata"];
+}
+
+export interface HostedDetachedFinalizationState<TChunk> {
+  hasContent: boolean;
+  fallbackChunks: readonly TChunk[];
+  hasIncompleteToolParts: boolean;
+}
+
+export interface FinalizeHostedResponseOptions<TMessage, TChunk> {
+  isAborted: boolean;
+  getFinalStep: () => Promise<unknown>;
+  buildState: (finalStep: unknown) =>
+    | Promise<HostedResponseFinalizationState<TMessage, TChunk>>
+    | HostedResponseFinalizationState<TMessage, TChunk>;
+  shouldFailEmptyMessage: (input: { isAborted: boolean; message: TMessage }) => boolean;
+  resolveEmptyTerminalError: (input: {
+    finalStep: unknown;
+    streamError?: unknown | null;
+  }) => HostedTerminalError | Promise<HostedTerminalError>;
+  appendFallbackChunk: (chunk: TChunk) => Promise<void> | void;
+  flushMirror: () => Promise<void> | void;
+  dispatchTerminalState: (state: HostedLifecycleTerminalState) => Promise<void> | void;
+  resolveTerminalState: (input: {
+    isAborted: boolean;
+    hasIncompleteToolParts: boolean;
+  }) => HostedLifecycleTerminalState;
+  cleanup: () => Promise<void> | void;
+  streamError?: unknown | null;
+}
+
+export interface FinalizeHostedDetachedOptions<TChunk> {
+  isAborted: boolean;
+  mirroredDurableOutput: boolean;
+  getFinalStep: () => Promise<unknown>;
+  buildState: (finalStep: unknown) =>
+    | Promise<HostedDetachedFinalizationState<TChunk>>
+    | HostedDetachedFinalizationState<TChunk>;
+  resolveEmptyTerminalError: (input: {
+    finalStep: unknown;
+    streamError?: unknown | null;
+  }) => HostedTerminalError | Promise<HostedTerminalError>;
+  appendFallbackChunk: (chunk: TChunk) => Promise<void> | void;
+  flushMirror: () => Promise<void> | void;
+  dispatchTerminalState: (state: HostedLifecycleTerminalState) => Promise<void> | void;
+  resolveTerminalState: (input: {
+    isAborted: boolean;
+    hasIncompleteToolParts: boolean;
+  }) => HostedLifecycleTerminalState;
+  cleanup: () => Promise<void> | void;
+  streamError?: unknown | null;
+}
+
+async function appendFallbackChunks<TChunk>(
+  chunks: readonly TChunk[],
+  appendFallbackChunk: (chunk: TChunk) => Promise<void> | void,
+): Promise<void> {
+  for (const chunk of chunks) {
+    await appendFallbackChunk(chunk);
+  }
+}
+
+async function cleanupAfterFinalization(cleanup: () => Promise<void> | void): Promise<void> {
+  await cleanup();
+}
+
+export async function finalizeHostedResponse<TMessage, TChunk>(
+  options: FinalizeHostedResponseOptions<TMessage, TChunk>,
+): Promise<void> {
+  const finalStep = await options.getFinalStep();
+  const state = await options.buildState(finalStep);
+
+  if (
+    options.shouldFailEmptyMessage({
+      isAborted: options.isAborted,
+      message: state.finalizedMessage,
+    })
+  ) {
+    const terminalError = await options.resolveEmptyTerminalError({
+      finalStep,
+      streamError: options.streamError,
+    });
+
+    await options.flushMirror();
+    await options.dispatchTerminalState({
+      status: "failed",
+      metadata: state.metadata,
+      terminalErrorCode: terminalError.code,
+      terminalErrorMessage: terminalError.message,
+    });
+    await cleanupAfterFinalization(options.cleanup);
+    return;
+  }
+
+  await appendFallbackChunks(state.fallbackChunks, options.appendFallbackChunk);
+  await options.flushMirror();
+  const terminalState = options.resolveTerminalState({
+    isAborted: options.isAborted,
+    hasIncompleteToolParts: state.hasIncompleteToolParts,
+  });
+  await options.dispatchTerminalState({
+    ...terminalState,
+    ...(state.metadata !== undefined ? { metadata: state.metadata } : {}),
+  });
+  await cleanupAfterFinalization(options.cleanup);
+}
+
+export async function finalizeHostedDetached<TChunk>(
+  options: FinalizeHostedDetachedOptions<TChunk>,
+): Promise<void> {
+  const finalStep = await options.getFinalStep();
+  const state = await options.buildState(finalStep);
+
+  if (!options.isAborted && !options.mirroredDurableOutput && !state.hasContent) {
+    const terminalError = await options.resolveEmptyTerminalError({
+      finalStep,
+      streamError: options.streamError,
+    });
+
+    await options.flushMirror();
+    await options.dispatchTerminalState({
+      status: "failed",
+      terminalErrorCode: terminalError.code,
+      terminalErrorMessage: terminalError.message,
+    });
+    await cleanupAfterFinalization(options.cleanup);
+    return;
+  }
+
+  await appendFallbackChunks(state.fallbackChunks, options.appendFallbackChunk);
+  await options.flushMirror();
+  await options.dispatchTerminalState(
+    options.resolveTerminalState({
+      isAborted: options.isAborted,
+      hasIncompleteToolParts: state.hasIncompleteToolParts,
+    }),
+  );
+  await cleanupAfterFinalization(options.cleanup);
+}

package/src/src/agent/index.ts

@@ -252,6 +252,15 @@ export {
   type ConversationRunStreamMirror,
   createConversationRunStreamMirror,
 } from "./conversation-run-stream-mirror.js";
+export {
+  finalizeHostedDetached,
+  type FinalizeHostedDetachedOptions,
+  finalizeHostedResponse,
+  type FinalizeHostedResponseOptions,
+  type HostedDetachedFinalizationState,
+  type HostedResponseFinalizationState,
+  type HostedTerminalError,
+} from "./hosted-stream-finalization.js";
 export {
   type ActiveConversationRunStatus,
   appendConversationRunEvents,

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