@rk0429/agentic-relay 19.4.3 → 19.5.0

package/dist/domain/loop-execution.js

@@ -0,0 +1,419 @@
+import { randomUUID } from "node:crypto";
+import { ValidationError } from "../core/errors.js";
+const UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+export const LOOP_EXECUTION_SCHEMA_VERSION = 1;
+export class LoopExecutionId {
+    value;
+    constructor(value) {
+        this.value = value;
+    }
+    static create() {
+        return new LoopExecutionId(randomUUID());
+    }
+    static restore(value) {
+        if (!UUID_PATTERN.test(value)) {
+            throw new ValidationError(`Invalid loop execution id: ${value}`, {
+                recoveryHint: "Loop execution IDs must be UUID strings.",
+            });
+        }
+        return new LoopExecutionId(value);
+    }
+    toString() {
+        return this.value;
+    }
+}
+export class NestDepth {
+    value;
+    maxDepth;
+    constructor(value, maxDepth = 5) {
+        if (!Number.isInteger(value) || value < 0) {
+            throw new ValidationError(`Invalid nest depth value: ${value}`, {
+                recoveryHint: "Nest depth must be a non-negative integer.",
+            });
+        }
+        if (!Number.isInteger(maxDepth) || maxDepth <= 0) {
+            throw new ValidationError(`Invalid max nest depth: ${maxDepth}`, {
+                recoveryHint: "Nest depth maxDepth must be a positive integer.",
+            });
+        }
+        this.value = value;
+        this.maxDepth = maxDepth;
+    }
+    increment() {
+        return new NestDepth(this.value + 1, this.maxDepth);
+    }
+    isAtLimit() {
+        return this.value >= this.maxDepth;
+    }
+}
+export class LoopExecution {
+    workflow;
+    executionIdValue;
+    nestDepthValue;
+    workflowPathValue;
+    workflowDigestValue;
+    statusValue;
+    currentIterationValue;
+    stepResultsValue;
+    completionReasonValue;
+    initialSessionIdValue;
+    pendingExitConditionValue;
+    nextStepIdValue;
+    startedAtValue;
+    completedAtValue;
+    constructor(options) {
+        assertNonEmptyString(options.workflowPath, "workflowPath");
+        assertNonEmptyString(options.workflowDigest, "workflowDigest");
+        assertTimestamp(options.startedAt, "startedAt");
+        if (options.completedAt) {
+            assertTimestamp(options.completedAt, "completedAt");
+        }
+        if (!Number.isInteger(options.currentIteration) || options.currentIteration < 0) {
+            throw new ValidationError(`Invalid current iteration: ${options.currentIteration}`, {
+                recoveryHint: "Current iteration must be a non-negative integer.",
+            });
+        }
+        validateStepResults(options.stepResults);
+        this.workflow = options.workflow;
+        this.executionIdValue = options.executionId;
+        this.nestDepthValue = options.nestDepth;
+        this.workflowPathValue = options.workflowPath;
+        this.workflowDigestValue = options.workflowDigest;
+        this.statusValue = options.status;
+        this.currentIterationValue = options.currentIteration;
+        this.stepResultsValue = cloneStepResults(options.stepResults);
+        this.startedAtValue = options.startedAt;
+        this.initialSessionIdValue = options.initialSessionId ?? null;
+        this.pendingExitConditionValue = options.pendingExitCondition ?? null;
+        this.nextStepIdValue = options.nextStepId ?? null;
+        this.completionReasonValue = options.completionReason;
+        this.completedAtValue = options.completedAt;
+    }
+    static create(workflow, options) {
+        return new LoopExecution({
+            workflow,
+            executionId: LoopExecutionId.create(),
+            nestDepth: options.nestDepth,
+            workflowPath: options.workflowPath,
+            workflowDigest: options.workflowDigest,
+            status: "created",
+            currentIteration: 0,
+            stepResults: [],
+            startedAt: options.startedAt ?? new Date().toISOString(),
+            initialSessionId: options.initialSessionId ?? null,
+            nextStepId: workflow.steps[0]?.id ?? null,
+        });
+    }
+    static resume(workflow, state, nestDepth) {
+        if (state.schemaVersion !== LOOP_EXECUTION_SCHEMA_VERSION) {
+            throw new ValidationError(`Unsupported loop interrupt state schema version: ${state.schemaVersion}`, {
+                recoveryHint: "Only schemaVersion 1 is currently supported.",
+            });
+        }
+        if (state.frames.length === 0) {
+            throw new ValidationError("Loop interrupt state must contain at least one frame.", {
+                recoveryHint: "Retry resume with a valid loop state file.",
+            });
+        }
+        assertTimestamp(state.startedAt, "startedAt");
+        assertTimestamp(state.interruptedAt, "interruptedAt");
+        const frame = state.frames[state.frames.length - 1];
+        validateWorkflowResumeFrame(frame);
+        return new LoopExecution({
+            workflow,
+            executionId: LoopExecutionId.restore(state.executionId),
+            nestDepth,
+            workflowPath: frame.workflowPath,
+            workflowDigest: frame.workflowDigest,
+            status: "running",
+            currentIteration: frame.currentIteration,
+            stepResults: frame.stepResults,
+            startedAt: state.startedAt,
+            initialSessionId: frame.initialSessionId ?? null,
+            nextStepId: frame.pendingExitCondition === undefined
+                ? frame.nextStepId ??
+                    deriveNextStepId(workflow, frame.currentIteration, frame.stepResults)
+                : frame.nextStepId ?? null,
+            pendingExitCondition: frame.pendingExitCondition ?? null,
+        });
+    }
+    get executionId() {
+        return this.executionIdValue.value;
+    }
+    get executionIdObject() {
+        return this.executionIdValue;
+    }
+    get status() {
+        return this.statusValue;
+    }
+    get currentIteration() {
+        return this.currentIterationValue;
+    }
+    get stepResults() {
+        return cloneStepResults(this.stepResultsValue);
+    }
+    get completionReason() {
+        return this.completionReasonValue;
+    }
+    get nestDepth() {
+        return this.nestDepthValue;
+    }
+    get initialSessionId() {
+        return this.initialSessionIdValue;
+    }
+    get pendingExitCondition() {
+        return this.pendingExitConditionValue;
+    }
+    get nextStepId() {
+        return this.nextStepIdValue;
+    }
+    get startedAt() {
+        return this.startedAtValue;
+    }
+    get completedAt() {
+        return this.completedAtValue;
+    }
+    get workflowPath() {
+        return this.workflowPathValue;
+    }
+    get workflowDigest() {
+        return this.workflowDigestValue;
+    }
+    start() {
+        if (this.statusValue !== "created") {
+            throw new ValidationError(`Loop execution cannot start from status "${this.statusValue}".`, {
+                recoveryHint: 'Only loop executions in "created" status can be started.',
+            });
+        }
+        this.statusValue = "running";
+        this.nextStepIdValue = this.workflow.steps[0]?.id ?? null;
+    }
+    beginIteration() {
+        this.assertRunning("beginIteration");
+        if (this.currentIterationValue >= this.workflow.loop.maxIterations) {
+            throw new ValidationError(`Cannot begin iteration ${this.currentIterationValue + 1}; max_iterations is ${this.workflow.loop.maxIterations}.`, {
+                recoveryHint: "Complete the loop execution instead of starting another iteration.",
+            });
+        }
+        this.currentIterationValue += 1;
+        this.pendingExitConditionValue = null;
+        this.nextStepIdValue = this.workflow.steps[0]?.id ?? null;
+    }
+    recordStepResult(result) {
+        this.assertRunning("recordStepResult");
+        validateStepResult(result);
+        if (result.iteration !== this.currentIterationValue) {
+            throw new ValidationError(`Step result iteration ${result.iteration} does not match current iteration ${this.currentIterationValue}.`, {
+                recoveryHint: "Record step results against the active iteration only.",
+            });
+        }
+        const stepIndex = this.workflow.steps.findIndex((step) => step.id === result.stepId);
+        if (stepIndex === -1) {
+            throw new ValidationError(`Unknown step id "${result.stepId}" for this workflow.`, {
+                recoveryHint: "Record results only for steps that exist in the workflow definition.",
+            });
+        }
+        this.stepResultsValue = upsertStepResult(this.stepResultsValue, result);
+        if (result.status === "running" || result.status === "pending") {
+            this.nextStepIdValue = result.stepId;
+            return;
+        }
+        this.nextStepIdValue = this.workflow.steps[stepIndex + 1]?.id ?? null;
+    }
+    shouldEvaluateAfter(stepId) {
+        const exitCondition = this.workflow.loop.exitCondition;
+        if (!exitCondition) {
+            return false;
+        }
+        const evaluateAfter = exitCondition.evaluateAfter ?? this.workflow.steps.at(-1)?.id;
+        return evaluateAfter === stepId;
+    }
+    applyExitVerdict(verdict, options) {
+        this.assertRunning("applyExitVerdict");
+        if (verdict === "continue") {
+            this.pendingExitConditionValue = null;
+            return;
+        }
+        const evaluatedAfter = options?.evaluatedAfter ?? findLastCompletedStepId(this.stepResultsValue, this.currentIterationValue);
+        if (evaluatedAfter) {
+            const evaluatedAfterIndex = this.workflow.steps.findIndex((step) => step.id === evaluatedAfter);
+            if (evaluatedAfterIndex >= 0) {
+                for (const step of this.workflow.steps.slice(evaluatedAfterIndex + 1)) {
+                    const existingResult = this.stepResultsValue.find((candidate) => candidate.iteration === this.currentIterationValue &&
+                        candidate.stepId === step.id);
+                    if (existingResult) {
+                        continue;
+                    }
+                    this.stepResultsValue.push({
+                        stepId: step.id,
+                        iteration: this.currentIterationValue,
+                        status: "skipped",
+                    });
+                }
+            }
+        }
+        this.pendingExitConditionValue = null;
+        this.nextStepIdValue = null;
+        this.complete("exit_condition_met", options?.completedAt);
+    }
+    interrupt(options) {
+        this.assertRunning("interrupt");
+        const interruptedAt = options?.interruptedAt ?? new Date().toISOString();
+        assertTimestamp(interruptedAt, "interruptedAt");
+        const frame = {
+            workflowPath: this.workflowPathValue,
+            workflowDigest: this.workflowDigestValue,
+            currentIteration: this.currentIterationValue,
+            stepResults: cloneStepResults(this.stepResultsValue),
+            nextStepId: options?.nextStepId === undefined
+                ? this.nextStepIdValue ?? undefined
+                : options.nextStepId ?? undefined,
+            initialSessionId: this.initialSessionIdValue ?? undefined,
+            pendingExitCondition: options?.pendingExitCondition === undefined
+                ? this.pendingExitConditionValue ?? undefined
+                : options.pendingExitCondition ?? undefined,
+        };
+        this.statusValue = "interrupted";
+        this.nextStepIdValue = frame.nextStepId ?? null;
+        this.pendingExitConditionValue = frame.pendingExitCondition ?? null;
+        return {
+            schemaVersion: LOOP_EXECUTION_SCHEMA_VERSION,
+            executionId: this.executionIdValue.value,
+            startedAt: this.startedAtValue,
+            frames: [frame],
+            interruptedAt,
+        };
+    }
+    complete(reason, completedAt = new Date().toISOString()) {
+        this.assertRunning("complete");
+        assertTimestamp(completedAt, "completedAt");
+        this.statusValue = "completed";
+        this.completionReasonValue = reason;
+        this.completedAtValue = completedAt;
+        this.pendingExitConditionValue = null;
+        this.nextStepIdValue = null;
+    }
+    toProgressSnapshot() {
+        return {
+            executionId: this.executionIdValue.value,
+            workflowName: this.workflow.name,
+            currentIteration: this.currentIterationValue,
+            maxIterations: this.workflow.loop.maxIterations,
+            startedAt: this.startedAtValue,
+            steps: this.workflow.steps.map((step) => {
+                const currentResult = findLatestStepResult(this.stepResultsValue, step.id, this.currentIterationValue);
+                return {
+                    stepId: step.id,
+                    kind: isWorkflowStep(step) ? "workflow" : "agent",
+                    status: this.currentIterationValue === 0
+                        ? "pending"
+                        : currentResult?.status ?? "pending",
+                    backend: isWorkflowStep(step) ? undefined : step.backend,
+                    role: isWorkflowStep(step) ? undefined : step.role,
+                    duration: currentResult?.duration,
+                };
+            }),
+        };
+    }
+    assertRunning(operation) {
+        if (this.statusValue !== "running") {
+            throw new ValidationError(`Loop execution cannot ${operation} while status is "${this.statusValue}".`, {
+                recoveryHint: 'Only loop executions in "running" status support this operation.',
+            });
+        }
+    }
+}
+function validateWorkflowResumeFrame(frame) {
+    assertNonEmptyString(frame.workflowPath, "workflowPath");
+    assertNonEmptyString(frame.workflowDigest, "workflowDigest");
+    if (!Number.isInteger(frame.currentIteration) || frame.currentIteration < 0) {
+        throw new ValidationError(`Invalid interrupt state currentIteration: ${frame.currentIteration}`, {
+            recoveryHint: "Interrupt states must store a non-negative currentIteration.",
+        });
+    }
+    validateStepResults(frame.stepResults);
+}
+function validateStepResults(results) {
+    for (const result of results) {
+        validateStepResult(result);
+    }
+}
+function validateStepResult(result) {
+    assertNonEmptyString(result.stepId, "stepId");
+    if (!Number.isInteger(result.iteration) || result.iteration <= 0) {
+        throw new ValidationError(`Invalid step result iteration: ${result.iteration}`, {
+            recoveryHint: "Step result iteration must be a positive integer.",
+        });
+    }
+    if (!["pending", "running", "completed", "failed", "skipped"].includes(result.status)) {
+        throw new ValidationError(`Invalid step result status: ${result.status}`, {
+            recoveryHint: "Step result status must be one of pending, running, completed, failed, or skipped.",
+        });
+    }
+    if (result.duration !== undefined && (!Number.isFinite(result.duration) || result.duration < 0)) {
+        throw new ValidationError(`Invalid step result duration: ${result.duration}`, {
+            recoveryHint: "Step result duration must be a non-negative number.",
+        });
+    }
+}
+function upsertStepResult(results, result) {
+    const next = cloneStepResults(results);
+    const existingIndex = next.findIndex((candidate) => candidate.stepId === result.stepId && candidate.iteration === result.iteration);
+    if (existingIndex >= 0) {
+        next[existingIndex] = { ...result };
+        return next;
+    }
+    next.push({ ...result });
+    return next;
+}
+function cloneStepResults(results) {
+    return results.map((result) => ({ ...result }));
+}
+function deriveNextStepId(workflow, currentIteration, stepResults) {
+    if (currentIteration === 0) {
+        return workflow.steps[0]?.id ?? null;
+    }
+    for (const step of workflow.steps) {
+        const hasResultForIteration = stepResults.some((candidate) => candidate.stepId === step.id && candidate.iteration === currentIteration);
+        if (!hasResultForIteration) {
+            return step.id;
+        }
+    }
+    return null;
+}
+function findLastCompletedStepId(stepResults, iteration) {
+    for (let index = stepResults.length - 1; index >= 0; index -= 1) {
+        const candidate = stepResults[index];
+        if (candidate.iteration === iteration && candidate.status === "completed") {
+            return candidate.stepId;
+        }
+    }
+    return undefined;
+}
+function findLatestStepResult(stepResults, stepId, iteration) {
+    for (let index = stepResults.length - 1; index >= 0; index -= 1) {
+        const candidate = stepResults[index];
+        if (candidate.stepId === stepId && candidate.iteration === iteration) {
+            return candidate;
+        }
+    }
+    return undefined;
+}
+function isWorkflowStep(step) {
+    return "workflow" in step;
+}
+function assertNonEmptyString(value, field) {
+    if (value.trim().length === 0) {
+        throw new ValidationError(`Invalid ${field}: value must not be empty.`, {
+            recoveryHint: `${field} must be a non-empty string.`,
+        });
+    }
+}
+function assertTimestamp(value, field) {
+    if (Number.isNaN(Date.parse(value))) {
+        throw new ValidationError(`Invalid ${field}: ${value}`, {
+            recoveryHint: `${field} must be a valid ISO 8601 timestamp.`,
+        });
+    }
+}
+//# sourceMappingURL=loop-execution.js.map

package/dist/domain/loop-execution.js.map

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

package/dist/domain/session-resolver.d.ts

@@ -0,0 +1,6 @@
+import type { StepResult } from "./loop-execution.js";
+import type { StepDefinition } from "./workflow-schema.js";
+export declare function resolve(stepDef: StepDefinition, currentIteration: number, stepResults: StepResult[], initialSessionId?: string): string | null;
+export declare const SessionResolver: {
+    resolve: typeof resolve;
+};

package/dist/domain/session-resolver.js

@@ -0,0 +1,49 @@
+import { ValidationError } from "../core/errors.js";
+export function resolve(stepDef, currentIteration, stepResults, initialSessionId) {
+    if (!Number.isInteger(currentIteration) || currentIteration <= 0) {
+        throw new ValidationError(`Invalid current iteration for session resolution: ${currentIteration}`, {
+            recoveryHint: "currentIteration must be a positive integer.",
+        });
+    }
+    if (stepDef.session === undefined) {
+        if (initialSessionId && stepResults.length === 0) {
+            return initialSessionId;
+        }
+        return null;
+    }
+    const inheritFromStepId = stepDef.session.inheritFrom;
+    const targetIteration = inheritFromStepId === stepDef.id ? currentIteration - 1 : currentIteration;
+    if (inheritFromStepId === stepDef.id && currentIteration === 1) {
+        return null;
+    }
+    const targetResult = findLatestStepResult(stepResults, inheritFromStepId, targetIteration);
+    if (!targetResult) {
+        throw new ValidationError(`Step "${stepDef.id}" cannot inherit session from "${inheritFromStepId}" in iteration ${targetIteration}: the referenced step has not completed yet.`, {
+            recoveryHint: "inherit_from can only reference completed steps in the current workflow frame.",
+        });
+    }
+    if (targetResult.status !== "completed") {
+        throw new ValidationError(`Step "${stepDef.id}" cannot inherit session from "${inheritFromStepId}" in iteration ${targetIteration}: referenced step status is "${targetResult.status}".`, {
+            recoveryHint: "inherit_from can only reference completed steps. Failed, skipped, pending, and running steps are invalid.",
+        });
+    }
+    if (!targetResult.relaySessionId) {
+        throw new ValidationError(`Step "${stepDef.id}" cannot inherit session from "${inheritFromStepId}" in iteration ${targetIteration}: relaySessionId is missing.`, {
+            recoveryHint: "Only completed step results with relaySessionId can be used for session inheritance.",
+        });
+    }
+    return targetResult.relaySessionId;
+}
+export const SessionResolver = {
+    resolve,
+};
+function findLatestStepResult(stepResults, stepId, iteration) {
+    for (let index = stepResults.length - 1; index >= 0; index -= 1) {
+        const candidate = stepResults[index];
+        if (candidate.stepId === stepId && candidate.iteration === iteration) {
+            return candidate;
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=session-resolver.js.map

package/dist/domain/session-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-resolver.js","sourceRoot":"","sources":["../../src/domain/session-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAIpD,MAAM,UAAU,OAAO,CACrB,OAAuB,EACvB,gBAAwB,EACxB,WAAyB,EACzB,gBAAyB;IAEzB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,gBAAgB,CAAC,IAAI,gBAAgB,IAAI,CAAC,EAAE,CAAC;QACjE,MAAM,IAAI,eAAe,CACvB,qDAAqD,gBAAgB,EAAE,EACvE;YACE,YAAY,EAAE,8CAA8C;SAC7D,CACF,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAClC,IAAI,gBAAgB,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACjD,OAAO,gBAAgB,CAAC;QAC1B,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC;IACtD,MAAM,eAAe,GACnB,iBAAiB,KAAK,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,gBAAgB,GAAG,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC;IAE7E,IAAI,iBAAiB,KAAK,OAAO,CAAC,EAAE,IAAI,gBAAgB,KAAK,CAAC,EAAE,CAAC;QAC/D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,YAAY,GAAG,oBAAoB,CAAC,WAAW,EAAE,iBAAiB,EAAE,eAAe,CAAC,CAAC;IAC3F,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,IAAI,eAAe,CACvB,SAAS,OAAO,CAAC,EAAE,kCAAkC,iBAAiB,kBAAkB,eAAe,8CAA8C,EACrJ;YACE,YAAY,EACV,gFAAgF;SACnF,CACF,CAAC;IACJ,CAAC;IAED,IAAI,YAAY,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;QACxC,MAAM,IAAI,eAAe,CACvB,SAAS,OAAO,CAAC,EAAE,kCAAkC,iBAAiB,kBAAkB,eAAe,gCAAgC,YAAY,CAAC,MAAM,IAAI,EAC9J;YACE,YAAY,EACV,2GAA2G;SAC9G,CACF,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,YAAY,CAAC,cAAc,EAAE,CAAC;QACjC,MAAM,IAAI,eAAe,CACvB,SAAS,OAAO,CAAC,EAAE,kCAAkC,iBAAiB,kBAAkB,eAAe,8BAA8B,EACrI;YACE,YAAY,EACV,sFAAsF;SACzF,CACF,CAAC;IACJ,CAAC;IAED,OAAO,YAAY,CAAC,cAAc,CAAC;AACrC,CAAC;AAED,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,OAAO;CACR,CAAC;AAEF,SAAS,oBAAoB,CAC3B,WAAyB,EACzB,MAAc,EACd,SAAiB;IAEjB,KAAK,IAAI,KAAK,GAAG,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAChE,MAAM,SAAS,GAAG,WAAW,CAAC,KAAK,CAAE,CAAC;QACtC,IAAI,SAAS,CAAC,MAAM,KAAK,MAAM,IAAI,SAAS,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YACrE,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/domain/workflow-loader.d.ts

@@ -0,0 +1,16 @@
+import { NestDepth } from "./loop-execution.js";
+import { type WorkflowDefinition } from "./workflow-schema.js";
+export interface WorkflowFileRepository {
+    read(path: string): Promise<string>;
+    exists(path: string): Promise<boolean>;
+}
+export interface WorkflowCapabilitySummary {
+    hasCommandRun: boolean;
+    commandRunWorkflowPaths: string[];
+}
+export interface WorkflowLoadResult {
+    workflow: WorkflowDefinition;
+    capabilitySummary: WorkflowCapabilitySummary;
+}
+export declare function loadWorkflow(rootPath: string, repo: WorkflowFileRepository, nestDepth?: NestDepth): Promise<WorkflowLoadResult>;
+export declare function computeWorkflowDigest(yamlContent: string): string;

package/dist/domain/workflow-loader.js

@@ -0,0 +1,140 @@
+import { createHash } from "node:crypto";
+import { dirname, isAbsolute, relative, resolve } from "node:path";
+import { ValidationError } from "../core/errors.js";
+import { NestDepth } from "./loop-execution.js";
+import { parseWorkflowYaml, } from "./workflow-schema.js";
+export async function loadWorkflow(rootPath, repo, nestDepth = new NestDepth(0)) {
+    const canonicalRootPath = resolve(rootPath);
+    const context = {
+        repo,
+        cache: new Map(),
+        errors: [],
+        commandRunWorkflowPaths: new Set(),
+        rootDir: dirname(canonicalRootPath),
+    };
+    const workflow = await loadWorkflowFrame(canonicalRootPath, nestDepth, [], context);
+    if (workflow === null || context.errors.length > 0) {
+        throw new ValidationError(context.errors.join("\n"), {
+            causeData: {
+                errors: [...context.errors],
+            },
+            recoveryHint: "Fix the workflow definition and try again.",
+        });
+    }
+    return {
+        workflow,
+        capabilitySummary: {
+            hasCommandRun: context.commandRunWorkflowPaths.size > 0,
+            commandRunWorkflowPaths: [...context.commandRunWorkflowPaths].sort(),
+        },
+    };
+}
+export function computeWorkflowDigest(yamlContent) {
+    return createHash("sha256").update(yamlContent).digest("hex");
+}
+async function loadWorkflowFrame(workflowPath, nestDepth, ancestry, context) {
+    const cached = context.cache.get(workflowPath);
+    if (cached) {
+        return cached.workflow;
+    }
+    if (ancestry.includes(workflowPath)) {
+        context.errors.push(formatCircularReferenceError(ancestry, workflowPath));
+        return null;
+    }
+    if (!(await context.repo.exists(workflowPath))) {
+        context.errors.push(`${workflowPath}: Workflow file does not exist.`);
+        return null;
+    }
+    const yamlContent = await context.repo.read(workflowPath);
+    const digest = computeWorkflowDigest(yamlContent);
+    let workflow;
+    try {
+        workflow = parseWorkflowYaml(yamlContent);
+    }
+    catch (error) {
+        collectValidationError(workflowPath, error, context.errors);
+        return null;
+    }
+    context.cache.set(workflowPath, {
+        digest,
+        workflow,
+    });
+    recordCapabilities(workflowPath, workflow, context.commandRunWorkflowPaths);
+    validateWorkflowGraph(workflowPath, workflow, context.errors);
+    const nextAncestry = [...ancestry, workflowPath];
+    for (const [index, step] of workflow.steps.entries()) {
+        if (!isWorkflowStep(step)) {
+            continue;
+        }
+        const childPath = resolve(dirname(workflowPath), step.workflow);
+        if (!isPathWithinRoot(context.rootDir, childPath)) {
+            context.errors.push(`${workflowPath}: steps[${index}].workflow: Subworkflow path "${step.workflow}" resolves outside the root workflow directory (${context.rootDir}).`);
+            continue;
+        }
+        if (nextAncestry.includes(childPath)) {
+            context.errors.push(`${workflowPath}: steps[${index}].workflow: Circular subworkflow reference detected: ${[
+                ...nextAncestry,
+                childPath,
+            ].join(" -> ")}.`);
+            continue;
+        }
+        if (nestDepth.isAtLimit()) {
+            context.errors.push(`${workflowPath}: steps[${index}].workflow: Nest depth limit exceeded while resolving "${step.workflow}" (${childPath}). Current depth ${nestDepth.value} reached maxDepth ${nestDepth.maxDepth}.`);
+            continue;
+        }
+        await loadWorkflowFrame(childPath, nestDepth.increment(), nextAncestry, context);
+    }
+    return workflow;
+}
+function validateWorkflowGraph(workflowPath, workflow, errors) {
+    const stepIds = new Set(workflow.steps.map((step) => step.id));
+    for (const [index, step] of workflow.steps.entries()) {
+        const inheritFrom = step.session?.inheritFrom;
+        if (inheritFrom && !stepIds.has(inheritFrom)) {
+            errors.push(`${workflowPath}: steps[${index}].session.inherit_from: Referenced step "${inheritFrom}" does not exist in the current workflow frame.`);
+        }
+    }
+    const evaluateAfter = workflow.loop.exitCondition?.evaluateAfter;
+    if (evaluateAfter && !stepIds.has(evaluateAfter)) {
+        errors.push(`${workflowPath}: loop.exit_condition.evaluate_after: Referenced step "${evaluateAfter}" does not exist in the current workflow frame.`);
+    }
+}
+function recordCapabilities(workflowPath, workflow, commandRunWorkflowPaths) {
+    if (workflow.loop.exitCondition?.type === "command") {
+        commandRunWorkflowPaths.add(workflowPath);
+    }
+}
+function collectValidationError(workflowPath, error, errors) {
+    if (error instanceof ValidationError) {
+        for (const line of splitMessageLines(error.message)) {
+            errors.push(`${workflowPath}: ${line}`);
+        }
+        return;
+    }
+    if (error instanceof Error) {
+        errors.push(`${workflowPath}: ${error.message}`);
+        return;
+    }
+    errors.push(`${workflowPath}: Failed to load workflow.`);
+}
+function splitMessageLines(message) {
+    return message
+        .split("\n")
+        .map((line) => line.trim())
+        .filter((line) => line.length > 0);
+}
+function formatCircularReferenceError(ancestry, workflowPath) {
+    return `Circular subworkflow reference detected: ${[
+        ...ancestry,
+        workflowPath,
+    ].join(" -> ")}.`;
+}
+function isPathWithinRoot(rootDir, candidatePath) {
+    const relativePath = relative(rootDir, candidatePath);
+    return (relativePath === "" ||
+        (!relativePath.startsWith("..") && !isAbsolute(relativePath)));
+}
+function isWorkflowStep(step) {
+    return "workflow" in step;
+}
+//# sourceMappingURL=workflow-loader.js.map