@sogni-ai/sogni-intelligence-client 2.1.0

package/dist-esm/workflows/primitives/retryUntilCondition.js

@@ -0,0 +1,95 @@
+export const RETRY_UNTIL_MAX_ATTEMPTS_CAP = 10;
+export const DEFAULT_MAX_ATTEMPTS = 3;
+export function resolveMaxAttempts(raw) {
+    if (typeof raw !== 'number' || !Number.isFinite(raw))
+        return DEFAULT_MAX_ATTEMPTS;
+    return Math.min(RETRY_UNTIL_MAX_ATTEMPTS_CAP, Math.max(1, Math.round(raw)));
+}
+export function readPath(obj, path) {
+    if (!path)
+        return obj;
+    const segments = path.split('.');
+    let current = obj;
+    for (const seg of segments) {
+        if (current === null || current === undefined)
+            return undefined;
+        if (typeof current !== 'object')
+            return undefined;
+        current = current[seg];
+    }
+    return current;
+}
+export function evaluateRetryCondition(condition, parsedResult) {
+    const observed = readPath(parsedResult, condition.path);
+    switch (condition.kind) {
+        case 'metadata_field_truthy':
+            return { passed: Boolean(observed), observed };
+        case 'metadata_field_equals':
+            return { passed: observed === condition.value, observed };
+        case 'metadata_field_gte':
+            return {
+                passed: typeof observed === 'number' && Number.isFinite(observed) && observed >= condition.value,
+                observed,
+            };
+        case 'metadata_field_lte':
+            return {
+                passed: typeof observed === 'number' && Number.isFinite(observed) && observed <= condition.value,
+                observed,
+            };
+    }
+}
+export function parseRetryUntilArgs(args) {
+    const tool = typeof args.tool === 'string' ? args.tool.trim() : '';
+    if (!tool)
+        return { ok: false, error: '`tool` is required and must be a non-empty string.' };
+    if (tool === 'wf:retry_until_condition') {
+        return { ok: false, error: '`tool` must not be wf:retry_until_condition (no recursion).' };
+    }
+    const toolArgs = (args.toolArgs && typeof args.toolArgs === 'object' && !Array.isArray(args.toolArgs))
+        ? args.toolArgs
+        : null;
+    if (!toolArgs)
+        return { ok: false, error: '`toolArgs` is required and must be an object.' };
+    const maxAttempts = resolveMaxAttempts(args.maxAttempts);
+    const backoffMs = typeof args.backoffMs === 'number' && Number.isFinite(args.backoffMs) && args.backoffMs >= 0
+        ? args.backoffMs
+        : 0;
+    let condition;
+    if (args.condition !== undefined && args.condition !== null) {
+        if (typeof args.condition !== 'object' || Array.isArray(args.condition)) {
+            return { ok: false, error: '`condition` must be an object when supplied.' };
+        }
+        const c = args.condition;
+        const kind = typeof c.kind === 'string' ? c.kind : '';
+        const path = typeof c.path === 'string' ? c.path : '';
+        if (!path)
+            return { ok: false, error: '`condition.path` is required when condition is supplied.' };
+        switch (kind) {
+            case 'metadata_field_truthy':
+                condition = { kind, path };
+                break;
+            case 'metadata_field_equals':
+                if (c.value === undefined)
+                    return { ok: false, error: '`condition.value` required for metadata_field_equals.' };
+                if (typeof c.value !== 'string' && typeof c.value !== 'number' && typeof c.value !== 'boolean') {
+                    return { ok: false, error: '`condition.value` must be a string|number|boolean for metadata_field_equals.' };
+                }
+                condition = { kind, path, value: c.value };
+                break;
+            case 'metadata_field_gte':
+            case 'metadata_field_lte':
+                if (typeof c.value !== 'number' || !Number.isFinite(c.value)) {
+                    return { ok: false, error: `\`condition.value\` must be a finite number for ${kind}.` };
+                }
+                condition = { kind, path, value: c.value };
+                break;
+            default:
+                return { ok: false, error: `Unknown condition.kind "${kind}". Valid: metadata_field_truthy|metadata_field_equals|metadata_field_gte|metadata_field_lte.` };
+        }
+    }
+    return {
+        ok: true,
+        args: { tool, toolArgs, maxAttempts, condition, backoffMs },
+    };
+}
+//# sourceMappingURL=retryUntilCondition.js.map

package/dist-esm/workflows/primitives/retryUntilCondition.js.map

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

package/dist-esm/workflows/primitives/validateWithRubric.js

@@ -0,0 +1,141 @@
+const PASS_TOKEN = '__PASS__';
+const FAIL_TOKEN = '__FAIL__';
+export function buildRubricPrompts(input) {
+    const successLine = input.successDescription
+        ? `Good output looks like: ${input.successDescription}`
+        : 'Good output satisfies every rubric item completely.';
+    const rubricList = input.rubric
+        .map((line, i) => `${i + 1}. ${line.trim()}`)
+        .join('\n');
+    const system = [
+        `You are a strict creative quality judge for ${input.artifactKind} artifacts.`,
+        successLine,
+        'Evaluate the artifact against EACH rubric item one at a time.',
+        `If ALL items pass, your ENTIRE response must be exactly: ${PASS_TOKEN}`,
+        `Otherwise, your ENTIRE response must start with: ${FAIL_TOKEN}: `,
+        'followed by a short comma-separated list of the failed item numbers and',
+        'a one-sentence summary of what the next render attempt should change.',
+        `Example fail response: ${FAIL_TOKEN}: items 1, 3 — subject identity is `
+            + 'inconsistent across panels; next attempt must lock the face shape from '
+            + 'the reference photo.',
+        'Do not output anything else. No preamble. No analysis.',
+    ].join('\n');
+    const artifactBlock = input.artifactKind === 'text'
+        ? `<text-artifact>\n${(input.artifactInline ?? '').trim()}\n</text-artifact>`
+        : input.artifactUrl
+            ? `<${input.artifactKind}-artifact src="${input.artifactUrl}"/>`
+            : '<artifact missing/>';
+    const user = [
+        'Rubric:',
+        rubricList,
+        '',
+        'Artifact to evaluate:',
+        artifactBlock,
+    ].join('\n');
+    return { system, user };
+}
+export function parseJudgeResponse(raw, rubric) {
+    const cleaned = (raw ?? '').trim();
+    if (cleaned.startsWith(PASS_TOKEN)) {
+        return { pass: true, failedCriteria: [], notes: cleaned, suggestedRetryNotes: '' };
+    }
+    if (cleaned.startsWith(FAIL_TOKEN)) {
+        const afterToken = cleaned.slice(FAIL_TOKEN.length).replace(/^\s*:?\s*/, '');
+        return {
+            pass: false,
+            failedCriteria: extractFailedCriteria(afterToken, rubric),
+            notes: afterToken,
+            suggestedRetryNotes: afterToken,
+        };
+    }
+    if (cleaned.includes(PASS_TOKEN) && !cleaned.includes(FAIL_TOKEN)) {
+        return { pass: true, failedCriteria: [], notes: cleaned, suggestedRetryNotes: '' };
+    }
+    return {
+        pass: false,
+        failedCriteria: extractFailedCriteria(cleaned, rubric),
+        notes: cleaned || 'Judge returned an empty or unparseable response.',
+        suggestedRetryNotes: cleaned || 'Re-render with more attention to the rubric items above.',
+    };
+}
+function extractFailedCriteria(text, rubric) {
+    const matches = [];
+    const numberRegex = /\bitems?\s+([\d,\s]+)/i;
+    const m = text.match(numberRegex);
+    if (m) {
+        const nums = m[1]
+            .split(',')
+            .map((s) => s.trim())
+            .map((s) => Number(s))
+            .filter((n) => Number.isInteger(n) && n >= 1 && n <= rubric.length);
+        for (const n of nums)
+            matches.push(rubric[n - 1]);
+    }
+    return matches;
+}
+export { PASS_TOKEN, FAIL_TOKEN };
+export function assertArtifactUrlIsSafe(url) {
+    let parsed;
+    try {
+        parsed = new URL(url);
+    }
+    catch {
+        return { ok: false, reason: 'artifactUrl is not a valid URL' };
+    }
+    if (parsed.protocol !== 'https:' && parsed.protocol !== 'http:') {
+        return {
+            ok: false,
+            reason: `artifactUrl protocol "${parsed.protocol}" is not supported (http/https only)`,
+        };
+    }
+    if (parsed.username || parsed.password) {
+        return { ok: false, reason: 'artifactUrl must not contain userinfo credentials' };
+    }
+    const host = parsed.hostname.toLowerCase();
+    if (!host)
+        return { ok: false, reason: 'artifactUrl host is empty' };
+    const bareHost = host.startsWith('[') && host.endsWith(']') ? host.slice(1, -1) : host;
+    const loopback = new Set(['localhost', '127.0.0.1', '0.0.0.0', '::', '::1']);
+    if (loopback.has(bareHost)) {
+        return { ok: false, reason: `artifactUrl host "${bareHost}" is a loopback address` };
+    }
+    if (bareHost.endsWith('.localhost') || bareHost.endsWith('.local')) {
+        return {
+            ok: false,
+            reason: `artifactUrl host "${bareHost}" is on a local network suffix`,
+        };
+    }
+    if (/^(::ffff:|64:ff9b:)/i.test(bareHost)) {
+        return {
+            ok: false,
+            reason: `artifactUrl host "${bareHost}" is an IPv4-embedded IPv6 address`,
+        };
+    }
+    if (PRIVATE_IPV4_PATTERNS.some((re) => re.test(bareHost))) {
+        return {
+            ok: false,
+            reason: `artifactUrl host "${bareHost}" is in a private/link-local IPv4 range`,
+        };
+    }
+    if (PRIVATE_IPV6_PATTERNS.some((re) => re.test(bareHost))) {
+        return {
+            ok: false,
+            reason: `artifactUrl host "${bareHost}" is in a private/link-local IPv6 range`,
+        };
+    }
+    return { ok: true };
+}
+const PRIVATE_IPV4_PATTERNS = [
+    /^10\.\d{1,3}\.\d{1,3}\.\d{1,3}$/,
+    /^192\.168\.\d{1,3}\.\d{1,3}$/,
+    /^172\.(1[6-9]|2[0-9]|3[01])\.\d{1,3}\.\d{1,3}$/,
+    /^169\.254\.\d{1,3}\.\d{1,3}$/,
+    /^127\.\d{1,3}\.\d{1,3}\.\d{1,3}$/,
+    /^0\.\d{1,3}\.\d{1,3}\.\d{1,3}$/,
+];
+const PRIVATE_IPV6_PATTERNS = [
+    /^fe80::/i,
+    /^fc00:/i,
+    /^fd[0-9a-f]{2}:/i,
+];
+//# sourceMappingURL=validateWithRubric.js.map

package/dist-esm/workflows/primitives/validateWithRubric.js.map

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

package/dist-esm/workflows/summarize.js

@@ -0,0 +1,51 @@
+const DEFAULT_MAX_LENGTH = 320;
+export function summarizeWorkflowTemplate(template, options = {}) {
+    const maxLength = options.maxDescriptionLength ?? DEFAULT_MAX_LENGTH;
+    const includeInputs = options.includeInputsSentence ?? true;
+    const base = template.description?.trim() || template.name.trim();
+    const inputsSentence = includeInputs ? buildInputsSentence(template.inputs) : '';
+    const stagesSentence = buildStagesSentence(template);
+    const parts = [base, stagesSentence, inputsSentence].filter((part) => part.length > 0);
+    const merged = parts.join(' ');
+    return truncateOnBoundary(merged, maxLength);
+}
+function buildStagesSentence(template) {
+    const stageCount = template.stages.length;
+    if (stageCount === 0)
+        return '';
+    const interactiveCount = template.stages.filter((stage) => stage.type === 'interactive').length;
+    const batchCount = template.stages.filter((stage) => stage.type === 'batch').length;
+    const fragments = [`${stageCount} ${stageCount === 1 ? 'stage' : 'stages'}`];
+    if (batchCount > 0)
+        fragments.push(`${batchCount} batch`);
+    if (interactiveCount > 0)
+        fragments.push(`${interactiveCount} interactive`);
+    return `(${fragments.join(', ')}).`;
+}
+function buildInputsSentence(inputs) {
+    const declared = inputs.filter((input) => !input.internal);
+    if (declared.length === 0)
+        return 'No inputs required.';
+    const requiredNames = declared
+        .filter((input) => input.required)
+        .map((input) => `${input.name} (${input.type})`);
+    const optionalNames = declared
+        .filter((input) => !input.required)
+        .map((input) => `${input.name} (${input.type})`);
+    const parts = [];
+    if (requiredNames.length > 0)
+        parts.push(`Required inputs: ${requiredNames.join(', ')}.`);
+    if (optionalNames.length > 0)
+        parts.push(`Optional inputs: ${optionalNames.join(', ')}.`);
+    return parts.join(' ');
+}
+function truncateOnBoundary(text, maxLength) {
+    if (text.length <= maxLength)
+        return text;
+    const slice = text.slice(0, maxLength);
+    const lastSpace = slice.lastIndexOf(' ');
+    if (lastSpace <= 0)
+        return `${slice.trimEnd()}…`;
+    return `${slice.slice(0, lastSpace).trimEnd()}…`;
+}
+//# sourceMappingURL=summarize.js.map

package/dist-esm/workflows/summarize.js.map

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

package/dist-esm/workflows/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist-esm/workflows/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/workflows/types.ts"],"names":[],"mappings":""}

package/dist-esm/workflows/validation.js

@@ -0,0 +1,330 @@
+import { collectBindings, parseBinding, BindingError } from './bindings.js';
+export function validateWorkflow(def) {
+    const issues = [];
+    const stageIds = new Set();
+    for (const stage of walkStages(def.stages)) {
+        if (stageIds.has(stage.id)) {
+            issues.push({
+                severity: 'error',
+                code: 'duplicate_stage_id',
+                message: `Duplicate stage id: ${stage.id}`,
+                path: `stages/${stage.id}`,
+            });
+        }
+        stageIds.add(stage.id);
+    }
+    const inputNames = new Set();
+    for (const input of def.inputs) {
+        if (inputNames.has(input.name)) {
+            issues.push({
+                severity: 'error',
+                code: 'duplicate_input_name',
+                message: `Duplicate input name: ${input.name}`,
+                path: `inputs/${input.name}`,
+            });
+        }
+        inputNames.add(input.name);
+    }
+    const flatStages = Array.from(walkStages(def.stages));
+    const producerIndex = {};
+    flatStages.forEach((stage, idx) => {
+        for (const name of stage.produces ?? []) {
+            if (name in producerIndex) {
+                issues.push({
+                    severity: 'warning',
+                    code: 'duplicate_artifact_producer',
+                    message: `Artifact "${name}" is produced by multiple stages. Downstream stages will see the last write.`,
+                    path: `stages/${stage.id}/produces`,
+                });
+            }
+            else {
+                producerIndex[name] = idx;
+            }
+        }
+    });
+    flatStages.forEach((stage, idx) => {
+        for (const name of stage.requiredArtifactsIn ?? []) {
+            if (!(name in producerIndex)) {
+                issues.push({
+                    severity: 'error',
+                    code: 'missing_artifact_producer',
+                    message: `Stage "${stage.id}" requires artifact "${name}" but no earlier stage produces it.`,
+                    path: `stages/${stage.id}/requiredArtifactsIn`,
+                });
+                continue;
+            }
+            if (producerIndex[name] >= idx) {
+                issues.push({
+                    severity: 'error',
+                    code: 'forward_artifact_reference',
+                    message: `Stage "${stage.id}" requires "${name}" but its producer runs later.`,
+                    path: `stages/${stage.id}/requiredArtifactsIn`,
+                });
+            }
+        }
+        for (const name of stage.optionalArtifactsIn ?? []) {
+            if (!(name in producerIndex)) {
+                issues.push({
+                    severity: 'warning',
+                    code: 'missing_optional_artifact',
+                    message: `Optional artifact "${name}" has no producer and will never be available.`,
+                    path: `stages/${stage.id}/optionalArtifactsIn`,
+                });
+            }
+        }
+    });
+    for (const { stage, inBatchItem } of walkStageContexts(def.stages)) {
+        const bindings = collectStageBindings(stage);
+        for (const binding of bindings) {
+            try {
+                const parsed = parseBinding(binding);
+                if (parsed.root === 'inputs') {
+                    const firstField = parsed.segments.find((s) => s.kind === 'field');
+                    if (firstField && firstField.kind === 'field' && !inputNames.has(firstField.name)) {
+                        issues.push({
+                            severity: 'error',
+                            code: 'unknown_input',
+                            message: `Binding "${binding}" references unknown input "${firstField.name}".`,
+                            path: `stages/${stage.id}/args`,
+                        });
+                    }
+                }
+                if (parsed.root === 'artifacts') {
+                    const firstField = parsed.segments.find((s) => s.kind === 'field');
+                    if (firstField && firstField.kind === 'field' && !(firstField.name in producerIndex)) {
+                        issues.push({
+                            severity: 'error',
+                            code: 'unknown_artifact',
+                            message: `Binding "${binding}" references unknown artifact "${firstField.name}".`,
+                            path: `stages/${stage.id}/args`,
+                        });
+                    }
+                }
+                if (parsed.root === 'item' && !inBatchItem && stage.type !== 'batch' && !stage.subStages?.length) {
+                    issues.push({
+                        severity: 'error',
+                        code: 'item_binding_outside_batch',
+                        message: `Stage "${stage.id}" uses $item but is not inside a batch.`,
+                        path: `stages/${stage.id}/args`,
+                    });
+                }
+            }
+            catch (err) {
+                if (err instanceof BindingError) {
+                    issues.push({
+                        severity: 'error',
+                        code: 'invalid_binding_syntax',
+                        message: err.message,
+                        path: `stages/${stage.id}/args`,
+                    });
+                }
+                else {
+                    throw err;
+                }
+            }
+        }
+    }
+    const graph = {};
+    for (const stage of flatStages) {
+        graph[stage.id] = [];
+        for (const name of [...(stage.requiredArtifactsIn ?? []), ...(stage.optionalArtifactsIn ?? [])]) {
+            const producerIdx = producerIndex[name];
+            if (producerIdx !== undefined) {
+                const producerStage = flatStages[producerIdx];
+                if (producerStage)
+                    graph[stage.id].push(producerStage.id);
+            }
+        }
+    }
+    const cycle = findCycle(graph);
+    if (cycle) {
+        issues.push({
+            severity: 'error',
+            code: 'cyclic_stage_dependency',
+            message: `Cyclic artifact dependency detected: ${cycle.join(' → ')}`,
+            path: `stages`,
+        });
+    }
+    for (const stage of flatStages) {
+        if (stage.type === 'batch') {
+            if (!stage.overBinding.startsWith('$')) {
+                issues.push({
+                    severity: 'error',
+                    code: 'batch_over_binding_not_a_binding',
+                    message: `Batch stage "${stage.id}" overBinding must be a $... binding.`,
+                    path: `stages/${stage.id}/overBinding`,
+                });
+            }
+            if (!stage.itemName) {
+                issues.push({
+                    severity: 'error',
+                    code: 'batch_item_name_required',
+                    message: `Batch stage "${stage.id}" must declare itemName.`,
+                    path: `stages/${stage.id}/itemName`,
+                });
+            }
+            if (stage.concurrency !== undefined && stage.concurrency < 1) {
+                issues.push({
+                    severity: 'error',
+                    code: 'batch_concurrency_invalid',
+                    message: `Batch stage "${stage.id}" concurrency must be ≥ 1.`,
+                    path: `stages/${stage.id}/concurrency`,
+                });
+            }
+        }
+    }
+    const hasErrors = issues.some((i) => i.severity === 'error');
+    return { valid: !hasErrors, issues };
+}
+export function computeStaleStageIds(run, mutatedArtifactNames) {
+    if (mutatedArtifactNames.length === 0)
+        return [];
+    const flat = Array.from(walkStages(run.workflowSnapshot.stages));
+    const producerIndex = {};
+    flat.forEach((stage, idx) => {
+        for (const name of stage.produces ?? []) {
+            if (!(name in producerIndex))
+                producerIndex[name] = idx;
+        }
+    });
+    const liveArtifacts = new Set(mutatedArtifactNames);
+    const stale = new Set();
+    let startIdx = Infinity;
+    for (const name of mutatedArtifactNames) {
+        const idx = producerIndex[name];
+        if (idx !== undefined && idx < startIdx)
+            startIdx = idx;
+    }
+    if (!Number.isFinite(startIdx))
+        return [];
+    for (let i = startIdx; i < flat.length; i++) {
+        const stage = flat[i];
+        const consumes = [
+            ...(stage.requiredArtifactsIn ?? []),
+            ...(stage.optionalArtifactsIn ?? []),
+        ];
+        const touchesLive = consumes.some((name) => liveArtifacts.has(name));
+        if (touchesLive) {
+            stale.add(stage.id);
+            for (const name of stage.produces ?? [])
+                liveArtifacts.add(name);
+        }
+    }
+    return Array.from(stale);
+}
+const TRANSIENT_ITEM_FIELDS = [
+    'status',
+    'progress',
+    'workerName',
+    'error',
+];
+export function persistedArtifactItem(item) {
+    const clone = { ...item };
+    for (const field of TRANSIENT_ITEM_FIELDS) {
+        delete clone[field];
+    }
+    return clone;
+}
+export function persistedArtifact(artifact) {
+    return {
+        ...artifact,
+        items: artifact.items.map(persistedArtifactItem),
+    };
+}
+export function persistedRun(run) {
+    const artifacts = {};
+    for (const [name, artifact] of Object.entries(run.artifacts)) {
+        artifacts[name] = persistedArtifact(artifact);
+    }
+    const stages = run.stages.map((s) => s.state === 'running' ? { ...s, state: 'pending' } : s);
+    return { ...run, artifacts, stages };
+}
+export function* walkStages(stages) {
+    for (const stage of stages) {
+        yield stage;
+        if (stage.subStages?.length) {
+            yield* walkStages(stage.subStages);
+        }
+        if (stage.type === 'batch') {
+            yield stage.itemStage;
+        }
+    }
+}
+export function getFlatWorkflowStages(stages) {
+    return Array.from(walkStages(stages));
+}
+export function getCurrentRunStage(run) {
+    return getFlatWorkflowStages(run.workflowSnapshot.stages)[run.currentStageIndex];
+}
+function* walkStageContexts(stages, inBatchItem = false) {
+    for (const stage of stages) {
+        yield { stage, inBatchItem };
+        if (stage.subStages?.length) {
+            yield* walkStageContexts(stage.subStages, inBatchItem);
+        }
+        if (stage.type === 'batch') {
+            yield* walkStageContexts([stage.itemStage], true);
+        }
+    }
+}
+function collectStageBindings(stage) {
+    const out = [];
+    if (stage.type === 'fixed') {
+        out.push(...collectBindings(stage.args));
+    }
+    if (stage.type === 'interactive') {
+        void stage;
+    }
+    if (stage.type === 'batch') {
+        const b = stage;
+        out.push(b.overBinding);
+        if (b.itemStage.type === 'fixed') {
+            out.push(...collectBindings(b.itemStage.args));
+        }
+    }
+    return out;
+}
+function findCycle(graph) {
+    const WHITE = 0;
+    const GRAY = 1;
+    const BLACK = 2;
+    const color = {};
+    const parent = {};
+    for (const id of Object.keys(graph))
+        color[id] = WHITE;
+    for (const start of Object.keys(graph)) {
+        if (color[start] !== WHITE)
+            continue;
+        const stack = [start];
+        parent[start] = null;
+        while (stack.length > 0) {
+            const id = stack[stack.length - 1];
+            if (color[id] === WHITE)
+                color[id] = GRAY;
+            let advanced = false;
+            for (const next of graph[id] ?? []) {
+                if (color[next] === WHITE) {
+                    parent[next] = id;
+                    stack.push(next);
+                    advanced = true;
+                    break;
+                }
+                if (color[next] === GRAY) {
+                    const cycle = [next, id];
+                    let p = parent[id];
+                    while (p && p !== next) {
+                        cycle.push(p);
+                        p = parent[p];
+                    }
+                    return cycle.reverse();
+                }
+            }
+            if (!advanced) {
+                color[id] = BLACK;
+                stack.pop();
+            }
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=validation.js.map