veryfront 0.1.251 → 0.1.254

package/esm/deno.js

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

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

@@ -0,0 +1,8 @@
+type ConversationRunEventRecord = Record<string, unknown> & {
+    type: string;
+};
+export declare function getConversationRunEventJsonByteLength(value: unknown): number;
+export declare function normalizeConversationRunEvent(event: ConversationRunEventRecord): ConversationRunEventRecord[];
+export declare function normalizeConversationRunEvents(events: ConversationRunEventRecord[]): ConversationRunEventRecord[];
+export {};
+//# sourceMappingURL=conversation-run-event-normalization.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-run-event-normalization.d.ts","sourceRoot":"","sources":["../../../src/src/agent/conversation-run-event-normalization.ts"],"names":[],"mappings":"AAQA,KAAK,0BAA0B,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAS7E,wBAAgB,qCAAqC,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAM5E;AAED,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,0BAA0B,GAChC,0BAA0B,EAAE,CAkB9B;AAED,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,0BAA0B,EAAE,GACnC,0BAA0B,EAAE,CAE9B"}

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

@@ -0,0 +1,167 @@
+const MAX_CONVERSATION_RUN_EVENT_PAYLOAD_BYTES = 240 * 1024;
+const MAX_SUMMARY_DEPTH = 4;
+const MAX_SUMMARY_ARRAY_ITEMS = 8;
+const MAX_SUMMARY_OBJECT_KEYS = 24;
+const MAX_SUMMARY_STRING_BYTES = 8 * 1024;
+const encoder = new TextEncoder();
+function hasStringField(event, field) {
+    return typeof event[field] === "string";
+}
+export function getConversationRunEventJsonByteLength(value) {
+    try {
+        return encoder.encode(JSON.stringify(value)).byteLength;
+    }
+    catch {
+        return Number.POSITIVE_INFINITY;
+    }
+}
+export function normalizeConversationRunEvent(event) {
+    if (getConversationRunEventJsonByteLength(event) <= MAX_CONVERSATION_RUN_EVENT_PAYLOAD_BYTES) {
+        return [event];
+    }
+    switch (event.type) {
+        case "TEXT_MESSAGE_CONTENT":
+        case "REASONING_CONTENT":
+        case "REASONING_MESSAGE_CONTENT":
+        case "TOOL_CALL_ARGS":
+            return hasStringField(event, "delta") ? splitStringFieldEvent(event, "delta") : [event];
+        case "TOOL_CALL_RESULT":
+            return [summarizeToolResultEvent(event)];
+        default:
+            return [summarizeGenericEvent(event)];
+    }
+}
+export function normalizeConversationRunEvents(events) {
+    return events.flatMap(normalizeConversationRunEvent);
+}
+function summarizeToolResultEvent(event) {
+    if (event.type !== "TOOL_CALL_RESULT") {
+        return event;
+    }
+    if (typeof event.content === "string") {
+        const maxResultBytes = getStringFieldBudget(event, "content");
+        return {
+            ...event,
+            content: truncateUtf8String(event.content, maxResultBytes, " [tool result truncated in conversation-run event]"),
+        };
+    }
+    const summarizedEvent = {
+        ...event,
+        content: summarizeValue(event.content),
+    };
+    if (getConversationRunEventJsonByteLength(summarizedEvent) <=
+        MAX_CONVERSATION_RUN_EVENT_PAYLOAD_BYTES) {
+        return summarizedEvent;
+    }
+    return {
+        ...event,
+        content: {
+            truncated: true,
+            originalType: describeValueType(event.content),
+            note: "Tool result omitted from the conversation-run event because it exceeded the payload size limit.",
+        },
+    };
+}
+function summarizeGenericEvent(event) {
+    return {
+        ...event,
+        truncated: true,
+        note: "Conversation-run event payload was summarized to stay within storage limits.",
+    };
+}
+function splitStringFieldEvent(event, field) {
+    const maxBytes = getStringFieldBudget(event, field);
+    const parts = splitUtf8String(event[field], maxBytes);
+    return parts.map((part) => ({ ...event, [field]: part }));
+}
+function getStringFieldBudget(event, field) {
+    const eventWithEmptyField = {
+        ...event,
+        [field]: "",
+    };
+    return Math.max(1, MAX_CONVERSATION_RUN_EVENT_PAYLOAD_BYTES -
+        getConversationRunEventJsonByteLength(eventWithEmptyField));
+}
+function splitUtf8String(value, maxBytes) {
+    if (encoder.encode(value).byteLength <= maxBytes) {
+        return [value];
+    }
+    const parts = [];
+    let startIndex = 0;
+    while (startIndex < value.length) {
+        let low = startIndex + 1;
+        let high = value.length;
+        let bestEndIndex = startIndex + 1;
+        while (low <= high) {
+            const mid = Math.floor((low + high) / 2);
+            const slice = value.slice(startIndex, mid);
+            if (encoder.encode(slice).byteLength <= maxBytes) {
+                bestEndIndex = mid;
+                low = mid + 1;
+            }
+            else {
+                high = mid - 1;
+            }
+        }
+        parts.push(value.slice(startIndex, bestEndIndex));
+        startIndex = bestEndIndex;
+    }
+    return parts;
+}
+function truncateUtf8String(value, maxBytes, suffix) {
+    if (encoder.encode(value).byteLength <= maxBytes) {
+        return value;
+    }
+    const suffixBytes = encoder.encode(suffix).byteLength;
+    if (suffixBytes >= maxBytes) {
+        return suffix.slice(0, Math.max(1, maxBytes));
+    }
+    const prefixBudget = maxBytes - suffixBytes;
+    const [prefix] = splitUtf8String(value, prefixBudget);
+    return `${prefix}${suffix}`;
+}
+function summarizeValue(value, depth = 0, seen = new WeakSet()) {
+    if (typeof value === "string") {
+        return truncateUtf8String(value, MAX_SUMMARY_STRING_BYTES, "… [truncated]");
+    }
+    if (value === null || typeof value !== "object") {
+        return value;
+    }
+    if (seen.has(value)) {
+        return "[circular]";
+    }
+    if (depth >= MAX_SUMMARY_DEPTH) {
+        return "[truncated nested data]";
+    }
+    seen.add(value);
+    if (Array.isArray(value)) {
+        const items = value
+            .slice(0, MAX_SUMMARY_ARRAY_ITEMS)
+            .map((item) => summarizeValue(item, depth + 1, seen));
+        if (value.length > MAX_SUMMARY_ARRAY_ITEMS) {
+            items.push(`[truncated ${value.length - MAX_SUMMARY_ARRAY_ITEMS} more items]`);
+        }
+        return items;
+    }
+    const entries = Object.entries(value);
+    const summarizedEntries = entries
+        .slice(0, MAX_SUMMARY_OBJECT_KEYS)
+        .map(([key, entryValue]) => [key, summarizeValue(entryValue, depth + 1, seen)]);
+    const summarizedObject = Object.fromEntries(summarizedEntries);
+    if (entries.length > MAX_SUMMARY_OBJECT_KEYS) {
+        return {
+            ...summarizedObject,
+            _truncatedKeys: entries.length - MAX_SUMMARY_OBJECT_KEYS,
+        };
+    }
+    return summarizedObject;
+}
+function describeValueType(value) {
+    if (Array.isArray(value)) {
+        return "array";
+    }
+    if (value === null) {
+        return "null";
+    }
+    return typeof value;
+}

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

@@ -0,0 +1,5 @@
+import { type ChatStreamEvent } from "../chat/protocol.js";
+import { type ConversationRunEvent, ConversationRunEventEncoder } from "./conversation-run-events.js";
+export declare function prepareConversationRunStreamEvents(events: ChatStreamEvent[], encoder?: ConversationRunEventEncoder): ConversationRunEvent[];
+export declare function prepareConversationRunExternalEvents(events: ConversationRunEvent[]): ConversationRunEvent[];
+//# sourceMappingURL=conversation-run-event-preparation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-run-event-preparation.d.ts","sourceRoot":"","sources":["../../../src/src/agent/conversation-run-event-preparation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EACL,KAAK,oBAAoB,EACzB,2BAA2B,EAE5B,MAAM,8BAA8B,CAAC;AAGtC,wBAAgB,kCAAkC,CAChD,MAAM,EAAE,eAAe,EAAE,EACzB,OAAO,8BAAoC,GAC1C,oBAAoB,EAAE,CAExB;AAED,wBAAgB,oCAAoC,CAClD,MAAM,EAAE,oBAAoB,EAAE,GAC7B,oBAAoB,EAAE,CAExB"}

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

@@ -0,0 +1,8 @@
+import { ConversationRunEventEncoder, encodeConversationRunEvents, } from "./conversation-run-events.js";
+import { normalizeConversationRunEvents } from "./conversation-run-event-normalization.js";
+export function prepareConversationRunStreamEvents(events, encoder = new ConversationRunEventEncoder()) {
+    return normalizeConversationRunEvents(encodeConversationRunEvents(events, encoder));
+}
+export function prepareConversationRunExternalEvents(events) {
+    return normalizeConversationRunEvents(events);
+}

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

@@ -0,0 +1,30 @@
+import { z } from "zod";
+import { type ChatStreamEvent } from "../chat/protocol.js";
+export declare const conversationRunEventTypes: {
+    readonly custom: "CUSTOM";
+    readonly textMessageStart: "TEXT_MESSAGE_START";
+    readonly textMessageContent: "TEXT_MESSAGE_CONTENT";
+    readonly textMessageEnd: "TEXT_MESSAGE_END";
+    readonly reasoningMessageStart: "REASONING_MESSAGE_START";
+    readonly reasoningMessageContent: "REASONING_MESSAGE_CONTENT";
+    readonly reasoningMessageEnd: "REASONING_MESSAGE_END";
+    readonly toolCallStart: "TOOL_CALL_START";
+    readonly toolCallArgs: "TOOL_CALL_ARGS";
+    readonly toolCallEnd: "TOOL_CALL_END";
+    readonly toolCallResult: "TOOL_CALL_RESULT";
+};
+export declare const ConversationRunEventSchema: z.ZodObject<{
+    type: z.ZodString;
+}, z.core.$loose>;
+export type ConversationRunEvent = z.infer<typeof ConversationRunEventSchema>;
+export declare class ConversationRunEventEncoder {
+    private readonly streamedToolInputs;
+    private readonly toolInputs;
+    private activeMessageId;
+    private getToolResultMessageId;
+    private serializeToolResultContent;
+    encode(chunk: ChatStreamEvent): ConversationRunEvent[];
+}
+export declare function encodeConversationRunEvents(events: ChatStreamEvent[], encoder?: ConversationRunEventEncoder): ConversationRunEvent[];
+export declare function normalizeEncodedConversationRunEvents(events: ChatStreamEvent[], encoder?: ConversationRunEventEncoder): ConversationRunEvent[];
+//# sourceMappingURL=conversation-run-events.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-run-events.d.ts","sourceRoot":"","sources":["../../../src/src/agent/conversation-run-events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAG3D,eAAO,MAAM,yBAAyB;;;;;;;;;;;;CAY5B,CAAC;AAEX,eAAO,MAAM,0BAA0B;;iBAEvB,CAAC;AAEjB,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAyB9E,qBAAa,2BAA2B;IACtC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAqB;IACxD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA8B;IACzD,OAAO,CAAC,eAAe,CAAuB;IAE9C,OAAO,CAAC,sBAAsB;IAM9B,OAAO,CAAC,0BAA0B;IAYlC,MAAM,CAAC,KAAK,EAAE,eAAe,GAAG,oBAAoB,EAAE;CAqJvD;AAED,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,eAAe,EAAE,EACzB,OAAO,8BAAoC,GAC1C,oBAAoB,EAAE,CAExB;AAED,wBAAgB,qCAAqC,CACnD,MAAM,EAAE,eAAe,EAAE,EACzB,OAAO,8BAAoC,GAC1C,oBAAoB,EAAE,CAExB"}

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

@@ -0,0 +1,198 @@
+import { z } from "zod";
+import { normalizeConversationRunEvents } from "./conversation-run-event-normalization.js";
+export const conversationRunEventTypes = {
+    custom: "CUSTOM",
+    textMessageStart: "TEXT_MESSAGE_START",
+    textMessageContent: "TEXT_MESSAGE_CONTENT",
+    textMessageEnd: "TEXT_MESSAGE_END",
+    reasoningMessageStart: "REASONING_MESSAGE_START",
+    reasoningMessageContent: "REASONING_MESSAGE_CONTENT",
+    reasoningMessageEnd: "REASONING_MESSAGE_END",
+    toolCallStart: "TOOL_CALL_START",
+    toolCallArgs: "TOOL_CALL_ARGS",
+    toolCallEnd: "TOOL_CALL_END",
+    toolCallResult: "TOOL_CALL_RESULT",
+};
+export const ConversationRunEventSchema = z.object({
+    type: z.string().min(1),
+}).passthrough();
+function serializeToolInput(input) {
+    try {
+        return JSON.stringify(input ?? {});
+    }
+    catch {
+        return "{}";
+    }
+}
+function encodeCustomDataEvent(chunk) {
+    const name = chunk.type.slice("data-".length);
+    if (name.length === 0) {
+        return [];
+    }
+    return [{
+            type: conversationRunEventTypes.custom,
+            name,
+            value: chunk.data,
+        }];
+}
+export class ConversationRunEventEncoder {
+    streamedToolInputs = new Set();
+    toolInputs = new Map();
+    activeMessageId = null;
+    getToolResultMessageId(toolCallId) {
+        return this.activeMessageId
+            ? `${this.activeMessageId}:tool:${toolCallId}`
+            : `tool:${toolCallId}`;
+    }
+    serializeToolResultContent(value) {
+        if (typeof value === "string") {
+            return value;
+        }
+        try {
+            return JSON.stringify(value ?? null);
+        }
+        catch {
+            return String(value);
+        }
+    }
+    encode(chunk) {
+        switch (chunk.type) {
+            case "start":
+                this.activeMessageId = chunk.messageId ?? null;
+                return [];
+            case "text-start":
+                return [{
+                        type: conversationRunEventTypes.textMessageStart,
+                        messageId: chunk.id,
+                        role: "assistant",
+                    }];
+            case "text-delta":
+                return [{
+                        type: conversationRunEventTypes.textMessageContent,
+                        messageId: chunk.id,
+                        delta: chunk.delta,
+                    }];
+            case "text-end":
+                return [{ type: conversationRunEventTypes.textMessageEnd, messageId: chunk.id }];
+            case "reasoning-start":
+                return [{
+                        type: conversationRunEventTypes.reasoningMessageStart,
+                        messageId: chunk.id,
+                        role: "assistant",
+                    }];
+            case "reasoning-delta":
+                return [{
+                        type: conversationRunEventTypes.reasoningMessageContent,
+                        messageId: chunk.id,
+                        delta: chunk.delta,
+                    }];
+            case "reasoning-end":
+                return [{ type: conversationRunEventTypes.reasoningMessageEnd, messageId: chunk.id }];
+            case "tool-input-start":
+                return [{
+                        type: conversationRunEventTypes.toolCallStart,
+                        toolCallId: chunk.toolCallId,
+                        toolCallName: chunk.toolName,
+                    }];
+            case "tool-input-delta":
+                this.streamedToolInputs.add(chunk.toolCallId);
+                return [{
+                        type: conversationRunEventTypes.toolCallArgs,
+                        toolCallId: chunk.toolCallId,
+                        delta: chunk.inputTextDelta,
+                    }];
+            case "tool-input-available": {
+                this.toolInputs.set(chunk.toolCallId, chunk.input);
+                const events = [];
+                if (!this.streamedToolInputs.has(chunk.toolCallId)) {
+                    events.push({
+                        type: conversationRunEventTypes.toolCallArgs,
+                        toolCallId: chunk.toolCallId,
+                        delta: serializeToolInput(chunk.input),
+                    });
+                }
+                events.push({ type: conversationRunEventTypes.toolCallEnd, toolCallId: chunk.toolCallId });
+                return events;
+            }
+            case "tool-input-error": {
+                this.toolInputs.set(chunk.toolCallId, chunk.input);
+                const events = [];
+                if (!this.streamedToolInputs.has(chunk.toolCallId)) {
+                    events.push({
+                        type: conversationRunEventTypes.toolCallArgs,
+                        toolCallId: chunk.toolCallId,
+                        delta: serializeToolInput(chunk.input),
+                    });
+                }
+                events.push({ type: conversationRunEventTypes.toolCallEnd, toolCallId: chunk.toolCallId });
+                events.push({
+                    type: conversationRunEventTypes.toolCallResult,
+                    messageId: this.getToolResultMessageId(chunk.toolCallId),
+                    toolCallId: chunk.toolCallId,
+                    content: this.serializeToolResultContent(chunk.errorText),
+                    role: "tool",
+                    ...(this.toolInputs.has(chunk.toolCallId)
+                        ? { input: this.toolInputs.get(chunk.toolCallId) }
+                        : {}),
+                    isError: true,
+                });
+                this.toolInputs.delete(chunk.toolCallId);
+                return events;
+            }
+            case "tool-output-available":
+                return [{
+                        type: conversationRunEventTypes.toolCallResult,
+                        messageId: this.getToolResultMessageId(chunk.toolCallId),
+                        toolCallId: chunk.toolCallId,
+                        content: this.serializeToolResultContent(chunk.output),
+                        role: "tool",
+                        ...(this.toolInputs.has(chunk.toolCallId)
+                            ? { input: this.toolInputs.get(chunk.toolCallId) }
+                            : {}),
+                    }];
+            case "tool-output-error":
+                return [{
+                        type: conversationRunEventTypes.toolCallResult,
+                        messageId: this.getToolResultMessageId(chunk.toolCallId),
+                        toolCallId: chunk.toolCallId,
+                        content: this.serializeToolResultContent(chunk.errorText),
+                        role: "tool",
+                        ...(this.toolInputs.has(chunk.toolCallId)
+                            ? { input: this.toolInputs.get(chunk.toolCallId) }
+                            : {}),
+                        isError: true,
+                    }];
+            case "tool-output-denied":
+                return [{
+                        type: conversationRunEventTypes.toolCallResult,
+                        messageId: this.getToolResultMessageId(chunk.toolCallId),
+                        toolCallId: chunk.toolCallId,
+                        content: "Tool output denied",
+                        role: "tool",
+                        ...(this.toolInputs.has(chunk.toolCallId)
+                            ? { input: this.toolInputs.get(chunk.toolCallId) }
+                            : {}),
+                        isError: true,
+                    }];
+            case "error":
+            case "finish":
+            case "abort":
+            case "message-metadata":
+            case "source-url":
+            case "source-document":
+            case "file":
+            case "tool-approval-request":
+            case "start-step":
+            case "finish-step":
+                return [];
+            default:
+                return chunk.type.startsWith("data-") ? encodeCustomDataEvent(chunk) : [];
+        }
+    }
+}
+export function encodeConversationRunEvents(events, encoder = new ConversationRunEventEncoder()) {
+    return events.flatMap((event) => encoder.encode(event));
+}
+export function normalizeEncodedConversationRunEvents(events, encoder = new ConversationRunEventEncoder()) {
+    return normalizeConversationRunEvents(encodeConversationRunEvents(events, encoder));
+}

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

@@ -93,6 +93,9 @@ export { type ConversationRunContext, createConversationRunContext, } from "./co
 export { type ConversationRootRunContext, type ConversationRootRunDescriptor, createConversationRootRunContext, createConversationRootRunStartAdapter, prepareConversationRootRunContext, startConversationRootRun, } from "./conversation-root-run-context.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, } from "./conversation-hosted-lifecycle.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";
 export { type ConversationRunMirror, type ConversationRunMirrorRetryScheduledState, type ConversationRunMirrorSnapshot, type ConversationRunMirrorStoppedState, createConversationRunMirror, } from "./conversation-run-mirror.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";

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

@@ -92,6 +92,9 @@ export { createConversationRunContext, } from "./conversation-run-context.js";
 export { createConversationRootRunContext, createConversationRootRunStartAdapter, prepareConversationRootRunContext, startConversationRootRun, } from "./conversation-root-run-context.js";
 export { bootstrapConversationAgentRun, ConversationMessageRecordSchema, ConversationRecordSchema, createConversationMessage, createConversationRecord, ensureConversationProjectLink, fetchConversationRecord, } from "./conversation-bootstrap.js";
 export { createConversationChildLifecycleAdapter, createConversationHostedLifecycleAdapter, } from "./conversation-hosted-lifecycle.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";
 export { createConversationRunMirror, } from "./conversation-run-mirror.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";

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

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.1.251";
+export declare const VERSION = "0.1.254";
 //# 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.251";
+export const VERSION = "0.1.254";

package/package.json

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

package/src/src/agent/conversation-run-event-normalization.ts

@@ -0,0 +1,228 @@
+const MAX_CONVERSATION_RUN_EVENT_PAYLOAD_BYTES = 240 * 1024;
+const MAX_SUMMARY_DEPTH = 4;
+const MAX_SUMMARY_ARRAY_ITEMS = 8;
+const MAX_SUMMARY_OBJECT_KEYS = 24;
+const MAX_SUMMARY_STRING_BYTES = 8 * 1024;
+
+const encoder = new TextEncoder();
+
+type ConversationRunEventRecord = Record<string, unknown> & { type: string };
+
+function hasStringField<TField extends "delta" | "content">(
+  event: ConversationRunEventRecord,
+  field: TField,
+): event is ConversationRunEventRecord & Record<TField, string> {
+  return typeof event[field] === "string";
+}
+
+export function getConversationRunEventJsonByteLength(value: unknown): number {
+  try {
+    return encoder.encode(JSON.stringify(value)).byteLength;
+  } catch {
+    return Number.POSITIVE_INFINITY;
+  }
+}
+
+export function normalizeConversationRunEvent(
+  event: ConversationRunEventRecord,
+): ConversationRunEventRecord[] {
+  if (getConversationRunEventJsonByteLength(event) <= MAX_CONVERSATION_RUN_EVENT_PAYLOAD_BYTES) {
+    return [event];
+  }
+
+  switch (event.type) {
+    case "TEXT_MESSAGE_CONTENT":
+    case "REASONING_CONTENT":
+    case "REASONING_MESSAGE_CONTENT":
+    case "TOOL_CALL_ARGS":
+      return hasStringField(event, "delta") ? splitStringFieldEvent(event, "delta") : [event];
+
+    case "TOOL_CALL_RESULT":
+      return [summarizeToolResultEvent(event)];
+
+    default:
+      return [summarizeGenericEvent(event)];
+  }
+}
+
+export function normalizeConversationRunEvents(
+  events: ConversationRunEventRecord[],
+): ConversationRunEventRecord[] {
+  return events.flatMap(normalizeConversationRunEvent);
+}
+
+function summarizeToolResultEvent(event: ConversationRunEventRecord): ConversationRunEventRecord {
+  if (event.type !== "TOOL_CALL_RESULT") {
+    return event;
+  }
+
+  if (typeof event.content === "string") {
+    const maxResultBytes = getStringFieldBudget(event, "content");
+    return {
+      ...event,
+      content: truncateUtf8String(
+        event.content,
+        maxResultBytes,
+        " [tool result truncated in conversation-run event]",
+      ),
+    };
+  }
+
+  const summarizedEvent = {
+    ...event,
+    content: summarizeValue(event.content),
+  } satisfies ConversationRunEventRecord;
+
+  if (
+    getConversationRunEventJsonByteLength(summarizedEvent) <=
+      MAX_CONVERSATION_RUN_EVENT_PAYLOAD_BYTES
+  ) {
+    return summarizedEvent;
+  }
+
+  return {
+    ...event,
+    content: {
+      truncated: true,
+      originalType: describeValueType(event.content),
+      note:
+        "Tool result omitted from the conversation-run event because it exceeded the payload size limit.",
+    },
+  };
+}
+
+function summarizeGenericEvent(event: ConversationRunEventRecord): ConversationRunEventRecord {
+  return {
+    ...event,
+    truncated: true,
+    note: "Conversation-run event payload was summarized to stay within storage limits.",
+  };
+}
+
+function splitStringFieldEvent<TField extends "delta" | "content">(
+  event: ConversationRunEventRecord & Record<TField, string>,
+  field: TField,
+): ConversationRunEventRecord[] {
+  const maxBytes = getStringFieldBudget(event, field);
+  const parts = splitUtf8String(event[field], maxBytes);
+  return parts.map((part) => ({ ...event, [field]: part }));
+}
+
+function getStringFieldBudget(
+  event: ConversationRunEventRecord,
+  field: "delta" | "content",
+): number {
+  const eventWithEmptyField = {
+    ...event,
+    [field]: "",
+  };
+
+  return Math.max(
+    1,
+    MAX_CONVERSATION_RUN_EVENT_PAYLOAD_BYTES -
+      getConversationRunEventJsonByteLength(eventWithEmptyField),
+  );
+}
+
+function splitUtf8String(value: string, maxBytes: number): string[] {
+  if (encoder.encode(value).byteLength <= maxBytes) {
+    return [value];
+  }
+
+  const parts: string[] = [];
+  let startIndex = 0;
+
+  while (startIndex < value.length) {
+    let low = startIndex + 1;
+    let high = value.length;
+    let bestEndIndex = startIndex + 1;
+
+    while (low <= high) {
+      const mid = Math.floor((low + high) / 2);
+      const slice = value.slice(startIndex, mid);
+      if (encoder.encode(slice).byteLength <= maxBytes) {
+        bestEndIndex = mid;
+        low = mid + 1;
+      } else {
+        high = mid - 1;
+      }
+    }
+
+    parts.push(value.slice(startIndex, bestEndIndex));
+    startIndex = bestEndIndex;
+  }
+
+  return parts;
+}
+
+function truncateUtf8String(value: string, maxBytes: number, suffix: string): string {
+  if (encoder.encode(value).byteLength <= maxBytes) {
+    return value;
+  }
+
+  const suffixBytes = encoder.encode(suffix).byteLength;
+  if (suffixBytes >= maxBytes) {
+    return suffix.slice(0, Math.max(1, maxBytes));
+  }
+
+  const prefixBudget = maxBytes - suffixBytes;
+  const [prefix] = splitUtf8String(value, prefixBudget);
+  return `${prefix}${suffix}`;
+}
+
+function summarizeValue(value: unknown, depth = 0, seen: WeakSet<object> = new WeakSet()): unknown {
+  if (typeof value === "string") {
+    return truncateUtf8String(value, MAX_SUMMARY_STRING_BYTES, "… [truncated]");
+  }
+
+  if (value === null || typeof value !== "object") {
+    return value;
+  }
+
+  if (seen.has(value)) {
+    return "[circular]";
+  }
+
+  if (depth >= MAX_SUMMARY_DEPTH) {
+    return "[truncated nested data]";
+  }
+
+  seen.add(value);
+
+  if (Array.isArray(value)) {
+    const items = value
+      .slice(0, MAX_SUMMARY_ARRAY_ITEMS)
+      .map((item) => summarizeValue(item, depth + 1, seen));
+    if (value.length > MAX_SUMMARY_ARRAY_ITEMS) {
+      items.push(`[truncated ${value.length - MAX_SUMMARY_ARRAY_ITEMS} more items]`);
+    }
+    return items;
+  }
+
+  const entries = Object.entries(value);
+  const summarizedEntries = entries
+    .slice(0, MAX_SUMMARY_OBJECT_KEYS)
+    .map(([key, entryValue]) => [key, summarizeValue(entryValue, depth + 1, seen)] as const);
+  const summarizedObject = Object.fromEntries(summarizedEntries);
+
+  if (entries.length > MAX_SUMMARY_OBJECT_KEYS) {
+    return {
+      ...summarizedObject,
+      _truncatedKeys: entries.length - MAX_SUMMARY_OBJECT_KEYS,
+    };
+  }
+
+  return summarizedObject;
+}
+
+function describeValueType(value: unknown): string {
+  if (Array.isArray(value)) {
+    return "array";
+  }
+
+  if (value === null) {
+    return "null";
+  }
+
+  return typeof value;
+}

package/src/src/agent/conversation-run-event-preparation.ts

@@ -0,0 +1,20 @@
+import { type ChatStreamEvent } from "../chat/protocol.js";
+import {
+  type ConversationRunEvent,
+  ConversationRunEventEncoder,
+  encodeConversationRunEvents,
+} from "./conversation-run-events.js";
+import { normalizeConversationRunEvents } from "./conversation-run-event-normalization.js";
+
+export function prepareConversationRunStreamEvents(
+  events: ChatStreamEvent[],
+  encoder = new ConversationRunEventEncoder(),
+): ConversationRunEvent[] {
+  return normalizeConversationRunEvents(encodeConversationRunEvents(events, encoder));
+}
+
+export function prepareConversationRunExternalEvents(
+  events: ConversationRunEvent[],
+): ConversationRunEvent[] {
+  return normalizeConversationRunEvents(events);
+}

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

@@ -0,0 +1,234 @@
+import { z } from "zod";
+import { type ChatStreamEvent } from "../chat/protocol.js";
+import { normalizeConversationRunEvents } from "./conversation-run-event-normalization.js";
+
+export const conversationRunEventTypes = {
+  custom: "CUSTOM",
+  textMessageStart: "TEXT_MESSAGE_START",
+  textMessageContent: "TEXT_MESSAGE_CONTENT",
+  textMessageEnd: "TEXT_MESSAGE_END",
+  reasoningMessageStart: "REASONING_MESSAGE_START",
+  reasoningMessageContent: "REASONING_MESSAGE_CONTENT",
+  reasoningMessageEnd: "REASONING_MESSAGE_END",
+  toolCallStart: "TOOL_CALL_START",
+  toolCallArgs: "TOOL_CALL_ARGS",
+  toolCallEnd: "TOOL_CALL_END",
+  toolCallResult: "TOOL_CALL_RESULT",
+} as const;
+
+export const ConversationRunEventSchema = z.object({
+  type: z.string().min(1),
+}).passthrough();
+
+export type ConversationRunEvent = z.infer<typeof ConversationRunEventSchema>;
+
+function serializeToolInput(input: unknown): string {
+  try {
+    return JSON.stringify(input ?? {});
+  } catch {
+    return "{}";
+  }
+}
+
+function encodeCustomDataEvent(
+  chunk: Extract<ChatStreamEvent, { type: `data-${string}` }>,
+): ConversationRunEvent[] {
+  const name = chunk.type.slice("data-".length);
+  if (name.length === 0) {
+    return [];
+  }
+
+  return [{
+    type: conversationRunEventTypes.custom,
+    name,
+    value: chunk.data,
+  }];
+}
+
+export class ConversationRunEventEncoder {
+  private readonly streamedToolInputs = new Set<string>();
+  private readonly toolInputs = new Map<string, unknown>();
+  private activeMessageId: string | null = null;
+
+  private getToolResultMessageId(toolCallId: string) {
+    return this.activeMessageId
+      ? `${this.activeMessageId}:tool:${toolCallId}`
+      : `tool:${toolCallId}`;
+  }
+
+  private serializeToolResultContent(value: unknown): string {
+    if (typeof value === "string") {
+      return value;
+    }
+
+    try {
+      return JSON.stringify(value ?? null);
+    } catch {
+      return String(value);
+    }
+  }
+
+  encode(chunk: ChatStreamEvent): ConversationRunEvent[] {
+    switch (chunk.type) {
+      case "start":
+        this.activeMessageId = chunk.messageId ?? null;
+        return [];
+
+      case "text-start":
+        return [{
+          type: conversationRunEventTypes.textMessageStart,
+          messageId: chunk.id,
+          role: "assistant",
+        }];
+
+      case "text-delta":
+        return [{
+          type: conversationRunEventTypes.textMessageContent,
+          messageId: chunk.id,
+          delta: chunk.delta,
+        }];
+
+      case "text-end":
+        return [{ type: conversationRunEventTypes.textMessageEnd, messageId: chunk.id }];
+
+      case "reasoning-start":
+        return [{
+          type: conversationRunEventTypes.reasoningMessageStart,
+          messageId: chunk.id,
+          role: "assistant",
+        }];
+
+      case "reasoning-delta":
+        return [{
+          type: conversationRunEventTypes.reasoningMessageContent,
+          messageId: chunk.id,
+          delta: chunk.delta,
+        }];
+
+      case "reasoning-end":
+        return [{ type: conversationRunEventTypes.reasoningMessageEnd, messageId: chunk.id }];
+
+      case "tool-input-start":
+        return [{
+          type: conversationRunEventTypes.toolCallStart,
+          toolCallId: chunk.toolCallId,
+          toolCallName: chunk.toolName,
+        }];
+
+      case "tool-input-delta":
+        this.streamedToolInputs.add(chunk.toolCallId);
+        return [{
+          type: conversationRunEventTypes.toolCallArgs,
+          toolCallId: chunk.toolCallId,
+          delta: chunk.inputTextDelta,
+        }];
+
+      case "tool-input-available": {
+        this.toolInputs.set(chunk.toolCallId, chunk.input);
+        const events: ConversationRunEvent[] = [];
+        if (!this.streamedToolInputs.has(chunk.toolCallId)) {
+          events.push({
+            type: conversationRunEventTypes.toolCallArgs,
+            toolCallId: chunk.toolCallId,
+            delta: serializeToolInput(chunk.input),
+          });
+        }
+        events.push({ type: conversationRunEventTypes.toolCallEnd, toolCallId: chunk.toolCallId });
+        return events;
+      }
+
+      case "tool-input-error": {
+        this.toolInputs.set(chunk.toolCallId, chunk.input);
+        const events: ConversationRunEvent[] = [];
+        if (!this.streamedToolInputs.has(chunk.toolCallId)) {
+          events.push({
+            type: conversationRunEventTypes.toolCallArgs,
+            toolCallId: chunk.toolCallId,
+            delta: serializeToolInput(chunk.input),
+          });
+        }
+        events.push({ type: conversationRunEventTypes.toolCallEnd, toolCallId: chunk.toolCallId });
+        events.push({
+          type: conversationRunEventTypes.toolCallResult,
+          messageId: this.getToolResultMessageId(chunk.toolCallId),
+          toolCallId: chunk.toolCallId,
+          content: this.serializeToolResultContent(chunk.errorText),
+          role: "tool",
+          ...(this.toolInputs.has(chunk.toolCallId)
+            ? { input: this.toolInputs.get(chunk.toolCallId) }
+            : {}),
+          isError: true,
+        });
+        this.toolInputs.delete(chunk.toolCallId);
+        return events;
+      }
+
+      case "tool-output-available":
+        return [{
+          type: conversationRunEventTypes.toolCallResult,
+          messageId: this.getToolResultMessageId(chunk.toolCallId),
+          toolCallId: chunk.toolCallId,
+          content: this.serializeToolResultContent(chunk.output),
+          role: "tool",
+          ...(this.toolInputs.has(chunk.toolCallId)
+            ? { input: this.toolInputs.get(chunk.toolCallId) }
+            : {}),
+        }];
+
+      case "tool-output-error":
+        return [{
+          type: conversationRunEventTypes.toolCallResult,
+          messageId: this.getToolResultMessageId(chunk.toolCallId),
+          toolCallId: chunk.toolCallId,
+          content: this.serializeToolResultContent(chunk.errorText),
+          role: "tool",
+          ...(this.toolInputs.has(chunk.toolCallId)
+            ? { input: this.toolInputs.get(chunk.toolCallId) }
+            : {}),
+          isError: true,
+        }];
+
+      case "tool-output-denied":
+        return [{
+          type: conversationRunEventTypes.toolCallResult,
+          messageId: this.getToolResultMessageId(chunk.toolCallId),
+          toolCallId: chunk.toolCallId,
+          content: "Tool output denied",
+          role: "tool",
+          ...(this.toolInputs.has(chunk.toolCallId)
+            ? { input: this.toolInputs.get(chunk.toolCallId) }
+            : {}),
+          isError: true,
+        }];
+
+      case "error":
+      case "finish":
+      case "abort":
+      case "message-metadata":
+      case "source-url":
+      case "source-document":
+      case "file":
+      case "tool-approval-request":
+      case "start-step":
+      case "finish-step":
+        return [];
+
+      default:
+        return chunk.type.startsWith("data-") ? encodeCustomDataEvent(chunk) : [];
+    }
+  }
+}
+
+export function encodeConversationRunEvents(
+  events: ChatStreamEvent[],
+  encoder = new ConversationRunEventEncoder(),
+): ConversationRunEvent[] {
+  return events.flatMap((event) => encoder.encode(event));
+}
+
+export function normalizeEncodedConversationRunEvents(
+  events: ChatStreamEvent[],
+  encoder = new ConversationRunEventEncoder(),
+): ConversationRunEvent[] {
+  return normalizeConversationRunEvents(encodeConversationRunEvents(events, encoder));
+}

package/src/src/agent/index.ts

@@ -211,6 +211,23 @@ export {
   createConversationHostedLifecycleAdapter,
   type CreateConversationHostedLifecycleAdapterOptions,
 } from "./conversation-hosted-lifecycle.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";
 export {
   type ConversationRunMirror,
   type ConversationRunMirrorRetryScheduledState,

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