@nodetool-ai/agents 0.7.0-rc.11

package/dist/agent-workflow-runner.js

@@ -0,0 +1,124 @@
+/**
+ * AgentWorkflowRunner -- executes a graph plan via the kernel's WorkflowRunner.
+ *
+ * Takes a GraphData (produced by GraphPlanner) and runs it through the kernel.
+ * Agent step nodes are resolved via AgentStepExecutor; deterministic nodes
+ * are resolved via the provided NodeRegistry.
+ */
+import { WorkflowRunner } from "@nodetool-ai/kernel";
+import { createLogger } from "@nodetool-ai/config";
+import { AGENT_STEP_NODE_TYPE } from "./graph-builder.js";
+import { AgentStepExecutor } from "./agent-step-executor.js";
+import { randomUUID } from "node:crypto";
+const log = createLogger("nodetool.agents.workflow-runner");
+export class AgentWorkflowRunner {
+    opts;
+    constructor(opts) {
+        this.opts = opts;
+    }
+    /**
+     * Execute a graph plan and yield ProcessingMessages live as the kernel emits them.
+     */
+    async *execute(graphData) {
+        const jobId = randomUUID();
+        const { provider, model, registry, tools, context } = this.opts;
+        const runner = new WorkflowRunner(jobId, {
+            resolveExecutor: (node) => {
+                if (node.type === AGENT_STEP_NODE_TYPE) {
+                    return new AgentStepExecutor(node, {
+                        provider,
+                        model,
+                        tools,
+                        systemPrompt: this.opts.systemPrompt,
+                        maxTokenLimit: this.opts.maxTokenLimit,
+                        maxIterations: this.opts.maxStepIterations
+                    });
+                }
+                return registry.resolve(node);
+            },
+            executionContext: context
+        });
+        log.info("Executing agent graph", {
+            jobId,
+            nodes: graphData.nodes.length,
+            edges: graphData.edges.length
+        });
+        // Intercept context.emit to stream kernel messages live to our generator.
+        const queue = [];
+        let waiter = null;
+        const wake = () => {
+            const w = waiter;
+            waiter = null;
+            w?.();
+        };
+        const ctx = context;
+        const origEmit = ctx.emit.bind(context);
+        ctx.emit = (msg) => {
+            origEmit(msg);
+            queue.push(msg);
+            wake();
+        };
+        let runError = null;
+        let done = false;
+        const runPromise = runner
+            .run({ job_id: jobId, params: this.opts.inputs }, graphData)
+            .catch((err) => {
+            runError = err;
+            return undefined;
+        })
+            .finally(() => {
+            done = true;
+            wake();
+        });
+        try {
+            while (true) {
+                while (queue.length > 0) {
+                    yield queue.shift();
+                }
+                if (done)
+                    break;
+                await new Promise((resolve) => {
+                    waiter = resolve;
+                });
+            }
+        }
+        finally {
+            ctx.emit = origEmit;
+        }
+        if (runError) {
+            throw runError instanceof Error
+                ? runError
+                : new Error(String(runError));
+        }
+        const result = await runPromise;
+        if (!result) {
+            throw new Error("Workflow execution produced no result");
+        }
+        if (result.status === "failed") {
+            throw new Error(result.error ?? "Workflow execution failed");
+        }
+        const nodeErrors = (result.messages ?? []).filter((m) => m.type === "node_update" && m.status === "error");
+        if (nodeErrors.length > 0) {
+            log.error("Node execution errors", {
+                count: nodeErrors.length,
+                first: nodeErrors[0].error
+            });
+        }
+        log.info("Agent graph execution complete", {
+            jobId,
+            status: result.status,
+            outputKeys: Object.keys(result.outputs)
+        });
+        // Yield a final step_result with the graph outputs so callers can
+        // capture the result (MultiModeAgent checks is_task_result).
+        if (result.status === "completed" && Object.keys(result.outputs).length > 0) {
+            yield {
+                type: "step_result",
+                step: { name: "graph_execution", status: "completed" },
+                result: result.outputs,
+                is_task_result: true
+            };
+        }
+    }
+}
+//# sourceMappingURL=agent-workflow-runner.js.map

package/dist/agent-workflow-runner.js.map

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

package/dist/agent.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Agent -- orchestrates AI-driven task execution using LLMs and Tools.
+ *
+ * Port of src/nodetool/agents/agent.py (simplified for TypeScript).
+ *
+ * The Agent class takes a complex objective, decomposes it into a step-by-step
+ * plan using TaskPlanner, then executes that plan via TaskExecutor.
+ * Supports loading skills from the filesystem.
+ */
+import type { BaseProvider } from "@nodetool-ai/runtime";
+import type { ProcessingContext } from "@nodetool-ai/runtime";
+import type { ProcessingMessage } from "@nodetool-ai/protocol";
+import { BaseAgent } from "./base-agent.js";
+import type { Tool } from "./tools/base-tool.js";
+import type { Task, TaskPlan } from "./types.js";
+import { type AgentOutputFormat } from "./output-format.js";
+export interface AgentSkill {
+    name: string;
+    description: string;
+    instructions: string;
+    path: string;
+}
+/**
+ * Parse minimal YAML frontmatter (key: value pairs).
+ */
+export declare function parseFrontmatter(frontmatter: string): Record<string, string>;
+/**
+ * Load all valid skills from a directory (recursively searches for SKILL.md files).
+ */
+export declare function loadSkillsFromDirectory(dir: string): Promise<AgentSkill[]>;
+export interface AgentOptions {
+    name: string;
+    objective: string;
+    provider: BaseProvider;
+    model: string;
+    /** Model used for planning phase. Defaults to `model`. */
+    planningModel?: string;
+    /** Model used for reasoning/refinement within the planner. Defaults to `model`. */
+    reasoningModel?: string;
+    description?: string;
+    tools?: Tool[];
+    inputs?: Record<string, unknown>;
+    systemPrompt?: string;
+    maxTokenLimit?: number;
+    workspace?: string;
+    maxSteps?: number;
+    maxStepIterations?: number;
+    outputSchema?: Record<string, unknown>;
+    /**
+     * Format for the agent's final result.
+     * - "structured" (default): honors `outputSchema`; finish_step returns JSON.
+     * - "markdown" / "text" / "html": final result is a string in that format.
+     *   `outputSchema` is ignored.
+     */
+    outputFormat?: AgentOutputFormat;
+    /** Pre-defined task to execute, skipping the planning phase. */
+    task?: Task;
+    skills?: string[];
+    skillDirs?: string[];
+}
+export declare class Agent extends BaseAgent {
+    private readonly description;
+    private readonly planningModel;
+    private readonly reasoningModel;
+    private readonly maxSteps;
+    private readonly maxStepIterations;
+    private readonly outputSchema?;
+    private readonly outputFormat;
+    private readonly workspace?;
+    private readonly requestedSkills?;
+    private readonly skillDirs;
+    private readonly initialTask?;
+    /** The multi-task plan, set after planning. */
+    taskPlan: TaskPlan | null;
+    constructor(opts: AgentOptions);
+    /**
+     * Resolve skill directories from constructor args + environment + defaults.
+     */
+    private resolveSkillDirs;
+    /**
+     * Discover all valid skills from resolved directories.
+     */
+    private discoverSkills;
+    /**
+     * Resolve active skills: explicit names first, then auto-match by objective words.
+     */
+    private resolveActiveSkills;
+    /**
+     * Build system prompt segment from active skills.
+     */
+    private buildSkillSystemPrompt;
+    /**
+     * Build effective objective enriched with skill summaries.
+     */
+    private buildEffectiveObjective;
+    /**
+     * Merge user system prompt with skill system prompt.
+     */
+    private mergeSystemPrompt;
+    execute(context: ProcessingContext): AsyncGenerator<ProcessingMessage>;
+    private _executeImpl;
+    /**
+     * Run a final LLM call that synthesizes all task results into one coherent
+     * response for the user. Streams chunks as ProcessingMessage so the UI sees
+     * the answer being composed in real time. Sets `this.results` to the
+     * synthesized string (or wraps in the outputSchema shape).
+     */
+    private synthesizeFinalResponse;
+    /**
+     * Execute a single pre-defined task (legacy path for backward compatibility).
+     */
+    private executeSingleTask;
+    getResults(): unknown;
+}
+//# sourceMappingURL=agent.d.ts.map

package/dist/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAIzD,OAAO,KAAK,EAAW,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,KAAK,EACV,iBAAiB,EAKlB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAI5C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEjD,OAAO,EACL,KAAK,iBAAiB,EAEvB,MAAM,oBAAoB,CAAC;AAM5B,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;CACd;AAOD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAmB5E;AAmED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,UAAU,EAAE,CAAC,CAQvB;AAsBD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,YAAY,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mFAAmF;IACnF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC;;;;;OAKG;IACH,YAAY,CAAC,EAAE,iBAAiB,CAAC;IACjC,gEAAgE;IAChE,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,qBAAa,KAAM,SAAQ,SAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAA0B;IACxD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAoB;IACjD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAW;IAC5C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAW;IACrC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAO;IACpC,+CAA+C;IAC/C,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAQ;gBAErB,IAAI,EAAE,YAAY;IA8B9B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAiCxB;;OAEG;YACW,cAAc;IAoB5B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAsD3B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAY9B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAQ/B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAUlB,OAAO,CACZ,OAAO,EAAE,iBAAiB,GACzB,cAAc,CAAC,iBAAiB,CAAC;YAcrB,YAAY;IAsK3B;;;;;OAKG;YACY,uBAAuB;IAqFtC;;OAEG;YACY,iBAAiB;IA2DhC,UAAU,IAAI,OAAO;CAGtB"}