@fluidgrids/workflows 0.0.0-stage → 2026.1027.0

package/dist/types-Dr2Fn1Ax.d.cts

@@ -0,0 +1,225 @@
+/**
+ * Workflow IR, schema version 2 (spec 01).
+ *
+ * Version 2 is a strict superset of what the builder saves today: every stored
+ * definition (no `schemaVersion`, legacy mirrors under `data`, `config` on
+ * internal nodes) is a valid version-2 document. The canonical fields are typed
+ * here; anything else a stored definition carries is kept verbatim through the
+ * index signatures so a round trip never drops data.
+ */
+/** Any JSON value. */
+type Json = null | boolean | number | string | Json[] | {
+    [key: string]: Json;
+};
+/** A JSON object. */
+type JsonObject = {
+    [key: string]: Json;
+};
+/** Error types shared by node error policies and code activities. */
+type ErrorType = 'TIMEOUT' | 'TRANSIENT' | 'DEPENDENCY' | 'AUTHORIZATION' | 'VALIDATION' | 'PERMANENT' | 'UNKNOWN';
+/** A node position on the canvas. */
+interface Position {
+    x: number;
+    y: number;
+}
+/** Retry policy of a node (`errorConfig.retryConfig`). */
+interface RetryConfig {
+    maxRetries: number;
+    retryDelay: number;
+    backoffMultiplier?: number;
+    maxDelay?: number;
+    retryOnErrorTypes?: ErrorType[];
+    nonRetryableErrorTypes?: string[];
+    [key: string]: unknown;
+}
+/** Per-node timeout (`errorConfig.timeout`). */
+interface NodeTimeout {
+    duration: number;
+    onTimeout?: 'stop' | 'continue' | 'branch';
+    timeoutBranchId?: string;
+    [key: string]: unknown;
+}
+/** Node error policy, read by the executor from `errorConfig`. */
+interface NodeErrorConfig {
+    onError?: 'stop' | 'continue' | 'branch';
+    errorBranchId?: string;
+    retryConfig?: RetryConfig;
+    timeout?: NodeTimeout;
+    [key: string]: unknown;
+}
+/** Where a node runs: FluidGrids Cloud (absent) or a registered runner. */
+interface RunOnSetting {
+    kind: string;
+    runnerId?: string;
+    [key: string]: unknown;
+}
+/** Builder execution settings. */
+interface ExecutionSettings {
+    alwaysOutputData?: boolean;
+    executeOnce?: boolean;
+    runOn?: RunOnSetting;
+    [key: string]: unknown;
+}
+/** A connection reference (connections are owned by wspace-integrations-svc). */
+interface ConnectionRef {
+    connectionId: string;
+    adapter: string;
+    [key: string]: unknown;
+}
+/** A legacy credential reference (`args.credentials`, deprecated). */
+interface LegacyCredentialRef {
+    id: string;
+    adapter: string;
+    [key: string]: unknown;
+}
+/** Node arguments. */
+interface NodeArgs {
+    state?: JsonObject;
+    context?: JsonObject;
+    connections?: ConnectionRef[];
+    credentials?: LegacyCredentialRef[];
+    [key: string]: unknown;
+}
+/** One workflow node. */
+interface WorkflowNode {
+    id: string;
+    type: string;
+    label?: string;
+    position?: Position;
+    operation_name?: string;
+    version?: string;
+    args?: NodeArgs;
+    errorConfig?: NodeErrorConfig;
+    executionSettings?: ExecutionSettings;
+    disabled?: boolean;
+    /** Builder UI bag. Legacy mirrors of the canonical fields may live here. */
+    data?: JsonObject;
+    /** Legacy parameter mirror (internal nodes read it below `args.state`). */
+    config?: JsonObject;
+    [key: string]: unknown;
+}
+/** One workflow edge. */
+interface WorkflowEdge {
+    /** Absent on some API-created definitions; the builder and canvas always write one. */
+    id?: string;
+    source: string;
+    target: string;
+    sourceHandle?: string;
+    targetHandle?: string;
+    type?: string;
+    label?: string;
+    data?: JsonObject;
+    mapping?: JsonObject;
+    [key: string]: unknown;
+}
+/** The typed contract of a workflow (spec 01 §4). */
+interface WorkflowInterface {
+    input?: JsonObject;
+    output?: JsonObject;
+    signals?: {
+        [name: string]: {
+            payload?: JsonObject;
+            [key: string]: unknown;
+        };
+    };
+    queries?: {
+        [name: string]: {
+            args?: JsonObject;
+            result?: JsonObject;
+            [key: string]: unknown;
+        };
+    };
+    updates?: {
+        [name: string]: {
+            args?: JsonObject;
+            result?: JsonObject;
+            [key: string]: unknown;
+        };
+    };
+    open?: {
+        signals?: boolean;
+        queries?: boolean;
+        updates?: boolean;
+    };
+    [key: string]: unknown;
+}
+/** One export of a code bundle. */
+interface CodeBundleWorkflowExport {
+    interface?: WorkflowInterface;
+    taskQueue?: string;
+    [key: string]: unknown;
+}
+/** A user activity declared by a code bundle. */
+interface CodeBundleActivityExport {
+    taskQueue?: string;
+    input?: JsonObject;
+    output?: JsonObject;
+    [key: string]: unknown;
+}
+/** The code bundle attached to a version (spec 01 §5). */
+interface WorkflowCode {
+    language: 'typescript' | 'python';
+    sdk?: string;
+    buildId: string;
+    bundleRef?: string;
+    sourceRef?: string;
+    entry?: string;
+    exports?: {
+        workflows?: {
+            [name: string]: CodeBundleWorkflowExport;
+        };
+        activities?: {
+            [name: string]: CodeBundleActivityExport;
+        };
+    };
+    determinism?: 'isolate' | 'worker';
+    [key: string]: unknown;
+}
+/** How a document was produced (spec 01 §6). Never affects execution. */
+interface WorkflowAuthoring {
+    mode?: 'canvas' | 'code' | 'hybrid';
+    generator?: 'builder' | 'sdk-ts' | 'sdk-py' | 'ai' | 'import' | 'lift';
+    generatorVersion?: string;
+    sourceHash?: string;
+    liftedFrom?: {
+        workflowKey?: string;
+        version?: string;
+        fidelity?: 'lossless' | 'lossy';
+    };
+    [key: string]: unknown;
+}
+/** Run-level settings. */
+interface WorkflowConfig {
+    maxParallelism?: number;
+    /** Run timeout in seconds. */
+    timeout?: number;
+    /** Chain deadline in seconds or a duration string (v2). */
+    executionTimeout?: number | string;
+    /** Workflow-task budget in seconds or a duration string (v2). */
+    workflowTaskTimeout?: number | string;
+    versioningBehavior?: 'PINNED' | 'AUTO_UPGRADE';
+    [key: string]: unknown;
+}
+/** The canonical workflow definition (`definitionJson`). */
+interface WorkflowDefinition {
+    schemaVersion?: 1 | 2;
+    key?: string;
+    name?: string;
+    description?: string;
+    interface?: WorkflowInterface;
+    code?: WorkflowCode;
+    authoring?: WorkflowAuthoring;
+    data: {
+        nodes: WorkflowNode[];
+        edges: WorkflowEdge[];
+        stickyNotes?: JsonObject[];
+        [key: string]: unknown;
+    };
+    config?: WorkflowConfig;
+    pinnedData?: JsonObject;
+    meta?: JsonObject;
+    tags?: Json[];
+    [key: string]: unknown;
+}
+
+export type { CodeBundleActivityExport as C, ErrorType as E, Json as J, LegacyCredentialRef as L, NodeArgs as N, Position as P, RetryConfig as R, WorkflowDefinition as W, JsonObject as a, WorkflowInterface as b, CodeBundleWorkflowExport as c, ConnectionRef as d, ExecutionSettings as e, NodeErrorConfig as f, NodeTimeout as g, RunOnSetting as h, WorkflowAuthoring as i, WorkflowCode as j, WorkflowConfig as k, WorkflowEdge as l, WorkflowNode as m };

package/dist/types-Dr2Fn1Ax.d.ts

@@ -0,0 +1,225 @@
+/**
+ * Workflow IR, schema version 2 (spec 01).
+ *
+ * Version 2 is a strict superset of what the builder saves today: every stored
+ * definition (no `schemaVersion`, legacy mirrors under `data`, `config` on
+ * internal nodes) is a valid version-2 document. The canonical fields are typed
+ * here; anything else a stored definition carries is kept verbatim through the
+ * index signatures so a round trip never drops data.
+ */
+/** Any JSON value. */
+type Json = null | boolean | number | string | Json[] | {
+    [key: string]: Json;
+};
+/** A JSON object. */
+type JsonObject = {
+    [key: string]: Json;
+};
+/** Error types shared by node error policies and code activities. */
+type ErrorType = 'TIMEOUT' | 'TRANSIENT' | 'DEPENDENCY' | 'AUTHORIZATION' | 'VALIDATION' | 'PERMANENT' | 'UNKNOWN';
+/** A node position on the canvas. */
+interface Position {
+    x: number;
+    y: number;
+}
+/** Retry policy of a node (`errorConfig.retryConfig`). */
+interface RetryConfig {
+    maxRetries: number;
+    retryDelay: number;
+    backoffMultiplier?: number;
+    maxDelay?: number;
+    retryOnErrorTypes?: ErrorType[];
+    nonRetryableErrorTypes?: string[];
+    [key: string]: unknown;
+}
+/** Per-node timeout (`errorConfig.timeout`). */
+interface NodeTimeout {
+    duration: number;
+    onTimeout?: 'stop' | 'continue' | 'branch';
+    timeoutBranchId?: string;
+    [key: string]: unknown;
+}
+/** Node error policy, read by the executor from `errorConfig`. */
+interface NodeErrorConfig {
+    onError?: 'stop' | 'continue' | 'branch';
+    errorBranchId?: string;
+    retryConfig?: RetryConfig;
+    timeout?: NodeTimeout;
+    [key: string]: unknown;
+}
+/** Where a node runs: FluidGrids Cloud (absent) or a registered runner. */
+interface RunOnSetting {
+    kind: string;
+    runnerId?: string;
+    [key: string]: unknown;
+}
+/** Builder execution settings. */
+interface ExecutionSettings {
+    alwaysOutputData?: boolean;
+    executeOnce?: boolean;
+    runOn?: RunOnSetting;
+    [key: string]: unknown;
+}
+/** A connection reference (connections are owned by wspace-integrations-svc). */
+interface ConnectionRef {
+    connectionId: string;
+    adapter: string;
+    [key: string]: unknown;
+}
+/** A legacy credential reference (`args.credentials`, deprecated). */
+interface LegacyCredentialRef {
+    id: string;
+    adapter: string;
+    [key: string]: unknown;
+}
+/** Node arguments. */
+interface NodeArgs {
+    state?: JsonObject;
+    context?: JsonObject;
+    connections?: ConnectionRef[];
+    credentials?: LegacyCredentialRef[];
+    [key: string]: unknown;
+}
+/** One workflow node. */
+interface WorkflowNode {
+    id: string;
+    type: string;
+    label?: string;
+    position?: Position;
+    operation_name?: string;
+    version?: string;
+    args?: NodeArgs;
+    errorConfig?: NodeErrorConfig;
+    executionSettings?: ExecutionSettings;
+    disabled?: boolean;
+    /** Builder UI bag. Legacy mirrors of the canonical fields may live here. */
+    data?: JsonObject;
+    /** Legacy parameter mirror (internal nodes read it below `args.state`). */
+    config?: JsonObject;
+    [key: string]: unknown;
+}
+/** One workflow edge. */
+interface WorkflowEdge {
+    /** Absent on some API-created definitions; the builder and canvas always write one. */
+    id?: string;
+    source: string;
+    target: string;
+    sourceHandle?: string;
+    targetHandle?: string;
+    type?: string;
+    label?: string;
+    data?: JsonObject;
+    mapping?: JsonObject;
+    [key: string]: unknown;
+}
+/** The typed contract of a workflow (spec 01 §4). */
+interface WorkflowInterface {
+    input?: JsonObject;
+    output?: JsonObject;
+    signals?: {
+        [name: string]: {
+            payload?: JsonObject;
+            [key: string]: unknown;
+        };
+    };
+    queries?: {
+        [name: string]: {
+            args?: JsonObject;
+            result?: JsonObject;
+            [key: string]: unknown;
+        };
+    };
+    updates?: {
+        [name: string]: {
+            args?: JsonObject;
+            result?: JsonObject;
+            [key: string]: unknown;
+        };
+    };
+    open?: {
+        signals?: boolean;
+        queries?: boolean;
+        updates?: boolean;
+    };
+    [key: string]: unknown;
+}
+/** One export of a code bundle. */
+interface CodeBundleWorkflowExport {
+    interface?: WorkflowInterface;
+    taskQueue?: string;
+    [key: string]: unknown;
+}
+/** A user activity declared by a code bundle. */
+interface CodeBundleActivityExport {
+    taskQueue?: string;
+    input?: JsonObject;
+    output?: JsonObject;
+    [key: string]: unknown;
+}
+/** The code bundle attached to a version (spec 01 §5). */
+interface WorkflowCode {
+    language: 'typescript' | 'python';
+    sdk?: string;
+    buildId: string;
+    bundleRef?: string;
+    sourceRef?: string;
+    entry?: string;
+    exports?: {
+        workflows?: {
+            [name: string]: CodeBundleWorkflowExport;
+        };
+        activities?: {
+            [name: string]: CodeBundleActivityExport;
+        };
+    };
+    determinism?: 'isolate' | 'worker';
+    [key: string]: unknown;
+}
+/** How a document was produced (spec 01 §6). Never affects execution. */
+interface WorkflowAuthoring {
+    mode?: 'canvas' | 'code' | 'hybrid';
+    generator?: 'builder' | 'sdk-ts' | 'sdk-py' | 'ai' | 'import' | 'lift';
+    generatorVersion?: string;
+    sourceHash?: string;
+    liftedFrom?: {
+        workflowKey?: string;
+        version?: string;
+        fidelity?: 'lossless' | 'lossy';
+    };
+    [key: string]: unknown;
+}
+/** Run-level settings. */
+interface WorkflowConfig {
+    maxParallelism?: number;
+    /** Run timeout in seconds. */
+    timeout?: number;
+    /** Chain deadline in seconds or a duration string (v2). */
+    executionTimeout?: number | string;
+    /** Workflow-task budget in seconds or a duration string (v2). */
+    workflowTaskTimeout?: number | string;
+    versioningBehavior?: 'PINNED' | 'AUTO_UPGRADE';
+    [key: string]: unknown;
+}
+/** The canonical workflow definition (`definitionJson`). */
+interface WorkflowDefinition {
+    schemaVersion?: 1 | 2;
+    key?: string;
+    name?: string;
+    description?: string;
+    interface?: WorkflowInterface;
+    code?: WorkflowCode;
+    authoring?: WorkflowAuthoring;
+    data: {
+        nodes: WorkflowNode[];
+        edges: WorkflowEdge[];
+        stickyNotes?: JsonObject[];
+        [key: string]: unknown;
+    };
+    config?: WorkflowConfig;
+    pinnedData?: JsonObject;
+    meta?: JsonObject;
+    tags?: Json[];
+    [key: string]: unknown;
+}
+
+export type { CodeBundleActivityExport as C, ErrorType as E, Json as J, LegacyCredentialRef as L, NodeArgs as N, Position as P, RetryConfig as R, WorkflowDefinition as W, JsonObject as a, WorkflowInterface as b, CodeBundleWorkflowExport as c, ConnectionRef as d, ExecutionSettings as e, NodeErrorConfig as f, NodeTimeout as g, RunOnSetting as h, WorkflowAuthoring as i, WorkflowCode as j, WorkflowConfig as k, WorkflowEdge as l, WorkflowNode as m };

package/package.json

@@ -1,6 +1,119 @@
 {
   "name": "@fluidgrids/workflows",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "2026.1027.0",
+  "description": "Author FluidGrids workflows as code: the IR v2 schema and tools, the tier-1 graph builder, lift and lower between canvas JSON, TypeScript and Python, and typed node client generation.",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./ir": {
+      "types": "./dist/ir/index.d.ts",
+      "import": "./dist/ir/index.js",
+      "require": "./dist/ir/index.cjs"
+    },
+    "./roundtrip": {
+      "types": "./dist/roundtrip/index.d.ts",
+      "import": "./dist/roundtrip/index.js",
+      "require": "./dist/roundtrip/index.cjs"
+    },
+    "./codegen": {
+      "types": "./dist/codegen/index.d.ts",
+      "import": "./dist/codegen/index.js",
+      "require": "./dist/codegen/index.cjs"
+    },
+    "./quickjs": {
+      "types": "./dist/quickjs/index.d.ts",
+      "import": "./dist/quickjs/index.js",
+      "require": "./dist/quickjs/index.cjs"
+    },
+    "./schema/ir-v2.schema.json": "./schema/ir-v2.schema.json",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "schema",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "generate": "bun scripts/generate.ts",
+    "build": "bun run generate && tsup",
+    "dev": "bun run generate && TSUP_DEV=1 tsup --watch",
+    "test": "bun run generate && bash scripts/build-limits.sh vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "bun run generate && bash scripts/build-limits.sh vitest run --coverage",
+    "lint": "bun run generate && eslint src/ tests/ scripts/",
+    "lint:fix": "eslint src/ tests/ scripts/ --fix",
+    "lint:check": "bun run lint",
+    "format": "prettier --write \"src/**/*.ts\" \"tests/**/*.ts\" \"scripts/**/*.ts\" \"*.{json,md}\"",
+    "format:check": "prettier --check \"src/**/*.ts\" \"tests/**/*.ts\" \"scripts/**/*.ts\" \"*.{json,md}\"",
+    "typecheck": "bun run generate && bash scripts/build-limits.sh tsc --noEmit -p tsconfig.json && bash scripts/build-limits.sh tsc -p tsconfig.test.json && bash scripts/build-limits.sh tsc -p tsconfig.fixtures.json",
+    "check:fixtures": "bun scripts/check-fixtures.ts",
+    "sanity": "bash scripts/build-limits.sh --gate bash -c 'bun run format:check && bun run lint:check && bun run typecheck && bun run test:coverage && bun run build && bun run check:fixtures'",
+    "prepublishOnly": "bun run build",
+    "clean": "rm -rf dist coverage src/generated"
+  },
+  "keywords": [
+    "fluidgrids",
+    "workflow",
+    "workflow-as-code",
+    "automation",
+    "sdk",
+    "typescript"
+  ],
+  "author": {
+    "name": "FluidGrids",
+    "email": "info@fluidgrids.ai",
+    "url": "https://fluidgrids.ai"
+  },
+  "license": "UNLICENSED",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Algoshred/fluidgrids-workflows-sdk-node.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Algoshred/fluidgrids-workflows-sdk-node/issues"
+  },
+  "homepage": "https://github.com/Algoshred/fluidgrids-workflows-sdk-node#readme",
+  "engines": {
+    "node": ">=22.0.0",
+    "bun": ">=1.3.10"
+  },
+  "dependencies": {
+    "ajv": "8.20.0",
+    "cron-parser": "5.10.2",
+    "esbuild": "0.28.2",
+    "prettier": "3.8.3",
+    "quickjs-emscripten": "0.32.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.12.2",
+    "@typescript-eslint/eslint-plugin": "^8.58.0",
+    "@typescript-eslint/parser": "^8.58.0",
+    "@vitest/coverage-v8": "5.0.4",
+    "esbuild-wasm": "0.28.2",
+    "eslint": "^9.39.4",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.5",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "5.0.4"
+  },
+  "trustedDependencies": [
+    "esbuild"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "overrides": {
+    "esbuild": "0.28.2"
+  }
+}