@xyne/workflow-sdk 3.2.37 → 3.2.38

package/dist/connectors/builtin/steps/conditional.step.js

@@ -0,0 +1,82 @@
+/**
+ * CONDITIONAL step — branch on a recursive {@link Condition} AST.
+ *
+ * BaseControlFlowStep with two branches: `if_true` and `if_false`.
+ *
+ *   evaluator.evaluate(config.condition, ctx.workflow)
+ *     true  → walk `if_true`  → output.branch = 'if_true'
+ *     false → walk `if_false` → output.branch = 'if_false'
+ *             (no-op when `if_false` is omitted → output.branch = 'none')
+ *
+ * The condition evaluator + variable resolver already understand `{{...}}`
+ * refs and the operator catalog, so a leaf condition like
+ *
+ *   { variable: 'steps.fetch.output.status', operator: '==', value: 200 }
+ *
+ * works without any per-step parsing here.
+ *
+ * Pause/resume inside either branch is handled by the executor's
+ * `walkBranchSteps` — same mechanism the PARALLEL and LOOP steps rely on.
+ */
+import { z } from 'zod';
+import { BaseControlFlowStep, collectBranchSteps } from '../../../steps/base-step.js';
+import { BuiltinStepType } from '../../../types/known-types.js';
+import { ConditionSchema } from '../../../types/workflow-config.js';
+import { ConditionEvaluator } from '../../../engine/condition-evaluator.js';
+// ─── Config ───
+export const ConditionalStepConfigSchema = z.object({
+    condition: ConditionSchema
+        .describe('Recursive condition tree. Leaf nodes reference {{variables}} and apply operators; `all`/`any` compose children.'),
+    if_true: z.array(z.object({ id: z.string(), type: z.string() }).passthrough()).describe('Steps to execute when the condition resolves true'),
+    if_false: z.array(z.object({ id: z.string(), type: z.string() }).passthrough()).optional().describe('Steps to execute when the condition resolves false. Omit to no-op on the false branch.'),
+});
+const ConditionalStepOutputSchema = z.object({
+    branch: z.enum(['if_true', 'if_false', 'none']),
+    evaluated: z.boolean(),
+    branches: z.record(z.object({ steps: z.record(z.object({ output: z.record(z.unknown()) })) })),
+});
+// ─── Step ───
+export class ConditionalStep extends BaseControlFlowStep {
+    type = BuiltinStepType.CONDITIONAL;
+    name = 'Conditional';
+    description = 'Branch execution based on a condition';
+    configSchema = ConditionalStepConfigSchema;
+    outputSchema = ConditionalStepOutputSchema;
+    category = 'control';
+    icon = 'fork';
+    declaredOutputs = [
+        { key: 'if_true', label: 'When true' },
+        { key: 'if_false', label: 'When false' },
+    ];
+    /** Allows config-validator to recursively validate nested branches. */
+    getBranches(config) {
+        return {
+            if_true: (config['if_true'] ?? []),
+            if_false: (config['if_false'] ?? []),
+        };
+    }
+    async execute(config, ctx) {
+        const evaluator = new ConditionEvaluator();
+        const evaluated = evaluator.evaluate(config.condition, ctx.workflow);
+        if (evaluated) {
+            const branchSteps = config.if_true;
+            await ctx.walkBranch(branchSteps, ctx.workflow, 'if_true');
+            return {
+                branch: 'if_true',
+                evaluated: true,
+                branches: { if_true: { steps: collectBranchSteps(branchSteps, ctx.workflow) } },
+            };
+        }
+        if (config.if_false && config.if_false.length > 0) {
+            const branchSteps = config.if_false;
+            await ctx.walkBranch(branchSteps, ctx.workflow, 'if_false');
+            return {
+                branch: 'if_false',
+                evaluated: false,
+                branches: { if_false: { steps: collectBranchSteps(branchSteps, ctx.workflow) } },
+            };
+        }
+        return { branch: 'none', evaluated: false, branches: {} };
+    }
+}
+//# sourceMappingURL=conditional.step.js.map

package/dist/connectors/builtin/steps/conditional.step.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conditional.step.js","sourceRoot":"","sources":["../../../../src/connectors/builtin/steps/conditional.step.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEtF,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAEhE,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAE5E,iBAAiB;AAEjB,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,SAAS,EAAE,eAAe;SACvB,QAAQ,CAAC,iHAAiH,CAAC;IAC9H,OAAO,EAAE,CAAC,CAAC,KAAK,CACd,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAC7D,CAAC,QAAQ,CAAC,mDAAmD,CAAC;IAC/D,QAAQ,EAAE,CAAC,CAAC,KAAK,CACf,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAC7D,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wFAAwF,CAAC;CAChH,CAAC,CAAC;AAoBH,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IAC/C,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE;IACtB,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;CAC/F,CAAC,CAAC;AAEH,eAAe;AAEf,MAAM,OAAO,eAAgB,SAAQ,mBAGpC;IACmB,IAAI,GAAG,eAAe,CAAC,WAAW,CAAC;IACnC,IAAI,GAAG,aAAa,CAAC;IACrB,WAAW,GAAG,uCAAuC,CAAC;IACtD,YAAY,GAAG,2BAA2B,CAAC;IAC3C,YAAY,GAAG,2BAA2B,CAAC;IAC3C,QAAQ,GAAG,SAAkB,CAAC;IAC9B,IAAI,GAAG,MAAM,CAAC;IACd,eAAe,GAAG;QAClC,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE;QACtC,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,YAAY,EAAE;KAChC,CAAC;IAEX,uEAAuE;IAC9D,WAAW,CAClB,MAA+B;QAE/B,OAAO;YACL,OAAO,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,CAAyB;YAC1D,QAAQ,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,CAAyB;SAC7D,CAAC;IACJ,CAAC;IAEQ,KAAK,CAAC,OAAO,CACpB,MAA6B,EAC7B,GAAgC;QAEhC,MAAM,SAAS,GAAG,IAAI,kBAAkB,EAAE,CAAC;QAC3C,MAAM,SAAS,GAAG,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC;QAErE,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,WAAW,GAAG,MAAM,CAAC,OAA0C,CAAC;YACtE,MAAM,GAAG,CAAC,UAAU,CAAC,WAAW,EAAE,GAAG,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;YAC3D,OAAO;gBACL,MAAM,EAAE,SAAS;gBACjB,SAAS,EAAE,IAAI;gBACf,QAAQ,EAAE,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,kBAAkB,CAAC,WAAW,EAAE,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE;aAChF,CAAC;QACJ,CAAC;QAED,IAAI,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClD,MAAM,WAAW,GAAG,MAAM,CAAC,QAA2C,CAAC;YACvE,MAAM,GAAG,CAAC,UAAU,CAAC,WAAW,EAAE,GAAG,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;YAC5D,OAAO;gBACL,MAAM,EAAE,UAAU;gBAClB,SAAS,EAAE,KAAK;gBAChB,QAAQ,EAAE,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,kBAAkB,CAAC,WAAW,EAAE,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE;aACjF,CAAC;QACJ,CAAC;QAED,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IAC5D,CAAC;CACF"}

package/dist/connectors/builtin/steps/dedup.step.d.ts

@@ -0,0 +1,65 @@
+/**
+ * DEDUP step — deduplication via ctx.staticData.
+ *
+ * Checks whether a key (derived from the current context) has been
+ * seen before. If it has, marks the output as `duplicate: true` so
+ * downstream steps/conditions can skip processing.
+ *
+ * Uses `ctx.staticData` for persistence — keys survive across executions.
+ * Optional TTL: stored timestamps are compared against current time.
+ */
+import { z } from 'zod';
+import { BaseActionStep } from '../../../steps/base-step.js';
+import type { StepExecutionContext } from '../../../steps/base-step.js';
+import { BuiltinStepType } from '../../../types/known-types.js';
+import type { StepCategory } from '../../../types/categories.js';
+export declare const DedupStepConfigSchema: z.ZodObject<{
+    keyPath: z.ZodString;
+    ttlMs: z.ZodOptional<z.ZodNumber>;
+    keyPrefix: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    keyPath: string;
+    keyPrefix: string;
+    ttlMs?: number | undefined;
+}, {
+    keyPath: string;
+    ttlMs?: number | undefined;
+    keyPrefix?: string | undefined;
+}>;
+export type DedupStepConfig = z.infer<typeof DedupStepConfigSchema>;
+export interface DedupStepOutput extends Record<string, unknown> {
+    duplicate: boolean;
+    key: string;
+}
+export declare class DedupStep extends BaseActionStep<typeof DedupStepConfigSchema, DedupStepOutput> {
+    readonly type = BuiltinStepType.DEDUP;
+    readonly name = "Dedup";
+    readonly description = "Skip duplicate items using persistent key tracking";
+    readonly configSchema: z.ZodObject<{
+        keyPath: z.ZodString;
+        ttlMs: z.ZodOptional<z.ZodNumber>;
+        keyPrefix: z.ZodDefault<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        keyPath: string;
+        keyPrefix: string;
+        ttlMs?: number | undefined;
+    }, {
+        keyPath: string;
+        ttlMs?: number | undefined;
+        keyPrefix?: string | undefined;
+    }>;
+    readonly outputSchema: z.ZodObject<{
+        duplicate: z.ZodBoolean;
+        key: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        key: string;
+        duplicate: boolean;
+    }, {
+        key: string;
+        duplicate: boolean;
+    }>;
+    readonly category: StepCategory;
+    readonly icon = "copy-check";
+    execute(config: DedupStepConfig, ctx: StepExecutionContext): Promise<DedupStepOutput>;
+}
+//# sourceMappingURL=dedup.step.d.ts.map

package/dist/connectors/builtin/steps/dedup.step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dedup.step.d.ts","sourceRoot":"","sources":["../../../../src/connectors/builtin/steps/dedup.step.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAKjE,eAAO,MAAM,qBAAqB;;;;;;;;;;;;EAIhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAIpE,MAAM,WAAW,eAAgB,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC9D,SAAS,EAAE,OAAO,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;CACb;AASD,qBAAa,SAAU,SAAQ,cAAc,CAC3C,OAAO,qBAAqB,EAC5B,eAAe,CAChB;IACC,SAAkB,IAAI,yBAAyB;IAC/C,SAAkB,IAAI,WAAW;IACjC,SAAkB,WAAW,wDAAwD;IACrF,SAAkB,YAAY;;;;;;;;;;;;OAAyB;IACvD,SAAkB,YAAY;;;;;;;;;OAAyB;IACvD,SAAkB,QAAQ,EAAE,YAAY,CAAU;IAClD,SAAkB,IAAI,gBAAgB;IAEvB,OAAO,CACpB,MAAM,EAAE,eAAe,EACvB,GAAG,EAAE,oBAAoB,GACxB,OAAO,CAAC,eAAe,CAAC;CAmC5B"}

package/dist/connectors/builtin/steps/dedup.step.js

@@ -0,0 +1,61 @@
+/**
+ * DEDUP step — deduplication via ctx.staticData.
+ *
+ * Checks whether a key (derived from the current context) has been
+ * seen before. If it has, marks the output as `duplicate: true` so
+ * downstream steps/conditions can skip processing.
+ *
+ * Uses `ctx.staticData` for persistence — keys survive across executions.
+ * Optional TTL: stored timestamps are compared against current time.
+ */
+import { z } from 'zod';
+import { BaseActionStep } from '../../../steps/base-step.js';
+import { BuiltinStepType } from '../../../types/known-types.js';
+import { resolvePath } from '../../../engine/variable-resolver.js';
+// ─── Config ───
+export const DedupStepConfigSchema = z.object({
+    keyPath: z.string().min(1).describe('Dotted path to the deduplication key in the workflow context'),
+    ttlMs: z.number().int().positive().optional().describe('Time-to-live in milliseconds. Keys older than this are treated as new'),
+    keyPrefix: z.string().default('dedup:').describe('Prefix for the storage key to avoid collisions'),
+});
+const DedupStepOutputSchema = z.object({
+    duplicate: z.boolean(),
+    key: z.string(),
+});
+// ─── Step ───
+export class DedupStep extends BaseActionStep {
+    type = BuiltinStepType.DEDUP;
+    name = 'Dedup';
+    description = 'Skip duplicate items using persistent key tracking';
+    configSchema = DedupStepConfigSchema;
+    outputSchema = DedupStepOutputSchema;
+    category = 'data';
+    icon = 'copy-check';
+    async execute(config, ctx) {
+        // Resolve the dedup key from context
+        const rawKey = resolvePath(ctx.workflow, config.keyPath);
+        if (rawKey === undefined || rawKey === null) {
+            throw new Error(`DEDUP keyPath "${config.keyPath}" resolved to ${String(rawKey)}`);
+        }
+        const key = `${config.keyPrefix}${String(rawKey)}`;
+        // Check if key exists in staticData
+        const existing = (await ctx.staticData.get(key));
+        if (existing !== undefined) {
+            // Check TTL if configured
+            if (config.ttlMs !== undefined) {
+                const age = Date.now() - existing.seenAt;
+                if (age < config.ttlMs) {
+                    return { duplicate: true, key };
+                }
+                // Expired — treat as new, fall through to record
+            }
+            else {
+                return { duplicate: true, key };
+            }
+        }
+        // Record the key
+        await ctx.staticData.set(key, { seenAt: Date.now() });
+        return { duplicate: false, key };
+    }
+}
+//# sourceMappingURL=dedup.step.js.map

package/dist/connectors/builtin/steps/dedup.step.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dedup.step.js","sourceRoot":"","sources":["../../../../src/connectors/builtin/steps/dedup.step.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE7D,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAEhE,OAAO,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AAEnE,iBAAiB;AAEjB,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,8DAA8D,CAAC;IACnG,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uEAAuE,CAAC;IAC/H,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,gDAAgD,CAAC;CACnG,CAAC,CAAC;AAWH,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE;IACtB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;CAChB,CAAC,CAAC;AAEH,eAAe;AAEf,MAAM,OAAO,SAAU,SAAQ,cAG9B;IACmB,IAAI,GAAG,eAAe,CAAC,KAAK,CAAC;IAC7B,IAAI,GAAG,OAAO,CAAC;IACf,WAAW,GAAG,oDAAoD,CAAC;IACnE,YAAY,GAAG,qBAAqB,CAAC;IACrC,YAAY,GAAG,qBAAqB,CAAC;IACrC,QAAQ,GAAiB,MAAM,CAAC;IAChC,IAAI,GAAG,YAAY,CAAC;IAE7B,KAAK,CAAC,OAAO,CACpB,MAAuB,EACvB,GAAyB;QAEzB,qCAAqC;QACrC,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;QAEzD,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YAC5C,MAAM,IAAI,KAAK,CACb,kBAAkB,MAAM,CAAC,OAAO,iBAAiB,MAAM,CAAC,MAAM,CAAC,EAAE,CAClE,CAAC;QACJ,CAAC;QAED,MAAM,GAAG,GAAG,GAAG,MAAM,CAAC,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QAEnD,oCAAoC;QACpC,MAAM,QAAQ,GAAG,CAAC,MAAM,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAElC,CAAC;QAEd,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,0BAA0B;YAC1B,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;gBAC/B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAC;gBACzC,IAAI,GAAG,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC;oBACvB,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;gBAClC,CAAC;gBACD,iDAAiD;YACnD,CAAC;iBAAM,CAAC;gBACN,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;YAClC,CAAC;QACH,CAAC;QAED,iBAAiB;QACjB,MAAM,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAEtD,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;IACnC,CAAC;CACF"}