@nodetool-ai/node-sdk 0.7.0-rc.11

package/dist/base-node.d.ts

@@ -0,0 +1,141 @@
+import type { NodeDescriptor, SyncMode } from "@nodetool-ai/protocol";
+import type { NodeExecutor } from "@nodetool-ai/kernel";
+import type { ProcessingContext, StreamingInputs, StreamingOutputs } from "@nodetool-ai/runtime";
+import { type NodePropertyValidationIssue } from "./validation.js";
+export interface DeclaredOutputTypes {
+    [name: string]: string;
+}
+export interface NodeValidationOptions {
+    /**
+     * Set of property names that are connected to incoming data edges. These
+     * properties are produced at runtime by upstream nodes, so their current
+     * value should not be flagged as missing.
+     */
+    connectedHandles?: ReadonlySet<string> | ReadonlyArray<string>;
+    /** Node id to attach to issues. Defaults to the node's __node_id. */
+    nodeId?: string;
+}
+export type NodeClass = {
+    new (properties?: Record<string, unknown>): BaseNode;
+    nodeType: string;
+    title: string;
+    description: string;
+    layout?: string;
+    recommendedModels?: unknown[];
+    basicFields?: string[];
+    requiredSettings?: string[];
+    requiredRuntimes?: string[];
+    isStreamingInput: boolean;
+    isStreamingOutput: boolean;
+    isDynamic: boolean;
+    syncMode: SyncMode;
+    isControlled: boolean;
+    exposeAsTool?: boolean;
+    supportsDynamicOutputs?: boolean;
+    autoSaveAsset: boolean;
+    modelPacks?: unknown[];
+    metadataOutputTypes?: DeclaredOutputTypes;
+    outputTypes: DeclaredOutputTypes;
+    getDeclaredProperties(): Array<{
+        name: string;
+        options: {
+            type: string;
+            default?: unknown;
+        };
+    }>;
+    getDeclaredOutputs(): Record<string, string>;
+    toDescriptor(id?: string): NodeDescriptor;
+    validateProperties(properties: Record<string, unknown>, options?: NodeValidationOptions): NodePropertyValidationIssue[];
+};
+/** Keys that belong to BaseNode itself and should not appear in NodeProps. */
+type BaseNodeKey = keyof BaseNode | "dynamicProps";
+/**
+ * Extract the @prop-declared fields of a node as an optional record.
+ *
+ * Usage:
+ * ```ts
+ * async process(): Promise<{ output: ImageRef }> {
+ *   // Properties are assigned before process() is called
+ *   const prompt = this.prompt; // typed via @prop
+ * }
+ * ```
+ */
+export type NodeProps<T extends BaseNode> = Partial<Pick<T, Exclude<keyof T, BaseNodeKey | `__${string}` | `_${string}`>>>;
+export declare abstract class BaseNode {
+    static readonly nodeType: string;
+    static readonly title: string;
+    static readonly description: string;
+    static readonly layout: string | undefined;
+    static readonly recommendedModels: unknown[] | undefined;
+    static readonly basicFields: string[] | undefined;
+    static readonly requiredSettings: string[] | undefined;
+    static readonly requiredRuntimes: string[] | undefined;
+    static readonly isStreamingInput: boolean;
+    static readonly isStreamingOutput: boolean;
+    static readonly isDynamic: boolean;
+    static readonly syncMode: SyncMode;
+    static readonly isControlled: boolean;
+    static readonly exposeAsTool: boolean | undefined;
+    static readonly supportsDynamicOutputs: boolean | undefined;
+    static readonly autoSaveAsset: boolean;
+    static readonly modelPacks: unknown[] | undefined;
+    static readonly metadataOutputTypes: DeclaredOutputTypes | undefined;
+    static readonly outputTypes: DeclaredOutputTypes;
+    __node_id: string;
+    __node_name: string;
+    protected dynamicProps: Map<string, unknown>;
+    constructor(properties?: Record<string, unknown>);
+    static getDeclaredProperties(): import("./decorators.js").DeclaredPropertyMetadata[];
+    static getDeclaredOutputs(): Record<string, string>;
+    /**
+     * Validate a property bag against this node's declared @prop metadata.
+     *
+     * Flags two classes of problem:
+     *   - Properties declared `required: true` whose value is missing/empty.
+     *   - Properties whose type ends in `_model` whose value carries the
+     *     "empty" provider sentinel or an empty model id.
+     *
+     * Properties listed in `options.connectedHandles` are ignored — those
+     * receive their value from an upstream node at runtime.
+     *
+     * Subclasses may override this to add custom rules. Most nodes won't
+     * need to: declarative `@prop` metadata is enough.
+     */
+    static validateProperties(properties: Record<string, unknown>, options?: NodeValidationOptions): NodePropertyValidationIssue[];
+    assign(properties: Record<string, unknown>): void;
+    serialize(): Record<string, unknown>;
+    deserialize(data: Record<string, unknown>): void;
+    setDynamic(key: string, value: unknown): void;
+    getDynamic<T = unknown>(key: string): T | undefined;
+    initialize(): Promise<void>;
+    preProcess(): Promise<void>;
+    finalize(): Promise<void>;
+    /**
+     * Validate the current property values on this instance.
+     *
+     * Default implementation defers to the class's static validateProperties
+     * over the result of `serialize()`. Subclasses can override to add
+     * runtime-only rules (for example, mutually-exclusive fields).
+     */
+    validate(options?: NodeValidationOptions): NodePropertyValidationIssue[];
+    abstract process(context?: ProcessingContext): Promise<Record<string, unknown>>;
+    genProcess(context?: ProcessingContext): AsyncGenerator<Record<string, unknown>>;
+    /**
+     * Streaming input+output processing.
+     * Override this for nodes with isStreamingInput=true.
+     * Drain inputs via `inputs.stream()` / `inputs.any()` and
+     * push results via `outputs.emit()`.
+     */
+    run?(inputs: StreamingInputs, outputs: StreamingOutputs, context?: ProcessingContext): Promise<void>;
+    /**
+     * Resolve requiredSettings from the context's secret store and inject
+     * them as `inputs._secrets` so node process() can access API keys.
+     */
+    private _injectSecrets;
+    /** Get resolved secrets (available during process()). */
+    get _secrets(): Record<string, string>;
+    toExecutor(): NodeExecutor;
+    static toDescriptor(id?: string): NodeDescriptor;
+}
+export {};
+//# sourceMappingURL=base-node.d.ts.map

package/dist/base-node.d.ts.map

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

package/dist/base-node.js

@@ -0,0 +1,225 @@
+import { getDeclaredPropertiesForClass } from "./decorators.js";
+import { validateNodeProperties } from "./validation.js";
+export class BaseNode {
+    static nodeType = "";
+    static title = "";
+    static description = "";
+    static layout = undefined;
+    static recommendedModels = undefined;
+    static basicFields = undefined;
+    static requiredSettings = undefined;
+    static requiredRuntimes = undefined;
+    static isStreamingInput = false;
+    static isStreamingOutput = false;
+    static isDynamic = false;
+    static syncMode = "zip_all";
+    static isControlled = false;
+    static exposeAsTool = undefined;
+    static supportsDynamicOutputs = undefined;
+    static autoSaveAsset = false;
+    static modelPacks = undefined;
+    static metadataOutputTypes = undefined;
+    static outputTypes = {};
+    __node_id = "";
+    __node_name = "";
+    dynamicProps = new Map();
+    constructor(properties = {}) {
+        this.assign(properties);
+    }
+    static getDeclaredProperties() {
+        return getDeclaredPropertiesForClass(this);
+    }
+    static getDeclaredOutputs() {
+        return { ...(this.outputTypes ?? {}) };
+    }
+    /**
+     * Validate a property bag against this node's declared @prop metadata.
+     *
+     * Flags two classes of problem:
+     *   - Properties declared `required: true` whose value is missing/empty.
+     *   - Properties whose type ends in `_model` whose value carries the
+     *     "empty" provider sentinel or an empty model id.
+     *
+     * Properties listed in `options.connectedHandles` are ignored — those
+     * receive their value from an upstream node at runtime.
+     *
+     * Subclasses may override this to add custom rules. Most nodes won't
+     * need to: declarative `@prop` metadata is enough.
+     */
+    static validateProperties(properties, options = {}) {
+        const cls = this;
+        return validateNodeProperties(cls.getDeclaredProperties(), properties, {
+            connectedHandles: options.connectedHandles,
+            nodeId: options.nodeId,
+            nodeType: cls.nodeType
+        });
+    }
+    assign(properties) {
+        const ctor = this.constructor;
+        const declared = ctor.getDeclaredProperties();
+        if (Object.prototype.hasOwnProperty.call(properties, "__node_id")) {
+            this.__node_id = String(properties.__node_id ?? "");
+        }
+        if (Object.prototype.hasOwnProperty.call(properties, "__node_name")) {
+            this.__node_name = String(properties.__node_name ?? "");
+        }
+        const declaredNames = new Set(declared.map((p) => p.name));
+        for (const { name, options } of declared) {
+            if (Object.prototype.hasOwnProperty.call(properties, name)) {
+                // Explicit value provided — use it
+                this[name] = properties[name];
+            }
+            else if (this[name] === undefined &&
+                Object.prototype.hasOwnProperty.call(options, "default")) {
+                // No value on instance yet and a default exists — apply it.
+                // Deep-copy mutable defaults so instances don't share references.
+                const def = options.default;
+                this[name] =
+                    def !== null && typeof def === "object"
+                        ? JSON.parse(JSON.stringify(def))
+                        : def;
+            }
+        }
+        // For dynamic nodes, store undeclared properties in dynamicProps
+        if (ctor.isDynamic) {
+            const skip = new Set(["__node_id", "__node_name", "_secrets"]);
+            for (const [key, value] of Object.entries(properties)) {
+                if (!declaredNames.has(key) && !skip.has(key)) {
+                    this.dynamicProps.set(key, value);
+                }
+            }
+        }
+    }
+    serialize() {
+        const ctor = this.constructor;
+        const result = {};
+        for (const { name } of ctor.getDeclaredProperties()) {
+            result[name] = this[name];
+        }
+        // Include dynamic properties so round-trip serialization is lossless
+        if (ctor.isDynamic) {
+            for (const [key, value] of this.dynamicProps) {
+                result[key] = value;
+            }
+        }
+        return result;
+    }
+    deserialize(data) {
+        this.assign(data);
+    }
+    setDynamic(key, value) {
+        this.dynamicProps.set(key, value);
+    }
+    getDynamic(key) {
+        return this.dynamicProps.get(key);
+    }
+    async initialize() { }
+    async preProcess() { }
+    async finalize() { }
+    /**
+     * Validate the current property values on this instance.
+     *
+     * Default implementation defers to the class's static validateProperties
+     * over the result of `serialize()`. Subclasses can override to add
+     * runtime-only rules (for example, mutually-exclusive fields).
+     */
+    validate(options = {}) {
+        const ctor = this.constructor;
+        return ctor.validateProperties(this.serialize(), {
+            connectedHandles: options.connectedHandles,
+            nodeId: options.nodeId ?? (this.__node_id || undefined)
+        });
+    }
+    async *genProcess(context) {
+        yield await this.process(context);
+    }
+    /**
+     * Resolve requiredSettings from the context's secret store and inject
+     * them as `inputs._secrets` so node process() can access API keys.
+     */
+    async _injectSecrets(inputs, context) {
+        const ctor = this.constructor;
+        const required = ctor.requiredSettings;
+        if (!required || required.length === 0) {
+            return inputs;
+        }
+        if (!context) {
+            console.warn(`[_injectSecrets] No context for ${ctor.nodeType}, required: ${required.join(", ")}`);
+            return inputs;
+        }
+        const secrets = {};
+        for (const key of required) {
+            const value = await context.getSecret(key);
+            if (value) {
+                secrets[key] = value;
+            }
+            else {
+                console.warn(`[_injectSecrets] Secret "${key}" not found for ${ctor.nodeType}`);
+            }
+        }
+        if (Object.keys(secrets).length === 0)
+            return inputs;
+        return {
+            ...inputs,
+            _secrets: {
+                ...(inputs._secrets ?? {}),
+                ...secrets
+            }
+        };
+    }
+    /** Get resolved secrets (available during process()). */
+    get _secrets() {
+        return this.getDynamic("_secrets") ?? {};
+    }
+    toExecutor() {
+        const executor = {
+            process: async (inputs, context) => {
+                const merged = await this._injectSecrets(inputs, context);
+                const { _secrets, ...props } = merged;
+                if (_secrets)
+                    this.setDynamic("_secrets", _secrets);
+                this.assign(props);
+                return this.process(context);
+            },
+            genProcess: async function* (inputs, context) {
+                const merged = await this._injectSecrets(inputs, context);
+                const { _secrets, ...props } = merged;
+                if (_secrets)
+                    this.setDynamic("_secrets", _secrets);
+                this.assign(props);
+                yield* this.genProcess(context);
+            }.bind(this),
+            preProcess: () => this.preProcess(),
+            finalize: () => this.finalize(),
+            initialize: () => this.initialize()
+        };
+        if (this.run) {
+            executor.run = async (inputs, outputs, context) => this.run(inputs, outputs, context);
+        }
+        return executor;
+    }
+    static toDescriptor(id) {
+        const cls = this;
+        const propertyTypes = Object.fromEntries(cls
+            .getDeclaredProperties()
+            .map((entry) => [entry.name, entry.options.type]));
+        const desc = {
+            id: id ?? cls.nodeType,
+            type: cls.nodeType,
+            name: cls.title,
+            is_streaming_input: cls.isStreamingInput,
+            is_streaming_output: cls.isStreamingOutput,
+            sync_mode: cls.syncMode,
+            is_controlled: cls.isControlled
+        };
+        if (Object.keys(propertyTypes).length > 0) {
+            desc.propertyTypes = propertyTypes;
+        }
+        const outputs = cls.getDeclaredOutputs();
+        if (Object.keys(outputs).length > 0) {
+            desc.outputs = outputs;
+        }
+        return desc;
+    }
+}
+//# sourceMappingURL=base-node.js.map

package/dist/base-node.js.map

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

package/dist/decorators.d.ts

@@ -0,0 +1,19 @@
+export interface PropOptions {
+    type: string;
+    default?: unknown;
+    title?: string;
+    description?: string;
+    min?: number;
+    max?: number;
+    required?: boolean;
+    values?: Array<string | number>;
+    json_schema_extra?: Record<string, unknown>;
+}
+export interface DeclaredPropertyMetadata {
+    name: string;
+    options: PropOptions;
+}
+export declare function registerDeclaredProperty(ctor: Function, name: string, options: PropOptions): void;
+export declare function getDeclaredPropertiesForClass(ctor: Function): DeclaredPropertyMetadata[];
+export declare function prop(options: PropOptions): PropertyDecorator;
+//# sourceMappingURL=decorators.d.ts.map

package/dist/decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../src/decorators.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAChC,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,WAAW,CAAC;CACtB;AAqCD,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,QAAQ,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,WAAW,GACnB,IAAI,CAGN;AAED,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,QAAQ,GACb,wBAAwB,EAAE,CAE5B;AAED,wBAAgB,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,iBAAiB,CAK5D"}

package/dist/decorators.js

@@ -0,0 +1,42 @@
+const declaredPropsByClass = new WeakMap();
+function getOrCreatePropMap(ctor) {
+    const existing = declaredPropsByClass.get(ctor);
+    if (existing)
+        return existing;
+    const created = new Map();
+    declaredPropsByClass.set(ctor, created);
+    return created;
+}
+function collectDeclaredProps(ctor) {
+    const chain = [];
+    let current = ctor;
+    while (typeof current === "function" && current !== Function.prototype) {
+        chain.push(current);
+        current = Object.getPrototypeOf(current);
+    }
+    chain.reverse();
+    const merged = new Map();
+    for (const cls of chain) {
+        const entries = declaredPropsByClass.get(cls);
+        if (!entries)
+            continue;
+        for (const [name, metadata] of entries.entries()) {
+            merged.set(name, metadata);
+        }
+    }
+    return [...merged.values()];
+}
+export function registerDeclaredProperty(ctor, name, options) {
+    const map = getOrCreatePropMap(ctor);
+    map.set(name, { name, options: { ...options } });
+}
+export function getDeclaredPropertiesForClass(ctor) {
+    return collectDeclaredProps(ctor);
+}
+export function prop(options) {
+    return (target, propertyKey) => {
+        const ctor = target.constructor;
+        registerDeclaredProperty(ctor, String(propertyKey), options);
+    };
+}
+//# sourceMappingURL=decorators.js.map

package/dist/decorators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.js","sourceRoot":"","sources":["../src/decorators.ts"],"names":[],"mappings":"AAiBA,MAAM,oBAAoB,GAAG,IAAI,OAAO,EAGrC,CAAC;AAEJ,SAAS,kBAAkB,CACzB,IAAc;IAEd,MAAM,QAAQ,GAAG,oBAAoB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChD,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,MAAM,OAAO,GAAG,IAAI,GAAG,EAAoC,CAAC;IAC5D,oBAAoB,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACxC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,oBAAoB,CAAC,IAAc;IAC1C,MAAM,KAAK,GAAe,EAAE,CAAC;IAC7B,IAAI,OAAO,GAAY,IAAI,CAAC;IAC5B,OAAO,OAAO,OAAO,KAAK,UAAU,IAAI,OAAO,KAAK,QAAQ,CAAC,SAAS,EAAE,CAAC;QACvE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACpB,OAAO,GAAG,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;IAC3C,CAAC;IACD,KAAK,CAAC,OAAO,EAAE,CAAC;IAEhB,MAAM,MAAM,GAAG,IAAI,GAAG,EAAoC,CAAC;IAC3D,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;QACxB,MAAM,OAAO,GAAG,oBAAoB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC9C,IAAI,CAAC,OAAO;YAAE,SAAS;QACvB,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;YACjD,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IACD,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,IAAc,EACd,IAAY,EACZ,OAAoB;IAEpB,MAAM,GAAG,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IACrC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,EAAE,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC3C,IAAc;IAEd,OAAO,oBAAoB,CAAC,IAAI,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,OAAoB;IACvC,OAAO,CAAC,MAAc,EAAE,WAA4B,EAAQ,EAAE;QAC5D,MAAM,IAAI,GAAI,MAAoC,CAAC,WAAW,CAAC;QAC/D,wBAAwB,CAAC,IAAI,EAAE,MAAM,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC,CAAC;IAC/D,CAAC,CAAC;AACJ,CAAC"}

package/dist/docs/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./overview.js";
+export * from "./nodes.js";
+export * from "./workflows.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/docs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/docs/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC"}

package/dist/docs/index.js

@@ -0,0 +1,4 @@
+export * from "./overview.js";
+export * from "./nodes.js";
+export * from "./workflows.js";
+//# sourceMappingURL=index.js.map

package/dist/docs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/docs/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC"}

package/dist/docs/nodes.d.ts

@@ -0,0 +1,10 @@
+import type { NodeMetadata } from "../metadata.js";
+export interface NodeDocOptions {
+    /** Filter by package_name (matches NodeMetadata.namespace prefix). */
+    packageName?: string;
+}
+/** Build a filesystem-safe filename for a node: "<namespace>-<title>.md". */
+export declare function slugifyNodeFilename(node: NodeMetadata): string;
+export declare function generateNodeMarkdown(node: NodeMetadata): string;
+export declare function generateAllNodeDocs(nodes: NodeMetadata[], opts?: NodeDocOptions): Map<string, string>;
+//# sourceMappingURL=nodes.d.ts.map

package/dist/docs/nodes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodes.d.ts","sourceRoot":"","sources":["../../src/docs/nodes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EAIb,MAAM,gBAAgB,CAAC;AAExB,MAAM,WAAW,cAAc;IAC7B,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAgCD,6EAA6E;AAC7E,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAQ9D;AAiBD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAiC/D;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,YAAY,EAAE,EACrB,IAAI,GAAE,cAAmB,GACxB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAYrB"}

package/dist/docs/nodes.js

@@ -0,0 +1,99 @@
+function typeMetaToString(type) {
+    const args = (type.type_args ?? []).map(typeMetaToString).filter(Boolean);
+    if (args.length === 0)
+        return type.type;
+    return `${type.type}[${args.join(", ")}]`;
+}
+function escapeCell(value) {
+    return value
+        .replace(/\\/g, "\\\\")
+        .replace(/\|/g, "\\|")
+        .replace(/\r?\n/g, " ");
+}
+function formatDefault(value) {
+    if (value === undefined)
+        return "";
+    if (value === null)
+        return "null";
+    if (typeof value === "string") {
+        return value.length > 40 ? `"${value.slice(0, 37)}..."` : `"${value}"`;
+    }
+    if (typeof value === "object") {
+        try {
+            const s = JSON.stringify(value);
+            return s.length > 40 ? `${s.slice(0, 37)}...` : s;
+        }
+        catch {
+            return String(value);
+        }
+    }
+    return String(value);
+}
+/** Build a filesystem-safe filename for a node: "<namespace>-<title>.md". */
+export function slugifyNodeFilename(node) {
+    const base = `${node.namespace}.${node.title || node.node_type}`;
+    const slug = base
+        .toLowerCase()
+        .replace(/[^a-z0-9.]+/g, "-")
+        .replace(/-+/g, "-")
+        .replace(/^-|-$/g, "");
+    return `${slug}.md`;
+}
+function propertyRow(prop) {
+    const name = escapeCell(prop.name);
+    const typeStr = escapeCell(typeMetaToString(prop.type));
+    const def = escapeCell(formatDefault(prop.default));
+    const desc = escapeCell(prop.description ?? "");
+    return `| ${name} | ${typeStr} | ${def} | ${desc} |`;
+}
+function outputRow(output) {
+    const name = escapeCell(output.name);
+    const typeStr = escapeCell(typeMetaToString(output.type));
+    const streaming = output.stream ? " (stream)" : "";
+    return `| ${name} | ${typeStr}${streaming} |`;
+}
+export function generateNodeMarkdown(node) {
+    const lines = [];
+    lines.push(`# ${node.title}`, "");
+    lines.push(`\`${node.node_type}\``, "");
+    if (node.description) {
+        lines.push(node.description, "");
+    }
+    lines.push("## Properties", "");
+    if (!node.properties || node.properties.length === 0) {
+        lines.push("_(none)_", "");
+    }
+    else {
+        lines.push("| Name | Type | Default | Description |");
+        lines.push("|------|------|---------|-------------|");
+        for (const prop of node.properties) {
+            lines.push(propertyRow(prop));
+        }
+        lines.push("");
+    }
+    lines.push("## Outputs", "");
+    if (!node.outputs || node.outputs.length === 0) {
+        lines.push("_(none)_", "");
+    }
+    else {
+        lines.push("| Name | Type |");
+        lines.push("|------|------|");
+        for (const output of node.outputs) {
+            lines.push(outputRow(output));
+        }
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+export function generateAllNodeDocs(nodes, opts = {}) {
+    const docs = new Map();
+    for (const node of nodes) {
+        if (opts.packageName &&
+            !node.namespace.startsWith(opts.packageName)) {
+            continue;
+        }
+        docs.set(slugifyNodeFilename(node), generateNodeMarkdown(node));
+    }
+    return docs;
+}
+//# sourceMappingURL=nodes.js.map

package/dist/docs/nodes.js.map

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

package/dist/docs/overview.d.ts

@@ -0,0 +1,6 @@
+import type { PackageMetadata } from "../metadata.js";
+export interface OverviewOptions {
+    compact?: boolean;
+}
+export declare function generatePackageOverviewMarkdown(pkg: PackageMetadata, opts?: OverviewOptions): string;
+//# sourceMappingURL=overview.d.ts.map

package/dist/docs/overview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overview.d.ts","sourceRoot":"","sources":["../../src/docs/overview.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAgB,MAAM,gBAAgB,CAAC;AAGpE,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAoBD,wBAAgB,+BAA+B,CAC7C,GAAG,EAAE,eAAe,EACpB,IAAI,GAAE,eAAoB,GACzB,MAAM,CA0DR"}