veryfront 0.1.1239 → 0.1.1240

package/esm/src/agent/ag-ui/runtime-event-encoder.js

@@ -1,7 +1,7 @@
-import { createAgUiBrowserEncoderState, finalizeAgUiBrowserEvents, mapRuntimeStreamEventToAgUiBrowserEvents, } from "./browser-encoder.js";
+import { createAgUiEncoderState, finalizeAgUiEvents, mapRuntimeStreamEventToAgUiEvents, } from "./encoder.js";
 /** Create AG-UI runtime event encoder. */
 export function createAgUiRuntimeEventEncoder(options = {}) {
-    const state = createAgUiBrowserEncoderState(options.timing ?? {});
+    const state = createAgUiEncoderState(options.timing ?? {});
     const toolInputs = new Map();
     Object.assign(state.metadata, options.initialMetadata ?? {});
     return {
@@ -11,7 +11,7 @@ export function createAgUiRuntimeEventEncoder(options = {}) {
                 typeof event.toolCallId === "string") {
                 toolInputs.set(event.toolCallId, event.input);
             }
-            const encodedEvents = mapRuntimeStreamEventToAgUiBrowserEvents(state, event).map((next) => {
+            const encodedEvents = mapRuntimeStreamEventToAgUiEvents(state, event).map((next) => {
                 if (next.event !== "ToolCallResult" ||
                     typeof next.payload.toolCallId !== "string" ||
                     !toolInputs.has(next.payload.toolCallId)) {
@@ -33,6 +33,6 @@ export function createAgUiRuntimeEventEncoder(options = {}) {
             }
             return encodedEvents;
         },
-        finalize: (response) => finalizeAgUiBrowserEvents(state, response),
+        finalize: (response) => finalizeAgUiEvents(state, response),
     };
 }

package/esm/src/agent/ag-ui/runtime-response.d.ts

@@ -0,0 +1,20 @@
+import { type AgUiResponseEncoder, type AgUiResponseExecution } from "./response-stream.js";
+import { type AgUiRuntimeRequest } from "../runtime/ag-ui-contract.js";
+import type { AgentResponse } from "../types.js";
+/** Input payload for create AG-UI runtime response. */
+export interface CreateAgUiRuntimeResponseInput<TChunk, TState> {
+    agUiInput: AgUiRuntimeRequest;
+    defaults?: {
+        threadId?: string;
+        runId?: string;
+    };
+    agentId: string;
+    execution: AgUiResponseExecution<TChunk>;
+    encoder: AgUiResponseEncoder<TChunk>;
+    initialState: TState;
+    onChunk?: (state: TState, chunk: TChunk) => void;
+    getFinalResponse?: (state: TState) => AgentResponse | null;
+}
+/** Response payload for create AG-UI runtime response. */
+export declare function createAgUiRuntimeResponse<TChunk, TState>(input: CreateAgUiRuntimeResponseInput<TChunk, TState>): Response;
+//# sourceMappingURL=runtime-response.d.ts.map

package/esm/src/agent/ag-ui/runtime-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-response.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/ag-ui/runtime-response.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAE3B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,KAAK,kBAAkB,EAExB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,uDAAuD;AACvD,MAAM,WAAW,8BAA8B,CAAC,MAAM,EAAE,MAAM;IAC5D,SAAS,EAAE,kBAAkB,CAAC;IAC9B,QAAQ,CAAC,EAAE;QACT,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,qBAAqB,CAAC,MAAM,CAAC,CAAC;IACzC,OAAO,EAAE,mBAAmB,CAAC,MAAM,CAAC,CAAC;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACjD,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,aAAa,GAAG,IAAI,CAAC;CAC5D;AAED,0DAA0D;AAC1D,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,EACtD,KAAK,EAAE,8BAA8B,CAAC,MAAM,EAAE,MAAM,CAAC,GACpD,QAAQ,CAYV"}

package/esm/src/agent/ag-ui/runtime-response.js

@@ -0,0 +1,16 @@
+import { createAgUiResponseStream, } from "./response-stream.js";
+import { createAgUiSseResponse } from "./host-support.js";
+import { normalizeAgUiRuntimeRequest, } from "../runtime/ag-ui-contract.js";
+/** Response payload for create AG-UI runtime response. */
+export function createAgUiRuntimeResponse(input) {
+    const stream = createAgUiResponseStream({
+        agUiInput: normalizeAgUiRuntimeRequest(input.agUiInput, input.defaults),
+        agentId: input.agentId,
+        execution: input.execution,
+        encoder: input.encoder,
+        initialState: input.initialState,
+        ...(input.onChunk ? { onChunk: input.onChunk } : {}),
+        ...(input.getFinalResponse ? { getFinalResponse: input.getFinalResponse } : {}),
+    });
+    return createAgUiSseResponse(stream);
+}

package/esm/src/agent/ag-ui/sse-parser.d.ts

@@ -1,4 +1,4 @@
-/** AG-UI runtime event type constants normalized from browser-wire SSE events. */
+/** AG-UI runtime event type constants normalized from legacy SSE event names. */
 export declare const agUiSseEventTypes: {
     readonly custom: "CUSTOM";
     readonly textMessageStart: "TEXT_MESSAGE_START";

package/esm/src/agent/ag-ui/sse-parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sse-parser.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/ag-ui/sse-parser.ts"],"names":[],"mappings":"AAGA,kFAAkF;AAClF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;CAmBpB,CAAC;AAEX,iDAAiD;AACjD,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,OAAO,iBAAiB,CAAC,CAAC;AAE1F,6EAA6E;AAC7E,MAAM,WAAW,gBAAgB;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACvC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,qEAAqE;AACrE,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,4CAA4C;AAC5C,MAAM,WAAW,2BAA2B;IAC1C,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,uBAAuB,KAAK,IAAI,CAAC;IACzD,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,sEAAsE;AACtE,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAE5D;AAED,kEAAkE;AAClE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGjG;AAED,+DAA+D;AAC/D,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACtC,SAAS,EAAE,MAAM,GAChB,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAEhC;AAED,0EAA0E;AAC1E,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,CAEvE;AAoLD,yGAAyG;AACzG,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,QAAQ,EAClB,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAAC,gBAAgB,CAAC,CAoD3B"}
+{"version":3,"file":"sse-parser.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/ag-ui/sse-parser.ts"],"names":[],"mappings":"AAGA,iFAAiF;AACjF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;CAmBpB,CAAC;AAEX,iDAAiD;AACjD,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,OAAO,iBAAiB,CAAC,CAAC;AAE1F,6EAA6E;AAC7E,MAAM,WAAW,gBAAgB;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACvC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,qEAAqE;AACrE,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,4CAA4C;AAC5C,MAAM,WAAW,2BAA2B;IAC1C,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,uBAAuB,KAAK,IAAI,CAAC;IACzD,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,sEAAsE;AACtE,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAE5D;AAED,kEAAkE;AAClE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGjG;AAED,+DAA+D;AAC/D,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACtC,SAAS,EAAE,MAAM,GAChB,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAEhC;AAED,0EAA0E;AAC1E,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,CAEvE;AAoLD,yGAAyG;AACzG,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,QAAQ,EAClB,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAAC,gBAAgB,CAAC,CAoD3B"}

package/esm/src/agent/ag-ui/sse-parser.js

@@ -1,6 +1,6 @@
 import { isRecord } from "../../chat/conversation.js";
 import { safeJsonParse } from "../../chat/provider-errors.js";
-/** AG-UI runtime event type constants normalized from browser-wire SSE events. */
+/** AG-UI runtime event type constants normalized from legacy SSE event names. */
 export const agUiSseEventTypes = {
     custom: "CUSTOM",
     textMessageStart: "TEXT_MESSAGE_START",
@@ -98,7 +98,7 @@ function applyParsedEvent(run, event) {
         }
     }
 }
-function coerceBrowserWireEvent(eventName, payload) {
+function coerceWireEvent(eventName, payload) {
     switch (eventName) {
         case "RunStarted":
             return { type: agUiSseEventTypes.runStarted, ...payload };
@@ -151,7 +151,7 @@ function normalizeParsedEvent(payload, eventName) {
     if (!eventName) {
         return null;
     }
-    return coerceBrowserWireEvent(eventName, payload);
+    return coerceWireEvent(eventName, payload);
 }
 function consumeSseBuffer(run, buffer, options, state) {
     let nextBuffer = buffer;

package/esm/src/agent/ag-ui/tracked-response.d.ts

@@ -0,0 +1,11 @@
+import type { AgUiFinalizeTracker } from "./finalize-tracker.js";
+import type { AgUiChunkEncoderBridge } from "./chunk-encoder-bridge.js";
+import { type CreateAgUiRuntimeResponseInput } from "./runtime-response.js";
+/** Input payload for create AG-UI tracked response. */
+export interface CreateAgUiTrackedResponseInput<TChunk> extends Omit<CreateAgUiRuntimeResponseInput<TChunk, null>, "encoder" | "initialState" | "onChunk" | "getFinalResponse"> {
+    chunkEncoder: Pick<AgUiChunkEncoderBridge<TChunk>, "encode" | "finalize"> & Partial<Pick<AgUiChunkEncoderBridge<TChunk>, "timingState">>;
+    finalizeTracker: Pick<AgUiFinalizeTracker<TChunk>, "observeChunk" | "observeEncodedEvents" | "getFinalResponse">;
+}
+/** Response payload for create AG-UI tracked response. */
+export declare function createAgUiTrackedResponse<TChunk>(input: CreateAgUiTrackedResponseInput<TChunk>): Response;
+//# sourceMappingURL=tracked-response.d.ts.map

package/esm/src/agent/ag-ui/tracked-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracked-response.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/ag-ui/tracked-response.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,EAEL,KAAK,8BAA8B,EACpC,MAAM,uBAAuB,CAAC;AAG/B,uDAAuD;AACvD,MAAM,WAAW,8BAA8B,CAAC,MAAM,CAAE,SACtD,IAAI,CACF,8BAA8B,CAAC,MAAM,EAAE,IAAI,CAAC,EAC5C,SAAS,GAAG,cAAc,GAAG,SAAS,GAAG,kBAAkB,CAC5D;IACD,YAAY,EACR,IAAI,CAAC,sBAAsB,CAAC,MAAM,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC,GAC3D,OAAO,CAAC,IAAI,CAAC,sBAAsB,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC;IACjE,eAAe,EAAE,IAAI,CACnB,mBAAmB,CAAC,MAAM,CAAC,EAC3B,cAAc,GAAG,sBAAsB,GAAG,kBAAkB,CAC7D,CAAC;CACH;AAED,0DAA0D;AAC1D,wBAAgB,yBAAyB,CAAC,MAAM,EAC9C,KAAK,EAAE,8BAA8B,CAAC,MAAM,CAAC,GAC5C,QAAQ,CAqBV"}

package/esm/src/agent/ag-ui/{tracked-browser-response.js → tracked-response.js}

@@ -1,9 +1,11 @@
-import { createAgUiRuntimeBrowserResponse, } from "./runtime-browser-response.js";
-/** Response payload for create AG-UI tracked browser. */
-export function createAgUiTrackedBrowserResponse(input) {
-    return createAgUiRuntimeBrowserResponse({
+import { createAgUiRuntimeResponse, } from "./runtime-response.js";
+/** Response payload for create AG-UI tracked response. */
+export function createAgUiTrackedResponse(input) {
+    const timingState = input.chunkEncoder.timingState;
+    return createAgUiRuntimeResponse({
         ...input,
         encoder: {
+            ...(timingState === undefined ? {} : { timingState }),
             encode: (chunk) => {
                 const events = input.chunkEncoder.encode(chunk);
                 input.finalizeTracker.observeEncodedEvents(events);

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

@@ -1 +1 @@
-{"version":3,"file":"hosted-lifecycle.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/conversation/hosted-lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,yBAAyB,EAC9B,KAAK,yBAAyB,EAE/B,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,EACL,KAAK,gCAAgC,EACrC,KAAK,gCAAgC,EAEtC,MAAM,yCAAyC,CAAC;AACjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EACV,2BAA2B,EAE5B,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,sBAAsB,EAAE,4BAA4B,EAAE,MAAM,wBAAwB,CAAC;AAGnG,gEAAgE;AAChE,MAAM,WAAW,wCAAwC;IACvD,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,yBAAyB,CAAC;IAClC,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;AAED,wEAAwE;AACxE,MAAM,WAAW,+CAA+C,CAAC,MAAM;IACrE,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,CACR,KAAK,EAAE;QAAE,WAAW,EAAE,WAAW,CAAA;KAAE,KAChC,OAAO,CAAC,yBAAyB,CAAC,GAAG,yBAAyB,CAAC;IACpE,gBAAgB,CAAC,EAAE,CACjB,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,yBAAyB,KAC3B,OAAO,CAAC,SAAS,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC,GAAG,SAAS,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC;IAC9E,oBAAoB,EAAE,CAAC,KAAK,EAAE;QAC5B,GAAG,EAAE,yBAAyB,CAAC;QAC/B,aAAa,EAAE,4BAA4B,CAAC;KAC7C,KACG,OAAO,CAAC,wCAAwC,CAAC,GACjD,wCAAwC,CAAC;CAC9C;AAED,oDAAoD;AACpD,wBAAgB,wCAAwC,CAAC,MAAM,EAC7D,OAAO,EAAE,+CAA+C,CAAC,MAAM,CAAC,GAC/D,sBAAsB,CAAC,yBAAyB,EAAE,MAAM,CAAC,CAiF3D;AAED,2DAA2D;AAC3D,wBAAgB,8CAA8C,CAC5D,OAAO,EACH,IAAI,CACJ,+CAA+C,CAAC,eAAe,CAAC,EAChE,kBAAkB,CACnB,GACC;IACA,8EAA8E;IAC9E,OAAO,CAAC,EAAE,2BAA2B,CAAC;CACvC,GACF,sBAAsB,CAAC,yBAAyB,EAAE,eAAe,CAAC,CAapE;AAED,gDAAgD;AAChD,MAAM,WAAW,iCAAiC;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,oBAAoB,EAAE,MAAM,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,sBAAsB,CAAC,EAAE,CAAC,MAAM,EAAE,gCAAgC,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC9F,QAAQ,EAAE,IAAI,CAAC,gCAAgC,EAAE,QAAQ,CAAC,CAAC;IAC3D,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAwDD,mDAAmD;AACnD,wBAAgB,uCAAuC,CACrD,GAAG,EAAE,iCAAiC,GACrC,2BAA2B,CA+C7B"}
+{"version":3,"file":"hosted-lifecycle.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/conversation/hosted-lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,yBAAyB,EAC9B,KAAK,yBAAyB,EAE/B,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,EACL,KAAK,gCAAgC,EACrC,KAAK,gCAAgC,EAEtC,MAAM,yCAAyC,CAAC;AACjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EACV,2BAA2B,EAE5B,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,sBAAsB,EAAE,4BAA4B,EAAE,MAAM,wBAAwB,CAAC;AAInG,gEAAgE;AAChE,MAAM,WAAW,wCAAwC;IACvD,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,yBAAyB,CAAC;IAClC,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;AAED,wEAAwE;AACxE,MAAM,WAAW,+CAA+C,CAAC,MAAM;IACrE,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,CACR,KAAK,EAAE;QAAE,WAAW,EAAE,WAAW,CAAA;KAAE,KAChC,OAAO,CAAC,yBAAyB,CAAC,GAAG,yBAAyB,CAAC;IACpE,gBAAgB,CAAC,EAAE,CACjB,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,yBAAyB,KAC3B,OAAO,CAAC,SAAS,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC,GAAG,SAAS,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC;IAC9E,oBAAoB,EAAE,CAAC,KAAK,EAAE;QAC5B,GAAG,EAAE,yBAAyB,CAAC;QAC/B,aAAa,EAAE,4BAA4B,CAAC;KAC7C,KACG,OAAO,CAAC,wCAAwC,CAAC,GACjD,wCAAwC,CAAC;CAC9C;AAED,oDAAoD;AACpD,wBAAgB,wCAAwC,CAAC,MAAM,EAC7D,OAAO,EAAE,+CAA+C,CAAC,MAAM,CAAC,GAC/D,sBAAsB,CAAC,yBAAyB,EAAE,MAAM,CAAC,CAiF3D;AAED,2DAA2D;AAC3D,wBAAgB,8CAA8C,CAC5D,OAAO,EACH,IAAI,CACJ,+CAA+C,CAAC,eAAe,CAAC,EAChE,kBAAkB,CACnB,GACC;IACA,8EAA8E;IAC9E,OAAO,CAAC,EAAE,2BAA2B,CAAC;CACvC,GACF,sBAAsB,CAAC,yBAAyB,EAAE,eAAe,CAAC,CAapE;AAED,gDAAgD;AAChD,MAAM,WAAW,iCAAiC;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,oBAAoB,EAAE,MAAM,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,sBAAsB,CAAC,EAAE,CAAC,MAAM,EAAE,gCAAgC,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC9F,QAAQ,EAAE,IAAI,CAAC,gCAAgC,EAAE,QAAQ,CAAC,CAAC;IAC3D,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAwDD,mDAAmD;AACnD,wBAAgB,uCAAuC,CACrD,GAAG,EAAE,iCAAiC,GACrC,2BAA2B,CA+C7B"}

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

@@ -3,6 +3,7 @@ import { prepareConversationRunStreamEvents } from "./run-event-preparation.js";
 import { ConversationRunEventEncoder } from "./run-events.js";
 import { publishInvokeAgentChildRunProgress, } from "../child-run/invoke-agent-child-runs.js";
 import { agentLogger } from "../../utils/index.js";
+import { createAgentRunEventTimingAnchor } from "../../runtime/model-call-context.js";
 /** Create conversation hosted lifecycle adapter. */
 export function createConversationHostedLifecycleAdapter(options) {
     // Appends read run.latestEventId as the expected cursor and write it back,
@@ -87,7 +88,7 @@ export function createConversationHostedStreamLifecycleAdapter(options) {
     // creation is also the anchor `elapsedMs` is measured from, so a fresh encoder
     // would reset elapsed to zero on every event.
     const encoder = options.encoder ??
-        new ConversationRunEventEncoder({ nowMs: () => performance.now() });
+        new ConversationRunEventEncoder(createAgentRunEventTimingAnchor());
     return createConversationHostedLifecycleAdapter({
         ...options,
         mapChunkToEvents: (chunk) => prepareConversationRunStreamEvents([chunk], encoder),

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

@@ -1 +1 @@
-{"version":3,"file":"lifecycle-run-event-adapter.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/conversation/lifecycle-run-event-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAE5E,OAAO,EAAE,KAAK,oBAAoB,EAA6B,MAAM,iBAAiB,CAAC;AAEvF;;;;GAIG;AACH,qBAAa,8BAA+B,SAAQ,KAAK;gBAC3C,OAAO,EAAE,MAAM;CAI5B;AAED,iEAAiE;AACjE,MAAM,WAAW,wBAAwB;IACvC,WAAW,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC/C,KAAK,IAAI,IAAI,CAAC;IACd,OAAO,IAAI,IAAI,CAAC;CACjB;AAcD,wBAAgB,8BAA8B,CAAC,KAAK,EAAE;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,MAAM,EAAE,SAAS,oBAAoB,EAAE,GAAG,IAAI,CAAC;IACxD,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;IAC7D,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACxC,GAAG,wBAAwB,CAoU3B"}
+{"version":3,"file":"lifecycle-run-event-adapter.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/conversation/lifecycle-run-event-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAE5E,OAAO,EAAE,KAAK,oBAAoB,EAA6B,MAAM,iBAAiB,CAAC;AAEvF;;;;GAIG;AACH,qBAAa,8BAA+B,SAAQ,KAAK;gBAC3C,OAAO,EAAE,MAAM;CAI5B;AAED,iEAAiE;AACjE,MAAM,WAAW,wBAAwB;IACvC,WAAW,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC/C,KAAK,IAAI,IAAI,CAAC;IACd,OAAO,IAAI,IAAI,CAAC;CACjB;AAcD,wBAAgB,8BAA8B,CAAC,KAAK,EAAE;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,MAAM,EAAE,SAAS,oBAAoB,EAAE,GAAG,IAAI,CAAC;IACxD,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;IAC7D,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACxC,GAAG,wBAAwB,CA+T3B"}

package/esm/src/agent/conversation/lifecycle-run-event-adapter.js

@@ -237,6 +237,8 @@ export function createLifecycleRunEventAdapter(input) {
             case "provider_tool_start":
                 return;
             case "provider_tool_result": {
+                if (event.preliminary === true)
+                    return;
                 const storedInput = toolInputs.get(event.toolCallId);
                 emit({
                     type: conversationRunEventTypes.toolCallResult,

package/esm/src/agent/conversation/private-run-event.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"private-run-event.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/conversation/private-run-event.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwC,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAO7F,oFAAoF;AACpF,wBAAgB,kCAAkC,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAGlF;AAED,iFAAiF;AACjF,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CASrE;AAED,+EAA+E;AAC/E,qBAAa,+BAAgC,SAAQ,cAAc;IACxD,IAAI,SAAqC;gBAEtC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO;CAY9D"}
+{"version":3,"file":"private-run-event.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/conversation/private-run-event.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwC,cAAc,EAAE,MAAM,uBAAuB,CAAC;AA6J7F,oFAAoF;AACpF,wBAAgB,kCAAkC,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAGlF;AAED,iFAAiF;AACjF,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CA6BrE;AAED,+EAA+E;AAC/E,qBAAa,+BAAgC,SAAQ,cAAc;IACxD,IAAI,SAAqC;gBAEtC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO;CAY9D"}

package/esm/src/agent/conversation/private-run-event.js

@@ -3,6 +3,154 @@ function ownDataValue(record, key) {
     const descriptor = Object.getOwnPropertyDescriptor(record, key);
     return descriptor && "value" in descriptor ? descriptor.value : undefined;
 }
+function isRecord(value) {
+    return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function hasOnlyKeys(value, keys) {
+    return Object.keys(value).every((key) => keys.includes(key));
+}
+function isFiniteNumber(value) {
+    return typeof value === "number" && Number.isFinite(value);
+}
+function isModel(value) {
+    return isRecord(value) && hasOnlyKeys(value, ["id", "modelProvider"]) &&
+        typeof ownDataValue(value, "id") === "string" && ownDataValue(value, "id") !== "" &&
+        (ownDataValue(value, "modelProvider") === undefined ||
+            (typeof ownDataValue(value, "modelProvider") === "string" &&
+                ownDataValue(value, "modelProvider") !== ""));
+}
+function isRequest(value) {
+    if (!isRecord(value) || !hasOnlyKeys(value, [
+        "maxOutputTokens",
+        "temperature",
+        "topP",
+        "topK",
+        "stopSequences",
+        "seed",
+        "presencePenalty",
+        "frequencyPenalty",
+        "reasoning",
+    ]))
+        return false;
+    for (const key of [
+        "maxOutputTokens",
+        "temperature",
+        "topP",
+        "topK",
+        "seed",
+        "presencePenalty",
+        "frequencyPenalty",
+    ]) {
+        const field = ownDataValue(value, key);
+        if (field !== undefined && !isFiniteNumber(field))
+            return false;
+    }
+    const maxOutputTokens = ownDataValue(value, "maxOutputTokens");
+    if (typeof maxOutputTokens === "number" && maxOutputTokens < 0)
+        return false;
+    const stops = ownDataValue(value, "stopSequences");
+    if (stops !== undefined && (!Array.isArray(stops) || stops.some((item) => typeof item !== "string"))) {
+        return false;
+    }
+    const reasoning = ownDataValue(value, "reasoning");
+    if (reasoning === undefined)
+        return true;
+    if (!isRecord(reasoning) || !hasOnlyKeys(reasoning, ["enabled", "effort", "budgetTokens"])) {
+        return false;
+    }
+    const enabled = ownDataValue(reasoning, "enabled");
+    const effort = ownDataValue(reasoning, "effort");
+    const budget = ownDataValue(reasoning, "budgetTokens");
+    return (enabled === undefined || typeof enabled === "boolean") &&
+        (effort === undefined ||
+            (typeof effort === "string" && ["low", "medium", "high", "max"].includes(effort))) &&
+        (budget === undefined || (Number.isInteger(budget) && budget >= 0));
+}
+function isMessage(value) {
+    if (!isRecord(value) || typeof ownDataValue(value, "role") !== "string")
+        return false;
+    const role = ownDataValue(value, "role");
+    const content = ownDataValue(value, "content");
+    if (role === "system") {
+        return typeof content === "string" &&
+            hasOnlyKeys(value, ["role", "content", "providerOptions"]) &&
+            isPersistedProviderOptions(ownDataValue(value, "providerOptions"));
+    }
+    if (!Array.isArray(content) || !hasOnlyKeys(value, ["role", "content"]))
+        return false;
+    return content.every((part) => {
+        if (!isRecord(part))
+            return false;
+        if (role === "user") {
+            return ownDataValue(part, "type") === "text"
+                ? hasOnlyKeys(part, ["type", "text"]) && typeof ownDataValue(part, "text") === "string"
+                : ["image", "file"].includes(String(ownDataValue(part, "type"))) &&
+                    hasOnlyKeys(part, ["type", "mediaType", "url", "filename"]) &&
+                    typeof ownDataValue(part, "mediaType") === "string" &&
+                    typeof ownDataValue(part, "url") === "string" &&
+                    (ownDataValue(part, "filename") === undefined ||
+                        typeof ownDataValue(part, "filename") === "string");
+        }
+        if (role === "assistant") {
+            if (ownDataValue(part, "type") === "text") {
+                return hasOnlyKeys(part, ["type", "text"]) &&
+                    typeof ownDataValue(part, "text") === "string";
+            }
+            return ownDataValue(part, "type") === "tool-call" &&
+                hasOnlyKeys(part, ["type", "toolCallId", "toolName", "input", "providerExecuted"]) &&
+                typeof ownDataValue(part, "toolCallId") === "string" &&
+                typeof ownDataValue(part, "toolName") === "string" &&
+                ownDataValue(part, "input") !== undefined &&
+                (ownDataValue(part, "providerExecuted") === undefined ||
+                    typeof ownDataValue(part, "providerExecuted") === "boolean");
+        }
+        if (role === "tool") {
+            const output = ownDataValue(part, "output");
+            return ownDataValue(part, "type") === "tool-result" &&
+                hasOnlyKeys(part, ["type", "toolCallId", "toolName", "output"]) &&
+                typeof ownDataValue(part, "toolCallId") === "string" &&
+                typeof ownDataValue(part, "toolName") === "string" && isRecord(output) &&
+                hasOnlyKeys(output, ["type", "value"]) && ownDataValue(output, "type") === "json" &&
+                ownDataValue(output, "value") !== undefined;
+        }
+        return false;
+    });
+}
+function isPersistedProviderOptions(value) {
+    if (value === undefined)
+        return true;
+    if (!isRecord(value))
+        return false;
+    return Object.keys(value).every((key) => {
+        if (key === "")
+            return false;
+        const bucket = ownDataValue(value, key);
+        if (!isRecord(bucket) || !hasOnlyKeys(bucket, ["cacheControl"]))
+            return false;
+        const cacheControl = ownDataValue(bucket, "cacheControl");
+        return isRecord(cacheControl) && hasOnlyKeys(cacheControl, ["type", "ttl"]) &&
+            ownDataValue(cacheControl, "type") === "ephemeral" &&
+            (ownDataValue(cacheControl, "ttl") === undefined ||
+                ownDataValue(cacheControl, "ttl") === "5m" || ownDataValue(cacheControl, "ttl") === "1h");
+    });
+}
+function isTool(value) {
+    if (!isRecord(value))
+        return false;
+    if (ownDataValue(value, "type") === "function") {
+        return hasOnlyKeys(value, ["type", "name", "description", "inputSchema"]) &&
+            typeof ownDataValue(value, "name") === "string" &&
+            ownDataValue(value, "inputSchema") !== undefined &&
+            (ownDataValue(value, "description") === undefined ||
+                typeof ownDataValue(value, "description") === "string");
+    }
+    return ownDataValue(value, "type") === "provider" &&
+        hasOnlyKeys(value, ["type", "name", "id", "args"]) &&
+        typeof ownDataValue(value, "name") === "string" &&
+        typeof ownDataValue(value, "id") === "string" &&
+        String(ownDataValue(value, "id")).includes(".") &&
+        isRecord(ownDataValue(value, "args"));
+}
 /** Return whether an event declares the private durable run-event discriminator. */
 export function hasPrivateConversationRunEventType(value) {
     return !!value && typeof value === "object" && !Array.isArray(value) &&
@@ -12,13 +160,36 @@ export function hasPrivateConversationRunEventType(value) {
 export function isPrivateConversationRunEvent(value) {
     if (!hasPrivateConversationRunEventType(value))
         return false;
-    if (!Array.isArray(ownDataValue(value, "messages")))
+    const messages = ownDataValue(value, "messages");
+    if (!Array.isArray(messages) || !messages.every(isMessage))
         return false;
     const toolsDescriptor = Object.getOwnPropertyDescriptor(value, "tools");
     if (toolsDescriptor !== undefined &&
-        (!("value" in toolsDescriptor) || !Array.isArray(toolsDescriptor.value)))
+        (!("value" in toolsDescriptor) || !Array.isArray(toolsDescriptor.value) ||
+            !toolsDescriptor.value.every(isTool)))
+        return false;
+    const model = ownDataValue(value, "model");
+    if (model !== undefined && !isModel(model))
+        return false;
+    const request = ownDataValue(value, "request");
+    if (request !== undefined && !isRequest(request))
         return false;
-    return Object.keys(value).every((key) => key === "type" || key === "messages" || key === "tools");
+    const elapsedMs = ownDataValue(value, "elapsedMs");
+    if (elapsedMs !== undefined && (!isFiniteNumber(elapsedMs) || elapsedMs < 0))
+        return false;
+    const emittedAt = ownDataValue(value, "emittedAt");
+    if (emittedAt !== undefined && (!Number.isInteger(emittedAt) || emittedAt < 0)) {
+        return false;
+    }
+    return hasOnlyKeys(value, [
+        "type",
+        "model",
+        "request",
+        "messages",
+        "tools",
+        "elapsedMs",
+        "emittedAt",
+    ]);
 }
 /** Failure to persist a required run event before its associated operation. */
 export class DurableRunEventPersistenceError extends VeryfrontError {

package/esm/src/agent/conversation/run-chunk-mirror.d.ts

@@ -1,9 +1,11 @@
 import type { ChatMessageMetadata, ChatUiMessageChunk } from "../../chat/protocol.js";
+import { type AgentRunEventTimingOptions } from "../../runtime/model-call-context.js";
 import { type ConversationRunEvent, ConversationRunEventEncoder } from "./run-events.js";
 import { type ConversationRunMirror, type ConversationRunMirrorHighBacklogState, type ConversationRunMirrorRetryScheduledState, type ConversationRunMirrorSnapshot, type ConversationRunMirrorStoppedState } from "./run-mirror.js";
 import { type ConversationRunEventQueueController } from "./durable.js";
 /** Public API contract for conversation run chunk mirror. */
 export interface ConversationRunChunkMirror {
+    readonly timing?: AgentRunEventTimingOptions;
     handleChunk(chunk: ChatUiMessageChunk<ChatMessageMetadata>): Promise<void>;
     appendEvents(events: ConversationRunEvent[]): Promise<void>;
     flush(options?: {

package/esm/src/agent/conversation/run-chunk-mirror.d.ts.map

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

package/esm/src/agent/conversation/run-chunk-mirror.js

@@ -1,3 +1,4 @@
+import { createAgentRunEventTimingAnchor, } from "../../runtime/model-call-context.js";
 import { ConversationRunEventEncoder } from "./run-events.js";
 import { createConversationRunMirror, } from "./run-mirror.js";
 import { prepareConversationRunChunkEvents, prepareConversationRunExternalEvents, } from "./run-event-preparation.js";
@@ -31,8 +32,11 @@ export function createConversationRunChunkMirror(input) {
     // headless -- a scheduled run has no client attached -- so this is the only
     // point that observes emission time. Callers injecting their own encoder
     // choose their own clock, or none.
-    const encoder = input.encoder ??
-        new ConversationRunEventEncoder({ nowMs: () => performance.now() });
+    const getEncoderTimingAnchor = input.encoder?.getTimingAnchor;
+    const timing = typeof getEncoderTimingAnchor === "function"
+        ? getEncoderTimingAnchor.call(input.encoder) ?? createAgentRunEventTimingAnchor()
+        : createAgentRunEventTimingAnchor();
+    const encoder = input.encoder ?? new ConversationRunEventEncoder(timing);
     const immediateFlushEventCount = input.immediateFlushEventCount ??
         DEFAULT_IMMEDIATE_FLUSH_EVENT_COUNT;
     const mirror = createConversationRunMirror({
@@ -48,6 +52,7 @@ export function createConversationRunChunkMirror(input) {
         ...(input.onStopped ? { onStopped: input.onStopped } : {}),
     });
     return {
+        timing,
         async handleChunk(chunk) {
             if (mirror.getSnapshot().disabled) {
                 return;
@@ -66,10 +71,12 @@ export function createConversationRunChunkMirror(input) {
             if (mirror.getSnapshot().disabled || events.length === 0) {
                 return;
             }
-            const normalizedEvents = await (input.prepareExternalEvents?.({
-                events,
-                defaultPrepare: () => prepareConversationRunExternalEvents(events),
-            }) ?? prepareConversationRunExternalEvents(events));
+            const stampedEvents = encoder.stamp(events);
+            const preparedEvents = await (input.prepareExternalEvents?.({
+                events: stampedEvents,
+                defaultPrepare: () => prepareConversationRunExternalEvents(stampedEvents),
+            }) ?? prepareConversationRunExternalEvents(stampedEvents));
+            const normalizedEvents = prepareConversationRunExternalEvents(encoder.stamp(preparedEvents));
             await input.onExternalEventsPrepared?.({ events: normalizedEvents });
             if (normalizedEvents.length === 0) {
                 return;

package/esm/src/agent/conversation/run-events.d.ts

@@ -1,5 +1,6 @@
 import type { InferSchema } from "../../extensions/schema/index.js";
 import { type ChatStreamEvent } from "../../chat/protocol.js";
+import type { AgentRunEventTimingOptions } from "../../runtime/model-call-context.js";
 /** Shared conversation run event types value. */
 export declare const conversationRunEventTypes: {
     readonly custom: "CUSTOM";
@@ -41,6 +42,8 @@ export interface ConversationRunEventEncoderOptions {
      * nothing is stamped.
      */
     nowMs?: () => number;
+    epochMs?: () => number;
+    startedMs?: number;
 }
 export declare class ConversationRunEventEncoder {
     private readonly streamedToolInputs;
@@ -52,7 +55,10 @@ export declare class ConversationRunEventEncoder {
     private stepCount;
     private readonly nowMs?;
     private readonly startedMs?;
+    private readonly epochMs?;
     constructor(options?: ConversationRunEventEncoderOptions);
+    /** Return the run timing anchor owned by this encoder, when it has one. */
+    getTimingAnchor(): AgentRunEventTimingOptions | undefined;
     private nextStepName;
     private finishStepName;
     private getToolResultMessageId;
@@ -61,6 +67,8 @@ export declare class ConversationRunEventEncoder {
     private serializeToolResultContent;
     encode(chunk: ChatStreamEvent): ConversationRunEvent[];
     private stampElapsed;
+    /** Stamp externally-created checkpoints against this encoder's run anchor. */
+    stamp(events: ConversationRunEvent[]): ConversationRunEvent[];
     private encodeChunk;
 }
 /** Encode conversation run events helper. */

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

@@ -1 +1 @@
-{"version":3,"file":"run-events.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/conversation/run-events.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAG9D,iDAAiD;AACjD,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;CAc5B,CAAC;AAEX,eAAO,MAAM,6BAA6B;;iCAIzC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,0BAA0B;;iCAA4C,CAAC;AAEpF,0CAA0C;AAC1C,MAAM,MAAM,oBAAoB,GAC5B,WAAW,CAAC,UAAU,CAAC,OAAO,6BAA6B,CAAC,CAAC,GAC7D,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAyB5B,gDAAgD;AAChD,8DAA8D;AAC9D,MAAM,WAAW,kCAAkC;IACjD;;;;;;;;;OASG;IACH,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;CACtB;AAED,qBAAa,2BAA2B;IACtC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAqB;IACxD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA8B;IACzD,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,mBAAmB,CAAuB;IAClD,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAS;gBAKxB,OAAO,GAAE,kCAAuC;IAO5D,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,sBAAsB;IAM9B,OAAO,CAAC,qBAAqB;IAuB7B,OAAO,CAAC,oBAAoB;IAK5B,OAAO,CAAC,0BAA0B;IAYlC,MAAM,CAAC,KAAK,EAAE,eAAe,GAAG,oBAAoB,EAAE;IAOtD,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,WAAW;CAiLpB;AAED,6CAA6C;AAC7C,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,eAAe,EAAE,EACzB,OAAO,8BAAoC,GAC1C,oBAAoB,EAAE,CAExB;AAED,kDAAkD;AAClD,wBAAgB,qCAAqC,CACnD,MAAM,EAAE,eAAe,EAAE,EACzB,OAAO,8BAAoC,GAC1C,oBAAoB,EAAE,CAExB"}
+{"version":3,"file":"run-events.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/conversation/run-events.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,qCAAqC,CAAC;AAGtF,iDAAiD;AACjD,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;CAc5B,CAAC;AAEX,eAAO,MAAM,6BAA6B;;iCAIzC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,0BAA0B;;iCAA4C,CAAC;AAEpF,0CAA0C;AAC1C,MAAM,MAAM,oBAAoB,GAC5B,WAAW,CAAC,UAAU,CAAC,OAAO,6BAA6B,CAAC,CAAC,GAC7D,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAyB5B,gDAAgD;AAChD,8DAA8D;AAC9D,MAAM,WAAW,kCAAkC;IACjD;;;;;;;;;OASG;IACH,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,2BAA2B;IACtC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAqB;IACxD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA8B;IACzD,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,mBAAmB,CAAuB;IAClD,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAe;gBAK5B,OAAO,GAAE,kCAAuC;IAQ5D,2EAA2E;IAC3E,eAAe,IAAI,0BAA0B,GAAG,SAAS;IASzD,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,sBAAsB;IAM9B,OAAO,CAAC,qBAAqB;IAuB7B,OAAO,CAAC,oBAAoB;IAK5B,OAAO,CAAC,0BAA0B;IAYlC,MAAM,CAAC,KAAK,EAAE,eAAe,GAAG,oBAAoB,EAAE;IAOtD,OAAO,CAAC,YAAY;IA4BpB,8EAA8E;IAC9E,KAAK,CAAC,MAAM,EAAE,oBAAoB,EAAE,GAAG,oBAAoB,EAAE;IAI7D,OAAO,CAAC,WAAW;CAkLpB;AAcD,6CAA6C;AAC7C,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,eAAe,EAAE,EACzB,OAAO,8BAAoC,GAC1C,oBAAoB,EAAE,CAExB;AAED,kDAAkD;AAClD,wBAAgB,qCAAqC,CACnD,MAAM,EAAE,eAAe,EAAE,EACzB,OAAO,8BAAoC,GAC1C,oBAAoB,EAAE,CAExB"}

package/esm/src/agent/conversation/run-events.js

@@ -52,14 +52,26 @@ export class ConversationRunEventEncoder {
     stepCount = 0;
     nowMs;
     startedMs;
+    epochMs;
     // One encoder spans a whole run: it carries stepCount and the active message
     // across every step, so elapsed measured from here is run-relative and needs no
     // per-attempt anchor. Add it to the run's start time to get wall clock.
     constructor(options = {}) {
         if (options.nowMs) {
             this.nowMs = options.nowMs;
-            this.startedMs = options.nowMs();
+            this.startedMs = options.startedMs ?? options.nowMs();
         }
+        this.epochMs = options.epochMs;
+    }
+    /** Return the run timing anchor owned by this encoder, when it has one. */
+    getTimingAnchor() {
+        if (!this.nowMs && !this.epochMs)
+            return undefined;
+        return {
+            ...(this.nowMs ? { nowMs: this.nowMs } : {}),
+            ...(this.epochMs ? { epochMs: this.epochMs } : {}),
+            ...(this.startedMs !== undefined ? { startedMs: this.startedMs } : {}),
+        };
     }
     nextStepName() {
         this.stepCount += 1;
@@ -117,11 +129,37 @@ export class ConversationRunEventEncoder {
     // is treated alike -- including the ones this encoder synthesises, such as the
     // terminal result for a provider-executed call the provider never resolved.
     stampElapsed(events) {
-        if (!this.nowMs || this.startedMs === undefined) {
+        if (events.length === 0) {
+            return events;
+        }
+        for (const event of events) {
+            if (Object.hasOwn(event, "elapsedMs"))
+                assertValidElapsedMs(event.elapsedMs);
+            if (Object.hasOwn(event, "emittedAt"))
+                assertValidEmittedAt(event.emittedAt);
+        }
+        const needsElapsedMs = events.some((event) => !Object.hasOwn(event, "elapsedMs"));
+        const needsEmittedAt = events.some((event) => !Object.hasOwn(event, "emittedAt"));
+        const elapsedMs = needsElapsedMs && this.nowMs && this.startedMs !== undefined
+            ? Math.max(0, Math.round(this.nowMs() - this.startedMs))
+            : undefined;
+        const emittedAt = needsEmittedAt && this.epochMs ? Math.round(this.epochMs()) : undefined;
+        if (elapsedMs !== undefined)
+            assertValidElapsedMs(elapsedMs);
+        if (emittedAt !== undefined)
+            assertValidEmittedAt(emittedAt);
+        if (elapsedMs === undefined && emittedAt === undefined) {
             return events;
         }
-        const elapsedMs = Math.max(0, Math.round(this.nowMs() - this.startedMs));
-        return events.map((event) => ({ ...event, elapsedMs }));
+        return events.map((event) => ({
+            ...event,
+            ...(elapsedMs !== undefined && !Object.hasOwn(event, "elapsedMs") ? { elapsedMs } : {}),
+            ...(emittedAt !== undefined && !Object.hasOwn(event, "emittedAt") ? { emittedAt } : {}),
+        }));
+    }
+    /** Stamp externally-created checkpoints against this encoder's run anchor. */
+    stamp(events) {
+        return this.stampElapsed(events);
     }
     encodeChunk(chunk) {
         switch (chunk.type) {
@@ -211,6 +249,8 @@ export class ConversationRunEventEncoder {
                 return events;
             }
             case "tool-output-available": {
+                if (chunk.preliminary === true)
+                    return [];
                 const events = [{
                         type: conversationRunEventTypes.toolCallResult,
                         messageId: this.getToolResultMessageId(chunk.toolCallId),
@@ -283,6 +323,16 @@ export class ConversationRunEventEncoder {
         }
     }
 }
+function assertValidElapsedMs(value) {
+    if (typeof value !== "number" || !Number.isFinite(value) || value < 0) {
+        throw new TypeError("elapsedMs must be a finite non-negative number");
+    }
+}
+function assertValidEmittedAt(value) {
+    if (typeof value !== "number" || !Number.isInteger(value) || value < 0) {
+        throw new TypeError("emittedAt must be a non-negative integer");
+    }
+}
 /** Encode conversation run events helper. */
 export function encodeConversationRunEvents(events, encoder = new ConversationRunEventEncoder()) {
     return events.flatMap((event) => encoder.encode(event));

package/esm/src/agent/conversation/run-stream-mirror.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-stream-mirror.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/conversation/run-stream-mirror.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,KAAK,oBAAoB,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC;AACzF,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,qCAAqC,EAC1C,KAAK,wCAAwC,EAC7C,KAAK,6BAA6B,EAClC,KAAK,iCAAiC,EAEvC,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,KAAK,mCAAmC,EAAE,MAAM,cAAc,CAAC;AAExE,8DAA8D;AAC9D,MAAM,WAAW,2BAA2B;IAC1C,iBAAiB,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,CAAC;IAChD,YAAY,CAAC,MAAM,EAAE,oBAAoB,EAAE,GAAG,IAAI,CAAC;IACnD,KAAK,IAAI,OAAO,CAAC,6BAA6B,CAAC,CAAC;IAChD,WAAW,IAAI,UAAU,CAAC,qBAAqB,CAAC,aAAa,CAAC,CAAC,CAAC;IAChE,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,6CAA6C;AAC7C,wBAAgB,iCAAiC,CAAC,KAAK,EAAE;IACvD,eAAe,EAAE,mCAAmC,CAAC;IACrD,wBAAwB,EAAE,MAAM,CAAC;IACjC,OAAO,CAAC,EAAE,2BAA2B,CAAC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,CAAC,mBAAmB,EAAE,MAAM,KAAK,MAAM,CAAC;IAC1D,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,qCAAqC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACvF,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,wCAAwC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC7F,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,iCAAiC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAChF,GAAG,2BAA2B,CAgC9B"}
+{"version":3,"file":"run-stream-mirror.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/conversation/run-stream-mirror.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,KAAK,oBAAoB,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC;AACzF,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,qCAAqC,EAC1C,KAAK,wCAAwC,EAC7C,KAAK,6BAA6B,EAClC,KAAK,iCAAiC,EAEvC,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,KAAK,mCAAmC,EAAE,MAAM,cAAc,CAAC;AAGxE,8DAA8D;AAC9D,MAAM,WAAW,2BAA2B;IAC1C,iBAAiB,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,CAAC;IAChD,YAAY,CAAC,MAAM,EAAE,oBAAoB,EAAE,GAAG,IAAI,CAAC;IACnD,KAAK,IAAI,OAAO,CAAC,6BAA6B,CAAC,CAAC;IAChD,WAAW,IAAI,UAAU,CAAC,qBAAqB,CAAC,aAAa,CAAC,CAAC,CAAC;IAChE,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,6CAA6C;AAC7C,wBAAgB,iCAAiC,CAAC,KAAK,EAAE;IACvD,eAAe,EAAE,mCAAmC,CAAC;IACrD,wBAAwB,EAAE,MAAM,CAAC;IACjC,OAAO,CAAC,EAAE,2BAA2B,CAAC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,CAAC,mBAAmB,EAAE,MAAM,KAAK,MAAM,CAAC;IAC1D,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,qCAAqC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACvF,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,wCAAwC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC7F,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,iCAAiC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAChF,GAAG,2BAA2B,CAkC9B"}