veto-sdk 2.5.1 → 2.6.0

package/dist/rules/pipeline-dsl.d.ts

@@ -0,0 +1,802 @@
+/**
+ * Pipeline DSL — declarative, content-addressable spec for dynamic
+ * policy feeds.
+ *
+ * A pipeline composes a small set of validated resolver operations into
+ * a list-producing DAG. The LLM compiler emits pipelines by selecting
+ * from a fixed catalog; it never writes executable code. Identity is
+ * the sha256 of the canonicalized spec (minus `id`), so two callers
+ * requesting "block gambling sites" share one pipeline.
+ *
+ * This module is pure OSS: runtime, scheduler, and resolver
+ * implementations live in the platform. The SDK only exposes the
+ * schema and validator so consumers can author, verify, and diff
+ * pipeline specs without the platform.
+ *
+ * @module rules/pipeline-dsl
+ */
+import { z } from 'zod';
+export declare const PipelineStepSchema: z.ZodUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"search">;
+    resolver: z.ZodString;
+    query: z.ZodString;
+    limit: z.ZodOptional<z.ZodNumber>;
+    as: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    kind: "search";
+    query: string;
+    resolver: string;
+    limit?: number | undefined;
+    as?: string | undefined;
+}, {
+    kind: "search";
+    query: string;
+    resolver: string;
+    limit?: number | undefined;
+    as?: string | undefined;
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"fetch">;
+    resolver: z.ZodString;
+    id_from: z.ZodString;
+    fields: z.ZodArray<z.ZodString, "many">;
+    as: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    fields: string[];
+    kind: "fetch";
+    resolver: string;
+    id_from: string;
+    as?: string | undefined;
+}, {
+    fields: string[];
+    kind: "fetch";
+    resolver: string;
+    id_from: string;
+    as?: string | undefined;
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"extract">;
+    from: z.ZodString;
+    selector: z.ZodString;
+    as: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    kind: "extract";
+    from: string;
+    as: string;
+    selector: string;
+}, {
+    kind: "extract";
+    from: string;
+    as: string;
+    selector: string;
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"aggregate">;
+    source: z.ZodString;
+    op: z.ZodEnum<["unique", "count", "union", "intersect"]>;
+    as: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    source: string;
+    op: "count" | "unique" | "union" | "intersect";
+    kind: "aggregate";
+    as?: string | undefined;
+}, {
+    source: string;
+    op: "count" | "unique" | "union" | "intersect";
+    kind: "aggregate";
+    as?: string | undefined;
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"diff">;
+    current: z.ZodString;
+    previous: z.ZodString;
+    emit: z.ZodEnum<["added", "removed", "changed"]>;
+    as: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    current: string;
+    kind: "diff";
+    previous: string;
+    emit: "added" | "removed" | "changed";
+    as?: string | undefined;
+}, {
+    current: string;
+    kind: "diff";
+    previous: string;
+    emit: "added" | "removed" | "changed";
+    as?: string | undefined;
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"foreach">;
+    source: z.ZodString;
+    do: z.ZodArray<z.ZodUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"search">;
+        resolver: z.ZodString;
+        query: z.ZodString;
+        limit: z.ZodOptional<z.ZodNumber>;
+        as: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        kind: "search";
+        query: string;
+        resolver: string;
+        limit?: number | undefined;
+        as?: string | undefined;
+    }, {
+        kind: "search";
+        query: string;
+        resolver: string;
+        limit?: number | undefined;
+        as?: string | undefined;
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"fetch">;
+        resolver: z.ZodString;
+        id_from: z.ZodString;
+        fields: z.ZodArray<z.ZodString, "many">;
+        as: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        fields: string[];
+        kind: "fetch";
+        resolver: string;
+        id_from: string;
+        as?: string | undefined;
+    }, {
+        fields: string[];
+        kind: "fetch";
+        resolver: string;
+        id_from: string;
+        as?: string | undefined;
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"extract">;
+        from: z.ZodString;
+        selector: z.ZodString;
+        as: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        kind: "extract";
+        from: string;
+        as: string;
+        selector: string;
+    }, {
+        kind: "extract";
+        from: string;
+        as: string;
+        selector: string;
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"aggregate">;
+        source: z.ZodString;
+        op: z.ZodEnum<["unique", "count", "union", "intersect"]>;
+        as: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        source: string;
+        op: "count" | "unique" | "union" | "intersect";
+        kind: "aggregate";
+        as?: string | undefined;
+    }, {
+        source: string;
+        op: "count" | "unique" | "union" | "intersect";
+        kind: "aggregate";
+        as?: string | undefined;
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"diff">;
+        current: z.ZodString;
+        previous: z.ZodString;
+        emit: z.ZodEnum<["added", "removed", "changed"]>;
+        as: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        current: string;
+        kind: "diff";
+        previous: string;
+        emit: "added" | "removed" | "changed";
+        as?: string | undefined;
+    }, {
+        current: string;
+        kind: "diff";
+        previous: string;
+        emit: "added" | "removed" | "changed";
+        as?: string | undefined;
+    }>]>, "many">;
+    as: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    source: string;
+    kind: "foreach";
+    do: ({
+        kind: "search";
+        query: string;
+        resolver: string;
+        limit?: number | undefined;
+        as?: string | undefined;
+    } | {
+        fields: string[];
+        kind: "fetch";
+        resolver: string;
+        id_from: string;
+        as?: string | undefined;
+    } | {
+        kind: "extract";
+        from: string;
+        as: string;
+        selector: string;
+    } | {
+        source: string;
+        op: "count" | "unique" | "union" | "intersect";
+        kind: "aggregate";
+        as?: string | undefined;
+    } | {
+        current: string;
+        kind: "diff";
+        previous: string;
+        emit: "added" | "removed" | "changed";
+        as?: string | undefined;
+    })[];
+    as?: string | undefined;
+}, {
+    source: string;
+    kind: "foreach";
+    do: ({
+        kind: "search";
+        query: string;
+        resolver: string;
+        limit?: number | undefined;
+        as?: string | undefined;
+    } | {
+        fields: string[];
+        kind: "fetch";
+        resolver: string;
+        id_from: string;
+        as?: string | undefined;
+    } | {
+        kind: "extract";
+        from: string;
+        as: string;
+        selector: string;
+    } | {
+        source: string;
+        op: "count" | "unique" | "union" | "intersect";
+        kind: "aggregate";
+        as?: string | undefined;
+    } | {
+        current: string;
+        kind: "diff";
+        previous: string;
+        emit: "added" | "removed" | "changed";
+        as?: string | undefined;
+    })[];
+    as?: string | undefined;
+}>]>;
+export type PipelineStep = z.infer<typeof PipelineStepSchema>;
+export declare const PipelineScheduleSchema: z.ZodUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"interval">;
+    every_sec: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    kind: "interval";
+    every_sec: number;
+}, {
+    kind: "interval";
+    every_sec: number;
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"cron">;
+    expr: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    kind: "cron";
+    expr: string;
+}, {
+    kind: "cron";
+    expr: string;
+}>]>;
+export type PipelineSchedule = z.infer<typeof PipelineScheduleSchema>;
+export declare const PipelineOutputSchema: z.ZodObject<{
+    shape: z.ZodEnum<["list_of_strings", "list_of_objects"]>;
+    schema: z.ZodOptional<z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    shape: "list_of_strings" | "list_of_objects";
+    schema?: unknown;
+}, {
+    shape: "list_of_strings" | "list_of_objects";
+    schema?: unknown;
+}>;
+export type PipelineOutput = z.infer<typeof PipelineOutputSchema>;
+export declare const PipelineBudgetSchema: z.ZodObject<{
+    max_resolver_calls_per_run: z.ZodNumber;
+    max_tokens_per_run: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    max_resolver_calls_per_run: number;
+    max_tokens_per_run: number;
+}, {
+    max_resolver_calls_per_run: number;
+    max_tokens_per_run: number;
+}>;
+export type PipelineBudget = z.infer<typeof PipelineBudgetSchema>;
+export declare const PipelineSpecSchema: z.ZodObject<{
+    dsl_version: z.ZodLiteral<1>;
+    id: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    schedule: z.ZodUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"interval">;
+        every_sec: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        kind: "interval";
+        every_sec: number;
+    }, {
+        kind: "interval";
+        every_sec: number;
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"cron">;
+        expr: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        kind: "cron";
+        expr: string;
+    }, {
+        kind: "cron";
+        expr: string;
+    }>]>;
+    steps: z.ZodArray<z.ZodUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"search">;
+        resolver: z.ZodString;
+        query: z.ZodString;
+        limit: z.ZodOptional<z.ZodNumber>;
+        as: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        kind: "search";
+        query: string;
+        resolver: string;
+        limit?: number | undefined;
+        as?: string | undefined;
+    }, {
+        kind: "search";
+        query: string;
+        resolver: string;
+        limit?: number | undefined;
+        as?: string | undefined;
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"fetch">;
+        resolver: z.ZodString;
+        id_from: z.ZodString;
+        fields: z.ZodArray<z.ZodString, "many">;
+        as: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        fields: string[];
+        kind: "fetch";
+        resolver: string;
+        id_from: string;
+        as?: string | undefined;
+    }, {
+        fields: string[];
+        kind: "fetch";
+        resolver: string;
+        id_from: string;
+        as?: string | undefined;
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"extract">;
+        from: z.ZodString;
+        selector: z.ZodString;
+        as: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        kind: "extract";
+        from: string;
+        as: string;
+        selector: string;
+    }, {
+        kind: "extract";
+        from: string;
+        as: string;
+        selector: string;
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"aggregate">;
+        source: z.ZodString;
+        op: z.ZodEnum<["unique", "count", "union", "intersect"]>;
+        as: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        source: string;
+        op: "count" | "unique" | "union" | "intersect";
+        kind: "aggregate";
+        as?: string | undefined;
+    }, {
+        source: string;
+        op: "count" | "unique" | "union" | "intersect";
+        kind: "aggregate";
+        as?: string | undefined;
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"diff">;
+        current: z.ZodString;
+        previous: z.ZodString;
+        emit: z.ZodEnum<["added", "removed", "changed"]>;
+        as: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        current: string;
+        kind: "diff";
+        previous: string;
+        emit: "added" | "removed" | "changed";
+        as?: string | undefined;
+    }, {
+        current: string;
+        kind: "diff";
+        previous: string;
+        emit: "added" | "removed" | "changed";
+        as?: string | undefined;
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"foreach">;
+        source: z.ZodString;
+        do: z.ZodArray<z.ZodUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"search">;
+            resolver: z.ZodString;
+            query: z.ZodString;
+            limit: z.ZodOptional<z.ZodNumber>;
+            as: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            kind: "search";
+            query: string;
+            resolver: string;
+            limit?: number | undefined;
+            as?: string | undefined;
+        }, {
+            kind: "search";
+            query: string;
+            resolver: string;
+            limit?: number | undefined;
+            as?: string | undefined;
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"fetch">;
+            resolver: z.ZodString;
+            id_from: z.ZodString;
+            fields: z.ZodArray<z.ZodString, "many">;
+            as: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            fields: string[];
+            kind: "fetch";
+            resolver: string;
+            id_from: string;
+            as?: string | undefined;
+        }, {
+            fields: string[];
+            kind: "fetch";
+            resolver: string;
+            id_from: string;
+            as?: string | undefined;
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"extract">;
+            from: z.ZodString;
+            selector: z.ZodString;
+            as: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            kind: "extract";
+            from: string;
+            as: string;
+            selector: string;
+        }, {
+            kind: "extract";
+            from: string;
+            as: string;
+            selector: string;
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"aggregate">;
+            source: z.ZodString;
+            op: z.ZodEnum<["unique", "count", "union", "intersect"]>;
+            as: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            source: string;
+            op: "count" | "unique" | "union" | "intersect";
+            kind: "aggregate";
+            as?: string | undefined;
+        }, {
+            source: string;
+            op: "count" | "unique" | "union" | "intersect";
+            kind: "aggregate";
+            as?: string | undefined;
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"diff">;
+            current: z.ZodString;
+            previous: z.ZodString;
+            emit: z.ZodEnum<["added", "removed", "changed"]>;
+            as: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            current: string;
+            kind: "diff";
+            previous: string;
+            emit: "added" | "removed" | "changed";
+            as?: string | undefined;
+        }, {
+            current: string;
+            kind: "diff";
+            previous: string;
+            emit: "added" | "removed" | "changed";
+            as?: string | undefined;
+        }>]>, "many">;
+        as: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        source: string;
+        kind: "foreach";
+        do: ({
+            kind: "search";
+            query: string;
+            resolver: string;
+            limit?: number | undefined;
+            as?: string | undefined;
+        } | {
+            fields: string[];
+            kind: "fetch";
+            resolver: string;
+            id_from: string;
+            as?: string | undefined;
+        } | {
+            kind: "extract";
+            from: string;
+            as: string;
+            selector: string;
+        } | {
+            source: string;
+            op: "count" | "unique" | "union" | "intersect";
+            kind: "aggregate";
+            as?: string | undefined;
+        } | {
+            current: string;
+            kind: "diff";
+            previous: string;
+            emit: "added" | "removed" | "changed";
+            as?: string | undefined;
+        })[];
+        as?: string | undefined;
+    }, {
+        source: string;
+        kind: "foreach";
+        do: ({
+            kind: "search";
+            query: string;
+            resolver: string;
+            limit?: number | undefined;
+            as?: string | undefined;
+        } | {
+            fields: string[];
+            kind: "fetch";
+            resolver: string;
+            id_from: string;
+            as?: string | undefined;
+        } | {
+            kind: "extract";
+            from: string;
+            as: string;
+            selector: string;
+        } | {
+            source: string;
+            op: "count" | "unique" | "union" | "intersect";
+            kind: "aggregate";
+            as?: string | undefined;
+        } | {
+            current: string;
+            kind: "diff";
+            previous: string;
+            emit: "added" | "removed" | "changed";
+            as?: string | undefined;
+        })[];
+        as?: string | undefined;
+    }>]>, "many">;
+    output: z.ZodObject<{
+        shape: z.ZodEnum<["list_of_strings", "list_of_objects"]>;
+        schema: z.ZodOptional<z.ZodUnknown>;
+    }, "strip", z.ZodTypeAny, {
+        shape: "list_of_strings" | "list_of_objects";
+        schema?: unknown;
+    }, {
+        shape: "list_of_strings" | "list_of_objects";
+        schema?: unknown;
+    }>;
+    budget: z.ZodObject<{
+        max_resolver_calls_per_run: z.ZodNumber;
+        max_tokens_per_run: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        max_resolver_calls_per_run: number;
+        max_tokens_per_run: number;
+    }, {
+        max_resolver_calls_per_run: number;
+        max_tokens_per_run: number;
+    }>;
+    on_failure: z.ZodEnum<["skip", "fail_open", "fail_closed", "last_known_good"]>;
+}, "strip", z.ZodTypeAny, {
+    output: {
+        shape: "list_of_strings" | "list_of_objects";
+        schema?: unknown;
+    };
+    id: string;
+    budget: {
+        max_resolver_calls_per_run: number;
+        max_tokens_per_run: number;
+    };
+    dsl_version: 1;
+    schedule: {
+        kind: "interval";
+        every_sec: number;
+    } | {
+        kind: "cron";
+        expr: string;
+    };
+    steps: ({
+        kind: "search";
+        query: string;
+        resolver: string;
+        limit?: number | undefined;
+        as?: string | undefined;
+    } | {
+        fields: string[];
+        kind: "fetch";
+        resolver: string;
+        id_from: string;
+        as?: string | undefined;
+    } | {
+        kind: "extract";
+        from: string;
+        as: string;
+        selector: string;
+    } | {
+        source: string;
+        op: "count" | "unique" | "union" | "intersect";
+        kind: "aggregate";
+        as?: string | undefined;
+    } | {
+        current: string;
+        kind: "diff";
+        previous: string;
+        emit: "added" | "removed" | "changed";
+        as?: string | undefined;
+    } | {
+        source: string;
+        kind: "foreach";
+        do: ({
+            kind: "search";
+            query: string;
+            resolver: string;
+            limit?: number | undefined;
+            as?: string | undefined;
+        } | {
+            fields: string[];
+            kind: "fetch";
+            resolver: string;
+            id_from: string;
+            as?: string | undefined;
+        } | {
+            kind: "extract";
+            from: string;
+            as: string;
+            selector: string;
+        } | {
+            source: string;
+            op: "count" | "unique" | "union" | "intersect";
+            kind: "aggregate";
+            as?: string | undefined;
+        } | {
+            current: string;
+            kind: "diff";
+            previous: string;
+            emit: "added" | "removed" | "changed";
+            as?: string | undefined;
+        })[];
+        as?: string | undefined;
+    })[];
+    on_failure: "fail_open" | "fail_closed" | "last_known_good" | "skip";
+    description?: string | undefined;
+}, {
+    output: {
+        shape: "list_of_strings" | "list_of_objects";
+        schema?: unknown;
+    };
+    id: string;
+    budget: {
+        max_resolver_calls_per_run: number;
+        max_tokens_per_run: number;
+    };
+    dsl_version: 1;
+    schedule: {
+        kind: "interval";
+        every_sec: number;
+    } | {
+        kind: "cron";
+        expr: string;
+    };
+    steps: ({
+        kind: "search";
+        query: string;
+        resolver: string;
+        limit?: number | undefined;
+        as?: string | undefined;
+    } | {
+        fields: string[];
+        kind: "fetch";
+        resolver: string;
+        id_from: string;
+        as?: string | undefined;
+    } | {
+        kind: "extract";
+        from: string;
+        as: string;
+        selector: string;
+    } | {
+        source: string;
+        op: "count" | "unique" | "union" | "intersect";
+        kind: "aggregate";
+        as?: string | undefined;
+    } | {
+        current: string;
+        kind: "diff";
+        previous: string;
+        emit: "added" | "removed" | "changed";
+        as?: string | undefined;
+    } | {
+        source: string;
+        kind: "foreach";
+        do: ({
+            kind: "search";
+            query: string;
+            resolver: string;
+            limit?: number | undefined;
+            as?: string | undefined;
+        } | {
+            fields: string[];
+            kind: "fetch";
+            resolver: string;
+            id_from: string;
+            as?: string | undefined;
+        } | {
+            kind: "extract";
+            from: string;
+            as: string;
+            selector: string;
+        } | {
+            source: string;
+            op: "count" | "unique" | "union" | "intersect";
+            kind: "aggregate";
+            as?: string | undefined;
+        } | {
+            current: string;
+            kind: "diff";
+            previous: string;
+            emit: "added" | "removed" | "changed";
+            as?: string | undefined;
+        })[];
+        as?: string | undefined;
+    })[];
+    on_failure: "fail_open" | "fail_closed" | "last_known_good" | "skip";
+    description?: string | undefined;
+}>;
+export type PipelineSpec = z.infer<typeof PipelineSpecSchema>;
+/**
+ * Canonicalize an arbitrary JSON value to a deterministic string.
+ *
+ * Rules:
+ * - Object keys sorted lexicographically.
+ * - Arrays preserved in order (order is semantically meaningful in DSL).
+ * - Numbers formatted with JSON.stringify default (no special handling).
+ * - `undefined` removed (matches JSON.stringify behavior).
+ *
+ * Throws on non-plain-object container types (Date, Map, Set, RegExp,
+ * class instances), BigInt, Symbol, and functions. These would either
+ * hash-collide silently (Date → `{}`) or crash JSON.stringify (BigInt).
+ * Pipeline specs validated by PipelineSpecSchema never contain such
+ * values; the guard exists for callers who bypass Zod.
+ *
+ * Used only for content-hash identity; not a general-purpose serializer.
+ */
+export declare function canonicalizeJson(value: unknown): string;
+/**
+ * Compute the content-addressable pipeline id.
+ *
+ * The id is the hex sha256 of the canonicalized spec with the `id`
+ * field stripped (the id cannot refer to itself). Two specs that
+ * differ only in description still hash the same because the
+ * description is intentionally included — a new description means
+ * new monitoring semantics. Callers that want to reuse an existing
+ * pipeline should pass the same description.
+ */
+export declare function computePipelineId(spec: Omit<PipelineSpec, 'id'> | PipelineSpec): string;
+/**
+ * Parse and validate an untrusted pipeline spec.
+ *
+ * Throws on any schema violation. Does NOT verify the `id` matches
+ * the content hash — call `verifyPipelineId(spec)` for that.
+ */
+export declare function parsePipelineSpec(input: unknown): PipelineSpec;
+/**
+ * Verify the `id` field equals the computed content hash.
+ *
+ * Use on load from any untrusted source (network, disk) to detect
+ * tampering or stale ids after edits.
+ */
+export declare function verifyPipelineId(spec: PipelineSpec): boolean;
+/**
+ * Stamp the correct content-hash id onto a draft spec.
+ *
+ * Convenience for authors and compilers who produce specs without
+ * pre-computing the id.
+ */
+export declare function stampPipelineId(draft: Omit<PipelineSpec, 'id'>): PipelineSpec;
+//# sourceMappingURL=pipeline-dsl.d.ts.map