@nodetool-ai/agents 0.7.0-rc.23 → 0.8.2

package/dist/tools/google-tools.d.ts

@@ -1,44 +1,33 @@
 /**
- * Google-powered tools: grounded search and image generation via Gemini API.
+ * The Gemini grounded-search backend behind the routed `web_search` capability.
  *
- * Port of src/nodetool/agents/tools/google_tools.py
+ * This is not a tool. `capabilities/web.ts` picks the first configured backend
+ * and calls the function below; the model never sees a `google_grounded_search`
+ * name, because choosing a search provider is the host's job, not the model's.
+ *
+ * The call itself lives in `serp-providers/gemini-provider.ts`, which is also
+ * what `SERP_PROVIDER=gemini` builds. This file is the context-aware half:
+ * resolve the key, return `{error}` rather than throwing.
  */
 import type { ProcessingContext } from "@nodetool-ai/runtime";
-import { Tool } from "./base-tool.js";
-export declare class GoogleGroundedSearchTool extends Tool {
-    readonly name = "google_grounded_search";
-    readonly description = "Search the web using Google's Gemini API with grounding capabilities";
-    readonly inputSchema: {
-        type: "object";
-        properties: {
-            query: {
-                type: "string";
-                description: string;
-            };
-        };
-        required: string[];
-    };
-    process(_context: ProcessingContext, params: Record<string, unknown>): Promise<unknown>;
-    userMessage(params: Record<string, unknown>): string;
-}
-export declare class GoogleImageGenerationTool extends Tool {
-    readonly name = "google_image_generation";
-    readonly description = "Generate images based on a text prompt using Google's Gemini/Imagen API";
-    readonly inputSchema: {
-        type: "object";
-        properties: {
-            prompt: {
-                type: "string";
-                description: string;
-            };
-            output_file: {
-                type: "string";
-                description: string;
-            };
-        };
-        required: string[];
-    };
-    process(context: ProcessingContext, params: Record<string, unknown>): Promise<unknown>;
-    userMessage(params: Record<string, unknown>): string;
-}
+/**
+ * Whether the Gemini grounded-search backend is usable: its API key is present
+ * in the secret store or the environment. Configuration is decided here,
+ * before any call — never by sniffing an error message afterwards.
+ */
+export declare function geminiSearchConfigured(context: ProcessingContext): Promise<boolean>;
+/** Search the web with Gemini's grounded-search tool. */
+export declare function googleGroundedSearch(context: ProcessingContext, params: {
+    query?: unknown;
+}): Promise<{
+    query?: string;
+    results?: string[];
+    sources?: Array<{
+        title: string;
+        url: string;
+        snippet: string;
+    }>;
+    status?: string;
+    error?: string;
+}>;
 //# sourceMappingURL=google-tools.d.ts.map

package/dist/tools/google-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"google-tools.d.ts","sourceRoot":"","sources":["../../src/tools/google-tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAUtC,qBAAa,wBAAyB,SAAQ,IAAI;IAChD,QAAQ,CAAC,IAAI,4BAA4B;IACzC,QAAQ,CAAC,WAAW,0EACqD;IACzE,QAAQ,CAAC,WAAW;;;;;;;;;MASlB;IAEI,OAAO,CACX,QAAQ,EAAE,iBAAiB,EAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,OAAO,CAAC;IAyFnB,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;CAKrD;AAED,qBAAa,yBAA0B,SAAQ,IAAI;IACjD,QAAQ,CAAC,IAAI,6BAA6B;IAC1C,QAAQ,CAAC,WAAW,6EACwD;IAC5E,QAAQ,CAAC,WAAW;;;;;;;;;;;;;MAalB;IAEI,OAAO,CACX,OAAO,EAAE,iBAAiB,EAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,OAAO,CAAC;IAiEnB,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;CAKrD"}
+{"version":3,"file":"google-tools.d.ts","sourceRoot":"","sources":["../../src/tools/google-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAgB9D;;;;GAIG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,OAAO,CAAC,CAMlB;AAED,yDAAyD;AACzD,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,iBAAiB,EAC1B,MAAM,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAC1B,OAAO,CAAC;IACT,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC,CA0BD"}

package/dist/tools/google-tools.js

@@ -1,176 +1,63 @@
 /**
- * Google-powered tools: grounded search and image generation via Gemini API.
+ * The Gemini grounded-search backend behind the routed `web_search` capability.
  *
- * Port of src/nodetool/agents/tools/google_tools.py
+ * This is not a tool. `capabilities/web.ts` picks the first configured backend
+ * and calls the function below; the model never sees a `google_grounded_search`
+ * name, because choosing a search provider is the host's job, not the model's.
+ *
+ * The call itself lives in `serp-providers/gemini-provider.ts`, which is also
+ * what `SERP_PROVIDER=gemini` builds. This file is the context-aware half:
+ * resolve the key, return `{error}` rather than throwing.
  */
-import * as fs from "node:fs/promises";
-import * as path from "node:path";
-import { Tool } from "./base-tool.js";
-const GEMINI_API_BASE = "https://generativelanguage.googleapis.com/v1beta";
-function getGeminiApiKey() {
-    const key = process.env["GEMINI_API_KEY"];
+import { GeminiSearchProvider } from "./serp-providers/gemini-provider.js";
+import { isFunction, isString } from "../utils/type-guards.js";
+async function getGeminiApiKey(context) {
+    // Prefer the context's secretResolver (encrypted DB) over env vars so the
+    // chat-cli + agent picks up keys configured via `nodetool secrets store`.
+    const fromCtx = isFunction(context?.getSecret)
+        ? await context.getSecret("GEMINI_API_KEY")
+        : null;
+    const key = fromCtx ?? process.env["GEMINI_API_KEY"];
     if (!key)
         throw new Error("GEMINI_API_KEY is not set");
     return key;
 }
-export class GoogleGroundedSearchTool extends Tool {
-    name = "google_grounded_search";
-    description = "Search the web using Google's Gemini API with grounding capabilities";
-    inputSchema = {
-        type: "object",
-        properties: {
-            query: {
-                type: "string",
-                description: "The search query to execute"
-            }
-        },
-        required: ["query"]
-    };
-    async process(_context, params) {
-        const query = params["query"];
-        if (typeof query !== "string" || !query) {
-            return { error: "Search query is required" };
-        }
-        try {
-            const apiKey = getGeminiApiKey();
-            const url = `${GEMINI_API_BASE}/models/gemini-2.0-flash:generateContent?key=${apiKey}`;
-            const body = {
-                contents: [{ role: "user", parts: [{ text: query }] }],
-                tools: [{ googleSearch: {} }],
-                generationConfig: { responseModalities: ["TEXT"] }
-            };
-            const response = await fetch(url, {
-                method: "POST",
-                headers: { "Content-Type": "application/json" },
-                body: JSON.stringify(body)
-            });
-            if (!response.ok) {
-                return {
-                    error: `Gemini API error: ${response.status} ${response.statusText}`
-                };
-            }
-            const data = (await response.json());
-            const candidates = data["candidates"];
-            if (!candidates?.length) {
-                return { error: "No response received from Gemini API" };
-            }
-            const candidate = candidates[0];
-            const content = candidate["content"];
-            const parts = content?.["parts"];
-            // Extract text results
-            const results = [];
-            if (parts) {
-                for (const part of parts) {
-                    if (typeof part["text"] === "string") {
-                        results.push(part["text"]);
-                    }
-                }
-            }
-            // Extract grounding metadata / sources
-            const groundingMetadata = candidate["groundingMetadata"];
-            const sources = [];
-            if (groundingMetadata) {
-                const chunks = groundingMetadata["groundingChunks"];
-                if (chunks) {
-                    for (const chunk of chunks) {
-                        const web = chunk["web"];
-                        if (web?.["uri"]) {
-                            sources.push({
-                                title: String(web["title"] ?? "Unknown Source"),
-                                url: String(web["uri"])
-                            });
-                        }
-                    }
-                }
-            }
-            return {
-                query,
-                results,
-                sources,
-                status: "success"
-            };
-        }
-        catch (e) {
-            return { error: `Google grounded search failed: ${String(e)}` };
-        }
-    }
-    userMessage(params) {
-        const query = String(params["query"] ?? "something");
-        const msg = `Searching Google (grounded) for '${query}'...`;
-        return msg.length > 80 ? "Searching Google (grounded)..." : msg;
-    }
+/**
+ * Whether the Gemini grounded-search backend is usable: its API key is present
+ * in the secret store or the environment. Configuration is decided here,
+ * before any call — never by sniffing an error message afterwards.
+ */
+export async function geminiSearchConfigured(context) {
+    const fromCtx = isFunction(context?.getSecret)
+        ? await context.getSecret("GEMINI_API_KEY")
+        : null;
+    return Boolean(fromCtx ?? process.env["GEMINI_API_KEY"]);
 }
-export class GoogleImageGenerationTool extends Tool {
-    name = "google_image_generation";
-    description = "Generate images based on a text prompt using Google's Gemini/Imagen API";
-    inputSchema = {
-        type: "object",
-        properties: {
-            prompt: {
-                type: "string",
-                description: "The text prompt describing the image to generate"
-            },
-            output_file: {
-                type: "string",
-                description: "The path to save the generated image as a PNG file"
-            }
-        },
-        required: ["prompt", "output_file"]
-    };
-    async process(context, params) {
-        const prompt = params["prompt"];
-        const outputFile = params["output_file"];
-        if (typeof prompt !== "string" || !prompt)
-            return { error: "Image generation prompt is required" };
-        if (typeof outputFile !== "string" || !outputFile)
-            return { error: "Output file is required" };
-        try {
-            const apiKey = getGeminiApiKey();
-            // Use Imagen 3 REST API
-            const url = `${GEMINI_API_BASE}/models/imagen-3.0-generate-002:predict?key=${apiKey}`;
-            const body = {
-                instances: [{ prompt }],
-                parameters: { sampleCount: 1 }
-            };
-            const response = await fetch(url, {
-                method: "POST",
-                headers: { "Content-Type": "application/json" },
-                body: JSON.stringify(body)
-            });
-            if (!response.ok) {
-                const errText = await response.text();
-                return { error: `Gemini API error: ${response.status} - ${errText}` };
-            }
-            const data = (await response.json());
-            const predictions = data["predictions"];
-            if (!predictions?.length) {
-                return { error: "No images generated" };
-            }
-            const imageB64 = predictions[0]["bytesBase64Encoded"];
-            if (!imageB64)
-                return { error: "No image bytes found in response" };
-            const imageBuffer = Buffer.from(imageB64, "base64");
-            const workspace = context["workspaceDir"];
-            const filePath = workspace
-                ? path.join(workspace, outputFile)
-                : outputFile;
-            await fs.mkdir(path.dirname(filePath), { recursive: true });
-            await fs.writeFile(filePath, imageBuffer);
-            return {
-                type: "image",
-                prompt,
-                output_file: outputFile,
-                status: "success"
-            };
-        }
-        catch (e) {
-            return { error: `Google image generation failed: ${String(e)}` };
-        }
+/** Search the web with Gemini's grounded-search tool. */
+export async function googleGroundedSearch(context, params) {
+    const query = params.query;
+    if (!isString(query) || !query) {
+        return { error: "Search query is required" };
+    }
+    try {
+        const apiKey = await getGeminiApiKey(context);
+        const answer = await new GeminiSearchProvider(apiKey).answer(query);
+        return {
+            query,
+            results: answer.texts,
+            sources: answer.citations.map((c) => ({
+                title: c.title,
+                url: c.url,
+                snippet: c.snippet
+            })),
+            status: "success"
+        };
     }
-    userMessage(params) {
-        const prompt = String(params["prompt"] ?? "an image");
-        const msg = `Generating image '${prompt}' using Google...`;
-        return msg.length > 80 ? "Generating an image using Google..." : msg;
+    catch (e) {
+        // The provider and the key resolver already name what failed; re-prefixing
+        // would turn "No response received from Gemini API" into a sentence with
+        // two verbs and no more information.
+        return { error: e instanceof Error ? e.message : String(e) };
     }
 }
 //# sourceMappingURL=google-tools.js.map

package/dist/tools/google-tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"google-tools.js","sourceRoot":"","sources":["../../src/tools/google-tools.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"google-tools.js","sourceRoot":"","sources":["../../src/tools/google-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAE/D,KAAK,UAAU,eAAe,CAAC,OAA2B;IACxD,0EAA0E;IAC1E,0EAA0E;IAC1E,MAAM,OAAO,GACX,UAAU,CAAC,OAAO,EAAE,SAAS,CAAC;QAC5B,CAAC,CAAC,MAAM,OAAO,CAAC,SAAS,CAAC,gBAAgB,CAAC;QAC3C,CAAC,CAAC,IAAI,CAAC;IACX,MAAM,GAAG,GAAG,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IACrD,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IACvD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,OAA0B;IAE1B,MAAM,OAAO,GACX,UAAU,CAAC,OAAO,EAAE,SAAS,CAAC;QAC5B,CAAC,CAAC,MAAM,OAAO,CAAC,SAAS,CAAC,gBAAgB,CAAC;QAC3C,CAAC,CAAC,IAAI,CAAC;IACX,OAAO,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,yDAAyD;AACzD,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,OAA0B,EAC1B,MAA2B;IAQ3B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IAC3B,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QAC/B,OAAO,EAAE,KAAK,EAAE,0BAA0B,EAAE,CAAC;IAC/C,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,OAAO,CAAC,CAAC;QAC9C,MAAM,MAAM,GAAG,MAAM,IAAI,oBAAoB,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAEpE,OAAO;YACL,KAAK;YACL,OAAO,EAAE,MAAM,CAAC,KAAK;YACrB,OAAO,EAAE,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACpC,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,GAAG,EAAE,CAAC,CAAC,GAAG;gBACV,OAAO,EAAE,CAAC,CAAC,OAAO;aACnB,CAAC,CAAC;YACH,MAAM,EAAE,SAAS;SAClB,CAAC;IACJ,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,2EAA2E;QAC3E,yEAAyE;QACzE,qCAAqC;QACrC,OAAO,EAAE,KAAK,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/D,CAAC;AACH,CAAC"}

package/dist/tools/google-workspace-tools.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Google Workspace agent tools — Drive, Gmail, Docs, Sheets and Calendar.
+ *
+ * These authenticate with the access token from the user's Google sign-in
+ * (resolved through `getSecret("GOOGLE_ACCESS_TOKEN")`), so there is no API key
+ * to configure. They are only offered when the server runs in Supabase auth
+ * mode — see `isGoogleWorkspaceEnabled()` in `@nodetool-ai/config`.
+ *
+ * The implementations live in the `google` capability module
+ * (`../capabilities/google.ts`) and arrive here through the registry's eager
+ * spec table: each name becomes a `Tool` whose spec is read synchronously and
+ * whose implementation loads at first call.
+ */
+import type { Tool } from "./base-tool.js";
+/**
+ * Every Google Workspace tool name. Kept apart from `BUILTIN_TOOL_NAMES`
+ * because these are only offered when the deployment can produce a Google
+ * login token.
+ */
+export declare const GOOGLE_WORKSPACE_TOOL_NAMES: readonly string[];
+/** One fresh instance per Google Workspace tool. */
+export declare function getGoogleWorkspaceTools(): Tool[];
+//# sourceMappingURL=google-workspace-tools.d.ts.map

package/dist/tools/google-workspace-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"google-workspace-tools.d.ts","sourceRoot":"","sources":["../../src/tools/google-workspace-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAI3C;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,EAAE,SAAS,MAAM,EAExD,CAAC;AAEF,oDAAoD;AACpD,wBAAgB,uBAAuB,IAAI,IAAI,EAAE,CAEhD"}

package/dist/tools/google-workspace-tools.js

@@ -0,0 +1,26 @@
+/**
+ * Google Workspace agent tools — Drive, Gmail, Docs, Sheets and Calendar.
+ *
+ * These authenticate with the access token from the user's Google sign-in
+ * (resolved through `getSecret("GOOGLE_ACCESS_TOKEN")`), so there is no API key
+ * to configure. They are only offered when the server runs in Supabase auth
+ * mode — see `isGoogleWorkspaceEnabled()` in `@nodetool-ai/config`.
+ *
+ * The implementations live in the `google` capability module
+ * (`../capabilities/google.ts`) and arrive here through the registry's eager
+ * spec table: each name becomes a `Tool` whose spec is read synchronously and
+ * whose implementation loads at first call.
+ */
+import { googleSpecs } from "../capabilities/google.specs.js";
+import { toolFromLazyCapability } from "../capabilities/lazy-tool.js";
+/**
+ * Every Google Workspace tool name. Kept apart from `BUILTIN_TOOL_NAMES`
+ * because these are only offered when the deployment can produce a Google
+ * login token.
+ */
+export const GOOGLE_WORKSPACE_TOOL_NAMES = googleSpecs.map((spec) => spec.name);
+/** One fresh instance per Google Workspace tool. */
+export function getGoogleWorkspaceTools() {
+    return googleSpecs.map((spec) => toolFromLazyCapability(spec));
+}
+//# sourceMappingURL=google-workspace-tools.js.map

package/dist/tools/google-workspace-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"google-workspace-tools.js","sourceRoot":"","sources":["../../src/tools/google-workspace-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAEtE;;;;GAIG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAsB,WAAW,CAAC,GAAG,CAC3E,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CACpB,CAAC;AAEF,oDAAoD;AACpD,MAAM,UAAU,uBAAuB;IACrC,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAC,CAAC;AACjE,CAAC"}

package/dist/tools/graph-validation-registry.d.ts

@@ -0,0 +1,33 @@
+/**
+ * The registry adapter an authored graph is validated through.
+ *
+ * It lived in `finish-graph-tool.ts` until that tool — the last of the
+ * incremental `add_node`/`add_edge` family — was deleted, and these two
+ * helpers were the file's only live exports. `validate_workflow` and the
+ * graph validator read them now.
+ */
+import { type GraphValidationRegistry } from "@nodetool-ai/node-sdk";
+/**
+ * Wrap the planner's registry for `validateGraph`.
+ *
+ * Two planner-specific relaxations:
+ *
+ * - Metadata-only (Python) node types count as known rather than unknown,
+ *   mirroring the check `add_node` applies at add time.
+ * - Unselected models are not errors. The planner is told to omit `model` so
+ *   the run's configured provider+model gets stamped in at execution time; an
+ *   empty model is the intended output, not a defect. Left in, this check
+ *   would reject the shape the planner is asked to produce and push it into
+ *   pinning a model it has no basis to choose.
+ *
+ * A model the planner *does* pin is checked, though: `NodeRegistry` carries no
+ * provider catalog (it also runs in the browser), so without the two hooks
+ * below `validateGraph` skipped provider and model ids entirely and a
+ * hallucinated `fal-ai/flux/schnel` reached the graph the planner handed back.
+ * The planner runs server-side, so the runtime's own registry is the default;
+ * a caller with its own catalog overrides it.
+ */
+export declare function metadataAwareRegistry(registry: GraphValidationRegistry): GraphValidationRegistry;
+/** True when the registry implements the full validation surface (stubs and mocks often don't). */
+export declare function supportsDeepValidation(registry: unknown): registry is GraphValidationRegistry;
+//# sourceMappingURL=graph-validation-registry.d.ts.map

package/dist/tools/graph-validation-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-validation-registry.d.ts","sourceRoot":"","sources":["../../src/tools/graph-validation-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,EACL,KAAK,uBAAuB,EAE7B,MAAM,uBAAuB,CAAC;AAE/B;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,uBAAuB,GAChC,uBAAuB,CAqBzB;AAED,mGAAmG;AACnG,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,OAAO,GAChB,QAAQ,IAAI,uBAAuB,CAQrC"}

package/dist/tools/graph-validation-registry.js

@@ -0,0 +1,54 @@
+/**
+ * The registry adapter an authored graph is validated through.
+ *
+ * It lived in `finish-graph-tool.ts` until that tool — the last of the
+ * incremental `add_node`/`add_edge` family — was deleted, and these two
+ * helpers were the file's only live exports. `validate_workflow` and the
+ * graph validator read them now.
+ */
+import { listOfflineModelIds, listOfflineRequiredTextInputs, listRegisteredProviderIds } from "@nodetool-ai/runtime";
+/**
+ * Wrap the planner's registry for `validateGraph`.
+ *
+ * Two planner-specific relaxations:
+ *
+ * - Metadata-only (Python) node types count as known rather than unknown,
+ *   mirroring the check `add_node` applies at add time.
+ * - Unselected models are not errors. The planner is told to omit `model` so
+ *   the run's configured provider+model gets stamped in at execution time; an
+ *   empty model is the intended output, not a defect. Left in, this check
+ *   would reject the shape the planner is asked to produce and push it into
+ *   pinning a model it has no basis to choose.
+ *
+ * A model the planner *does* pin is checked, though: `NodeRegistry` carries no
+ * provider catalog (it also runs in the browser), so without the two hooks
+ * below `validateGraph` skipped provider and model ids entirely and a
+ * hallucinated `fal-ai/flux/schnel` reached the graph the planner handed back.
+ * The planner runs server-side, so the runtime's own registry is the default;
+ * a caller with its own catalog overrides it.
+ */
+export function metadataAwareRegistry(registry) {
+    return {
+        has: (nodeType) => registry.has(nodeType) || registry.getMetadata(nodeType) != null,
+        getMetadata: (nodeType) => registry.getMetadata(nodeType),
+        validateNode: (descriptor, connectedHandles) => registry
+            .validateNode(descriptor, connectedHandles)
+            .filter((issue) => issue.code !== "unset_model"),
+        listProviderIds: () => registry.listProviderIds?.() ?? listRegisteredProviderIds(),
+        listModelIds: (provider, modelType) => registry.listModelIds
+            ? registry.listModelIds(provider, modelType)
+            : listOfflineModelIds(provider, modelType),
+        listRequiredTextInputs: (provider, modelType, modelId) => registry.listRequiredTextInputs
+            ? registry.listRequiredTextInputs(provider, modelType, modelId)
+            : listOfflineRequiredTextInputs(provider, modelType, modelId)
+    };
+}
+/** True when the registry implements the full validation surface (stubs and mocks often don't). */
+export function supportsDeepValidation(registry) {
+    const r = registry;
+    return (!!r &&
+        typeof r.has === "function" &&
+        typeof r.getMetadata === "function" &&
+        typeof r.validateNode === "function");
+}
+//# sourceMappingURL=graph-validation-registry.js.map

package/dist/tools/graph-validation-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-validation-registry.js","sourceRoot":"","sources":["../../src/tools/graph-validation-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,mBAAmB,EACnB,6BAA6B,EAC7B,yBAAyB,EAC1B,MAAM,sBAAsB,CAAC;AAM9B;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,qBAAqB,CACnC,QAAiC;IAEjC,OAAO;QACL,GAAG,EAAE,CAAC,QAAgB,EAAE,EAAE,CACxB,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,IAAI;QAClE,WAAW,EAAE,CAAC,QAAgB,EAA4B,EAAE,CAC1D,QAAQ,CAAC,WAAW,CAAC,QAAQ,CAAC;QAChC,YAAY,EAAE,CAAC,UAAU,EAAE,gBAAgB,EAAE,EAAE,CAC7C,QAAQ;aACL,YAAY,CAAC,UAAU,EAAE,gBAAgB,CAAC;aAC1C,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,aAAa,CAAC;QACpD,eAAe,EAAE,GAAG,EAAE,CACpB,QAAQ,CAAC,eAAe,EAAE,EAAE,IAAI,yBAAyB,EAAE;QAC7D,YAAY,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,EAAE,CACpC,QAAQ,CAAC,YAAY;YACnB,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,QAAQ,EAAE,SAAS,CAAC;YAC5C,CAAC,CAAC,mBAAmB,CAAC,QAAQ,EAAE,SAAS,CAAC;QAC9C,sBAAsB,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,CACvD,QAAQ,CAAC,sBAAsB;YAC7B,CAAC,CAAC,QAAQ,CAAC,sBAAsB,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC;YAC/D,CAAC,CAAC,6BAA6B,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC;KAClE,CAAC;AACJ,CAAC;AAED,mGAAmG;AACnG,MAAM,UAAU,sBAAsB,CACpC,QAAiB;IAEjB,MAAM,CAAC,GAAG,QAA+D,CAAC;IAC1E,OAAO,CACL,CAAC,CAAC,CAAC;QACH,OAAO,CAAC,CAAC,GAAG,KAAK,UAAU;QAC3B,OAAO,CAAC,CAAC,WAAW,KAAK,UAAU;QACnC,OAAO,CAAC,CAAC,YAAY,KAAK,UAAU,CACrC,CAAC;AACJ,CAAC"}

package/dist/tools/http-tools.d.ts

@@ -1,56 +1,8 @@
 /**
- * HTTP tools for downloading files and making HTTP requests.
- *
- * Port of src/nodetool/agents/tools/http_tools.py
+ * What survives of the two HTTP tools after the port to the `web` capability
+ * module (`../capabilities/web.ts`): the request-signal helper other code
+ * calls directly. `download_file` and `http_request` reach a belt through the
+ * registry now, by name.
  */
-import type { ProcessingContext } from "@nodetool-ai/runtime";
-import { Tool } from "./base-tool.js";
-export declare class DownloadFileTool extends Tool {
-    readonly name = "download_file";
-    readonly description = "Download a text or binary file from a URL and save it to disk";
-    readonly inputSchema: {
-        type: "object";
-        properties: {
-            url: {
-                type: "string";
-                description: string;
-            };
-            output_file: {
-                type: "string";
-                description: string;
-            };
-        };
-        required: string[];
-    };
-    process(context: ProcessingContext, params: Record<string, unknown>): Promise<unknown>;
-    userMessage(params: Record<string, unknown>): string;
-}
-export declare class HttpRequestTool extends Tool {
-    readonly name = "http_request";
-    readonly description = "Make an HTTP request and return the response body as text";
-    readonly inputSchema: {
-        type: "object";
-        properties: {
-            url: {
-                type: "string";
-                description: string;
-            };
-            method: {
-                type: "string";
-                description: string;
-            };
-            headers: {
-                type: "object";
-                description: string;
-            };
-            body: {
-                type: "string";
-                description: string;
-            };
-        };
-        required: string[];
-    };
-    process(_context: ProcessingContext, params: Record<string, unknown>): Promise<unknown>;
-    userMessage(params: Record<string, unknown>): string;
-}
+export { requestSignal } from "../capabilities/web.js";
 //# sourceMappingURL=http-tools.d.ts.map

package/dist/tools/http-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http-tools.d.ts","sourceRoot":"","sources":["../../src/tools/http-tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAStC,qBAAa,gBAAiB,SAAQ,IAAI;IACxC,QAAQ,CAAC,IAAI,mBAAmB;IAChC,QAAQ,CAAC,WAAW,mEAC8C;IAClE,QAAQ,CAAC,WAAW;;;;;;;;;;;;;MAalB;IAEI,OAAO,CACX,OAAO,EAAE,iBAAiB,EAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,OAAO,CAAC;IAqEnB,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;CAYrD;AAED,qBAAa,eAAgB,SAAQ,IAAI;IACvC,QAAQ,CAAC,IAAI,kBAAkB;IAC/B,QAAQ,CAAC,WAAW,+DAC0C;IAC9D,QAAQ,CAAC,WAAW;;;;;;;;;;;;;;;;;;;;;MAsBlB;IAEI,OAAO,CACX,QAAQ,EAAE,iBAAiB,EAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,OAAO,CAAC;IAuDnB,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;CASrD"}
+{"version":3,"file":"http-tools.d.ts","sourceRoot":"","sources":["../../src/tools/http-tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC"}