@nodetool-ai/node-sdk 0.7.0-rc.23 → 0.8.2

package/dist/pack-loader.d.ts.map

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

package/dist/pack-loader.js

@@ -0,0 +1,529 @@
+/**
+ * Dynamic node pack loader with a trust/governance layer.
+ *
+ * Discovers installed third-party node packs and registers their nodes into a
+ * {@link NodeRegistry}. A pack is any npm package whose `package.json` carries a
+ * `nodetool` field:
+ *
+ * ```jsonc
+ * {
+ *   "name": "@acme/cool-nodes",
+ *   "main": "dist/index.js",
+ *   "nodetool": {
+ *     "apiVersion": 1,
+ *     "register": "register"   // named export called with the registry
+ *   }
+ * }
+ * ```
+ *
+ * Trust model — packs run in-process with full server privileges (filesystem,
+ * secrets, network), so loading is gated:
+ *
+ *   - **Allowlist**: explicit list of trusted pack names. `"*"` allows all.
+ *   - **allowUnlisted**: whether packs not on the allowlist load anyway.
+ *     Defaults to `true` in development and `false` in production, so a
+ *     production server never silently runs whatever happens to be in
+ *     `node_modules`.
+ *
+ * Resolved (when not passed explicitly) from `NODETOOL_PACKS_ALLOWLIST` and a
+ * config file at `~/.config/nodetool/packs.json` (override via
+ * `NODETOOL_PACKS_CONFIG`).
+ *
+ * Two further guards protect the registry from misbehaving packs:
+ *   - **Reserved namespaces**: packs cannot register node types under
+ *     first-party namespaces (`nodetool.`, `lib.`, provider names, …).
+ *   - **Collision protection**: a pack cannot shadow an already-registered node
+ *     type (e.g. a built-in); the conflicting node is skipped with a warning.
+ */
+import { existsSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { isBoolean, isCallable, isObjectLike, isString } from "./type-predicates.js";
+import { dirname, isAbsolute, join, resolve } from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+import { SHIPPED_SANDBOX_PACKS_BUNDLE_DIR, SHIPPED_SANDBOX_PACKS_SOURCE_DIR } from "@nodetool-ai/config";
+import { NodePackHostManifestSchema } from "@nodetool-ai/protocol";
+/** The current pack API version. Packs declaring a higher version are skipped. */
+export const PACK_API_VERSION = 1;
+/** Default named export a pack's entry should expose. */
+const DEFAULT_REGISTER_EXPORT = "register";
+/**
+ * First-party node-type namespaces a third-party pack may not register under.
+ * Matched against the first dot-separated segment of a node type.
+ */
+export const DEFAULT_RESERVED_NAMESPACES = [
+    "nodetool",
+    "lib",
+    "comfy",
+    "default",
+    "huggingface",
+    "hf",
+    "mlx",
+    "transformers",
+    "openai",
+    "gemini",
+    "anthropic",
+    "mistral",
+    "groq",
+    "ollama",
+    "replicate",
+    "fal",
+    "elevenlabs",
+    "kie",
+    "vector",
+    "apify",
+    "search",
+    "messaging"
+];
+/**
+ * Walk up from `start` collecting each `node_modules` directory that exists,
+ * then add the root holding the packs that ship with NodeTool.
+ *
+ * Also includes any extra `node_modules` directories named in the
+ * `NODETOOL_OPTIONAL_NODE_MODULES` or `NODETOOL_PACK_SEARCH_PATHS` env vars
+ * (comma- or platform-separator-delimited). These are how the Electron app and
+ * other hosts hand the loader an install root outside the project tree.
+ *
+ * The shipped root comes last, so a pack of the same name found in any
+ * `node_modules` wins: what the user installed shadows the copy in the app.
+ */
+export function defaultPackSearchPaths(start = process.cwd()) {
+    const paths = [];
+    for (const extra of readEnvPackPaths()) {
+        if (existsSync(extra))
+            paths.push(extra);
+    }
+    let dir = resolve(start);
+    for (;;) {
+        const candidate = join(dir, "node_modules");
+        if (existsSync(candidate))
+            paths.push(candidate);
+        const parent = dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    paths.push(...shippedPackSearchPaths());
+    // Dedupe — an env-supplied path may also be on the cwd walk.
+    return [...new Set(paths)];
+}
+/**
+ * Roots holding the sandbox packs that ship with NodeTool.
+ *
+ * They are config-only packages no host code may import, so they are not
+ * workspaces and npm links nothing into `node_modules`. Every host therefore
+ * reads them from where its own build put them, found relative to this module:
+ *
+ *   - the bundled backend inlines this file into `server.mjs`, and
+ *     `bundle-backend.mjs` stages the packs in `_sandbox/` beside it — the
+ *     layout the packaged desktop app and the Docker/Fly image both run;
+ *   - a checkout resolves this file inside `packages/node-sdk`, so the source
+ *     directory is on the way up to the repo root.
+ *
+ * `NODETOOL_SHIPPED_PACKS_DIR` overrides both, for a host that stages them
+ * somewhere else. Non-existent candidates are dropped, so a host that ships no
+ * packs at all gets an empty list rather than a bad root.
+ */
+export function shippedPackSearchPaths() {
+    const override = process.env["NODETOOL_SHIPPED_PACKS_DIR"];
+    if (override)
+        return splitPathList(override).filter((p) => existsSync(p));
+    const here = dirname(fileURLToPath(import.meta.url));
+    const bundled = join(here, SHIPPED_SANDBOX_PACKS_BUNDLE_DIR);
+    if (existsSync(bundled))
+        return [bundled];
+    const segments = SHIPPED_SANDBOX_PACKS_SOURCE_DIR.split("/");
+    let dir = here;
+    for (;;) {
+        const candidate = join(dir, ...segments);
+        if (existsSync(candidate))
+            return [candidate];
+        const parent = dirname(dir);
+        if (parent === dir)
+            return [];
+        dir = parent;
+    }
+}
+function splitPathList(list) {
+    // Comma, semicolon, or the platform PATH separator. ":" must not split
+    // on Windows — it would shear drive letters off absolute paths (C:\…).
+    const separators = process.platform === "win32" ? /[,;]/ : /[,;:]/;
+    return list
+        .split(separators)
+        .map((entry) => entry.trim())
+        .filter((entry) => entry.length > 0);
+}
+function readEnvPackPaths() {
+    // Stryker disable next-line ArrayDeclaration: a bogus seed path is dropped by the existsSync filter in defaultPackSearchPaths (its only caller), so the result is unchanged (equivalent).
+    const out = [];
+    const single = process.env["NODETOOL_OPTIONAL_NODE_MODULES"];
+    // Stryker disable next-line ConditionalExpression: forcing this pushes an undefined single, which the existsSync filter downstream discards (equivalent).
+    if (single)
+        out.push(single);
+    const list = process.env["NODETOOL_PACK_SEARCH_PATHS"];
+    if (list)
+        out.push(...splitPathList(list));
+    return out;
+}
+/**
+ * Resolve the effective trust config from explicit options, then environment,
+ * then the config file, then defaults.
+ */
+export function resolvePackTrust(options = {}) {
+    const fromFile = readPacksConfigFile();
+    const envAllow = process.env["NODETOOL_PACKS_ALLOWLIST"];
+    const envList = envAllow
+        ? envAllow
+            .split(",")
+            .map((s) => s.trim())
+            .filter(Boolean)
+        : undefined;
+    const allowlist = options.allowlist ?? envList ?? fromFile.allow ?? [];
+    // Unlisted packs are trusted by default only in development. Production
+    // servers (NODETOOL_ENV=production) and the packaged desktop app
+    // (NODETOOL_PACKS_REQUIRE_ALLOWLIST=1 — set by Electron, which must NOT run
+    // in production mode because that disables local-only features like the
+    // Python bridge and the file browser) both require an explicit allowlist.
+    const isProd = process.env["NODETOOL_ENV"] === "production";
+    const requireAllowlist = process.env["NODETOOL_PACKS_REQUIRE_ALLOWLIST"] === "1";
+    const allowUnlisted = options.allowUnlisted ??
+        fromFile.allowUnlisted ??
+        !(isProd || requireAllowlist);
+    return { allowlist, allowUnlisted };
+}
+/**
+ * The trust fields as they exist ON DISK (no env or default merging). Use this
+ * — not {@link resolvePackTrust} — when persisting a partial trust update, so an
+ * ephemeral `NODETOOL_PACKS_ALLOWLIST` env override is never baked into the
+ * config file for a field the caller didn't set.
+ */
+export function readPackTrustFromFile() {
+    const f = readPacksConfigFile();
+    return { allow: f.allow, allowUnlisted: f.allowUnlisted };
+}
+function trustConfigPath() {
+    return (process.env["NODETOOL_PACKS_CONFIG"] ??
+        // Stryker disable next-line StringLiteral: the default path is anchored at the OS home dir; tests exercise trust resolution via the NODETOOL_PACKS_CONFIG override, and these path segments are not independently asserted (home-dir manipulation is unreliable under the test sandbox).
+        join(homedir(), ".config", "nodetool", "packs.json"));
+}
+function stringArray(value) {
+    return Array.isArray(value)
+        ? value.filter((v) => typeof v === "string")
+        : undefined;
+}
+function readPacksConfigFile(path = trustConfigPath()) {
+    try {
+        const parsed = JSON.parse(readFileSync(path, "utf8"));
+        return {
+            allow: stringArray(parsed.allow),
+            allowUnlisted: isBoolean(parsed.allowUnlisted)
+                ? parsed.allowUnlisted
+                : undefined,
+            enabledBuiltins: stringArray(parsed.enabledBuiltins),
+            disabledBuiltins: stringArray(parsed.disabledBuiltins)
+        };
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Explicit user overrides for built-in packs, keyed by pack id. Packs absent
+ * from the map keep their install default (`defaultEnabled` in the catalog).
+ * The server applies this at bootstrap; changes take effect on restart.
+ */
+export function readBuiltinPackOverrides() {
+    const config = readPacksConfigFile();
+    const overrides = {};
+    for (const id of config.disabledBuiltins ?? [])
+        overrides[id] = false;
+    for (const id of config.enabledBuiltins ?? [])
+        overrides[id] = true;
+    return overrides;
+}
+/**
+ * Persist built-in pack overrides as `enabledBuiltins` / `disabledBuiltins`
+ * lists, preserving the trust fields already in the config file. Creates
+ * parent directories as needed.
+ */
+export function writeBuiltinPackOverrides(overrides, path = trustConfigPath()) {
+    const current = readPacksConfigFile(path);
+    const enabled = Object.keys(overrides).filter((id) => overrides[id]).sort();
+    const disabled = Object.keys(overrides)
+        .filter((id) => !overrides[id])
+        .sort();
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, JSON.stringify({ ...current, enabledBuiltins: enabled, disabledBuiltins: disabled }, null, 2) + "\n", "utf8");
+}
+/**
+ * Persist a trust config to disk so it's picked up by {@link resolvePackTrust}
+ * on the next call. Creates parent directories as needed.
+ */
+export function writePackTrustConfig(trust, path = trustConfigPath()) {
+    // Preserve unrelated fields (e.g. disabledBuiltins) already in the file.
+    const current = readPacksConfigFile(path);
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, JSON.stringify({
+        ...current,
+        allow: trust.allowlist,
+        allowUnlisted: trust.allowUnlisted
+    }, null, 2) + "\n", 
+    // Stryker disable next-line StringLiteral: Node decodes "" as utf-8, so the encoding argument is behaviourally equivalent.
+    "utf8");
+}
+function isAllowed(name, trust) {
+    if (isPackTrusted(name, trust))
+        return true;
+    return trust.allowUnlisted;
+}
+/**
+ * Whether the operator put this pack on the allowlist.
+ *
+ * Distinct from {@link isAllowed}: `allowUnlisted` lets a pack *load* (it
+ * defaults to true outside production, so a dev box runs what is installed),
+ * which is not a statement that anyone vouched for it. Only a name — or `*` —
+ * written on the allowlist is, and that is the line the SKILL.md disclosure
+ * policy draws between "registers as a skill" and "reaches the agent only as
+ * untrusted tool output".
+ */
+export function isPackTrusted(name, trust = resolvePackTrust()) {
+    return trust.allowlist.includes("*") || trust.allowlist.includes(name);
+}
+/**
+ * Scan the given `node_modules` directories for packs.
+ *
+ * The first occurrence of a given package name wins, so nearer `node_modules`
+ * shadow farther ones — matching Node's own resolution order.
+ */
+export function discoverPacks(searchPaths = defaultPackSearchPaths()) {
+    const found = new Map();
+    for (const nodeModules of searchPaths) {
+        for (const pkgDir of listPackageDirs(nodeModules)) {
+            const pack = readPack(pkgDir);
+            if (pack && !found.has(pack.name))
+                found.set(pack.name, pack);
+        }
+    }
+    return [...found.values()];
+}
+/**
+ * Discover and load all trusted installed packs into `registry`.
+ *
+ * Loading is gated by the trust config; reserved namespaces and existing node
+ * types are protected. A failure in one pack never aborts the others.
+ */
+export async function loadInstalledPacks(registry, options = {}) {
+    const trust = resolvePackTrust(options.trust);
+    const reserved = options.reservedNamespaces ?? DEFAULT_RESERVED_NAMESPACES;
+    const packs = discoverPacks(options.searchPaths);
+    const results = [];
+    for (const pack of packs) {
+        let result;
+        if (!isAllowed(pack.name, trust)) {
+            result = {
+                pack,
+                status: "skipped",
+                reason: "not on pack allowlist",
+                registered: [],
+                skippedNodes: []
+            };
+        }
+        else {
+            result = await loadPack(registry, pack, reserved);
+        }
+        results.push(result);
+        options.onResult?.(result);
+    }
+    return results;
+}
+async function loadPack(registry, pack, reserved) {
+    const declared = pack.manifest.apiVersion ?? PACK_API_VERSION;
+    if (declared > PACK_API_VERSION) {
+        return {
+            pack,
+            status: "skipped",
+            reason: `requires pack API v${declared}, host supports v${PACK_API_VERSION}`,
+            registered: [],
+            skippedNodes: []
+        };
+    }
+    const registered = [];
+    const skippedNodes = [];
+    const guarded = makeGuardedRegistry(registry, reserved, registered, skippedNodes, pack.name);
+    try {
+        const mod = (await import(
+        /* @vite-ignore */ pathToFileURL(pack.entry).href));
+        const register = resolveRegisterFn(mod, pack.registerExport);
+        if (!register) {
+            throw new Error(`entry "${pack.entry}" has no callable export "${pack.registerExport}"`);
+        }
+        await register(guarded);
+        return { pack, status: "loaded", registered, skippedNodes };
+    }
+    catch (error) {
+        return {
+            pack,
+            status: "error",
+            error: error instanceof Error ? error : new Error(String(error)),
+            registered,
+            skippedNodes
+        };
+    }
+}
+function makeGuardedRegistry(target, reserved, registered, skippedNodes, packageId) {
+    return {
+        has: (nodeType) => target.has(nodeType),
+        register: (nodeClass) => {
+            const nodeType = nodeClass.nodeType;
+            // Stryker disable next-line ConditionalExpression,BlockStatement: a falsy nodeType errors either way — this branch lets target.register throw "without nodeType"; skipping it makes isReservedNamespace throw on the missing type — both surface as a loadPack error (equivalent).
+            if (!nodeType) {
+                // Let the real registry surface the "no nodeType" error.
+                target.register(nodeClass, { packageId });
+                return;
+            }
+            if (isReservedNamespace(nodeType, reserved)) {
+                skippedNodes.push({ nodeType, reason: "reserved-namespace" });
+                return;
+            }
+            if (target.has(nodeType)) {
+                skippedNodes.push({ nodeType, reason: "collision" });
+                return;
+            }
+            target.register(nodeClass, { packageId });
+            registered.push(nodeType);
+        }
+    };
+}
+function isReservedNamespace(nodeType, reserved) {
+    const dot = nodeType.indexOf(".");
+    // Stryker disable next-line EqualityOperator: > 0 vs >= 0 differ only at dot === 0 (a leading-dot type), where head becomes "" vs the full string — but neither is ever a reserved namespace, so the result is unchanged (equivalent).
+    const head = dot > 0 ? nodeType.slice(0, dot) : nodeType;
+    return reserved.includes(head);
+}
+function resolveRegisterFn(mod, exportName) {
+    const candidate = mod[exportName] ??
+        mod["default"]?.[exportName];
+    return isCallable(candidate)
+        ? candidate
+        : undefined;
+}
+/**
+ * Every package directory directly inside one `node_modules`, with scoped
+ * packages expanded one level deeper. Exported for the sandbox catalog host,
+ * which scans the same roots without importing any pack.
+ */
+export function listPackageDirs(nodeModules) {
+    let entries;
+    try {
+        entries = readdirSync(nodeModules);
+    }
+    catch {
+        // Stryker disable next-line ArrayDeclaration: a bogus seed path has no package.json, so discoverPacks (the only caller) drops it via readPack — equivalent.
+        return [];
+    }
+    // Stryker disable next-line ArrayDeclaration: a bogus seed path has no package.json, so readPack returns undefined for it and discoverPacks drops it — the result is unchanged (equivalent).
+    const dirs = [];
+    for (const name of entries) {
+        if (name === ".bin" || name === ".cache")
+            continue;
+        const full = join(nodeModules, name);
+        if (name.startsWith("@")) {
+            // Scoped: one level deeper holds the actual packages.
+            let scoped;
+            try {
+                scoped = readdirSync(full);
+            }
+            catch {
+                continue;
+            }
+            for (const sub of scoped)
+                dirs.push(join(full, sub));
+        }
+        else {
+            dirs.push(full);
+        }
+    }
+    return dirs;
+}
+function readPack(pkgDir) {
+    const pkgJsonPath = join(pkgDir, "package.json");
+    let pkg;
+    try {
+        // Stryker disable next-line ConditionalExpression: if package.json is a directory, the readFileSync below throws into this catch and also returns undefined, so the guard is equivalent.
+        if (!statSync(pkgJsonPath).isFile())
+            return undefined;
+        pkg = JSON.parse(readFileSync(pkgJsonPath, "utf8"));
+    }
+    catch {
+        return undefined;
+    }
+    const manifest = parsePackManifest(pkg.nodetool, pkg.name ?? pkgJsonPath);
+    if (!manifest || isSandboxOnlyManifest(manifest))
+        return undefined;
+    if (!pkg.name)
+        return undefined;
+    const entryRel = resolveEntry(pkg);
+    // Stryker disable next-line ConditionalExpression: resolveEntry always returns a string (it falls back to "index.js"), so entryRel is never falsy here (equivalent).
+    if (!entryRel)
+        return undefined;
+    const entry = isAbsolute(entryRel) ? entryRel : join(pkgDir, entryRel);
+    if (!existsSync(entry))
+        return undefined;
+    return {
+        name: pkg.name,
+        version: pkg.version,
+        dir: pkgDir,
+        entry,
+        registerExport: manifest.register ?? DEFAULT_REGISTER_EXPORT,
+        manifest
+    };
+}
+function parsePackManifest(value, packageLabel) {
+    const parsed = NodePackHostManifestSchema.safeParse(value);
+    if (!parsed.success) {
+        if (value !== undefined) {
+            console.warn(`Skipping ${packageLabel}: invalid nodetool manifest: ${parsed.error.message}`);
+        }
+        return undefined;
+    }
+    const manifest = {};
+    if (parsed.data.apiVersion !== undefined) {
+        manifest.apiVersion = parsed.data.apiVersion;
+    }
+    if (parsed.data.register !== undefined) {
+        manifest.register = parsed.data.register;
+    }
+    if (Object.hasOwn(parsed.data, "sandboxModules")) {
+        manifest.sandboxModules = parsed.data.sandboxModules;
+    }
+    return manifest;
+}
+function isSandboxOnlyManifest(manifest) {
+    return (Object.hasOwn(manifest, "sandboxModules") &&
+        !Object.hasOwn(manifest, "register"));
+}
+/** Resolve the entry module from `exports["."]` (import condition) or `main`. */
+function resolveEntry(pkg) {
+    const dot = pkg.exports?.["."];
+    if (isString(dot))
+        return dot;
+    const picked = pickExportCondition(dot);
+    if (picked != null)
+        return picked;
+    return pkg.main ?? "index.js";
+}
+/**
+ * Pick the `import` (then `default`) condition from an `exports["."]` object.
+ * Conditions may nest (e.g. `{ import: { types: "...", default: "x.js" } }`),
+ * so recurse until a string target is found. Depth-capped against cycles.
+ */
+function pickExportCondition(dot, depth = 0) {
+    // Stryker disable next-line ConditionalExpression: a nullish or non-object dot has no conditions to pick — every guard variant resolves to undefined and falls through to `main` (covered by the exports/main entry tests).
+    if (!isObjectLike(dot) || depth > 4)
+        return undefined;
+    const conds = dot;
+    const picked = conds["import"] ?? conds["default"];
+    if (isString(picked))
+        return picked;
+    return pickExportCondition(picked, depth + 1);
+}
+//# sourceMappingURL=pack-loader.js.map

package/dist/pack-loader.js.map

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

package/dist/port-types.d.ts

@@ -0,0 +1,15 @@
+/** Scalar and container types every NodeTool install understands. */
+export declare const CORE_PORT_TYPES: readonly ["any", "str", "text", "int", "float", "number", "bool", "list", "dict", "union", "enum", "image", "audio", "video", "document", "file"];
+/** The NodeTool name for a known alias, case-insensitively. */
+export declare const canonicalPortType: (type: string) => string | undefined;
+/** One alias found in a type declaration, and the name to use instead. */
+export interface PortTypeAlias {
+    used: string;
+    canonical: string;
+}
+/**
+ * Every alias in a type declaration, walking `type_args` so `list[integer]` is
+ * caught as well as a bare `integer`.
+ */
+export declare function portTypeAliases(type: unknown): PortTypeAlias[];
+//# sourceMappingURL=port-types.d.ts.map

package/dist/port-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"port-types.d.ts","sourceRoot":"","sources":["../src/port-types.ts"],"names":[],"mappings":"AAkBA,qEAAqE;AACrE,eAAO,MAAM,eAAe,YAC1B,KAAK,EACL,KAAK,EACL,MAAM,EACN,KAAK,EACL,OAAO,EACP,QAAQ,EACR,MAAM,EACN,MAAM,EACN,MAAM,EACN,OAAO,EACP,MAAM,EACN,OAAO,EACP,OAAO,EACP,OAAO,EACP,UAAU,EACV,MAAM,CACE,CAAC;AA0BX,+DAA+D;AAC/D,eAAO,MAAM,iBAAiB,SAAU,MAAM,KAAG,MAAM,GAAG,SAClB,CAAC;AAEzC,0EAA0E;AAC1E,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,aAAa,EAAE,CAkB9D"}

package/dist/port-types.js

@@ -0,0 +1,72 @@
+import { isObjectLike, isString } from "./type-predicates.js";
+/** Scalar and container types every NodeTool install understands. */
+export const CORE_PORT_TYPES = [
+    "any",
+    "str",
+    "text",
+    "int",
+    "float",
+    "number",
+    "bool",
+    "list",
+    "dict",
+    "union",
+    "enum",
+    "image",
+    "audio",
+    "video",
+    "document",
+    "file"
+];
+/**
+ * Spellings that get reached for which NodeTool spells differently. JSON Schema
+ * (`integer`, `string`, `boolean`, `object`, `array`, `null`) and TypeScript
+ * (`String`, `Number`, `Record`) both appear in practice.
+ */
+const ALIASES = new Map([
+    ["integer", "int"],
+    ["long", "int"],
+    ["double", "float"],
+    ["decimal", "float"],
+    ["string", "str"],
+    ["boolean", "bool"],
+    ["object", "dict"],
+    ["record", "dict"],
+    ["map", "dict"],
+    ["array", "list"],
+    ["tuple", "list"],
+    ["null", "any"],
+    ["none", "any"],
+    ["undefined", "any"],
+    ["unknown", "any"],
+    ["void", "any"]
+]);
+/** The NodeTool name for a known alias, case-insensitively. */
+export const canonicalPortType = (type) => ALIASES.get(type.trim().toLowerCase());
+/**
+ * Every alias in a type declaration, walking `type_args` so `list[integer]` is
+ * caught as well as a bare `integer`.
+ */
+export function portTypeAliases(type) {
+    const found = [];
+    const visit = (candidate) => {
+        if (!isObjectLike(candidate))
+            return;
+        const meta = candidate;
+        if (isString(meta.type)) {
+            const canonical = canonicalPortType(meta.type);
+            if (canonical)
+                found.push({ used: meta.type, canonical });
+        }
+        const args = Array.isArray(meta.type_args)
+            ? meta.type_args
+            : Array.isArray(meta.args)
+                ? meta.args
+                : [];
+        for (const arg of args)
+            visit(arg);
+    };
+    visit(type);
+    return found;
+}
+//# sourceMappingURL=port-types.js.map

package/dist/port-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"port-types.js","sourceRoot":"","sources":["../src/port-types.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAE9D,qEAAqE;AACrE,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,KAAK;IACL,KAAK;IACL,MAAM;IACN,KAAK;IACL,OAAO;IACP,QAAQ;IACR,MAAM;IACN,MAAM;IACN,MAAM;IACN,OAAO;IACP,MAAM;IACN,OAAO;IACP,OAAO;IACP,OAAO;IACP,UAAU;IACV,MAAM;CACE,CAAC;AAEX;;;;GAIG;AACH,MAAM,OAAO,GAAgC,IAAI,GAAG,CAAC;IACnD,CAAC,SAAS,EAAE,KAAK,CAAC;IAClB,CAAC,MAAM,EAAE,KAAK,CAAC;IACf,CAAC,QAAQ,EAAE,OAAO,CAAC;IACnB,CAAC,SAAS,EAAE,OAAO,CAAC;IACpB,CAAC,QAAQ,EAAE,KAAK,CAAC;IACjB,CAAC,SAAS,EAAE,MAAM,CAAC;IACnB,CAAC,QAAQ,EAAE,MAAM,CAAC;IAClB,CAAC,QAAQ,EAAE,MAAM,CAAC;IAClB,CAAC,KAAK,EAAE,MAAM,CAAC;IACf,CAAC,OAAO,EAAE,MAAM,CAAC;IACjB,CAAC,OAAO,EAAE,MAAM,CAAC;IACjB,CAAC,MAAM,EAAE,KAAK,CAAC;IACf,CAAC,MAAM,EAAE,KAAK,CAAC;IACf,CAAC,WAAW,EAAE,KAAK,CAAC;IACpB,CAAC,SAAS,EAAE,KAAK,CAAC;IAClB,CAAC,MAAM,EAAE,KAAK,CAAC;CAChB,CAAC,CAAC;AAEH,+DAA+D;AAC/D,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,IAAY,EAAsB,EAAE,CACpE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;AAQzC;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,IAAa;IAC3C,MAAM,KAAK,GAAoB,EAAE,CAAC;IAClC,MAAM,KAAK,GAAG,CAAC,SAAkB,EAAQ,EAAE;QACzC,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC;YAAE,OAAO;QACrC,MAAM,IAAI,GAAG,SAAyB,CAAC;QACvC,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,MAAM,SAAS,GAAG,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC/C,IAAI,SAAS;gBAAE,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;QAC5D,CAAC;QACD,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC;YACxC,CAAC,CAAC,IAAI,CAAC,SAAS;YAChB,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;gBACxB,CAAC,CAAC,IAAI,CAAC,IAAI;gBACX,CAAC,CAAC,EAAE,CAAC;QACT,KAAK,MAAM,GAAG,IAAI,IAAI;YAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IACrC,CAAC,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,CAAC;IACZ,OAAO,KAAK,CAAC;AACf,CAAC"}