@xyne/workflow-sdk 1.0.0

package/dist/steps/builtin/conditional.step.d.ts

@@ -0,0 +1,146 @@
+/**
+ * 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 } from '../base-step.js';
+import type { ControlFlowExecutionContext } from '../base-step.js';
+import { BuiltinStepType } from '../../types/known-types.js';
+import type { WorkflowStepConfig } from '../../types/workflow-config.js';
+export declare const ConditionalStepConfigSchema: z.ZodObject<{
+    condition: z.ZodType<import("../../types/workflow-config.js").Condition, z.ZodTypeDef, import("../../types/workflow-config.js").Condition>;
+    if_true: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodString;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        id: z.ZodString;
+        type: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        id: z.ZodString;
+        type: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">>, "many">;
+    if_false: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodString;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        id: z.ZodString;
+        type: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        id: z.ZodString;
+        type: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    condition: import("../../types/workflow-config.js").Condition;
+    if_true: z.objectOutputType<{
+        id: z.ZodString;
+        type: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">[];
+    if_false?: z.objectOutputType<{
+        id: z.ZodString;
+        type: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">[] | undefined;
+}, {
+    condition: import("../../types/workflow-config.js").Condition;
+    if_true: z.objectInputType<{
+        id: z.ZodString;
+        type: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">[];
+    if_false?: z.objectInputType<{
+        id: z.ZodString;
+        type: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">[] | undefined;
+}>;
+export type ConditionalStepConfig = z.infer<typeof ConditionalStepConfigSchema>;
+export interface ConditionalStepOutput extends Record<string, unknown> {
+    /** Which branch executed. `'none'` when condition was false and `if_false` was omitted. */
+    branch: 'if_true' | 'if_false' | 'none';
+    /** The boolean result of evaluating the condition. */
+    evaluated: boolean;
+}
+export declare class ConditionalStep extends BaseControlFlowStep<typeof ConditionalStepConfigSchema, ConditionalStepOutput> {
+    readonly type = BuiltinStepType.CONDITIONAL;
+    readonly name = "Conditional";
+    readonly description = "Branch execution based on a condition";
+    readonly configSchema: z.ZodObject<{
+        condition: z.ZodType<import("../../types/workflow-config.js").Condition, z.ZodTypeDef, import("../../types/workflow-config.js").Condition>;
+        if_true: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            type: z.ZodString;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            id: z.ZodString;
+            type: z.ZodString;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            id: z.ZodString;
+            type: z.ZodString;
+        }, z.ZodTypeAny, "passthrough">>, "many">;
+        if_false: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            type: z.ZodString;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            id: z.ZodString;
+            type: z.ZodString;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            id: z.ZodString;
+            type: z.ZodString;
+        }, z.ZodTypeAny, "passthrough">>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        condition: import("../../types/workflow-config.js").Condition;
+        if_true: z.objectOutputType<{
+            id: z.ZodString;
+            type: z.ZodString;
+        }, z.ZodTypeAny, "passthrough">[];
+        if_false?: z.objectOutputType<{
+            id: z.ZodString;
+            type: z.ZodString;
+        }, z.ZodTypeAny, "passthrough">[] | undefined;
+    }, {
+        condition: import("../../types/workflow-config.js").Condition;
+        if_true: z.objectInputType<{
+            id: z.ZodString;
+            type: z.ZodString;
+        }, z.ZodTypeAny, "passthrough">[];
+        if_false?: z.objectInputType<{
+            id: z.ZodString;
+            type: z.ZodString;
+        }, z.ZodTypeAny, "passthrough">[] | undefined;
+    }>;
+    readonly outputSchema: z.ZodObject<{
+        branch: z.ZodEnum<["if_true", "if_false", "none"]>;
+        evaluated: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        branch: "none" | "if_true" | "if_false";
+        evaluated: boolean;
+    }, {
+        branch: "none" | "if_true" | "if_false";
+        evaluated: boolean;
+    }>;
+    readonly category: "control";
+    readonly icon = "fork";
+    readonly declaredOutputs: readonly [{
+        readonly key: "if_true";
+        readonly label: "When true";
+    }, {
+        readonly key: "if_false";
+        readonly label: "When false";
+    }];
+    /** Allows config-validator to recursively validate nested branches. */
+    getBranches(config: Record<string, unknown>): Record<string, WorkflowStepConfig[]>;
+    execute(config: ConditionalStepConfig, ctx: ControlFlowExecutionContext): Promise<ConditionalStepOutput>;
+}
+//# sourceMappingURL=conditional.step.d.ts.map

package/dist/steps/builtin/conditional.step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conditional.step.d.ts","sourceRoot":"","sources":["../../../src/steps/builtin/conditional.step.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAMzE,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAStC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAIhF,MAAM,WAAW,qBAAsB,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACpE,2FAA2F;IAC3F,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;IACxC,sDAAsD;IACtD,SAAS,EAAE,OAAO,CAAC;CACpB;AASD,qBAAa,eAAgB,SAAQ,mBAAmB,CACtD,OAAO,2BAA2B,EAClC,qBAAqB,CACtB;IACC,SAAkB,IAAI,+BAA+B;IACrD,SAAkB,IAAI,iBAAiB;IACvC,SAAkB,WAAW,2CAA2C;IACxE,SAAkB,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAA+B;IAC7D,SAAkB,YAAY;;;;;;;;;OAA+B;IAC7D,SAAkB,QAAQ,EAAG,SAAS,CAAU;IAChD,SAAkB,IAAI,UAAU;IAChC,SAAkB,eAAe;;;;;;OAGtB;IAEX,uEAAuE;IAC9D,WAAW,CAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,MAAM,CAAC,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAOxB,OAAO,CACpB,MAAM,EAAE,qBAAqB,EAC7B,GAAG,EAAE,2BAA2B,GAC/B,OAAO,CAAC,qBAAqB,CAAC;CAwBlC"}

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

@@ -0,0 +1,71 @@
+/**
+ * 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 } from '../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(),
+});
+// ─── 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) {
+            await ctx.walkBranch(config.if_true, ctx.workflow, 'if_true');
+            return { branch: 'if_true', evaluated: true };
+        }
+        if (config.if_false && config.if_false.length > 0) {
+            await ctx.walkBranch(config.if_false, ctx.workflow, 'if_false');
+            return { branch: 'if_false', evaluated: false };
+        }
+        return { branch: 'none', evaluated: false };
+    }
+}
+//# sourceMappingURL=conditional.step.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"conditional.step.js","sourceRoot":"","sources":["../../../src/steps/builtin/conditional.step.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEtD,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE7D,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAEzE,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;AAaH,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;CACvB,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,GAAG,CAAC,UAAU,CAClB,MAAM,CAAC,OAA0C,EACjD,GAAG,CAAC,QAAQ,EACZ,SAAS,CACV,CAAC;YACF,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;QAChD,CAAC;QAED,IAAI,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClD,MAAM,GAAG,CAAC,UAAU,CAClB,MAAM,CAAC,QAA2C,EAClD,GAAG,CAAC,QAAQ,EACZ,UAAU,CACX,CAAC;YACF,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;QAClD,CAAC;QAED,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IAC9C,CAAC;CACF"}

package/dist/steps/builtin/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 '../base-step.js';
+import type { StepExecutionContext } from '../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/steps/builtin/dedup.step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dedup.step.d.ts","sourceRoot":"","sources":["../../../src/steps/builtin/dedup.step.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAK9D,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/steps/builtin/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 '../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/steps/builtin/dedup.step.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dedup.step.js","sourceRoot":"","sources":["../../../src/steps/builtin/dedup.step.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE7D,OAAO,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAEhE,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"}