@octonodes/sdk 0.0.3 → 0.1.5

package/dist/plugins/sdk/definitions/compiler/schemas.js

@@ -0,0 +1,95 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.schemaFor = schemaFor;
+// Generated from packages/plugin-runtime/src/definitions/compiler/schemas.ts. Do not edit; run the Octonode SDK sync.
+const ts = __importStar(require("typescript"));
+/** Public plugin contracts must be finite JSON values, never silently widened to unknown. */
+function schemaFor(checker, type, seen = new Set(), optional = false) {
+    const fail = () => {
+        throw new Error(`Cannot infer a JSON contract for ${checker.typeToString(type)}; use a concrete JSON-compatible function signature`);
+    };
+    if (seen.has(type))
+        return fail();
+    const next = new Set(seen).add(type);
+    if (type.isUnion()) {
+        const members = type.types.filter((item) => !optional || !(item.flags & ts.TypeFlags.Undefined));
+        if (members.length === 1)
+            return schemaFor(checker, members[0], seen);
+        if (members.every((item) => item.flags & ts.TypeFlags.BooleanLiteral))
+            return { type: "boolean" };
+        if (members.every((item) => item.isStringLiteral() || item.isNumberLiteral())) {
+            const values = members.map((item) => item.value);
+            if (values.every((value) => typeof value === typeof values[0]))
+                return { type: typeof values[0], enum: values };
+        }
+        return fail();
+    }
+    if (type.isStringLiteral() || type.isNumberLiteral())
+        return { type: typeof type.value, enum: [type.value] };
+    if (type.flags & ts.TypeFlags.String)
+        return { type: "string" };
+    if (type.flags & ts.TypeFlags.Number)
+        return { type: "number" };
+    if (type.flags & ts.TypeFlags.BooleanLike)
+        return { type: "boolean" };
+    if (type.flags & ts.TypeFlags.Null)
+        return { type: "null" };
+    if (checker.isArrayType(type))
+        return { type: "array", items: schemaFor(checker, checker.getTypeArguments(type)[0], next) };
+    if (!(type.flags & ts.TypeFlags.Object ||
+        (type.isIntersection() && type.types.every((member) => member.flags & ts.TypeFlags.Object))) ||
+        checker.isTupleType(type) ||
+        type.getCallSignatures().length ||
+        type.getConstructSignatures().length ||
+        checker.getIndexInfosOfType(type).length)
+        return fail();
+    if ((type.isIntersection() ? type.types : [type]).some((member) => member.getSymbol()?.declarations?.some((declaration) => ts.isClassDeclaration(declaration))))
+        return fail();
+    const properties = Object.create(null);
+    const required = [];
+    for (const property of type.getProperties()) {
+        const declaration = property.valueDeclaration ?? property.declarations?.[0];
+        if (!declaration)
+            return fail();
+        const value = checker.getTypeOfSymbolAtLocation(property, declaration);
+        const optional = !!(property.flags & ts.SymbolFlags.Optional);
+        properties[property.name] = schemaFor(checker, value, next, optional);
+        if (!optional)
+            required.push(property.name);
+    }
+    return { type: "object", properties, required };
+}
+//# sourceMappingURL=schemas.js.map

package/dist/plugins/sdk/definitions/compiler/schemas.js.map

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

package/dist/plugins/sdk/definitions/compiler/types.d.ts

@@ -0,0 +1,20 @@
+import type { PluginManifest } from "../../../schema/plugin-sdk";
+import type { NodeCustomization, NpmNodeHandle, WorkflowNodeHandle } from "../types";
+export interface CompiledNode {
+    path: string;
+    exportName: string;
+    symbol: string;
+    parameters: string[];
+    customization: NodeCustomization;
+    inputs?: Record<string, unknown>;
+    outputs?: Record<string, unknown>;
+    npm?: NpmNodeHandle;
+    workflow?: WorkflowNodeHandle;
+}
+export interface CompiledDefinition {
+    kind: "project" | "plugin";
+    nodes: CompiledNode[];
+    manifest?: PluginManifest;
+    assets: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/plugins/sdk/definitions/compiler/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/sdk/definitions/compiler/types.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAErF,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,aAAa,EAAE,iBAAiB,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,GAAG,CAAC,EAAE,aAAa,CAAC;IACpB,QAAQ,CAAC,EAAE,kBAAkB,CAAC;CAC/B;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC3B,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB"}

package/dist/plugins/sdk/definitions/compiler/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/plugins/sdk/definitions/compiler/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/plugins/sdk/definitions/compiler/types.ts"],"names":[],"mappings":""}

package/dist/plugins/sdk/definitions/index.d.ts

@@ -0,0 +1,7 @@
+import type { NodeCustomization, NodeReference, ProjectDefinition, PluginDefinition } from "./types";
+/** Compile-time declarations. Octonode reads these only in the reserved project and plugin files. */
+export declare function defineNode(implementation: NodeReference["implementation"], customization?: NodeCustomization): NodeReference;
+export declare function defineProject(definition?: ProjectDefinition): ProjectDefinition;
+export declare function definePlugin(definition: PluginDefinition): PluginDefinition;
+export type { NodeCustomization, NodeReference, ProjectDefinition, PluginDefinition } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/sdk/definitions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/plugins/sdk/definitions/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAErG,qGAAqG;AACrG,wBAAgB,UAAU,CACxB,cAAc,EAAE,aAAa,CAAC,gBAAgB,CAAC,EAC/C,aAAa,GAAE,iBAAsB,GACpC,aAAa,CAEf;AAED,wBAAgB,aAAa,CAAC,UAAU,GAAE,iBAAsB,GAAG,iBAAiB,CAEnF;AAED,wBAAgB,YAAY,CAAC,UAAU,EAAE,gBAAgB,GAAG,gBAAgB,CAE3E;AAED,YAAY,EAAE,iBAAiB,EAAE,aAAa,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC"}

package/dist/plugins/sdk/definitions/index.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineNode = defineNode;
+exports.defineProject = defineProject;
+exports.definePlugin = definePlugin;
+/** Compile-time declarations. Octonode reads these only in the reserved project and plugin files. */
+function defineNode(implementation, customization = {}) {
+    return { implementation, customization };
+}
+function defineProject(definition = {}) {
+    return definition;
+}
+function definePlugin(definition) {
+    return definition;
+}
+//# sourceMappingURL=index.js.map

package/dist/plugins/sdk/definitions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/plugins/sdk/definitions/index.ts"],"names":[],"mappings":";;AAIA,gCAKC;AAED,sCAEC;AAED,oCAEC;AAdD,qGAAqG;AACrG,SAAgB,UAAU,CACxB,cAA+C,EAC/C,gBAAmC,EAAE;IAErC,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,CAAC;AAC3C,CAAC;AAED,SAAgB,aAAa,CAAC,aAAgC,EAAE;IAC9D,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,SAAgB,YAAY,CAAC,UAA4B;IACvD,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/plugins/sdk/definitions/npm/emit/js.d.ts

@@ -0,0 +1,4 @@
+import type { CompiledNpmPlugin } from "../types";
+/** Render every generated file for the plugin (paths relative to the plugin folder). */
+export declare function emitNpmJsFiles(plan: CompiledNpmPlugin): Record<string, string>;
+//# sourceMappingURL=js.d.ts.map

package/dist/plugins/sdk/definitions/npm/emit/js.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"js.d.ts","sourceRoot":"","sources":["../../../../../../src/plugins/sdk/definitions/npm/emit/js.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAqB,MAAM,UAAU,CAAC;AA2LrE,wFAAwF;AACxF,wBAAgB,cAAc,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAK9E"}

package/dist/plugins/sdk/definitions/npm/emit/js.js

@@ -0,0 +1,190 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.emitNpmJsFiles = emitNpmJsFiles;
+/** Render the single IPC adapter used by every node extracted from a package. */
+function runner(plan) {
+    const descriptors = Object.fromEntries(plan.nodes.map((node) => [node.id, node]));
+    const cases = plan.nodes.map((node) => `    case ${JSON.stringify(node.id)}: {\n${nodeBody(node)}\n    }`).join("\n");
+    return `// Generated npm adapter: the original package remains the implementation.
+const { createRequire, register } = require("node:module");
+const { existsSync, realpathSync } = require("node:fs");
+const { dirname, join } = require("node:path");
+const { pathToFileURL } = require("node:url");
+const OCTONODE_PROJECT_ROOT = process["env"].OCTONODE_PROJECT_ROOT;
+class NodeError extends Error {
+  constructor(message, code = "NON_RETRYABLE", retryable = false) {
+    super(message);
+    this.name = "NodeError";
+    this.code = code;
+    this.retryable = retryable;
+  }
+}
+function send(envelope) {
+  process.stdout.write(JSON.stringify(envelope) + "\\n");
+}
+function resolveExport(pkg, name) {
+  if (name === "default") {
+    if (typeof pkg === "function") return pkg;
+    return pkg && pkg.default !== undefined ? pkg.default : pkg;
+  }
+  return pkg ? pkg[name] : undefined;
+}
+function toJson(value) {
+  if (value === undefined) return null;
+  try {
+    const json = JSON.stringify(value);
+    if (json === undefined) throw new Error();
+    return JSON.parse(json);
+  } catch {
+    throw new NodeError("npm export returned a value that is not JSON-serializable", "VALIDATION_ERROR");
+  }
+}
+const NODES = ${JSON.stringify(descriptors, null, 2)};
+const node = NODES[process.argv[2]];
+if (require.main === module && !node) throw new Error('unknown generated npm node "' + process.argv[2] + '"');
+const projectRoot = realpathSync(OCTONODE_PROJECT_ROOT || process.cwd());
+for (let root = projectRoot; ; root = dirname(root)) {
+  const pnp = join(root, ".pnp.cjs");
+  if (existsSync(pnp)) {
+    require(pnp).setup();
+    const loader = join(root, ".pnp.loader.mjs");
+    if (existsSync(loader)) register(pathToFileURL(loader));
+    break;
+  }
+  if (existsSync(join(root, ".git")) || dirname(root) === root) break;
+}
+const projectRequire = createRequire(join(projectRoot, "package.json"));
+const packages = new Map();
+async function loadPkg(specifier = ${JSON.stringify(plan.packageName)}) {
+  if (!packages.has(specifier)) packages.set(specifier, (async () => {
+    let entry;
+    try { entry = projectRequire.resolve(specifier); }
+    catch {
+      const { resolvePackage } = await import("./npm-resolve.mjs");
+      entry = resolvePackage(specifier, pathToFileURL(join(projectRoot, "package.json")).href);
+      return import(entry);
+    }
+    try { return projectRequire(entry); }
+    catch (error) {
+      if (error.code !== "ERR_REQUIRE_ESM" && error.code !== "ERR_REQUIRE_ASYNC_MODULE") throw error;
+      return import(pathToFileURL(entry).href);
+    }
+  })());
+  return packages.get(specifier);
+}
+async function bindClients(inputs, node) {
+  const bound = Object.create(null);
+  // Check every credential before loading factories; no partially initialized clients.
+  for (const [name, binding] of Object.entries(node.bindings || {})) {
+    if (Object.hasOwn(inputs, name)) throw new NodeError("SDK client parameters cannot be supplied as inputs", "VALIDATION_ERROR");
+    for (const variable of Object.values(binding.env || {})) {
+      if (!process.env[variable]) throw new NodeError("Missing SDK connection credentials", "VALIDATION_ERROR");
+    }
+  }
+  for (const [name, binding] of Object.entries(node.bindings || {})) {
+    const options = JSON.parse(JSON.stringify(binding.options || {}));
+    for (const [path, variable] of Object.entries(binding.env || {})) {
+      const keys = path.split(".");
+      if (keys.some((key) => ["__proto__", "prototype", "constructor"].includes(key)))
+        throw new NodeError("Unsafe SDK option path", "VALIDATION_ERROR");
+      let target = options;
+      for (const key of keys.slice(0, -1)) {
+        if (!Object.hasOwn(target, key)) target[key] = {};
+        if (!target[key] || typeof target[key] !== "object" || Array.isArray(target[key]))
+          throw new NodeError("SDK option path must point into an object", "VALIDATION_ERROR");
+        target = target[key];
+      }
+      target[keys[keys.length - 1]] = process.env[variable];
+    }
+    const module = await loadPkg(binding.module);
+    if (!Object.hasOwn(module, binding.export) || typeof module[binding.export] !== "function")
+      throw new NodeError("SDK client factory is not exported by the package", "VALIDATION_ERROR");
+    bound[name] = await module[binding.export](options);
+  }
+  return bound;
+}
+async function invoke(inputs, node = NODES[process.argv[2]]) {
+  if (!node) throw new NodeError("unknown npm node", "VALIDATION_ERROR");
+  try {
+  const bound = await bindClients(inputs, node);
+  const pkg = await loadPkg(node.moduleSpecifier || ${JSON.stringify(plan.packageName)});
+  switch (node.id) {
+${cases}
+    default: throw new NodeError('unknown generated npm node "' + node.id + '"', "VALIDATION_ERROR");
+  }
+  } catch (error) {
+    // SDK errors can embed authorization headers or response bodies. Never forward them over IPC.
+    if (Object.keys(node.bindings || {}).length && !(error instanceof NodeError))
+      throw new NodeError("SDK invocation failed; check the connection and request", "RUNTIME_ERROR");
+    throw error;
+  }
+}
+function start() {
+  let buf = "";
+  process.stdin.setEncoding("utf8");
+  process.stdin.on("data", (c) => (buf += c));
+  process.stdin.on("end", async () => {
+    let rid = "unknown";
+    try {
+      const req = JSON.parse(buf || "{}");
+      rid = req.invocationId || "unknown";
+      if (req.type === "describe") {
+        send({ octonode: "1", type: "manifest", invocationId: rid, status: "ok", manifest: {
+          id: node.id, language: "javascript", description: node.description,
+          inputs: node.inputsSchema, outputs: node.outputsSchema,
+        } });
+      } else if (req.type === "invoke") {
+        const outputs = await invoke(req.inputs || {}, node);
+        send({ octonode: "1", type: "result", invocationId: rid, status: "ok", outputs });
+      } else {
+        throw new NodeError(\`unsupported request type "\${req.type}"\`, "VALIDATION_ERROR");
+      }
+    } catch (err) {
+      send({
+        octonode: "1", type: "result", invocationId: rid, status: "error",
+        error: { code: err.code || "RUNTIME_ERROR", message: String(err && err.message), retryable: Boolean(err.retryable) },
+      });
+    }
+  });
+}
+module.exports.invokeNode = (id, inputs) => invoke(inputs, NODES[id]);
+if (require.main === module) start();
+`;
+}
+function nodeBody(node) {
+    if (node.generic) {
+        return `  if (typeof inputs.export !== "string" || !inputs.export) {
+    throw new NodeError("\`export\` is required", "VALIDATION_ERROR");
+  }
+  const target = resolveExport(pkg, inputs.export);
+  if (target === undefined) {
+    throw new NodeError(\`unknown export "\${inputs.export}"\`, "VALIDATION_ERROR");
+  }
+  if (typeof target !== "function") return { result: toJson(target), dryRun: false };
+  const args = Array.isArray(inputs.args) ? inputs.args : [];
+  return { result: toJson(await target(...args)), dryRun: false };`;
+    }
+    const positional = node.params.filter((p) => !p.rest).map((p) => p.name);
+    const rest = node.params.find((p) => p.rest);
+    const argsLines = node.permissive
+        ? `  const args = Array.isArray(inputs.args) ? inputs.args : [];`
+        : `  const args = ${JSON.stringify(positional)}.map((n) => Object.hasOwn(bound, n) ? bound[n] : inputs[n]);
+  while (args.length && args[args.length - 1] === undefined) args.pop();${rest
+            ? `
+  if (Array.isArray(inputs[${JSON.stringify(rest.name)}])) args.push(...inputs[${JSON.stringify(rest.name)}]);`
+            : ""}`;
+    return `  const fn = resolveExport(pkg, ${JSON.stringify(node.exportName)});
+  if (typeof fn !== "function") {
+    throw new NodeError('export ${node.exportName} is not a function', "VALIDATION_ERROR");
+  }
+${argsLines}
+  return { result: toJson(await fn(...args)), dryRun: false };`;
+}
+/** Render every generated file for the plugin (paths relative to the plugin folder). */
+function emitNpmJsFiles(plan) {
+    return {
+        "nodes/npm.cjs": runner(plan),
+        "nodes/npm-resolve.mjs": "export const resolvePackage = (name, parent) => import.meta.resolve(name, parent);\n",
+    };
+}
+//# sourceMappingURL=js.js.map

package/dist/plugins/sdk/definitions/npm/emit/js.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"js.js","sourceRoot":"","sources":["../../../../../../src/plugins/sdk/definitions/npm/emit/js.ts"],"names":[],"mappings":";;AA8LA,wCAKC;AA/LD,iFAAiF;AACjF,SAAS,MAAM,CAAC,IAAuB;IACrC,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IAClF,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,QAAQ,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtH,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gBAkCO,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;;;;;;;;;;;;;;;;qCAgBf,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sDAoDf,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC;;EAEpF,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwCN,CAAC;AACF,CAAC;AAED,SAAS,QAAQ,CAAC,IAAuB;IACvC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,OAAO;;;;;;;;;mEASwD,CAAC;IAClE,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACzE,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU;QAC/B,CAAC,CAAC,+DAA+D;QACjE,CAAC,CAAC,kBAAkB,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC;0EAE9C,IAAI;YACF,CAAC,CAAC;6BACqB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,2BAA2B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK;YACzG,CAAC,CAAC,EACN,EAAE,CAAC;IAEH,OAAO,mCAAmC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC;;kCAEzC,IAAI,CAAC,UAAU;;EAE/C,SAAS;+DACoD,CAAC;AAChE,CAAC;AAED,wFAAwF;AACxF,SAAgB,cAAc,CAAC,IAAuB;IACpD,OAAO;QACL,eAAe,EAAE,MAAM,CAAC,IAAI,CAAC;QAC7B,uBAAuB,EAAE,sFAAsF;KAChH,CAAC;AACJ,CAAC"}

package/dist/plugins/sdk/definitions/npm/types.d.ts

@@ -0,0 +1,63 @@
+import type { NpmClientBinding } from "../../../schema/plugin-sdk";
+export interface NpmPackageMeta {
+    /** Real npm package name (e.g. "@scope/pkg"). */
+    name: string;
+    /** Package entry point, including an optional exported subpath. */
+    moduleSpecifier?: string;
+    /** Resolved, pinned version. */
+    version: string;
+    description?: string;
+    /** Entry type-declaration file, or null when the package ships no types. */
+    dtsPath: string | null;
+    /** Fallback export names discovered at runtime when dtsPath is null. */
+    runtimeExports?: string[];
+    /** Exact package-manager spec; local fixtures retain their file: source. */
+    installSpec?: string;
+}
+export interface NpmParam {
+    name: string;
+    required: boolean;
+    rest: boolean;
+    schema: Record<string, unknown>;
+}
+export interface NpmNodeDescriptor {
+    id: string;
+    moduleSpecifier?: string;
+    bindings?: Record<string, NpmClientBinding>;
+    /** Export name on the package; "default" for the default export; "" for the generic call node. */
+    exportName: string;
+    /** Declared parameter order — the emitted node maps named inputs to positional args in this order. */
+    params: NpmParam[];
+    inputsSchema: Record<string, unknown>;
+    outputsSchema: Record<string, unknown>;
+    description?: string;
+    /** True for the generic `call` escape-hatch node. */
+    generic?: boolean;
+    /** True when params are unknown (untyped fallback): inputs are `{ args: any[] }`. */
+    permissive?: boolean;
+}
+export interface CompiledNpmPlugin {
+    /** A valid octonode.plugin.json object. */
+    manifest: Record<string, unknown>;
+    packageName: string;
+    moduleSpecifier?: string;
+    packageVersion: string;
+    nodes: NpmNodeDescriptor[];
+    warnings: string[];
+}
+export interface NpmGenerateOptions {
+    cacheRoot?: string;
+    /** Package spec: `name`, `name@version`, or a local folder path (tests/offline). */
+    pkg: string;
+    moduleSpecifier?: string;
+    id?: string;
+    name?: string;
+    icon?: string;
+    description?: string;
+    version?: string;
+    include?: string[];
+    exclude?: string[];
+    dir?: string;
+    force?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/plugins/sdk/definitions/npm/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/sdk/definitions/npm/types.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,MAAM,WAAW,cAAc;IAC7B,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4EAA4E;IAC5E,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,wEAAwE;IACxE,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC5C,kGAAkG;IAClG,UAAU,EAAE,MAAM,CAAC;IACnB,sGAAsG;IACtG,MAAM,EAAE,QAAQ,EAAE,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qDAAqD;IACrD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,qFAAqF;IACrF,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oFAAoF;IACpF,GAAG,EAAE,MAAM,CAAC;IACZ,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB"}

package/dist/plugins/sdk/definitions/npm/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/plugins/sdk/definitions/npm/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/plugins/sdk/definitions/npm/types.ts"],"names":[],"mappings":""}

package/dist/plugins/sdk/definitions/types.d.ts

@@ -0,0 +1,43 @@
+import type { PluginManifestInput, PluginNode } from "../../schema/plugin-sdk";
+export type NodeCustomization = Partial<Pick<PluginNode, "id" | "label" | "symbol" | "icon" | "description" | "defaults" | "connections" | "env" | "trigger" | "ui" | "bindings">>;
+export interface NodeReference {
+    readonly implementation: ((...args: never[]) => unknown) | NpmNodeHandle | WorkflowNodeHandle;
+    readonly customization: NodeCustomization;
+}
+export interface NpmNodeHandle {
+    readonly kind: "npm";
+    readonly packageName: string;
+    readonly packageVersion: string;
+    readonly installSpec?: string;
+    readonly descriptor: {
+        id: string;
+        exportName: string;
+        moduleSpecifier?: string;
+        params: {
+            name: string;
+            required: boolean;
+            rest: boolean;
+            schema: Record<string, unknown>;
+        }[];
+        inputsSchema: Record<string, unknown>;
+        outputsSchema: Record<string, unknown>;
+        description?: string;
+        generic?: boolean;
+        permissive?: boolean;
+    };
+}
+export interface WorkflowNodeHandle {
+    readonly kind: "workflow";
+    readonly definition: PluginNode;
+    readonly key: string;
+    readonly files: Record<string, string>;
+    readonly dependencies: Record<string, string>;
+}
+export interface ProjectDefinition {
+    readonly nodes?: readonly NodeReference[];
+}
+export type PluginDefinition = Omit<PluginManifestInput, "nodes"> & {
+    readonly nodes: readonly NodeReference[];
+    readonly assets?: readonly string[];
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/plugins/sdk/definitions/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/plugins/sdk/definitions/types.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAE/E,MAAM,MAAM,iBAAiB,GAAG,OAAO,CACrC,IAAI,CACF,UAAU,EACR,IAAI,GACJ,OAAO,GACP,QAAQ,GACR,MAAM,GACN,aAAa,GACb,UAAU,GACV,aAAa,GACb,KAAK,GACL,SAAS,GACT,IAAI,GACJ,UAAU,CACb,CACF,CAAC;AAEF,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,cAAc,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,CAAC,GAAG,aAAa,GAAG,kBAAkB,CAAC;IAC9F,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;CAC3C;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE;QACnB,EAAE,EAAE,MAAM,CAAC;QACX,UAAU,EAAE,MAAM,CAAC;QACnB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,MAAM,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,OAAO,CAAC;YAAC,IAAI,EAAE,OAAO,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;SAAE,EAAE,CAAC;QAC9F,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACtC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACvC,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,UAAU,CAAC,EAAE,OAAO,CAAC;KACtB,CAAC;CACH;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/C;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;CAC3C;AAED,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,mBAAmB,EAAE,OAAO,CAAC,GAAG;IAClE,QAAQ,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IACzC,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC,CAAC"}

package/dist/plugins/sdk/definitions/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/plugins/sdk/definitions/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/plugins/sdk/definitions/types.ts"],"names":[],"mappings":""}

package/dist/plugins/sdk/json-schema.d.ts

@@ -0,0 +1,17 @@
+/**
+ * A deliberately tiny JSON Schema validator covering the common subset Octonode
+ * nodes use to describe their I/O: `type`, `required`, `properties`, `items`,
+ * and `enum`. It is intentionally NOT a full JSON Schema implementation — the
+ * point is that every language SDK can carry an equivalent ~80-line validator
+ * with zero dependencies, so the contract is enforced identically everywhere.
+ *
+ * Unknown/unsupported keywords are ignored (treated as "no constraint"), so a
+ * richer schema still validates its supported parts rather than failing hard.
+ */
+export type JsonSchema = Record<string, unknown>;
+export interface ValidationError {
+    path: string;
+    message: string;
+}
+export declare function validate(schema: JsonSchema | undefined, data: unknown): ValidationError[];
+//# sourceMappingURL=json-schema.d.ts.map

package/dist/plugins/sdk/json-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema.d.ts","sourceRoot":"","sources":["../../../src/plugins/sdk/json-schema.ts"],"names":[],"mappings":"AACA;;;;;;;;;GASG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEjD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,EAAE,IAAI,EAAE,OAAO,GAAG,eAAe,EAAE,CAKzF"}

package/dist/plugins/sdk/json-schema.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validate = validate;
+function validate(schema, data) {
+    if (!schema)
+        return [];
+    const errors = [];
+    walk(schema, data, "$", errors);
+    return errors;
+}
+function walk(schema, data, path, errors) {
+    const allowed = normalizeTypes(schema.type);
+    if (allowed.length > 0 && !allowed.some((t) => matchesType(t, data))) {
+        errors.push({ path, message: `expected type ${allowed.join("|")}, got ${jsonType(data)}` });
+        return; // type is wrong; nested checks would be noise
+    }
+    if (Array.isArray(schema.enum) && !schema.enum.some((v) => deepEqual(v, data))) {
+        errors.push({ path, message: `value is not one of the allowed enum values` });
+    }
+    if (isPlainObject(data)) {
+        const required = Array.isArray(schema.required) ? schema.required : [];
+        for (const key of required) {
+            if (!(key in data))
+                errors.push({ path: `${path}.${key}`, message: `missing required property` });
+        }
+        const props = isPlainObject(schema.properties) ? schema.properties : undefined;
+        if (props) {
+            for (const [key, sub] of Object.entries(props)) {
+                if (key in data && isPlainObject(sub)) {
+                    walk(sub, data[key], `${path}.${key}`, errors);
+                }
+            }
+        }
+    }
+    if (Array.isArray(data) && isPlainObject(schema.items)) {
+        data.forEach((item, i) => walk(schema.items, item, `${path}[${i}]`, errors));
+    }
+}
+function normalizeTypes(type) {
+    if (typeof type === "string")
+        return [type];
+    if (Array.isArray(type))
+        return type.filter((t) => typeof t === "string");
+    return [];
+}
+function matchesType(type, data) {
+    switch (type) {
+        case "object":
+            return isPlainObject(data);
+        case "array":
+            return Array.isArray(data);
+        case "string":
+            return typeof data === "string";
+        case "number":
+            return typeof data === "number" && Number.isFinite(data);
+        case "integer":
+            return typeof data === "number" && Number.isInteger(data);
+        case "boolean":
+            return typeof data === "boolean";
+        case "null":
+            return data === null;
+        default:
+            return true; // unknown declared type → don't constrain
+    }
+}
+function jsonType(data) {
+    if (data === null)
+        return "null";
+    if (Array.isArray(data))
+        return "array";
+    return typeof data;
+}
+function isPlainObject(v) {
+    return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+function deepEqual(a, b) {
+    return JSON.stringify(a) === JSON.stringify(b);
+}
+//# sourceMappingURL=json-schema.js.map

package/dist/plugins/sdk/json-schema.js.map

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

package/dist/plugins/sdk/nodes/index.d.ts

@@ -0,0 +1,5 @@
+import type { NpmNodeHandle, WorkflowNodeHandle } from "../definitions/types";
+/** Generated inventory declaration; the compiler reads its literal argument. */
+export declare function npmNode(handle: Omit<NpmNodeHandle, "kind">): NpmNodeHandle;
+export declare function workflowNode(handle: Omit<WorkflowNodeHandle, "kind">): WorkflowNodeHandle;
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/sdk/nodes/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/plugins/sdk/nodes/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE9E,gFAAgF;AAChF,wBAAgB,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,GAAG,aAAa,CAE1E;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,kBAAkB,EAAE,MAAM,CAAC,GAAG,kBAAkB,CAEzF"}