veryfront 0.1.152 → 0.1.154

package/esm/deno.js

@@ -1,6 +1,6 @@
 export default {
     "name": "veryfront",
-    "version": "0.1.152",
+    "version": "0.1.154",
     "license": "Apache-2.0",
     "nodeModulesDir": "auto",
     "exclude": [

package/esm/src/agent/ag-ui-run-control.d.ts

@@ -0,0 +1,33 @@
+import * as dntShim from "../../_dnt.shims.js";
+import { z } from "zod";
+import { RunResumeSessionManager } from "./runtime/resume-session.js";
+export declare const AgUiResumeSignalSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"tool_result">;
+    toolCallId: z.ZodString;
+    result: z.ZodUnknown;
+    isError: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, z.core.$strip>], "type">;
+export type AgUiResumeSignal = z.infer<typeof AgUiResumeSignalSchema>;
+type ResumeValue = {
+    result: unknown;
+    isError: boolean;
+};
+export interface AgUiRunControlHandlerOptions {
+    resolveRunId?: ((input: {
+        request: dntShim.Request;
+        requestOrCtx: unknown;
+    }) => string | null) | ((input: {
+        request: dntShim.Request;
+        requestOrCtx: unknown;
+    }) => Promise<string | null>);
+}
+export interface AgUiResumeHandlerOptions extends AgUiRunControlHandlerOptions {
+    sessionManager: RunResumeSessionManager<ResumeValue>;
+}
+export interface AgUiCancelHandlerOptions<T = unknown> extends AgUiRunControlHandlerOptions {
+    sessionManager: RunResumeSessionManager<T>;
+}
+export declare function createAgUiResumeHandler(options: AgUiResumeHandlerOptions): (requestOrCtx: unknown) => Promise<dntShim.Response>;
+export declare function createAgUiCancelHandler<T = unknown>(options: AgUiCancelHandlerOptions<T>): (requestOrCtx: unknown) => Promise<dntShim.Response>;
+export {};
+//# sourceMappingURL=ag-ui-run-control.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ag-ui-run-control.d.ts","sourceRoot":"","sources":["../../../src/src/agent/ag-ui-run-control.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAEL,uBAAuB,EAGxB,MAAM,6BAA6B,CAAC;AAKrC,eAAO,MAAM,sBAAsB;;;;;2BAOjC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,KAAK,WAAW,GAAG;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAgCF,MAAM,WAAW,4BAA4B;IAC3C,YAAY,CAAC,EACT,CAAC,CAAC,KAAK,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC;QAAC,YAAY,EAAE,OAAO,CAAA;KAAE,KAAK,MAAM,GAAG,IAAI,CAAC,GAC/E,CAAC,CAAC,KAAK,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC;QAAC,YAAY,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC;CAC9F;AAED,MAAM,WAAW,wBAAyB,SAAQ,4BAA4B;IAC5E,cAAc,EAAE,uBAAuB,CAAC,WAAW,CAAC,CAAC;CACtD;AAED,MAAM,WAAW,wBAAwB,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,4BAA4B;IACzF,cAAc,EAAE,uBAAuB,CAAC,CAAC,CAAC,CAAC;CAC5C;AAaD,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,wBAAwB,GAChC,CAAC,YAAY,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAsDtD;AAED,wBAAgB,uBAAuB,CAAC,CAAC,GAAG,OAAO,EACjD,OAAO,EAAE,wBAAwB,CAAC,CAAC,CAAC,GACnC,CAAC,YAAY,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAgBtD"}

package/esm/src/agent/ag-ui-run-control.js

@@ -0,0 +1,102 @@
+import * as dntShim from "../../_dnt.shims.js";
+import { z } from "zod";
+import { INVALID_ARGUMENT } from "../errors/index.js";
+import { RunNotActiveError, WaitConflictError, WaitNotPendingError, } from "./runtime/resume-session.js";
+const RESUME_PATH_REGEX = /^\/api\/ag-ui\/runs\/([^/]+)\/resume$/;
+const CANCEL_PATH_REGEX = /^\/api\/ag-ui\/runs\/([^/]+)$/;
+export const AgUiResumeSignalSchema = z.discriminatedUnion("type", [
+    z.object({
+        type: z.literal("tool_result"),
+        toolCallId: z.string().min(1).max(128),
+        result: z.unknown(),
+        isError: z.boolean().optional().default(false),
+    }),
+]);
+function isRequest(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "json" in value &&
+        typeof value.json === "function" &&
+        "url" in value &&
+        typeof value.url === "string" &&
+        "method" in value &&
+        typeof value.method === "string");
+}
+function extractRequest(requestOrCtx) {
+    if (isRequest(requestOrCtx))
+        return requestOrCtx;
+    if (typeof requestOrCtx === "object" && requestOrCtx !== null && "request" in requestOrCtx) {
+        const candidate = requestOrCtx.request;
+        if (isRequest(candidate))
+            return candidate;
+    }
+    throw INVALID_ARGUMENT.create({
+        detail: "Invalid handler argument: expected Request or APIContext",
+    });
+}
+function getRunId(pathname, regex) {
+    return regex.exec(pathname)?.[1] ?? null;
+}
+async function resolveRunId(requestOrCtx, request, options, regex) {
+    const explicit = await options?.resolveRunId?.({ request, requestOrCtx });
+    if (explicit)
+        return explicit;
+    return getRunId(new URL(request.url).pathname, regex);
+}
+export function createAgUiResumeHandler(options) {
+    return async function POST(requestOrCtx) {
+        const request = extractRequest(requestOrCtx);
+        const runId = await resolveRunId(requestOrCtx, request, options, RESUME_PATH_REGEX);
+        if (!runId) {
+            return dntShim.Response.json({ error: "Run not found" }, { status: 404 });
+        }
+        try {
+            const parsed = AgUiResumeSignalSchema.parse(await request.json());
+            const outcome = options.sessionManager.submitSignal(runId, {
+                waitKey: parsed.toolCallId,
+                value: {
+                    result: parsed.result,
+                    isError: parsed.isError,
+                },
+            });
+            return dntShim.Response.json(outcome, { status: 200 });
+        }
+        catch (error) {
+            if (error instanceof z.ZodError) {
+                return dntShim.Response.json({
+                    error: "Invalid AG-UI resume request",
+                    details: error.issues.map((issue) => ({
+                        path: issue.path,
+                        message: issue.message,
+                    })),
+                }, { status: 400 });
+            }
+            if (error instanceof WaitConflictError) {
+                return dntShim.Response.json({ error: "TOOL_RESULT_CONFLICT" }, { status: 409 });
+            }
+            if (error instanceof WaitNotPendingError) {
+                return dntShim.Response.json({ error: "TOOL_RESULT_NOT_WAITING" }, { status: 409 });
+            }
+            if (error instanceof RunNotActiveError) {
+                return dntShim.Response.json({ error: "RUN_NOT_ACTIVE" }, { status: 410 });
+            }
+            return dntShim.Response.json({
+                error: error instanceof Error ? error.message : "Internal resume failed",
+            }, { status: 500 });
+        }
+    };
+}
+export function createAgUiCancelHandler(options) {
+    return async function DELETE(requestOrCtx) {
+        const request = extractRequest(requestOrCtx);
+        const runId = await resolveRunId(requestOrCtx, request, options, CANCEL_PATH_REGEX);
+        if (!runId) {
+            return dntShim.Response.json({ error: "Run not found" }, { status: 404 });
+        }
+        const accepted = options.sessionManager.cancelRun(runId);
+        if (accepted) {
+            return dntShim.Response.json({ accepted: true }, { status: 202 });
+        }
+        return new dntShim.Response(null, { status: 204 });
+    };
+}

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

@@ -85,6 +85,7 @@ export { BufferMemory, ConversationMemory, createMemory, createRedisMemory, type
 export { agentAsTool, createWorkflow, getAgent, getAgentsAsTools, getAllAgentIds, registerAgent, type WorkflowConfig, type WorkflowResult, type WorkflowStep, } from "./composition/index.js";
 export { agent } from "./factory.js";
 export { type AgUiRuntimeContextItem, AgUiRuntimeContextItemSchema, type AgUiRuntimeInjectedTool, AgUiRuntimeInjectedToolSchema, type AgUiRuntimeMessage, AgUiRuntimeMessageSchema, type AgUiRuntimeRequest, AgUiRuntimeRequestSchema, } from "./runtime-ag-ui-contract.js";
+export { type AgUiCancelHandlerOptions, type AgUiResumeHandlerOptions, type AgUiResumeSignal, AgUiResumeSignalSchema, createAgUiCancelHandler, createAgUiResumeHandler, } from "./ag-ui-run-control.js";
 export { type AgUiContextItem, type AgUiHandlerConfigWithAgent, type AgUiHandlerOptions, type AgUiInjectedTool, type AgUiRequest, AgUiRequestSchema, createAgUiHandler, } from "./ag-ui-handler.js";
 export { type ChatHandlerBeforeStream, type ChatHandlerBeforeStreamContext, type ChatHandlerBeforeStreamResult, type ChatHandlerConfigWithAgent, type ChatHandlerMessageInput, type ChatHandlerOptions, createChatHandler, } from "./chat-handler.js";
 export { AgentRuntime, RunAlreadyExistsError, RunCancelledError, RunNotActiveError, RunResumeSessionManager, type RunResumeSessionManagerOptions, type RunSessionStatus, type SubmitResumeValueOutcome, WaitConflictError, WaitNotPendingError, } from "./runtime/index.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":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+EG;AACH,OAAO,yBAAyB,CAAC;AAGjC,YAAY,EACV,KAAK,EACL,WAAW,EACX,YAAY,EACZ,eAAe,EACf,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,YAAY,EACZ,OAAO,IAAI,YAAY,EACvB,WAAW,EACX,aAAa,EACb,WAAW,EACX,mBAAmB,EACnB,cAAc,EACd,QAAQ,EACR,YAAY,EACZ,oBAAoB,EACpB,qBAAqB,EACrB,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEnF,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,YAAY,EACZ,iBAAiB,EACjB,KAAK,MAAM,EACX,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,WAAW,EACX,KAAK,iBAAiB,EACtB,aAAa,GACd,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,WAAW,EACX,cAAc,EACd,QAAQ,EACR,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,YAAY,GAClB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AACrC,OAAO,EACL,KAAK,sBAAsB,EAC3B,4BAA4B,EAC5B,KAAK,uBAAuB,EAC5B,6BAA6B,EAC7B,KAAK,kBAAkB,EACvB,wBAAwB,EACxB,KAAK,kBAAkB,EACvB,wBAAwB,GACzB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,0BAA0B,EAC/B,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,KAAK,uBAAuB,EAC5B,KAAK,8BAA8B,EACnC,KAAK,6BAA6B,EAClC,KAAK,0BAA0B,EAC/B,KAAK,uBAAuB,EAC5B,KAAK,kBAAkB,EACvB,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EACjB,uBAAuB,EACvB,KAAK,8BAA8B,EACnC,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,EAC7B,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/src/agent/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+EG;AACH,OAAO,yBAAyB,CAAC;AAGjC,YAAY,EACV,KAAK,EACL,WAAW,EACX,YAAY,EACZ,eAAe,EACf,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,YAAY,EACZ,OAAO,IAAI,YAAY,EACvB,WAAW,EACX,aAAa,EACb,WAAW,EACX,mBAAmB,EACnB,cAAc,EACd,QAAQ,EACR,YAAY,EACZ,oBAAoB,EACpB,qBAAqB,EACrB,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEnF,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,YAAY,EACZ,iBAAiB,EACjB,KAAK,MAAM,EACX,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,WAAW,EACX,KAAK,iBAAiB,EACtB,aAAa,GACd,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,WAAW,EACX,cAAc,EACd,QAAQ,EACR,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,YAAY,GAClB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AACrC,OAAO,EACL,KAAK,sBAAsB,EAC3B,4BAA4B,EAC5B,KAAK,uBAAuB,EAC5B,6BAA6B,EAC7B,KAAK,kBAAkB,EACvB,wBAAwB,EACxB,KAAK,kBAAkB,EACvB,wBAAwB,GACzB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,KAAK,wBAAwB,EAC7B,KAAK,wBAAwB,EAC7B,KAAK,gBAAgB,EACrB,sBAAsB,EACtB,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,0BAA0B,EAC/B,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,KAAK,uBAAuB,EAC5B,KAAK,8BAA8B,EACnC,KAAK,6BAA6B,EAClC,KAAK,0BAA0B,EAC/B,KAAK,uBAAuB,EAC5B,KAAK,kBAAkB,EACvB,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EACjB,uBAAuB,EACvB,KAAK,8BAA8B,EACnC,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,EAC7B,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC"}

package/esm/src/agent/index.js

@@ -84,6 +84,7 @@ export { BufferMemory, ConversationMemory, createMemory, createRedisMemory, Redi
 export { agentAsTool, createWorkflow, getAgent, getAgentsAsTools, getAllAgentIds, registerAgent, } from "./composition/index.js";
 export { agent } from "./factory.js";
 export { AgUiRuntimeContextItemSchema, AgUiRuntimeInjectedToolSchema, AgUiRuntimeMessageSchema, AgUiRuntimeRequestSchema, } from "./runtime-ag-ui-contract.js";
+export { AgUiResumeSignalSchema, createAgUiCancelHandler, createAgUiResumeHandler, } from "./ag-ui-run-control.js";
 export { AgUiRequestSchema, createAgUiHandler, } from "./ag-ui-handler.js";
 export { createChatHandler, } from "./chat-handler.js";
 export { AgentRuntime, RunAlreadyExistsError, RunCancelledError, RunNotActiveError, RunResumeSessionManager, WaitConflictError, WaitNotPendingError, } from "./runtime/index.js";

package/esm/src/agent/runtime/chat-stream-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chat-stream-handler.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/runtime/chat-stream-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAqB,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAUtF,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAC1C,WAAW,EAAE,mBAAmB,EAAE,CAAC;IACnC,KAAK,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;CAChF;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE;QAChB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,KAAK,IAAI,CAAC;CACZ;AA6HD,wBAAgB,iBAAiB,IAAI,eAAe,CAQnD;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,mBAAmB,EAC3B,KAAK,EAAE,eAAe,EACtB,UAAU,EAAE,+BAA+B,EAC3C,OAAO,EAAE,WAAW,EACpB,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,SAAS,CAAC,EAAE,mBAAmB,EAC/B,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,IAAI,CAAC,CA0Nf"}
+{"version":3,"file":"chat-stream-handler.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/runtime/chat-stream-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAqB,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAWtF,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAC1C,WAAW,EAAE,mBAAmB,EAAE,CAAC;IACnC,KAAK,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;CAChF;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE;QAChB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,KAAK,IAAI,CAAC;CACZ;AA4FD,wBAAgB,iBAAiB,IAAI,eAAe,CAQnD;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,mBAAmB,EAC3B,KAAK,EAAE,eAAe,EACtB,UAAU,EAAE,+BAA+B,EAC3C,OAAO,EAAE,WAAW,EACpB,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,SAAS,CAAC,EAAE,mBAAmB,EAC/B,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,IAAI,CAAC,CA0Nf"}

package/esm/src/agent/runtime/chat-stream-handler.js

@@ -13,6 +13,7 @@ import { serverLogger } from "../../utils/index.js";
 import { isAnyDebugEnabled } from "../../utils/constants/env.js";
 import { setActiveSpanAttributes, withSpan } from "../../observability/tracing/otlp-setup.js";
 import { getHostEnv } from "../../platform/compat/process.js";
+import { stringifyToolError, throwIfAborted } from "./error-utils.js";
 const logger = serverLogger.component("agent");
 function isRecord(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -40,31 +41,6 @@ function normalizeToolInputObject(input) {
     }
     return {};
 }
-function createAbortError(reason) {
-    if (reason instanceof Error) {
-        return reason;
-    }
-    return new DOMException(typeof reason === "string" && reason.length > 0 ? reason : "The operation was aborted", "AbortError");
-}
-function throwIfAborted(abortSignal) {
-    if (abortSignal?.aborted) {
-        throw createAbortError(abortSignal.reason);
-    }
-}
-function stringifyToolError(output) {
-    if (typeof output === "string" && output.length > 0) {
-        return output;
-    }
-    if (output instanceof Error && typeof output.message === "string" && output.message.length > 0) {
-        return output.message;
-    }
-    try {
-        return JSON.stringify(output);
-    }
-    catch {
-        return String(output);
-    }
-}
 function summarizeDebugValue(value) {
     if (value instanceof Error) {
         return {

package/esm/src/agent/runtime/error-utils.d.ts

@@ -0,0 +1,4 @@
+export declare function createAbortError(reason?: unknown): Error;
+export declare function throwIfAborted(abortSignal?: AbortSignal): void;
+export declare function stringifyToolError(error: unknown): string;
+//# sourceMappingURL=error-utils.d.ts.map

package/esm/src/agent/runtime/error-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-utils.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/runtime/error-utils.ts"],"names":[],"mappings":"AAAA,wBAAgB,gBAAgB,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,KAAK,CASxD;AAED,wBAAgB,cAAc,CAAC,WAAW,CAAC,EAAE,WAAW,GAAG,IAAI,CAI9D;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAczD"}

package/esm/src/agent/runtime/error-utils.js

@@ -0,0 +1,25 @@
+export function createAbortError(reason) {
+    if (reason instanceof Error) {
+        return reason;
+    }
+    return new DOMException(typeof reason === "string" && reason.length > 0 ? reason : "The operation was aborted", "AbortError");
+}
+export function throwIfAborted(abortSignal) {
+    if (abortSignal?.aborted) {
+        throw createAbortError(abortSignal.reason);
+    }
+}
+export function stringifyToolError(error) {
+    if (typeof error === "string" && error.length > 0) {
+        return error;
+    }
+    if (error instanceof Error && typeof error.message === "string" && error.message.length > 0) {
+        return error.message;
+    }
+    try {
+        return JSON.stringify(error);
+    }
+    catch {
+        return String(error);
+    }
+}

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

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

package/esm/src/agent/runtime/index.js

@@ -39,39 +39,15 @@ import { executeConfiguredTool, getAvailableTools, isDynamicTool, parseToolArgs,
 import { accumulateUsage, getMaxSteps, normalizeInput } from "./input-utils.js";
 import { filterToolsForSkill, isToolAllowedBySkill, validateAllowedToolPatterns, } from "../../skill/allowed-tools.js";
 import { resolveConfiguredAgentModel, resolveRuntimeModel } from "./model-resolution.js";
+import { stringifyToolError, throwIfAborted } from "./error-utils.js";
 const logger = serverLogger.component("agent");
 const LOAD_SKILL_TOOL_ID = "load-skill";
-function createAbortError(reason) {
-    if (reason instanceof Error) {
-        return reason;
-    }
-    return new DOMException(typeof reason === "string" && reason.length > 0 ? reason : "The operation was aborted", "AbortError");
-}
-function throwIfAborted(abortSignal) {
-    if (abortSignal?.aborted) {
-        throw createAbortError(abortSignal.reason);
-    }
-}
 function isAbortError(error, abortSignal) {
     if (abortSignal?.aborted && error === abortSignal.reason) {
         return true;
     }
     return error instanceof DOMException && error.name === "AbortError";
 }
-function stringifyToolError(error) {
-    if (typeof error === "string" && error.length > 0) {
-        return error;
-    }
-    if (error instanceof Error && typeof error.message === "string" && error.message.length > 0) {
-        return error.message;
-    }
-    try {
-        return JSON.stringify(error);
-    }
-    catch {
-        return String(error);
-    }
-}
 function getToolResultError(result) {
     if (!result || typeof result !== "object" || !("error" in result)) {
         return undefined;

package/esm/src/routing/api/module-loader/loader.js

@@ -293,24 +293,32 @@ function createImportMapPlugin(projectDir, adapter, config) {
                 logger.debug(`Import map resolved: ${args.path} -> ${absolutePath}`);
                 return { path: absolutePath, namespace: "import-map" };
             });
-            build.onLoad({ filter: /.*/, namespace: "import-map" }, wrapWithCurrentContext(async (args) => {
-                try {
-                    const { filePath, contents } = await readFileWithExtensions(adapter, args.path, FILE_EXTENSIONS, projectDir);
-                    return {
-                        contents,
-                        loader: getLoaderForFile(filePath),
-                        resolveDir: pathHelper.dirname(filePath),
-                    };
-                }
-                catch (error) {
-                    const msg = error instanceof Error ? error.message : String(error);
-                    logger.error(`Failed to load file via import map: ${args.path}`, error);
-                    return { errors: [{ text: `Failed to load: ${msg}` }] };
-                }
+            build.onLoad({ filter: /.*/, namespace: "import-map" }, createNamespaceOnLoadHandler({
+                adapter,
+                projectDir,
+                errorLabel: "file via import map",
             }));
         },
     };
 }
+function createNamespaceOnLoadHandler(options) {
+    const { adapter, projectDir, errorLabel } = options;
+    return wrapWithCurrentContext(async (args) => {
+        try {
+            const { filePath, contents } = await readFileWithExtensions(adapter, args.path, FILE_EXTENSIONS, projectDir);
+            return {
+                contents,
+                loader: getLoaderForFile(filePath),
+                resolveDir: pathHelper.dirname(filePath),
+            };
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            logger.error(`Failed to load ${errorLabel}: ${args.path}`, error);
+            return { errors: [{ text: `Failed to load: ${msg}` }] };
+        }
+    });
+}
 /** Resolves relative imports through the adapter's virtual FS for remote projects. */
 function createAdapterResolvePlugin(adapter, projectDir) {
     return {
@@ -337,20 +345,10 @@ function createAdapterResolvePlugin(adapter, projectDir) {
             // callbacks fire from the child process message handler, losing the
             // AsyncLocalStorage store. Without this, MultiProjectFSAdapter.getAdapter()
             // cannot resolve the per-project adapter and all file reads fail silently.
-            build.onLoad({ filter: /.*/, namespace: "vf-adapter" }, wrapWithCurrentContext(async (args) => {
-                try {
-                    const { filePath, contents } = await readFileWithExtensions(adapter, args.path, FILE_EXTENSIONS, projectDir);
-                    return {
-                        contents,
-                        loader: getLoaderForFile(filePath),
-                        resolveDir: pathHelper.dirname(filePath),
-                    };
-                }
-                catch (error) {
-                    const msg = error instanceof Error ? error.message : String(error);
-                    logger.error(`Failed to load via adapter: ${args.path}`, error);
-                    return { errors: [{ text: `Failed to load: ${msg}` }] };
-                }
+            build.onLoad({ filter: /.*/, namespace: "vf-adapter" }, createNamespaceOnLoadHandler({
+                adapter,
+                projectDir,
+                errorLabel: "via adapter",
             }));
         },
     };

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

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.1.152";
+export declare const VERSION = "0.1.154";
 //# 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.152";
+export const VERSION = "0.1.154";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "veryfront",
-  "version": "0.1.152",
+  "version": "0.1.154",
   "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.152",
+  "version": "0.1.154",
   "license": "Apache-2.0",
   "nodeModulesDir": "auto",
   "exclude": [

package/src/src/agent/ag-ui-run-control.ts

@@ -0,0 +1,161 @@
+import * as dntShim from "../../_dnt.shims.js";
+import { z } from "zod";
+import { INVALID_ARGUMENT } from "../errors/index.js";
+import {
+  RunNotActiveError,
+  RunResumeSessionManager,
+  WaitConflictError,
+  WaitNotPendingError,
+} from "./runtime/resume-session.js";
+
+const RESUME_PATH_REGEX = /^\/api\/ag-ui\/runs\/([^/]+)\/resume$/;
+const CANCEL_PATH_REGEX = /^\/api\/ag-ui\/runs\/([^/]+)$/;
+
+export const AgUiResumeSignalSchema = z.discriminatedUnion("type", [
+  z.object({
+    type: z.literal("tool_result"),
+    toolCallId: z.string().min(1).max(128),
+    result: z.unknown(),
+    isError: z.boolean().optional().default(false),
+  }),
+]);
+
+export type AgUiResumeSignal = z.infer<typeof AgUiResumeSignalSchema>;
+
+type ResumeValue = {
+  result: unknown;
+  isError: boolean;
+};
+
+function isRequest(value: unknown): value is dntShim.Request {
+  return (
+    typeof value === "object" &&
+    value !== null &&
+    "json" in value &&
+    typeof value.json === "function" &&
+    "url" in value &&
+    typeof value.url === "string" &&
+    "method" in value &&
+    typeof value.method === "string"
+  );
+}
+
+function extractRequest(requestOrCtx: unknown): dntShim.Request {
+  if (isRequest(requestOrCtx)) return requestOrCtx;
+
+  if (typeof requestOrCtx === "object" && requestOrCtx !== null && "request" in requestOrCtx) {
+    const candidate = (requestOrCtx as Record<string, unknown>).request;
+    if (isRequest(candidate)) return candidate;
+  }
+
+  throw INVALID_ARGUMENT.create({
+    detail: "Invalid handler argument: expected Request or APIContext",
+  });
+}
+
+function getRunId(pathname: string, regex: RegExp): string | null {
+  return regex.exec(pathname)?.[1] ?? null;
+}
+
+export interface AgUiRunControlHandlerOptions {
+  resolveRunId?:
+    | ((input: { request: dntShim.Request; requestOrCtx: unknown }) => string | null)
+    | ((input: { request: dntShim.Request; requestOrCtx: unknown }) => Promise<string | null>);
+}
+
+export interface AgUiResumeHandlerOptions extends AgUiRunControlHandlerOptions {
+  sessionManager: RunResumeSessionManager<ResumeValue>;
+}
+
+export interface AgUiCancelHandlerOptions<T = unknown> extends AgUiRunControlHandlerOptions {
+  sessionManager: RunResumeSessionManager<T>;
+}
+
+async function resolveRunId(
+  requestOrCtx: unknown,
+  request: dntShim.Request,
+  options: AgUiRunControlHandlerOptions | undefined,
+  regex: RegExp,
+): Promise<string | null> {
+  const explicit = await options?.resolveRunId?.({ request, requestOrCtx });
+  if (explicit) return explicit;
+  return getRunId(new URL(request.url).pathname, regex);
+}
+
+export function createAgUiResumeHandler(
+  options: AgUiResumeHandlerOptions,
+): (requestOrCtx: unknown) => Promise<dntShim.Response> {
+  return async function POST(requestOrCtx: unknown): Promise<dntShim.Response> {
+    const request = extractRequest(requestOrCtx);
+    const runId = await resolveRunId(requestOrCtx, request, options, RESUME_PATH_REGEX);
+
+    if (!runId) {
+      return dntShim.Response.json({ error: "Run not found" }, { status: 404 });
+    }
+
+    try {
+      const parsed = AgUiResumeSignalSchema.parse(await request.json());
+      const outcome = options.sessionManager.submitSignal(runId, {
+        waitKey: parsed.toolCallId,
+        value: {
+          result: parsed.result,
+          isError: parsed.isError,
+        },
+      });
+
+      return dntShim.Response.json(outcome, { status: 200 });
+    } catch (error) {
+      if (error instanceof z.ZodError) {
+        return dntShim.Response.json(
+          {
+            error: "Invalid AG-UI resume request",
+            details: error.issues.map((issue) => ({
+              path: issue.path,
+              message: issue.message,
+            })),
+          },
+          { status: 400 },
+        );
+      }
+
+      if (error instanceof WaitConflictError) {
+        return dntShim.Response.json({ error: "TOOL_RESULT_CONFLICT" }, { status: 409 });
+      }
+
+      if (error instanceof WaitNotPendingError) {
+        return dntShim.Response.json({ error: "TOOL_RESULT_NOT_WAITING" }, { status: 409 });
+      }
+
+      if (error instanceof RunNotActiveError) {
+        return dntShim.Response.json({ error: "RUN_NOT_ACTIVE" }, { status: 410 });
+      }
+
+      return dntShim.Response.json(
+        {
+          error: error instanceof Error ? error.message : "Internal resume failed",
+        },
+        { status: 500 },
+      );
+    }
+  };
+}
+
+export function createAgUiCancelHandler<T = unknown>(
+  options: AgUiCancelHandlerOptions<T>,
+): (requestOrCtx: unknown) => Promise<dntShim.Response> {
+  return async function DELETE(requestOrCtx: unknown): Promise<dntShim.Response> {
+    const request = extractRequest(requestOrCtx);
+    const runId = await resolveRunId(requestOrCtx, request, options, CANCEL_PATH_REGEX);
+
+    if (!runId) {
+      return dntShim.Response.json({ error: "Run not found" }, { status: 404 });
+    }
+
+    const accepted = options.sessionManager.cancelRun(runId);
+    if (accepted) {
+      return dntShim.Response.json({ accepted: true }, { status: 202 });
+    }
+
+    return new dntShim.Response(null, { status: 204 });
+  };
+}

package/src/src/agent/index.ts

@@ -145,6 +145,14 @@ export {
   type AgUiRuntimeRequest,
   AgUiRuntimeRequestSchema,
 } from "./runtime-ag-ui-contract.js";
+export {
+  type AgUiCancelHandlerOptions,
+  type AgUiResumeHandlerOptions,
+  type AgUiResumeSignal,
+  AgUiResumeSignalSchema,
+  createAgUiCancelHandler,
+  createAgUiResumeHandler,
+} from "./ag-ui-run-control.js";
 export {
   type AgUiContextItem,
   type AgUiHandlerConfigWithAgent,

package/src/src/agent/runtime/chat-stream-handler.ts

@@ -15,6 +15,7 @@ import { serverLogger } from "../../utils/index.js";
 import { isAnyDebugEnabled } from "../../utils/constants/env.js";
 import { setActiveSpanAttributes, withSpan } from "../../observability/tracing/otlp-setup.js";
 import { getHostEnv } from "../../platform/compat/process.js";
+import { stringifyToolError, throwIfAborted } from "./error-utils.js";
 
 const logger = serverLogger.component("agent");
 
@@ -84,39 +85,6 @@ function normalizeToolInputObject(input: unknown): Record<string, unknown> {
   return {};
 }
 
-function createAbortError(reason?: unknown): Error {
-  if (reason instanceof Error) {
-    return reason;
-  }
-
-  return new DOMException(
-    typeof reason === "string" && reason.length > 0 ? reason : "The operation was aborted",
-    "AbortError",
-  );
-}
-
-function throwIfAborted(abortSignal?: AbortSignal): void {
-  if (abortSignal?.aborted) {
-    throw createAbortError(abortSignal.reason);
-  }
-}
-
-function stringifyToolError(output: unknown): string {
-  if (typeof output === "string" && output.length > 0) {
-    return output;
-  }
-
-  if (output instanceof Error && typeof output.message === "string" && output.message.length > 0) {
-    return output.message;
-  }
-
-  try {
-    return JSON.stringify(output);
-  } catch {
-    return String(output);
-  }
-}
-
 function summarizeDebugValue(value: unknown): unknown {
   if (value instanceof Error) {
     return {

package/src/src/agent/runtime/error-utils.ts

@@ -0,0 +1,32 @@
+export function createAbortError(reason?: unknown): Error {
+  if (reason instanceof Error) {
+    return reason;
+  }
+
+  return new DOMException(
+    typeof reason === "string" && reason.length > 0 ? reason : "The operation was aborted",
+    "AbortError",
+  );
+}
+
+export function throwIfAborted(abortSignal?: AbortSignal): void {
+  if (abortSignal?.aborted) {
+    throw createAbortError(abortSignal.reason);
+  }
+}
+
+export function stringifyToolError(error: unknown): string {
+  if (typeof error === "string" && error.length > 0) {
+    return error;
+  }
+
+  if (error instanceof Error && typeof error.message === "string" && error.message.length > 0) {
+    return error.message;
+  }
+
+  try {
+    return JSON.stringify(error);
+  } catch {
+    return String(error);
+  }
+}

package/src/src/agent/runtime/index.ts

@@ -100,6 +100,7 @@ import {
 } from "../../skill/allowed-tools.js";
 import { resolveConfiguredAgentModel, resolveRuntimeModel } from "./model-resolution.js";
 import type { RuntimeGenerateToolResult } from "./runtime-tool-types.js";
+import { stringifyToolError, throwIfAborted } from "./error-utils.js";
 
 const logger = serverLogger.component("agent");
 const LOAD_SKILL_TOOL_ID = "load-skill";
@@ -108,23 +109,6 @@ type RuntimeToolFilterConfig = AgentConfig & {
   __vfAllowedRemoteTools?: string[];
 };
 
-function createAbortError(reason?: unknown): Error {
-  if (reason instanceof Error) {
-    return reason;
-  }
-
-  return new DOMException(
-    typeof reason === "string" && reason.length > 0 ? reason : "The operation was aborted",
-    "AbortError",
-  );
-}
-
-function throwIfAborted(abortSignal?: AbortSignal): void {
-  if (abortSignal?.aborted) {
-    throw createAbortError(abortSignal.reason);
-  }
-}
-
 function isAbortError(error: unknown, abortSignal?: AbortSignal): boolean {
   if (abortSignal?.aborted && error === abortSignal.reason) {
     return true;
@@ -133,22 +117,6 @@ function isAbortError(error: unknown, abortSignal?: AbortSignal): boolean {
   return error instanceof DOMException && error.name === "AbortError";
 }
 
-function stringifyToolError(error: unknown): string {
-  if (typeof error === "string" && error.length > 0) {
-    return error;
-  }
-
-  if (error instanceof Error && typeof error.message === "string" && error.message.length > 0) {
-    return error.message;
-  }
-
-  try {
-    return JSON.stringify(error);
-  } catch {
-    return String(error);
-  }
-}
-
 function getToolResultError(result: unknown): string | undefined {
   if (!result || typeof result !== "object" || !("error" in result)) {
     return undefined;

package/src/src/routing/api/module-loader/loader.ts

@@ -355,31 +355,45 @@ function createImportMapPlugin(
 
       build.onLoad(
         { filter: /.*/, namespace: "import-map" },
-        wrapWithCurrentContext(async (args) => {
-          try {
-            const { filePath, contents } = await readFileWithExtensions(
-              adapter,
-              args.path,
-              FILE_EXTENSIONS,
-              projectDir,
-            );
-
-            return {
-              contents,
-              loader: getLoaderForFile(filePath),
-              resolveDir: pathHelper.dirname(filePath),
-            };
-          } catch (error) {
-            const msg = error instanceof Error ? error.message : String(error);
-            logger.error(`Failed to load file via import map: ${args.path}`, error);
-            return { errors: [{ text: `Failed to load: ${msg}` }] };
-          }
+        createNamespaceOnLoadHandler({
+          adapter,
+          projectDir,
+          errorLabel: "file via import map",
         }),
       );
     },
   };
 }
 
+function createNamespaceOnLoadHandler(options: {
+  adapter: RuntimeAdapter;
+  projectDir: string;
+  errorLabel: string;
+}) {
+  const { adapter, projectDir, errorLabel } = options;
+
+  return wrapWithCurrentContext(async (args: { path: string }) => {
+    try {
+      const { filePath, contents } = await readFileWithExtensions(
+        adapter,
+        args.path,
+        FILE_EXTENSIONS,
+        projectDir,
+      );
+
+      return {
+        contents,
+        loader: getLoaderForFile(filePath),
+        resolveDir: pathHelper.dirname(filePath),
+      };
+    } catch (error) {
+      const msg = error instanceof Error ? error.message : String(error);
+      logger.error(`Failed to load ${errorLabel}: ${args.path}`, error);
+      return { errors: [{ text: `Failed to load: ${msg}` }] };
+    }
+  });
+}
+
 /** Resolves relative imports through the adapter's virtual FS for remote projects. */
 function createAdapterResolvePlugin(
   adapter: RuntimeAdapter,
@@ -420,25 +434,10 @@ function createAdapterResolvePlugin(
       // cannot resolve the per-project adapter and all file reads fail silently.
       build.onLoad(
         { filter: /.*/, namespace: "vf-adapter" },
-        wrapWithCurrentContext(async (args) => {
-          try {
-            const { filePath, contents } = await readFileWithExtensions(
-              adapter,
-              args.path,
-              FILE_EXTENSIONS,
-              projectDir,
-            );
-
-            return {
-              contents,
-              loader: getLoaderForFile(filePath),
-              resolveDir: pathHelper.dirname(filePath),
-            };
-          } catch (error) {
-            const msg = error instanceof Error ? error.message : String(error);
-            logger.error(`Failed to load via adapter: ${args.path}`, error);
-            return { errors: [{ text: `Failed to load: ${msg}` }] };
-          }
+        createNamespaceOnLoadHandler({
+          adapter,
+          projectDir,
+          errorLabel: "via adapter",
         }),
       );
     },

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