veryfront 0.1.190 → 0.1.192

package/esm/cli/mcp/standalone.d.ts

@@ -1,10 +1,3 @@
-/**
- * Standalone MCP Server
- *
- * Runs as a separate process (`veryfront mcp`), communicates over stdio.
- * Pulls runtime data from the dev server's Dashboard API over HTTP.
- * Falls back gracefully when the dev server is not running.
- */
 export interface StandaloneMCPConfig {
     port?: number;
 }
@@ -25,6 +18,7 @@ export declare class StandaloneMCPServer {
     private handlePromptsList;
     private handlePromptsGet;
     private createTools;
+    private createContext7Tools;
 }
 export declare function createStandaloneMCPServer(config?: StandaloneMCPConfig): StandaloneMCPServer;
 //# sourceMappingURL=standalone.d.ts.map

package/esm/cli/mcp/standalone.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"standalone.d.ts","sourceRoot":"","sources":["../../../src/cli/mcp/standalone.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA8BH,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,WAAW,CAA4B;gBAEnC,MAAM,GAAE,mBAAwB;IAM5C,KAAK,IAAI,IAAI;IAWb,IAAI,IAAI,IAAI;YAME,aAAa;IAW3B,OAAO,CAAC,cAAc;YAgCR,eAAe;IAqB7B,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,mBAAmB;YAyBb,mBAAmB;IA6CjC,OAAO,CAAC,iBAAiB;YAkBX,gBAAgB;IAwB9B,OAAO,CAAC,WAAW;CA8JpB;AAED,wBAAgB,yBAAyB,CAAC,MAAM,GAAE,mBAAwB,GAAG,mBAAmB,CAI/F"}
+{"version":3,"file":"standalone.d.ts","sourceRoot":"","sources":["../../../src/cli/mcp/standalone.ts"],"names":[],"mappings":"AAsCA,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,WAAW,CAA4B;gBAEnC,MAAM,GAAE,mBAAwB;IAM5C,KAAK,IAAI,IAAI;IAWb,IAAI,IAAI,IAAI;YAME,aAAa;IAW3B,OAAO,CAAC,cAAc;YAgCR,eAAe;IAqB7B,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,mBAAmB;YAyBb,mBAAmB;IA6CjC,OAAO,CAAC,iBAAiB;YAkBX,gBAAgB;IAwB9B,OAAO,CAAC,WAAW;IAgKnB,OAAO,CAAC,mBAAmB;CA0F5B;AAED,wBAAgB,yBAAyB,CAAC,MAAM,GAAE,mBAAwB,GAAG,mBAAmB,CAI/F"}

package/esm/cli/mcp/standalone.js

@@ -5,6 +5,7 @@
  * Pulls runtime data from the dev server's Dashboard API over HTTP.
  * Falls back gracefully when the dev server is not running.
  */
+import * as dntShim from "../../_dnt.shims.js";
 import { readTextFile } from "../../src/platform/index.js";
 import { DevServerClient } from "./dev-server-client.js";
 import { startStdioJsonRpc } from "./stdio.js";
@@ -349,6 +350,90 @@ export class StandaloneMCPServer {
                     }
                 },
             },
+            ...this.createContext7Tools(),
+        ];
+    }
+    createContext7Tools() {
+        const isAvailable = () => Boolean(dntShim.Deno.env.get("CONTEXT7_API_KEY"));
+        let source;
+        const getSource = async () => {
+            if (!source) {
+                const { createContext7ToolSource } = await import("../../src/tool/index.js");
+                source = createContext7ToolSource();
+            }
+            return source;
+        };
+        const notConfigured = {
+            error: "context7_not_configured",
+            message: "Context7 API key not configured. Set the CONTEXT7_API_KEY environment variable.",
+        };
+        return [
+            {
+                name: "c7_resolve_library",
+                description: "Resolves a package or product name to a Context7-compatible library ID. " +
+                    "Call this before c7_query_docs to obtain the correct library ID. " +
+                    "Returns matching libraries with metadata (name, description, snippet count, reputation).",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        libraryName: {
+                            type: "string",
+                            description: "Library name to search for. Use the official name with proper punctuation — e.g., 'Next.js' not 'nextjs'.",
+                        },
+                        query: {
+                            type: "string",
+                            description: "The question or task you need help with. Used to rank results by relevance.",
+                        },
+                    },
+                    required: ["libraryName", "query"],
+                },
+                async execute(args) {
+                    if (!isAvailable())
+                        return notConfigured;
+                    try {
+                        return await (await getSource()).executeTool("resolve-library-id", args);
+                    }
+                    catch (error) {
+                        return {
+                            error: "context7_request_failed",
+                            message: error instanceof Error ? error.message : String(error),
+                        };
+                    }
+                },
+            },
+            {
+                name: "c7_query_docs",
+                description: "Retrieves up-to-date documentation and code examples from Context7 for a library. " +
+                    "You must call c7_resolve_library first to obtain the library ID, unless the user " +
+                    "provides one directly in '/org/project' format.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        libraryId: {
+                            type: "string",
+                            description: "Context7-compatible library ID (e.g., '/vercel/next.js', '/supabase/supabase').",
+                        },
+                        query: {
+                            type: "string",
+                            description: "The question or task you need help with. Be specific and include relevant details.",
+                        },
+                    },
+                    required: ["libraryId", "query"],
+                },
+                async execute(args) {
+                    if (!isAvailable())
+                        return notConfigured;
+                    try {
+                        return await (await getSource()).executeTool("query-docs", args);
+                    }
+                    catch (error) {
+                        return {
+                            error: "context7_request_failed",
+                            message: error instanceof Error ? error.message : String(error),
+                        };
+                    }
+                },
+            },
         ];
     }
 }

package/esm/cli/mcp/tools/context7-tools.d.ts

@@ -0,0 +1,3 @@
+import type { MCPTool } from "../../../src/mcp/index.js";
+export declare const context7Tools: MCPTool[];
+//# sourceMappingURL=context7-tools.d.ts.map

package/esm/cli/mcp/tools/context7-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context7-tools.d.ts","sourceRoot":"","sources":["../../../../src/cli/mcp/tools/context7-tools.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AA2GzD,eAAO,MAAM,aAAa,EAAE,OAAO,EAAoC,CAAC"}

package/esm/cli/mcp/tools/context7-tools.js

@@ -0,0 +1,90 @@
+import * as dntShim from "../../../_dnt.shims.js";
+import { z } from "zod";
+import { createContext7ToolSource } from "../../../src/tool/index.js";
+let _source;
+function getSource() {
+    if (!_source) {
+        _source = createContext7ToolSource();
+    }
+    return _source;
+}
+function isContext7Available() {
+    return Boolean(dntShim.Deno.env.get("CONTEXT7_API_KEY"));
+}
+const c7ResolveLibrary = {
+    name: "c7_resolve_library",
+    title: "Context7: Resolve Library ID",
+    description: "Resolves a package or product name to a Context7-compatible library ID. " +
+        "Call this before c7_query_docs to obtain the correct library ID. " +
+        "Returns matching libraries with metadata (name, description, snippet count, reputation).",
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true,
+    },
+    inputSchema: z.object({
+        libraryName: z
+            .string()
+            .describe("Library name to search for. Use the official name with proper punctuation — e.g., 'Next.js' not 'nextjs'."),
+        query: z
+            .string()
+            .describe("The question or task you need help with. Used to rank results by relevance."),
+    }),
+    execute: async (input) => {
+        if (!isContext7Available()) {
+            return {
+                error: "context7_not_configured",
+                message: "Context7 API key not configured. Set the CONTEXT7_API_KEY environment variable.",
+            };
+        }
+        try {
+            return await getSource().executeTool("resolve-library-id", input);
+        }
+        catch (error) {
+            return {
+                error: "context7_request_failed",
+                message: error instanceof Error ? error.message : String(error),
+            };
+        }
+    },
+};
+const c7QueryDocs = {
+    name: "c7_query_docs",
+    title: "Context7: Query Documentation",
+    description: "Retrieves up-to-date documentation and code examples from Context7 for a library. " +
+        "You must call c7_resolve_library first to obtain the library ID, unless the user " +
+        "provides one directly in '/org/project' format.",
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true,
+    },
+    inputSchema: z.object({
+        libraryId: z
+            .string()
+            .describe("Context7-compatible library ID (e.g., '/vercel/next.js', '/supabase/supabase')."),
+        query: z
+            .string()
+            .describe("The question or task you need help with. Be specific and include relevant details."),
+    }),
+    execute: async (input) => {
+        if (!isContext7Available()) {
+            return {
+                error: "context7_not_configured",
+                message: "Context7 API key not configured. Set the CONTEXT7_API_KEY environment variable.",
+            };
+        }
+        try {
+            return await getSource().executeTool("query-docs", input);
+        }
+        catch (error) {
+            return {
+                error: "context7_request_failed",
+                message: error instanceof Error ? error.message : String(error),
+            };
+        }
+    },
+};
+export const context7Tools = [c7ResolveLibrary, c7QueryDocs];

package/esm/cli/mcp/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/cli/mcp/tools.ts"],"names":[],"mappings":"AAAA;;4BAE4B;AAE5B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,KAAK,QAAQ,EAIb,KAAK,QAAQ,EAEd,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EAAE,KAAK,iBAAiB,EAAwB,MAAM,2BAA2B,CAAC;AACzF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAMtD,YAAY,EAAE,OAAO,EAAE,CAAC;AAUxB,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAErD;AAED,QAAA,MAAM,cAAc;;;;;;;;;;iBAUlB,CAAC;AAEH,KAAK,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAErD,eAAO,MAAM,WAAW,EAAE,OAAO,CAAC,cAAc,EAAE,QAAQ,EAAE,CAgB3D,CAAC;AAEF,QAAA,MAAM,YAAY;;;;;;;;;;;iBAgBhB,CAAC;AAEH,KAAK,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAEjD,eAAO,MAAM,SAAS,EAAE,OAAO,CAAC,YAAY,EAAE,QAAQ,EAAE,CAgBvD,CAAC;AAEF,QAAA,MAAM,eAAe;;;;;;iBAInB,CAAC;AAEH,KAAK,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAEvD,UAAU,gBAAgB;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,eAAO,MAAM,YAAY,EAAE,OAAO,CAAC,eAAe,EAAE,gBAAgB,CA6BnE,CAAC;AAEF,QAAA,MAAM,cAAc,gCAAe,CAAC;AAEpC,KAAK,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAErD,UAAU,YAAY;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,iBAAiB,CAC/B,GAAG,GAAE,iBAA0C,GAC9C,OAAO,CAAC,cAAc,EAAE,YAAY,CAAC,CAyBvC;AAED,eAAO,MAAM,WAAW,8CAAsB,CAAC;AAE/C,QAAA,MAAM,gBAAgB;;;;;;;;;iBAOpB,CAAC;AAEH,KAAK,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEzD,UAAU,iBAAiB;IACzB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,aAAa,EAAE,OAAO,CAAC,gBAAgB,EAAE,iBAAiB,CAsBtE,CAAC;AAEF,eAAO,MAAM,QAAQ,EAAE,OAAO,EAS7B,CAAC;AAEF,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAEzD;AAED,wBAAgB,SAAS,IAAI,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CAExE"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/cli/mcp/tools.ts"],"names":[],"mappings":"AAAA;;4BAE4B;AAE5B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,KAAK,QAAQ,EAIb,KAAK,QAAQ,EAEd,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EAAE,KAAK,iBAAiB,EAAwB,MAAM,2BAA2B,CAAC;AACzF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAOtD,YAAY,EAAE,OAAO,EAAE,CAAC;AAUxB,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAErD;AAED,QAAA,MAAM,cAAc;;;;;;;;;;iBAUlB,CAAC;AAEH,KAAK,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAErD,eAAO,MAAM,WAAW,EAAE,OAAO,CAAC,cAAc,EAAE,QAAQ,EAAE,CAgB3D,CAAC;AAEF,QAAA,MAAM,YAAY;;;;;;;;;;;iBAgBhB,CAAC;AAEH,KAAK,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAEjD,eAAO,MAAM,SAAS,EAAE,OAAO,CAAC,YAAY,EAAE,QAAQ,EAAE,CAgBvD,CAAC;AAEF,QAAA,MAAM,eAAe;;;;;;iBAInB,CAAC;AAEH,KAAK,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAEvD,UAAU,gBAAgB;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,eAAO,MAAM,YAAY,EAAE,OAAO,CAAC,eAAe,EAAE,gBAAgB,CA6BnE,CAAC;AAEF,QAAA,MAAM,cAAc,gCAAe,CAAC;AAEpC,KAAK,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAErD,UAAU,YAAY;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,iBAAiB,CAC/B,GAAG,GAAE,iBAA0C,GAC9C,OAAO,CAAC,cAAc,EAAE,YAAY,CAAC,CAyBvC;AAED,eAAO,MAAM,WAAW,8CAAsB,CAAC;AAE/C,QAAA,MAAM,gBAAgB;;;;;;;;;iBAOpB,CAAC;AAEH,KAAK,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEzD,UAAU,iBAAiB;IACzB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,aAAa,EAAE,OAAO,CAAC,gBAAgB,EAAE,iBAAiB,CAsBtE,CAAC;AAEF,eAAO,MAAM,QAAQ,EAAE,OAAO,EAU7B,CAAC;AAEF,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAEzD;AAED,wBAAgB,SAAS,IAAI,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CAExE"}

package/esm/cli/mcp/tools.js

@@ -8,6 +8,7 @@ import { getEnvironmentConfig } from "../../src/config/index.js";
 import { advancedTools } from "./advanced-tools.js";
 import { remoteFileTools } from "./remote-file-tools.js";
 import { issuesMcpTools } from "../../src/issues/index.js";
+import { context7Tools } from "./tools/context7-tools.js";
 import { DEFAULT_MCP_PORT } from "../shared/constants.js";
 const CACHE_DIRS = {
     all: [".cache/veryfront-modules", ".cache/veryfront-mdx-esm"],
@@ -149,6 +150,7 @@ export const allTools = [
     ...advancedTools,
     ...remoteFileTools,
     ...issuesMcpTools,
+    ...context7Tools,
     vfGetErrors,
     vfGetLogs,
     vfClearCache,

package/esm/deno.js

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

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

@@ -1 +1 @@
-{"version":3,"file":"ag-ui-handler.d.ts","sourceRoot":"","sources":["../../../src/src/agent/ag-ui-handler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,KAAK,EAAW,MAAM,YAAY,CAAC;AACjD,OAAO,EAGL,KAAK,uBAAuB,EAC7B,MAAM,oBAAoB,CAAC;AAsC5B,QAAA,MAAM,sBAAsB;;;;iBAO1B,CAAC;AAEH,QAAA,MAAM,qBAAqB;;;;;;;;;;;;;;2BAqBzB,CAAC;AAYH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAe5B,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAG5D,KAAK,eAAe,GAAG;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC;AA4Y7D,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"}
+{"version":3,"file":"ag-ui-handler.d.ts","sourceRoot":"","sources":["../../../src/src/agent/ag-ui-handler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,KAAK,EAAW,MAAM,YAAY,CAAC;AACjD,OAAO,EAGL,KAAK,uBAAuB,EAC7B,MAAM,oBAAoB,CAAC;AAsC5B,QAAA,MAAM,sBAAsB;;;;iBAO1B,CAAC;AAEH,QAAA,MAAM,qBAAqB;;;;;;;;;;;;;;2BAqBzB,CAAC;AAYH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAe5B,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAG5D,KAAK,eAAe,GAAG;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC;AAia7D,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"}

package/esm/src/agent/ag-ui-handler.js

@@ -198,13 +198,23 @@ function enqueueEvent(controller, event, payload) {
     }
 }
 async function createAgUiStreamResponse(options) {
-    const { agentId, request, runId, threadId, upstreamBody, upstreamStatus, upstreamStatusText, onFinish, onError, } = options;
+    const { agentId, request, runId, threadId, upstreamBody, upstreamStatus, upstreamStatusText, onFinish, onError, onToolCallSeen, } = options;
     const stream = new ReadableStream({
         start: async (controller) => {
             const state = createStreamTransformState();
             let reader = null;
             let remainder = "";
             const decoder = new TextDecoder();
+            const prepareToolResultIfNeeded = (event, payload) => {
+                if (event !== "ToolCallStart" && event !== "ToolCallArgs" &&
+                    event !== "ToolCallEnd") {
+                    return;
+                }
+                const toolCallId = typeof payload.toolCallId === "string" ? payload.toolCallId : null;
+                if (toolCallId) {
+                    onToolCallSeen?.(toolCallId);
+                }
+            };
             if (!enqueueEvent(controller, "RunStarted", { runId, threadId, agentId })) {
                 return;
             }
@@ -235,6 +245,7 @@ async function createAgUiStreamResponse(options) {
                     remainder = parsed.remainder;
                     for (const event of parsed.events) {
                         for (const mapped of mapRuntimeEventToAgUi(state, event)) {
+                            prepareToolResultIfNeeded(mapped.event, mapped.payload);
                             if (!enqueueEvent(controller, mapped.event, mapped.payload)) {
                                 return;
                             }
@@ -245,6 +256,7 @@ async function createAgUiStreamResponse(options) {
                 const parsed = parseSseJsonEvents(remainder);
                 for (const event of parsed.events) {
                     for (const mapped of mapRuntimeEventToAgUi(state, event)) {
+                        prepareToolResultIfNeeded(mapped.event, mapped.payload);
                         if (!enqueueEvent(controller, mapped.event, mapped.payload)) {
                             return;
                         }
@@ -309,6 +321,7 @@ function createInjectedAgUiTool(runId, tool, sessionManager) {
             if (!toolCallId) {
                 throw new Error(`Missing toolCallId for injected tool "${tool.name}"`);
             }
+            sessionManager.prepareForSignal(runId, toolCallId);
             const submitted = await sessionManager.waitForSignal(runId, toolCallId);
             if (submitted.isError) {
                 throw new Error(typeof submitted.result === "string"
@@ -367,6 +380,9 @@ async function createAgUiInjectedToolsStreamResponse(agent, request, baseContext
         onError: () => {
             sessionManager.failRun(runId);
         },
+        onToolCallSeen: (toolCallId) => {
+            sessionManager.prepareForSignal(runId, toolCallId);
+        },
     });
 }
 function mergeConfig(config, options) {

package/esm/src/agent/factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/src/agent/factory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,KAAK,EACL,WAAW,EACX,eAAe,EAKhB,MAAM,YAAY,CAAC;AA+CpB,wBAAgB,KAAK,CAAC,MAAM,EAAE,WAAW,GAAG,KAAK,CA4MhD;AAcD;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,UAAU,GAAG,YAAY,CAAC,GACnD,eAAe,EAAE,CAcnB"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/src/agent/factory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,KAAK,EACL,WAAW,EACX,eAAe,EAKhB,MAAM,YAAY,CAAC;AA+CpB,wBAAgB,KAAK,CAAC,MAAM,EAAE,WAAW,GAAG,KAAK,CA8MhD;AAcD;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,UAAU,GAAG,YAAY,CAAC,GACnD,eAAe,EAAE,CAcnB"}

package/esm/src/agent/factory.js

@@ -137,7 +137,8 @@ export function agent(config) {
                 const stream = await runtime.stream(inputMessages, input.context, {
                     onToolCall: input.onToolCall,
                     onChunk: input.onChunk,
-                }, input.model, input.maxOutputTokens);
+                    onFinish: input.onFinish,
+                }, input.model, input.maxOutputTokens, input.abortSignal);
                 return createAgentStreamResult(stream);
             }, { "agent.id": id, "agent.input_type": input.input ? "string" : "messages" });
         },

package/esm/src/agent/human-input.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"human-input.d.ts","sourceRoot":"","sources":["../../../src/src/agent/human-input.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAI7D,eAAO,MAAM,sBAAsB;;;;;iBAKjC,CAAC;AAUH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAuChC,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAMlC,CAAC;AAEH,eAAO,MAAM,8BAA8B,oGAG1C,CAAC;AAEF,eAAO,MAAM,sBAAsB;;;;;;gCASjC,CAAC;AAEH,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAIzC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACzE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAC7E,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAEtF,KAAK,qBAAqB,GAAG;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,MAAM,WAAW,wBAAwB;IACvC,cAAc,EAAE,uBAAuB,CAAC,qBAAqB,CAAC,CAAC;IAC/D,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,sBAAsB,CAAC;IAChC,SAAS,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,wBAAwB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,SAAS,CAAC;CACvF;AAED,qBAAa,qBAAsB,SAAQ,KAAK;IAClC,QAAQ,CAAC,MAAM,EAAE,OAAO;gBAAf,MAAM,EAAE,OAAO;CAMrC;AAED,qBAAa,4BAA6B,SAAQ,KAAK;IACzC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;gBAApB,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CAI1C;AAED,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,gBAAgB,CAAC,CAoB3B"}
+{"version":3,"file":"human-input.d.ts","sourceRoot":"","sources":["../../../src/src/agent/human-input.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAI7D,eAAO,MAAM,sBAAsB;;;;;iBAKjC,CAAC;AAUH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAuChC,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAMlC,CAAC;AAEH,eAAO,MAAM,8BAA8B,oGAG1C,CAAC;AAEF,eAAO,MAAM,sBAAsB;;;;;;gCASjC,CAAC;AAEH,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAIzC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACzE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAC7E,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAEtF,KAAK,qBAAqB,GAAG;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,MAAM,WAAW,wBAAwB;IACvC,cAAc,EAAE,uBAAuB,CAAC,qBAAqB,CAAC,CAAC;IAC/D,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,sBAAsB,CAAC;IAChC,SAAS,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,wBAAwB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,SAAS,CAAC;CACvF;AAED,qBAAa,qBAAsB,SAAQ,KAAK;IAClC,QAAQ,CAAC,MAAM,EAAE,OAAO;gBAAf,MAAM,EAAE,OAAO;CAMrC;AAED,qBAAa,4BAA6B,SAAQ,KAAK;IACzC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;gBAApB,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CAI1C;AAED,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,gBAAgB,CAAC,CAqB3B"}

package/esm/src/agent/human-input.js

@@ -94,6 +94,7 @@ export class InvalidHumanInputResultError extends Error {
     }
 }
 export async function waitForHumanInput(options) {
+    options.sessionManager.prepareForSignal(options.runId, options.toolCallId);
     const pendingRequest = HumanInputPendingRequestSchema.parse({
         runId: options.runId,
         toolCallId: options.toolCallId,

package/esm/src/agent/runtime/resume-session.d.ts

@@ -47,6 +47,7 @@ export declare class RunResumeSessionManager<T> {
         runId: string;
         threadId: string;
     }): AbortSignal;
+    prepareForSignal(runId: string, waitKey: string): void;
     waitForSignal(runId: string, waitKey: string): Promise<T>;
     submitSignal(runId: string, input: {
         waitKey: string;

package/esm/src/agent/runtime/resume-session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resume-session.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/runtime/resume-session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,wBAAwB,CAAC;AAClD,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,WAAW,GAAG,QAAQ,CAAC;AAE5F,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,OAAO,SAAkB;CAItC;AAED,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,KAAK,EAAE,MAAM;CAI1B;AAED,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,KAAK,EAAE,MAAM;CAI1B;AAED,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAI3C;AAED,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAI3C;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,IAAI,CAAC;IACf,SAAS,CAAC,EAAE,IAAI,CAAC;CAClB;AA0BD,MAAM,WAAW,8BAA8B,CAAC,CAAC;IAC/C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,YAAY,CAAC,EAAE,OAAO,OAAO,CAAC,UAAU,CAAC;IACzC,cAAc,CAAC,EAAE,OAAO,YAAY,CAAC;IACrC,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,CAAC;CACvC;AAMD,qBAAa,uBAAuB,CAAC,CAAC;IAIlC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAH1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoC;gBAG1C,OAAO,GAAE,8BAA8B,CAAC,CAAC,CAAM;IAGlE,OAAO,KAAK,YAAY,GAEvB;IAED,OAAO,KAAK,YAAY,GAEvB;IAED,OAAO,KAAK,qBAAqB,GAEhC;IAED,OAAO,KAAK,YAAY,GAEvB;IAED,OAAO,KAAK,cAAc,GAEzB;IAED,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,mBAAmB;IAM3B,OAAO,CAAC,mBAAmB;IAM3B,OAAO,CAAC,sBAAsB;IAQ9B,OAAO,CAAC,sBAAsB;IAO9B,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,eAAe;IAWvB,QAAQ,CAAC,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,WAAW;IA2B3D,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAsD/D,YAAY,CACV,KAAK,EAAE,MAAM,EACb,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,CAAC,CAAA;KAAE,GACnC,wBAAwB;IAqC3B,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAkBjC,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAMhC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAM5B,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;IAIpD,KAAK,IAAI,IAAI;CAOd"}
+{"version":3,"file":"resume-session.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/runtime/resume-session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,wBAAwB,CAAC;AAClD,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,WAAW,GAAG,QAAQ,CAAC;AAE5F,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,OAAO,SAAkB;CAItC;AAED,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,KAAK,EAAE,MAAM;CAI1B;AAED,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,KAAK,EAAE,MAAM;CAI1B;AAED,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAI3C;AAED,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAI3C;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,IAAI,CAAC;IACf,SAAS,CAAC,EAAE,IAAI,CAAC;CAClB;AA2BD,MAAM,WAAW,8BAA8B,CAAC,CAAC;IAC/C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,YAAY,CAAC,EAAE,OAAO,OAAO,CAAC,UAAU,CAAC;IACzC,cAAc,CAAC,EAAE,OAAO,YAAY,CAAC;IACrC,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,CAAC;CACvC;AAMD,qBAAa,uBAAuB,CAAC,CAAC;IAIlC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAH1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoC;gBAG1C,OAAO,GAAE,8BAA8B,CAAC,CAAC,CAAM;IAGlE,OAAO,KAAK,YAAY,GAEvB;IAED,OAAO,KAAK,YAAY,GAEvB;IAED,OAAO,KAAK,qBAAqB,GAEhC;IAED,OAAO,KAAK,YAAY,GAEvB;IAED,OAAO,KAAK,cAAc,GAEzB;IAED,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,mBAAmB;IAM3B,OAAO,CAAC,mBAAmB;IAM3B,OAAO,CAAC,sBAAsB;IAQ9B,OAAO,CAAC,sBAAsB;IAO9B,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,eAAe;IAWvB,QAAQ,CAAC,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,WAAW;IA4BjE,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAiBhD,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAuD/D,YAAY,CACV,KAAK,EAAE,MAAM,EACb,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,CAAC,CAAA;KAAE,GACnC,wBAAwB;IA+C3B,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAkBjC,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAMhC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAM5B,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;IAIpD,KAAK,IAAI,IAAI;CAOd"}

package/esm/src/agent/runtime/resume-session.js

@@ -110,6 +110,7 @@ export class RunResumeSessionManager {
             status: "running",
             abortController: new AbortController(),
             waitingState: null,
+            preparedWaitKeys: new Set(),
             submittedValues: new Map(),
             waitingTimeoutId: null,
             sessionTimeoutId: null,
@@ -118,6 +119,18 @@ export class RunResumeSessionManager {
         this.touchSession(session);
         return session.abortController.signal;
     }
+    prepareForSignal(runId, waitKey) {
+        const session = this.sessions.get(runId);
+        if (!session) {
+            throw new RunNotActiveError(runId);
+        }
+        if (session.status === "completed" || session.status === "failed" ||
+            session.status === "cancelled") {
+            throw new RunNotActiveError(runId);
+        }
+        session.preparedWaitKeys.add(waitKey);
+        this.touchSession(session);
+    }
     async waitForSignal(runId, waitKey) {
         const session = this.sessions.get(runId);
         if (!session || session.status === "completed" || session.status === "failed") {
@@ -126,6 +139,7 @@ export class RunResumeSessionManager {
         if (session.abortController.signal.aborted || session.status === "cancelled") {
             throw new RunCancelledError();
         }
+        session.preparedWaitKeys.add(waitKey);
         const existingValue = session.submittedValues.get(waitKey);
         if (existingValue) {
             session.status = "running";
@@ -185,7 +199,15 @@ export class RunResumeSessionManager {
             session.status === "cancelled") {
             throw new RunNotActiveError(runId);
         }
-        if (!session.waitingState || session.waitingState.waitKey !== input.waitKey) {
+        if (!session.waitingState) {
+            if (!session.preparedWaitKeys.has(input.waitKey)) {
+                throw new WaitNotPendingError(runId, input.waitKey);
+            }
+            session.submittedValues.set(input.waitKey, normalized);
+            this.touchSession(session);
+            return { accepted: true };
+        }
+        if (session.waitingState.waitKey !== input.waitKey) {
             throw new WaitNotPendingError(runId, input.waitKey);
         }
         session.submittedValues.set(input.waitKey, normalized);

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

@@ -141,6 +141,8 @@ export interface Agent {
         maxOutputTokens?: number;
         onToolCall?: (toolCall: ToolCall) => void;
         onChunk?: (chunk: string) => void;
+        onFinish?: (response: AgentResponse) => void;
+        abortSignal?: AbortSignal;
     }): Promise<AgentStreamResult>;
     respond(request: Request): Promise<Response>;
     getMemory(): Memory<Message>;

package/esm/src/agent/types.d.ts.map

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

package/esm/src/internal-agents/run-stream.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-stream.d.ts","sourceRoot":"","sources":["../../../src/src/internal-agents/run-stream.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,KAAK,EACV,KAAK,YAAY,IAAI,OAAO,EAC5B,KAAK,aAAa,EAEnB,MAAM,mBAAmB,CAAC;AAW3B,OAAO,EAA0B,KAAK,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC3F,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAYxD,MAAM,WAAW,+BAA+B;IAC9C,cAAc,EAAE,sBAAsB,CAAC;IACvC,aAAa,CAAC,EAAE,CACd,KAAK,EAAE,KAAK,EACZ,WAAW,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,KAClC;QACH,MAAM,EAAE,CACN,QAAQ,EAAE,OAAO,EAAE,EACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,SAAS,CAAC,EAAE;YACV,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,aAAa,KAAK,IAAI,CAAC;SAC9C,EACD,aAAa,CAAC,EAAE,MAAM,EACtB,uBAAuB,CAAC,EAAE,MAAM,EAChC,WAAW,CAAC,EAAE,WAAW,KACtB,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAAC;KAC1C,CAAC;CACH;AAmJD,wBAAsB,gCAAgC,CACpD,KAAK,EAAE,oBAAoB,EAC3B,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,+BAA+B,GACpC,OAAO,CAAC,QAAQ,CAAC,CA6NnB"}
+{"version":3,"file":"run-stream.d.ts","sourceRoot":"","sources":["../../../src/src/internal-agents/run-stream.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,KAAK,EACV,KAAK,YAAY,IAAI,OAAO,EAC5B,KAAK,aAAa,EAEnB,MAAM,mBAAmB,CAAC;AAW3B,OAAO,EAA0B,KAAK,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC3F,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAYxD,MAAM,WAAW,+BAA+B;IAC9C,cAAc,EAAE,sBAAsB,CAAC;IACvC,aAAa,CAAC,EAAE,CACd,KAAK,EAAE,KAAK,EACZ,WAAW,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,KAClC;QACH,MAAM,EAAE,CACN,QAAQ,EAAE,OAAO,EAAE,EACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,SAAS,CAAC,EAAE;YACV,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,aAAa,KAAK,IAAI,CAAC;SAC9C,EACD,aAAa,CAAC,EAAE,MAAM,EACtB,uBAAuB,CAAC,EAAE,MAAM,EAChC,WAAW,CAAC,EAAE,WAAW,KACtB,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAAC;KAC1C,CAAC;CACH;AAoJD,wBAAsB,gCAAgC,CACpD,KAAK,EAAE,oBAAoB,EAC3B,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,+BAA+B,GACpC,OAAO,CAAC,QAAQ,CAAC,CA8OnB"}

package/esm/src/internal-agents/run-stream.js

@@ -20,6 +20,7 @@ function createInjectedStudioTool(runId, toolName, description, parameters, sess
             if (!toolCallId) {
                 throw new Error(`Missing toolCallId for injected tool "${toolName}"`);
             }
+            sessionManager.prepareForToolResult(runId, toolCallId);
             const waitResult = await sessionManager.waitForToolResult(runId, toolCallId);
             if (waitResult.isError) {
                 throw new Error(typeof waitResult.result === "string"
@@ -198,6 +199,17 @@ export async function createRuntimeAgentStreamResponse(input, agent, deps) {
                     clientAttached = false;
                 }
             };
+            const prepareToolResultIfNeeded = (event, payload) => {
+                if (event !== "ToolCallStart" && event !== "ToolCallArgs" &&
+                    event !== "ToolCallEnd") {
+                    return;
+                }
+                const toolCallId = typeof payload.toolCallId === "string" ? payload.toolCallId : null;
+                if (!toolCallId) {
+                    return;
+                }
+                deps.sessionManager.prepareForToolResult(input.runId, toolCallId);
+            };
             const throwIfAborted = () => {
                 if (aborted || abortSignal.aborted) {
                     throw new AgentRunCancelledError();
@@ -236,6 +248,7 @@ export async function createRuntimeAgentStreamResponse(input, agent, deps) {
                     remainder = parsed.remainder;
                     for (const event of parsed.events) {
                         for (const mappedEvent of mapRuntimeEventToAgUi(state, event)) {
+                            prepareToolResultIfNeeded(mappedEvent.event, mappedEvent.payload);
                             enqueueIfAttached(mappedEvent.event, mappedEvent.payload);
                         }
                     }
@@ -244,6 +257,7 @@ export async function createRuntimeAgentStreamResponse(input, agent, deps) {
                 const trailingEvents = parseSseJsonEvents(`${remainder}\n\n`);
                 for (const event of trailingEvents.events) {
                     for (const mappedEvent of mapRuntimeEventToAgUi(state, event)) {
+                        prepareToolResultIfNeeded(mappedEvent.event, mappedEvent.payload);
                         enqueueIfAttached(mappedEvent.event, mappedEvent.payload);
                     }
                 }

package/esm/src/internal-agents/session-manager.d.ts

@@ -33,6 +33,7 @@ export declare class AgentRunSessionManager {
         result: unknown;
         isError: boolean;
     }>;
+    prepareForToolResult(runId: string, toolCallId: string): void;
     submitToolResult(runId: string, input: {
         toolCallId: string;
         result: unknown;

package/esm/src/internal-agents/session-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-manager.d.ts","sourceRoot":"","sources":["../../../src/src/internal-agents/session-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EAGjB,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,EAC7B,iBAAiB,EACjB,mBAAmB,EACpB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EAAE,iBAAiB,EAAE,CAAC;AA0B7B,qBAAa,sBAAuB,SAAQ,iBAAiB;gBAC/C,OAAO,SAAkB;CAItC;AAED,qBAAa,0BAA2B,SAAQ,qBAAqB;gBACvD,KAAK,EAAE,MAAM;CAI1B;AAED,qBAAa,yBAA0B,SAAQ,mBAAmB;gBACpD,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;CAI9C;AAED,qBAAa,uBAAwB,SAAQ,iBAAiB;gBAChD,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;CAI9C;AAWD,MAAM,MAAM,aAAa,GAAG,gBAAgB,CAAC;AAC7C,MAAM,MAAM,uBAAuB,GAAG,wBAAwB,CAAC;AAE/D,qBAAa,sBAAsB;IAI/B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAH1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA+C;gBAGrD,OAAO,GAAE;QACxB,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAC7B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,qBAAqB,CAAC,EAAE,MAAM,CAAC;QAC/B,YAAY,CAAC,EAAE,OAAO,OAAO,CAAC,UAAU,CAAC;QACzC,cAAc,CAAC,EAAE,OAAO,YAAY,CAAC;KACjC;IAaR,QAAQ,CAAC,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,WAAW;IAW3D,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;QAClE,MAAM,EAAE,OAAO,CAAC;QAChB,OAAO,EAAE,OAAO,CAAC;KAClB,CAAC;IAeF,gBAAgB,CACd,KAAK,EAAE,MAAM,EACb,KAAK,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAChE,uBAAuB;IAuB1B,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAIjC,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIhC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI5B,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAIjD,KAAK,IAAI,IAAI;CAGd;AAoBD,wBAAgB,4CAA4C,IAAI,IAAI,CAGnE;AAED,eAAO,MAAM,sBAAsB,wBAAoC,CAAC"}
+{"version":3,"file":"session-manager.d.ts","sourceRoot":"","sources":["../../../src/src/internal-agents/session-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EAGjB,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,EAC7B,iBAAiB,EACjB,mBAAmB,EACpB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EAAE,iBAAiB,EAAE,CAAC;AA0B7B,qBAAa,sBAAuB,SAAQ,iBAAiB;gBAC/C,OAAO,SAAkB;CAItC;AAED,qBAAa,0BAA2B,SAAQ,qBAAqB;gBACvD,KAAK,EAAE,MAAM;CAI1B;AAED,qBAAa,yBAA0B,SAAQ,mBAAmB;gBACpD,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;CAI9C;AAED,qBAAa,uBAAwB,SAAQ,iBAAiB;gBAChD,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;CAI9C;AAWD,MAAM,MAAM,aAAa,GAAG,gBAAgB,CAAC;AAC7C,MAAM,MAAM,uBAAuB,GAAG,wBAAwB,CAAC;AAE/D,qBAAa,sBAAsB;IAI/B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAH1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA+C;gBAGrD,OAAO,GAAE;QACxB,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAC7B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,qBAAqB,CAAC,EAAE,MAAM,CAAC;QAC/B,YAAY,CAAC,EAAE,OAAO,OAAO,CAAC,UAAU,CAAC;QACzC,cAAc,CAAC,EAAE,OAAO,YAAY,CAAC;KACjC;IAaR,QAAQ,CAAC,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,WAAW;IAW3D,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;QAClE,MAAM,EAAE,OAAO,CAAC;QAChB,OAAO,EAAE,OAAO,CAAC;KAClB,CAAC;IAeF,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAI7D,gBAAgB,CACd,KAAK,EAAE,MAAM,EACb,KAAK,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAChE,uBAAuB;IAuB1B,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAIjC,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIhC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI5B,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAIjD,KAAK,IAAI,IAAI;CAGd;AAoBD,wBAAgB,4CAA4C,IAAI,IAAI,CAGnE;AAED,eAAO,MAAM,sBAAsB,wBAAoC,CAAC"}

package/esm/src/internal-agents/session-manager.js

@@ -87,6 +87,9 @@ export class AgentRunSessionManager {
             throw error;
         }
     }
+    prepareForToolResult(runId, toolCallId) {
+        this.sessions.prepareForSignal(runId, toolCallId);
+    }
     submitToolResult(runId, input) {
         const normalized = {
             result: input.result,

package/esm/src/tool/context7.d.ts

@@ -0,0 +1,9 @@
+import type { RemoteToolSource } from "./types.js";
+export interface Context7ToolSourceConfig {
+    /** Context7 API key. Falls back to Deno.env.get("CONTEXT7_API_KEY"). */
+    apiKey?: string;
+    /** Override the default endpoint (useful for testing). */
+    endpoint?: string;
+}
+export declare function createContext7ToolSource(config?: Context7ToolSourceConfig): RemoteToolSource;
+//# sourceMappingURL=context7.d.ts.map

package/esm/src/tool/context7.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context7.d.ts","sourceRoot":"","sources":["../../../src/src/tool/context7.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,MAAM,WAAW,wBAAwB;IACvC,wEAAwE;IACxE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAcD,wBAAgB,wBAAwB,CACtC,MAAM,GAAE,wBAA6B,GACpC,gBAAgB,CAQlB"}

package/esm/src/tool/context7.js

@@ -0,0 +1,19 @@
+import * as dntShim from "../../_dnt.shims.js";
+import { createRemoteMCPToolSource } from "./remote-mcp.js";
+const DEFAULT_ENDPOINT = "https://mcp.context7.com/mcp";
+function resolveApiKey(config) {
+    const key = config.apiKey ?? dntShim.Deno.env.get("CONTEXT7_API_KEY");
+    if (!key) {
+        throw new Error("Context7 API key is required. Pass apiKey or set the CONTEXT7_API_KEY environment variable.");
+    }
+    return key;
+}
+export function createContext7ToolSource(config = {}) {
+    return createRemoteMCPToolSource({
+        id: "context7",
+        endpoint: config.endpoint ?? DEFAULT_ENDPOINT,
+        headers: () => ({
+            CONTEXT7_API_KEY: resolveApiKey(config),
+        }),
+    });
+}

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

@@ -48,6 +48,8 @@ export { dynamicTool, tool } from "./factory.js";
 export type { DynamicToolConfig } from "./factory.js";
 export { createRemoteMCPToolSource } from "./remote-mcp.js";
 export type { RemoteMCPToolSourceConfig } from "./remote-mcp.js";
+export { createContext7ToolSource } from "./context7.js";
+export type { Context7ToolSourceConfig } from "./context7.js";
 export { createToolsFromRemoteDefinitions, loadRemoteToolsFromSource, } from "./remote-source-tools.js";
 export type { RemoteToolMaterializationOptions } from "./remote-source-tools.js";
 export { toolRegistry } from "./registry.js";

package/esm/src/tool/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/src/tool/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,OAAO,yBAAyB,CAAC;AAGjC,YAAY,EACV,gBAAgB,EAChB,IAAI,EACJ,UAAU,EACV,cAAc,EACd,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACjD,YAAY,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,YAAY,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AACjE,OAAO,EACL,gCAAgC,EAChC,yBAAyB,GAC1B,MAAM,0BAA0B,CAAC;AAClC,YAAY,EAAE,gCAAgC,EAAE,MAAM,0BAA0B,CAAC;AAEjF,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/src/tool/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,OAAO,yBAAyB,CAAC;AAGjC,YAAY,EACV,gBAAgB,EAChB,IAAI,EACJ,UAAU,EACV,cAAc,EACd,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACjD,YAAY,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,YAAY,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AACjE,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AACzD,YAAY,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EACL,gCAAgC,EAChC,yBAAyB,GAC1B,MAAM,0BAA0B,CAAC;AAClC,YAAY,EAAE,gCAAgC,EAAE,MAAM,0BAA0B,CAAC;AAEjF,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC"}

package/esm/src/tool/index.js

@@ -45,6 +45,7 @@
 import "../../_dnt.polyfills.js";
 export { dynamicTool, tool } from "./factory.js";
 export { createRemoteMCPToolSource } from "./remote-mcp.js";
+export { createContext7ToolSource } from "./context7.js";
 export { createToolsFromRemoteDefinitions, loadRemoteToolsFromSource, } from "./remote-source-tools.js";
 export { toolRegistry } from "./registry.js";
 export { executeTool } from "./executor.js";

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

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.1.190";
+export declare const VERSION = "0.1.192";
 //# 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.190";
+export const VERSION = "0.1.192";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "veryfront",
-  "version": "0.1.190",
+  "version": "0.1.192",
   "description": "The simplest way to build AI-powered apps",
   "keywords": [
     "react",

package/src/cli/mcp/standalone.ts

@@ -5,6 +5,8 @@
  * Pulls runtime data from the dev server's Dashboard API over HTTP.
  * Falls back gracefully when the dev server is not running.
  */
+import * as dntShim from "../../_dnt.shims.js";
+
 
 import { readTextFile } from "../../src/platform/index.js";
 import type { StdinReader } from "../../src/platform/index.js";
@@ -409,6 +411,98 @@ export class StandaloneMCPServer {
           }
         },
       },
+      ...this.createContext7Tools(),
+    ];
+  }
+
+  private createContext7Tools(): StandaloneTool[] {
+    const isAvailable = () => Boolean(dntShim.Deno.env.get("CONTEXT7_API_KEY"));
+
+    let source: {
+      executeTool: (name: string, args: Record<string, unknown>) => Promise<unknown>;
+    } | undefined;
+
+    const getSource = async () => {
+      if (!source) {
+        const { createContext7ToolSource } = await import("../../src/tool/index.js");
+        source = createContext7ToolSource();
+      }
+      return source;
+    };
+
+    const notConfigured = {
+      error: "context7_not_configured",
+      message: "Context7 API key not configured. Set the CONTEXT7_API_KEY environment variable.",
+    };
+
+    return [
+      {
+        name: "c7_resolve_library",
+        description: "Resolves a package or product name to a Context7-compatible library ID. " +
+          "Call this before c7_query_docs to obtain the correct library ID. " +
+          "Returns matching libraries with metadata (name, description, snippet count, reputation).",
+        inputSchema: {
+          type: "object",
+          properties: {
+            libraryName: {
+              type: "string",
+              description:
+                "Library name to search for. Use the official name with proper punctuation — e.g., 'Next.js' not 'nextjs'.",
+            },
+            query: {
+              type: "string",
+              description:
+                "The question or task you need help with. Used to rank results by relevance.",
+            },
+          },
+          required: ["libraryName", "query"],
+        },
+        async execute(args) {
+          if (!isAvailable()) return notConfigured;
+          try {
+            return await (await getSource()).executeTool("resolve-library-id", args);
+          } catch (error) {
+            return {
+              error: "context7_request_failed",
+              message: error instanceof Error ? error.message : String(error),
+            };
+          }
+        },
+      },
+      {
+        name: "c7_query_docs",
+        description:
+          "Retrieves up-to-date documentation and code examples from Context7 for a library. " +
+          "You must call c7_resolve_library first to obtain the library ID, unless the user " +
+          "provides one directly in '/org/project' format.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            libraryId: {
+              type: "string",
+              description:
+                "Context7-compatible library ID (e.g., '/vercel/next.js', '/supabase/supabase').",
+            },
+            query: {
+              type: "string",
+              description:
+                "The question or task you need help with. Be specific and include relevant details.",
+            },
+          },
+          required: ["libraryId", "query"],
+        },
+        async execute(args) {
+          if (!isAvailable()) return notConfigured;
+          try {
+            return await (await getSource()).executeTool("query-docs", args);
+          } catch (error) {
+            return {
+              error: "context7_request_failed",
+              message: error instanceof Error ? error.message : String(error),
+            };
+          }
+        },
+      },
     ];
   }
 }

package/src/cli/mcp/tools/context7-tools.ts

@@ -0,0 +1,110 @@
+import * as dntShim from "../../../_dnt.shims.js";
+import { z } from "zod";
+import type { MCPTool } from "../../../src/mcp/index.js";
+import { createContext7ToolSource } from "../../../src/tool/index.js";
+
+let _source: ReturnType<typeof createContext7ToolSource> | undefined;
+
+function getSource() {
+  if (!_source) {
+    _source = createContext7ToolSource();
+  }
+  return _source;
+}
+
+function isContext7Available(): boolean {
+  return Boolean(dntShim.Deno.env.get("CONTEXT7_API_KEY"));
+}
+
+const c7ResolveLibrary: MCPTool<
+  { libraryName: string; query: string },
+  unknown
+> = {
+  name: "c7_resolve_library",
+  title: "Context7: Resolve Library ID",
+  description: "Resolves a package or product name to a Context7-compatible library ID. " +
+    "Call this before c7_query_docs to obtain the correct library ID. " +
+    "Returns matching libraries with metadata (name, description, snippet count, reputation).",
+  annotations: {
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true,
+  },
+  inputSchema: z.object({
+    libraryName: z
+      .string()
+      .describe(
+        "Library name to search for. Use the official name with proper punctuation — e.g., 'Next.js' not 'nextjs'.",
+      ),
+    query: z
+      .string()
+      .describe(
+        "The question or task you need help with. Used to rank results by relevance.",
+      ),
+  }),
+  execute: async (input) => {
+    if (!isContext7Available()) {
+      return {
+        error: "context7_not_configured",
+        message: "Context7 API key not configured. Set the CONTEXT7_API_KEY environment variable.",
+      };
+    }
+    try {
+      return await getSource().executeTool("resolve-library-id", input);
+    } catch (error) {
+      return {
+        error: "context7_request_failed",
+        message: error instanceof Error ? error.message : String(error),
+      };
+    }
+  },
+};
+
+const c7QueryDocs: MCPTool<
+  { libraryId: string; query: string },
+  unknown
+> = {
+  name: "c7_query_docs",
+  title: "Context7: Query Documentation",
+  description:
+    "Retrieves up-to-date documentation and code examples from Context7 for a library. " +
+    "You must call c7_resolve_library first to obtain the library ID, unless the user " +
+    "provides one directly in '/org/project' format.",
+  annotations: {
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true,
+  },
+  inputSchema: z.object({
+    libraryId: z
+      .string()
+      .describe(
+        "Context7-compatible library ID (e.g., '/vercel/next.js', '/supabase/supabase').",
+      ),
+    query: z
+      .string()
+      .describe(
+        "The question or task you need help with. Be specific and include relevant details.",
+      ),
+  }),
+  execute: async (input) => {
+    if (!isContext7Available()) {
+      return {
+        error: "context7_not_configured",
+        message: "Context7 API key not configured. Set the CONTEXT7_API_KEY environment variable.",
+      };
+    }
+    try {
+      return await getSource().executeTool("query-docs", input);
+    } catch (error) {
+      return {
+        error: "context7_request_failed",
+        message: error instanceof Error ? error.message : String(error),
+      };
+    }
+  },
+};
+
+export const context7Tools: MCPTool[] = [c7ResolveLibrary, c7QueryDocs];

package/src/cli/mcp/tools.ts

@@ -17,6 +17,7 @@ import type { MCPTool } from "../../src/mcp/index.js";
 import { advancedTools } from "./advanced-tools.js";
 import { remoteFileTools } from "./remote-file-tools.js";
 import { issuesMcpTools } from "../../src/issues/index.js";
+import { context7Tools } from "./tools/context7-tools.js";
 import { DEFAULT_MCP_PORT } from "../shared/constants.js";
 
 export type { MCPTool };
@@ -235,6 +236,7 @@ export const allTools: MCPTool[] = [
   ...advancedTools,
   ...remoteFileTools,
   ...issuesMcpTools,
+  ...context7Tools,
   vfGetErrors,
   vfGetLogs,
   vfClearCache,

package/src/deno.js

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

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

@@ -277,6 +277,7 @@ async function createAgUiStreamResponse(
     upstreamStatusText?: string;
     onFinish?: () => void;
     onError?: (error: unknown) => void;
+    onToolCallSeen?: (toolCallId: string) => void;
   },
 ): Promise<Response> {
   const {
@@ -289,6 +290,7 @@ async function createAgUiStreamResponse(
     upstreamStatusText,
     onFinish,
     onError,
+    onToolCallSeen,
   } = options;
 
   const stream = new ReadableStream<Uint8Array>({
@@ -297,6 +299,19 @@ async function createAgUiStreamResponse(
       let reader: ReadableStreamDefaultReader<Uint8Array> | null = null;
       let remainder = "";
       const decoder = new TextDecoder();
+      const prepareToolResultIfNeeded = (event: string, payload: Record<string, unknown>) => {
+        if (
+          event !== "ToolCallStart" && event !== "ToolCallArgs" &&
+          event !== "ToolCallEnd"
+        ) {
+          return;
+        }
+
+        const toolCallId = typeof payload.toolCallId === "string" ? payload.toolCallId : null;
+        if (toolCallId) {
+          onToolCallSeen?.(toolCallId);
+        }
+      };
 
       if (!enqueueEvent(controller, "RunStarted", { runId, threadId, agentId })) {
         return;
@@ -332,6 +347,7 @@ async function createAgUiStreamResponse(
 
           for (const event of parsed.events as AgUiRuntimePart[]) {
             for (const mapped of mapRuntimeEventToAgUi(state, event)) {
+              prepareToolResultIfNeeded(mapped.event, mapped.payload);
               if (!enqueueEvent(controller, mapped.event, mapped.payload)) {
                 return;
               }
@@ -343,6 +359,7 @@ async function createAgUiStreamResponse(
         const parsed = parseSseJsonEvents(remainder);
         for (const event of parsed.events as AgUiRuntimePart[]) {
           for (const mapped of mapRuntimeEventToAgUi(state, event)) {
+            prepareToolResultIfNeeded(mapped.event, mapped.payload);
             if (!enqueueEvent(controller, mapped.event, mapped.payload)) {
               return;
             }
@@ -421,6 +438,7 @@ function createInjectedAgUiTool(
         throw new Error(`Missing toolCallId for injected tool "${tool.name}"`);
       }
 
+      sessionManager.prepareForSignal(runId, toolCallId);
       const submitted = await sessionManager.waitForSignal(runId, toolCallId);
       if (submitted.isError) {
         throw new Error(
@@ -501,6 +519,9 @@ async function createAgUiInjectedToolsStreamResponse(
     onError: () => {
       sessionManager.failRun(runId);
     },
+    onToolCallSeen: (toolCallId) => {
+      sessionManager.prepareForSignal(runId, toolCallId);
+    },
   });
 }
 

package/src/src/agent/factory.ts

@@ -190,9 +190,11 @@ export function agent(config: AgentConfig): Agent {
             {
               onToolCall: input.onToolCall,
               onChunk: input.onChunk,
+              onFinish: input.onFinish,
             },
             input.model,
             input.maxOutputTokens,
+            input.abortSignal,
           );
 
           return createAgentStreamResult(stream);

package/src/src/agent/human-input.ts

@@ -130,6 +130,7 @@ export class InvalidHumanInputResultError extends Error {
 export async function waitForHumanInput(
   options: WaitForHumanInputOptions,
 ): Promise<HumanInputResult> {
+  options.sessionManager.prepareForSignal(options.runId, options.toolCallId);
   const pendingRequest = HumanInputPendingRequestSchema.parse({
     runId: options.runId,
     toolCallId: options.toolCallId,

package/src/src/agent/runtime/resume-session.ts

@@ -57,6 +57,7 @@ type RunSession<T> = {
   status: RunSessionStatus;
   abortController: AbortController;
   waitingState: WaitingState<T> | null;
+  preparedWaitKeys: Set<string>;
   submittedValues: Map<string, SubmittedValue<T>>;
   waitingTimeoutId: number | null;
   sessionTimeoutId: number | null;
@@ -171,6 +172,7 @@ export class RunResumeSessionManager<T> {
       status: "running",
       abortController: new AbortController(),
       waitingState: null,
+      preparedWaitKeys: new Set(),
       submittedValues: new Map(),
       waitingTimeoutId: null,
       sessionTimeoutId: null,
@@ -181,6 +183,23 @@ export class RunResumeSessionManager<T> {
     return session.abortController.signal;
   }
 
+  prepareForSignal(runId: string, waitKey: string): void {
+    const session = this.sessions.get(runId);
+    if (!session) {
+      throw new RunNotActiveError(runId);
+    }
+
+    if (
+      session.status === "completed" || session.status === "failed" ||
+      session.status === "cancelled"
+    ) {
+      throw new RunNotActiveError(runId);
+    }
+
+    session.preparedWaitKeys.add(waitKey);
+    this.touchSession(session);
+  }
+
   async waitForSignal(runId: string, waitKey: string): Promise<T> {
     const session = this.sessions.get(runId);
     if (!session || session.status === "completed" || session.status === "failed") {
@@ -191,6 +210,7 @@ export class RunResumeSessionManager<T> {
       throw new RunCancelledError();
     }
 
+    session.preparedWaitKeys.add(waitKey);
     const existingValue = session.submittedValues.get(waitKey);
     if (existingValue) {
       session.status = "running";
@@ -265,7 +285,17 @@ export class RunResumeSessionManager<T> {
       throw new RunNotActiveError(runId);
     }
 
-    if (!session.waitingState || session.waitingState.waitKey !== input.waitKey) {
+    if (!session.waitingState) {
+      if (!session.preparedWaitKeys.has(input.waitKey)) {
+        throw new WaitNotPendingError(runId, input.waitKey);
+      }
+
+      session.submittedValues.set(input.waitKey, normalized);
+      this.touchSession(session);
+      return { accepted: true };
+    }
+
+    if (session.waitingState.waitKey !== input.waitKey) {
       throw new WaitNotPendingError(runId, input.waitKey);
     }
 

package/src/src/agent/types.ts

@@ -219,6 +219,8 @@ export interface Agent {
     maxOutputTokens?: number;
     onToolCall?: (toolCall: ToolCall) => void;
     onChunk?: (chunk: string) => void;
+    onFinish?: (response: AgentResponse) => void;
+    abortSignal?: AbortSignal;
   }): Promise<AgentStreamResult>;
 
   respond(request: Request): Promise<Response>;

package/src/src/internal-agents/run-stream.ts

@@ -66,6 +66,7 @@ function createInjectedStudioTool(
         throw new Error(`Missing toolCallId for injected tool "${toolName}"`);
       }
 
+      sessionManager.prepareForToolResult(runId, toolCallId);
       const waitResult = await sessionManager.waitForToolResult(runId, toolCallId);
       if (waitResult.isError) {
         throw new Error(
@@ -284,6 +285,21 @@ export async function createRuntimeAgentStreamResponse(
           clientAttached = false;
         }
       };
+      const prepareToolResultIfNeeded = (event: string, payload: Record<string, unknown>) => {
+        if (
+          event !== "ToolCallStart" && event !== "ToolCallArgs" &&
+          event !== "ToolCallEnd"
+        ) {
+          return;
+        }
+
+        const toolCallId = typeof payload.toolCallId === "string" ? payload.toolCallId : null;
+        if (!toolCallId) {
+          return;
+        }
+
+        deps.sessionManager.prepareForToolResult(input.runId, toolCallId);
+      };
 
       const throwIfAborted = () => {
         if (aborted || abortSignal.aborted) {
@@ -330,6 +346,7 @@ export async function createRuntimeAgentStreamResponse(
 
           for (const event of parsed.events) {
             for (const mappedEvent of mapRuntimeEventToAgUi(state, event)) {
+              prepareToolResultIfNeeded(mappedEvent.event, mappedEvent.payload);
               enqueueIfAttached(mappedEvent.event, mappedEvent.payload);
             }
           }
@@ -340,6 +357,7 @@ export async function createRuntimeAgentStreamResponse(
         const trailingEvents = parseSseJsonEvents(`${remainder}\n\n`);
         for (const event of trailingEvents.events) {
           for (const mappedEvent of mapRuntimeEventToAgUi(state, event)) {
+            prepareToolResultIfNeeded(mappedEvent.event, mappedEvent.payload);
             enqueueIfAttached(mappedEvent.event, mappedEvent.payload);
           }
         }

package/src/src/internal-agents/session-manager.ts

@@ -129,6 +129,10 @@ export class AgentRunSessionManager {
     }
   }
 
+  prepareForToolResult(runId: string, toolCallId: string): void {
+    this.sessions.prepareForSignal(runId, toolCallId);
+  }
+
   submitToolResult(
     runId: string,
     input: { toolCallId: string; result: unknown; isError?: boolean },

package/src/src/tool/context7.ts

@@ -0,0 +1,34 @@
+import * as dntShim from "../../_dnt.shims.js";
+import { createRemoteMCPToolSource } from "./remote-mcp.js";
+import type { RemoteToolSource } from "./types.js";
+
+export interface Context7ToolSourceConfig {
+  /** Context7 API key. Falls back to Deno.env.get("CONTEXT7_API_KEY"). */
+  apiKey?: string;
+  /** Override the default endpoint (useful for testing). */
+  endpoint?: string;
+}
+
+const DEFAULT_ENDPOINT = "https://mcp.context7.com/mcp";
+
+function resolveApiKey(config: Context7ToolSourceConfig): string {
+  const key = config.apiKey ?? dntShim.Deno.env.get("CONTEXT7_API_KEY");
+  if (!key) {
+    throw new Error(
+      "Context7 API key is required. Pass apiKey or set the CONTEXT7_API_KEY environment variable.",
+    );
+  }
+  return key;
+}
+
+export function createContext7ToolSource(
+  config: Context7ToolSourceConfig = {},
+): RemoteToolSource {
+  return createRemoteMCPToolSource({
+    id: "context7",
+    endpoint: config.endpoint ?? DEFAULT_ENDPOINT,
+    headers: () => ({
+      CONTEXT7_API_KEY: resolveApiKey(config),
+    }),
+  });
+}

package/src/src/tool/index.ts

@@ -57,6 +57,8 @@ export { dynamicTool, tool } from "./factory.js";
 export type { DynamicToolConfig } from "./factory.js";
 export { createRemoteMCPToolSource } from "./remote-mcp.js";
 export type { RemoteMCPToolSourceConfig } from "./remote-mcp.js";
+export { createContext7ToolSource } from "./context7.js";
+export type { Context7ToolSourceConfig } from "./context7.js";
 export {
   createToolsFromRemoteDefinitions,
   loadRemoteToolsFromSource,

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