@invect/core 0.0.1

package/dist/types/node-execution.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-execution.types.d.ts","names":[],"sources":["../../src/types/node-execution.types.ts"],"mappings":";;;;;;;UAYiB,yBAAA;EACf,KAAA,EAAO,mBAAA,CAAoB,MAAA;EAC3B,MAAA;EACA,QAAA,GAAW,MAAA;AAAA;;AAMb;;UAAiB,0BAAA;EACf,KAAA,EAAO,mBAAA,CAAoB,OAAA;EAC3B,IAAA;EACA,UAAA;EACA,MAAA;EACA,WAAA;EACA,QAAA,GAAW,MAAA;AAAA;;;;UAMI,0BAAA;EACf,IAAA;EACA,MAAA,EAAQ,UAAA;EACR,KAAA,EAAO,mBAAA,CAAoB,OAAA;EAC3B,QAAA,GAAW,MAAA;AAAA;;;;KAMD,mBAAA,GACR,yBAAA,GACA,0BAAA,GACA,0BAAA"}

package/dist/types/node-io-types.cjs

@@ -0,0 +1,19 @@
+require("../_virtual/_rolldown/runtime.cjs");
+let zod_v4 = require("zod/v4");
+//#region src/types/node-io-types.ts
+/**
+* Node I/O Types
+*
+* Generic types for node inputs and outputs.
+* These are NOT parameterised by node type — every node (whether a legacy
+* executor or a provider-action) uses the same shapes. This keeps the type
+* system scalable as hundreds of new actions are added.
+*
+* IMPORTANT: This file must NOT import from src/nodes/* to avoid pulling
+* Node.js runtime code into the frontend bundle via @invect/core/types.
+*/
+const NodeInputMappingSchema = zod_v4.z.record(zod_v4.z.string(), zod_v4.z.string());
+//#endregion
+exports.NodeInputMappingSchema = NodeInputMappingSchema;
+
+//# sourceMappingURL=node-io-types.cjs.map

package/dist/types/node-io-types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-io-types.cjs","names":["z"],"sources":["../../src/types/node-io-types.ts"],"sourcesContent":["/**\n * Node I/O Types\n *\n * Generic types for node inputs and outputs.\n * These are NOT parameterised by node type — every node (whether a legacy\n * executor or a provider-action) uses the same shapes. This keeps the type\n * system scalable as hundreds of new actions are added.\n *\n * IMPORTANT: This file must NOT import from src/nodes/* to avoid pulling\n * Node.js runtime code into the frontend bundle via @invect/core/types.\n */\n\nimport { z } from 'zod/v4';\n\n// =============================================================================\n// COMMON NODE INPUT MAPPING TYPES\n// =============================================================================\n\nexport const NodeInputMappingSchema = z.record(z.string(), z.string());\n\nexport type InputMappingConfig = Record<string, string>;\n\n/**\n * Node incoming data is a simple object keyed by upstream node slug.\n * Values are the direct output values from upstream nodes (JSON-parsed if valid).\n *\n * Example: { \"fetch_user\": { \"id\": 123, \"name\": \"Alice\" }, \"get_config\": \"production\" }\n */\nexport type NodeIncomingDataObject = Record<string, unknown>;\n\n/**\n * Generic input data passed to a node executor's `execute()` method.\n * Always a flat key→value record (slug-keyed incoming data from upstream nodes).\n */\nexport type NodeInputData = Record<string, unknown>;\n\n// =============================================================================\n// OUTPUT TYPES\n// =============================================================================\n\n/**\n * A single output variable produced by a node.\n *\n * The `type` discriminator categorises the runtime `value`:\n *   - `'string'`  → value is a `string`, or a primitive (`number | boolean | null | undefined`)\n *   - `'object'`  → value is a non-null `object` (plain object or array)\n *\n * In practice every action returns one of:\n *   • a plain string (JQ, model, template_string, output)\n *   • a JSON-serializable object (http.request, gmail.*, trigger.*, sql_query)\n *   • `undefined` (batch-pending sentinel — only `core.model`)\n *\n * No action returns raw numbers, booleans, `null`, Buffers, Dates, or class instances.\n */\nexport type OutputVariable = {\n  value: unknown;\n  type: 'string' | 'object';\n};\n\n/**\n * Record of named output variables.\n */\nexport type OutputVariables = Record<string, OutputVariable>;\n\n/**\n * Structured output envelope produced by every node.\n */\nexport interface StructuredOutput {\n  /** Named outputs produced by node execution (e.g. `output`, `true_output`). */\n  variables: OutputVariables;\n  /** Optional metadata about the execution (model, timing, etc.). */\n  metadata?: Record<string, unknown>;\n}\n\n/**\n * The generic node output shape stored in execution traces and passed\n * downstream.  `nodeType` is the action/executor ID string (e.g.\n * `\"core.model\"`, `\"AGENT\"`).\n */\nexport interface NodeOutput {\n  nodeType: string;\n  data: StructuredOutput;\n}\n\n/**\n * Union kept as an alias for backwards compatibility — it is simply\n * `NodeOutput` now that output types are no longer per-node-type.\n */\nexport type NodeOutputs = NodeOutput;\n"],"mappings":";;;;;;;;;;;;;;AAkBA,MAAa,yBAAyBA,OAAAA,EAAE,OAAOA,OAAAA,EAAE,QAAQ,EAAEA,OAAAA,EAAE,QAAQ,CAAC"}

package/dist/types/node-io-types.d.cts

@@ -0,0 +1,65 @@
+import { z } from "zod/v4";
+
+//#region src/types/node-io-types.d.ts
+declare const NodeInputMappingSchema: z.ZodRecord<z.ZodString, z.ZodString>;
+type InputMappingConfig = Record<string, string>;
+/**
+ * Node incoming data is a simple object keyed by upstream node slug.
+ * Values are the direct output values from upstream nodes (JSON-parsed if valid).
+ *
+ * Example: { "fetch_user": { "id": 123, "name": "Alice" }, "get_config": "production" }
+ */
+type NodeIncomingDataObject = Record<string, unknown>;
+/**
+ * Generic input data passed to a node executor's `execute()` method.
+ * Always a flat key→value record (slug-keyed incoming data from upstream nodes).
+ */
+type NodeInputData = Record<string, unknown>;
+/**
+ * A single output variable produced by a node.
+ *
+ * The `type` discriminator categorises the runtime `value`:
+ *   - `'string'`  → value is a `string`, or a primitive (`number | boolean | null | undefined`)
+ *   - `'object'`  → value is a non-null `object` (plain object or array)
+ *
+ * In practice every action returns one of:
+ *   • a plain string (JQ, model, template_string, output)
+ *   • a JSON-serializable object (http.request, gmail.*, trigger.*, sql_query)
+ *   • `undefined` (batch-pending sentinel — only `core.model`)
+ *
+ * No action returns raw numbers, booleans, `null`, Buffers, Dates, or class instances.
+ */
+type OutputVariable = {
+  value: unknown;
+  type: 'string' | 'object';
+};
+/**
+ * Record of named output variables.
+ */
+type OutputVariables = Record<string, OutputVariable>;
+/**
+ * Structured output envelope produced by every node.
+ */
+interface StructuredOutput {
+  /** Named outputs produced by node execution (e.g. `output`, `true_output`). */
+  variables: OutputVariables;
+  /** Optional metadata about the execution (model, timing, etc.). */
+  metadata?: Record<string, unknown>;
+}
+/**
+ * The generic node output shape stored in execution traces and passed
+ * downstream.  `nodeType` is the action/executor ID string (e.g.
+ * `"core.model"`, `"AGENT"`).
+ */
+interface NodeOutput {
+  nodeType: string;
+  data: StructuredOutput;
+}
+/**
+ * Union kept as an alias for backwards compatibility — it is simply
+ * `NodeOutput` now that output types are no longer per-node-type.
+ */
+type NodeOutputs = NodeOutput;
+//#endregion
+export { InputMappingConfig, NodeIncomingDataObject, NodeInputData, NodeInputMappingSchema, NodeOutput, NodeOutputs, OutputVariable, OutputVariables, StructuredOutput };
+//# sourceMappingURL=node-io-types.d.cts.map

package/dist/types/node-io-types.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-io-types.d.cts","names":[],"sources":["../../src/types/node-io-types.ts"],"mappings":";;;cAkBa,sBAAA,EAAsB,CAAA,CAAA,SAAA,CAAA,CAAA,CAAA,SAAA,EAAA,CAAA,CAAA,SAAA;AAAA,KAEvB,kBAAA,GAAqB,MAAA;;;;;;AAAjC;KAQY,sBAAA,GAAyB,MAAA;;;;AAArC;KAMY,aAAA,GAAgB,MAAA;;;;AAA5B;;;;;AAoBA;;;;;AAQA;KARY,cAAA;EACV,KAAA;EACA,IAAA;AAAA;AAWF;;;AAAA,KALY,eAAA,GAAkB,MAAA,SAAe,cAAA;;;;UAK5B,gBAAA;EAIE;EAFjB,SAAA,EAAW,eAAA;EAUI;EARf,QAAA,GAAW,MAAA;AAAA;;;;;;UAQI,UAAA;EACf,QAAA;EACA,IAAA,EAAM,gBAAA;AAAA;;;;;KAOI,WAAA,GAAc,UAAA"}

package/dist/types/node-io-types.d.ts

@@ -0,0 +1,65 @@
+import { z } from "zod/v4";
+
+//#region src/types/node-io-types.d.ts
+declare const NodeInputMappingSchema: z.ZodRecord<z.ZodString, z.ZodString>;
+type InputMappingConfig = Record<string, string>;
+/**
+ * Node incoming data is a simple object keyed by upstream node slug.
+ * Values are the direct output values from upstream nodes (JSON-parsed if valid).
+ *
+ * Example: { "fetch_user": { "id": 123, "name": "Alice" }, "get_config": "production" }
+ */
+type NodeIncomingDataObject = Record<string, unknown>;
+/**
+ * Generic input data passed to a node executor's `execute()` method.
+ * Always a flat key→value record (slug-keyed incoming data from upstream nodes).
+ */
+type NodeInputData = Record<string, unknown>;
+/**
+ * A single output variable produced by a node.
+ *
+ * The `type` discriminator categorises the runtime `value`:
+ *   - `'string'`  → value is a `string`, or a primitive (`number | boolean | null | undefined`)
+ *   - `'object'`  → value is a non-null `object` (plain object or array)
+ *
+ * In practice every action returns one of:
+ *   • a plain string (JQ, model, template_string, output)
+ *   • a JSON-serializable object (http.request, gmail.*, trigger.*, sql_query)
+ *   • `undefined` (batch-pending sentinel — only `core.model`)
+ *
+ * No action returns raw numbers, booleans, `null`, Buffers, Dates, or class instances.
+ */
+type OutputVariable = {
+  value: unknown;
+  type: 'string' | 'object';
+};
+/**
+ * Record of named output variables.
+ */
+type OutputVariables = Record<string, OutputVariable>;
+/**
+ * Structured output envelope produced by every node.
+ */
+interface StructuredOutput {
+  /** Named outputs produced by node execution (e.g. `output`, `true_output`). */
+  variables: OutputVariables;
+  /** Optional metadata about the execution (model, timing, etc.). */
+  metadata?: Record<string, unknown>;
+}
+/**
+ * The generic node output shape stored in execution traces and passed
+ * downstream.  `nodeType` is the action/executor ID string (e.g.
+ * `"core.model"`, `"AGENT"`).
+ */
+interface NodeOutput {
+  nodeType: string;
+  data: StructuredOutput;
+}
+/**
+ * Union kept as an alias for backwards compatibility — it is simply
+ * `NodeOutput` now that output types are no longer per-node-type.
+ */
+type NodeOutputs = NodeOutput;
+//#endregion
+export { InputMappingConfig, NodeIncomingDataObject, NodeInputData, NodeInputMappingSchema, NodeOutput, NodeOutputs, OutputVariable, OutputVariables, StructuredOutput };
+//# sourceMappingURL=node-io-types.d.ts.map

package/dist/types/node-io-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-io-types.d.ts","names":[],"sources":["../../src/types/node-io-types.ts"],"mappings":";;;cAkBa,sBAAA,EAAsB,CAAA,CAAA,SAAA,CAAA,CAAA,CAAA,SAAA,EAAA,CAAA,CAAA,SAAA;AAAA,KAEvB,kBAAA,GAAqB,MAAA;;;;;;AAAjC;KAQY,sBAAA,GAAyB,MAAA;;;;AAArC;KAMY,aAAA,GAAgB,MAAA;;;;AAA5B;;;;;AAoBA;;;;;AAQA;KARY,cAAA;EACV,KAAA;EACA,IAAA;AAAA;AAWF;;;AAAA,KALY,eAAA,GAAkB,MAAA,SAAe,cAAA;;;;UAK5B,gBAAA;EAIE;EAFjB,SAAA,EAAW,eAAA;EAUI;EARf,QAAA,GAAW,MAAA;AAAA;;;;;;UAQI,UAAA;EACf,QAAA;EACA,IAAA,EAAM,gBAAA;AAAA;;;;;KAOI,WAAA,GAAc,UAAA"}

package/dist/types/node-io-types.js

@@ -0,0 +1,18 @@
+import { z } from "zod/v4";
+//#region src/types/node-io-types.ts
+/**
+* Node I/O Types
+*
+* Generic types for node inputs and outputs.
+* These are NOT parameterised by node type — every node (whether a legacy
+* executor or a provider-action) uses the same shapes. This keeps the type
+* system scalable as hundreds of new actions are added.
+*
+* IMPORTANT: This file must NOT import from src/nodes/* to avoid pulling
+* Node.js runtime code into the frontend bundle via @invect/core/types.
+*/
+const NodeInputMappingSchema = z.record(z.string(), z.string());
+//#endregion
+export { NodeInputMappingSchema };
+
+//# sourceMappingURL=node-io-types.js.map

package/dist/types/node-io-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-io-types.js","names":[],"sources":["../../src/types/node-io-types.ts"],"sourcesContent":["/**\n * Node I/O Types\n *\n * Generic types for node inputs and outputs.\n * These are NOT parameterised by node type — every node (whether a legacy\n * executor or a provider-action) uses the same shapes. This keeps the type\n * system scalable as hundreds of new actions are added.\n *\n * IMPORTANT: This file must NOT import from src/nodes/* to avoid pulling\n * Node.js runtime code into the frontend bundle via @invect/core/types.\n */\n\nimport { z } from 'zod/v4';\n\n// =============================================================================\n// COMMON NODE INPUT MAPPING TYPES\n// =============================================================================\n\nexport const NodeInputMappingSchema = z.record(z.string(), z.string());\n\nexport type InputMappingConfig = Record<string, string>;\n\n/**\n * Node incoming data is a simple object keyed by upstream node slug.\n * Values are the direct output values from upstream nodes (JSON-parsed if valid).\n *\n * Example: { \"fetch_user\": { \"id\": 123, \"name\": \"Alice\" }, \"get_config\": \"production\" }\n */\nexport type NodeIncomingDataObject = Record<string, unknown>;\n\n/**\n * Generic input data passed to a node executor's `execute()` method.\n * Always a flat key→value record (slug-keyed incoming data from upstream nodes).\n */\nexport type NodeInputData = Record<string, unknown>;\n\n// =============================================================================\n// OUTPUT TYPES\n// =============================================================================\n\n/**\n * A single output variable produced by a node.\n *\n * The `type` discriminator categorises the runtime `value`:\n *   - `'string'`  → value is a `string`, or a primitive (`number | boolean | null | undefined`)\n *   - `'object'`  → value is a non-null `object` (plain object or array)\n *\n * In practice every action returns one of:\n *   • a plain string (JQ, model, template_string, output)\n *   • a JSON-serializable object (http.request, gmail.*, trigger.*, sql_query)\n *   • `undefined` (batch-pending sentinel — only `core.model`)\n *\n * No action returns raw numbers, booleans, `null`, Buffers, Dates, or class instances.\n */\nexport type OutputVariable = {\n  value: unknown;\n  type: 'string' | 'object';\n};\n\n/**\n * Record of named output variables.\n */\nexport type OutputVariables = Record<string, OutputVariable>;\n\n/**\n * Structured output envelope produced by every node.\n */\nexport interface StructuredOutput {\n  /** Named outputs produced by node execution (e.g. `output`, `true_output`). */\n  variables: OutputVariables;\n  /** Optional metadata about the execution (model, timing, etc.). */\n  metadata?: Record<string, unknown>;\n}\n\n/**\n * The generic node output shape stored in execution traces and passed\n * downstream.  `nodeType` is the action/executor ID string (e.g.\n * `\"core.model\"`, `\"AGENT\"`).\n */\nexport interface NodeOutput {\n  nodeType: string;\n  data: StructuredOutput;\n}\n\n/**\n * Union kept as an alias for backwards compatibility — it is simply\n * `NodeOutput` now that output types are no longer per-node-type.\n */\nexport type NodeOutputs = NodeOutput;\n"],"mappings":";;;;;;;;;;;;;AAkBA,MAAa,yBAAyB,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,QAAQ,CAAC"}

package/dist/types/node-output-schemas.cjs

@@ -0,0 +1,51 @@
+require("../_virtual/_rolldown/runtime.cjs");
+let zod_v4 = require("zod/v4");
+//#region src/types/node-output-schemas.ts
+/**
+* Common Node Output Schema Utilities
+*
+* Provides Zod schema building blocks for validating node output shapes.
+* These schemas are used by legacy executors that define an `outputSchema`.
+* New actions don't need these — their output shape is validated generically.
+*/
+/** Schema for a string variable in node output */
+const stringVariableSchema = zod_v4.z.object({
+	value: zod_v4.z.string(),
+	type: zod_v4.z.literal("string")
+});
+/** Schema for an object variable in node output */
+const objectVariableSchema = zod_v4.z.object({
+	value: zod_v4.z.union([zod_v4.z.record(zod_v4.z.string(), zod_v4.z.unknown()), zod_v4.z.array(zod_v4.z.unknown())]),
+	type: zod_v4.z.literal("object")
+});
+/** Schema for a variable that can be either string or object */
+const anyVariableSchema = zod_v4.z.union([stringVariableSchema, objectVariableSchema]);
+/** Schema for the variables object (record of named outputs) */
+const variablesRecordSchema = zod_v4.z.record(zod_v4.z.string(), anyVariableSchema);
+/**
+* Create a node output schema with proper typing.
+*
+* @param nodeType - A string literal for the node type (informational)
+* @param variablesSchema - Zod schema for the variables object
+* @param metadataSchema - Optional Zod schema for metadata
+*/
+function createOutputSchema(nodeType, variablesSchema, metadataSchema) {
+	return zod_v4.z.object({
+		nodeType: zod_v4.z.literal(nodeType),
+		data: zod_v4.z.object({
+			variables: variablesSchema,
+			metadata: metadataSchema ?? zod_v4.z.record(zod_v4.z.string(), zod_v4.z.unknown()).optional()
+		})
+	});
+}
+zod_v4.z.object({
+	nodeType: zod_v4.z.string(),
+	data: zod_v4.z.object({
+		variables: variablesRecordSchema,
+		metadata: zod_v4.z.record(zod_v4.z.string(), zod_v4.z.unknown()).optional()
+	})
+});
+//#endregion
+exports.createOutputSchema = createOutputSchema;
+
+//# sourceMappingURL=node-output-schemas.cjs.map

package/dist/types/node-output-schemas.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-output-schemas.cjs","names":["z"],"sources":["../../src/types/node-output-schemas.ts"],"sourcesContent":["/**\n * Common Node Output Schema Utilities\n *\n * Provides Zod schema building blocks for validating node output shapes.\n * These schemas are used by legacy executors that define an `outputSchema`.\n * New actions don't need these — their output shape is validated generically.\n */\n\nimport { z, ZodType } from 'zod/v4';\n\n// =============================================================================\n// COMMON VARIABLE SCHEMAS\n// =============================================================================\n\n/** Schema for a string variable in node output */\nexport const stringVariableSchema = z.object({\n  value: z.string(),\n  type: z.literal('string'),\n});\n\n/** Schema for an object variable in node output */\nexport const objectVariableSchema = z.object({\n  value: z.union([z.record(z.string(), z.unknown()), z.array(z.unknown())]),\n  type: z.literal('object'),\n});\n\n/** Schema for a variable that can be either string or object */\nexport const anyVariableSchema = z.union([stringVariableSchema, objectVariableSchema]);\n\n/** Schema for the variables object (record of named outputs) */\nexport const variablesRecordSchema = z.record(z.string(), anyVariableSchema);\n\n// =============================================================================\n// OUTPUT SCHEMA FACTORY\n// =============================================================================\n\n/**\n * Create a node output schema with proper typing.\n *\n * @param nodeType - A string literal for the node type (informational)\n * @param variablesSchema - Zod schema for the variables object\n * @param metadataSchema - Optional Zod schema for metadata\n */\nexport function createOutputSchema<\n  TVariables extends ZodType,\n  TMetadata extends ZodType = z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>,\n>(nodeType: string, variablesSchema: TVariables, metadataSchema?: TMetadata) {\n  return z.object({\n    nodeType: z.literal(nodeType),\n    data: z.object({\n      variables: variablesSchema,\n      metadata: metadataSchema ?? z.record(z.string(), z.unknown()).optional(),\n    }),\n  });\n}\n\n/** Infer the TypeScript type from an output schema */\nexport type InferOutputType<T extends ZodType> = z.infer<T>;\n\n// =============================================================================\n// DEFAULT OUTPUT SCHEMA\n// =============================================================================\n\n/**\n * Default output schema for nodes that don't define their own.\n * Uses a flexible structure that accepts any valid node output.\n */\nexport const defaultOutputSchema = z.object({\n  nodeType: z.string(),\n  data: z.object({\n    variables: variablesRecordSchema,\n    metadata: z.record(z.string(), z.unknown()).optional(),\n  }),\n});\n\nexport type DefaultNodeOutput = z.infer<typeof defaultOutputSchema>;\n"],"mappings":";;;;;;;;;;;AAeA,MAAa,uBAAuBA,OAAAA,EAAE,OAAO;CAC3C,OAAOA,OAAAA,EAAE,QAAQ;CACjB,MAAMA,OAAAA,EAAE,QAAQ,SAAS;CAC1B,CAAC;;AAGF,MAAa,uBAAuBA,OAAAA,EAAE,OAAO;CAC3C,OAAOA,OAAAA,EAAE,MAAM,CAACA,OAAAA,EAAE,OAAOA,OAAAA,EAAE,QAAQ,EAAEA,OAAAA,EAAE,SAAS,CAAC,EAAEA,OAAAA,EAAE,MAAMA,OAAAA,EAAE,SAAS,CAAC,CAAC,CAAC;CACzE,MAAMA,OAAAA,EAAE,QAAQ,SAAS;CAC1B,CAAC;;AAGF,MAAa,oBAAoBA,OAAAA,EAAE,MAAM,CAAC,sBAAsB,qBAAqB,CAAC;;AAGtF,MAAa,wBAAwBA,OAAAA,EAAE,OAAOA,OAAAA,EAAE,QAAQ,EAAE,kBAAkB;;;;;;;;AAa5E,SAAgB,mBAGd,UAAkB,iBAA6B,gBAA4B;AAC3E,QAAOA,OAAAA,EAAE,OAAO;EACd,UAAUA,OAAAA,EAAE,QAAQ,SAAS;EAC7B,MAAMA,OAAAA,EAAE,OAAO;GACb,WAAW;GACX,UAAU,kBAAkBA,OAAAA,EAAE,OAAOA,OAAAA,EAAE,QAAQ,EAAEA,OAAAA,EAAE,SAAS,CAAC,CAAC,UAAU;GACzE,CAAC;EACH,CAAC;;AAc+BA,OAAAA,EAAE,OAAO;CAC1C,UAAUA,OAAAA,EAAE,QAAQ;CACpB,MAAMA,OAAAA,EAAE,OAAO;EACb,WAAW;EACX,UAAUA,OAAAA,EAAE,OAAOA,OAAAA,EAAE,QAAQ,EAAEA,OAAAA,EAAE,SAAS,CAAC,CAAC,UAAU;EACvD,CAAC;CACH,CAAC"}

package/dist/types/node-output-schemas.js

@@ -0,0 +1,50 @@
+import { z } from "zod/v4";
+//#region src/types/node-output-schemas.ts
+/**
+* Common Node Output Schema Utilities
+*
+* Provides Zod schema building blocks for validating node output shapes.
+* These schemas are used by legacy executors that define an `outputSchema`.
+* New actions don't need these — their output shape is validated generically.
+*/
+/** Schema for a string variable in node output */
+const stringVariableSchema = z.object({
+	value: z.string(),
+	type: z.literal("string")
+});
+/** Schema for an object variable in node output */
+const objectVariableSchema = z.object({
+	value: z.union([z.record(z.string(), z.unknown()), z.array(z.unknown())]),
+	type: z.literal("object")
+});
+/** Schema for a variable that can be either string or object */
+const anyVariableSchema = z.union([stringVariableSchema, objectVariableSchema]);
+/** Schema for the variables object (record of named outputs) */
+const variablesRecordSchema = z.record(z.string(), anyVariableSchema);
+/**
+* Create a node output schema with proper typing.
+*
+* @param nodeType - A string literal for the node type (informational)
+* @param variablesSchema - Zod schema for the variables object
+* @param metadataSchema - Optional Zod schema for metadata
+*/
+function createOutputSchema(nodeType, variablesSchema, metadataSchema) {
+	return z.object({
+		nodeType: z.literal(nodeType),
+		data: z.object({
+			variables: variablesSchema,
+			metadata: metadataSchema ?? z.record(z.string(), z.unknown()).optional()
+		})
+	});
+}
+z.object({
+	nodeType: z.string(),
+	data: z.object({
+		variables: variablesRecordSchema,
+		metadata: z.record(z.string(), z.unknown()).optional()
+	})
+});
+//#endregion
+export { createOutputSchema };
+
+//# sourceMappingURL=node-output-schemas.js.map

package/dist/types/node-output-schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-output-schemas.js","names":[],"sources":["../../src/types/node-output-schemas.ts"],"sourcesContent":["/**\n * Common Node Output Schema Utilities\n *\n * Provides Zod schema building blocks for validating node output shapes.\n * These schemas are used by legacy executors that define an `outputSchema`.\n * New actions don't need these — their output shape is validated generically.\n */\n\nimport { z, ZodType } from 'zod/v4';\n\n// =============================================================================\n// COMMON VARIABLE SCHEMAS\n// =============================================================================\n\n/** Schema for a string variable in node output */\nexport const stringVariableSchema = z.object({\n  value: z.string(),\n  type: z.literal('string'),\n});\n\n/** Schema for an object variable in node output */\nexport const objectVariableSchema = z.object({\n  value: z.union([z.record(z.string(), z.unknown()), z.array(z.unknown())]),\n  type: z.literal('object'),\n});\n\n/** Schema for a variable that can be either string or object */\nexport const anyVariableSchema = z.union([stringVariableSchema, objectVariableSchema]);\n\n/** Schema for the variables object (record of named outputs) */\nexport const variablesRecordSchema = z.record(z.string(), anyVariableSchema);\n\n// =============================================================================\n// OUTPUT SCHEMA FACTORY\n// =============================================================================\n\n/**\n * Create a node output schema with proper typing.\n *\n * @param nodeType - A string literal for the node type (informational)\n * @param variablesSchema - Zod schema for the variables object\n * @param metadataSchema - Optional Zod schema for metadata\n */\nexport function createOutputSchema<\n  TVariables extends ZodType,\n  TMetadata extends ZodType = z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>,\n>(nodeType: string, variablesSchema: TVariables, metadataSchema?: TMetadata) {\n  return z.object({\n    nodeType: z.literal(nodeType),\n    data: z.object({\n      variables: variablesSchema,\n      metadata: metadataSchema ?? z.record(z.string(), z.unknown()).optional(),\n    }),\n  });\n}\n\n/** Infer the TypeScript type from an output schema */\nexport type InferOutputType<T extends ZodType> = z.infer<T>;\n\n// =============================================================================\n// DEFAULT OUTPUT SCHEMA\n// =============================================================================\n\n/**\n * Default output schema for nodes that don't define their own.\n * Uses a flexible structure that accepts any valid node output.\n */\nexport const defaultOutputSchema = z.object({\n  nodeType: z.string(),\n  data: z.object({\n    variables: variablesRecordSchema,\n    metadata: z.record(z.string(), z.unknown()).optional(),\n  }),\n});\n\nexport type DefaultNodeOutput = z.infer<typeof defaultOutputSchema>;\n"],"mappings":";;;;;;;;;;AAeA,MAAa,uBAAuB,EAAE,OAAO;CAC3C,OAAO,EAAE,QAAQ;CACjB,MAAM,EAAE,QAAQ,SAAS;CAC1B,CAAC;;AAGF,MAAa,uBAAuB,EAAE,OAAO;CAC3C,OAAO,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;CACzE,MAAM,EAAE,QAAQ,SAAS;CAC1B,CAAC;;AAGF,MAAa,oBAAoB,EAAE,MAAM,CAAC,sBAAsB,qBAAqB,CAAC;;AAGtF,MAAa,wBAAwB,EAAE,OAAO,EAAE,QAAQ,EAAE,kBAAkB;;;;;;;;AAa5E,SAAgB,mBAGd,UAAkB,iBAA6B,gBAA4B;AAC3E,QAAO,EAAE,OAAO;EACd,UAAU,EAAE,QAAQ,SAAS;EAC7B,MAAM,EAAE,OAAO;GACb,WAAW;GACX,UAAU,kBAAkB,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,SAAS,CAAC,CAAC,UAAU;GACzE,CAAC;EACH,CAAC;;AAc+B,EAAE,OAAO;CAC1C,UAAU,EAAE,QAAQ;CACpB,MAAM,EAAE,OAAO;EACb,WAAW;EACX,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,SAAS,CAAC,CAAC,UAAU;EACvD,CAAC;CACH,CAAC"}