@nodetool-ai/agents 0.7.0-rc.11

package/dist/parallel-task-executor.d.ts

@@ -0,0 +1,87 @@
+/**
+ * ParallelTaskExecutor -- orchestrates parallel execution of a multi-task plan.
+ *
+ * Each task in the plan runs as an independent sub-agent via TaskExecutor.
+ * Tasks form a DAG via their `dependsOn` arrays. Independent tasks
+ * (those with no unmet dependencies) run concurrently.
+ *
+ * Flow:
+ *   TaskPlan (multiple Tasks) → ParallelTaskExecutor
+ *     → finds tasks with satisfied dependencies
+ *     → runs them concurrently, each via TaskExecutor
+ *     → stores results in shared context
+ *     → repeats until all tasks complete
+ */
+import type { BaseProvider } from "@nodetool-ai/runtime";
+import type { ProcessingContext } from "@nodetool-ai/runtime";
+import type { ProcessingMessage } from "@nodetool-ai/protocol";
+import type { Tool } from "./tools/base-tool.js";
+import type { TaskPlan } from "./types.js";
+export interface ParallelTaskExecutorOptions {
+    provider: BaseProvider;
+    model: string;
+    context: ProcessingContext;
+    tools: Tool[];
+    taskPlan: TaskPlan;
+    systemPrompt?: string;
+    inputs?: Record<string, unknown>;
+    /** Maximum total iteration count across all tasks. */
+    maxIterations?: number;
+    /** Maximum iterations per step within a task. */
+    maxStepIterations?: number;
+    maxTokenLimit?: number;
+}
+export declare class ParallelTaskExecutor {
+    private readonly provider;
+    private readonly model;
+    private readonly tools;
+    private readonly taskPlan;
+    private readonly context;
+    private readonly inputs;
+    private readonly systemPrompt;
+    private readonly maxIterations;
+    private readonly maxStepIterations;
+    private readonly maxTokenLimit;
+    /** Results collected per task ID. */
+    private readonly taskResults;
+    constructor(opts: ParallelTaskExecutorOptions);
+    /**
+     * Execute all tasks in the plan, respecting inter-task dependencies.
+     * Independent tasks run concurrently as separate sub-agents.
+     */
+    execute(): AsyncGenerator<ProcessingMessage>;
+    /**
+     * Execute a single task as an independent sub-agent.
+     * Injects dependency results into the task's context before execution.
+     */
+    private executeTask;
+    /**
+     * Build a map of dependency results for a task.
+     */
+    private buildDependencyContext;
+    /**
+     * Build system prompt enhanced with dependency results.
+     */
+    private buildTaskSystemPrompt;
+    /**
+     * Check if all tasks have been completed.
+     */
+    private allTasksComplete;
+    /**
+     * Find tasks whose dependencies are all satisfied.
+     */
+    private getExecutableTasks;
+    /**
+     * Get the result of a specific task.
+     */
+    getTaskResult(taskId: string): unknown;
+    /**
+     * Get all task results.
+     */
+    getAllResults(): Record<string, unknown>;
+    /**
+     * Get the result of the final task (last task in the plan, typically the aggregator).
+     */
+    getFinalResult(): unknown;
+}
+//# sourceMappingURL=parallel-task-executor.d.ts.map

package/dist/parallel-task-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parallel-task-executor.d.ts","sourceRoot":"","sources":["../src/parallel-task-executor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,OAAO,KAAK,EACV,iBAAiB,EAKlB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,KAAK,EAAQ,QAAQ,EAAE,MAAM,YAAY,CAAC;AAQjD,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,YAAY,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,iBAAiB,CAAC;IAC3B,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,QAAQ,EAAE,QAAQ,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,sDAAsD;IACtD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iDAAiD;IACjD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0B;IACjD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAClD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IAEvC,qCAAqC;IACrC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA8B;gBAE9C,IAAI,EAAE,2BAA2B;IAc7C;;;OAGG;IACI,OAAO,IAAI,cAAc,CAAC,iBAAiB,CAAC;IAiFnD;;;OAGG;YACY,WAAW;IAuF1B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAa9B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAyB7B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAIxB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAkB1B;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAItC;;OAEG;IACH,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAQxC;;OAEG;IACH,cAAc,IAAI,OAAO;CAK1B"}

package/dist/parallel-task-executor.js

@@ -0,0 +1,332 @@
+/**
+ * ParallelTaskExecutor -- orchestrates parallel execution of a multi-task plan.
+ *
+ * Each task in the plan runs as an independent sub-agent via TaskExecutor.
+ * Tasks form a DAG via their `dependsOn` arrays. Independent tasks
+ * (those with no unmet dependencies) run concurrently.
+ *
+ * Flow:
+ *   TaskPlan (multiple Tasks) → ParallelTaskExecutor
+ *     → finds tasks with satisfied dependencies
+ *     → runs them concurrently, each via TaskExecutor
+ *     → stores results in shared context
+ *     → repeats until all tasks complete
+ */
+import { createLogger } from "@nodetool-ai/config";
+import { TaskUpdateEvent } from "@nodetool-ai/protocol";
+import { TaskExecutor } from "./task-executor.js";
+import { DEFAULT_TOKEN_LIMIT } from "./constants.js";
+const log = createLogger("nodetool.agents.parallel-task-executor");
+const DEFAULT_MAX_TASK_ITERATIONS = 100;
+const DEFAULT_MAX_STEP_ITERATIONS = 10;
+export class ParallelTaskExecutor {
+    provider;
+    model;
+    tools;
+    taskPlan;
+    context;
+    inputs;
+    systemPrompt;
+    maxIterations;
+    maxStepIterations;
+    maxTokenLimit;
+    /** Results collected per task ID. */
+    taskResults = new Map();
+    constructor(opts) {
+        this.provider = opts.provider;
+        this.model = opts.model;
+        this.tools = opts.tools;
+        this.taskPlan = opts.taskPlan;
+        this.context = opts.context;
+        this.inputs = opts.inputs ?? {};
+        this.systemPrompt = opts.systemPrompt;
+        this.maxIterations = opts.maxIterations ?? DEFAULT_MAX_TASK_ITERATIONS;
+        this.maxStepIterations =
+            opts.maxStepIterations ?? DEFAULT_MAX_STEP_ITERATIONS;
+        this.maxTokenLimit = opts.maxTokenLimit ?? DEFAULT_TOKEN_LIMIT;
+    }
+    /**
+     * Execute all tasks in the plan, respecting inter-task dependencies.
+     * Independent tasks run concurrently as separate sub-agents.
+     */
+    async *execute() {
+        // Seed inputs into context
+        for (const [key, value] of Object.entries(this.inputs)) {
+            this.context.set(key, value);
+        }
+        const totalTasks = this.taskPlan.tasks.length;
+        log.info("Parallel task execution started", {
+            title: this.taskPlan.title,
+            tasks: totalTasks
+        });
+        yield {
+            type: "log_update",
+            node_id: "parallel_task_executor",
+            node_name: "ParallelTaskExecutor",
+            content: `Starting parallel execution of ${totalTasks} tasks...`,
+            severity: "info"
+        };
+        let iterations = 0;
+        while (!this.allTasksComplete() && iterations < this.maxIterations) {
+            iterations++;
+            const executableTasks = this.getExecutableTasks();
+            if (executableTasks.length === 0) {
+                if (!this.allTasksComplete()) {
+                    yield {
+                        type: "chunk",
+                        content: "\nNo executable tasks but not all complete. Possible dependency issues.\n",
+                        done: false
+                    };
+                }
+                break;
+            }
+            const taskIds = executableTasks.map((t) => t.id);
+            log.debug("Dispatching parallel tasks", { taskIds });
+            yield {
+                type: "log_update",
+                node_id: "parallel_task_executor",
+                node_name: "ParallelTaskExecutor",
+                content: `Running ${executableTasks.length} task(s) in parallel: ${taskIds.join(", ")}`,
+                severity: "info"
+            };
+            // Create task executors — each task runs as its own sub-agent
+            const taskGenerators = executableTasks.map((task) => {
+                return this.executeTask(task);
+            });
+            if (taskGenerators.length > 1) {
+                // Execute all tasks concurrently, merging yielded messages
+                yield* mergeAsyncGenerators(taskGenerators);
+            }
+            else {
+                // Single task — no need for merge overhead
+                for await (const message of taskGenerators[0]) {
+                    yield message;
+                }
+            }
+        }
+        if (iterations >= this.maxIterations) {
+            log.warn("Max iterations reached", {
+                iterations,
+                completedTasks: this.taskPlan.tasks.filter((t) => t.completed).length,
+                totalTasks
+            });
+        }
+        log.info("Parallel task execution completed", {
+            title: this.taskPlan.title,
+            completedTasks: this.taskPlan.tasks.filter((t) => t.completed).length,
+            totalTasks
+        });
+    }
+    /**
+     * Execute a single task as an independent sub-agent.
+     * Injects dependency results into the task's context before execution.
+     */
+    async *executeTask(task) {
+        // Mark task as started
+        task.completed = false;
+        yield {
+            type: "task_update",
+            event: TaskUpdateEvent.TaskCreated,
+            task: {
+                id: task.id,
+                title: task.title,
+                description: task.description,
+                steps: task.steps.map((s) => ({
+                    id: s.id,
+                    instructions: s.instructions,
+                    completed: s.completed
+                }))
+            }
+        };
+        // Build context with dependency results
+        const depContext = this.buildDependencyContext(task);
+        // Build enhanced system prompt with dependency information
+        const enhancedPrompt = this.buildTaskSystemPrompt(task, depContext);
+        // Create TaskExecutor for this task's steps
+        const executor = new TaskExecutor({
+            provider: this.provider,
+            model: this.model,
+            context: this.context,
+            tools: [...this.tools],
+            task,
+            systemPrompt: enhancedPrompt,
+            inputs: { ...this.inputs, ...depContext },
+            maxSteps: task.steps.length + 5, // Allow some slack
+            maxStepIterations: this.maxStepIterations,
+            maxTokenLimit: this.maxTokenLimit,
+            parallelExecution: true // Enable parallel step execution within each task
+        });
+        let taskResult = null;
+        for await (const item of executor.executeTasks()) {
+            if (item.type === "step_result") {
+                const stepResult = item;
+                if (stepResult.is_task_result) {
+                    taskResult = stepResult.result;
+                }
+            }
+            yield item;
+        }
+        // Store task result in shared context and mark complete
+        if (taskResult !== null && taskResult !== undefined) {
+            this.taskResults.set(task.id, taskResult);
+            this.context.set(task.id, taskResult);
+        }
+        else {
+            // Use last step result as task result
+            const lastStep = task.steps[task.steps.length - 1];
+            if (lastStep) {
+                const lastResult = this.context.get(lastStep.id);
+                if (lastResult !== undefined) {
+                    this.taskResults.set(task.id, lastResult);
+                    this.context.set(task.id, lastResult);
+                    taskResult = lastResult;
+                }
+            }
+        }
+        task.completed = true;
+        yield {
+            type: "task_update",
+            event: TaskUpdateEvent.TaskCompleted,
+            task: {
+                id: task.id,
+                title: task.title,
+                result: taskResult
+            }
+        };
+        log.info("Task completed", {
+            taskId: task.id,
+            title: task.title
+        });
+    }
+    /**
+     * Build a map of dependency results for a task.
+     */
+    buildDependencyContext(task) {
+        const depContext = {};
+        for (const depId of task.dependsOn ?? []) {
+            const result = this.taskResults.get(depId);
+            if (result !== undefined) {
+                depContext[depId] = result;
+            }
+        }
+        return depContext;
+    }
+    /**
+     * Build system prompt enhanced with dependency results.
+     */
+    buildTaskSystemPrompt(task, depContext) {
+        const parts = [];
+        if (this.systemPrompt) {
+            parts.push(this.systemPrompt);
+        }
+        if (Object.keys(depContext).length > 0) {
+            parts.push("\n# Results from prerequisite tasks:");
+            for (const [depId, result] of Object.entries(depContext)) {
+                const depTask = this.taskPlan.tasks.find((t) => t.id === depId);
+                const depTitle = depTask?.title ?? depId;
+                const resultStr = typeof result === "string"
+                    ? result
+                    : JSON.stringify(result, null, 2);
+                parts.push(`\n## ${depTitle} (${depId}):\n${resultStr}`);
+            }
+        }
+        return parts.length > 0 ? parts.join("\n") : undefined;
+    }
+    /**
+     * Check if all tasks have been completed.
+     */
+    allTasksComplete() {
+        return this.taskPlan.tasks.every((task) => task.completed);
+    }
+    /**
+     * Find tasks whose dependencies are all satisfied.
+     */
+    getExecutableTasks() {
+        const completedIds = new Set(this.taskPlan.tasks
+            .filter((t) => t.completed)
+            .map((t) => t.id));
+        // Input keys also count as satisfied dependencies
+        for (const key of Object.keys(this.inputs)) {
+            completedIds.add(key);
+        }
+        return this.taskPlan.tasks.filter((task) => !task.completed &&
+            (task.dependsOn ?? []).every((dep) => completedIds.has(dep)));
+    }
+    /**
+     * Get the result of a specific task.
+     */
+    getTaskResult(taskId) {
+        return this.taskResults.get(taskId);
+    }
+    /**
+     * Get all task results.
+     */
+    getAllResults() {
+        const results = {};
+        for (const [id, result] of this.taskResults) {
+            results[id] = result;
+        }
+        return results;
+    }
+    /**
+     * Get the result of the final task (last task in the plan, typically the aggregator).
+     */
+    getFinalResult() {
+        if (this.taskPlan.tasks.length === 0)
+            return null;
+        const lastTask = this.taskPlan.tasks[this.taskPlan.tasks.length - 1];
+        return this.taskResults.get(lastTask.id) ?? null;
+    }
+}
+// ---------------------------------------------------------------------------
+// Async generator merge utility
+// ---------------------------------------------------------------------------
+async function* mergeAsyncGenerators(generators) {
+    const queue = [];
+    let activeCount = generators.length;
+    let resolve = null;
+    let firstError = undefined;
+    function notify() {
+        if (resolve) {
+            const r = resolve;
+            resolve = null;
+            r();
+        }
+    }
+    const tasks = generators.map(async (gen) => {
+        try {
+            for await (const item of gen) {
+                queue.push(item);
+                notify();
+            }
+        }
+        catch (e) {
+            if (firstError === undefined)
+                firstError = e;
+        }
+        finally {
+            activeCount--;
+            notify();
+        }
+    });
+    while (activeCount > 0 || queue.length > 0) {
+        if (queue.length > 0) {
+            yield queue.shift();
+        }
+        else if (activeCount > 0) {
+            const waitPromise = new Promise((r) => {
+                resolve = r;
+            });
+            if (queue.length > 0) {
+                resolve = null;
+                continue;
+            }
+            await waitPromise;
+        }
+    }
+    await Promise.allSettled(tasks);
+    if (firstError !== undefined) {
+        throw firstError;
+    }
+}
+//# sourceMappingURL=parallel-task-executor.js.map

package/dist/parallel-task-executor.js.map

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

package/dist/prompts/graph-planner-prompt.d.ts

@@ -0,0 +1,48 @@
+/**
+ * GraphPlanner system prompt and the curated catalog of generic AI nodes
+ * that the workflow-building agent must prefer over provider-specific nodes.
+ *
+ * Centralized here so the prompt's table and the runtime catalog can't drift.
+ */
+import { PROVIDER_NAMESPACES } from "@nodetool-ai/node-sdk";
+export type GenericNodeCapability = "text_to_image" | "image_to_image" | "text_to_video" | "image_to_video" | "text_to_speech" | "automatic_speech_recognition" | "generate_embedding" | "generate_message";
+export interface GenericAINode {
+    /** Fully-qualified node_type to pass to add_node. */
+    type: string;
+    /** Provider capability used to look up models via `find_model`. */
+    capability: GenericNodeCapability;
+    /** Human-readable task label used in the prompt table. */
+    task: string;
+    /** One-line description shown to the agent. */
+    summary: string;
+    /**
+     * Whether this node accepts a `model` property of the form `{provider, id}`.
+     * `false` for AgentStep, which inherits the workflow's configured model.
+     */
+    acceptsModel: boolean;
+}
+/**
+ * Curated set of provider-agnostic nodes the agent must reach for FIRST when
+ * the user asks for AI generation/transform of any kind.
+ *
+ * Verified to exist in `@nodetool-ai/base-nodes` as of writing.
+ */
+export declare const GENERIC_AI_NODES: readonly GenericAINode[];
+/** Deterministic baseline namespaces — search inside these for non-AI work. */
+export declare const CORE_BASELINE_NAMESPACES: readonly string[];
+export { PROVIDER_NAMESPACES };
+export interface BuildPromptOptions {
+    /**
+     * Whether `find_model` is available. When false (no providers configured),
+     * the prompt drops the "use find_model" instruction and steers the agent
+     * toward AgentStep for any AI work.
+     */
+    hasFindModel?: boolean;
+}
+/**
+ * Build the GraphPlanner system prompt. Pass `hasFindModel: false` when
+ * there are no configured providers — the prompt then omits the model
+ * lookup step and tells the agent to fall back to AgentStep.
+ */
+export declare function buildGraphPlannerSystemPrompt(options?: BuildPromptOptions): string;
+//# sourceMappingURL=graph-planner-prompt.d.ts.map

package/dist/prompts/graph-planner-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-planner-prompt.d.ts","sourceRoot":"","sources":["../../src/prompts/graph-planner-prompt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,MAAM,MAAM,qBAAqB,GAC7B,eAAe,GACf,gBAAgB,GAChB,eAAe,GACf,gBAAgB,GAChB,gBAAgB,GAChB,8BAA8B,GAC9B,oBAAoB,GACpB,kBAAkB,CAAC;AAEvB,MAAM,WAAW,aAAa;IAC5B,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,UAAU,EAAE,qBAAqB,CAAC;IAClC,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,YAAY,EAAE,OAAO,CAAC;CACvB;AAED;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,aAAa,EAiEpD,CAAC;AAEF,+EAA+E;AAC/E,eAAO,MAAM,wBAAwB,EAAE,SAAS,MAAM,EAcrD,CAAC;AAEF,OAAO,EAAE,mBAAmB,EAAE,CAAC;AAE/B,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAeD;;;;GAIG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,GAAE,kBAAuB,GAC/B,MAAM,CA+ER"}

package/dist/prompts/graph-planner-prompt.js

@@ -0,0 +1,180 @@
+/**
+ * GraphPlanner system prompt and the curated catalog of generic AI nodes
+ * that the workflow-building agent must prefer over provider-specific nodes.
+ *
+ * Centralized here so the prompt's table and the runtime catalog can't drift.
+ */
+import { PROVIDER_NAMESPACES } from "@nodetool-ai/node-sdk";
+/**
+ * Curated set of provider-agnostic nodes the agent must reach for FIRST when
+ * the user asks for AI generation/transform of any kind.
+ *
+ * Verified to exist in `@nodetool-ai/base-nodes` as of writing.
+ */
+export const GENERIC_AI_NODES = [
+    {
+        type: "nodetool.image.TextToImage",
+        capability: "text_to_image",
+        task: "Text → Image",
+        summary: "Generate an image from a text prompt. Required: prompt, model.",
+        acceptsModel: true
+    },
+    {
+        type: "nodetool.image.ImageToImage",
+        capability: "image_to_image",
+        task: "Image → Image",
+        summary: "Transform a source image with a text prompt. Required: image, prompt, model.",
+        acceptsModel: true
+    },
+    {
+        type: "nodetool.video.TextToVideo",
+        capability: "text_to_video",
+        task: "Text → Video",
+        summary: "Generate a video from a text prompt. Required: prompt, model.",
+        acceptsModel: true
+    },
+    {
+        type: "nodetool.video.ImageToVideo",
+        capability: "image_to_video",
+        task: "Image → Video",
+        summary: "Animate a source image into a video. Required: image, prompt, model.",
+        acceptsModel: true
+    },
+    {
+        type: "nodetool.audio.TextToSpeech",
+        capability: "text_to_speech",
+        task: "Text → Speech",
+        summary: "Generate speech audio from text. Required: text, model. Optional: voice.",
+        acceptsModel: true
+    },
+    {
+        type: "nodetool.text.AutomaticSpeechRecognition",
+        capability: "automatic_speech_recognition",
+        task: "Speech → Text",
+        summary: "Transcribe audio to text. Required: audio, model.",
+        acceptsModel: true
+    },
+    {
+        type: "nodetool.text.Embedding",
+        capability: "generate_embedding",
+        task: "Text → Embedding",
+        summary: "Compute a text embedding vector. Required: text, model.",
+        acceptsModel: true
+    },
+    {
+        type: "nodetool.agents.AgentStep",
+        capability: "generate_message",
+        task: "LLM step (reasoning / generation)",
+        summary: "LLM step: pass instructions in, get text out. Inherits the workflow's configured model — do NOT set a model property.",
+        acceptsModel: false
+    }
+];
+/** Deterministic baseline namespaces — search inside these for non-AI work. */
+export const CORE_BASELINE_NAMESPACES = [
+    "nodetool.control",
+    "nodetool.text",
+    "nodetool.image",
+    "nodetool.video",
+    "nodetool.audio",
+    "nodetool.data",
+    "nodetool.constant",
+    "nodetool.input",
+    "nodetool.output",
+    "nodetool.workspace",
+    "nodetool.document",
+    "nodetool.vector",
+    "nodetool.triggers"
+];
+export { PROVIDER_NAMESPACES };
+function renderGenericNodeTable() {
+    const header = "| Task | node_type | Capability |";
+    const sep = "|---|---|---|";
+    const rows = GENERIC_AI_NODES.map((n) => `| ${n.task} | \`${n.type}\` | \`${n.capability}\` |`);
+    return [header, sep, ...rows].join("\n");
+}
+function renderProviderList() {
+    return PROVIDER_NAMESPACES.map((ns) => `${ns}.*`).join(", ");
+}
+/**
+ * Build the GraphPlanner system prompt. Pass `hasFindModel: false` when
+ * there are no configured providers — the prompt then omits the model
+ * lookup step and tells the agent to fall back to AgentStep.
+ */
+export function buildGraphPlannerSystemPrompt(options = {}) {
+    const hasFindModel = options.hasFindModel ?? true;
+    const tools = [
+        hasFindModel
+            ? "- `find_model(capability, [task], [provider_hint], [prefer_local])` — REQUIRED before adding any generic AI node. Returns ranked `{provider, model_id, name, downloaded, recommended}` filtered to providers the user has actually configured. Use the first result unless the user named a specific provider."
+            : null,
+        "- `search_nodes(query, [namespace], [include_provider_nodes])` — deterministic core nodes only by default. Provider-specific nodes are HIDDEN unless `include_provider_nodes: true`. Optional `namespace` restricts results to a single core namespace.",
+        "- `get_node_info(node_type)` — fetch full property/output schema. REQUIRED before `add_node` for non-generic nodes.",
+        "- `list_nodes([namespace])` — browse a baseline namespace.",
+        "- `add_node`, `add_edge`, `finish_graph` — graph mutation."
+    ]
+        .filter((line) => line !== null)
+        .join("\n");
+    const aiWorkflow = hasFindModel
+        ? `2. For each AI node from the table: call \`find_model\` with the node's capability. Pick the first ranked result. Set the node's \`model\` property to \`{ provider: <provider>, id: <model_id> }\`. AgentStep is the exception — it inherits the workflow's configured model, so do NOT set a \`model\` property on it.`
+        : `2. No providers are configured for model lookup. Use \`nodetool.agents.AgentStep\` for any AI work — it uses the workflow's configured model. Do NOT pick provider-specific nodes.`;
+    return `You are a WorkflowArchitect. Build a workflow graph to achieve the user's objective.
+
+# Node-selection policy (READ FIRST)
+
+Always start from the CORE catalog below. Do NOT use provider-specific nodes
+(${renderProviderList()})
+unless the user explicitly named that provider (e.g. "use OpenAI's image API").
+Provider-specific nodes are hidden from search results by default; only set
+\`include_provider_nodes: true\` when the user named a provider.
+
+## Generic AI nodes — pick one of these for ANY AI generation/transform
+
+${renderGenericNodeTable()}
+
+These nodes accept a \`model\` property (a \`{provider, id}\` object) — except
+AgentStep, which uses the workflow's configured model. Do NOT guess model IDs;
+${hasFindModel ? "use `find_model` to pick a real model+provider." : "AgentStep is the safe choice when no providers are configured."}
+
+## Core baseline namespaces (deterministic, non-AI work)
+
+For non-AI operations, use deterministic nodes from these namespaces only:
+${CORE_BASELINE_NAMESPACES.join(", ")}.
+
+# Workflow
+
+1. CHOOSE: For each step, decide whether it is (a) AI generation/transform →
+   pick a generic node from the table above, or (b) deterministic → use
+   \`search_nodes\` to find a node in a core baseline namespace.
+${aiWorkflow}
+3. INSPECT non-AI nodes with \`get_node_info\` before adding so handle names
+   and types match exactly.
+4. BUILD with \`add_node\` for each node and \`add_edge\` to connect outputs to
+   inputs. Every node needs a unique snake_case id.
+5. FINALIZE with \`finish_graph\` when done.
+
+# Tools
+
+${tools}
+
+# Rules
+
+- Provider-specific nodes are FORBIDDEN unless the user named the provider.
+- Always pass required properties to \`add_node\`. A constant String node
+  needs \`{ "value": "your text here" }\`. Empty defaults break workflows.
+- Maximize parallelism: nodes without data dependencies run concurrently.
+- Use \`nodetool.agents.AgentStep\` ONLY when no deterministic node and no
+  generic AI node fits. AgentStep required properties: \`instructions\` (string).
+  Optional: \`tools\` (string array), \`output_schema\` (JSON schema string).
+  Input handle: \`input\`. Output handle: \`output\`.
+- Do NOT use \`nodetool.agents.Agent\` (the registry node) — it requires a
+  complex model property that cannot be set via \`add_node\`.
+
+# Persistence
+
+- Workflow outputs are persisted by their nodes. For images/audio/video the
+  generic AI nodes auto-save assets; you do NOT need a separate save node.
+- For text artifacts an AgentStep produces (reports, summaries, JSON), use
+  the \`nodetool.workspace.WriteTextFile\` deterministic node OR have the
+  AgentStep call \`save_asset\` with \`name\` + \`content\` from its tool list
+  so the artifact shows up in the chat asset browser.`;
+}
+//# sourceMappingURL=graph-planner-prompt.js.map