@travisliu/open-dynamic-workflow 0.3.1 → 0.3.5

package/dist/loop/events.d.ts

@@ -0,0 +1,62 @@
+import type { LoopRoundStatus } from "./types.js";
+import type { SerializedError } from "../types/errors.js";
+import type { LoopStartedPayload, LoopRoundStartedPayload, LoopRoundTerminalPayload, LoopTerminalPayload } from "../output/events.js";
+/**
+ * Builds the payload for a loop.started event.
+ */
+export declare function buildLoopStartedPayload(input: {
+    loopId: string;
+    workflowInvocationId: string;
+    label: string;
+    parentLoopId?: string;
+    maxRounds: number;
+    timeoutMs?: number;
+    artifactPath?: string;
+}): LoopStartedPayload;
+/**
+ * Builds the payload for a loop.round.started event.
+ */
+export declare function buildLoopRoundStartedPayload(input: {
+    loopId: string;
+    workflowInvocationId: string;
+    label: string;
+    roundIndex: number;
+    roundNumber: number;
+    roundId: string;
+    startedAt: string;
+    artifactPath?: string;
+}): LoopRoundStartedPayload;
+/**
+ * Builds the payload for a loop.round terminal event (completed, failed, cancelled, timed_out).
+ */
+export declare function buildLoopRoundTerminalPayload(input: {
+    loopId: string;
+    workflowInvocationId: string;
+    label: string;
+    roundIndex: number;
+    roundNumber: number;
+    roundId: string;
+    status: LoopRoundStatus;
+    durationMs: number;
+    statePreview?: unknown;
+    reason?: string;
+    artifactPath?: string;
+    error?: SerializedError;
+}): LoopRoundTerminalPayload;
+/**
+ * Builds the payload for a loop terminal event.
+ */
+export declare function buildLoopTerminalPayload(input: {
+    loopId: string;
+    workflowInvocationId: string;
+    label: string;
+    status: "succeeded" | "max_rounds" | "failed" | "cancelled" | "timed_out";
+    roundsCompleted: number;
+    roundCount: number;
+    maxRounds: number;
+    durationMs: number;
+    reason?: string;
+    artifactPath?: string;
+    error?: SerializedError;
+    statePreview?: unknown;
+}): LoopTerminalPayload;

package/dist/loop/events.js

@@ -0,0 +1,68 @@
+/**
+ * Builds the payload for a loop.started event.
+ */
+export function buildLoopStartedPayload(input) {
+    return {
+        loopId: input.loopId,
+        workflowInvocationId: input.workflowInvocationId,
+        label: input.label,
+        ...(input.parentLoopId !== undefined ? { parentLoopId: input.parentLoopId } : {}),
+        maxRounds: input.maxRounds,
+        ...(input.timeoutMs !== undefined ? { timeoutMs: input.timeoutMs } : {}),
+        ...(input.artifactPath !== undefined ? { artifactPath: input.artifactPath } : {}),
+    };
+}
+/**
+ * Builds the payload for a loop.round.started event.
+ */
+export function buildLoopRoundStartedPayload(input) {
+    return {
+        loopId: input.loopId,
+        workflowInvocationId: input.workflowInvocationId,
+        label: input.label,
+        roundIndex: input.roundIndex,
+        roundNumber: input.roundNumber,
+        roundId: input.roundId,
+        startedAt: input.startedAt,
+        ...(input.artifactPath !== undefined ? { artifactPath: input.artifactPath } : {}),
+    };
+}
+/**
+ * Builds the payload for a loop.round terminal event (completed, failed, cancelled, timed_out).
+ */
+export function buildLoopRoundTerminalPayload(input) {
+    return {
+        loopId: input.loopId,
+        workflowInvocationId: input.workflowInvocationId,
+        label: input.label,
+        roundIndex: input.roundIndex,
+        roundNumber: input.roundNumber,
+        roundId: input.roundId,
+        status: input.status,
+        durationMs: input.durationMs,
+        ...(input.statePreview !== undefined ? { statePreview: input.statePreview } : {}),
+        ...(input.reason !== undefined ? { reason: input.reason } : {}),
+        ...(input.artifactPath !== undefined ? { artifactPath: input.artifactPath } : {}),
+        ...(input.error !== undefined ? { error: input.error } : {}),
+    };
+}
+/**
+ * Builds the payload for a loop terminal event.
+ */
+export function buildLoopTerminalPayload(input) {
+    return {
+        loopId: input.loopId,
+        workflowInvocationId: input.workflowInvocationId,
+        label: input.label,
+        status: input.status,
+        roundsCompleted: input.roundsCompleted,
+        roundCount: input.roundCount,
+        maxRounds: input.maxRounds,
+        durationMs: input.durationMs,
+        ...(input.reason !== undefined ? { reason: input.reason } : {}),
+        ...(input.artifactPath !== undefined ? { artifactPath: input.artifactPath } : {}),
+        ...(input.error !== undefined ? { error: input.error } : {}),
+        ...(input.statePreview !== undefined ? { statePreview: input.statePreview } : {}),
+    };
+}
+//# sourceMappingURL=events.js.map

package/dist/loop/events.js.map

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

package/dist/loop/id.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Creates a stable loop identifier.
+ */
+export declare function createLoopId(label: string): string;
+/**
+ * Creates a stable round identifier.
+ */
+export declare function createRoundId(loopId: string, roundNumber: number): string;
+/**
+ * Input for createLoopAgentId.
+ */
+export interface CreateLoopAgentIdInput {
+    label: string;
+    roundNumber: number;
+    suffix?: string;
+}
+/**
+ * Normalizes a loop label for use in IDs.
+ */
+export declare function normalizeLoopLabel(label: string): string;
+/**
+ * Creates a stable agent identifier for use inside a loop round.
+ */
+export declare function createLoopAgentId(input: CreateLoopAgentIdInput): string;

package/dist/loop/id.js

@@ -0,0 +1,65 @@
+import { InvalidDslCallError } from "../workflow/errors.js";
+const ID_NAME_PATTERN = /^[A-Za-z0-9_.:-]+$/;
+/**
+ * Creates a stable loop identifier.
+ */
+export function createLoopId(label) {
+    if (!label || typeof label !== "string" || label.trim() === "") {
+        throw new InvalidDslCallError("Loop label is required to generate loop ID.");
+    }
+    return normalizeLoopLabel(label);
+}
+/**
+ * Creates a stable round identifier.
+ */
+export function createRoundId(loopId, roundNumber) {
+    if (!loopId || typeof loopId !== "string") {
+        throw new InvalidDslCallError("createRoundId: loopId is required and must be a string.");
+    }
+    if (typeof roundNumber !== "number" || roundNumber < 1 || isNaN(roundNumber) || !Number.isInteger(roundNumber)) {
+        throw new InvalidDslCallError("createRoundId: roundNumber must be a positive integer.");
+    }
+    const paddedIndex = roundNumber.toString().padStart(4, "0");
+    return `${loopId}-round-${paddedIndex}`;
+}
+/**
+ * Normalizes a loop label for use in IDs.
+ */
+export function normalizeLoopLabel(label) {
+    if (!label || typeof label !== "string") {
+        return "";
+    }
+    return label
+        .toLowerCase()
+        .trim()
+        .replace(/[^a-z0-9_.:-]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+}
+/**
+ * Creates a stable agent identifier for use inside a loop round.
+ */
+export function createLoopAgentId(input) {
+    const normalizedLabel = normalizeLoopLabel(input.label);
+    const roundPart = `round-${input.roundNumber}`;
+    if (input.suffix) {
+        const trimmedSuffix = input.suffix.trim();
+        if (trimmedSuffix === "") {
+            throw new InvalidDslCallError("createLoopAgentId: suffix cannot be empty or whitespace-only.");
+        }
+        if (trimmedSuffix === "." || trimmedSuffix === "..") {
+            throw new InvalidDslCallError("createLoopAgentId: suffix cannot be '.' or '..'.");
+        }
+        if (trimmedSuffix.includes("/") || trimmedSuffix.includes("\\")) {
+            throw new InvalidDslCallError("createLoopAgentId: suffix cannot contain path separators.");
+        }
+        if (trimmedSuffix.includes("..")) {
+            throw new InvalidDslCallError("createLoopAgentId: suffix cannot contain path traversal segments.");
+        }
+        if (!ID_NAME_PATTERN.test(trimmedSuffix)) {
+            throw new InvalidDslCallError(`createLoopAgentId: suffix '${input.suffix}' contains invalid characters. Only alphanumeric, underscores, dots, colons, and hyphens are allowed.`);
+        }
+        return `${normalizedLabel}:${roundPart}:${trimmedSuffix}`;
+    }
+    return `${normalizedLabel}:${roundPart}`;
+}
+//# sourceMappingURL=id.js.map

package/dist/loop/id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.js","sourceRoot":"","sources":["../../src/loop/id.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,MAAM,eAAe,GAAG,oBAAoB,CAAC;AAE7C;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC/D,MAAM,IAAI,mBAAmB,CAAC,6CAA6C,CAAC,CAAC;IAC/E,CAAC;IACD,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,MAAc,EAAE,WAAmB;IAC/D,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC1C,MAAM,IAAI,mBAAmB,CAAC,yDAAyD,CAAC,CAAC;IAC3F,CAAC;IACD,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,WAAW,GAAG,CAAC,IAAI,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,CAAC;QAC/G,MAAM,IAAI,mBAAmB,CAAC,wDAAwD,CAAC,CAAC;IAC1F,CAAC;IACD,MAAM,WAAW,GAAG,WAAW,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC5D,OAAO,GAAG,MAAM,UAAU,WAAW,EAAE,CAAC;AAC1C,CAAC;AAWD;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC9C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,KAAK;SACT,WAAW,EAAE;SACb,IAAI,EAAE;SACN,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC;SAC/B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAA6B;IAC7D,MAAM,eAAe,GAAG,kBAAkB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACxD,MAAM,SAAS,GAAG,SAAS,KAAK,CAAC,WAAW,EAAE,CAAC;IAE/C,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACjB,MAAM,aAAa,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QAC1C,IAAI,aAAa,KAAK,EAAE,EAAE,CAAC;YACzB,MAAM,IAAI,mBAAmB,CAAC,+DAA+D,CAAC,CAAC;QACjG,CAAC;QACD,IAAI,aAAa,KAAK,GAAG,IAAI,aAAa,KAAK,IAAI,EAAE,CAAC;YACpD,MAAM,IAAI,mBAAmB,CAAC,kDAAkD,CAAC,CAAC;QACpF,CAAC;QACD,IAAI,aAAa,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAChE,MAAM,IAAI,mBAAmB,CAAC,2DAA2D,CAAC,CAAC;QAC7F,CAAC;QACD,IAAI,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,mBAAmB,CAAC,mEAAmE,CAAC,CAAC;QACrG,CAAC;QACD,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC;YACzC,MAAM,IAAI,mBAAmB,CAC3B,8BAA8B,KAAK,CAAC,MAAM,uGAAuG,CAClJ,CAAC;QACJ,CAAC;QACD,OAAO,GAAG,eAAe,IAAI,SAAS,IAAI,aAAa,EAAE,CAAC;IAC5D,CAAC;IAED,OAAO,GAAG,eAAe,IAAI,SAAS,EAAE,CAAC;AAC3C,CAAC"}

package/dist/loop/index.d.ts

@@ -0,0 +1,8 @@
+export * from "./types.js";
+export { runLoop, type RunLoopInput } from "./run.js";
+export { validateAndNormalizeLoopArgs, validateLoopRunResult } from "./validate.js";
+export { createLoopId, createRoundId, createLoopAgentId, normalizeLoopLabel } from "./id.js";
+export { buildLoopSummary } from "./summary.js";
+export { createLoopRoundContext, getActiveLoopContext, withActiveLoopContext, recordLoopChildAgentId, } from "./context.js";
+export { stableHashJson, buildLoopStartReplayMarker, buildLoopRoundReplayMarker, recordLoopCacheMarker, } from "./replay.js";
+export { getIsoTimestamp, getDurationMs, createLoopRoundRecord, createLoopExecutionRecord, createSettledSuccessEnvelope, createSettledFailureEnvelope, createLoopExhaustionError, createInvalidRunResultError, } from "./results.js";

package/dist/loop/index.js

@@ -0,0 +1,9 @@
+export * from "./types.js";
+export { runLoop } from "./run.js";
+export { validateAndNormalizeLoopArgs, validateLoopRunResult } from "./validate.js";
+export { createLoopId, createRoundId, createLoopAgentId, normalizeLoopLabel } from "./id.js";
+export { buildLoopSummary } from "./summary.js";
+export { createLoopRoundContext, getActiveLoopContext, withActiveLoopContext, recordLoopChildAgentId, } from "./context.js";
+export { stableHashJson, buildLoopStartReplayMarker, buildLoopRoundReplayMarker, recordLoopCacheMarker, } from "./replay.js";
+export { getIsoTimestamp, getDurationMs, createLoopRoundRecord, createLoopExecutionRecord, createSettledSuccessEnvelope, createSettledFailureEnvelope, createLoopExhaustionError, createInvalidRunResultError, } from "./results.js";
+//# sourceMappingURL=index.js.map

package/dist/loop/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/loop/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,OAAO,EAAqB,MAAM,UAAU,CAAC;AACtD,OAAO,EAAE,4BAA4B,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACpF,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAC7F,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,cAAc,EACd,0BAA0B,EAC1B,0BAA0B,EAC1B,qBAAqB,GACtB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,eAAe,EACf,aAAa,EACb,qBAAqB,EACrB,yBAAyB,EACzB,4BAA4B,EAC5B,4BAA4B,EAC5B,yBAAyB,EACzB,2BAA2B,GAC5B,MAAM,cAAc,CAAC"}

package/dist/loop/replay.d.ts

@@ -0,0 +1,47 @@
+import { type RuntimeCallCache, type LoopCallCacheEntry } from "../artifacts/call-cache.js";
+import type { ArtifactStore } from "../types/artifacts.js";
+/**
+ * Computes a stable hash of a JSON-serializable value.
+ */
+export declare function stableHashJson(value: unknown): string;
+/**
+ * Builds a loop-start replay marker.
+ */
+export declare function buildLoopStartReplayMarker(input: {
+    loopId: string;
+    label: string;
+    parentLoopId?: string;
+    maxRounds: number;
+    optionsFingerprint: string;
+    initialStateHash: string;
+    maxRoundsCeiling: number;
+}): string;
+/**
+ * Builds a loop-round replay marker.
+ */
+export declare function buildLoopRoundReplayMarker(input: {
+    loopId: string;
+    label: string;
+    roundIndex: number;
+    roundNumber: number;
+    nestedCallSequence: string[];
+    stateBeforeHash: string;
+    stateAfterHash?: string;
+    status?: string;
+}): string;
+/**
+ * Records a loop cache marker and checks for a prefix cache hit.
+ * If there's a mismatch, it disables further cache hits.
+ */
+export declare function recordLoopCacheMarker(input: {
+    store: ArtifactStore;
+    cache?: RuntimeCallCache;
+    kind: "loop";
+    sequence: number;
+    loopId: string;
+    roundIndex?: number;
+    roundId?: string;
+    fingerprint: string;
+    resultPath: string;
+    status?: "succeeded" | "failed" | "cancelled" | "timed_out" | "skipped";
+}): Promise<LoopCallCacheEntry | undefined>;

package/dist/loop/replay.js

@@ -0,0 +1,104 @@
+import * as crypto from "node:crypto";
+import { findPrefixCacheHit, recordLoopCall } from "../artifacts/call-cache.js";
+/**
+ * Stable JSON stringify for consistent hashing.
+ */
+function stableStringify(value) {
+    return JSON.stringify(sortValue(value));
+}
+function sortValue(value) {
+    if (Array.isArray(value)) {
+        return value.map(sortValue);
+    }
+    if (value && typeof value === "object") {
+        const sorted = {};
+        for (const key of Object.keys(value).sort()) {
+            const child = value[key];
+            if (child !== undefined) {
+                sorted[key] = sortValue(child);
+            }
+        }
+        return sorted;
+    }
+    return value;
+}
+/**
+ * Computes a stable hash of a JSON-serializable value.
+ */
+export function stableHashJson(value) {
+    return crypto
+        .createHash("sha256")
+        .update(stableStringify(value))
+        .digest("hex");
+}
+/**
+ * Builds a loop-start replay marker.
+ */
+export function buildLoopStartReplayMarker(input) {
+    return stableHashJson({
+        kind: "loop-start",
+        loopId: input.loopId,
+        label: input.label,
+        ...(input.parentLoopId !== undefined ? { parentLoopId: input.parentLoopId } : {}),
+        maxRounds: input.maxRounds,
+        optionsFingerprint: input.optionsFingerprint,
+        initialStateHash: input.initialStateHash,
+        maxRoundsCeiling: input.maxRoundsCeiling,
+    });
+}
+import { normalizeLoopLabel } from "./id.js";
+function normalizeNestedCallSequence(loopId, label, roundNumber, sequence) {
+    const normalizedLabel = normalizeLoopLabel(label);
+    const prefix = `${loopId}:${normalizedLabel}:round-${roundNumber}:`;
+    let workflowCount = 0;
+    return sequence.map((id) => {
+        if (id.startsWith(prefix)) {
+            workflowCount++;
+            return `${prefix}workflow-${workflowCount}`;
+        }
+        return id;
+    });
+}
+/**
+ * Builds a loop-round replay marker.
+ */
+export function buildLoopRoundReplayMarker(input) {
+    const normalizedSequence = normalizeNestedCallSequence(input.loopId, input.label, input.roundNumber, input.nestedCallSequence);
+    return stableHashJson({
+        kind: "loop-round",
+        loopId: input.loopId,
+        label: input.label,
+        roundIndex: input.roundIndex,
+        roundNumber: input.roundNumber,
+        nestedCallSequence: normalizedSequence,
+        stateBeforeHash: input.stateBeforeHash,
+        ...(input.stateAfterHash !== undefined ? { stateAfterHash: input.stateAfterHash } : {}),
+        ...(input.status !== undefined ? { status: input.status } : {}),
+    });
+}
+/**
+ * Records a loop cache marker and checks for a prefix cache hit.
+ * If there's a mismatch, it disables further cache hits.
+ */
+export async function recordLoopCacheMarker(input) {
+    const hit = findPrefixCacheHit({
+        cache: input.cache,
+        kind: "loop",
+        sequence: input.sequence,
+        callId: input.loopId,
+        fingerprint: input.fingerprint,
+    });
+    await recordLoopCall({
+        store: input.store,
+        ...(input.cache !== undefined ? { cache: input.cache } : {}),
+        sequence: input.sequence,
+        loopId: input.loopId,
+        ...(input.roundIndex !== undefined ? { roundIndex: input.roundIndex } : {}),
+        ...(input.roundId !== undefined ? { roundId: input.roundId } : {}),
+        fingerprint: input.fingerprint,
+        resultPath: input.resultPath,
+        ...(input.status !== undefined ? { status: input.status } : {}),
+    });
+    return hit;
+}
+//# sourceMappingURL=replay.js.map

package/dist/loop/replay.js.map

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

package/dist/loop/results.d.ts

@@ -0,0 +1,74 @@
+import type { LoopRoundRecord, LoopExecutionRecord, LoopSettledSuccess, LoopSettledFailure } from "./types.js";
+import type { SerializedError } from "../types/errors.js";
+/**
+ * Returns the current ISO timestamp.
+ */
+export declare function getIsoTimestamp(): string;
+/**
+ * Calculates duration between two ISO timestamps.
+ */
+export declare function getDurationMs(startIso: string, endIso: string): number;
+/**
+ * Creates a concise round record.
+ */
+export declare function createLoopRoundRecord<TState>(input: {
+    index: number;
+    roundNumber: number;
+    status: "completed" | "failed" | "cancelled" | "timed_out";
+    inputState: TState;
+    nextState?: TState;
+    durationMs: number;
+    error?: SerializedError;
+    nestedCalls: {
+        agents: string[];
+        workflows: string[];
+    };
+}): LoopRoundRecord<TState>;
+/**
+ * Creates an execution record.
+ */
+export declare function createLoopExecutionRecord<TState>(input: {
+    loopId: string;
+    label: string;
+    status: "succeeded" | "failed" | "cancelled" | "timed_out" | "max_rounds";
+    roundsCompleted: number;
+    maxRounds: number;
+    initialState: TState;
+    finalState?: TState;
+    rounds: LoopRoundRecord<TState>[];
+    startedAt: string;
+    finishedAt: string;
+    durationMs: number;
+    artifactPath: string;
+    error?: SerializedError;
+}): LoopExecutionRecord<TState>;
+/**
+ * Creates settled success envelope.
+ */
+export declare function createSettledSuccessEnvelope<TState>(input: {
+    label: string;
+    loopId: string;
+    roundsCompleted: number;
+    finalState: TState;
+    artifactsDir: string;
+}): LoopSettledSuccess<TState>;
+/**
+ * Creates settled failure envelope.
+ */
+export declare function createSettledFailureEnvelope<TState>(input: {
+    status: "failed" | "cancelled" | "timed_out" | "max_rounds";
+    label: string;
+    loopId: string;
+    roundsCompleted: number;
+    finalState?: TState;
+    error?: SerializedError;
+    artifactsDir: string;
+}): LoopSettledFailure<TState>;
+/**
+ * Creates loop exhaustion error.
+ */
+export declare function createLoopExhaustionError(label: string, maxRounds: number): Error;
+/**
+ * Creates invalid round result error.
+ */
+export declare function createInvalidRunResultError(label: string, details: string): Error;

package/dist/loop/results.js

@@ -0,0 +1,101 @@
+import { OpenDynamicWorkflowError } from "../errors/types.js";
+import { ErrorCode } from "../errors/codes.js";
+/**
+ * Returns the current ISO timestamp.
+ */
+export function getIsoTimestamp() {
+    return new Date().toISOString();
+}
+/**
+ * Calculates duration between two ISO timestamps.
+ */
+export function getDurationMs(startIso, endIso) {
+    const start = new Date(startIso).getTime();
+    const end = new Date(endIso).getTime();
+    return Math.max(0, end - start);
+}
+/**
+ * Creates a concise round record.
+ */
+export function createLoopRoundRecord(input) {
+    return {
+        index: input.index,
+        roundNumber: input.roundNumber,
+        status: input.status,
+        inputState: input.inputState,
+        ...(input.nextState !== undefined ? { nextState: input.nextState } : {}),
+        durationMs: input.durationMs,
+        ...(input.error !== undefined ? { error: input.error } : {}),
+        nestedCalls: {
+            agents: [...input.nestedCalls.agents],
+            workflows: [...input.nestedCalls.workflows],
+        },
+    };
+}
+/**
+ * Creates an execution record.
+ */
+export function createLoopExecutionRecord(input) {
+    return {
+        schemaVersion: "open-dynamic-workflow.loop-result.v2",
+        loopId: input.loopId,
+        label: input.label,
+        status: input.status,
+        roundsCompleted: input.roundsCompleted,
+        maxRounds: input.maxRounds,
+        initialState: input.initialState,
+        ...(input.finalState !== undefined ? { finalState: input.finalState } : {}),
+        rounds: [...input.rounds],
+        startedAt: input.startedAt,
+        finishedAt: input.finishedAt,
+        durationMs: input.durationMs,
+        artifactPath: input.artifactPath,
+        ...(input.error !== undefined ? { error: input.error } : {}),
+    };
+}
+/**
+ * Creates settled success envelope.
+ */
+export function createSettledSuccessEnvelope(input) {
+    return {
+        ok: true,
+        status: "succeeded",
+        label: input.label,
+        loopId: input.loopId,
+        roundsCompleted: input.roundsCompleted,
+        finalState: input.finalState,
+        artifacts: {
+            dir: input.artifactsDir,
+        },
+    };
+}
+/**
+ * Creates settled failure envelope.
+ */
+export function createSettledFailureEnvelope(input) {
+    return {
+        ok: false,
+        status: input.status,
+        label: input.label,
+        loopId: input.loopId,
+        roundsCompleted: input.roundsCompleted,
+        ...(input.finalState !== undefined ? { finalState: input.finalState } : {}),
+        ...(input.error !== undefined ? { error: input.error } : {}),
+        artifacts: {
+            dir: input.artifactsDir,
+        },
+    };
+}
+/**
+ * Creates loop exhaustion error.
+ */
+export function createLoopExhaustionError(label, maxRounds) {
+    return new OpenDynamicWorkflowError(ErrorCode.WORKFLOW_FAILED, `Loop '${label}' exhausted maxRounds of ${maxRounds}.`);
+}
+/**
+ * Creates invalid round result error.
+ */
+export function createInvalidRunResultError(label, details) {
+    return new OpenDynamicWorkflowError(ErrorCode.WORKFLOW_INVALID_CALL, `Loop '${label}' round returned invalid run result: ${details}`);
+}
+//# sourceMappingURL=results.js.map

package/dist/loop/results.js.map

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

package/dist/loop/run.d.ts

@@ -0,0 +1,22 @@
+import type { LoopSettledResult } from "./types.js";
+import type { RuntimeState } from "../workflow/types.js";
+import type { AgentCallInput, AgentResult } from "../types/agent.js";
+import type { WorkflowCallInput } from "../types/workflow.js";
+/**
+ * Input for runLoop.
+ */
+export interface RunLoopInput<TState = unknown> {
+    loopInput: unknown;
+    runtime: RuntimeState;
+    signal: AbortSignal;
+    dsl: {
+        agent: (input: AgentCallInput) => Promise<AgentResult>;
+        workflow: (input: WorkflowCallInput) => Promise<any>;
+        log: (message: string, data?: unknown) => void;
+    };
+    _stateType?: TState;
+}
+/**
+ * Main loop execution runtime.
+ */
+export declare function runLoop<TState = unknown>(input: RunLoopInput<TState>): Promise<TState | LoopSettledResult<TState>>;