@nodetool-ai/agents 0.7.0-rc.11

package/dist/tools/create-task-tool.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Tool for creating and validating a single-task execution plan.
+ *
+ * Used by TaskPlanner (legacy single-task path) to let the LLM produce
+ * a validated Task through the standard agent tool-calling loop.
+ */
+import type { ProcessingContext } from "@nodetool-ai/runtime";
+import { Tool } from "./base-tool.js";
+import type { Task } from "../types.js";
+export declare class CreateTaskPlanTool extends Tool {
+    readonly name = "create_task";
+    readonly description: string;
+    readonly inputSchema: Record<string, unknown>;
+    /** Captured validated task, or null if not yet created. */
+    private _task;
+    /** Input keys for dependency validation. */
+    private readonly inputKeys;
+    constructor(inputs?: Record<string, unknown>);
+    get task(): Task | null;
+    process(_context: ProcessingContext, params: Record<string, unknown>): Promise<unknown>;
+    userMessage(params: Record<string, unknown>): string;
+    private buildTask;
+    private validateTask;
+    private checkForCycles;
+    private validatePlanSemantics;
+    private applySchemaOverrides;
+}
+//# sourceMappingURL=create-task-tool.d.ts.map

package/dist/tools/create-task-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-task-tool.d.ts","sourceRoot":"","sources":["../../src/tools/create-task-tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,EAAQ,IAAI,EAAE,MAAM,aAAa,CAAC;AA4B9C,qBAAa,kBAAmB,SAAQ,IAAI;IAC1C,QAAQ,CAAC,IAAI,iBAAiB;IAC9B,QAAQ,CAAC,WAAW,SAEwD;IAC5E,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAA4B;IAEzE,2DAA2D;IAC3D,OAAO,CAAC,KAAK,CAAqB;IAElC,4CAA4C;IAC5C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAc;gBAE5B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAK5C,IAAI,IAAI,IAAI,IAAI,GAAG,IAAI,CAEtB;IAEK,OAAO,CACX,QAAQ,EAAE,iBAAiB,EAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,OAAO,CAAC;IAqBnB,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;IAUpD,OAAO,CAAC,SAAS;IAyCjB,OAAO,CAAC,YAAY;IAwCpB,OAAO,CAAC,cAAc;IA2BtB,OAAO,CAAC,qBAAqB;IA8E7B,OAAO,CAAC,oBAAoB;CAmB7B"}

package/dist/tools/create-task-tool.js

@@ -0,0 +1,254 @@
+/**
+ * Tool for creating and validating a single-task execution plan.
+ *
+ * Used by TaskPlanner (legacy single-task path) to let the LLM produce
+ * a validated Task through the standard agent tool-calling loop.
+ */
+import { Tool } from "./base-tool.js";
+import { randomUUID } from "node:crypto";
+/**
+ * JSON Schema for the create_task tool input.
+ */
+const CREATE_TASK_INPUT_SCHEMA = {
+    type: "object",
+    properties: {
+        title: { type: "string", description: "Task title" },
+        steps: {
+            type: "array",
+            items: {
+                type: "object",
+                properties: {
+                    id: { type: "string" },
+                    instructions: { type: "string" },
+                    depends_on: { type: "array", items: { type: "string" } },
+                    output_schema: { type: "string" },
+                    tools: { type: "array", items: { type: "string" } }
+                },
+                required: ["id", "instructions", "depends_on"]
+            }
+        }
+    },
+    required: ["title", "steps"]
+};
+export class CreateTaskPlanTool extends Tool {
+    name = "create_task";
+    description = "Create an executable task with steps. " +
+        "Steps form a DAG via depends_on for parallel execution within the task.";
+    inputSchema = CREATE_TASK_INPUT_SCHEMA;
+    /** Captured validated task, or null if not yet created. */
+    _task = null;
+    /** Input keys for dependency validation. */
+    inputKeys;
+    constructor(inputs) {
+        super();
+        this.inputKeys = new Set(Object.keys(inputs ?? {}));
+    }
+    get task() {
+        return this._task;
+    }
+    async process(_context, params) {
+        const task = this.buildTask(params);
+        const errors = this.validateTask(task);
+        if (errors.length > 0) {
+            return {
+                status: "validation_failed",
+                errors
+            };
+        }
+        this.applySchemaOverrides(task.steps);
+        this._task = task;
+        return {
+            status: "task_created",
+            title: task.title,
+            steps: task.steps.length
+        };
+    }
+    userMessage(params) {
+        const title = typeof params["title"] === "string" ? params["title"] : "task";
+        return `Creating task: ${title}`;
+    }
+    // ---------------------------------------------------------------------------
+    // Build
+    // ---------------------------------------------------------------------------
+    buildTask(data) {
+        const title = typeof data["title"] === "string" ? data["title"] : "Untitled Task";
+        const rawSteps = Array.isArray(data["steps"]) ? data["steps"] : [];
+        const steps = rawSteps.map((s) => {
+            const raw = s;
+            return {
+                id: typeof raw["id"] === "string" ? raw["id"] : randomUUID(),
+                instructions: typeof raw["instructions"] === "string" ? raw["instructions"] : "",
+                completed: false,
+                dependsOn: Array.isArray(raw["depends_on"])
+                    ? raw["depends_on"]
+                    : Array.isArray(raw["dependsOn"])
+                        ? raw["dependsOn"]
+                        : [],
+                outputSchema: typeof raw["output_schema"] === "string"
+                    ? raw["output_schema"]
+                    : typeof raw["outputSchema"] === "string"
+                        ? raw["outputSchema"]
+                        : undefined,
+                tools: Array.isArray(raw["tools"])
+                    ? raw["tools"]
+                    : undefined,
+                logs: []
+            };
+        });
+        return {
+            id: randomUUID(),
+            title,
+            steps
+        };
+    }
+    // ---------------------------------------------------------------------------
+    // Validation
+    // ---------------------------------------------------------------------------
+    validateTask(task) {
+        const errors = [];
+        const stepIds = new Set(task.steps.map((s) => s.id));
+        // Check dependencies
+        for (const step of task.steps) {
+            for (const dep of step.dependsOn) {
+                if (!stepIds.has(dep) && !this.inputKeys.has(dep)) {
+                    errors.push(`Step '${step.id}' depends on '${dep}' which does not exist as a step ID or input key.`);
+                }
+            }
+        }
+        // Check for duplicate step IDs
+        const seen = new Set();
+        for (const step of task.steps) {
+            if (seen.has(step.id)) {
+                errors.push(`Duplicate step ID: '${step.id}'.`);
+            }
+            seen.add(step.id);
+        }
+        // Check for cycles
+        if (!this.checkForCycles(task)) {
+            errors.push("Circular dependency detected in task plan.");
+        }
+        // Semantic checks
+        errors.push(...this.validatePlanSemantics(task.steps));
+        // Must have at least one step
+        if (task.steps.length === 0) {
+            errors.push("Task must contain at least one step.");
+        }
+        return errors;
+    }
+    checkForCycles(task) {
+        const stepIds = new Set(task.steps.map((s) => s.id));
+        const visited = new Set();
+        const inStack = new Set();
+        const stepMap = new Map(task.steps.map((s) => [s.id, s]));
+        const hasCycle = (id) => {
+            if (inStack.has(id))
+                return true;
+            if (visited.has(id))
+                return false;
+            visited.add(id);
+            inStack.add(id);
+            const step = stepMap.get(id);
+            if (step) {
+                for (const dep of step.dependsOn) {
+                    if (stepIds.has(dep) && hasCycle(dep))
+                        return true;
+                }
+            }
+            inStack.delete(id);
+            return false;
+        };
+        for (const step of task.steps) {
+            if (hasCycle(step.id))
+                return false;
+        }
+        return true;
+    }
+    validatePlanSemantics(steps) {
+        const errors = [];
+        const loopingPhrases = [
+            "for each",
+            "for every",
+            "iterate over",
+            "loop over",
+            "for all"
+        ];
+        const aggregatorPatterns = [
+            "aggregate",
+            "compile",
+            "combine",
+            "merge",
+            "final",
+            "report"
+        ];
+        const aggregatorIds = new Set();
+        for (const step of steps) {
+            const sid = step.id.toLowerCase();
+            if (aggregatorPatterns.some((p) => sid.includes(p))) {
+                aggregatorIds.add(step.id);
+            }
+        }
+        for (const step of steps) {
+            if (aggregatorIds.has(step.id))
+                continue;
+            const content = step.instructions.toLowerCase();
+            for (const phrase of loopingPhrases) {
+                if (content.includes(phrase)) {
+                    errors.push(`Step '${step.id}' contains looping phrase '${phrase}'. Emit one step per item (fan-out) instead.`);
+                    break;
+                }
+            }
+        }
+        const extractorPatterns = [
+            "extract",
+            "fetch",
+            "scrape",
+            "crawl",
+            "parse",
+            "process"
+        ];
+        const extractorIds = [];
+        for (const step of steps) {
+            const sid = step.id.toLowerCase();
+            if (extractorPatterns.some((p) => sid.includes(p))) {
+                extractorIds.push(step.id);
+            }
+        }
+        if (aggregatorIds.size > 0 && extractorIds.length > 0) {
+            for (const aggId of aggregatorIds) {
+                const agg = steps.find((s) => s.id === aggId);
+                if (!agg)
+                    continue;
+                const declaredDeps = new Set(agg.dependsOn);
+                const missing = extractorIds.filter((eid) => !declaredDeps.has(eid));
+                if (missing.length > 0) {
+                    errors.push(`Aggregator '${aggId}' must depend on all extractor steps. Missing: ${missing.join(", ")}`);
+                }
+            }
+        }
+        return errors;
+    }
+    // ---------------------------------------------------------------------------
+    // Schema normalization
+    // ---------------------------------------------------------------------------
+    applySchemaOverrides(steps) {
+        for (const step of steps) {
+            if (!step.outputSchema)
+                continue;
+            try {
+                const parsed = typeof step.outputSchema === "string"
+                    ? JSON.parse(step.outputSchema)
+                    : step.outputSchema;
+                if (typeof parsed === "object" && parsed !== null) {
+                    if (!("type" in parsed)) {
+                        parsed["type"] = "object";
+                        step.outputSchema = JSON.stringify(parsed);
+                    }
+                }
+            }
+            catch {
+                step.outputSchema = undefined;
+            }
+        }
+    }
+}
+//# sourceMappingURL=create-task-tool.js.map

package/dist/tools/create-task-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-task-tool.js","sourceRoot":"","sources":["../../src/tools/create-task-tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAEtC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;GAEG;AACH,MAAM,wBAAwB,GAAG;IAC/B,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE;QACpD,KAAK,EAAE;YACL,IAAI,EAAE,OAAO;YACb,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACtB,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBAChC,UAAU,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;oBACxD,aAAa,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACjC,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;iBACpD;gBACD,QAAQ,EAAE,CAAC,IAAI,EAAE,cAAc,EAAE,YAAY,CAAC;aAC/C;SACF;KACF;IACD,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC;CAC7B,CAAC;AAEF,MAAM,OAAO,kBAAmB,SAAQ,IAAI;IACjC,IAAI,GAAG,aAAa,CAAC;IACrB,WAAW,GAClB,wCAAwC;QACxC,yEAAyE,CAAC;IACnE,WAAW,GAA4B,wBAAwB,CAAC;IAEzE,2DAA2D;IACnD,KAAK,GAAgB,IAAI,CAAC;IAElC,4CAA4C;IAC3B,SAAS,CAAc;IAExC,YAAY,MAAgC;QAC1C,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,SAAS,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC;IACtD,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,KAAK,CAAC,OAAO,CACX,QAA2B,EAC3B,MAA+B;QAE/B,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACpC,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QAEvC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,OAAO;gBACL,MAAM,EAAE,mBAAmB;gBAC3B,MAAM;aACP,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACtC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAElB,OAAO;YACL,MAAM,EAAE,cAAc;YACtB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM;SACzB,CAAC;IACJ,CAAC;IAED,WAAW,CAAC,MAA+B;QACzC,MAAM,KAAK,GACT,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QACjE,OAAO,kBAAkB,KAAK,EAAE,CAAC;IACnC,CAAC;IAED,8EAA8E;IAC9E,QAAQ;IACR,8EAA8E;IAEtE,SAAS,CAAC,IAA6B;QAC7C,MAAM,KAAK,GACT,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC;QACtE,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAEnE,MAAM,KAAK,GAAW,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAU,EAAE,EAAE;YAChD,MAAM,GAAG,GAAG,CAA4B,CAAC;YACzC,OAAO;gBACL,EAAE,EAAE,OAAO,GAAG,CAAC,IAAI,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE;gBAC5D,YAAY,EACV,OAAO,GAAG,CAAC,cAAc,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,EAAE;gBACpE,SAAS,EAAE,KAAK;gBAChB,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;oBACzC,CAAC,CAAE,GAAG,CAAC,YAAY,CAAc;oBACjC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;wBAC/B,CAAC,CAAE,GAAG,CAAC,WAAW,CAAc;wBAChC,CAAC,CAAC,EAAE;gBACR,YAAY,EACV,OAAO,GAAG,CAAC,eAAe,CAAC,KAAK,QAAQ;oBACtC,CAAC,CAAC,GAAG,CAAC,eAAe,CAAC;oBACtB,CAAC,CAAC,OAAO,GAAG,CAAC,cAAc,CAAC,KAAK,QAAQ;wBACvC,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC;wBACrB,CAAC,CAAC,SAAS;gBACjB,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;oBAChC,CAAC,CAAE,GAAG,CAAC,OAAO,CAAc;oBAC5B,CAAC,CAAC,SAAS;gBACb,IAAI,EAAE,EAAE;aACT,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,OAAO;YACL,EAAE,EAAE,UAAU,EAAE;YAChB,KAAK;YACL,KAAK;SACN,CAAC;IACJ,CAAC;IAED,8EAA8E;IAC9E,aAAa;IACb,8EAA8E;IAEtE,YAAY,CAAC,IAAU;QAC7B,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAErD,qBAAqB;QACrB,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9B,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;gBACjC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;oBAClD,MAAM,CAAC,IAAI,CACT,SAAS,IAAI,CAAC,EAAE,iBAAiB,GAAG,mDAAmD,CACxF,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;QAED,+BAA+B;QAC/B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9B,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;gBACtB,MAAM,CAAC,IAAI,CAAC,uBAAuB,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;YAClD,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACpB,CAAC;QAED,mBAAmB;QACnB,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/B,MAAM,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;QAC5D,CAAC;QAED,kBAAkB;QAClB,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAEvD,8BAA8B;QAC9B,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,MAAM,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;QACtD,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,cAAc,CAAC,IAAU;QAC/B,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACrD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;QAClC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;QAClC,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAE1D,MAAM,QAAQ,GAAG,CAAC,EAAU,EAAW,EAAE;YACvC,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;gBAAE,OAAO,IAAI,CAAC;YACjC,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;gBAAE,OAAO,KAAK,CAAC;YAClC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChB,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChB,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC7B,IAAI,IAAI,EAAE,CAAC;gBACT,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;oBACjC,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC,GAAG,CAAC;wBAAE,OAAO,IAAI,CAAC;gBACrD,CAAC;YACH,CAAC;YACD,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACnB,OAAO,KAAK,CAAC;QACf,CAAC,CAAC;QAEF,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9B,IAAI,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;gBAAE,OAAO,KAAK,CAAC;QACtC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,qBAAqB,CAAC,KAAa;QACzC,MAAM,MAAM,GAAa,EAAE,CAAC;QAE5B,MAAM,cAAc,GAAG;YACrB,UAAU;YACV,WAAW;YACX,cAAc;YACd,WAAW;YACX,SAAS;SACV,CAAC;QAEF,MAAM,kBAAkB,GAAG;YACzB,WAAW;YACX,SAAS;YACT,SAAS;YACT,OAAO;YACP,OAAO;YACP,QAAQ;SACT,CAAC;QACF,MAAM,aAAa,GAAG,IAAI,GAAG,EAAU,CAAC;QAExC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC;YAClC,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBACpD,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC;QAED,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBAAE,SAAS;YACzC,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC;YAChD,KAAK,MAAM,MAAM,IAAI,cAAc,EAAE,CAAC;gBACpC,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;oBAC7B,MAAM,CAAC,IAAI,CACT,SAAS,IAAI,CAAC,EAAE,8BAA8B,MAAM,8CAA8C,CACnG,CAAC;oBACF,MAAM;gBACR,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,iBAAiB,GAAG;YACxB,SAAS;YACT,OAAO;YACP,QAAQ;YACR,OAAO;YACP,OAAO;YACP,SAAS;SACV,CAAC;QACF,MAAM,YAAY,GAAa,EAAE,CAAC;QAClC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC;YAClC,IAAI,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBACnD,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC;QAED,IAAI,aAAa,CAAC,IAAI,GAAG,CAAC,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtD,KAAK,MAAM,KAAK,IAAI,aAAa,EAAE,CAAC;gBAClC,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,CAAC,CAAC;gBAC9C,IAAI,CAAC,GAAG;oBAAE,SAAS;gBACnB,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;gBAC5C,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;gBACrE,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACvB,MAAM,CAAC,IAAI,CACT,eAAe,KAAK,kDAAkD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC3F,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,8EAA8E;IAC9E,uBAAuB;IACvB,8EAA8E;IAEtE,oBAAoB,CAAC,KAAa;QACxC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,YAAY;gBAAE,SAAS;YACjC,IAAI,CAAC;gBACH,MAAM,MAAM,GACV,OAAO,IAAI,CAAC,YAAY,KAAK,QAAQ;oBACnC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC;oBAC/B,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC;gBACxB,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;oBAClD,IAAI,CAAC,CAAC,MAAM,IAAI,MAAM,CAAC,EAAE,CAAC;wBACvB,MAAkC,CAAC,MAAM,CAAC,GAAG,QAAQ,CAAC;wBACvD,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;oBAC7C,CAAC;gBACH,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,IAAI,CAAC,YAAY,GAAG,SAAS,CAAC;YAChC,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

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

@@ -0,0 +1,38 @@
+/**
+ * DataForSEO search tools.
+ *
+ * Port of:
+ *  - src/nodetool/agents/serp_providers/data_for_seo_provider.py
+ *  - DataForSEO-specific tools from src/nodetool/agents/tools/serp_tools.py
+ */
+import type { ProcessingContext } from "@nodetool-ai/runtime";
+import { Tool } from "./base-tool.js";
+import type { SerpProvider } from "./serp-providers/index.js";
+export declare class DataForSEOSearchTool extends Tool {
+    readonly name = "dataforseo_search";
+    readonly description = "Search Google via DataForSEO to retrieve organic search results.";
+    readonly inputSchema: Record<string, unknown>;
+    private _provider?;
+    constructor(provider?: SerpProvider);
+    process(context: ProcessingContext, params: Record<string, unknown>): Promise<unknown>;
+    userMessage(params: Record<string, unknown>): string;
+}
+export declare class DataForSEONewsTool extends Tool {
+    readonly name = "dataforseo_news";
+    readonly description = "Search Google News via DataForSEO to retrieve live news articles.";
+    readonly inputSchema: Record<string, unknown>;
+    private _provider?;
+    constructor(provider?: SerpProvider);
+    process(context: ProcessingContext, params: Record<string, unknown>): Promise<unknown>;
+    userMessage(params: Record<string, unknown>): string;
+}
+export declare class DataForSEOImagesTool extends Tool {
+    readonly name = "dataforseo_images";
+    readonly description = "Search Google Images via DataForSEO to retrieve image results.";
+    readonly inputSchema: Record<string, unknown>;
+    private _provider?;
+    constructor(provider?: SerpProvider);
+    process(context: ProcessingContext, params: Record<string, unknown>): Promise<unknown>;
+    userMessage(params: Record<string, unknown>): string;
+}
+//# sourceMappingURL=dataseo-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dataseo-tools.d.ts","sourceRoot":"","sources":["../../src/tools/dataseo-tools.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAmH9D,qBAAa,oBAAqB,SAAQ,IAAI;IAC5C,QAAQ,CAAC,IAAI,uBAAuB;IACpC,QAAQ,CAAC,WAAW,sEACiD;IACrE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAc3C;IAEF,OAAO,CAAC,SAAS,CAAC,CAAe;gBAErB,QAAQ,CAAC,EAAE,YAAY;IAK7B,OAAO,CACX,OAAO,EAAE,iBAAiB,EAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,OAAO,CAAC;IA6CnB,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;CAKrD;AAMD,qBAAa,kBAAmB,SAAQ,IAAI;IAC1C,QAAQ,CAAC,IAAI,qBAAqB;IAClC,QAAQ,CAAC,WAAW,uEACkD;IACtE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAc3C;IAEF,OAAO,CAAC,SAAS,CAAC,CAAe;gBAErB,QAAQ,CAAC,EAAE,YAAY;IAK7B,OAAO,CACX,OAAO,EAAE,iBAAiB,EAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,OAAO,CAAC;IAmDnB,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;CAKrD;AAMD,qBAAa,oBAAqB,SAAQ,IAAI;IAC5C,QAAQ,CAAC,IAAI,uBAAuB;IACpC,QAAQ,CAAC,WAAW,oEAC+C;IACnE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAmB3C;IAEF,OAAO,CAAC,SAAS,CAAC,CAAe;gBAErB,QAAQ,CAAC,EAAE,YAAY;IAK7B,OAAO,CACX,OAAO,EAAE,iBAAiB,EAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,OAAO,CAAC;IA+DnB,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;CAQrD"}

package/dist/tools/dataseo-tools.js

@@ -0,0 +1,329 @@
+/**
+ * DataForSEO search tools.
+ *
+ * Port of:
+ *  - src/nodetool/agents/serp_providers/data_for_seo_provider.py
+ *  - DataForSEO-specific tools from src/nodetool/agents/tools/serp_tools.py
+ */
+import { Tool } from "./base-tool.js";
+/* ------------------------------------------------------------------ */
+/*  Helpers                                                           */
+/* ------------------------------------------------------------------ */
+const API_BASE = "https://api.dataforseo.com";
+const DEFAULT_LOCATION_CODE = 2840; // United States
+const DEFAULT_LANGUAGE_CODE = "en";
+async function getDataForSEOCredentials(context) {
+    const login = (await context.getSecret("DATA_FOR_SEO_LOGIN")) ??
+        process.env.DATA_FOR_SEO_LOGIN;
+    const password = (await context.getSecret("DATA_FOR_SEO_PASSWORD")) ??
+        process.env.DATA_FOR_SEO_PASSWORD;
+    if (!login || !password) {
+        throw new Error("DataForSEO credentials (DATA_FOR_SEO_LOGIN, DATA_FOR_SEO_PASSWORD) not found.");
+    }
+    return { login, password };
+}
+function makeAuthHeader(login, password) {
+    const encoded = Buffer.from(`${login}:${password}`).toString("base64");
+    return `Basic ${encoded}`;
+}
+/** Strip base64-encoded images from result objects to keep payloads small. */
+function removeBase64Images(data) {
+    if (Array.isArray(data)) {
+        return data.map(removeBase64Images);
+    }
+    if (data !== null && typeof data === "object") {
+        const out = {};
+        for (const [k, v] of Object.entries(data)) {
+            if (typeof v === "string" && v.startsWith("data:image/"))
+                continue;
+            out[k] = removeBase64Images(v);
+        }
+        return out;
+    }
+    return data;
+}
+async function dataForSEORequest(endpoint, payload, auth) {
+    const url = `${API_BASE}${endpoint}`;
+    try {
+        const res = await fetch(url, {
+            method: "POST",
+            headers: {
+                Authorization: auth,
+                "Content-Type": "application/json"
+            },
+            body: JSON.stringify(payload)
+        });
+        if (!res.ok) {
+            let details;
+            try {
+                details = await res.json();
+            }
+            catch {
+                details = await res.text();
+            }
+            return {
+                error: `HTTP error occurred: ${res.status} - ${res.statusText}`,
+                details
+            };
+        }
+        return (await res.json());
+    }
+    catch (e) {
+        return { error: `DataForSEO request failed: ${e.message}` };
+    }
+}
+function extractItems(result) {
+    if ("error" in result)
+        return result;
+    if (result.status_code !== 20000 || result.status_message !== "Ok.") {
+        return {
+            error: `DataForSEO API Error: ${result.status_code} - ${result.status_message}`,
+            details: result
+        };
+    }
+    const taskResult = result.tasks?.[0]?.result;
+    if (taskResult && Array.isArray(taskResult) && taskResult.length > 0) {
+        return taskResult[0].items ?? [];
+    }
+    return [];
+}
+/* ------------------------------------------------------------------ */
+/*  DataForSEOSearchTool                                              */
+/* ------------------------------------------------------------------ */
+export class DataForSEOSearchTool extends Tool {
+    name = "dataforseo_search";
+    description = "Search Google via DataForSEO to retrieve organic search results.";
+    inputSchema = {
+        type: "object",
+        properties: {
+            keyword: {
+                type: "string",
+                description: "The keyword to search for."
+            },
+            num_results: {
+                type: "integer",
+                description: "Number of results to retrieve.",
+                default: 10
+            }
+        },
+        required: ["keyword"]
+    };
+    _provider;
+    constructor(provider) {
+        super();
+        this._provider = provider;
+    }
+    async process(context, params) {
+        const keyword = params.keyword;
+        if (!keyword)
+            return { error: "keyword is required" };
+        const numResults = params.num_results ?? 10;
+        let creds;
+        try {
+            creds = await getDataForSEOCredentials(context);
+        }
+        catch (e) {
+            return { error: e.message };
+        }
+        const auth = makeAuthHeader(creds.login, creds.password);
+        const payload = [
+            {
+                keyword,
+                location_code: DEFAULT_LOCATION_CODE,
+                language_code: DEFAULT_LANGUAGE_CODE,
+                device: "desktop",
+                os: "windows",
+                depth: numResults
+            }
+        ];
+        const result = await dataForSEORequest("/v3/serp/google/organic/live/advanced", payload, auth);
+        const items = extractItems(result);
+        if (!Array.isArray(items))
+            return items;
+        const organicResults = items
+            .filter((item) => item.type === "organic")
+            .map((item) => ({
+            title: item.title ?? null,
+            url: item.url ?? null,
+            snippet: item.description ?? null,
+            position: item.rank_absolute ?? null,
+            type: "organic"
+        }));
+        return { success: true, results: removeBase64Images(organicResults) };
+    }
+    userMessage(params) {
+        const keyword = params.keyword ?? "something";
+        const msg = `Searching Google (DataForSEO) for '${keyword}'...`;
+        return msg.length > 80 ? "Searching Google (DataForSEO)..." : msg;
+    }
+}
+/* ------------------------------------------------------------------ */
+/*  DataForSEONewsTool                                                */
+/* ------------------------------------------------------------------ */
+export class DataForSEONewsTool extends Tool {
+    name = "dataforseo_news";
+    description = "Search Google News via DataForSEO to retrieve live news articles.";
+    inputSchema = {
+        type: "object",
+        properties: {
+            keyword: {
+                type: "string",
+                description: "The keyword to search for in Google News."
+            },
+            num_results: {
+                type: "integer",
+                description: "Number of news results to retrieve.",
+                default: 10
+            }
+        },
+        required: ["keyword"]
+    };
+    _provider;
+    constructor(provider) {
+        super();
+        this._provider = provider;
+    }
+    async process(context, params) {
+        const keyword = params.keyword;
+        if (!keyword)
+            return { error: "keyword is required" };
+        const numResults = params.num_results ?? 10;
+        let creds;
+        try {
+            creds = await getDataForSEOCredentials(context);
+        }
+        catch (e) {
+            return { error: e.message };
+        }
+        const auth = makeAuthHeader(creds.login, creds.password);
+        const payload = [
+            {
+                keyword,
+                location_code: DEFAULT_LOCATION_CODE,
+                language_code: DEFAULT_LANGUAGE_CODE,
+                sort_by: "relevance",
+                depth: numResults
+            }
+        ];
+        const result = await dataForSEORequest("/v3/serp/google/news/live/advanced", payload, auth);
+        const items = extractItems(result);
+        if (!Array.isArray(items))
+            return items;
+        const newsResults = items
+            .filter((item) => item.type === "news_search" || item.type === "top_stories")
+            .map((item) => {
+            const timestamp = item.timestamp;
+            const publishedAt = timestamp ? timestamp.split(" ")[0] : null;
+            return {
+                title: item.title ?? null,
+                url: item.url ?? null,
+                source: item.source ?? null,
+                published_at: publishedAt,
+                snippet: item.description ?? null,
+                type: "news"
+            };
+        });
+        return { success: true, results: removeBase64Images(newsResults) };
+    }
+    userMessage(params) {
+        const keyword = params.keyword ?? "something";
+        const msg = `Searching Google News (DataForSEO) for '${keyword}'...`;
+        return msg.length > 80 ? "Searching Google News (DataForSEO)..." : msg;
+    }
+}
+/* ------------------------------------------------------------------ */
+/*  DataForSEOImagesTool                                              */
+/* ------------------------------------------------------------------ */
+export class DataForSEOImagesTool extends Tool {
+    name = "dataforseo_images";
+    description = "Search Google Images via DataForSEO to retrieve image results.";
+    inputSchema = {
+        type: "object",
+        properties: {
+            keyword: {
+                type: "string",
+                description: "Keyword for image search. (Optional if image_url is provided)"
+            },
+            image_url: {
+                type: "string",
+                description: "URL of an image for reverse search. (Optional if keyword is provided)"
+            },
+            num_results: {
+                type: "integer",
+                description: "Number of image results to retrieve.",
+                default: 20
+            }
+        }
+    };
+    _provider;
+    constructor(provider) {
+        super();
+        this._provider = provider;
+    }
+    async process(context, params) {
+        const keyword = params.keyword;
+        const imageUrl = params.image_url;
+        const numResults = params.num_results ?? 20;
+        if (!keyword && !imageUrl) {
+            return {
+                error: "One of 'keyword' or 'image_url' is required for image search."
+            };
+        }
+        let creds;
+        try {
+            creds = await getDataForSEOCredentials(context);
+        }
+        catch (e) {
+            return { error: e.message };
+        }
+        const auth = makeAuthHeader(creds.login, creds.password);
+        const payloadDict = {
+            location_code: DEFAULT_LOCATION_CODE,
+            language_code: DEFAULT_LANGUAGE_CODE,
+            depth: numResults
+        };
+        if (keyword)
+            payloadDict.keyword = keyword;
+        if (imageUrl)
+            payloadDict.image_url = imageUrl;
+        const result = await dataForSEORequest("/v3/serp/google/images/live/advanced", [payloadDict], auth);
+        const items = extractItems(result);
+        if (!Array.isArray(items))
+            return items;
+        const imageResults = [];
+        for (const item of items) {
+            if (item.type === "images_search") {
+                imageResults.push({
+                    title: item.title ?? null,
+                    image_url: item.image_url ?? null,
+                    source_url: item.source_url ?? null,
+                    alt_text: item.alt ?? null,
+                    type: "image"
+                });
+            }
+            else if (item.type === "carousel" && Array.isArray(item.items)) {
+                for (const ci of item.items) {
+                    if (ci.type === "carousel_element" && ci.image_url) {
+                        imageResults.push({
+                            title: ci.title ?? null,
+                            image_url: ci.image_url ?? null,
+                            source_url: ci.url ?? null,
+                            alt_text: ci.title ?? null,
+                            type: "image_carousel_element"
+                        });
+                    }
+                }
+            }
+        }
+        return { success: true, results: removeBase64Images(imageResults) };
+    }
+    userMessage(params) {
+        const keyword = params.keyword;
+        if (keyword) {
+            const msg = `Searching Google Images (DataForSEO) for '${keyword}'...`;
+            return msg.length > 80 ? "Searching Google Images (DataForSEO)..." : msg;
+        }
+        return "Searching Google Images (DataForSEO)...";
+    }
+}
+//# sourceMappingURL=dataseo-tools.js.map