@foldrun/core 0.3.0 → 0.4.0

package/dist/src/runner.d.ts

@@ -1,4 +1,4 @@
-import { type FlowStep, type RunRecord } from "./store.ts";
+import { type FlowStep, type RunRecord, type StepRecord } from "./store.ts";
 /** How much of the earlier groups' output a step is handed, in characters.
  *  Newest groups are kept when the total is over it. */
 export declare const CONTEXT_CHARS = 30000;
@@ -12,6 +12,17 @@ export declare const DESK_RUNS_CAP = 100;
  * step is most likely to be about.
  */
 export declare function joinEarlierGroups(groupResults: (string | null)[], gi: number, cap?: number): string | null;
+/**
+ * `parallel: N` — a pool of N slots the instances of one fan-out share.
+ * Fan-out always ran every instance at once, and still does unless the
+ * step says otherwise: twenty browser steps against one site, or one
+ * vendor's rate limit, is what the cap is for. Nothing is rented while an
+ * instance waits for a slot.
+ */
+export declare function slotPool(size: number): {
+    acquire: () => Promise<void>;
+    release: () => void;
+};
 export interface DiscoveredSkill {
     name: string;
     description: string;
@@ -102,6 +113,20 @@ export declare function applicableSkills<T extends {
  */
 export declare function saysUntilMarker(result: string | null, until: string): boolean;
 export declare function resolveDocLinks(text: string, workspaceRoot: string): string;
+/**
+ * Write one attempt onto the step's history and re-total the step.
+ *
+ * runStep reports the attempt it just ran — its cost, tokens and sandbox
+ * seconds — by assigning the step's fields. Those become this attempt's row;
+ * the step's fields then become the sum of every row, which is what the
+ * run's spend, the flow's budget: and the platform's bill read. A retried
+ * step used to carry only its last attempt's cost, so a `retry: 2` step
+ * could spend three shares while reporting one.
+ */
+export declare function recordAttempt(step: StepRecord, n: number, status: "completed" | "failed", startedAt: string, eventsBefore: number, 
+/** The attempt re-attached to a sandbox a previous driver left: same
+ *  attempt, so its row is replaced rather than repeated. */
+reattach?: boolean): void;
 /**
  * Copy a directory tree by reading and writing the bytes.
  *
@@ -132,8 +157,19 @@ export declare const OVERLOAD_RETRIES = 3;
  */
 export declare function isTransientOverload(text: string): boolean;
 export declare function backoffMs(attempt: number, text?: string, random?: () => number): number;
-export declare function createFlowRun(tenant: string, workspace: string, steps: FlowStep[], flowName: string, status: "queued" | "running", tags?: string[]): RunRecord;
-export declare function startFlowRun(tenant: string, workspace: string, steps: FlowStep[], flowName: string, modelOverride?: string | null, tags?: string[], effortOverride?: string | null): RunRecord;
+/**
+ * `schema: <path>` — the file, read and parsed, or null. Agent-relative like
+ * every other path in a flow (`../../schemas/lead.json`), confined to the
+ * workspace: a schema is the author's document, never something a step
+ * can point outside.
+ */
+export declare function readSchemaFile(workspaceRoot: string, rel: string): Record<string, unknown> | boolean | null;
+export declare function createFlowRun(tenant: string, workspace: string, steps: FlowStep[], flowName: string, status: "queued" | "running", tags?: string[], startedBy?: string | null, opts?: {
+    test?: boolean;
+}): RunRecord;
+export declare function startFlowRun(tenant: string, workspace: string, steps: FlowStep[], flowName: string, modelOverride?: string | null, tags?: string[], effortOverride?: string | null, startedBy?: string | null, opts?: {
+    test?: boolean;
+}): RunRecord;
 /**
  * Drive a run to completion: groups in order, approval gates, retries.
  *