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

package/README.md

@@ -0,0 +1,73 @@
+# @nodetool-ai/dsl
+
+Type-safe TypeScript DSL for defining [NodeTool](https://nodetool.ai) workflows.
+
+Build a workflow graph in code — nodes, edges, and typed output handles — then run it or export it. Node factories are generated from the registry, so connections are checked at compile time.
+
+## Install
+
+```bash
+npm install @nodetool-ai/dsl
+```
+
+## Exported symbols
+
+| Symbol | Kind | Description |
+|---|---|---|
+| `createNode` | function | Create a graph node from a node type, inputs, and options |
+| `resolveConnection` | function | Normalize a handle or single-output node, return `undefined` for a literal |
+| `NodeOptions` | type | Optional explicit node identity (`id`) |
+| `workflow` | function | Build from terminals or a typed schema and symbolic callback |
+| `t`, `choose`, `map`, `template` | helpers | Typed parameters, runtime branches, iteration, and symbolic text |
+| `toKernelGraph` | function | Convert host workflow nodes to kernel descriptors |
+| `run` | function | Execute a workflow and return its outputs |
+| `workflowToDsl` | function | Generate DSL source from a workflow graph (used by `export-dsl`) |
+| `OutputHandle`, `Connectable`, `SingleOutput` | type | Typed wiring between node outputs and inputs |
+| `DslNode`, `Workflow`, `WorkflowNode`, `WorkflowEdge` | type | Graph value types |
+| `RunOptions`, `WorkflowResult`, `SecretResolver` | type | Execution configuration and results |
+| generated namespaces (`text`, `agents`, `geminiImage`, …) | module | Typed factories for every registered node, grouped by namespace |
+
+## Usage
+
+```ts
+import { workflow, run, t, template } from "@nodetool-ai/dsl";
+
+const greeter = workflow({ name: t.string() }, ({ name }) => ({
+  greeting: template`Hello ${name}!`
+}));
+const result = await run(greeter, { params: { name: "Ada" } });
+// { greeting: "Hello Ada!" }
+```
+
+`createNode(nodeType, inputs, opts)` is the low-level primitive behind the generated factories; `opts` covers `id`, `streaming`, `multiOutput`, `outputNames`, and `defaultOutput`. A single-output node can be passed directly as an input. Explicit `node.output()` syntax remains supported. Select multi-output slots with `node.output("slot")`, `node.outputs.slot`, or a safe named property such as `node.if_true`. Generated factories accept an optional second argument: `text.concat({ a: greeting, b: "!" }, { id: "joined" })`. Duplicate IDs in a build fail. Graphs with Python nodes connect a worker bridge automatically (via `RunOptions.bridgeOptions` or the `NODETOOL_WORKER_URL` environment).
+
+Regenerate the node factories after node changes:
+
+```bash
+npm run codegen         # rewrite both generated trees from the node registry
+npm run codegen:check   # exit 1 when either tree no longer matches it
+```
+
+`codegen:check` runs in CI, so a node that is renamed or deleted cannot leave a
+factory behind in the DSL. Pass `--graph` or `--flow` to work on one tree.
+
+## Native flow (internal)
+
+`src/flow/` calls a node as an async function — registry resolve, secret
+injection, `process()`, outputs — with no graph and no `WorkflowRunner`. It is
+**not** exported from this package. The public surface is the sandbox pack
+`@nodetool-ai/sandbox-flow`, whose guest modules are generated into
+`src/flow/generated/` by the same codegen pass and reach this code through the
+`@nodetool-ai/sandbox-nodetool/flow` capability module. Two files here are
+guest-only: `src/flow/guest-core.ts` (the call bridge the generated modules
+import) and the generated tree itself — the pack build transforms them to
+JavaScript, and nothing on the host imports either.
+
+See [docs/dsl-native-flow-design.md](../../docs/dsl-native-flow-design.md).
+
+See the [DSL guide](../../docs/developer/ts-dsl-guide.md) for before/after examples and the [authoring design](../../docs/developer/ts-dsl-authoring-design.md) for scope and follow-up phases.
+
+## Links
+
+- [NodeTool](https://nodetool.ai)
+- [GitHub](https://github.com/nodetool-ai/nodetool)

package/dist/.nodetool-build-stamp

@@ -0,0 +1 @@
+2026-10-07T23:09:53.182Z

package/dist/authoring.d.ts

@@ -0,0 +1,69 @@
+import { type Connectable, type OutputHandle, type SingleOutputNode, type NodeOptions, type Workflow, type WorkflowTerminal } from "./core.js";
+import type { ImageRef, AudioRef, VideoRef } from "./types.js";
+/** Workflow parameter type with an optional explicit fallback. */
+export interface InputType<T, Optional extends boolean = boolean> {
+    readonly type: string;
+    readonly optionalInput: Optional;
+    readonly fallback?: T;
+    readonly __type?: T;
+    optional(): InputType<T | null, true>;
+    optional(value: T): InputType<T, true>;
+}
+/** Descriptors for symbolic workflow inputs. Optional values default to null. */
+export declare const t: Readonly<{
+    string: () => InputType<string, false>;
+    int: () => InputType<number, false>;
+    float: () => InputType<number, false>;
+    boolean: () => InputType<boolean, false>;
+    image: () => InputType<ImageRef, false>;
+    audio: () => InputType<AudioRef, false>;
+    video: () => InputType<VideoRef, false>;
+    value: <T = unknown>() => InputType<T, false>;
+    list: <T>(item: InputType<T>) => InputType<T[], false>;
+}>;
+export type InputSchema = Record<string, InputType<unknown>>;
+type InputValue<S> = S extends InputType<infer T> ? T : never;
+export type WorkflowParams<I extends InputSchema> = {
+    [K in keyof I as I[K] extends InputType<unknown, true> ? never : K]: InputValue<I[K]>;
+} & {
+    [K in keyof I as I[K] extends InputType<unknown, true> ? K : never]?: InputValue<I[K]>;
+};
+export type SymbolicInputs<I extends InputSchema> = {
+    readonly [K in keyof I]: OutputHandle<InputValue<I[K]>>;
+};
+export type WorkflowValues<O extends Record<string, unknown>> = {
+    [K in keyof O]: O[K] extends OutputHandle<infer V> ? V : O[K] extends SingleOutputNode<infer V> ? V : O[K];
+};
+export type WorkflowBuilder<I extends InputSchema, O extends Record<string, unknown>> = (inputs: SymbolicInputs<I>) => O;
+export type WorkflowDefinition<I extends InputSchema, O extends Record<string, unknown>> = Workflow & {
+    (params: {
+        [K in keyof WorkflowParams<I>]: Connectable<WorkflowParams<I>[K]>;
+    }, options?: NodeOptions): O;
+    readonly inputSchema: I;
+    readonly outputNames: readonly string[];
+    toJSON(): Workflow;
+};
+/** Build a legacy graph or a callable graph with a typed parameter schema. */
+export declare function workflow<I extends InputSchema, O extends Record<string, unknown>>(schema: I, builder: WorkflowBuilder<I, O>): WorkflowDefinition<I, O>;
+export declare function workflow(...terminals: WorkflowTerminal[]): Workflow;
+/** Runtime port type used when lowering typed helpers to existing graph nodes. */
+export declare function valueType(value: unknown): string;
+/** @internal Build a callable workflow using the ordinary graph representation. */
+export declare function defineWorkflow<I extends InputSchema, O extends Record<string, unknown>>(schema: I, builder: WorkflowBuilder<I, O>): WorkflowDefinition<I, O>;
+/** Convert the host graph envelope to the existing kernel envelope. */
+export interface KernelWorkflow {
+    nodes: Array<Record<string, unknown>>;
+    edges: Workflow["edges"];
+}
+export declare function toKernelGraph(graph: Workflow): KernelWorkflow;
+/** Build two isolated bodies and execute only the runtime-selected branch. */
+export declare function choose<T>(condition: Connectable<boolean>, branches: {
+    then: () => Connectable<T>;
+    else: () => Connectable<NoInfer<T>>;
+}): OutputHandle<T>;
+/** Map through the kernel's iteration and collection primitives. */
+export declare function map<T, U>(items: Connectable<T[]>, build: (item: OutputHandle<T>, index: OutputHandle<number>) => Connectable<U>): OutputHandle<U[]>;
+/** Interpolate symbolic values through the existing dynamic-input Template node. */
+export declare function template(strings: TemplateStringsArray, ...values: unknown[]): OutputHandle<string>;
+export {};
+//# sourceMappingURL=authoring.d.ts.map

package/dist/authoring.d.ts.map

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

package/dist/authoring.js

@@ -0,0 +1,318 @@
+import { createNode, resolveConnection, connectionIdentity, connectionSlot, workflow as graphWorkflow, withBuildScope, withNodeScope } from "./core.js";
+function inputType(type, optionalInput = false, fallback) {
+    return Object.freeze({
+        type,
+        optionalInput,
+        fallback,
+        optional(value) {
+            return inputType(type, true, value === undefined ? null : value);
+        }
+    });
+}
+/** Descriptors for symbolic workflow inputs. Optional values default to null. */
+export const t = Object.freeze({
+    string: () => inputType("str"),
+    int: () => inputType("int"),
+    float: () => inputType("float"),
+    boolean: () => inputType("bool"),
+    image: () => inputType("image"),
+    audio: () => inputType("audio"),
+    video: () => inputType("video"),
+    value: () => inputType("any"),
+    list: (item) => inputType(`list[${item.type}]`)
+});
+export function workflow(...args) {
+    if (args.length === 2 && typeof args[1] === "function") {
+        return defineWorkflow(args[0], args[1]);
+    }
+    return graphWorkflow(...args);
+}
+const INPUT_NODES = {
+    str: "StringInput",
+    int: "IntegerInput",
+    float: "FloatInput",
+    bool: "BooleanInput",
+    image: "ImageInput",
+    audio: "AudioInput",
+    video: "VideoInput"
+};
+function input(name, descriptor) {
+    const specialized = !descriptor.optionalInput && descriptor.type in INPUT_NODES
+        ? INPUT_NODES[descriptor.type]
+        : undefined;
+    const properties = { name };
+    if (descriptor.optionalInput) {
+        properties.value = descriptor.fallback;
+    }
+    return createNode(`nodetool.input.${specialized || "ValueInput"}`, properties, {
+        id: `input/${name}`,
+        outputNames: ["output"],
+        defaultOutput: "output",
+        outputTypes: { output: descriptor.type }
+    });
+}
+/** Runtime port type used when lowering typed helpers to existing graph nodes. */
+export function valueType(value) {
+    const handle = resolveConnection(value);
+    if (handle)
+        return handle.valueType ?? "any";
+    if (typeof value === "string")
+        return "str";
+    if (typeof value === "boolean")
+        return "bool";
+    if (typeof value === "number")
+        return Number.isInteger(value) ? "int" : "float";
+    if (Array.isArray(value))
+        return `list[${value.length ? valueType(value[0]) : "any"}]`;
+    if (value &&
+        typeof value === "object" &&
+        "type" in value &&
+        typeof value.type === "string") {
+        if (["image", "audio", "video", "model3d"].includes(value.type))
+            return value.type;
+    }
+    return "any";
+}
+function resultNodes(result) {
+    if (!result ||
+        typeof result !== "object" ||
+        Array.isArray(result) ||
+        typeof result.then === "function") {
+        throw new Error("A workflow builder must synchronously return a named output object");
+    }
+    if (!Object.keys(result).length)
+        throw new Error("A workflow must return at least one named output");
+    return Object.entries(result).map(([name, value]) => createNode("nodetool.output.Output", { name, value }, { id: `output/${name}`, outputNames: ["output"] }));
+}
+/** @internal Build a callable workflow using the ordinary graph representation. */
+export function defineWorkflow(schema, builder) {
+    schema = Object.freeze({ ...schema });
+    for (const [name, descriptor] of Object.entries(schema)) {
+        if (!name ||
+            !descriptor ||
+            typeof descriptor.type !== "string" ||
+            typeof descriptor.optionalInput !== "boolean") {
+            throw new Error(`Invalid workflow input descriptor: ${name}`);
+        }
+    }
+    let outputNames = [];
+    const graph = withBuildScope(() => {
+        const inputs = Object.fromEntries(Object.entries(schema).map(([name, descriptor]) => [
+            name,
+            input(name, descriptor)
+        ]));
+        const symbols = Object.fromEntries(Object.entries(inputs).map(([name, node]) => [name, node.output()]));
+        const result = builder(symbols);
+        const outputs = resultNodes(result);
+        outputNames = Object.keys(result);
+        return graphWorkflow(...outputs, ...Object.values(inputs));
+    });
+    const definition = (params, options) => withNodeScope(options?.id, () => {
+        for (const [name, descriptor] of Object.entries(schema)) {
+            if ((!Object.hasOwn(params, name) || params[name] === undefined) &&
+                !descriptor.optionalInput)
+                throw new Error(`Missing required workflow input "${name}"`);
+        }
+        for (const name of Object.keys(params)) {
+            if (!Object.hasOwn(schema, name))
+                throw new Error(`Unknown workflow input "${name}"`);
+        }
+        const inputs = Object.fromEntries(Object.entries(schema).map(([name, descriptor]) => [
+            name,
+            createNode("nodetool.control.Reroute", {
+                input_value: Object.hasOwn(params, name) && params[name] !== undefined
+                    ? params[name]
+                    : descriptor.fallback
+            }, {
+                id: `input/${name}`,
+                outputNames: ["output"],
+                defaultOutput: "output",
+                outputTypes: { output: descriptor.type },
+                outputCorrelation: {
+                    output: { kind: "forward", source: "input_value" }
+                }
+            }).output()
+        ]));
+        const result = builder(inputs);
+        if (!result ||
+            Object.keys(result).join("\0") !== outputNames.join("\0")) {
+            throw new Error("A composed workflow must preserve its declared output names");
+        }
+        return result;
+    });
+    return Object.freeze(Object.assign(definition, graph, {
+        inputSchema: schema,
+        outputNames: Object.freeze(outputNames),
+        toJSON: () => graph
+    }));
+}
+export function toKernelGraph(graph) {
+    return {
+        nodes: graph.nodes.map((node) => {
+            if (!("data" in node)) {
+                return Object.fromEntries(Object.entries(node));
+            }
+            const { data, streaming, streamingInput, ...rest } = node;
+            return {
+                ...rest,
+                properties: data,
+                is_streaming_output: streaming,
+                is_streaming_input: streamingInput
+            };
+        }),
+        edges: graph.edges.map((edge) => ({ ...edge }))
+    };
+}
+function bodyGraph(build) {
+    const captures = {};
+    const captured = new Map();
+    let type = "any";
+    let captureCount = 0;
+    const graph = withBuildScope(() => {
+        const value = build();
+        if (value &&
+            typeof value === "object" &&
+            "then" in value &&
+            typeof value.then === "function") {
+            throw new Error("Branch and map callbacks must return synchronously");
+        }
+        type = valueType(value);
+        return graphWorkflow(...resultNodes({ value }));
+    }, (handle) => {
+        const identity = connectionIdentity(handle);
+        const slot = connectionSlot(handle);
+        let slots = captured.get(identity);
+        if (!slots) {
+            slots = new Map();
+            captured.set(identity, slots);
+        }
+        let local = slots.get(slot);
+        if (!local) {
+            const name = `capture_${captureCount++}`;
+            captures[name] = handle;
+            local = input(name, inputType(handle.valueType ?? "any")).output();
+            slots.set(slot, local);
+        }
+        return local;
+    });
+    return { graph: toKernelGraph(graph), captures, type };
+}
+function route(condition, value, type, source) {
+    return createNode("nodetool.control.If", { condition, value }, {
+        outputNames: ["if_true", "if_false"],
+        outputTypes: { if_true: type, if_false: type },
+        outputCorrelation: source
+            ? {
+                if_true: { kind: "forward", source },
+                if_false: { kind: "forward", source }
+            }
+            : undefined
+    });
+}
+function subgraph(body, inputs, correlationSource) {
+    return createNode("nodetool.workflows.subgraph.Subgraph", { graph: body.graph, ...inputs }, {
+        outputNames: ["value"],
+        defaultOutput: "value",
+        outputTypes: { value: body.type },
+        dynamicOutputs: { value: { type: body.type, type_args: [] } },
+        outputCorrelation: {
+            value: { kind: "forward", source: correlationSource }
+        }
+    });
+}
+/** Build two isolated bodies and execute only the runtime-selected branch. */
+export function choose(condition, branches) {
+    const yes = bodyGraph(branches.then);
+    const no = bodyGraph(branches.else);
+    if (yes.type !== "any" &&
+        no.type !== "any" &&
+        yes.type !== no.type &&
+        ![yes.type, no.type].every((type) => ["int", "float"].includes(type))) {
+        throw new Error(`Branch output types do not match: ${yes.type} and ${no.type}`);
+    }
+    const gate = route(condition, true, "bool");
+    const branch = (body, slot) => {
+        const inputs = { gate: gate.output(slot) };
+        for (const [name, handle] of Object.entries(body.captures)) {
+            inputs[name] = route(condition, handle, handle.valueType ?? "any").output(slot);
+        }
+        return subgraph(body, inputs, "gate");
+    };
+    const a = branch(yes, "if_true");
+    const b = branch(no, "if_false");
+    return createNode("nodetool.code.Code", {
+        code: 'for await (const value of stream("yes")) { await emit("output", value); }\nfor await (const value of stream("no")) { await emit("output", value); }',
+        yes: a,
+        no: b
+    }, {
+        outputNames: ["output"],
+        defaultOutput: "output",
+        outputTypes: { output: yes.type },
+        streamingInput: true,
+        streaming: true
+    }).output();
+}
+/** Map through the kernel's iteration and collection primitives. */
+export function map(items, build) {
+    const listType = valueType(items);
+    const itemType = listType.startsWith("list[") ? listType.slice(5, -1) : "any";
+    const body = bodyGraph(() => build(input("item", inputType(itemType)).output(), input("index", t.int()).output()));
+    const each = createNode("nodetool.control.ForEach", { input_list: items }, {
+        outputNames: ["output", "index"],
+        outputTypes: { output: itemType, index: "int" },
+        streaming: true,
+        outputCorrelation: {
+            output: { kind: "iteration", source: "__execution__", group: "items" },
+            index: { kind: "iteration", source: "__execution__", group: "items" }
+        }
+    });
+    const inputs = {
+        item: each.output("output"),
+        index: each.output("index")
+    };
+    if (Object.keys(body.captures).length) {
+        const gate = createNode("nodetool.code.Code", {
+            code: 'await output("output", true);',
+            item: each.output("output")
+        }, {
+            outputNames: ["output"],
+            defaultOutput: "output",
+            outputTypes: { output: "bool" },
+            outputCorrelation: { output: { kind: "forward", source: "item" } }
+        });
+        for (const [name, handle] of Object.entries(body.captures)) {
+            inputs[name] = route(gate, handle, handle.valueType ?? "any", "condition").output("if_true");
+        }
+    }
+    const invocation = subgraph(body, inputs, "item");
+    return createNode("nodetool.control.Collect", { input_item: invocation }, {
+        outputNames: ["output"],
+        defaultOutput: "output",
+        outputTypes: { output: `list[${body.type}]` },
+        streamingInput: true,
+        inputMode: "stream",
+        outputCorrelation: {
+            output: {
+                kind: "aggregate",
+                source: "input_item",
+                collapse: "innermost"
+            }
+        }
+    }).output();
+}
+/** Interpolate symbolic values through the existing dynamic-input Template node. */
+export function template(strings, ...values) {
+    const inputs = {};
+    let text = strings[0] ?? "";
+    values.forEach((value, index) => {
+        const name = `value_${index}`;
+        inputs[name] = value;
+        text += `{{${name}}}${strings[index + 1] ?? ""}`;
+    });
+    return createNode("nodetool.text.Template", { string: text, ...inputs }, {
+        outputNames: ["output"],
+        defaultOutput: "output",
+        outputTypes: { output: "str" }
+    }).output();
+}
+//# sourceMappingURL=authoring.js.map

package/dist/authoring.js.map

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

package/dist/core.d.ts

@@ -1,36 +1,60 @@
-/**
- * @nodetool-ai/dsl – Core DSL primitives
- *
- * OutputHandle, Connectable, DslNode, SingleOutput, createNode(), workflow(), run()
- */
-import { NodeRegistry } from "@nodetool-ai/node-sdk";
+import type { InputSchema, WorkflowDefinition } from "./authoring.js";
+import type { NodeRegistry } from "@nodetool-ai/node-sdk";
+import { type PythonBridgeOptions } from "@nodetool-ai/runtime";
 export interface OutputHandle<T> {
     readonly __brand: "OutputHandle";
     readonly nodeId: string;
     readonly slot: string;
     readonly __phantom?: T;
+    readonly valueType?: string;
 }
 export declare function isOutputHandle(value: unknown): value is OutputHandle<unknown>;
-export type Connectable<T> = T | OutputHandle<T>;
+export interface SingleOutputNode<T> {
+    readonly defaultOutputHandle: OutputHandle<T>;
+}
+export type Connectable<T> = T | OutputHandle<T> | SingleOutputNode<T>;
 export type SingleOutput<T, TSlot extends string = "output"> = {
     readonly [K in TSlot]: T;
 };
 export type OutputSlot<TOutputs extends object> = Extract<keyof TOutputs, string>;
+type IsUnion<T, TWhole = T> = T extends TWhole ? [TWhole] extends [T] ? false : true : never;
+type DefaultOutputSlot<TOutputs extends object> = [
+    OutputSlot<TOutputs>
+] extends [never] ? undefined : IsUnion<OutputSlot<TOutputs>> extends false ? OutputSlot<TOutputs> : undefined;
 export interface OutputAccessor<TOutputs extends object, TDefault extends OutputSlot<TOutputs> | undefined = undefined> {
     (): TDefault extends OutputSlot<TOutputs> ? OutputHandle<TOutputs[TDefault]> : never;
     <K extends OutputSlot<TOutputs>>(slot: K): OutputHandle<TOutputs[K]>;
 }
-export interface DslNode<TOutputs extends object, TDefault extends OutputSlot<TOutputs> | undefined = TOutputs extends SingleOutput<infer _TValue, infer TSlot> ? Extract<TSlot, OutputSlot<TOutputs>> : undefined> {
+export interface DslNode<TOutputs extends object, TDefault extends OutputSlot<TOutputs> | undefined = DefaultOutputSlot<TOutputs>> {
+    readonly defaultOutputHandle: [DefaultOutputSlot<TOutputs>] extends [
+        undefined
+    ] ? undefined : TDefault extends OutputSlot<TOutputs> ? OutputHandle<TOutputs[TDefault]> : undefined;
     readonly nodeId: string;
     readonly nodeType: string;
     readonly inputs: Record<string, unknown>;
     readonly output: OutputAccessor<TOutputs, TDefault>;
 }
+export type OutputHandles<TOutputs extends object> = {
+    readonly [K in OutputSlot<TOutputs>]: OutputHandle<TOutputs[K]>;
+};
+export type NamedOutputs<TOutputs extends object> = {
+    readonly outputs: OutputHandles<TOutputs>;
+} & (string extends keyof TOutputs ? object : {
+    readonly [K in Exclude<OutputSlot<TOutputs>, keyof DslNode<TOutputs> | "outputs" | "then" | "constructor" | "__proto__">]: OutputHandle<TOutputs[K]>;
+});
+export type NodeWithOutputs<TOutputs extends object, TDefault extends OutputSlot<TOutputs> | undefined = DefaultOutputSlot<TOutputs>> = DslNode<TOutputs, TDefault> & NamedOutputs<TOutputs>;
 export interface WorkflowNode {
     readonly id: string;
     readonly type: string;
     readonly data: Record<string, unknown>;
     readonly streaming: boolean;
+    readonly streamingInput: boolean;
+    readonly dynamic_outputs?: Record<string, {
+        type: string;
+        type_args: never[];
+    }>;
+    readonly input_mode?: import("@nodetool-ai/protocol").InputMode;
+    readonly output_correlation?: Record<string, import("@nodetool-ai/protocol").OutputCorrelation>;
 }
 export interface WorkflowEdge {
     readonly source: string;
@@ -42,21 +66,67 @@ export interface Workflow {
     readonly nodes: WorkflowNode[];
     readonly edges: WorkflowEdge[];
 }
-export type CreateNodeOptions<TOutputs extends object, TDefault extends OutputSlot<TOutputs> | undefined = undefined> = {
+export type WorkflowTerminal = Pick<DslNode<Record<string, unknown>, string>, "nodeId">;
+/** @internal Isolate a synchronous graph build and restore the enclosing build. */
+export declare function withBuildScope<T>(build: () => T, capture?: (handle: OutputHandle<unknown>) => OutputHandle<unknown>): T;
+/** @internal Namespace one composed instantiation without clearing its parent. */
+export declare function withNodeScope<T>(id: string | undefined, build: () => T): T;
+/** Resolve a symbolic connection, leaving literal values unchanged. */
+export declare function resolveConnection(value: unknown): OutputHandle<unknown> | undefined;
+/** @internal Original producer identity, including isolated build scopes. */
+export declare function connectionIdentity(handle: OutputHandle<unknown>): object;
+/** @internal Port name shared with the guest handle adapter. */
+export declare function connectionSlot(handle: OutputHandle<unknown>): string;
+/** Optional authored identity shared by generated factories. */
+export interface NodeOptions {
+    id?: string;
+}
+export type CreateNodeOptions<TOutputs extends object, TDefault extends OutputSlot<TOutputs> | undefined = undefined> = NodeOptions & {
     streaming?: boolean;
+    streamingInput?: boolean;
     outputNames?: readonly OutputSlot<TOutputs>[];
     defaultOutput?: TDefault;
     multiOutput?: boolean;
+    outputTypes?: Record<string, string>;
+    dynamicOutputs?: Record<string, {
+        type: string;
+        type_args: never[];
+    }>;
+    inputMode?: import("@nodetool-ai/protocol").InputMode;
+    outputCorrelation?: Record<string, import("@nodetool-ai/protocol").OutputCorrelation>;
 };
-export declare function createNode<TOutputs extends object, TDefault extends OutputSlot<TOutputs> | undefined = TOutputs extends SingleOutput<infer _TValue, infer TSlot> ? Extract<TSlot, OutputSlot<TOutputs>> : undefined>(nodeType: string, inputs: Record<string, unknown>, opts?: CreateNodeOptions<TOutputs, TDefault>): DslNode<TOutputs, TDefault>;
-export declare function workflow(...terminals: DslNode<any>[]): Workflow;
+export declare function createNode<TOutputs extends object, TDefault extends OutputSlot<TOutputs> | undefined = DefaultOutputSlot<TOutputs>>(nodeType: string, inputs: Record<string, unknown>, opts?: CreateNodeOptions<TOutputs, TDefault>): NodeWithOutputs<TOutputs, TDefault>;
+export declare function workflow(...terminals: WorkflowTerminal[]): Workflow;
+export type SecretResolver = (key: string, userId: string) => Promise<string | null | undefined> | string | null | undefined;
 export type RunOptions = {
+    params?: Record<string, unknown>;
     userId?: string;
     authToken?: string;
     /** Custom node registry; defaults to NodeRegistry.global. */
     registry?: NodeRegistry;
+    /**
+     * Resolve a credential by name for the running job. Bind your storage
+     * backend here — typically `(key, userId) => getSecret(key, userId)` from
+     * `@nodetool-ai/models`. Without it the context falls back to env vars
+     * only, and any node declaring `requiredSettings` will warn that its
+     * secret is missing.
+     */
+    secretResolver?: SecretResolver;
+    /**
+     * Python worker bridge options forwarded to {@link createPythonBridge} when
+     * the graph contains Python nodes. Omit to rely on the environment
+     * (`NODETOOL_WORKER_URL` / `NODETOOL_WORKER_TOKEN`); set `wsUrl`/`workerToken`
+     * here to target a specific remote worker programmatically.
+     */
+    bridgeOptions?: PythonBridgeOptions;
 };
 export type WorkflowResult = Record<string, unknown>;
-export declare function run(wf: Workflow, opts?: RunOptions): Promise<WorkflowResult>;
-export declare function runGraph(...terminals: DslNode<any>[]): Promise<WorkflowResult>;
+export declare function run<I extends InputSchema, O extends Record<string, unknown>>(wf: WorkflowDefinition<I, O>, opts?: Omit<RunOptions, "params"> & {
+    params?: import("./authoring.js").WorkflowParams<I>;
+}): Promise<import("./authoring.js").WorkflowValues<O>>;
+export declare function run(wf: Workflow & {
+    inputSchema?: never;
+}, opts?: RunOptions): Promise<WorkflowResult>;
+export declare function runGraph(...terminals: DslNode<never>[]): Promise<WorkflowResult>;
+export {};
 //# sourceMappingURL=core.d.ts.map