@nodetool-ai/agents 0.7.0-rc.11

package/dist/agent-executor.d.ts

@@ -0,0 +1,62 @@
+/**
+ * AgentExecutor -- value-based task execution using LLM interactions.
+ *
+ * Port of src/nodetool/agents/agent_executor.py
+ *
+ * A simplified executor that operates on Python/JS values instead of files.
+ * Maintains output type handling while removing file operations.
+ */
+import type { BaseProvider, ProcessingContext, ToolCall } from "@nodetool-ai/runtime";
+import type { Chunk } from "@nodetool-ai/protocol";
+import { Tool } from "./tools/base-tool.js";
+export declare function jsonSchemaForOutputType(type: string): Record<string, unknown>;
+export declare class FinishTool extends Tool {
+    readonly name = "finish_task";
+    readonly description = "Finish the task by providing the final result value and metadata.";
+    readonly inputSchema: Record<string, unknown>;
+    constructor(outputType: string, outputSchema: Record<string, unknown> | null);
+    process(_context: ProcessingContext, params: Record<string, unknown>): Promise<unknown>;
+}
+export interface AgentExecutorOptions {
+    provider: BaseProvider;
+    model: string;
+    context: ProcessingContext;
+    tools: Tool[];
+    systemPrompt?: string;
+    maxIterations?: number;
+    outputType?: string;
+    outputSchema?: Record<string, unknown> | null;
+    threadId?: string;
+}
+export declare class AgentExecutor {
+    private readonly provider;
+    private readonly model;
+    private readonly context;
+    private readonly tools;
+    private readonly finishTool;
+    private readonly maxIterations;
+    private readonly outputType;
+    private readonly systemPrompt;
+    private readonly threadId?;
+    private history;
+    private iterations;
+    private completed;
+    private _result;
+    private _metadata;
+    constructor(options: AgentExecutorOptions);
+    private createSystemPrompt;
+    /**
+     * Check if the provider supports native agentic tool execution.
+     */
+    private isAgenticProvider;
+    execute(objective: string, inputs?: Record<string, unknown>): AsyncGenerator<Chunk | ToolCall>;
+    /**
+     * Agentic execution: single provider call handles all tool calls via MCP.
+     * The onToolCall callback executes tools natively; finish_task signals completion.
+     */
+    private executeAgentic;
+    private handleToolCall;
+    getResult(): unknown;
+    getMetadata(): Record<string, unknown> | null;
+}
+//# sourceMappingURL=agent-executor.d.ts.map

package/dist/agent-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-executor.d.ts","sourceRoot":"","sources":["../src/agent-executor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,iBAAiB,EAEjB,QAAQ,EAET,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAe5C,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAkB7E;AAED,qBAAa,UAAW,SAAQ,IAAI;IAClC,QAAQ,CAAC,IAAI,iBAAiB;IAC9B,QAAQ,CAAC,WAAW,uEACkD;IACtE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAG5C,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAgBxC,OAAO,CACX,QAAQ,EAAE,iBAAiB,EAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,OAAO,CAAC;CAGpB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,YAAY,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,iBAAiB,CAAC;IAC3B,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAOD,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;IAC5C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAS;IACnC,OAAO,CAAC,OAAO,CAAY;IAC3B,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,SAAS,CAAwC;gBAE7C,OAAO,EAAE,oBAAoB;IAiBzC,OAAO,CAAC,kBAAkB;IA0B1B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAOlB,OAAO,CACZ,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,cAAc,CAAC,KAAK,GAAG,QAAQ,CAAC;IAuGnC;;;OAGG;YACY,cAAc;YAuGf,cAAc;IAa5B,SAAS,IAAI,OAAO;IAIpB,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAG9C"}

package/dist/agent-executor.js

@@ -0,0 +1,324 @@
+/**
+ * AgentExecutor -- value-based task execution using LLM interactions.
+ *
+ * Port of src/nodetool/agents/agent_executor.py
+ *
+ * A simplified executor that operates on Python/JS values instead of files.
+ * Maintains output type handling while removing file operations.
+ */
+import { Tool } from "./tools/base-tool.js";
+const DEFAULT_MAX_ITERATIONS = 10;
+const METADATA_SCHEMA = {
+    type: "object",
+    properties: {
+        title: { type: "string" },
+        description: { type: "string" },
+        sources: { type: "array", items: { type: "string" } }
+    },
+    required: ["title", "description"],
+    additionalProperties: true
+};
+export function jsonSchemaForOutputType(type) {
+    const schemas = {
+        json: { type: "object", description: "JSON object" },
+        list: { type: "array", description: "Array of values" },
+        string: { type: "string", description: "Text string" },
+        number: { type: "number", description: "Numeric value" },
+        boolean: { type: "boolean", description: "Boolean value" },
+        markdown: { type: "string", description: "Markdown formatted text" },
+        html: { type: "string", description: "HTML markup" },
+        csv: { type: "string", description: "CSV formatted data" },
+        yaml: { type: "string", description: "YAML formatted data" }
+    };
+    return (schemas[type] ?? {
+        type: "string",
+        description: `Output of type ${type}`
+    });
+}
+export class FinishTool extends Tool {
+    name = "finish_task";
+    description = "Finish the task by providing the final result value and metadata.";
+    inputSchema;
+    constructor(outputType, outputSchema) {
+        super();
+        const resultSchema = outputSchema ?? jsonSchemaForOutputType(outputType);
+        this.inputSchema = {
+            type: "object",
+            properties: {
+                result: resultSchema,
+                metadata: METADATA_SCHEMA
+            },
+            required: ["result", "metadata"],
+            additionalProperties: false
+        };
+    }
+    async process(_context, params) {
+        return params;
+    }
+}
+export class AgentExecutor {
+    provider;
+    model;
+    context;
+    tools;
+    finishTool;
+    maxIterations;
+    outputType;
+    systemPrompt;
+    threadId;
+    history;
+    iterations = 0;
+    completed = false;
+    _result = null;
+    _metadata = null;
+    constructor(options) {
+        this.provider = options.provider;
+        this.model = options.model;
+        this.context = options.context;
+        this.outputType = options.outputType ?? "string";
+        this.threadId = options.threadId;
+        this.maxIterations = options.maxIterations ?? DEFAULT_MAX_ITERATIONS;
+        this.finishTool = new FinishTool(this.outputType, options.outputSchema ?? null);
+        this.tools = [...options.tools, this.finishTool];
+        this.systemPrompt = options.systemPrompt ?? this.createSystemPrompt("");
+        this.history = [{ role: "system", content: this.systemPrompt }];
+    }
+    createSystemPrompt(objective) {
+        return `You are an AI agent executing a focused objective. Produce a result of type '${this.outputType}'.
+
+## Operating Mode
+- Keep going until the objective is completed; do not hand back early.
+- Resolve ambiguity by making reasonable assumptions and record them in \`metadata.notes\`.
+- Prefer tool calls and concrete actions over clarifying questions.
+- Do not reveal chain-of-thought; output only tool calls and required fields.
+
+## Communication Pattern (Tool Preambles)
+- First assistant message: restate the objective in one sentence and list a 1-3 step plan.
+- Before each tool call, add a one-sentence rationale describing what and why.
+- After tool results, update the plan only if it materially changes.
+
+## Execution Protocol
+1. Focus on the objective: ${objective}
+2. Use the provided input values efficiently.
+3. Perform the minimal steps required to generate the result.
+4. Ensure the final result matches the expected output type: ${this.outputType}.
+5. Call \`finish_task\` exactly once at the end with final \`result\` and \`metadata\` (title, description, sources, notes).
+
+## Output Discipline
+- Prefer deterministic, structured outputs over prose.
+- Do not include multi-paragraph docstrings, multi-line comment blocks, or planning documents unless explicitly requested.`;
+    }
+    /**
+     * Check if the provider supports native agentic tool execution.
+     */
+    isAgenticProvider() {
+        return (this.provider.provider ===
+            "claude_agent");
+    }
+    async *execute(objective, inputs) {
+        const promptParts = [`**Objective:**\n${objective}\n`];
+        if (inputs && Object.keys(inputs).length > 0) {
+            const inputStr = Object.entries(inputs)
+                .map(([key, val]) => `- ${key}: ${formatValue(val)}`)
+                .join("\n");
+            promptParts.push(`**Input Values:**\n${inputStr}\n`);
+        }
+        promptParts.push("Please complete the objective using the provided input values.");
+        this.history.push({
+            role: "user",
+            content: promptParts.join("\n")
+        });
+        const providerTools = this.tools.map((t) => t.toProviderTool());
+        // --- Agentic provider fast-path ---
+        // The provider handles the full tool loop in a single call via MCP.
+        if (this.isAgenticProvider()) {
+            yield* this.executeAgentic(providerTools);
+            return;
+        }
+        // --- Standard multi-iteration loop (for non-agentic providers) ---
+        while (!this.completed && this.iterations < this.maxIterations) {
+            this.iterations += 1;
+            const response = await this.provider.generateMessageTraced({
+                messages: this.history,
+                model: this.model,
+                tools: providerTools,
+                threadId: this.threadId
+            });
+            if (response.content) {
+                yield {
+                    type: "chunk",
+                    content: String(response.content)
+                };
+            }
+            const assistantMessage = {
+                role: "assistant",
+                content: response.content,
+                toolCalls: response.toolCalls ?? undefined
+            };
+            this.history.push(assistantMessage);
+            if (response.toolCalls) {
+                for (const toolCall of response.toolCalls) {
+                    yield toolCall;
+                    const result = await this.handleToolCall(toolCall);
+                    let serialized;
+                    if (result == null) {
+                        serialized = "Tool returned no output.";
+                    }
+                    else {
+                        try {
+                            serialized = JSON.stringify(result);
+                        }
+                        catch {
+                            serialized = JSON.stringify({
+                                error: "Failed to serialize tool result",
+                                result_repr: String(result)
+                            });
+                        }
+                    }
+                    this.history.push({
+                        role: "tool",
+                        content: serialized,
+                        toolCallId: toolCall.id
+                    });
+                    if (toolCall.name === "finish_task") {
+                        this.completed = true;
+                        this._result = toolCall.args.result ?? null;
+                        this._metadata =
+                            toolCall.args.metadata ?? null;
+                        break;
+                    }
+                }
+            }
+        }
+        if (!this.completed) {
+            this.completed = true;
+            this._result = `Task incomplete after ${this.maxIterations} iterations`;
+            this._metadata = {
+                title: "Incomplete Task",
+                description: "Task did not complete within iteration limit",
+                sources: []
+            };
+        }
+    }
+    /**
+     * Agentic execution: single provider call handles all tool calls via MCP.
+     * The onToolCall callback executes tools natively; finish_task signals completion.
+     */
+    async *executeAgentic(providerTools) {
+        const finishTaskState = { args: null };
+        const getFinishTaskArgs = () => finishTaskState.args;
+        const onToolCall = async (name, args) => {
+            if (name === "finish_task") {
+                finishTaskState.args = args;
+                return JSON.stringify({ status: "finished" });
+            }
+            const tool = this.tools.find((t) => t.name === name);
+            if (!tool)
+                return JSON.stringify({ error: `Unknown tool: ${name}` });
+            try {
+                const result = await tool.process(this.context, args);
+                const raw = typeof result === "string" ? result : JSON.stringify(result ?? null);
+                if (raw.length > 25_000) {
+                    return (raw.slice(0, 25_000) +
+                        `\n...[truncated ${raw.length - 25_000} chars]`);
+                }
+                return raw;
+            }
+            catch (e) {
+                return JSON.stringify({ error: String(e) });
+            }
+        };
+        const response = await this.provider.generateMessageTraced({
+            messages: this.history,
+            model: this.model,
+            tools: providerTools,
+            threadId: this.threadId,
+            onToolCall
+        });
+        if (response.content) {
+            yield { type: "chunk", content: String(response.content) };
+        }
+        // Yield tool calls for tracking
+        if (response.toolCalls) {
+            for (const tc of response.toolCalls) {
+                yield tc;
+            }
+        }
+        // Check if finish_task was called via MCP
+        const initialFinishTaskArgs = getFinishTaskArgs();
+        if (initialFinishTaskArgs) {
+            this.completed = true;
+            this._result = initialFinishTaskArgs.result ?? null;
+            this._metadata = initialFinishTaskArgs.metadata ?? null;
+            return;
+        }
+        // Fallback: send a nudge to call finish_task
+        const nudgeMessages = [
+            ...this.history,
+            { role: "assistant", content: String(response.content ?? "") },
+            {
+                role: "user",
+                content: `Now call finish_task with the final result and metadata. The result type should be '${this.outputType}'.`
+            }
+        ];
+        finishTaskState.args = null;
+        const nudgeResponse = await this.provider.generateMessageTraced({
+            messages: nudgeMessages,
+            model: this.model,
+            tools: providerTools,
+            threadId: this.threadId,
+            onToolCall
+        });
+        if (nudgeResponse.content) {
+            yield { type: "chunk", content: String(nudgeResponse.content) };
+        }
+        if (nudgeResponse.toolCalls) {
+            for (const tc of nudgeResponse.toolCalls) {
+                yield tc;
+            }
+        }
+        const nudgedFinishTaskArgs = getFinishTaskArgs();
+        if (nudgedFinishTaskArgs) {
+            this.completed = true;
+            this._result = nudgedFinishTaskArgs.result ?? null;
+            this._metadata = nudgedFinishTaskArgs.metadata ?? null;
+        }
+        else {
+            this.completed = true;
+            this._result = String(response.content ?? "Task incomplete");
+            this._metadata = {
+                title: "Incomplete Task",
+                description: "finish_task was not called"
+            };
+        }
+    }
+    async handleToolCall(toolCall) {
+        const tool = this.tools.find((t) => t.name === toolCall.name);
+        if (!tool) {
+            return { error: `Tool ${toolCall.name} not found` };
+        }
+        try {
+            return await tool.process(this.context, toolCall.args);
+        }
+        catch (e) {
+            return { error: String(e) };
+        }
+    }
+    getResult() {
+        return this._result;
+    }
+    getMetadata() {
+        return this._metadata;
+    }
+}
+function formatValue(value) {
+    if (typeof value === "string") {
+        return value.length > 200 ? value.slice(0, 200) + "..." : value;
+    }
+    if (typeof value === "object" && value !== null) {
+        const formatted = JSON.stringify(value, null, 2);
+        return formatted.length > 200 ? formatted.slice(0, 200) + "..." : formatted;
+    }
+    return String(value);
+}
+//# sourceMappingURL=agent-executor.js.map

package/dist/agent-executor.js.map

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

package/dist/agent-step-executor.d.ts

@@ -0,0 +1,28 @@
+/**
+ * AgentStepExecutor -- a NodeExecutor adapter that wraps StepExecutor.
+ *
+ * This bridges the agent system into the kernel: when WorkflowRunner encounters
+ * a node of type "nodetool.agents.AgentStep", it resolves to this executor.
+ * The executor creates a StepExecutor internally, runs the LLM tool-calling
+ * loop, forwards ProcessingMessages via context.emit(), and returns the
+ * final result as a Record for downstream kernel routing.
+ */
+import type { NodeExecutor } from "@nodetool-ai/runtime";
+import type { ProcessingContext, BaseProvider } from "@nodetool-ai/runtime";
+import type { NodeDescriptor } from "@nodetool-ai/protocol";
+import type { Tool } from "./tools/base-tool.js";
+export interface AgentStepExecutorOptions {
+    provider: BaseProvider;
+    model: string;
+    tools: Tool[];
+    systemPrompt?: string;
+    maxTokenLimit?: number;
+    maxIterations?: number;
+}
+export declare class AgentStepExecutor implements NodeExecutor {
+    private readonly node;
+    private readonly opts;
+    constructor(node: NodeDescriptor, opts: AgentStepExecutorOptions);
+    process(inputs: Record<string, unknown>, context?: ProcessingContext): Promise<Record<string, unknown>>;
+}
+//# sourceMappingURL=agent-step-executor.d.ts.map

package/dist/agent-step-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-step-executor.d.ts","sourceRoot":"","sources":["../src/agent-step-executor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAC5E,OAAO,KAAK,EACV,cAAc,EAGf,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAIjD,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,YAAY,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AA4CD,qBAAa,iBAAkB,YAAW,YAAY;IACpD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAiB;IACtC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA2B;gBAEpC,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,wBAAwB;IAK1D,OAAO,CACX,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAoDpC"}

package/dist/agent-step-executor.js

@@ -0,0 +1,99 @@
+/**
+ * AgentStepExecutor -- a NodeExecutor adapter that wraps StepExecutor.
+ *
+ * This bridges the agent system into the kernel: when WorkflowRunner encounters
+ * a node of type "nodetool.agents.AgentStep", it resolves to this executor.
+ * The executor creates a StepExecutor internally, runs the LLM tool-calling
+ * loop, forwards ProcessingMessages via context.emit(), and returns the
+ * final result as a Record for downstream kernel routing.
+ */
+import { StepExecutor } from "./step-executor.js";
+import { randomUUID } from "node:crypto";
+/**
+ * Build a Step object from a NodeDescriptor with AgentStep properties.
+ */
+function stepFromDescriptor(node) {
+    const props = (node.properties ?? {});
+    return {
+        id: node.id,
+        instructions: typeof props["instructions"] === "string" ? props["instructions"] : "",
+        completed: false,
+        dependsOn: [],
+        outputSchema: typeof props["output_schema"] === "string"
+            ? props["output_schema"]
+            : undefined,
+        tools: Array.isArray(props["tools"])
+            ? props["tools"]
+            : undefined,
+        logs: []
+    };
+}
+/**
+ * Format upstream inputs (arriving via kernel edges) into a context string
+ * that gets prepended to the step instructions.
+ */
+function formatUpstreamContext(inputs) {
+    const entries = Object.entries(inputs).filter(([, v]) => v !== undefined && v !== null);
+    if (entries.length === 0)
+        return "";
+    const sections = entries.map(([key, value]) => {
+        const serialized = typeof value === "string" ? value : JSON.stringify(value, null, 2);
+        return `## Input "${key}":\n${serialized}`;
+    });
+    return ("# Upstream Results\n\n" + sections.join("\n\n") + "\n\n---\n\n");
+}
+export class AgentStepExecutor {
+    node;
+    opts;
+    constructor(node, opts) {
+        this.node = node;
+        this.opts = opts;
+    }
+    async process(inputs, context) {
+        const step = stepFromDescriptor(this.node);
+        const task = {
+            id: randomUUID(),
+            title: step.instructions.slice(0, 80),
+            steps: [step]
+        };
+        // Prepend upstream results to step instructions
+        const upstreamContext = formatUpstreamContext(inputs);
+        if (upstreamContext) {
+            step.instructions = upstreamContext + step.instructions;
+        }
+        // Filter tools if the step specifies a subset
+        let tools = this.opts.tools;
+        if (step.tools && step.tools.length > 0) {
+            const allowedNames = new Set(step.tools);
+            tools = tools.filter((t) => allowedNames.has(t.name));
+        }
+        const executor = new StepExecutor({
+            task,
+            step,
+            context: context,
+            provider: this.opts.provider,
+            model: this.opts.model,
+            tools,
+            systemPrompt: this.opts.systemPrompt,
+            maxTokenLimit: this.opts.maxTokenLimit,
+            maxIterations: this.opts.maxIterations
+        });
+        let result = null;
+        for await (const msg of executor.execute()) {
+            // Forward processing messages for UI updates
+            if (context) {
+                context.emit(msg);
+            }
+            if (msg.type === "step_result") {
+                result = msg.result;
+            }
+        }
+        // Also store in context for backwards compat with code reading from context
+        if (context) {
+            context.set(this.node.id, result);
+        }
+        // Use "output" as the handle name so downstream nodes can connect via .output
+        return { output: result, result };
+    }
+}
+//# sourceMappingURL=agent-step-executor.js.map

package/dist/agent-step-executor.js.map

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

package/dist/agent-workflow-runner.d.ts

@@ -0,0 +1,31 @@
+/**
+ * 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 type { NodeRegistry } from "@nodetool-ai/node-sdk";
+import type { BaseProvider, ProcessingContext } from "@nodetool-ai/runtime";
+import type { GraphData, ProcessingMessage } from "@nodetool-ai/protocol";
+import type { Tool } from "./tools/base-tool.js";
+export interface AgentWorkflowRunnerOptions {
+    provider: BaseProvider;
+    model: string;
+    registry: NodeRegistry;
+    tools: Tool[];
+    context: ProcessingContext;
+    systemPrompt?: string;
+    maxTokenLimit?: number;
+    maxStepIterations?: number;
+    inputs?: Record<string, unknown>;
+}
+export declare class AgentWorkflowRunner {
+    private readonly opts;
+    constructor(opts: AgentWorkflowRunnerOptions);
+    /**
+     * Execute a graph plan and yield ProcessingMessages live as the kernel emits them.
+     */
+    execute(graphData: GraphData): AsyncGenerator<ProcessingMessage>;
+}
+//# sourceMappingURL=agent-workflow-runner.d.ts.map

package/dist/agent-workflow-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-workflow-runner.d.ts","sourceRoot":"","sources":["../src/agent-workflow-runner.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC5E,OAAO,KAAK,EACV,SAAS,EACT,iBAAiB,EAGlB,MAAM,uBAAuB,CAAC;AAI/B,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAKjD,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,YAAY,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,YAAY,CAAC;IACvB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,OAAO,EAAE,iBAAiB,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA6B;gBAEtC,IAAI,EAAE,0BAA0B;IAI5C;;OAEG;IACI,OAAO,CACZ,SAAS,EAAE,SAAS,GACnB,cAAc,CAAC,iBAAiB,CAAC;CAmHrC"}