@kindgi/flow 0.0.0-bootstrap.0 → 0.1.0

package/dist/errors.d.ts

@@ -0,0 +1,252 @@
+import type { EdgeId, FlowId, NodeId } from '@kindgi/types';
+/**
+ * Every flow error carries a discriminating `code` so callers can pattern
+ * match without inspecting messages. Messages are intended for logs and are
+ * not part of the API contract.
+ */
+export type FlowError = SchemaValidationError | DuplicateNodeError | DuplicateEdgeError | UnknownNodeReferenceError | ReservedIdError | CycleError | InvalidPredicateError | InvalidEdgePolicyError | MissingStartEdgeError | LoopBodyMissingStartError | LoopBodyCycleError | LoopBodyEdgeReferenceError | LoopMaxIterationsError | LoopOutputSchemaError | LoopVariantMismatchError | LoopConcurrencyError | InvalidFanoutNodeError | InvalidSubflowNodeError | InvalidMappingError | InvalidFlowOutputError;
+export interface SchemaValidationError {
+    readonly code: 'schema-validation-failed';
+    readonly message: string;
+    readonly flowId?: FlowId;
+    /** Ajv-style path list — one per validation failure. */
+    readonly issues: readonly {
+        readonly path: string;
+        readonly message: string;
+    }[];
+}
+export interface DuplicateNodeError {
+    readonly code: 'duplicate-node-id';
+    readonly message: string;
+    readonly flowId: FlowId;
+    readonly nodeId: NodeId;
+}
+export interface DuplicateEdgeError {
+    readonly code: 'duplicate-edge-id';
+    readonly message: string;
+    readonly flowId: FlowId;
+    readonly edgeId: EdgeId;
+}
+export interface UnknownNodeReferenceError {
+    readonly code: 'unknown-node-reference';
+    readonly message: string;
+    readonly flowId: FlowId;
+    readonly edgeId: EdgeId;
+    readonly endpoint: 'from' | 'to';
+    readonly referencedId: string;
+}
+export interface ReservedIdError {
+    readonly code: 'reserved-id';
+    readonly message: string;
+    readonly flowId: FlowId;
+    readonly nodeId: NodeId;
+}
+export interface CycleError {
+    readonly code: 'cycle-detected';
+    readonly message: string;
+    readonly flowId: FlowId;
+    /** Node ids in the cycle, in traversal order. */
+    readonly cycle: readonly NodeId[];
+}
+export interface InvalidPredicateError {
+    readonly code: 'invalid-predicate';
+    readonly message: string;
+    readonly flowId: FlowId;
+    readonly edgeId: EdgeId;
+    readonly reason: string;
+}
+/**
+ * A `FlowEdge.policy` field is structurally valid JSON-schema-wise but
+ * violates one of the semantic rules `loadFlow` enforces — e.g.
+ * `retry.maxAttempts` out of the `[1, 10]` band, negative `delayMs`, or
+ * `backoff: 'exponential'` without a `maxDelayMs` ceiling.
+ *
+ * The schema layer catches shape errors (wrong types, unknown fields);
+ * this error surfaces the semantic ones the schema can't express.
+ */
+export interface InvalidEdgePolicyError {
+    readonly code: 'invalid-edge-policy';
+    readonly message: string;
+    readonly flowId: FlowId;
+    readonly edgeId: EdgeId;
+    readonly field: 'retry.maxAttempts' | 'retry.delayMs' | 'retry.backoff' | 'retry.maxDelayMs' | 'timeoutMs' | 'concurrencyKey' | 'priority';
+    readonly reason: string;
+}
+export interface MissingStartEdgeError {
+    readonly code: 'missing-start-edge';
+    readonly message: string;
+    readonly flowId: FlowId;
+}
+/**
+ * A loop node's body has no edge originating at `$loop-start`. Analogous to
+ * `MissingStartEdgeError` but scoped to a specific loop body.
+ */
+export interface LoopBodyMissingStartError {
+    readonly code: 'loop-body-missing-start-edge';
+    readonly message: string;
+    readonly flowId: FlowId;
+    readonly loopNodeId: NodeId;
+}
+/** A cycle was detected inside a loop node's body sub-flow. */
+export interface LoopBodyCycleError {
+    readonly code: 'loop-body-cycle-detected';
+    readonly message: string;
+    readonly flowId: FlowId;
+    readonly loopNodeId: NodeId;
+    readonly cycle: readonly NodeId[];
+}
+/**
+ * An edge inside a loop body references an endpoint that isn't a known
+ * body node or a `$loop-start` / `$loop-end` sentinel.
+ */
+export interface LoopBodyEdgeReferenceError {
+    readonly code: 'loop-body-unknown-node-reference';
+    readonly message: string;
+    readonly flowId: FlowId;
+    readonly loopNodeId: NodeId;
+    readonly edgeId: EdgeId;
+    readonly endpoint: 'from' | 'to';
+    readonly referencedId: string;
+}
+/**
+ * A loop node's `maxIterations` is out of the allowed range. Checked by
+ * `loadFlow` in addition to the schema-level bounds.
+ */
+export interface LoopMaxIterationsError {
+    readonly code: 'loop-invalid-max-iterations';
+    readonly message: string;
+    readonly flowId: FlowId;
+    readonly loopNodeId: NodeId;
+    readonly value: number;
+}
+/**
+ * A loop node's `outputSchema` is missing or is not a valid JSON Schema
+ * (draft 2020-12). Every loop declares a typed escape contract; a
+ * malformed schema is caught at load time so no execution-time surprise
+ * ever surfaces to the caller.
+ */
+export interface LoopOutputSchemaError {
+    readonly code: 'loop-invalid-output-schema';
+    readonly message: string;
+    readonly flowId: FlowId;
+    readonly loopNodeId: NodeId;
+    /** Meta-schema validation issues (Ajv-style path + message). */
+    readonly issues: readonly {
+        readonly path: string;
+        readonly message: string;
+    }[];
+}
+/**
+ * A loop node declares fields that belong to the wrong variant. Examples:
+ *   - `loopKind: 'foreach'` with an `exitCondition` present.
+ *   - `loopKind: 'while'` with an `iterateOver` present.
+ *   - `loopKind: 'foreach'` missing `iterateOver`.
+ *   - `loopKind: 'while'` missing `exitCondition`.
+ *
+ * Enforced at load time so the executor can trust the discriminated union.
+ */
+export interface LoopVariantMismatchError {
+    readonly code: 'loop-variant-mismatch';
+    readonly message: string;
+    readonly flowId: FlowId;
+    readonly loopNodeId: NodeId;
+    readonly loopKind: 'while' | 'foreach';
+    readonly problem: 'while-missing-exit-condition' | 'while-has-iterate-over' | 'while-has-invalid-evaluation-timing' | 'while-has-concurrency' | 'foreach-missing-iterate-over' | 'foreach-has-exit-condition' | 'foreach-has-evaluation-timing';
+}
+/**
+ * A foreach loop's `concurrency` field is out of the allowed band. Bounds:
+ *   - Must be a positive integer.
+ *   - `1 ≤ concurrency ≤ 32` — the upper cap is a safety limit.
+ *   - `concurrency ≤ maxIterations` — otherwise pointless.
+ *
+ * The 32 cap prevents accidents (a stray `concurrency: 1000` spawning a
+ * thousand simultaneous handlers). The cap is fixed; adaptive or
+ * rate-aware concurrency is not part of this primitive.
+ */
+export interface LoopConcurrencyError {
+    readonly code: 'loop-invalid-concurrency';
+    readonly message: string;
+    readonly flowId: FlowId;
+    readonly loopNodeId: NodeId;
+    readonly value: number;
+    readonly reason: 'not-integer' | 'below-minimum' | 'exceeds-max-iterations' | 'exceeds-cap';
+}
+/**
+ * A `subgraph` node is structurally valid JSON-schema-wise but violates
+ * one of the semantic rules `loadFlow` enforces — e.g. malformed `flowRef`,
+ * non-exact semver, an `inputMapping` value that isn't a valid Operand,
+ * an `outputSchema` that fails to compile against the draft-2020-12
+ * meta-schema, or an unknown `convergence` mode.
+ *
+ * `field` narrows the location of the failure so callers can attribute
+ * without matching on the message.
+ */
+export interface InvalidSubflowNodeError {
+    readonly code: 'invalid-subgraph-node';
+    readonly message: string;
+    readonly flowId: FlowId;
+    readonly subgraphNodeId: NodeId;
+    readonly field: 'flowRef' | 'flowRef.flowId' | 'flowRef.version' | 'inputMapping' | 'output-schema' | 'convergence';
+    readonly reason: string;
+    /** Meta-schema issues, when `field === 'output-schema'`. */
+    readonly issues?: readonly {
+        readonly path: string;
+        readonly message: string;
+    }[];
+}
+/**
+ * A `fanout` node is structurally valid JSON-schema-wise but violates one
+ * of the semantic rules `loadFlow` enforces — e.g. duplicate `branchId`,
+ * concurrency out of `[1, branches.length]`, an unknown convergence mode,
+ * or a per-branch `outputSchema` that fails to compile against the
+ * draft-2020-12 meta-schema.
+ *
+ * `field` narrows the location of the failure so callers can attribute
+ * without matching on the message.
+ */
+export interface InvalidFanoutNodeError {
+    readonly code: 'invalid-fanout-node';
+    readonly message: string;
+    readonly flowId: FlowId;
+    readonly fanoutNodeId: NodeId;
+    readonly field: 'branches' | 'branch-id' | 'branch-handler' | 'branch-output-schema' | 'concurrency' | 'convergence';
+    readonly reason: string;
+    /** Branch id at fault, when the failure attribution is per-branch. */
+    readonly branchId?: string;
+    /** Meta-schema issues, when `field === 'branch-output-schema'`. */
+    readonly issues?: readonly {
+        readonly path: string;
+        readonly message: string;
+    }[];
+}
+/**
+ * A leaf `inputMapping` or the flow `output.mapping` entry can't be
+ * resolved as written (schema-version 1.8.0+): its path names a node the
+ * flow doesn't have, maps the node's own output, or uses a loop-only root
+ * (`iterationIndex` / `iterationOutput`). A path with an unknown root
+ * fails the schema step instead (`schema-validation-failed`).
+ */
+export interface InvalidMappingError {
+    readonly code: 'invalid-mapping';
+    readonly message: string;
+    readonly flowId: FlowId;
+    /** The leaf node whose `inputMapping` is invalid; absent for the flow's `output`. */
+    readonly nodeId?: NodeId;
+    /** The mapping key whose operand is invalid. */
+    readonly key: string;
+    readonly reason: string;
+}
+/**
+ * A flow's `output.schema` is not a valid JSON Schema (draft 2020-12).
+ */
+export interface InvalidFlowOutputError {
+    readonly code: 'invalid-flow-output';
+    readonly message: string;
+    readonly flowId: FlowId;
+    /** Meta-schema validation issues (Ajv-style path + message). */
+    readonly issues: readonly {
+        readonly path: string;
+        readonly message: string;
+    }[];
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

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

package/dist/errors.js

@@ -0,0 +1,4 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (C) 2026 Kindgi Inc.
+export {};
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,iCAAiC"}

package/dist/evaluator.d.ts

@@ -0,0 +1,69 @@
+import type { NodeId } from '@kindgi/types';
+import type { Expr, Mapping } from './types.js';
+/**
+ * The evaluation environment. Passed by the kernel at edge dispatch time —
+ * one instance per edge evaluation — and when resolving a `Mapping`.
+ * Consumers should treat every branch as read-only.
+ *
+ * Every root is optional at construction; a missing root resolves any
+ * dependent path to MISSING (`MISSING_PATH`), which composes cleanly with
+ * `exists` and `notExists` predicates.
+ */
+export interface EvalEnv {
+    readonly runInput?: unknown;
+    readonly state?: unknown;
+    /**
+     * Outputs of previously-completed nodes, keyed by NodeId. Only nodes whose
+     * `step.completed` entry exists in the journal appear here — a fan-in edge
+     * whose predicate references a not-yet-completed sibling resolves that
+     * path to MISSING.
+     */
+    readonly nodeOutputs?: ReadonlyMap<NodeId, unknown>;
+    /**
+     * Only populated when evaluating a loop node's `exitCondition`. `undefined`
+     * outside that context; predicates referencing this root then resolve to
+     * MISSING (composes cleanly with `exists` / `notExists`).
+     */
+    readonly iterationIndex?: number;
+    /**
+     * Only populated when evaluating a loop node's `exitCondition`. Holds
+     * the just-completed iteration's `$loop-end` output (or the previous
+     * iteration's output for while+before at iteration i>0; null for
+     * while+before iteration 0).
+     */
+    readonly iterationOutput?: unknown;
+}
+/** Distinguishing "resolved to `undefined`" from "path does not exist". */
+declare const MISSING: unique symbol;
+type Resolved = unknown | typeof MISSING;
+/**
+ * Evaluate a predicate expression against an environment.
+ *
+ * Semantics summary:
+ *   - Comparisons on missing operands (path resolves to MISSING) → false.
+ *   - `exists` on MISSING → false; on `undefined` value at a real path → true.
+ *   - `truthy` / `falsy` use the JS truthiness rules on the resolved value;
+ *     MISSING is treated as falsy.
+ *   - `in` / `notIn` require `set` to be an array; a non-array `set` → false.
+ *   - `and` / `or` are short-circuiting; empty children are rejected at load time.
+ *
+ * The evaluator is intentionally total — it never throws for a well-formed
+ * expression, so kernel edge evaluation cannot fail due to predicate execution.
+ */
+export declare function evaluateExpr(expr: Expr, env: EvalEnv): boolean;
+/**
+ * Resolve a `Mapping` against an environment: literals as given, paths
+ * via `resolvePath`. A path that doesn't resolve omits its key — the
+ * result never carries a mapped key whose value is missing. Total, like
+ * `evaluateExpr`: it never throws for a well-formed mapping.
+ */
+export declare function resolveMapping(mapping: Mapping, env: EvalEnv): Record<string, unknown>;
+export declare function resolvePath(path: string, env: EvalEnv): Resolved;
+/**
+ * Distinguishes "path resolved but value was undefined" from "path did not
+ * exist at all". Exported so tests and downstream diagnostics can identify
+ * the missing marker without depending on a private symbol.
+ */
+export declare const MISSING_PATH: typeof MISSING;
+export {};
+//# sourceMappingURL=evaluator.d.ts.map

package/dist/evaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluator.d.ts","sourceRoot":"","sources":["../src/evaluator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,KAAK,EAAE,IAAI,EAAkB,OAAO,EAAW,MAAM,YAAY,CAAC;AAEzE;;;;;;;;GAQG;AACH,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpD;;;;OAIG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC;;;;;OAKG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;CACpC;AAED,2EAA2E;AAC3E,QAAA,MAAM,OAAO,eAAmC,CAAC;AACjD,KAAK,QAAQ,GAAG,OAAO,GAAG,OAAO,OAAO,CAAC;AAEzC;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CA2B9D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAOtF;AAwED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,QAAQ,CA4BhE;AA+CD;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,OAAO,OAAiB,CAAC"}

package/dist/evaluator.js

@@ -0,0 +1,220 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (C) 2026 Kindgi Inc.
+/** Distinguishing "resolved to `undefined`" from "path does not exist". */
+const MISSING = Symbol('flow.evaluator.missing');
+/**
+ * Evaluate a predicate expression against an environment.
+ *
+ * Semantics summary:
+ *   - Comparisons on missing operands (path resolves to MISSING) → false.
+ *   - `exists` on MISSING → false; on `undefined` value at a real path → true.
+ *   - `truthy` / `falsy` use the JS truthiness rules on the resolved value;
+ *     MISSING is treated as falsy.
+ *   - `in` / `notIn` require `set` to be an array; a non-array `set` → false.
+ *   - `and` / `or` are short-circuiting; empty children are rejected at load time.
+ *
+ * The evaluator is intentionally total — it never throws for a well-formed
+ * expression, so kernel edge evaluation cannot fail due to predicate execution.
+ */
+export function evaluateExpr(expr, env) {
+    switch (expr.op) {
+        case 'eq':
+        case 'ne':
+        case 'lt':
+        case 'lte':
+        case 'gt':
+        case 'gte':
+            return compare(expr.op, resolveOperand(expr.left, env), resolveOperand(expr.right, env));
+        case 'in':
+        case 'notIn':
+            return evalMembership(expr.op, expr, env);
+        case 'exists':
+            return resolveOperand(expr.value, env) !== MISSING;
+        case 'notExists':
+            return resolveOperand(expr.value, env) === MISSING;
+        case 'truthy':
+            return evalTruthy(resolveOperand(expr.value, env));
+        case 'falsy':
+            return evalFalsy(resolveOperand(expr.value, env));
+        case 'and':
+            return expr.children.every((c) => evaluateExpr(c, env));
+        case 'or':
+            return expr.children.some((c) => evaluateExpr(c, env));
+        case 'not':
+            return !evaluateExpr(expr.child, env);
+    }
+}
+/**
+ * Resolve a `Mapping` against an environment: literals as given, paths
+ * via `resolvePath`. A path that doesn't resolve omits its key — the
+ * result never carries a mapped key whose value is missing. Total, like
+ * `evaluateExpr`: it never throws for a well-formed mapping.
+ */
+export function resolveMapping(mapping, env) {
+    const out = {};
+    for (const [key, operand] of Object.entries(mapping)) {
+        const value = resolveOperand(operand, env);
+        if (value !== MISSING)
+            out[key] = value;
+    }
+    return out;
+}
+function evalMembership(op, expr, env) {
+    const value = resolveOperand(expr.value, env);
+    const set = resolveOperand(expr.set, env);
+    if (value === MISSING || set === MISSING)
+        return false;
+    if (!Array.isArray(set))
+        return false;
+    const found = set.some((item) => deepEqual(item, value));
+    return op === 'in' ? found : !found;
+}
+function evalTruthy(v) {
+    if (v === MISSING)
+        return false;
+    return Boolean(v);
+}
+function evalFalsy(v) {
+    if (v === MISSING)
+        return true;
+    return !v;
+}
+function compare(op, left, right) {
+    if (op === 'eq' || op === 'ne')
+        return compareEquality(op, left, right);
+    return compareOrdering(op, left, right);
+}
+function compareEquality(op, left, right) {
+    if (left === MISSING || right === MISSING)
+        return op === 'ne' ? left !== right : false;
+    const equal = deepEqual(left, right);
+    return op === 'eq' ? equal : !equal;
+}
+function compareOrdering(op, left, right) {
+    if (left === MISSING || right === MISSING)
+        return false;
+    if (typeof left !== typeof right)
+        return false;
+    if (typeof left !== 'number' && typeof left !== 'string')
+        return false;
+    const l = left;
+    const r = right;
+    switch (op) {
+        case 'lt':
+            return l < r;
+        case 'lte':
+            return l <= r;
+        case 'gt':
+            return l > r;
+        case 'gte':
+            return l >= r;
+    }
+}
+function resolveOperand(operand, env) {
+    if (isLiteral(operand))
+        return operand.literal;
+    return resolvePath(operand.path, env);
+}
+function isLiteral(operand) {
+    return 'literal' in operand;
+}
+// Exported for tests and diagnostics; keep small and predictable.
+export function resolvePath(path, env) {
+    const segments = path.split('.');
+    const [root, ...rest] = segments;
+    if (root === undefined)
+        return MISSING;
+    if (root === 'runInput') {
+        return walk(env.runInput, rest);
+    }
+    if (root === 'state') {
+        return walk(env.state, rest);
+    }
+    if (root === 'nodeOutputs') {
+        const [nodeId, ...tail] = rest;
+        if (nodeId === undefined || nodeId === '')
+            return MISSING;
+        if (env.nodeOutputs === undefined)
+            return MISSING;
+        if (!env.nodeOutputs.has(nodeId))
+            return MISSING;
+        return walk(env.nodeOutputs.get(nodeId), tail);
+    }
+    if (root === 'iterationIndex') {
+        if (env.iterationIndex === undefined)
+            return MISSING;
+        if (rest.length > 0)
+            return MISSING;
+        return env.iterationIndex;
+    }
+    if (root === 'iterationOutput') {
+        if (env.iterationOutput === undefined)
+            return MISSING;
+        return walk(env.iterationOutput, rest);
+    }
+    return MISSING;
+}
+function walk(base, segments) {
+    let current = base;
+    if (segments.length === 0)
+        return current === undefined ? MISSING : current;
+    for (const seg of segments) {
+        if (current === null || current === undefined)
+            return MISSING;
+        if (typeof current !== 'object')
+            return MISSING;
+        const asRecord = current;
+        if (!(seg in asRecord))
+            return MISSING;
+        current = asRecord[seg];
+    }
+    return current === undefined ? MISSING : current;
+}
+/** Structural JSON equality. Handles primitives, arrays, and plain objects. */
+function deepEqual(a, b) {
+    if (a === b)
+        return true;
+    if (a === null || b === null)
+        return false;
+    if (typeof a !== typeof b)
+        return false;
+    if (typeof a !== 'object')
+        return false;
+    if (Array.isArray(a) || Array.isArray(b))
+        return arrayEqual(a, b);
+    return objectEqual(a, b);
+}
+function arrayEqual(a, b) {
+    if (!Array.isArray(a) || !Array.isArray(b))
+        return false;
+    if (a.length !== b.length)
+        return false;
+    for (let i = 0; i < a.length; i += 1) {
+        if (!deepEqual(a[i], b[i]))
+            return false;
+    }
+    return true;
+}
+function objectEqual(a, b) {
+    const ka = Object.keys(a).sort();
+    const kb = Object.keys(b).sort();
+    if (ka.length !== kb.length)
+        return false;
+    for (let i = 0; i < ka.length; i += 1)
+        if (ka[i] !== kb[i])
+            return false;
+    const aRec = a;
+    const bRec = b;
+    for (const k of ka) {
+        if (!deepEqual(aRec[k], bRec[k]))
+            return false;
+    }
+    return true;
+}
+/**
+ * Distinguishes "path resolved but value was undefined" from "path did not
+ * exist at all". Exported so tests and downstream diagnostics can identify
+ * the missing marker without depending on a private symbol.
+ */
+export const MISSING_PATH = MISSING;
+//# sourceMappingURL=evaluator.js.map

package/dist/evaluator.js.map

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