veryfront 0.1.516 → 0.1.518

package/esm/src/agent/ag-ui/chat-ui-chunk-browser-encoder.js

@@ -0,0 +1,108 @@
+import { tryGetVeryfrontCloudProviderFromModelId } from "../../provider/index.js";
+import { createAgUiBrowserFinalizeTracker } from "./browser-finalize-tracker.js";
+import { createAgUiBrowserChunkEncoder } from "./browser-chunk-encoder.js";
+import { createAgUiTrackedBrowserResponse, } from "./tracked-browser-response.js";
+export function getAgUiChatUiMessageMetadataFromChunk(chunk) {
+    if (chunk.type === "start" || chunk.type === "finish") {
+        return chunk.messageMetadata;
+    }
+    if (chunk.type === "message-metadata") {
+        return chunk.messageMetadata;
+    }
+    return undefined;
+}
+export function getAgUiChatUiMessageUsageMetadata(messageMetadata) {
+    const inputTokens = messageMetadata?.usage?.inputTokens;
+    const outputTokens = messageMetadata?.usage?.outputTokens;
+    return {
+        inputTokens,
+        outputTokens,
+        totalTokens: typeof inputTokens === "number" || typeof outputTokens === "number"
+            ? (inputTokens ?? 0) + (outputTokens ?? 0)
+            : undefined,
+    };
+}
+export function getAgUiChatUiMessageChunkMetadata(chunk, options = {}) {
+    const messageMetadata = getAgUiChatUiMessageMetadataFromChunk(chunk);
+    const modelId = messageMetadata?.modelId;
+    const provider = modelId
+        ? (options.resolveProvider ?? tryGetVeryfrontCloudProviderFromModelId)(modelId)
+        : undefined;
+    const usageMetadata = getAgUiChatUiMessageUsageMetadata(messageMetadata);
+    if (!provider &&
+        !modelId &&
+        typeof usageMetadata.inputTokens !== "number" &&
+        typeof usageMetadata.outputTokens !== "number" &&
+        chunk.type !== "finish") {
+        return null;
+    }
+    return {
+        ...(provider ? { provider } : {}),
+        ...(modelId ? { model: modelId } : {}),
+        ...(typeof usageMetadata.inputTokens === "number"
+            ? { inputTokens: usageMetadata.inputTokens }
+            : {}),
+        ...(typeof usageMetadata.outputTokens === "number"
+            ? { outputTokens: usageMetadata.outputTokens }
+            : {}),
+        ...(typeof usageMetadata.totalTokens === "number"
+            ? { totalTokens: usageMetadata.totalTokens }
+            : {}),
+        ...(chunk.type === "finish" && chunk.finishReason ? { finishReason: chunk.finishReason } : {}),
+    };
+}
+export function normalizeChatUiMessageChunkToAgUiRuntimeEvent(chunk) {
+    switch (chunk.type) {
+        case "start":
+            return {
+                ...chunk,
+                type: "message-start",
+            };
+        case "finish":
+            return {
+                ...chunk,
+                type: "message-finish",
+            };
+        case "start-step":
+            return { type: "step-start" };
+        case "finish-step":
+            return { type: "step-end" };
+        case "error":
+            return {
+                type: "error",
+                error: chunk.errorText,
+            };
+        default:
+            return {
+                ...chunk,
+            };
+    }
+}
+export function createAgUiChatUiChunkBrowserEncoder(options = {}) {
+    const provider = options.modelId
+        ? (options.resolveProvider ?? tryGetVeryfrontCloudProviderFromModelId)(options.modelId)
+        : undefined;
+    return createAgUiBrowserChunkEncoder({
+        initialMetadata: {
+            ...(provider ? { provider } : {}),
+            ...(options.modelId ? { model: options.modelId } : {}),
+        },
+        getMetadataFromChunk: (chunk) => getAgUiChatUiMessageChunkMetadata(chunk, options),
+        getRuntimeEvents: (chunk) => [normalizeChatUiMessageChunkToAgUiRuntimeEvent(chunk)],
+    });
+}
+export function createAgUiChatUiTrackedBrowserResponse(input) {
+    const finalizeTracker = createAgUiBrowserFinalizeTracker({
+        getMetadataFromChunk: (chunk) => getAgUiChatUiMessageChunkMetadata(chunk, {
+            resolveProvider: input.resolveProvider,
+        }),
+    });
+    return createAgUiTrackedBrowserResponse({
+        ...input,
+        chunkEncoder: createAgUiChatUiChunkBrowserEncoder({
+            modelId: input.modelId,
+            resolveProvider: input.resolveProvider,
+        }),
+        finalizeTracker,
+    });
+}

package/esm/src/agent/ag-ui/chunk-encoder-bridge.d.ts

@@ -0,0 +1,11 @@
+import { type AgentResponse, type AgUiBrowserEncodedEvent, type AgUiBrowserEncoderState, type AgUiRuntimeStreamEvent } from "../index.js";
+export interface AgUiChunkEncoderBridge<TChunk> {
+    encode: (chunk: TChunk) => AgUiBrowserEncodedEvent[];
+    finalize: (response: AgentResponse | null) => AgUiBrowserEncodedEvent[];
+    state: AgUiBrowserEncoderState;
+}
+export interface CreateAgUiChunkEncoderBridgeOptions<TChunk> {
+    getRuntimeEvents: (chunk: TChunk) => readonly AgUiRuntimeStreamEvent[];
+}
+export declare function createAgUiChunkEncoderBridge<TChunk>(options: CreateAgUiChunkEncoderBridgeOptions<TChunk>): AgUiChunkEncoderBridge<TChunk>;
+//# sourceMappingURL=chunk-encoder-bridge.d.ts.map

package/esm/src/agent/ag-ui/chunk-encoder-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-encoder-bridge.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/ag-ui/chunk-encoder-bridge.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAI5B,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,sBAAsB,CAAC,MAAM;IAC5C,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,uBAAuB,EAAE,CAAC;IACrD,QAAQ,EAAE,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,KAAK,uBAAuB,EAAE,CAAC;IACxE,KAAK,EAAE,uBAAuB,CAAC;CAChC;AAED,MAAM,WAAW,mCAAmC,CAAC,MAAM;IACzD,gBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,SAAS,sBAAsB,EAAE,CAAC;CACxE;AAED,wBAAgB,4BAA4B,CAAC,MAAM,EACjD,OAAO,EAAE,mCAAmC,CAAC,MAAM,CAAC,GACnD,sBAAsB,CAAC,MAAM,CAAC,CAWhC"}

package/esm/src/agent/ag-ui/chunk-encoder-bridge.js

@@ -0,0 +1,9 @@
+import { createAgUiBrowserEncoderState, finalizeAgUiBrowserEvents, mapRuntimeStreamEventToAgUiBrowserEvents, } from "../index.js";
+export function createAgUiChunkEncoderBridge(options) {
+    const state = createAgUiBrowserEncoderState();
+    return {
+        state,
+        encode: (chunk) => options.getRuntimeEvents(chunk).flatMap((event) => mapRuntimeStreamEventToAgUiBrowserEvents(state, event)),
+        finalize: (response) => finalizeAgUiBrowserEvents(state, response),
+    };
+}

package/esm/src/agent/ag-ui/detached-start.d.ts

@@ -0,0 +1,158 @@
+import type { InferSchema } from "../../extensions/schema/index.js";
+import { type AgUiResumeValue } from "./tool-shared.js";
+import { type RunResumeSessionManager } from "../runtime/index.js";
+import type { Agent } from "../types.js";
+import type { ChatUiMessage } from "../../chat/types.js";
+type AgUiContextValue = Record<string, unknown> | ((request: Request) => Record<string, unknown> | Promise<Record<string, unknown>>);
+export declare const getAgUiDetachedStartRequestSchema: () => import("../../internal-agents/schema.js").Schema<{
+    messages: import("../../extensions/schema/schema-validator.js").InferShape<{
+        id: import("../../internal-agents/schema.js").Schema<string>;
+        role: import("../../internal-agents/schema.js").Schema<string>;
+        parts: import("../../internal-agents/schema.js").Schema<({
+            type: string;
+        } & {} & Record<string, unknown>)[]>;
+        metadata: import("../../internal-agents/schema.js").Schema<Record<string, unknown> | undefined>;
+        createdAt: import("../../internal-agents/schema.js").Schema<string | undefined>;
+    }>[];
+    tools: import("../../extensions/schema/schema-validator.js").InferShape<{
+        name: import("../../internal-agents/schema.js").Schema<string>;
+        description: import("../../internal-agents/schema.js").Schema<string | undefined>;
+        parameters: import("../../internal-agents/schema.js").Schema<Record<string, unknown> | undefined>;
+    }>[];
+    context: (import("../../extensions/schema/schema-validator.js").InferShape<{
+        type: import("../../internal-agents/schema.js").Schema<"text">;
+        title: import("../../internal-agents/schema.js").Schema<string | undefined>;
+        text: import("../../internal-agents/schema.js").Schema<string>;
+    }> | import("../../extensions/schema/schema-validator.js").InferShape<{
+        type: import("../../internal-agents/schema.js").Schema<"json">;
+        title: import("../../internal-agents/schema.js").Schema<string | undefined>;
+        data: import("../../internal-agents/schema.js").Schema<Record<string, unknown>>;
+    }> | import("../../extensions/schema/schema-validator.js").InferShape<{
+        type: import("../../internal-agents/schema.js").Schema<"resource">;
+        title: import("../../internal-agents/schema.js").Schema<string | undefined>;
+        uri: import("../../internal-agents/schema.js").Schema<string>;
+        mimeType: import("../../internal-agents/schema.js").Schema<string | undefined>;
+        text: import("../../internal-agents/schema.js").Schema<string | undefined>;
+    }>)[];
+} & {
+    threadId?: string | undefined;
+    runId?: string | undefined;
+    forwardedProps?: Record<string, unknown> | undefined;
+    model?: string | undefined;
+    maxOutputTokens?: number | undefined;
+} & {
+    threadId: string;
+    runId: string;
+}>;
+export declare const getAgUiDetachedStartAcceptedSchema: () => import("../../internal-agents/schema.js").Schema<import("../../extensions/schema/schema-validator.js").InferShape<{
+    accepted: import("../../internal-agents/schema.js").Schema<true>;
+    duplicate: import("../../internal-agents/schema.js").Schema<boolean>;
+    runId: import("../../internal-agents/schema.js").Schema<string>;
+    threadId: import("../../internal-agents/schema.js").Schema<string>;
+}>>;
+/** @deprecated Use getAgUiDetachedStartRequestSchema() */
+export declare const AgUiDetachedStartRequestSchema: import("../../internal-agents/schema.js").Schema<{
+    messages: import("../../extensions/schema/schema-validator.js").InferShape<{
+        id: import("../../internal-agents/schema.js").Schema<string>;
+        role: import("../../internal-agents/schema.js").Schema<string>;
+        parts: import("../../internal-agents/schema.js").Schema<({
+            type: string;
+        } & {} & Record<string, unknown>)[]>;
+        metadata: import("../../internal-agents/schema.js").Schema<Record<string, unknown> | undefined>;
+        createdAt: import("../../internal-agents/schema.js").Schema<string | undefined>;
+    }>[];
+    tools: import("../../extensions/schema/schema-validator.js").InferShape<{
+        name: import("../../internal-agents/schema.js").Schema<string>;
+        description: import("../../internal-agents/schema.js").Schema<string | undefined>;
+        parameters: import("../../internal-agents/schema.js").Schema<Record<string, unknown> | undefined>;
+    }>[];
+    context: (import("../../extensions/schema/schema-validator.js").InferShape<{
+        type: import("../../internal-agents/schema.js").Schema<"text">;
+        title: import("../../internal-agents/schema.js").Schema<string | undefined>;
+        text: import("../../internal-agents/schema.js").Schema<string>;
+    }> | import("../../extensions/schema/schema-validator.js").InferShape<{
+        type: import("../../internal-agents/schema.js").Schema<"json">;
+        title: import("../../internal-agents/schema.js").Schema<string | undefined>;
+        data: import("../../internal-agents/schema.js").Schema<Record<string, unknown>>;
+    }> | import("../../extensions/schema/schema-validator.js").InferShape<{
+        type: import("../../internal-agents/schema.js").Schema<"resource">;
+        title: import("../../internal-agents/schema.js").Schema<string | undefined>;
+        uri: import("../../internal-agents/schema.js").Schema<string>;
+        mimeType: import("../../internal-agents/schema.js").Schema<string | undefined>;
+        text: import("../../internal-agents/schema.js").Schema<string | undefined>;
+    }>)[];
+} & {
+    threadId?: string | undefined;
+    runId?: string | undefined;
+    forwardedProps?: Record<string, unknown> | undefined;
+    model?: string | undefined;
+    maxOutputTokens?: number | undefined;
+} & {
+    threadId: string;
+    runId: string;
+}>;
+/** @deprecated Use getAgUiDetachedStartAcceptedSchema() */
+export declare const AgUiDetachedStartAcceptedSchema: import("../../internal-agents/schema.js").Schema<import("../../extensions/schema/schema-validator.js").InferShape<{
+    accepted: import("../../internal-agents/schema.js").Schema<true>;
+    duplicate: import("../../internal-agents/schema.js").Schema<boolean>;
+    runId: import("../../internal-agents/schema.js").Schema<string>;
+    threadId: import("../../internal-agents/schema.js").Schema<string>;
+}>>;
+export type AgUiDetachedStartRequest = InferSchema<ReturnType<typeof getAgUiDetachedStartRequestSchema>>;
+export type AgUiDetachedStartAccepted = InferSchema<ReturnType<typeof getAgUiDetachedStartAcceptedSchema>>;
+export declare function buildDetachedAgUiStartRequest(input: {
+    runId: string;
+    threadId: string;
+    messages: ChatUiMessage[];
+    model?: string;
+    forwardedProps?: Record<string, unknown>;
+    createThreadId?: () => string;
+}): AgUiDetachedStartRequest;
+export interface ExecuteAgUiDetachedStartInput {
+    request: AgUiDetachedStartRequest;
+    rawRequest?: Request;
+    requestOrCtx?: unknown;
+    context?: Record<string, unknown>;
+}
+interface AgUiDetachedStartExecutionInput {
+    request: AgUiDetachedStartRequest;
+    requestOrCtx: unknown;
+    rawRequest: Request;
+    context: Record<string, unknown>;
+    abortSignal: AbortSignal;
+}
+type AgUiDetachedExecutionStarter = (input: AgUiDetachedStartExecutionInput) => Promise<void> | void;
+interface AgUiDetachedStartHandlerOptionsBase {
+    sessionManager: RunResumeSessionManager<AgUiResumeValue>;
+    context?: AgUiContextValue;
+    startDetachedExecution?: AgUiDetachedExecutionStarter;
+    onAccepted?: (input: {
+        request: AgUiDetachedStartRequest;
+        runId: string;
+        threadId: string;
+    }) => Promise<void> | void;
+    onDuplicate?: (input: {
+        request: AgUiDetachedStartRequest;
+        runId: string;
+        threadId: string;
+    }) => Promise<void> | void;
+    onFinish?: (input: {
+        runId: string;
+        threadId: string;
+    }) => Promise<void> | void;
+    onError?: (input: {
+        runId: string;
+        threadId: string;
+        error: unknown;
+    }) => Promise<void> | void;
+}
+export type AgUiDetachedStartHandlerOptions = (AgUiDetachedStartHandlerOptionsBase & {
+    agent: Agent;
+}) | (AgUiDetachedStartHandlerOptionsBase & {
+    agent?: undefined;
+    startDetachedExecution: AgUiDetachedExecutionStarter;
+});
+export declare function executeAgUiDetachedStart(options: AgUiDetachedStartHandlerOptions, input: ExecuteAgUiDetachedStartInput): Promise<Response>;
+export declare function createAgUiDetachedStartHandler(options: AgUiDetachedStartHandlerOptions): (requestOrCtx: unknown) => Promise<Response>;
+export {};
+//# sourceMappingURL=detached-start.d.ts.map

package/esm/src/agent/ag-ui/detached-start.d.ts.map

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

package/esm/src/agent/ag-ui/detached-start.js

@@ -0,0 +1,256 @@
+import * as dntShim from "../../../_dnt.shims.js";
+import { defineSchema } from "../../schemas/index.js";
+import { INVALID_ARGUMENT } from "../../errors/index.js";
+import { streamDataStreamEvents } from "../data-stream.js";
+import { getAgUiRequestSchema, normalizeAgUiMessages } from "./host-support.js";
+import { extractRequest } from "./request-shared.js";
+import { buildMergedAgUiTools } from "./tool-shared.js";
+import { AgentRuntime, RunAlreadyExistsError, } from "../runtime/index.js";
+const AGENT_ID_PATTERN = /^[a-zA-Z0-9_-]+$/;
+const getAgUiDetachedRunIdSchema = defineSchema((v) => v.string().min(1).max(128).regex(AGENT_ID_PATTERN));
+function buildStreamContext(request, baseContext, threadId, runId) {
+    return {
+        ...baseContext,
+        threadId,
+        runId,
+        agUi: {
+            context: request.context,
+            forwardedProps: request.forwardedProps,
+        },
+    };
+}
+function buildMergedTools(agent, request, sessionManager) {
+    return buildMergedAgUiTools(agent, request.runId, request.tools, sessionManager);
+}
+function scheduleDetachedTask(requestOrCtx, task) {
+    if (typeof requestOrCtx === "object" &&
+        requestOrCtx !== null &&
+        "waitUntil" in requestOrCtx &&
+        typeof requestOrCtx.waitUntil === "function") {
+        (requestOrCtx.waitUntil)(task);
+        return;
+    }
+    void task;
+}
+async function drainRuntimeStream(stream) {
+    for await (const _event of streamDataStreamEvents(stream)) {
+        continue;
+    }
+}
+export const getAgUiDetachedStartRequestSchema = defineSchema((v) => getAgUiRequestSchema().extend({
+    threadId: v.string().uuid(),
+    runId: getAgUiDetachedRunIdSchema(),
+}));
+export const getAgUiDetachedStartAcceptedSchema = defineSchema((v) => v.object({
+    accepted: v.literal(true),
+    duplicate: v.boolean(),
+    runId: getAgUiDetachedRunIdSchema(),
+    threadId: v.string().uuid(),
+}));
+/** @deprecated Use getAgUiDetachedStartRequestSchema() */
+export const AgUiDetachedStartRequestSchema = getAgUiDetachedStartRequestSchema();
+/** @deprecated Use getAgUiDetachedStartAcceptedSchema() */
+export const AgUiDetachedStartAcceptedSchema = getAgUiDetachedStartAcceptedSchema();
+function toDetachedAgUiMessageMetadata(metadata) {
+    if (!metadata) {
+        return undefined;
+    }
+    const normalizedMetadata = {
+        ...(metadata.modelId ? { modelId: metadata.modelId } : {}),
+        ...(metadata.usage
+            ? {
+                usage: {
+                    ...(metadata.usage.inputTokens !== undefined
+                        ? { inputTokens: metadata.usage.inputTokens }
+                        : {}),
+                    ...(metadata.usage.outputTokens !== undefined
+                        ? { outputTokens: metadata.usage.outputTokens }
+                        : {}),
+                    ...(metadata.usage.cachedInputTokens !== undefined
+                        ? { cachedInputTokens: metadata.usage.cachedInputTokens }
+                        : {}),
+                },
+            }
+            : {}),
+    };
+    return Object.keys(normalizedMetadata).length > 0 ? normalizedMetadata : undefined;
+}
+export function buildDetachedAgUiStartRequest(input) {
+    const isValidUuid = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i
+        .test(input.threadId);
+    const effectiveThreadId = isValidUuid
+        ? input.threadId
+        : (input.createThreadId?.() ?? dntShim.crypto.randomUUID());
+    const effectiveMessages = input.messages.length > 0
+        ? input.messages.map((message) => {
+            const metadata = toDetachedAgUiMessageMetadata(message.metadata);
+            return {
+                id: message.id,
+                role: message.role,
+                parts: message.parts,
+                ...(metadata ? { metadata } : {}),
+            };
+        })
+        : [
+            {
+                id: `${input.runId}:placeholder`,
+                role: "user",
+                parts: [{ type: "text", text: "" }],
+            },
+        ];
+    return {
+        runId: input.runId,
+        threadId: effectiveThreadId,
+        messages: effectiveMessages,
+        tools: [],
+        context: [],
+        ...(input.model ? { model: input.model } : {}),
+        ...(input.forwardedProps ? { forwardedProps: input.forwardedProps } : {}),
+    };
+}
+async function startDefaultDetachedExecution(input) {
+    const runtime = new AgentRuntime(input.agent.id, {
+        ...input.agent.config,
+        tools: buildMergedTools(input.agent, input.request, input.sessionManager),
+    });
+    const runtimeStream = await runtime.stream(normalizeAgUiMessages(input.request.messages), buildStreamContext(input.request, input.context, input.request.threadId, input.request.runId), undefined, input.request.model, input.request.maxOutputTokens, input.abortSignal);
+    await drainRuntimeStream(runtimeStream);
+}
+async function resolveDetachedStartContext(options, input) {
+    if (input.context) {
+        return input.context;
+    }
+    if (!options.context) {
+        return {};
+    }
+    if (typeof options.context === "function") {
+        if (!input.rawRequest) {
+            throw INVALID_ARGUMENT.create({
+                detail: "executeAgUiDetachedStart requires rawRequest when options.context is a function.",
+            });
+        }
+        return await options.context(input.rawRequest);
+    }
+    return options.context;
+}
+function assertDetachedStartRawRequest(options, input) {
+    if (!options.startDetachedExecution) {
+        return input.rawRequest;
+    }
+    if (input.rawRequest) {
+        return input.rawRequest;
+    }
+    throw INVALID_ARGUMENT.create({
+        detail: "executeAgUiDetachedStart requires rawRequest when options.startDetachedExecution is used.",
+    });
+}
+export async function executeAgUiDetachedStart(options, input) {
+    const rawRequest = assertDetachedStartRawRequest(options, input);
+    const context = await resolveDetachedStartContext(options, input);
+    try {
+        const abortSignal = options.sessionManager.startRun({
+            runId: input.request.runId,
+            threadId: input.request.threadId,
+        });
+        await options.onAccepted?.({
+            request: input.request,
+            runId: input.request.runId,
+            threadId: input.request.threadId,
+        });
+        const detachedTask = (async () => {
+            try {
+                if (options.startDetachedExecution) {
+                    await options.startDetachedExecution({
+                        request: input.request,
+                        requestOrCtx: input.requestOrCtx,
+                        rawRequest: rawRequest,
+                        context,
+                        abortSignal,
+                    });
+                }
+                else if (options.agent) {
+                    await startDefaultDetachedExecution({
+                        agent: options.agent,
+                        request: input.request,
+                        context,
+                        abortSignal,
+                        sessionManager: options.sessionManager,
+                    });
+                }
+                else {
+                    throw new Error("Detached AG-UI start configuration became invalid during execution.");
+                }
+                options.sessionManager.completeRun(input.request.runId);
+                await options.onFinish?.({
+                    runId: input.request.runId,
+                    threadId: input.request.threadId,
+                });
+            }
+            catch (error) {
+                options.sessionManager.failRun(input.request.runId);
+                await options.onError?.({
+                    runId: input.request.runId,
+                    threadId: input.request.threadId,
+                    error,
+                });
+            }
+        })().catch(() => undefined);
+        scheduleDetachedTask(input.requestOrCtx, detachedTask);
+        return Response.json({
+            accepted: true,
+            duplicate: false,
+            runId: input.request.runId,
+            threadId: input.request.threadId,
+        }, { status: 202 });
+    }
+    catch (error) {
+        if (error instanceof RunAlreadyExistsError) {
+            await options.onDuplicate?.({
+                request: input.request,
+                runId: input.request.runId,
+                threadId: input.request.threadId,
+            });
+            return Response.json({
+                accepted: true,
+                duplicate: true,
+                runId: input.request.runId,
+                threadId: input.request.threadId,
+            }, { status: 202 });
+        }
+        options.sessionManager.failRun(input.request.runId);
+        throw error;
+    }
+}
+export function createAgUiDetachedStartHandler(options) {
+    if (!options.agent && !options.startDetachedExecution) {
+        throw new Error("Detached AG-UI start requires either an agent or startDetachedExecution handler.");
+    }
+    return async function POST(requestOrCtx) {
+        const request = extractRequest(requestOrCtx);
+        try {
+            const parsed = getAgUiDetachedStartRequestSchema().parse(await request.json());
+            return await executeAgUiDetachedStart(options, {
+                request: parsed,
+                rawRequest: request,
+                requestOrCtx,
+            });
+        }
+        catch (error) {
+            if (error instanceof Error &&
+                "issues" in error &&
+                Array.isArray(error.issues)) {
+                const issues = error.issues;
+                return Response.json({
+                    error: "Invalid AG-UI detached start request",
+                    details: issues.map((issue) => ({
+                        path: issue.path,
+                        message: issue.message,
+                    })),
+                }, { status: 400 });
+            }
+            return Response.json({
+                error: error instanceof Error ? error.message : "Internal detached start failed",
+            }, { status: 500 });
+        }
+    };
+}

package/esm/src/agent/ag-ui/forwarded-context.d.ts

@@ -0,0 +1,14 @@
+import type { Schema } from "../../extensions/schema/index.js";
+import type { AgUiRuntimeRequest } from "../runtime/ag-ui-contract.js";
+export type AgUiForwardedConfigOptions<TConfig> = {
+    schema: Schema<TConfig>;
+    namespace?: string;
+};
+export declare function createAgUiRuntimeContextMap(input: Pick<AgUiRuntimeRequest, "context">): Map<string, string>;
+export declare function parseAgUiContextJsonValue(raw: string | undefined): unknown;
+export declare function parseAgUiContextString(raw: string | undefined): string | undefined;
+export declare function parseAgUiContextNullableString(raw: string | undefined): string | null | undefined;
+export declare function parseAgUiContextBoolean(raw: string | undefined): boolean | undefined;
+export declare function parseAgUiContextSchema<TValue>(raw: string | undefined, schema: Schema<TValue>): TValue | undefined;
+export declare function deriveAgUiForwardedConfig<TConfig>(input: Pick<AgUiRuntimeRequest, "forwardedProps">, options: AgUiForwardedConfigOptions<TConfig>): TConfig | undefined;
+//# sourceMappingURL=forwarded-context.d.ts.map

package/esm/src/agent/ag-ui/forwarded-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forwarded-context.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/ag-ui/forwarded-context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAC;AAC/D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAEvE,MAAM,MAAM,0BAA0B,CAAC,OAAO,IAAI;IAChD,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,IAAI,CAAC,kBAAkB,EAAE,SAAS,CAAC,GACzC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAUrB;AAED,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAU1E;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAGlF;AAED,wBAAgB,8BAA8B,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAOjG;AAED,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAGpF;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAC3C,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,GACrB,MAAM,GAAG,SAAS,CAIpB;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAC/C,KAAK,EAAE,IAAI,CAAC,kBAAkB,EAAE,gBAAgB,CAAC,EACjD,OAAO,EAAE,0BAA0B,CAAC,OAAO,CAAC,GAC3C,OAAO,GAAG,SAAS,CAgBrB"}

package/esm/src/agent/ag-ui/forwarded-context.js

@@ -0,0 +1,56 @@
+import { defineSchema } from "../../schemas/index.js";
+export function createAgUiRuntimeContextMap(input) {
+    const contextMap = new Map();
+    for (const entry of input.context) {
+        if ("description" in entry) {
+            contextMap.set(entry.description, entry.value);
+        }
+    }
+    return contextMap;
+}
+export function parseAgUiContextJsonValue(raw) {
+    if (raw === undefined) {
+        return undefined;
+    }
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return raw;
+    }
+}
+export function parseAgUiContextString(raw) {
+    const parsed = parseAgUiContextJsonValue(raw);
+    return typeof parsed === "string" && parsed.trim().length > 0 ? parsed : undefined;
+}
+export function parseAgUiContextNullableString(raw) {
+    const parsed = parseAgUiContextJsonValue(raw);
+    if (parsed === null) {
+        return null;
+    }
+    return typeof parsed === "string" && parsed.trim().length > 0 ? parsed : undefined;
+}
+export function parseAgUiContextBoolean(raw) {
+    const parsed = parseAgUiContextJsonValue(raw);
+    return typeof parsed === "boolean" ? parsed : undefined;
+}
+export function parseAgUiContextSchema(raw, schema) {
+    const parsed = parseAgUiContextJsonValue(raw);
+    const result = schema.safeParse(parsed);
+    return result.success ? result.data : undefined;
+}
+export function deriveAgUiForwardedConfig(input, options) {
+    const getRecordSchema = defineSchema((v) => v.record(v.string(), v.unknown()));
+    const forwardedProps = getRecordSchema().safeParse(input.forwardedProps);
+    if (!forwardedProps.success) {
+        return undefined;
+    }
+    if (options.namespace) {
+        const nestedConfig = options.schema.safeParse(forwardedProps.data[options.namespace]);
+        if (nestedConfig.success) {
+            return nestedConfig.data;
+        }
+    }
+    const rootConfig = options.schema.safeParse(forwardedProps.data);
+    return rootConfig.success ? rootConfig.data : undefined;
+}

package/esm/src/agent/ag-ui/handler.d.ts

@@ -0,0 +1,14 @@
+import type { Agent } from "../types.js";
+import { type RunResumeSessionManager } from "../runtime/index.js";
+import { type AgUiResumeValue } from "./tool-shared.js";
+export { type AgUiContextItem, AgUiContextItemSchema, type AgUiInjectedTool, AgUiInjectedToolSchema, type AgUiRequest, AgUiRequestSchema, } from "./host-support.js";
+export interface AgUiHandlerOptions {
+    context?: Record<string, unknown> | ((request: Request) => Record<string, unknown> | Promise<Record<string, unknown>>);
+    sessionManager?: RunResumeSessionManager<AgUiResumeValue>;
+}
+export interface AgUiHandlerConfigWithAgent extends AgUiHandlerOptions {
+    agent: Agent;
+}
+export declare function createAgUiHandler(agentId: string, options?: AgUiHandlerOptions): (requestOrCtx: unknown) => Promise<Response>;
+export declare function createAgUiHandler(config: AgUiHandlerConfigWithAgent, options?: AgUiHandlerOptions): (requestOrCtx: unknown) => Promise<Response>;
+//# sourceMappingURL=handler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/ag-ui/handler.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAGL,KAAK,uBAAuB,EAC7B,MAAM,qBAAqB,CAAC;AAc7B,OAAO,EAAE,KAAK,eAAe,EAAwB,MAAM,kBAAkB,CAAC;AAE9E,OAAO,EACL,KAAK,eAAe,EACpB,qBAAqB,EACrB,KAAK,gBAAgB,EACrB,sBAAsB,EACtB,KAAK,WAAW,EAChB,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AA8O3B,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EACJ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACvB,CAAC,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACvF,cAAc,CAAC,EAAE,uBAAuB,CAAC,eAAe,CAAC,CAAC;CAC3D;AAED,MAAM,WAAW,0BAA2B,SAAQ,kBAAkB;IACpE,KAAK,EAAE,KAAK,CAAC;CACd;AAUD,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,kBAAkB,GAC3B,CAAC,YAAY,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAChD,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,0BAA0B,EAClC,OAAO,CAAC,EAAE,kBAAkB,GAC3B,CAAC,YAAY,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC"}