@robmclarty/volley 0.5.1 → 0.5.3

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { UsageTotals, FinishReason, StreamChunk, Engine } from 'fascicle';
+import { UsageTotals, FinishReason, Throughput, StreamChunk, Engine } from 'fascicle';
 import { z } from 'zod';
 
 /**
@@ -176,6 +176,12 @@ type PhaseRecord = {
     provider: string;
     model: string;
     session_id: string | null;
+    /** Wall-clock of the phase's model work, the same measure for every provider
+     * so an all-local run and an all-Claude run compare directly. The builder's is
+     * fascicle's `GenerateResult.timing`: the whole call, every turn and the tools
+     * between them. The critic's spans its whole degradation ladder, failed
+     * attempts included, since no one result's timing covers the attempts before
+     * it. Neither counts the Ollama prewarm. */
     duration_ms: number;
     usage: UsageTotals;
     cost_usd: number | null;
@@ -205,6 +211,13 @@ type PhaseRecord = {
      * critique and on the builder. Additive, and a degraded verdict is *always*
      * marked so it never passes silently as a full one. */
     critic_degraded?: boolean;
+    /** Output tokens per second over the model's own turns (tool execution and
+     * retry backoff excluded), from fascicle's per-step timing. `basis` is
+     * `decode` when every turn streamed, `blended` when any round trip counted
+     * prefill and network too — always the case for `claude_cli`, whose rate
+     * fascicle derives from the CLI's reported API time. Absent when no turn
+     * carried timing. Additive. */
+    throughput?: Throughput;
 };
 type HaltReason = 'cost_cap' | 'gate_edit' | null;
 /** Carry-state threaded through the fascicle loop. */
@@ -297,6 +310,14 @@ type Renderer = {
 };
 declare function create_renderer(options: RendererOptions): Renderer;
 
+type OrchestratorDeps = {
+    renderer: Renderer;
+    engine?: Engine;
+    abort?: AbortSignal;
+    install_signal_handlers?: boolean;
+};
+declare function run_volley(config: ResolvedConfig, deps: OrchestratorDeps, resume_from?: LoopState | null): Promise<RunResult>;
+
 declare function initial_state(): LoopState;
 /** All stopping conditions live here: acceptance, cost cap, the gate
  * edit refusal, and — implicitly via `max_rounds` — the iteration budget.
@@ -311,18 +332,11 @@ declare function gate(config: ResolvedConfig, state: LoopState): {
     state: LoopState;
 };
 declare function status_of(value: LoopState, converged: boolean): RunStatus;
-type OrchestratorDeps = {
-    renderer: Renderer;
-    engine?: Engine;
-    abort?: AbortSignal;
-    install_signal_handlers?: boolean;
-};
-declare function run_volley(config: ResolvedConfig, deps: OrchestratorDeps, resume_from?: LoopState | null): Promise<RunResult>;
 
 /**
- * Critic invocation: a read-only `claude_cli` session returning a
- * schema-validated structured verdict. The harness — not the critic — writes
- * `.volley/feedback.md` and `.volley/verdict`.
+ * Critic invocation: a read-only session (`claude_cli`, or a local model with
+ * volley's read tools) returning a schema-validated structured verdict. The
+ * harness — not the critic — writes `.volley/feedback.md` and `.volley/verdict`.
  */
 
 declare const verdict_schema: z.ZodObject<{