@objectstack/spec 0.1.0 → 0.1.2

package/dist/data/field.zod.d.ts.map

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

package/dist/data/field.zod.js

@@ -0,0 +1,222 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Field = exports.FieldSchema = exports.AddressSchema = exports.LocationCoordinatesSchema = exports.SelectOptionSchema = exports.FieldType = void 0;
+const zod_1 = require("zod");
+/**
+ * Field Type Enum
+ */
+exports.FieldType = zod_1.z.enum([
+    // Core Text
+    'text', 'textarea', 'email', 'url', 'phone', 'password',
+    // Rich Content
+    'markdown', 'html', 'richtext',
+    // Numbers
+    'number', 'currency', 'percent',
+    // Date & Time
+    'date', 'datetime', 'time',
+    // Logic
+    'boolean',
+    // Selection
+    'select', // Static options
+    // Relational
+    'lookup', 'master_detail', // Dynamic reference to other objects
+    // Media
+    'image', 'file', 'avatar',
+    // Calculated / System
+    'formula', 'summary', 'autonumber',
+    // Enhanced Types
+    'location', // GPS coordinates
+    'address', // Structured address
+    'code', // Code with syntax highlighting
+    'color', // Color picker
+    'rating', // Star rating
+    'signature' // Digital signature
+]);
+/**
+ * Select Option Schema
+ */
+exports.SelectOptionSchema = zod_1.z.object({
+    label: zod_1.z.string().describe('Display label'),
+    value: zod_1.z.string().describe('Stored value'),
+    color: zod_1.z.string().optional().describe('Color code for badges/charts'),
+    default: zod_1.z.boolean().optional().describe('Is default option'),
+});
+/**
+ * Location Coordinates Schema
+ * GPS coordinates for location field type
+ */
+exports.LocationCoordinatesSchema = zod_1.z.object({
+    latitude: zod_1.z.number().min(-90).max(90).describe('Latitude coordinate'),
+    longitude: zod_1.z.number().min(-180).max(180).describe('Longitude coordinate'),
+    altitude: zod_1.z.number().optional().describe('Altitude in meters'),
+    accuracy: zod_1.z.number().optional().describe('Accuracy in meters'),
+});
+/**
+ * Address Schema
+ * Structured address for address field type
+ */
+exports.AddressSchema = zod_1.z.object({
+    street: zod_1.z.string().optional().describe('Street address'),
+    city: zod_1.z.string().optional().describe('City name'),
+    state: zod_1.z.string().optional().describe('State/Province'),
+    postalCode: zod_1.z.string().optional().describe('Postal/ZIP code'),
+    country: zod_1.z.string().optional().describe('Country name or code'),
+    countryCode: zod_1.z.string().optional().describe('ISO country code (e.g., US, GB)'),
+    formatted: zod_1.z.string().optional().describe('Formatted address string'),
+});
+/**
+ * Field Schema - Best Practice Enterprise Pattern
+ */
+exports.FieldSchema = zod_1.z.object({
+    /** Identity */
+    name: zod_1.z.string().regex(/^[a-z_][a-z0-9_]*$/).describe('Machine name (snake_case)').optional(),
+    label: zod_1.z.string().optional().describe('Human readable label'),
+    type: exports.FieldType.describe('Field Data Type'),
+    description: zod_1.z.string().optional().describe('Tooltip/Help text'),
+    format: zod_1.z.string().optional().describe('Format string (e.g. email, phone)'),
+    /** Database Constraints */
+    required: zod_1.z.boolean().default(false).describe('Is required'),
+    searchable: zod_1.z.boolean().default(false).describe('Is searchable'),
+    multiple: zod_1.z.boolean().default(false).describe('Allow multiple values (Stores as Array/JSON). Applicable for select, lookup, file, image.'),
+    unique: zod_1.z.boolean().default(false).describe('Is unique constraint'),
+    defaultValue: zod_1.z.any().optional().describe('Default value'),
+    /** Text/String Constraints */
+    maxLength: zod_1.z.number().optional().describe('Max character length'),
+    minLength: zod_1.z.number().optional().describe('Min character length'),
+    /** Number Constraints */
+    precision: zod_1.z.number().optional().describe('Total digits'),
+    scale: zod_1.z.number().optional().describe('Decimal places'),
+    min: zod_1.z.number().optional().describe('Minimum value'),
+    max: zod_1.z.number().optional().describe('Maximum value'),
+    /** Selection Options */
+    options: zod_1.z.array(exports.SelectOptionSchema).optional().describe('Static options for select/multiselect'),
+    /** Relationship Config */
+    reference: zod_1.z.string().optional().describe('Target Object Name'),
+    referenceFilters: zod_1.z.array(zod_1.z.string()).optional().describe('Filters applied to lookup dialogs (e.g. "active = true")'),
+    writeRequiresMasterRead: zod_1.z.boolean().optional().describe('If true, user needs read access to master record to edit this field'),
+    deleteBehavior: zod_1.z.enum(['set_null', 'cascade', 'restrict']).optional().default('set_null').describe('What happens if referenced record is deleted'),
+    /** Calculation */
+    expression: zod_1.z.string().optional().describe('Formula expression'),
+    formula: zod_1.z.string().optional().describe('Deprecated: Use expression'),
+    summaryOperations: zod_1.z.object({
+        object: zod_1.z.string(),
+        field: zod_1.z.string(),
+        function: zod_1.z.enum(['count', 'sum', 'min', 'max', 'avg'])
+    }).optional().describe('Roll-up summary definition'),
+    /** Enhanced Field Type Configurations */
+    // Code field config
+    language: zod_1.z.string().optional().describe('Programming language for syntax highlighting (e.g., javascript, python, sql)'),
+    theme: zod_1.z.string().optional().describe('Code editor theme (e.g., dark, light, monokai)'),
+    lineNumbers: zod_1.z.boolean().optional().describe('Show line numbers in code editor'),
+    // Rating field config
+    maxRating: zod_1.z.number().optional().describe('Maximum rating value (default: 5)'),
+    allowHalf: zod_1.z.boolean().optional().describe('Allow half-star ratings'),
+    // Location field config
+    displayMap: zod_1.z.boolean().optional().describe('Display map widget for location field'),
+    allowGeocoding: zod_1.z.boolean().optional().describe('Allow address-to-coordinate conversion'),
+    // Address field config
+    addressFormat: zod_1.z.enum(['us', 'uk', 'international']).optional().describe('Address format template'),
+    // Color field config
+    colorFormat: zod_1.z.enum(['hex', 'rgb', 'rgba', 'hsl']).optional().describe('Color value format'),
+    allowAlpha: zod_1.z.boolean().optional().describe('Allow transparency/alpha channel'),
+    presetColors: zod_1.z.array(zod_1.z.string()).optional().describe('Preset color options'),
+    /** Security & Visibility */
+    hidden: zod_1.z.boolean().default(false).describe('Hidden from default UI'),
+    readonly: zod_1.z.boolean().default(false).describe('Read-only in UI'),
+    encryption: zod_1.z.boolean().default(false).describe('Encrypt at rest'),
+    /** Indexing */
+    index: zod_1.z.boolean().default(false).describe('Create standard database index'),
+    externalId: zod_1.z.boolean().default(false).describe('Is external ID for upsert operations'),
+});
+exports.Field = {
+    text: (config = {}) => ({ type: 'text', ...config }),
+    textarea: (config = {}) => ({ type: 'textarea', ...config }),
+    number: (config = {}) => ({ type: 'number', ...config }),
+    boolean: (config = {}) => ({ type: 'boolean', ...config }),
+    date: (config = {}) => ({ type: 'date', ...config }),
+    datetime: (config = {}) => ({ type: 'datetime', ...config }),
+    currency: (config = {}) => ({ type: 'currency', ...config }),
+    percent: (config = {}) => ({ type: 'percent', ...config }),
+    url: (config = {}) => ({ type: 'url', ...config }),
+    email: (config = {}) => ({ type: 'email', ...config }),
+    phone: (config = {}) => ({ type: 'phone', ...config }),
+    image: (config = {}) => ({ type: 'image', ...config }),
+    file: (config = {}) => ({ type: 'file', ...config }),
+    avatar: (config = {}) => ({ type: 'avatar', ...config }),
+    formula: (config = {}) => ({ type: 'formula', ...config }),
+    summary: (config = {}) => ({ type: 'summary', ...config }),
+    autonumber: (config = {}) => ({ type: 'autonumber', ...config }),
+    markdown: (config = {}) => ({ type: 'markdown', ...config }),
+    html: (config = {}) => ({ type: 'html', ...config }),
+    password: (config = {}) => ({ type: 'password', ...config }),
+    /**
+     * Select field helper with backward-compatible API
+     *
+     * @example Old API (array first)
+     * Field.select(['High', 'Low'], { label: 'Priority' })
+     *
+     * @example New API (config object)
+     * Field.select({ options: [{label: 'High', value: 'high'}], label: 'Priority' })
+     */
+    select: (optionsOrConfig, config) => {
+        // Support both old and new signatures:
+        // Old: Field.select(['a', 'b'], { label: 'X' })
+        // New: Field.select({ options: [{label: 'A', value: 'a'}], label: 'X' })
+        let options;
+        let finalConfig;
+        if (Array.isArray(optionsOrConfig)) {
+            // Old signature: array as first param
+            options = optionsOrConfig.map(o => typeof o === 'string' ? { label: o, value: o } : o);
+            finalConfig = config || {};
+        }
+        else {
+            // New signature: config object with options
+            options = (optionsOrConfig.options || []).map(o => typeof o === 'string' ? { label: o, value: o } : o);
+            // Remove options from config to avoid confusion
+            const { options: _, ...restConfig } = optionsOrConfig;
+            finalConfig = restConfig;
+        }
+        return { type: 'select', options, ...finalConfig };
+    },
+    lookup: (reference, config = {}) => ({
+        type: 'lookup',
+        reference,
+        ...config
+    }),
+    masterDetail: (reference, config = {}) => ({
+        type: 'master_detail',
+        reference,
+        ...config
+    }),
+    // Enhanced Field Type Helpers
+    location: (config = {}) => ({
+        type: 'location',
+        ...config
+    }),
+    address: (config = {}) => ({
+        type: 'address',
+        ...config
+    }),
+    richtext: (config = {}) => ({
+        type: 'richtext',
+        ...config
+    }),
+    code: (language, config = {}) => ({
+        type: 'code',
+        language,
+        ...config
+    }),
+    color: (config = {}) => ({
+        type: 'color',
+        ...config
+    }),
+    rating: (maxRating = 5, config = {}) => ({
+        type: 'rating',
+        maxRating,
+        ...config
+    }),
+    signature: (config = {}) => ({
+        type: 'signature',
+        ...config
+    }),
+};

package/dist/data/flow.zod.d.ts

@@ -0,0 +1,242 @@
+import { z } from 'zod';
+/**
+ * Flow Node Types
+ */
+export declare const FlowNodeAction: z.ZodEnum<["start", "end", "decision", "assignment", "loop", "create_record", "update_record", "delete_record", "get_record", "http_request", "script", "wait", "subflow"]>;
+/**
+ * Flow Variable Schema
+ * Variables available within the flow execution context.
+ */
+export declare const FlowVariableSchema: z.ZodObject<{
+    name: z.ZodString;
+    type: z.ZodString;
+    isInput: z.ZodDefault<z.ZodBoolean>;
+    isOutput: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    type: string;
+    name: string;
+    isInput: boolean;
+    isOutput: boolean;
+}, {
+    type: string;
+    name: string;
+    isInput?: boolean | undefined;
+    isOutput?: boolean | undefined;
+}>;
+/**
+ * Flow Node Schema
+ * A single step in the visual logic graph.
+ */
+export declare const FlowNodeSchema: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodEnum<["start", "end", "decision", "assignment", "loop", "create_record", "update_record", "delete_record", "get_record", "http_request", "script", "wait", "subflow"]>;
+    label: z.ZodString;
+    /** Node Configuration Options (Specific to type) */
+    config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    /** UI Position (for the canvas) */
+    position: z.ZodOptional<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        x: number;
+        y: number;
+    }, {
+        x: number;
+        y: number;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    type: "script" | "start" | "end" | "decision" | "assignment" | "loop" | "create_record" | "update_record" | "delete_record" | "get_record" | "http_request" | "wait" | "subflow";
+    label: string;
+    id: string;
+    config?: Record<string, any> | undefined;
+    position?: {
+        x: number;
+        y: number;
+    } | undefined;
+}, {
+    type: "script" | "start" | "end" | "decision" | "assignment" | "loop" | "create_record" | "update_record" | "delete_record" | "get_record" | "http_request" | "wait" | "subflow";
+    label: string;
+    id: string;
+    config?: Record<string, any> | undefined;
+    position?: {
+        x: number;
+        y: number;
+    } | undefined;
+}>;
+/**
+ * Flow Edge Schema
+ * Connections between nodes.
+ */
+export declare const FlowEdgeSchema: z.ZodObject<{
+    id: z.ZodString;
+    source: z.ZodString;
+    target: z.ZodString;
+    /** Condition for this path (only for decision/branch nodes) */
+    condition: z.ZodOptional<z.ZodString>;
+    label: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    source: string;
+    target: string;
+    label?: string | undefined;
+    condition?: string | undefined;
+}, {
+    id: string;
+    source: string;
+    target: string;
+    label?: string | undefined;
+    condition?: string | undefined;
+}>;
+/**
+ * Flow Schema
+ * Visual Business Logic Orchestration.
+ */
+export declare const FlowSchema: z.ZodObject<{
+    /** Identity */
+    name: z.ZodString;
+    label: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    /** Trigger Type */
+    type: z.ZodEnum<["autolaunched", "record_change", "schedule", "screen", "api"]>;
+    /** Configuration Variables */
+    variables: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodString;
+        isInput: z.ZodDefault<z.ZodBoolean>;
+        isOutput: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        type: string;
+        name: string;
+        isInput: boolean;
+        isOutput: boolean;
+    }, {
+        type: string;
+        name: string;
+        isInput?: boolean | undefined;
+        isOutput?: boolean | undefined;
+    }>, "many">>;
+    /** Graph Definition */
+    nodes: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodEnum<["start", "end", "decision", "assignment", "loop", "create_record", "update_record", "delete_record", "get_record", "http_request", "script", "wait", "subflow"]>;
+        label: z.ZodString;
+        /** Node Configuration Options (Specific to type) */
+        config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        /** UI Position (for the canvas) */
+        position: z.ZodOptional<z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            x: number;
+            y: number;
+        }, {
+            x: number;
+            y: number;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        type: "script" | "start" | "end" | "decision" | "assignment" | "loop" | "create_record" | "update_record" | "delete_record" | "get_record" | "http_request" | "wait" | "subflow";
+        label: string;
+        id: string;
+        config?: Record<string, any> | undefined;
+        position?: {
+            x: number;
+            y: number;
+        } | undefined;
+    }, {
+        type: "script" | "start" | "end" | "decision" | "assignment" | "loop" | "create_record" | "update_record" | "delete_record" | "get_record" | "http_request" | "wait" | "subflow";
+        label: string;
+        id: string;
+        config?: Record<string, any> | undefined;
+        position?: {
+            x: number;
+            y: number;
+        } | undefined;
+    }>, "many">;
+    edges: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        source: z.ZodString;
+        target: z.ZodString;
+        /** Condition for this path (only for decision/branch nodes) */
+        condition: z.ZodOptional<z.ZodString>;
+        label: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        source: string;
+        target: string;
+        label?: string | undefined;
+        condition?: string | undefined;
+    }, {
+        id: string;
+        source: string;
+        target: string;
+        label?: string | undefined;
+        condition?: string | undefined;
+    }>, "many">;
+    /** Execution Config */
+    active: z.ZodDefault<z.ZodBoolean>;
+    runAs: z.ZodDefault<z.ZodEnum<["system", "user"]>>;
+}, "strip", z.ZodTypeAny, {
+    type: "schedule" | "autolaunched" | "record_change" | "screen" | "api";
+    label: string;
+    name: string;
+    active: boolean;
+    nodes: {
+        type: "script" | "start" | "end" | "decision" | "assignment" | "loop" | "create_record" | "update_record" | "delete_record" | "get_record" | "http_request" | "wait" | "subflow";
+        label: string;
+        id: string;
+        config?: Record<string, any> | undefined;
+        position?: {
+            x: number;
+            y: number;
+        } | undefined;
+    }[];
+    edges: {
+        id: string;
+        source: string;
+        target: string;
+        label?: string | undefined;
+        condition?: string | undefined;
+    }[];
+    runAs: "system" | "user";
+    description?: string | undefined;
+    variables?: {
+        type: string;
+        name: string;
+        isInput: boolean;
+        isOutput: boolean;
+    }[] | undefined;
+}, {
+    type: "schedule" | "autolaunched" | "record_change" | "screen" | "api";
+    label: string;
+    name: string;
+    nodes: {
+        type: "script" | "start" | "end" | "decision" | "assignment" | "loop" | "create_record" | "update_record" | "delete_record" | "get_record" | "http_request" | "wait" | "subflow";
+        label: string;
+        id: string;
+        config?: Record<string, any> | undefined;
+        position?: {
+            x: number;
+            y: number;
+        } | undefined;
+    }[];
+    edges: {
+        id: string;
+        source: string;
+        target: string;
+        label?: string | undefined;
+        condition?: string | undefined;
+    }[];
+    description?: string | undefined;
+    active?: boolean | undefined;
+    variables?: {
+        type: string;
+        name: string;
+        isInput?: boolean | undefined;
+        isOutput?: boolean | undefined;
+    }[] | undefined;
+    runAs?: "system" | "user" | undefined;
+}>;
+export type Flow = z.infer<typeof FlowSchema>;
+export type FlowNode = z.infer<typeof FlowNodeSchema>;
+export type FlowEdge = z.infer<typeof FlowEdgeSchema>;
+//# sourceMappingURL=flow.zod.d.ts.map

package/dist/data/flow.zod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow.zod.d.ts","sourceRoot":"","sources":["../../src/data/flow.zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,cAAc,6KAczB,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;EAK7B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,cAAc;;;;IAKzB,oDAAoD;;IAGpD,mCAAmC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEnC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,cAAc;;;;IAKzB,+DAA+D;;;;;;;;;;;;;;;EAI/D,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,UAAU;IACrB,eAAe;;;;IAKf,mBAAmB;;IAGnB,8BAA8B;;;;;;;;;;;;;;;;;IAG9B,uBAAuB;;;;;QAtCvB,oDAAoD;;QAGpD,mCAAmC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAanC,+DAA+D;;;;;;;;;;;;;;;;IA0B/D,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGvB,CAAC;AAEH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAC9C,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC"}

package/dist/data/flow.zod.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FlowSchema = exports.FlowEdgeSchema = exports.FlowNodeSchema = exports.FlowVariableSchema = exports.FlowNodeAction = void 0;
+const zod_1 = require("zod");
+/**
+ * Flow Node Types
+ */
+exports.FlowNodeAction = zod_1.z.enum([
+    'start', // Trigger
+    'end', // Return/Stop
+    'decision', // If/Else logic
+    'assignment', // Set Variable
+    'loop', // For Each
+    'create_record', // CRUD: Create
+    'update_record', // CRUD: Update
+    'delete_record', // CRUD: Delete
+    'get_record', // CRUD: Get/Query
+    'http_request', // Webhook/API Call
+    'script', // Custom Script (JS/TS)
+    'wait', // Delay/Sleep
+    'subflow' // Call another flow
+]);
+/**
+ * Flow Variable Schema
+ * Variables available within the flow execution context.
+ */
+exports.FlowVariableSchema = zod_1.z.object({
+    name: zod_1.z.string().describe('Variable name'),
+    type: zod_1.z.string().describe('Data type (text, number, boolean, object, list)'),
+    isInput: zod_1.z.boolean().default(false).describe('Is input parameter'),
+    isOutput: zod_1.z.boolean().default(false).describe('Is output parameter'),
+});
+/**
+ * Flow Node Schema
+ * A single step in the visual logic graph.
+ */
+exports.FlowNodeSchema = zod_1.z.object({
+    id: zod_1.z.string().describe('Node unique ID'),
+    type: exports.FlowNodeAction.describe('Action type'),
+    label: zod_1.z.string().describe('Node label'),
+    /** Node Configuration Options (Specific to type) */
+    config: zod_1.z.record(zod_1.z.any()).optional().describe('Node configuration'),
+    /** UI Position (for the canvas) */
+    position: zod_1.z.object({ x: zod_1.z.number(), y: zod_1.z.number() }).optional(),
+});
+/**
+ * Flow Edge Schema
+ * Connections between nodes.
+ */
+exports.FlowEdgeSchema = zod_1.z.object({
+    id: zod_1.z.string().describe('Edge unique ID'),
+    source: zod_1.z.string().describe('Source Node ID'),
+    target: zod_1.z.string().describe('Target Node ID'),
+    /** Condition for this path (only for decision/branch nodes) */
+    condition: zod_1.z.string().optional().describe('Expression returning boolean used for branching'),
+    label: zod_1.z.string().optional().describe('Label on the connector'),
+});
+/**
+ * Flow Schema
+ * Visual Business Logic Orchestration.
+ */
+exports.FlowSchema = zod_1.z.object({
+    /** Identity */
+    name: zod_1.z.string().regex(/^[a-z_][a-z0-9_]*$/).describe('Machine name'),
+    label: zod_1.z.string().describe('Flow label'),
+    description: zod_1.z.string().optional(),
+    /** Trigger Type */
+    type: zod_1.z.enum(['autolaunched', 'record_change', 'schedule', 'screen', 'api']).describe('Flow type'),
+    /** Configuration Variables */
+    variables: zod_1.z.array(exports.FlowVariableSchema).optional().describe('Flow variables'),
+    /** Graph Definition */
+    nodes: zod_1.z.array(exports.FlowNodeSchema).describe('Flow nodes'),
+    edges: zod_1.z.array(exports.FlowEdgeSchema).describe('Flow connections'),
+    /** Execution Config */
+    active: zod_1.z.boolean().default(false).describe('Is active'),
+    runAs: zod_1.z.enum(['system', 'user']).default('user').describe('Execution context'),
+});