@octonodes/sdk 0.0.3 → 0.1.0

package/dist/plugins/schema/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/plugins/schema/plugin.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB;;;;GAIG;AACH,eAAO,MAAM,WAAW,+CAA6C,CAAC;AACtE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD,eAAO,MAAM,cAAc,sCAAoC,CAAC;AAChE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAC5D,eAAO,MAAM,0BAA0B,QAAa,CAAC;AAerD,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAed,CAAC;AACZ,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAExD;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,WAAW,CAAC;AAE3C;;;;;GAKG;AACH,eAAO,MAAM,UAAU;;IAErB,oEAAoE;;;;;;;;;;IAUpE,iFAAiF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAKjF,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAEpD;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;EAG3B,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEhE,mFAAmF;AACnF,eAAO,MAAM,iBAAiB;;;IAG5B,+EAA+E;;IAE/E,2DAA2D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQ3D,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAElE,uFAAuF;AACvF,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgBlB,CAAC;AACZ,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEhE,+EAA+E;AAC/E,eAAO,MAAM,cAAc;;IAGvB,iEAAiE;;;;;;;;;IASjE,2FAA2F;;IAE3F,gFAAgF;;;;;;;;;;;;;;QAhDlF,+EAA+E;;QAE/E,2DAA2D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAlC3D,oEAAoE;;;;;;;;;;QAUpE,iFAAiF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoG/E,CAAC;AACL,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAC5D,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC"}

package/dist/plugins/schema/plugin.js

@@ -0,0 +1,144 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PluginManifest = exports.PluginConnection = exports.PluginIntegration = exports.PluginPermission = exports.PluginNode = exports.PluginNodeUi = exports.PLUGIN_UI_BUNDLE_MAX_BYTES = exports.PluginUiTarget = exports.PluginScope = void 0;
+// Generated from packages/schema/src/plugin.ts. Do not edit; run the Octonode SDK sync.
+const zod_1 = require("zod");
+const ipc_envelope_1 = require("./ipc-envelope");
+const icons_1 = require("./icons");
+const constants_1 = require("./constants");
+/**
+ * A plugin's distribution scope — who may discover and install it. `user` is
+ * private to its publisher in the hosted marketplace; group/org/public widen
+ * visibility. Local folder installs do not publish and remain local.
+ */
+exports.PluginScope = zod_1.z.enum(["user", "group", "org", "public"]);
+exports.PluginUiTarget = zod_1.z.enum(["node.inspector.inputs"]);
+exports.PLUGIN_UI_BUNDLE_MAX_BYTES = 512 * 1024;
+const pluginUiEntry = zod_1.z
+    .string()
+    .min(1)
+    .max(1_024)
+    .refine((value) => !value.startsWith("/") &&
+    !value.includes("\\") &&
+    !value.split("/").includes("..") &&
+    /\.[cm]?[jt]sx?$/.test(value), "UI entries must be relative JavaScript/TypeScript module paths");
+exports.PluginNodeUi = zod_1.z
+    .object({
+    apiVersion: zod_1.z.literal("1"),
+    renderers: zod_1.z
+        .record(zod_1.z.string().regex(/^[a-z0-9][a-z0-9_-]*$/i, "renderer id must be alphanumeric/dash/underscore"), zod_1.z
+        .object({
+        label: zod_1.z.string().min(1).max(240),
+        targets: zod_1.z.record(exports.PluginUiTarget, pluginUiEntry),
+    })
+        .strict())
+        .refine((renderers) => Object.keys(renderers).length > 0, "UI needs at least one renderer"),
+})
+    .strict();
+/**
+ * One node contributed by a plugin. Unlike a project node (whose signature is
+ * discovered by `octonode scan`), a plugin node declares its contract directly
+ * in the manifest — the plugin author owns it. `command` is resolved relative
+ * to the plugin folder, so a plugin is a self-contained, relocatable bundle.
+ */
+exports.PluginNode = zod_1.z.object({
+    id: zod_1.z.string().regex(/^[a-z0-9][a-z0-9_-]*$/i, "node id must be alphanumeric/dash/underscore"),
+    /** The command the engine spawns, relative to the plugin folder. */
+    command: zod_1.z.string(),
+    language: zod_1.z.string().optional(),
+    label: zod_1.z.string().min(1).max(240).optional(),
+    symbol: zod_1.z.string().min(1).max(16).optional(),
+    description: zod_1.z.string().optional(),
+    icon: icons_1.IconName.optional(),
+    trigger: zod_1.z.boolean().optional(),
+    inputs: ipc_envelope_1.JsonSchema.optional(),
+    outputs: ipc_envelope_1.JsonSchema.optional(),
+    /** Names of environment variables / secrets this node expects to be injected. */
+    env: zod_1.z.array(zod_1.z.string()).optional(),
+    connections: zod_1.z.array(zod_1.z.string().min(1)).optional(),
+    defaults: zod_1.z.record(zod_1.z.unknown()).optional(),
+    ui: exports.PluginNodeUi.optional(),
+});
+/**
+ * A coarse capability the plugin needs at runtime. Shown on the install
+ * consent screen and enforced before a node is handed the resource.
+ */
+exports.PluginPermission = zod_1.z.object({
+    resource: zod_1.z.enum(["project_data", "secrets", "network"]),
+    access: zod_1.z.enum(["read", "write", "outbound"]),
+});
+/** Discovery/marketplace metadata (used by the Studio Marketplace in Phase 14). */
+exports.PluginIntegration = zod_1.z.object({
+    category: zod_1.z.string().optional(),
+    tags: zod_1.z.array(zod_1.z.string()).default([]),
+    /** Secrets/env the integration needs to authenticate (e.g. ["JIRA_TOKEN"]). */
+    auth: zod_1.z.array(zod_1.z.string()).optional(),
+    /** Original npm dependency used by generated npm nodes. */
+    npm: zod_1.z
+        .object({
+        package: zod_1.z.string(),
+        version: zod_1.z.string(),
+        spec: zod_1.z.string(),
+    })
+        .optional(),
+});
+/** Credential metadata only. Values are supplied by the installing user at runtime. */
+exports.PluginConnection = zod_1.z
+    .object({
+    label: zod_1.z.string().min(1).max(240),
+    description: zod_1.z.string().max(4_000).optional(),
+    fields: zod_1.z.record(zod_1.z.string().regex(/^[A-Z_][A-Z0-9_]*$/, "credential fields must be environment variable names"), zod_1.z
+        .object({
+        label: zod_1.z.string().min(1).max(240),
+        description: zod_1.z.string().max(4_000).optional(),
+        secret: zod_1.z.boolean().default(true),
+        required: zod_1.z.boolean().default(true),
+    })
+        .strict()),
+})
+    .strict();
+/** The shared plugin contract used by the SDK, generators, and marketplace. */
+exports.PluginManifest = zod_1.z
+    .object({
+    schemaVersion: zod_1.z.string().default(constants_1.PLUGIN_SCHEMA_VERSION),
+    /** Stable plugin id; namespaces its nodes as `<id>/<nodeId>`. */
+    id: zod_1.z.string().regex(/^[a-z0-9][a-z0-9-]*$/, "plugin id must be lowercase alphanumeric/dash"),
+    name: zod_1.z.string(),
+    version: zod_1.z.string(),
+    description: zod_1.z.string().optional(),
+    icon: icons_1.IconName.optional(),
+    author: zod_1.z.string().optional(),
+    homepage: zod_1.z.string().optional(),
+    license: zod_1.z.string().optional(),
+    /** Distribution tiers this plugin may be discovered/installed from. Private by default. */
+    scope: zod_1.z.array(exports.PluginScope).default(["user"]),
+    /** Coarse runtime capabilities the plugin requests; consented to at install. */
+    permissions: zod_1.z.array(exports.PluginPermission).default([]),
+    integration: exports.PluginIntegration.optional(),
+    connections: zod_1.z.record(zod_1.z.string().regex(/^[a-z0-9][a-z0-9-]*$/), exports.PluginConnection).optional(),
+    nodes: zod_1.z.array(exports.PluginNode).default([]),
+})
+    .superRefine((manifest, ctx) => {
+    const ids = new Set();
+    manifest.nodes.forEach((node, index) => {
+        if (ids.has(node.id))
+            ctx.addIssue({ code: "custom", path: ["nodes", index, "id"], message: "node IDs must be unique" });
+        ids.add(node.id);
+        for (const connection of node.connections ?? []) {
+            if (!Object.hasOwn(manifest.connections ?? {}, connection))
+                ctx.addIssue({
+                    code: "custom",
+                    path: ["nodes", index, "connections"],
+                    message: `unknown connection "${connection}"`,
+                });
+        }
+    });
+    if (Object.keys(manifest.connections ?? {}).length &&
+        !manifest.permissions.some((permission) => permission.resource === "secrets" && permission.access === "read"))
+        ctx.addIssue({
+            code: "custom",
+            path: ["permissions"],
+            message: "credential connections require secrets:read permission",
+        });
+});
+//# sourceMappingURL=plugin.js.map

package/dist/plugins/schema/plugin.js.map

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

package/dist/plugins/sdk/define-node.d.ts

@@ -0,0 +1,103 @@
+import type { InvocationContext } from "../schema/plugin-sdk";
+import type { JsonSchema } from "./json-schema";
+/**
+ * What a node IS. `function` (default) is a data-flow node with inputs/outputs.
+ * `class`/`service`/`const` are setup-time entities with no runtime I/O ports —
+ * they're depended on by function nodes rather than feeding data into them.
+ */
+export type NodeKind = "function" | "class" | "service" | "const";
+/**
+ * The signature a node author writes: a plain (optionally async) function from
+ * a JSON `inputs` payload to a JSON `outputs` payload. The second argument is
+ * the invocation context (config, env, attempt, …). Nodes never touch stdin,
+ * stdout, or the envelope — the runner harness owns the wire.
+ */
+export type NodeHandler<I = any, O = any> = (inputs: I, context: InvocationContext) => O | Promise<O>;
+export interface NodeDefinition<I = any, O = any> {
+    /** Stable node id — the discovery key used by `octonode scan`. */
+    id: string;
+    workflowId?: string;
+    label?: string;
+    description?: string;
+    symbol?: string;
+    defaults?: Record<string, unknown>;
+    run: NodeHandler<I, O>;
+    /** JSON Schema for the inputs payload. Validated by the runner before `run`. */
+    inputs?: JsonSchema;
+    /** JSON Schema for the outputs payload. Validated by the runner after `run`. */
+    outputs?: JsonSchema;
+    /** What this node is. Omitted → `function`. */
+    kind?: NodeKind;
+    /** Setup params (constructor/config shape) for non-`function` kinds. */
+    setup?: JsonSchema;
+    /** Advisory default icon (a one-time seed; `.octonode` owns it thereafter). */
+    icon?: any;
+    /** Advisory default config (a one-time seed; `.octonode` owns it thereafter). */
+    config?: Record<string, unknown>;
+}
+export interface DefineNodeArgs<I, O> {
+    id?: string;
+    workflowId?: string;
+    label?: string;
+    description?: string;
+    symbol?: string;
+    defaults?: Record<string, unknown>;
+    run: NodeHandler<I, O>;
+    inputs?: JsonSchema;
+    outputs?: JsonSchema;
+    kind?: NodeKind;
+    setup?: JsonSchema;
+    icon?: any;
+    config?: Record<string, unknown>;
+}
+/**
+ * Declare a node: package its handler, id, and the JSON Schema for its I/O. The
+ * schemas are both enforced at runtime (the runner validates) and reported via
+ * `describe` so the engine can populate `.octonode` and type-check edges.
+ */
+export declare function defineNode<I = any, O = any>(args: DefineNodeArgs<I, O>): NodeDefinition<I, O>;
+/** Args for the setup-time helpers. These entities have setup params, not I/O ports. */
+export interface DefineSetupArgs<I = any, O = any> {
+    id: string;
+    /** JSON Schema for the setup/constructor params — rendered as a form in the editor. */
+    setup?: JsonSchema;
+    /**
+     * How the entity materializes at runtime (instantiate a client, read config…).
+     * Optional: setup-time entities aren't part of the data DAG, so a missing run
+     * defaults to a no-op that echoes the resolved setup config.
+     */
+    run?: NodeHandler<I, O>;
+    icon?: any;
+    config?: Record<string, unknown>;
+}
+export interface ServiceMethodSpec {
+    /** Object input keys mapped to positional class-method arguments. */
+    params?: string[];
+    inputs?: JsonSchema;
+    outputs?: JsonSchema;
+}
+export interface DefineExplicitServiceArgs<T extends object> {
+    id: string;
+    create: (context: InvocationContext) => T | Promise<T>;
+    expose: readonly (keyof T & string)[] | Record<string, ServiceMethodSpec>;
+    lifecycle?: "invocation" | "workflow-run" | "worker";
+    icon?: any;
+    setup?: JsonSchema;
+    config?: Record<string, unknown>;
+}
+export interface ServiceDefinition<T extends object = object> extends NodeDefinition {
+    kind: "service";
+    service: {
+        create: (context: InvocationContext) => T | Promise<T>;
+        lifecycle: "invocation" | "workflow-run" | "worker";
+        methods: Record<string, ServiceMethodSpec>;
+    };
+}
+/** Declare a service. Only the explicit create/expose form turns class methods into callable nodes. */
+export declare function defineService<T extends object>(args: DefineExplicitServiceArgs<T>): ServiceDefinition<T>;
+export declare function defineService<I = any, O = any>(args: DefineSetupArgs<I, O>): NodeDefinition<I, O>;
+/** Declare a class: a class definition (constructor/config params, methods). */
+export declare function defineClass<I = any, O = any>(args: DefineSetupArgs<I, O>): NodeDefinition<I, O>;
+/** Declare a const: a configuration constant referenced by other nodes. */
+export declare function defineConst<I = any, O = any>(args: DefineSetupArgs<I, O>): NodeDefinition<I, O>;
+//# sourceMappingURL=define-node.d.ts.map

package/dist/plugins/sdk/define-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-node.d.ts","sourceRoot":"","sources":["../../../src/plugins/sdk/define-node.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG,UAAU,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC;AAElE;;;;;GAKG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,iBAAiB,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAEtG,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG;IAC9C,kEAAkE;IAClE,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,GAAG,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACvB,gFAAgF;IAChF,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,gFAAgF;IAChF,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,+CAA+C;IAC/C,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,wEAAwE;IACxE,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,+EAA+E;IAC/E,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,iFAAiF;IACjF,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,cAAc,CAAC,CAAC,EAAE,CAAC;IAClC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,GAAG,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACvB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,CAgB7F;AAED,wFAAwF;AACxF,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG;IAC/C,EAAE,EAAE,MAAM,CAAC;IACX,uFAAuF;IACvF,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB;;;;OAIG;IACH,GAAG,CAAC,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACxB,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,iBAAiB;IAChC,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,OAAO,CAAC,EAAE,UAAU,CAAC;CACtB;AAED,MAAM,WAAW,yBAAyB,CAAC,CAAC,SAAS,MAAM;IACzD,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACvD,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAC1E,SAAS,CAAC,EAAE,YAAY,GAAG,cAAc,GAAG,QAAQ,CAAC;IACrD,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAE,SAAQ,cAAc;IAClF,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE;QACP,MAAM,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACvD,SAAS,EAAE,YAAY,GAAG,cAAc,GAAG,QAAQ,CAAC;QACpD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;KAC5C,CAAC;CACH;AAID,uGAAuG;AACvG,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,yBAAyB,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAC;AAC1G,wBAAgB,aAAa,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAwBnG,gFAAgF;AAChF,wBAAgB,WAAW,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,CAE/F;AAED,2EAA2E;AAC3E,wBAAgB,WAAW,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,CAE/F"}

package/dist/plugins/sdk/define-node.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineNode = defineNode;
+exports.defineService = defineService;
+exports.defineClass = defineClass;
+exports.defineConst = defineConst;
+/**
+ * Declare a node: package its handler, id, and the JSON Schema for its I/O. The
+ * schemas are both enforced at runtime (the runner validates) and reported via
+ * `describe` so the engine can populate `.octonode` and type-check edges.
+ */
+function defineNode(args) {
+    return {
+        id: args.id ?? "node",
+        ...(args.workflowId ? { workflowId: args.workflowId } : {}),
+        run: args.run,
+        label: args.label,
+        description: args.description,
+        symbol: args.symbol,
+        defaults: args.defaults,
+        inputs: args.inputs,
+        outputs: args.outputs,
+        kind: args.kind,
+        setup: args.setup,
+        icon: args.icon,
+        config: args.config,
+    };
+}
+const setupPassthrough = (_inputs, context) => (context?.config ?? {});
+function defineService(args) {
+    if ("create" in args && "expose" in args) {
+        const methods = Array.isArray(args.expose)
+            ? Object.fromEntries(args.expose.map((name) => [String(name), {}]))
+            : args.expose;
+        return {
+            ...defineNode({
+                id: args.id,
+                run: setupPassthrough,
+                kind: "service",
+                setup: args.setup,
+                icon: args.icon,
+                config: args.config,
+            }),
+            kind: "service",
+            service: { create: args.create, lifecycle: args.lifecycle ?? "invocation", methods },
+        };
+    }
+    return defineNode({ ...args, run: args.run ?? setupPassthrough, kind: "service" });
+}
+/** Declare a class: a class definition (constructor/config params, methods). */
+function defineClass(args) {
+    return defineNode({ ...args, run: args.run ?? setupPassthrough, kind: "class" });
+}
+/** Declare a const: a configuration constant referenced by other nodes. */
+function defineConst(args) {
+    return defineNode({ ...args, run: args.run ?? setupPassthrough, kind: "const" });
+}
+//# sourceMappingURL=define-node.js.map

package/dist/plugins/sdk/define-node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-node.js","sourceRoot":"","sources":["../../../src/plugins/sdk/define-node.ts"],"names":[],"mappings":";;AA+DA,gCAgBC;AAgDD,sCAqBC;AAGD,kCAEC;AAGD,kCAEC;AApGD;;;;GAIG;AACH,SAAgB,UAAU,CAAmB,IAA0B;IACrE,OAAO;QACL,EAAE,EAAE,IAAI,CAAC,EAAE,IAAI,MAAM;QACrB,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,MAAM,EAAE,IAAI,CAAC,MAAM;KACpB,CAAC;AACJ,CAAC;AA2CD,MAAM,gBAAgB,GAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,MAAM,IAAI,EAAE,CAAQ,CAAC;AAK3F,SAAgB,aAAa,CAC3B,IAA0D;IAE1D,IAAI,QAAQ,IAAI,IAAI,IAAI,QAAQ,IAAI,IAAI,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC;YACxC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;YACnE,CAAC,CAAE,IAAI,CAAC,MAA4C,CAAC;QACvD,OAAO;YACL,GAAG,UAAU,CAAC;gBACZ,EAAE,EAAE,IAAI,CAAC,EAAE;gBACX,GAAG,EAAE,gBAAgB;gBACrB,IAAI,EAAE,SAAS;gBACf,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,MAAM,EAAE,IAAI,CAAC,MAAM;aACpB,CAAC;YACF,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,YAAY,EAAE,OAAO,EAAE;SAC7D,CAAC;IAC5B,CAAC;IACD,OAAO,UAAU,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,gBAAgB,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;AACrF,CAAC;AAED,gFAAgF;AAChF,SAAgB,WAAW,CAAmB,IAA2B;IACvE,OAAO,UAAU,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,gBAAgB,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;AACnF,CAAC;AAED,2EAA2E;AAC3E,SAAgB,WAAW,CAAmB,IAA2B;IACvE,OAAO,UAAU,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,gBAAgB,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;AACnF,CAAC"}

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/plugin.d.ts

@@ -0,0 +1,7 @@
+import type { PluginDefinition, PluginHandlers, PluginOptions } from "./plugin.types";
+/** One definition owns discovery, presentation, ports, and the SDK runtime contract. */
+export declare function definePlugin(definition: PluginOptions): PluginDefinition;
+export declare function definePlugin(definition: unknown, handlers: PluginHandlers): PluginDefinition;
+/** The manifest command selects a node: `node dist/index.js <node-id>`. */
+export declare function startPlugin(plugin: PluginDefinition, nodeId?: string): void;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugins/sdk/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/plugins/sdk/plugin.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEtF,wFAAwF;AACxF,wBAAgB,YAAY,CAAC,UAAU,EAAE,aAAa,GAAG,gBAAgB,CAAC;AAC1E,wBAAgB,YAAY,CAAC,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,cAAc,GAAG,gBAAgB,CAAC;AA2D9F,2EAA2E;AAC3E,wBAAgB,WAAW,CAAC,MAAM,EAAE,gBAAgB,EAAE,MAAM,SAAkB,GAAG,IAAI,CAKpF"}

package/dist/plugins/sdk/plugin.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.definePlugin = definePlugin;
+exports.startPlugin = startPlugin;
+// Generated from sdks/typescript/src/plugin.ts. Do not edit; run the Octonode SDK sync.
+const plugin_sdk_1 = require("../schema/plugin-sdk");
+const define_node_1 = require("./define-node");
+const runner_1 = require("./runner");
+function definePlugin(definition, handlers) {
+    const options = definition;
+    if (!handlers && (!options || !Array.isArray(options.nodes)))
+        throw new Error("plugin needs a nodes array");
+    if (!handlers) {
+        for (const node of options.nodes) {
+            if (typeof node.run !== "function")
+                throw new Error(`plugin node "${node.id}" needs a handler`);
+            if (node.kind && node.kind !== "function")
+                throw new Error("plugin nodes must be functions");
+        }
+    }
+    const manifest = plugin_sdk_1.PluginManifest.parse(handlers
+        ? definition
+        : {
+            ...options,
+            nodes: options.nodes.map(({ run: _run, ...node }) => ({
+                ...node,
+                command: `node dist/index.js ${node.id}`,
+                language: "typescript",
+            })),
+        });
+    const nodeHandlers = handlers ?? Object.fromEntries(options.nodes.map((node) => [node.id, node.run]));
+    for (const node of manifest.nodes) {
+        for (const field of ["inputs", "outputs", "defaults"]) {
+            const error = node[field] === undefined ? undefined : (0, runner_1.jsonSafetyError)(node[field]);
+            if (error)
+                throw new Error(`plugin node "${node.id}" ${field} must be JSON-serializable: ${error}`);
+        }
+    }
+    for (const id of Object.keys(nodeHandlers)) {
+        if (!manifest.nodes.some((node) => node.id === id))
+            throw new Error(`handler "${id}" has no plugin node`);
+    }
+    return {
+        manifest,
+        ...(!handlers && options.assets ? { assets: options.assets } : {}),
+        nodes: Object.fromEntries(manifest.nodes.map((node) => {
+            if (!Object.hasOwn(nodeHandlers, node.id))
+                throw new Error(`plugin node "${node.id}" needs a handler`);
+            const fields = (node.connections ?? []).flatMap((id) => Object.entries(manifest.connections?.[id]?.fields ?? {}));
+            return [
+                node.id,
+                (0, define_node_1.defineNode)({
+                    ...node,
+                    run: (inputs, context) => {
+                        const missing = fields
+                            .filter(([name, field]) => field.required && !process.env[name])
+                            .map(([name]) => name);
+                        if (missing.length)
+                            throw new runner_1.NodeError(`Missing connection credentials: ${missing.join(", ")}`);
+                        return nodeHandlers[node.id](inputs, context);
+                    },
+                }),
+            ];
+        })),
+    };
+}
+/** The manifest command selects a node: `node dist/index.js <node-id>`. */
+function startPlugin(plugin, nodeId = process.argv[2]) {
+    const id = nodeId ?? (plugin.manifest.nodes.length === 1 ? plugin.manifest.nodes[0].id : undefined);
+    if (!id || !Object.hasOwn(plugin.nodes, id))
+        throw new Error(`Choose a plugin node: ${Object.keys(plugin.nodes).join(", ")}`);
+    (0, runner_1.start)(plugin.nodes[id]);
+}
+//# sourceMappingURL=plugin.js.map

package/dist/plugins/sdk/plugin.js.map

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

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

@@ -0,0 +1,15 @@
+import type { PluginManifest } from "../schema/plugin-sdk";
+import type { NodeDefinition, NodeHandler } from "./define-node";
+import type { PluginManifestInput, PluginNode } from "../schema/plugin-sdk";
+export interface PluginDefinition {
+    manifest: PluginManifest;
+    nodes: Record<string, NodeDefinition>;
+    /** Project-relative assets copied into the built plugin. Never credential files. */
+    assets?: readonly string[];
+}
+export type PluginHandlers = Record<string, NodeHandler>;
+export type PluginOptions = Omit<PluginManifestInput, "nodes"> & {
+    nodes: readonly (NodeDefinition & Pick<PluginNode, "connections" | "env" | "trigger">)[];
+    assets?: readonly string[];
+};
+//# sourceMappingURL=plugin.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.types.d.ts","sourceRoot":"","sources":["../../../src/plugins/sdk/plugin.types.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAE5E,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,cAAc,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACtC,oFAAoF;IACpF,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5B;AAED,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAEzD,MAAM,MAAM,aAAa,GAAG,IAAI,CAAC,mBAAmB,EAAE,OAAO,CAAC,GAAG;IAC/D,KAAK,EAAE,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,UAAU,EAAE,aAAa,GAAG,KAAK,GAAG,SAAS,CAAC,CAAC,EAAE,CAAC;IACzF,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5B,CAAC"}

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

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

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

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

package/dist/plugins/sdk/plugins/define-node.d.ts

@@ -0,0 +1,29 @@
+import type { JsonSchema } from "../json-schema";
+import type { PluginNodeOptions } from "./types";
+/** Plugin authoring keeps the portable contract beside its typed handler. */
+export declare function defineNode<const I extends JsonSchema, const O extends JsonSchema>(args: PluginNodeOptions<I, O>): {
+    connections: string[] | undefined;
+    env: string[] | undefined;
+    trigger: boolean | undefined;
+    ui: {
+        apiVersion: "1";
+        renderers: Record<string, {
+            label: string;
+            targets: Partial<Record<"node.inspector.inputs", string>>;
+        }>;
+    } | undefined;
+    id: string;
+    workflowId?: string;
+    label?: string;
+    description?: string;
+    symbol?: string;
+    defaults?: Record<string, unknown>;
+    run: import("../define-node").NodeHandler<import("./types").SchemaValue<I>, import("./types").SchemaValue<O>>;
+    inputs?: JsonSchema;
+    outputs?: JsonSchema;
+    kind?: import("../define-node").NodeKind;
+    setup?: JsonSchema;
+    icon?: any;
+    config?: Record<string, unknown>;
+};
+//# sourceMappingURL=define-node.d.ts.map

package/dist/plugins/sdk/plugins/define-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-node.d.ts","sourceRoot":"","sources":["../../../../src/plugins/sdk/plugins/define-node.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD,6EAA6E;AAC7E,wBAAgB,UAAU,CAAC,KAAK,CAAC,CAAC,SAAS,UAAU,EAAE,KAAK,CAAC,CAAC,SAAS,UAAU,EAAE,IAAI,EAAE,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC;;;;;;;;;;;;;;;;;;;;;;;;EAQ/G"}

package/dist/plugins/sdk/plugins/define-node.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineNode = defineNode;
+// Generated from sdks/typescript/src/plugins/define-node.ts. Do not edit; run the Octonode SDK sync.
+const define_node_1 = require("../define-node");
+/** Plugin authoring keeps the portable contract beside its typed handler. */
+function defineNode(args) {
+    return {
+        ...(0, define_node_1.defineNode)(args),
+        connections: args.connections,
+        env: args.env,
+        trigger: args.trigger,
+        ui: args.ui,
+    };
+}
+//# sourceMappingURL=define-node.js.map

package/dist/plugins/sdk/plugins/define-node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-node.js","sourceRoot":"","sources":["../../../../src/plugins/sdk/plugins/define-node.ts"],"names":[],"mappings":";;AAMA,gCAQC;AAdD,qGAAqG;AACrG,gDAAiE;AAIjE,6EAA6E;AAC7E,SAAgB,UAAU,CAAyD,IAA6B;IAC9G,OAAO;QACL,GAAG,IAAA,wBAAiB,EAAC,IAAI,CAAC;QAC1B,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,EAAE,EAAE,IAAI,CAAC,EAAE;KACZ,CAAC;AACJ,CAAC"}