octoflow-core 1.0.0

package/dist/runtime/orchestration/run/loop-engine.js

@@ -0,0 +1,287 @@
+import crypto from "node:crypto";
+import { AgentTimeoutError } from "../../../domain/errors/agent.js";
+import { extractText } from "../../../utils/extract-text.js";
+const DEFAULT_MAX_ITERATIONS = 50;
+const DEFAULT_MAX_CONSECUTIVE_FAILURES = 3;
+const DEFAULT_COMPLETION_CONFIRMATIONS = 2;
+const STALE_REPEAT_THRESHOLD = 3;
+const DEFAULT_PROGRESS_STALE_THRESHOLD = 5;
+const DEFAULT_LOOP_OUTCOME_CLASS = {
+  "completion-promise": "success",
+  "stop-condition": "success",
+  "max-iterations": "incomplete",
+  "max-runtime": "incomplete",
+  "max-cost": "incomplete",
+  "stale-loop": "incomplete",
+  "stale-progress": "incomplete",
+  paused: "incomplete",
+  error: "failure",
+  "consecutive-failures": "failure",
+  cancelled: "cancelled"
+};
+function classifyLoopOutcome(reason) {
+  return DEFAULT_LOOP_OUTCOME_CLASS[reason];
+}
+function computeSignature(result) {
+  const text = extractText(result);
+  return crypto.createHash("sha1").update(text).digest("hex").slice(0, 16);
+}
+function matchesCompletionPromise(text, promise, mode) {
+  if (mode === "exact") return text.trim() === promise;
+  return text.includes(promise);
+}
+function extractCostFromResult(result) {
+  const meta = result.task?.metadata;
+  const bridge = meta?.bridge;
+  const costUsd = bridge?.costUsd;
+  if (typeof costUsd === "number") return costUsd;
+  return 0;
+}
+async function* runLoopStream(executor, message, contextId, config) {
+  const maxIterations = config.continuous ? Number.MAX_SAFE_INTEGER : config.maxIterations ?? DEFAULT_MAX_ITERATIONS;
+  const maxConsecutiveFailures = config.maxConsecutiveFailures ?? DEFAULT_MAX_CONSECUTIVE_FAILURES;
+  const completionConfirmations = config.completionConfirmations ?? DEFAULT_COMPLETION_CONFIRMATIONS;
+  const completionMode = config.completionPromiseMode ?? "includes";
+  const staleDetection = config.staleDetection ?? config.continuous ?? false;
+  const ctx = {
+    iteration: 0,
+    elapsedMs: 0,
+    cumulativeCost: 0,
+    consecutiveFailures: 0,
+    lastOutputSignatures: [],
+    progressStaleCount: 0,
+    contextId
+  };
+  const startTime = Date.now();
+  let completionConfirmCount = 0;
+  let lastProgressMetric;
+  let terminationReason;
+  let cancelled = false;
+  let abortHandler;
+  if (config.signal) {
+    if (config.signal.aborted) {
+      cancelled = true;
+    } else {
+      abortHandler = () => {
+        cancelled = true;
+      };
+      config.signal.addEventListener("abort", abortHandler, { once: true });
+    }
+  }
+  while (ctx.iteration < maxIterations && !cancelled) {
+    ctx.elapsedMs = Date.now() - startTime;
+    if (config.maxRuntimeMs && ctx.elapsedMs >= config.maxRuntimeMs) {
+      terminationReason = "max-runtime";
+      break;
+    }
+    if (config.maxCostUsd !== void 0 && (ctx.cumulativeCost ?? 0) >= config.maxCostUsd) {
+      terminationReason = "max-cost";
+      break;
+    }
+    if (config.gate) {
+      const decision = await config.gate(ctx);
+      if (decision === "pause") {
+        terminationReason = "paused";
+        yield {
+          kind: "loop-paused",
+          source: "loop",
+          iteration: ctx.iteration,
+          contextId
+        };
+        break;
+      }
+    }
+    const iterationMessage = ctx.iteration === 0 ? message : await config.onIterationResult?.(ctx) ?? message;
+    if (iterationMessage === false) {
+      terminationReason = "stop-condition";
+      break;
+    }
+    await config.onIteration?.(ctx);
+    yield {
+      kind: "loop-iteration",
+      source: "loop",
+      iteration: ctx.iteration,
+      elapsedMs: ctx.elapsedMs
+    };
+    let currentResult;
+    try {
+      const executorPromise = executor(
+        iterationMessage,
+        contextId,
+        ctx.iteration
+      );
+      currentResult = config.iterationTimeoutMs ? await Promise.race([
+        executorPromise,
+        new Promise((_, reject) => {
+          const id = setTimeout(
+            () => reject(new Error("iteration-timeout")),
+            config.iterationTimeoutMs
+          );
+          executorPromise.then(
+            () => clearTimeout(id),
+            () => clearTimeout(id)
+          );
+        })
+      ]) : await executorPromise;
+      ctx.consecutiveFailures = 0;
+      const iterationCost = extractCostFromResult(currentResult);
+      ctx.cumulativeCost = (ctx.cumulativeCost ?? 0) + iterationCost;
+    } catch (err) {
+      if (err instanceof AgentTimeoutError) throw err;
+      if (err instanceof Error && (err.name === "AbortError" || err.message === "CLI process canceled")) {
+        throw err;
+      }
+      ctx.consecutiveFailures++;
+      completionConfirmCount = 0;
+      if (ctx.consecutiveFailures >= maxConsecutiveFailures) {
+        terminationReason = "consecutive-failures";
+        break;
+      }
+    }
+    if (currentResult !== void 0) {
+      const resultText = extractText(currentResult);
+      const stepOutput = {
+        text: resultText,
+        bridgeResult: currentResult
+      };
+      ctx.lastResult = stepOutput;
+      if (config.completionPromise && matchesCompletionPromise(
+        resultText,
+        config.completionPromise,
+        completionMode
+      )) {
+        completionConfirmCount++;
+        if (completionConfirmCount >= completionConfirmations) {
+          terminationReason = "completion-promise";
+          ctx.iteration++;
+          break;
+        }
+      } else {
+        completionConfirmCount = 0;
+      }
+    }
+    if (config.stopWhen && await config.stopWhen(ctx)) {
+      terminationReason = "stop-condition";
+      ctx.iteration++;
+      break;
+    }
+    if (currentResult !== void 0 && staleDetection) {
+      const sig = computeSignature(currentResult);
+      ctx.lastOutputSignatures.push(sig);
+      if (ctx.lastOutputSignatures.length > STALE_REPEAT_THRESHOLD) {
+        ctx.lastOutputSignatures.shift();
+      }
+      if (ctx.lastOutputSignatures.length >= STALE_REPEAT_THRESHOLD && ctx.lastOutputSignatures.every((s) => s === ctx.lastOutputSignatures[0])) {
+        terminationReason = "stale-loop";
+        ctx.iteration++;
+        break;
+      }
+    }
+    if (config.progressMetric) {
+      const metric = await config.progressMetric(ctx);
+      const threshold = config.progressStaleThreshold ?? DEFAULT_PROGRESS_STALE_THRESHOLD;
+      ctx.progressMetric = metric;
+      const isStale = lastProgressMetric !== void 0 && (config.progressDirection === "higher-is-better" ? metric <= lastProgressMetric : metric >= lastProgressMetric);
+      if (isStale) {
+        ctx.progressStaleCount++;
+      } else {
+        ctx.progressStaleCount = 0;
+      }
+      lastProgressMetric = metric;
+      if (ctx.progressStaleCount >= threshold) {
+        terminationReason = "stale-progress";
+        ctx.iteration++;
+        break;
+      }
+    }
+    ctx.iteration++;
+    if (config.cooldownMs && config.cooldownMs > 0) {
+      await new Promise((r) => setTimeout(r, config.cooldownMs));
+    }
+  }
+  if (!terminationReason) {
+    if (cancelled) {
+      terminationReason = "cancelled";
+    } else {
+      terminationReason = ctx.iteration >= maxIterations ? "max-iterations" : "cancelled";
+    }
+  }
+  ctx.elapsedMs = Date.now() - startTime;
+  await config.onTermination?.(terminationReason);
+  const outcomeClass = classifyLoopOutcome(terminationReason);
+  yield {
+    kind: "loop-terminated",
+    source: "loop",
+    reason: terminationReason,
+    outcomeClass,
+    totalIterations: ctx.iteration,
+    totalElapsedMs: ctx.elapsedMs,
+    totalCost: ctx.cumulativeCost
+  };
+  if (abortHandler) {
+    config.signal?.removeEventListener("abort", abortHandler);
+  }
+}
+function buildLoopResult(lastResult, terminationReason, totalIterations, totalElapsedMs, contextId, totalCost, outcomeClass = classifyLoopOutcome(terminationReason)) {
+  const base = lastResult ?? {
+    kind: "task",
+    contextId,
+    taskId: crypto.randomUUID(),
+    task: {
+      id: crypto.randomUUID(),
+      kind: "task",
+      contextId,
+      status: { state: "failed" }
+    }
+  };
+  return {
+    ...base,
+    terminationReason,
+    outcomeClass,
+    totalIterations,
+    totalElapsedMs,
+    totalCost
+  };
+}
+async function executeLoop(executor, message, contextId, config) {
+  let lastResult;
+  let finalReason = "cancelled";
+  let finalIterations = 0;
+  let finalCost;
+  let finalOutcomeClass;
+  const startTime = Date.now();
+  const wrappedExecutor = async (msg, ctx, iteration) => {
+    const result = await executor(msg, ctx, iteration);
+    lastResult = result;
+    return result;
+  };
+  for await (const event of runLoopStream(
+    wrappedExecutor,
+    message,
+    contextId,
+    config
+  )) {
+    if (event.kind === "loop-terminated") {
+      finalReason = event.reason;
+      finalIterations = event.totalIterations;
+      finalCost = event.totalCost;
+      finalOutcomeClass = event.outcomeClass;
+    }
+  }
+  return buildLoopResult(
+    lastResult,
+    finalReason,
+    finalIterations,
+    Date.now() - startTime,
+    contextId,
+    finalCost,
+    finalOutcomeClass
+  );
+}
+export {
+  buildLoopResult,
+  classifyLoopOutcome,
+  executeLoop,
+  runLoopStream
+};
+//# sourceMappingURL=loop-engine.js.map

package/dist/runtime/orchestration/run/loop-engine.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/runtime/orchestration/run/loop-engine.ts"],
+  "sourcesContent": ["import crypto from 'node:crypto';\n\nimport { AgentTimeoutError } from '../../../domain/errors/agent.js';\nimport { extractText } from '../../../utils/extract-text.js';\nimport type {\n  BridgeLoopResult,\n  BridgeTaskResult,\n  LoopConfig,\n  LoopContext,\n  LoopExecutor,\n  LoopOutcomeClass,\n  RunEvent,\n  StepOutput,\n  TerminationReason,\n} from './types.js';\n\nconst DEFAULT_MAX_ITERATIONS = 50;\nconst DEFAULT_MAX_CONSECUTIVE_FAILURES = 3;\nconst DEFAULT_COMPLETION_CONFIRMATIONS = 2;\nconst STALE_REPEAT_THRESHOLD = 3;\nconst DEFAULT_PROGRESS_STALE_THRESHOLD = 5;\n\nconst DEFAULT_LOOP_OUTCOME_CLASS: Record<TerminationReason, LoopOutcomeClass> =\n  {\n    'completion-promise': 'success',\n    'stop-condition': 'success',\n    'max-iterations': 'incomplete',\n    'max-runtime': 'incomplete',\n    'max-cost': 'incomplete',\n    'stale-loop': 'incomplete',\n    'stale-progress': 'incomplete',\n    paused: 'incomplete',\n    error: 'failure',\n    'consecutive-failures': 'failure',\n    cancelled: 'cancelled',\n  };\n\nexport function classifyLoopOutcome(\n  reason: TerminationReason\n): LoopOutcomeClass {\n  return DEFAULT_LOOP_OUTCOME_CLASS[reason];\n}\n\n// Design Gap 2 fix: hash full text instead of raw 128-char prefix.\nfunction computeSignature(result: BridgeTaskResult): string {\n  const text = extractText(result);\n  return crypto.createHash('sha1').update(text).digest('hex').slice(0, 16);\n}\n\nfunction matchesCompletionPromise(\n  text: string,\n  promise: string,\n  mode: 'exact' | 'includes'\n): boolean {\n  if (mode === 'exact') return text.trim() === promise;\n  return text.includes(promise);\n}\n\nfunction extractCostFromResult(result: BridgeTaskResult): number {\n  const meta = result.task?.metadata;\n  const bridge = meta?.bridge;\n  const costUsd = bridge?.costUsd;\n  if (typeof costUsd === 'number') return costUsd;\n  // Bug 3 fix: hardcoded fallback removed \u2014 returns 0 when backend omits cost data.\n  return 0;\n}\n\nexport async function* runLoopStream(\n  executor: LoopExecutor,\n  message: string,\n  contextId: string,\n  config: LoopConfig\n): AsyncGenerator<RunEvent> {\n  const maxIterations = config.continuous\n    ? Number.MAX_SAFE_INTEGER\n    : (config.maxIterations ?? DEFAULT_MAX_ITERATIONS);\n  const maxConsecutiveFailures =\n    config.maxConsecutiveFailures ?? DEFAULT_MAX_CONSECUTIVE_FAILURES;\n  const completionConfirmations =\n    config.completionConfirmations ?? DEFAULT_COMPLETION_CONFIRMATIONS;\n  const completionMode = config.completionPromiseMode ?? 'includes';\n  const staleDetection = config.staleDetection ?? config.continuous ?? false;\n\n  const ctx: LoopContext = {\n    iteration: 0,\n    elapsedMs: 0,\n    cumulativeCost: 0,\n    consecutiveFailures: 0,\n    lastOutputSignatures: [],\n    progressStaleCount: 0,\n    contextId,\n  };\n\n  const startTime = Date.now();\n  let completionConfirmCount = 0;\n  let lastProgressMetric: number | undefined;\n  let terminationReason: TerminationReason | undefined;\n  let cancelled = false;\n  let abortHandler: (() => void) | undefined;\n\n  if (config.signal) {\n    if (config.signal.aborted) {\n      cancelled = true;\n    } else {\n      abortHandler = () => {\n        cancelled = true;\n      };\n      config.signal.addEventListener('abort', abortHandler, { once: true });\n    }\n  }\n\n  while (ctx.iteration < maxIterations && !cancelled) {\n    ctx.elapsedMs = Date.now() - startTime;\n\n    if (config.maxRuntimeMs && ctx.elapsedMs >= config.maxRuntimeMs) {\n      terminationReason = 'max-runtime';\n      break;\n    }\n\n    // Bug 3 fix: removed falsy short-circuit on ctx.cumulativeCost.\n    if (\n      config.maxCostUsd !== undefined &&\n      (ctx.cumulativeCost ?? 0) >= config.maxCostUsd\n    ) {\n      terminationReason = 'max-cost';\n      break;\n    }\n\n    if (config.gate) {\n      const decision = await config.gate(ctx);\n      if (decision === 'pause') {\n        terminationReason = 'paused';\n        yield {\n          kind: 'loop-paused',\n          source: 'loop',\n          iteration: ctx.iteration,\n          contextId,\n        };\n        break;\n      }\n    }\n\n    const iterationMessage =\n      ctx.iteration === 0\n        ? message\n        : ((await config.onIterationResult?.(ctx)) ?? message);\n\n    if (iterationMessage === false) {\n      terminationReason = 'stop-condition';\n      break;\n    }\n\n    await config.onIteration?.(ctx);\n\n    yield {\n      kind: 'loop-iteration',\n      source: 'loop',\n      iteration: ctx.iteration,\n      elapsedMs: ctx.elapsedMs,\n    };\n\n    // Design Gap 1: per-iteration timeout via Promise.race when iterationTimeoutMs is set.\n    let currentResult: BridgeTaskResult | undefined;\n    try {\n      const executorPromise = executor(\n        iterationMessage,\n        contextId,\n        ctx.iteration\n      );\n      currentResult = config.iterationTimeoutMs\n        ? await Promise.race([\n            executorPromise,\n            new Promise<never>((_, reject) => {\n              const id = setTimeout(\n                () => reject(new Error('iteration-timeout')),\n                config.iterationTimeoutMs\n              );\n              executorPromise.then(\n                () => clearTimeout(id),\n                () => clearTimeout(id)\n              );\n            }),\n          ])\n        : await executorPromise;\n      ctx.consecutiveFailures = 0;\n\n      const iterationCost = extractCostFromResult(currentResult);\n      ctx.cumulativeCost = (ctx.cumulativeCost ?? 0) + iterationCost;\n    } catch (err) {\n      // Hard-stop errors imposed by the caller must not be retried \u2014 they\n      // represent an explicit cancellation or deadline, not a backend hiccup.\n      if (err instanceof AgentTimeoutError) throw err;\n      if (\n        err instanceof Error &&\n        (err.name === 'AbortError' || err.message === 'CLI process canceled')\n      ) {\n        throw err;\n      }\n\n      ctx.consecutiveFailures++;\n      // Bug 4 fix: reset so a failure between two matches doesn't count as consecutive.\n      completionConfirmCount = 0;\n      if (ctx.consecutiveFailures >= maxConsecutiveFailures) {\n        terminationReason = 'consecutive-failures';\n        break;\n      }\n      // Bug 1 fix: fall through instead of `continue` so stopWhen and progressMetric\n      // still evaluate against ctx.lastResult from the prior successful iteration.\n    }\n\n    // Result-text processing only when the executor succeeded this iteration.\n    if (currentResult !== undefined) {\n      const resultText = extractText(currentResult);\n      const stepOutput: StepOutput = {\n        text: resultText,\n        bridgeResult: currentResult,\n      };\n      ctx.lastResult = stepOutput;\n\n      if (\n        config.completionPromise &&\n        matchesCompletionPromise(\n          resultText,\n          config.completionPromise,\n          completionMode\n        )\n      ) {\n        completionConfirmCount++;\n        if (completionConfirmCount >= completionConfirmations) {\n          terminationReason = 'completion-promise';\n          ctx.iteration++;\n          break;\n        }\n      } else {\n        completionConfirmCount = 0;\n      }\n    }\n\n    // Bug 1 fix: stopWhen runs even after a non-fatal executor failure.\n    if (config.stopWhen && (await config.stopWhen(ctx))) {\n      terminationReason = 'stop-condition';\n      ctx.iteration++;\n      break;\n    }\n\n    if (currentResult !== undefined && staleDetection) {\n      const sig = computeSignature(currentResult);\n      ctx.lastOutputSignatures.push(sig);\n      if (ctx.lastOutputSignatures.length > STALE_REPEAT_THRESHOLD) {\n        ctx.lastOutputSignatures.shift();\n      }\n      if (\n        ctx.lastOutputSignatures.length >= STALE_REPEAT_THRESHOLD &&\n        ctx.lastOutputSignatures.every((s) => s === ctx.lastOutputSignatures[0])\n      ) {\n        terminationReason = 'stale-loop';\n        ctx.iteration++;\n        break;\n      }\n    }\n\n    // Bug 1 fix: progressMetric runs even after a non-fatal executor failure.\n    if (config.progressMetric) {\n      const metric = await config.progressMetric(ctx);\n      const threshold =\n        config.progressStaleThreshold ?? DEFAULT_PROGRESS_STALE_THRESHOLD;\n\n      ctx.progressMetric = metric;\n\n      // Bug 2 fix: respect progressDirection; default assumes lower-is-better.\n      const isStale =\n        lastProgressMetric !== undefined &&\n        (config.progressDirection === 'higher-is-better'\n          ? metric <= lastProgressMetric\n          : metric >= lastProgressMetric);\n\n      if (isStale) {\n        ctx.progressStaleCount++;\n      } else {\n        ctx.progressStaleCount = 0;\n      }\n      lastProgressMetric = metric;\n\n      if (ctx.progressStaleCount >= threshold) {\n        terminationReason = 'stale-progress';\n        ctx.iteration++;\n        break;\n      }\n    }\n\n    ctx.iteration++;\n\n    if (config.cooldownMs && config.cooldownMs > 0) {\n      await new Promise<void>((r) => setTimeout(r, config.cooldownMs));\n    }\n  }\n\n  if (!terminationReason) {\n    if (cancelled) {\n      terminationReason = 'cancelled';\n    } else {\n      terminationReason =\n        ctx.iteration >= maxIterations ? 'max-iterations' : 'cancelled';\n    }\n  }\n\n  ctx.elapsedMs = Date.now() - startTime;\n  await config.onTermination?.(terminationReason);\n  const outcomeClass = classifyLoopOutcome(terminationReason);\n\n  yield {\n    kind: 'loop-terminated',\n    source: 'loop',\n    reason: terminationReason,\n    outcomeClass,\n    totalIterations: ctx.iteration,\n    totalElapsedMs: ctx.elapsedMs,\n    totalCost: ctx.cumulativeCost,\n  };\n\n  if (abortHandler) {\n    config.signal?.removeEventListener('abort', abortHandler);\n  }\n}\n\nexport function buildLoopResult(\n  lastResult: BridgeTaskResult | undefined,\n  terminationReason: TerminationReason,\n  totalIterations: number,\n  totalElapsedMs: number,\n  contextId: string,\n  totalCost?: number,\n  outcomeClass = classifyLoopOutcome(terminationReason)\n): BridgeLoopResult {\n  const base: BridgeTaskResult = lastResult ?? {\n    kind: 'task',\n    contextId,\n    taskId: crypto.randomUUID(),\n    task: {\n      id: crypto.randomUUID(),\n      kind: 'task',\n      contextId,\n      status: { state: 'failed' },\n    },\n  };\n\n  return {\n    ...base,\n    terminationReason,\n    outcomeClass,\n    totalIterations,\n    totalElapsedMs,\n    totalCost,\n  };\n}\n\nexport async function executeLoop(\n  executor: LoopExecutor,\n  message: string,\n  contextId: string,\n  config: LoopConfig\n): Promise<BridgeLoopResult> {\n  let lastResult: BridgeTaskResult | undefined;\n  let finalReason: TerminationReason = 'cancelled';\n  let finalIterations = 0;\n  let finalCost: number | undefined;\n  let finalOutcomeClass: LoopOutcomeClass | undefined;\n  const startTime = Date.now();\n\n  const wrappedExecutor: LoopExecutor = async (msg, ctx, iteration) => {\n    const result = await executor(msg, ctx, iteration);\n    lastResult = result;\n    return result;\n  };\n\n  for await (const event of runLoopStream(\n    wrappedExecutor,\n    message,\n    contextId,\n    config\n  )) {\n    if (event.kind === 'loop-terminated') {\n      finalReason = event.reason;\n      finalIterations = event.totalIterations;\n      finalCost = event.totalCost;\n      finalOutcomeClass = event.outcomeClass;\n    }\n  }\n\n  return buildLoopResult(\n    lastResult,\n    finalReason,\n    finalIterations,\n    Date.now() - startTime,\n    contextId,\n    finalCost,\n    finalOutcomeClass\n  );\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/runtime/orchestration/run/orchestration-stream.d.ts

@@ -0,0 +1,20 @@
+import type { FabricAccessor } from '../../bridge/fabric-types.js';
+import type { BridgeLoopResult, FlowConfig, FlowRunResult, LoopConfig, LoopExecutor, RunBatchResult, RunEvent, StepDispatcher, TaskConfig } from './types.js';
+export type OrchestrationRunResult<TLoopResult extends BridgeLoopResult = BridgeLoopResult> = TLoopResult | FlowRunResult | RunBatchResult<TLoopResult>;
+export interface RunOrchestrationStreamParams<TLoopResult extends BridgeLoopResult = BridgeLoopResult> {
+    contextId: string;
+    message?: string;
+    loop?: LoopConfig;
+    flow?: FlowConfig;
+    tasks?: TaskConfig;
+    executor: LoopExecutor;
+    flowDispatcher?: StepDispatcher;
+    fabric?: FabricAccessor;
+    missingInputMessage: string;
+    mapLoopResult?: (result: BridgeLoopResult) => TLoopResult;
+    mapTaskResult?: (result: BridgeLoopResult) => TLoopResult;
+    onEvent?: (event: RunEvent) => void | Promise<void>;
+}
+export declare function drainRunStream<T>(stream: AsyncGenerator<RunEvent, T, void>): Promise<T>;
+export declare function runOrchestrationStream<TLoopResult extends BridgeLoopResult = BridgeLoopResult>(params: RunOrchestrationStreamParams<TLoopResult>): AsyncGenerator<RunEvent, OrchestrationRunResult<TLoopResult>, void>;
+//# sourceMappingURL=orchestration-stream.d.ts.map

package/dist/runtime/orchestration/run/orchestration-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestration-stream.d.ts","sourceRoot":"","sources":["../../../../src/runtime/orchestration/run/orchestration-stream.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAKnE,OAAO,KAAK,EACV,gBAAgB,EAEhB,UAAU,EACV,aAAa,EACb,UAAU,EACV,YAAY,EAEZ,cAAc,EACd,QAAQ,EACR,cAAc,EACd,UAAU,EAEX,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,sBAAsB,CAChC,WAAW,SAAS,gBAAgB,GAAG,gBAAgB,IACrD,WAAW,GAAG,aAAa,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;AAE9D,MAAM,WAAW,4BAA4B,CAC3C,WAAW,SAAS,gBAAgB,GAAG,gBAAgB;IAEvD,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,YAAY,CAAC;IACvB,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,WAAW,CAAC;IAC1D,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,WAAW,CAAC;IAC1D,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrD;AAeD,wBAAsB,cAAc,CAAC,CAAC,EACpC,MAAM,EAAE,cAAc,CAAC,QAAQ,EAAE,CAAC,EAAE,IAAI,CAAC,GACxC,OAAO,CAAC,CAAC,CAAC,CAMZ;AAuJD,wBAAuB,sBAAsB,CAC3C,WAAW,SAAS,gBAAgB,GAAG,gBAAgB,EAEvD,MAAM,EAAE,4BAA4B,CAAC,WAAW,CAAC,GAChD,cAAc,CAAC,QAAQ,EAAE,sBAAsB,CAAC,WAAW,CAAC,EAAE,IAAI,CAAC,CAiBrE"}

package/dist/runtime/orchestration/run/orchestration-stream.js

@@ -0,0 +1,165 @@
+import { assertNever } from "../../../utils/assert-never.js";
+import { runFlowEngineStream } from "./flow-engine.js";
+import { buildLoopResult, runLoopStream } from "./loop-engine.js";
+import { runTaskBatchStream } from "./task-batch.js";
+import { buildFailedResult } from "./task-batch-graph.js";
+async function* forwardRunEvents(stream, onEvent) {
+  let next = await stream.next();
+  while (!next.done) {
+    await onEvent?.(next.value);
+    yield next.value;
+    next = await stream.next();
+  }
+  return next.value;
+}
+async function drainRunStream(stream) {
+  let next = await stream.next();
+  while (!next.done) {
+    next = await stream.next();
+  }
+  return next.value;
+}
+function identityLoopResult(result) {
+  return result;
+}
+async function* runLoopMode(params, mapLoopResult) {
+  let lastResult;
+  let finalReason = "cancelled";
+  let finalIterations = 0;
+  let finalElapsedMs = 0;
+  let finalCost;
+  let finalOutcomeClass;
+  const startTime = Date.now();
+  const wrappedExecutor = async (message, contextId, iteration) => {
+    const result = await params.executor(message, contextId, iteration);
+    lastResult = result;
+    return result;
+  };
+  for await (const event of runLoopStream(
+    wrappedExecutor,
+    params.message ?? "",
+    params.contextId,
+    params.loop ?? {}
+  )) {
+    await params.onEvent?.(event);
+    yield event;
+    if (event.kind === "loop-terminated") {
+      finalReason = event.reason;
+      finalIterations = event.totalIterations;
+      finalElapsedMs = event.totalElapsedMs;
+      finalCost = event.totalCost;
+      finalOutcomeClass = event.outcomeClass;
+    }
+  }
+  return mapLoopResult(
+    buildLoopResult(
+      lastResult,
+      finalReason,
+      finalIterations,
+      finalElapsedMs || Date.now() - startTime,
+      params.contextId,
+      finalCost,
+      finalOutcomeClass
+    )
+  );
+}
+async function* runTaskMode(params, mapTaskResult) {
+  if (!params.tasks) {
+    throw new Error("runOrchestrationStream task mode requires `tasks`");
+  }
+  const startTime = Date.now();
+  const taskResults = [];
+  let totalTasks = 0;
+  let completedTasks = 0;
+  let failedTasks = 0;
+  for await (const event of runTaskBatchStream(
+    params.executor,
+    params.tasks,
+    params.loop ?? {},
+    params.contextId
+  )) {
+    await params.onEvent?.(event);
+    yield event;
+    switch (event.kind) {
+      case "task-start":
+        break;
+      case "task-complete":
+        taskResults.push({
+          task: event.task,
+          index: event.index,
+          result: mapTaskResult(event.result),
+          branch: event.branch
+        });
+        break;
+      case "task-failed":
+        taskResults.push({
+          task: event.task,
+          index: event.index,
+          result: mapTaskResult(buildFailedResult(params.contextId)),
+          error: event.error,
+          branch: event.branch
+        });
+        break;
+      case "task-batch-complete":
+        totalTasks = event.totalTasks;
+        completedTasks = event.completedTasks;
+        failedTasks = event.failedTasks;
+        break;
+      case "task-batch-truncated":
+        break;
+      case "flow-step-start":
+      case "flow-step-complete":
+      case "flow-terminated":
+      case "loop-iteration":
+      case "loop-paused":
+      case "loop-terminated":
+        break;
+      default:
+        assertNever(event, "runOrchestrationStream task event accumulator");
+    }
+  }
+  return {
+    kind: "batch",
+    taskResults,
+    totalTasks,
+    completedTasks,
+    failedTasks,
+    totalElapsedMs: Date.now() - startTime
+  };
+}
+async function* runFlowMode(params) {
+  if (!params.flow || !params.flowDispatcher) {
+    throw new Error(
+      "runOrchestrationStream flow mode requires `flow` and `flowDispatcher`"
+    );
+  }
+  return yield* forwardRunEvents(
+    runFlowEngineStream(
+      params.flowDispatcher,
+      params.message ?? "",
+      params.contextId,
+      params.flow,
+      params.fabric
+    ),
+    params.onEvent
+  );
+}
+async function* runOrchestrationStream(params) {
+  const mapLoopResult = params.mapLoopResult ?? identityLoopResult;
+  const mapTaskResult = params.mapTaskResult ?? mapLoopResult;
+  if (params.tasks) {
+    return yield* runTaskMode(params, mapTaskResult);
+  }
+  if (params.flow) {
+    return yield* runFlowMode(params);
+  }
+  if (params.message == null) {
+    throw new Error(params.missingInputMessage);
+  }
+  return yield* runLoopMode(params, mapLoopResult);
+}
+export {
+  drainRunStream,
+  runOrchestrationStream
+};
+//# sourceMappingURL=orchestration-stream.js.map

package/dist/runtime/orchestration/run/orchestration-stream.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/runtime/orchestration/run/orchestration-stream.ts"],
+  "sourcesContent": ["import { assertNever } from '../../../utils/assert-never.js';\nimport type { FabricAccessor } from '../../bridge/fabric-types.js';\nimport { runFlowEngineStream } from './flow-engine.js';\nimport { buildLoopResult, runLoopStream } from './loop-engine.js';\nimport { runTaskBatchStream } from './task-batch.js';\nimport { buildFailedResult } from './task-batch-graph.js';\nimport type {\n  BridgeLoopResult,\n  BridgeTaskResult,\n  FlowConfig,\n  FlowRunResult,\n  LoopConfig,\n  LoopExecutor,\n  LoopOutcomeClass,\n  RunBatchResult,\n  RunEvent,\n  StepDispatcher,\n  TaskConfig,\n  TerminationReason,\n} from './types.js';\n\nexport type OrchestrationRunResult<\n  TLoopResult extends BridgeLoopResult = BridgeLoopResult,\n> = TLoopResult | FlowRunResult | RunBatchResult<TLoopResult>;\n\nexport interface RunOrchestrationStreamParams<\n  TLoopResult extends BridgeLoopResult = BridgeLoopResult,\n> {\n  contextId: string;\n  message?: string;\n  loop?: LoopConfig;\n  flow?: FlowConfig;\n  tasks?: TaskConfig;\n  executor: LoopExecutor;\n  flowDispatcher?: StepDispatcher;\n  fabric?: FabricAccessor;\n  missingInputMessage: string;\n  mapLoopResult?: (result: BridgeLoopResult) => TLoopResult;\n  mapTaskResult?: (result: BridgeLoopResult) => TLoopResult;\n  onEvent?: (event: RunEvent) => void | Promise<void>;\n}\n\nasync function* forwardRunEvents<T>(\n  stream: AsyncGenerator<RunEvent, T, void>,\n  onEvent?: (event: RunEvent) => void | Promise<void>\n): AsyncGenerator<RunEvent, T, void> {\n  let next = await stream.next();\n  while (!next.done) {\n    await onEvent?.(next.value);\n    yield next.value;\n    next = await stream.next();\n  }\n  return next.value;\n}\n\nexport async function drainRunStream<T>(\n  stream: AsyncGenerator<RunEvent, T, void>\n): Promise<T> {\n  let next = await stream.next();\n  while (!next.done) {\n    next = await stream.next();\n  }\n  return next.value;\n}\n\nfunction identityLoopResult<TLoopResult extends BridgeLoopResult>(\n  result: BridgeLoopResult\n): TLoopResult {\n  return result as TLoopResult;\n}\n\nasync function* runLoopMode<TLoopResult extends BridgeLoopResult>(\n  params: RunOrchestrationStreamParams<TLoopResult>,\n  mapLoopResult: (result: BridgeLoopResult) => TLoopResult\n): AsyncGenerator<RunEvent, TLoopResult, void> {\n  let lastResult: BridgeTaskResult | undefined;\n  let finalReason: TerminationReason = 'cancelled';\n  let finalIterations = 0;\n  let finalElapsedMs = 0;\n  let finalCost: number | undefined;\n  let finalOutcomeClass: LoopOutcomeClass | undefined;\n  const startTime = Date.now();\n\n  const wrappedExecutor: LoopExecutor = async (\n    message,\n    contextId,\n    iteration\n  ) => {\n    const result = await params.executor(message, contextId, iteration);\n    lastResult = result;\n    return result;\n  };\n\n  for await (const event of runLoopStream(\n    wrappedExecutor,\n    params.message ?? '',\n    params.contextId,\n    params.loop ?? {}\n  )) {\n    await params.onEvent?.(event);\n    yield event;\n    if (event.kind === 'loop-terminated') {\n      finalReason = event.reason;\n      finalIterations = event.totalIterations;\n      finalElapsedMs = event.totalElapsedMs;\n      finalCost = event.totalCost;\n      finalOutcomeClass = event.outcomeClass;\n    }\n  }\n\n  return mapLoopResult(\n    buildLoopResult(\n      lastResult,\n      finalReason,\n      finalIterations,\n      finalElapsedMs || Date.now() - startTime,\n      params.contextId,\n      finalCost,\n      finalOutcomeClass\n    )\n  );\n}\n\nasync function* runTaskMode<TLoopResult extends BridgeLoopResult>(\n  params: RunOrchestrationStreamParams<TLoopResult>,\n  mapTaskResult: (result: BridgeLoopResult) => TLoopResult\n): AsyncGenerator<RunEvent, RunBatchResult<TLoopResult>, void> {\n  if (!params.tasks) {\n    throw new Error('runOrchestrationStream task mode requires `tasks`');\n  }\n\n  const startTime = Date.now();\n  const taskResults: RunBatchResult<TLoopResult>['taskResults'] = [];\n  let totalTasks = 0;\n  let completedTasks = 0;\n  let failedTasks = 0;\n\n  for await (const event of runTaskBatchStream(\n    params.executor,\n    params.tasks,\n    params.loop ?? {},\n    params.contextId\n  )) {\n    await params.onEvent?.(event);\n    yield event;\n    switch (event.kind) {\n      case 'task-start':\n        break;\n      case 'task-complete':\n        taskResults.push({\n          task: event.task,\n          index: event.index,\n          result: mapTaskResult(event.result as BridgeLoopResult),\n          branch: event.branch,\n        });\n        break;\n      case 'task-failed':\n        taskResults.push({\n          task: event.task,\n          index: event.index,\n          result: mapTaskResult(buildFailedResult(params.contextId)),\n          error: event.error,\n          branch: event.branch,\n        });\n        break;\n      case 'task-batch-complete':\n        totalTasks = event.totalTasks;\n        completedTasks = event.completedTasks;\n        failedTasks = event.failedTasks;\n        break;\n      case 'task-batch-truncated':\n        break;\n      case 'flow-step-start':\n      case 'flow-step-complete':\n      case 'flow-terminated':\n      case 'loop-iteration':\n      case 'loop-paused':\n      case 'loop-terminated':\n        break;\n      default:\n        assertNever(event, 'runOrchestrationStream task event accumulator');\n    }\n  }\n\n  return {\n    kind: 'batch',\n    taskResults,\n    totalTasks,\n    completedTasks,\n    failedTasks,\n    totalElapsedMs: Date.now() - startTime,\n  };\n}\n\nasync function* runFlowMode<TLoopResult extends BridgeLoopResult>(\n  params: RunOrchestrationStreamParams<TLoopResult>\n): AsyncGenerator<RunEvent, FlowRunResult, void> {\n  if (!params.flow || !params.flowDispatcher) {\n    throw new Error(\n      'runOrchestrationStream flow mode requires `flow` and `flowDispatcher`'\n    );\n  }\n  return yield* forwardRunEvents(\n    runFlowEngineStream(\n      params.flowDispatcher,\n      params.message ?? '',\n      params.contextId,\n      params.flow,\n      params.fabric\n    ),\n    params.onEvent\n  );\n}\n\nexport async function* runOrchestrationStream<\n  TLoopResult extends BridgeLoopResult = BridgeLoopResult,\n>(\n  params: RunOrchestrationStreamParams<TLoopResult>\n): AsyncGenerator<RunEvent, OrchestrationRunResult<TLoopResult>, void> {\n  const mapLoopResult = params.mapLoopResult ?? identityLoopResult<TLoopResult>;\n  const mapTaskResult = params.mapTaskResult ?? mapLoopResult;\n\n  if (params.tasks) {\n    return yield* runTaskMode(params, mapTaskResult);\n  }\n\n  if (params.flow) {\n    return yield* runFlowMode(params);\n  }\n\n  if (params.message == null) {\n    throw new Error(params.missingInputMessage);\n  }\n\n  return yield* runLoopMode(params, mapLoopResult);\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/runtime/orchestration/run/resolve-loop-config.d.ts

@@ -0,0 +1,11 @@
+import type { LoopConfig } from './types.js';
+/**
+ * Derives the effective LoopConfig for a run call.
+ *
+ * `run()` is documented as "one-shot (single turn)". When neither the
+ * bridge/pack-level default loop nor the call-level params.loop is supplied,
+ * maxIterations defaults to 1 so the executor fires exactly once.
+ * Multi-turn looping requires an explicit `loop: { ... }` option.
+ */
+export declare function resolveLoopConfig(defaultLoop: LoopConfig | undefined, paramsLoop: LoopConfig | undefined): LoopConfig;
+//# sourceMappingURL=resolve-loop-config.d.ts.map

package/dist/runtime/orchestration/run/resolve-loop-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-loop-config.d.ts","sourceRoot":"","sources":["../../../../src/runtime/orchestration/run/resolve-loop-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,UAAU,GAAG,SAAS,EACnC,UAAU,EAAE,UAAU,GAAG,SAAS,GACjC,UAAU,CAOZ"}

package/dist/runtime/orchestration/run/resolve-loop-config.js

@@ -0,0 +1,12 @@
+function resolveLoopConfig(defaultLoop, paramsLoop) {
+  const hasExplicitLoop = defaultLoop != null || paramsLoop != null;
+  return {
+    ...hasExplicitLoop ? {} : { maxIterations: 1 },
+    ...defaultLoop,
+    ...paramsLoop
+  };
+}
+export {
+  resolveLoopConfig
+};
+//# sourceMappingURL=resolve-loop-config.js.map

package/dist/runtime/orchestration/run/resolve-loop-config.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/runtime/orchestration/run/resolve-loop-config.ts"],
+  "sourcesContent": ["import type { LoopConfig } from './types.js';\n\n/**\n * Derives the effective LoopConfig for a run call.\n *\n * `run()` is documented as \"one-shot (single turn)\". When neither the\n * bridge/pack-level default loop nor the call-level params.loop is supplied,\n * maxIterations defaults to 1 so the executor fires exactly once.\n * Multi-turn looping requires an explicit `loop: { ... }` option.\n */\nexport function resolveLoopConfig(\n  defaultLoop: LoopConfig | undefined,\n  paramsLoop: LoopConfig | undefined\n): LoopConfig {\n  const hasExplicitLoop = defaultLoop != null || paramsLoop != null;\n  return {\n    ...(hasExplicitLoop ? {} : { maxIterations: 1 }),\n    ...defaultLoop,\n    ...paramsLoop,\n  };\n}\n"],
+  "mappings": "AAUO,SAAS,kBACd,aACA,YACY;AACZ,QAAM,kBAAkB,eAAe,QAAQ,cAAc;AAC7D,SAAO;AAAA,IACL,GAAI,kBAAkB,CAAC,IAAI,EAAE,eAAe,EAAE;AAAA,IAC9C,GAAG;AAAA,IACH,GAAG;AAAA,EACL;AACF;",
+  "names": []
+}

package/dist/runtime/orchestration/run/task-batch-graph.d.ts

@@ -0,0 +1,10 @@
+import type { BridgeLoopResult, IsolationStrategy, TaskConfig, TaskItem } from './types.js';
+export declare function validateDependencies(items: TaskItem[]): void;
+export declare function topologicalSort(items: TaskItem[]): TaskItem[];
+export declare function resolveIsolationStrategy(config: TaskConfig): IsolationStrategy;
+export declare function buildFailedResult(contextId: string): BridgeLoopResult;
+export declare function buildWaves(items: TaskItem[]): Array<Array<{
+    task: TaskItem;
+    originalIndex: number;
+}>>;
+//# sourceMappingURL=task-batch-graph.d.ts.map

package/dist/runtime/orchestration/run/task-batch-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-batch-graph.d.ts","sourceRoot":"","sources":["../../../../src/runtime/orchestration/run/task-batch-graph.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,EACV,QAAQ,EACT,MAAM,YAAY,CAAC;AAEpB,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI,CA4B5D;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,QAAQ,EAAE,CAgC7D;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,UAAU,GACjB,iBAAiB,CAQnB;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,CAgBrE;AAED,wBAAgB,UAAU,CACxB,KAAK,EAAE,QAAQ,EAAE,GAChB,KAAK,CAAC,KAAK,CAAC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAoBzD"}