@hham21/circe 0.4.0

package/dist/events.d.ts

@@ -0,0 +1,134 @@
+export type OrchestratorEvent = {
+    type: "agent:start";
+    agent: string;
+    timestamp: number;
+} | {
+    type: "agent:done";
+    agent: string;
+    result: unknown;
+    /** USD */ cost: number;
+    tokens: [number, number];
+    timestamp: number;
+} | {
+    type: "agent:error";
+    agent: string;
+    error: string;
+    attempt: number;
+    /** USD */ cost?: number;
+    tokens?: [number, number];
+    timestamp: number;
+} | {
+    type: "step:start";
+    step: number;
+    agent: string;
+    timestamp: number;
+} | {
+    type: "step:done";
+    step: number;
+    agent: string;
+    output: unknown;
+    /** USD */ cost?: number;
+    tokens?: [number, number];
+    timestamp: number;
+} | {
+    type: "step:error";
+    step: number;
+    agent: string;
+    error: string;
+    timestamp: number;
+} | {
+    type: "round:start";
+    round: number;
+    timestamp: number;
+} | {
+    type: "round:done";
+    round: number;
+    result: unknown; /** USD */
+    cost?: number;
+    timestamp: number;
+} | {
+    type: "round:error";
+    round: number;
+    error: string;
+    timestamp: number;
+} | {
+    type: "branch:start";
+    branch: string;
+    timestamp: number;
+} | {
+    type: "branch:done";
+    branch: string;
+    result: unknown; /** USD */
+    cost?: number;
+    timestamp: number;
+} | {
+    type: "branch:error";
+    branch: string;
+    error: string;
+    timestamp: number;
+} | {
+    type: "retry";
+    agent: string;
+    attempt: number;
+    maxAttempts: number;
+    timestamp: number;
+} | {
+    type: "pipeline:done"; /** USD */
+    totalCost: number;
+    timestamp: number;
+} | {
+    type: "sprint:start";
+    index: number;
+    definition: unknown;
+    timestamp: number;
+} | {
+    type: "sprint:done";
+    index: number;
+    result: unknown; /** USD */
+    cost?: number;
+    timestamp: number;
+} | {
+    type: "sprint:error";
+    index: number;
+    error: string;
+    timestamp: number;
+};
+type EventHandler<T extends OrchestratorEvent["type"]> = (event: Extract<OrchestratorEvent, {
+    type: T;
+}>) => void;
+export interface EventBusOptions {
+    maxCost?: number;
+}
+export declare class EventBus {
+    history: OrchestratorEvent[];
+    private handlerMap;
+    private maxCost;
+    private runningCost;
+    private perAgentCost;
+    constructor(options?: EventBusOptions);
+    on<T extends OrchestratorEvent["type"]>(type: T, handler: EventHandler<T>): void;
+    emit(event: OrchestratorEvent): void;
+    getCostSummary(): {
+        total: number;
+        perAgent: Record<string, number>;
+    };
+}
+export interface RetryPolicy {
+    maxRetries: number;
+    backoff?: (attempt: number) => number;
+    shouldRetry?: (error: Error) => boolean;
+}
+export declare function defaultShouldRetry(error: Error): boolean;
+export declare function defaultBackoff(attempt: number): number;
+export declare function toError(err: unknown): Error;
+export declare function errorMessage(err: unknown): string;
+/**
+ * Run a Runnable with optional retry + EventBus retry event emission.
+ * Shared by all orchestrators to eliminate duplicated retry wrappers.
+ */
+export declare function runWithOptionalRetry<TIn, TOut>(agent: {
+    name?: string;
+    run(input: TIn): Promise<TOut>;
+}, input: TIn, retryPolicy: RetryPolicy | null, eventBus: EventBus | null): Promise<TOut>;
+export declare function executeWithRetry<T>(fn: () => Promise<T>, policy: RetryPolicy, onRetry?: (attempt: number, error: Error) => void): Promise<T>;
+export {};

package/dist/events.js

@@ -0,0 +1,127 @@
+function extractCostEntry(event) {
+    if (event.type === "agent:done") {
+        return { cost: event.cost, agent: event.agent };
+    }
+    if (event.type === "agent:error" && event.cost != null) {
+        return { cost: event.cost, agent: event.agent };
+    }
+    if (event.type === "step:done" && event.cost != null) {
+        return { cost: event.cost, agent: event.agent };
+    }
+    if (event.type === "round:done" && event.cost != null) {
+        return { cost: event.cost, agent: `round-${event.round}` };
+    }
+    if (event.type === "sprint:done" && event.cost != null) {
+        return { cost: event.cost, agent: `sprint-${event.index}` };
+    }
+    if (event.type === "branch:done" && event.cost != null) {
+        return { cost: event.cost, agent: event.branch };
+    }
+    return null;
+}
+export class EventBus {
+    history = [];
+    handlerMap = new Map();
+    maxCost;
+    runningCost = 0;
+    perAgentCost = {};
+    constructor(options) {
+        this.maxCost = options?.maxCost ?? null;
+    }
+    on(type, handler) {
+        const list = this.handlerMap.get(type) ?? [];
+        list.push(handler);
+        this.handlerMap.set(type, list);
+    }
+    emit(event) {
+        this.history.push(event);
+        const costEntry = extractCostEntry(event);
+        if (costEntry) {
+            this.runningCost += costEntry.cost;
+            this.perAgentCost[costEntry.agent] = (this.perAgentCost[costEntry.agent] ?? 0) + costEntry.cost;
+        }
+        if (this.maxCost != null && this.runningCost > this.maxCost) {
+            throw new Error(`Cost limit exceeded: $${this.runningCost.toFixed(2)} spent, limit is $${this.maxCost.toFixed(2)}`);
+        }
+        const handlers = this.handlerMap.get(event.type);
+        if (handlers) {
+            for (const handler of handlers) {
+                try {
+                    handler(event);
+                }
+                catch (err) {
+                    console.error(`[EventBus] handler error for ${event.type}:`, err);
+                }
+            }
+        }
+    }
+    getCostSummary() {
+        return { total: this.runningCost, perAgent: { ...this.perAgentCost } };
+    }
+}
+const NON_RETRYABLE_PATTERNS = [
+    /\b400\b/,
+    /\b401\b/,
+    /\b403\b/,
+    /bad request/i,
+    /unauthorized/i,
+    /forbidden/i,
+    /invalid.*model/i,
+    /invalid.*api.?key/i,
+];
+export function defaultShouldRetry(error) {
+    const msg = error.message;
+    return !NON_RETRYABLE_PATTERNS.some((p) => p.test(msg));
+}
+const BASE_BACKOFF_MS = 1_000;
+const MAX_BACKOFF_MS = 60_000;
+export function defaultBackoff(attempt) {
+    return Math.min(BASE_BACKOFF_MS * 2 ** attempt, MAX_BACKOFF_MS);
+}
+export function toError(err) {
+    return err instanceof Error ? err : new Error(String(err));
+}
+export function errorMessage(err) {
+    return toError(err).message;
+}
+/**
+ * Run a Runnable with optional retry + EventBus retry event emission.
+ * Shared by all orchestrators to eliminate duplicated retry wrappers.
+ */
+export async function runWithOptionalRetry(agent, input, retryPolicy, eventBus) {
+    if (!retryPolicy) {
+        return agent.run(input);
+    }
+    return executeWithRetry(() => agent.run(input), retryPolicy, (attempt) => {
+        eventBus?.emit({
+            type: "retry",
+            agent: agent.name ?? "unknown",
+            attempt,
+            maxAttempts: retryPolicy.maxRetries,
+            timestamp: Date.now(),
+        });
+    });
+}
+export async function executeWithRetry(fn, policy, onRetry) {
+    const shouldRetry = policy.shouldRetry ?? defaultShouldRetry;
+    const backoff = policy.backoff ?? defaultBackoff;
+    let lastError = null;
+    for (let attempt = 0; attempt <= policy.maxRetries; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (err) {
+            lastError = toError(err);
+            if (attempt >= policy.maxRetries || !shouldRetry(lastError)) {
+                throw lastError;
+            }
+            onRetry?.(attempt + 1, lastError);
+            const delay = backoff(attempt);
+            if (delay > 0) {
+                await new Promise((r) => setTimeout(r, delay));
+            }
+        }
+    }
+    throw lastError;
+}
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

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

package/dist/handoff.d.ts

@@ -0,0 +1,153 @@
+import { z } from "zod";
+export declare const FeatureSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    description: string;
+}, {
+    name: string;
+    description: string;
+}>;
+export declare const TechStackSchema: z.ZodObject<{
+    frontend: z.ZodString;
+    backend: z.ZodString;
+    database: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    frontend: string;
+    backend: string;
+    database: string;
+}, {
+    frontend: string;
+    backend: string;
+    database: string;
+}>;
+export declare const ProductSpecSchema: z.ZodObject<{
+    appName: z.ZodString;
+    features: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        description: string;
+    }, {
+        name: string;
+        description: string;
+    }>, "many">;
+    techStack: z.ZodObject<{
+        frontend: z.ZodString;
+        backend: z.ZodString;
+        database: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        frontend: string;
+        backend: string;
+        database: string;
+    }, {
+        frontend: string;
+        backend: string;
+        database: string;
+    }>;
+    designDirection: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    appName: string;
+    features: {
+        name: string;
+        description: string;
+    }[];
+    techStack: {
+        frontend: string;
+        backend: string;
+        database: string;
+    };
+    designDirection: string;
+}, {
+    appName: string;
+    features: {
+        name: string;
+        description: string;
+    }[];
+    techStack: {
+        frontend: string;
+        backend: string;
+        database: string;
+    };
+    designDirection: string;
+}>;
+export declare const BuildResultSchema: z.ZodObject<{
+    appDir: z.ZodString;
+    runCommand: z.ZodString;
+    port: z.ZodNumber;
+    selfAssessment: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    appDir: string;
+    runCommand: string;
+    port: number;
+    selfAssessment: string;
+}, {
+    appDir: string;
+    runCommand: string;
+    port: number;
+    selfAssessment: string;
+}>;
+export declare const QAReportSchema: z.ZodObject<{
+    passed: z.ZodBoolean;
+    scores: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    feedback: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    passed: boolean;
+    scores: Record<string, number>;
+    feedback: string[];
+}, {
+    passed: boolean;
+    scores: Record<string, number>;
+    feedback: string[];
+}>;
+export type Feature = z.infer<typeof FeatureSchema>;
+export type TechStack = z.infer<typeof TechStackSchema>;
+export type ProductSpec = z.infer<typeof ProductSpecSchema>;
+export type BuildResult = z.infer<typeof BuildResultSchema>;
+export type QAReport = z.infer<typeof QAReportSchema>;
+export declare function hasQAPassed(result: unknown): boolean;
+export declare const Feature: {
+    parse: (d: unknown) => {
+        name: string;
+        description: string;
+    };
+};
+export declare const TechStack: {
+    parse: (d: unknown) => {
+        frontend: string;
+        backend: string;
+        database: string;
+    };
+};
+export declare const ProductSpec: {
+    parse: (d: unknown) => {
+        appName: string;
+        features: {
+            name: string;
+            description: string;
+        }[];
+        techStack: {
+            frontend: string;
+            backend: string;
+            database: string;
+        };
+        designDirection: string;
+    };
+};
+export declare const BuildResult: {
+    parse: (d: unknown) => {
+        appDir: string;
+        runCommand: string;
+        port: number;
+        selfAssessment: string;
+    };
+};
+export declare const QAReport: {
+    parse: (d: unknown) => {
+        passed: boolean;
+        scores: Record<string, number>;
+        feedback: string[];
+    };
+};

package/dist/handoff.js

@@ -0,0 +1,42 @@
+import { z } from "zod";
+export const FeatureSchema = z.object({
+    name: z.string(),
+    description: z.string(),
+});
+export const TechStackSchema = z.object({
+    frontend: z.string(),
+    backend: z.string(),
+    database: z.string(),
+});
+export const ProductSpecSchema = z.object({
+    appName: z.string(),
+    features: z.array(FeatureSchema),
+    techStack: TechStackSchema,
+    designDirection: z.string(),
+});
+export const BuildResultSchema = z.object({
+    appDir: z.string(),
+    runCommand: z.string(),
+    port: z.number(),
+    selfAssessment: z.string(),
+});
+export const QAReportSchema = z.object({
+    passed: z.boolean(),
+    scores: z.record(z.string(), z.number()),
+    feedback: z.array(z.string()),
+});
+export function hasQAPassed(result) {
+    if (result != null && typeof result === "object" && "passed" in result) {
+        return result.passed === true;
+    }
+    return false;
+}
+function makeParser(schema) {
+    return { parse: (d) => schema.parse(d) };
+}
+export const Feature = makeParser(FeatureSchema);
+export const TechStack = makeParser(TechStackSchema);
+export const ProductSpec = makeParser(ProductSpecSchema);
+export const BuildResult = makeParser(BuildResultSchema);
+export const QAReport = makeParser(QAReportSchema);
+//# sourceMappingURL=handoff.js.map

package/dist/handoff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handoff.js","sourceRoot":"","sources":["../src/handoff.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;CACxB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;CACrB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC;IAChC,SAAS,EAAE,eAAe;IAC1B,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE;CAC5B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE;CAC3B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;IACnB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;IACxC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CAC9B,CAAC,CAAC;AAQH,MAAM,UAAU,WAAW,CAAC,MAAe;IACzC,IAAI,MAAM,IAAI,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,QAAQ,IAAI,MAAM,EAAE,CAAC;QACvE,OAAQ,MAA8B,CAAC,MAAM,KAAK,IAAI,CAAC;IACzD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,UAAU,CAAI,MAAoC;IACzD,OAAO,EAAE,KAAK,EAAE,CAAC,CAAU,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AACpD,CAAC;AAED,MAAM,CAAC,MAAM,OAAO,GAAG,UAAU,CAAC,aAAa,CAAC,CAAC;AACjD,MAAM,CAAC,MAAM,SAAS,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC;AACrD,MAAM,CAAC,MAAM,WAAW,GAAG,UAAU,CAAC,iBAAiB,CAAC,CAAC;AACzD,MAAM,CAAC,MAAM,WAAW,GAAG,UAAU,CAAC,iBAAiB,CAAC,CAAC;AACzD,MAAM,CAAC,MAAM,QAAQ,GAAG,UAAU,CAAC,cAAc,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { Agent, Agent as BaseAgent, agent, loadAgent, type ResultMetrics } from "./agent.js";
+export { EventBus, executeWithRetry, defaultShouldRetry, defaultBackoff, type OrchestratorEvent, type RetryPolicy, } from "./events.js";
+export { findJsonString, parseTrailingOptions, createMetrics, accumulateMetrics, type MetricsAccumulator } from "./utils.js";
+export { FeatureSchema, TechStackSchema, ProductSpecSchema, BuildResultSchema, QAReportSchema, type Feature, type TechStack, type ProductSpec, type BuildResult, type QAReport, hasQAPassed, } from "./handoff.js";
+export { Pipeline, pipe, Loop, Parallel, Contract, Sprint, type PipelineOptions, type LoopOptions, type ParallelOptions, type ParallelResult, type ContractOptions, type SprintOptions, } from "./orchestration/index.js";
+export { OutputFormatter } from "./cli/output.js";
+export { SkillRegistry, type SkillInfo } from "./tools/skills.js";
+export { setFormatter, setSkillRegistry, getSkillRegistry } from "./context.js";
+export { RunContextSchema, type RunContext, type Runnable, type MetricsSnapshot } from "./types.js";

package/dist/index.js

@@ -0,0 +1,10 @@
+export { Agent, Agent as BaseAgent, agent, loadAgent } from "./agent.js";
+export { EventBus, executeWithRetry, defaultShouldRetry, defaultBackoff, } from "./events.js";
+export { findJsonString, parseTrailingOptions, createMetrics, accumulateMetrics } from "./utils.js";
+export { FeatureSchema, TechStackSchema, ProductSpecSchema, BuildResultSchema, QAReportSchema, hasQAPassed, } from "./handoff.js";
+export { Pipeline, pipe, Loop, Parallel, Contract, Sprint, } from "./orchestration/index.js";
+export { OutputFormatter } from "./cli/output.js";
+export { SkillRegistry } from "./tools/skills.js";
+export { setFormatter, setSkillRegistry, getSkillRegistry } from "./context.js";
+export { RunContextSchema } from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,IAAI,SAAS,EAAE,KAAK,EAAE,SAAS,EAAsB,MAAM,YAAY,CAAC;AAC7F,OAAO,EACL,QAAQ,EACR,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,GAGf,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,aAAa,EAAE,iBAAiB,EAA2B,MAAM,YAAY,CAAC;AAC7H,OAAO,EACL,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EAMd,WAAW,GACZ,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,QAAQ,EACR,IAAI,EACJ,IAAI,EACJ,QAAQ,EACR,QAAQ,EACR,MAAM,GAOP,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAkB,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAwD,MAAM,YAAY,CAAC"}

package/dist/orchestration/contract.d.ts

@@ -0,0 +1,27 @@
+import type { Runnable } from "../types.js";
+import type { EventBus, RetryPolicy } from "../events.js";
+export interface ContractOptions<TReview = unknown> {
+    maxRounds?: number;
+    isAccepted?: (review: TReview) => boolean;
+    retryPolicy?: RetryPolicy;
+    eventBus?: EventBus;
+}
+export declare class Contract<TIn = unknown, TProposal = unknown, TReview = unknown> implements Runnable<TIn, TProposal> {
+    name?: string;
+    private proposer;
+    private reviewer;
+    private maxRounds;
+    private retryPolicy;
+    private eventBus;
+    private customIsAccepted;
+    private _lastMetrics;
+    private _lastProposal;
+    private _lastEvaluatorResult;
+    constructor(proposer: Runnable<TIn | TReview, TProposal>, reviewer: Runnable<TProposal, TReview>, options?: ContractOptions<TReview>);
+    get lastMetrics(): import("../types.js").MetricsSnapshot | null;
+    get lastEvaluatorResult(): TReview | null;
+    run(input: TIn): Promise<TProposal>;
+    private executeRound;
+    private parseReview;
+    private isAccepted;
+}

package/dist/orchestration/contract.js

@@ -0,0 +1,104 @@
+import { findJsonString } from "../utils.js";
+import { runWithOptionalRetry, errorMessage } from "../events.js";
+import { createMetrics, accumulateMetrics } from "../utils.js";
+const DEFAULT_MAX_ROUNDS = 3;
+export class Contract {
+    name;
+    proposer;
+    reviewer;
+    maxRounds;
+    retryPolicy;
+    eventBus;
+    customIsAccepted = null;
+    _lastMetrics = null;
+    _lastProposal = null;
+    _lastEvaluatorResult = null;
+    constructor(proposer, reviewer, options) {
+        this.proposer = proposer;
+        this.reviewer = reviewer;
+        this.maxRounds = options?.maxRounds ?? DEFAULT_MAX_ROUNDS;
+        this.customIsAccepted = options?.isAccepted ?? null;
+        this.retryPolicy = options?.retryPolicy ?? null;
+        this.eventBus = options?.eventBus ?? null;
+    }
+    get lastMetrics() { return this._lastMetrics; }
+    get lastEvaluatorResult() { return this._lastEvaluatorResult; }
+    async run(input) {
+        this._lastMetrics = null;
+        this._lastProposal = null;
+        this._lastEvaluatorResult = null;
+        const accumulated = createMetrics();
+        let proposalInput = input;
+        let review;
+        try {
+            for (let round = 0; round < this.maxRounds; round++) {
+                this.eventBus?.emit({ type: "round:start", round, timestamp: Date.now() });
+                try {
+                    review = await this.executeRound(round, proposalInput, accumulated);
+                }
+                catch (err) {
+                    this.eventBus?.emit({
+                        type: "round:error",
+                        round,
+                        error: errorMessage(err),
+                        timestamp: Date.now(),
+                    });
+                    throw new Error(`[Contract:round-${round + 1}] ${errorMessage(err)}`);
+                }
+                if (this.isAccepted(review)) {
+                    this._lastMetrics = { ...accumulated };
+                    return this._lastProposal;
+                }
+                proposalInput = review;
+            }
+            this._lastMetrics = { ...accumulated };
+            return review;
+        }
+        finally {
+            if (!this._lastMetrics) {
+                this._lastMetrics = { ...accumulated };
+            }
+        }
+    }
+    async executeRound(round, proposalInput, accumulated) {
+        const proposal = await runWithOptionalRetry(this.proposer, proposalInput, this.retryPolicy, this.eventBus);
+        this._lastProposal = proposal;
+        const pm = this.proposer.lastMetrics;
+        accumulateMetrics(accumulated, pm);
+        const review = this.parseReview(await runWithOptionalRetry(this.reviewer, proposal, this.retryPolicy, this.eventBus));
+        this._lastEvaluatorResult = review;
+        const rm = this.reviewer.lastMetrics;
+        accumulateMetrics(accumulated, rm);
+        const roundCost = (pm?.cost ?? 0) + (rm?.cost ?? 0);
+        this.eventBus?.emit({
+            type: "round:done",
+            round,
+            result: review,
+            cost: roundCost || undefined,
+            timestamp: Date.now(),
+        });
+        return review;
+    }
+    parseReview(review) {
+        if (typeof review !== "string")
+            return review;
+        const jsonStr = findJsonString(review);
+        if (!jsonStr)
+            return review;
+        try {
+            return JSON.parse(jsonStr);
+        }
+        catch {
+            return review;
+        }
+    }
+    isAccepted(review) {
+        if (this.customIsAccepted)
+            return this.customIsAccepted(review);
+        if (review == null || typeof review !== "object")
+            return false;
+        const accepted = review.accepted;
+        return typeof accepted === "boolean" && accepted;
+    }
+}
+//# sourceMappingURL=contract.js.map

package/dist/orchestration/contract.js.map

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

package/dist/orchestration/index.d.ts

@@ -0,0 +1,10 @@
+export { Pipeline, pipe } from "./pipeline.js";
+export type { PipelineOptions } from "./pipeline.js";
+export { Loop } from "./loop.js";
+export type { LoopOptions } from "./loop.js";
+export { Parallel } from "./parallel.js";
+export type { ParallelOptions, ParallelResult } from "./parallel.js";
+export { Contract } from "./contract.js";
+export type { ContractOptions } from "./contract.js";
+export { Sprint } from "./sprint.js";
+export type { SprintOptions } from "./sprint.js";

package/dist/orchestration/index.js

@@ -0,0 +1,6 @@
+export { Pipeline, pipe } from "./pipeline.js";
+export { Loop } from "./loop.js";
+export { Parallel } from "./parallel.js";
+export { Contract } from "./contract.js";
+export { Sprint } from "./sprint.js";
+//# sourceMappingURL=index.js.map

package/dist/orchestration/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/orchestration/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAE/C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC"}