@deepstrike/core 0.2.6 → 0.2.7

package/index.d.ts

@@ -231,6 +231,50 @@ export interface EvalPipelineAction {
   details?: Array<CriterionResult>
   skillCandidate?: SkillCandidate
 }
+/** One pairwise match-up in a round. */
+export interface TournamentMatch {
+  /** Index of this match within its round (0-based). */
+  id: number
+  left: string
+  right: string
+}
+/**
+ * Discriminated union returned by `Tournament` methods. Inspect `kind`:
+ * - `"judgeRound"` → `round`, `matches` (run one fresh-context judge per match, in
+ *   parallel, then call `feedRound` with the winners)
+ * - `"done"`       → `winner`, `roundsUsed`
+ */
+export interface TournamentAction {
+  kind: string
+  round?: number
+  matches?: Array<TournamentMatch>
+  winner?: string
+  roundsUsed?: number
+}
+/**
+ * A single stop predicate. `kind` is one of `"noNewFindings"`, `"noErrors"`, `"maxRounds"`;
+ * `maxRounds` is required only when `kind === "maxRounds"`.
+ */
+export interface StopConditionSpec {
+  kind: string
+  maxRounds?: number
+}
+/** What the SDK reports after running a round's worker. */
+export interface RoundReport {
+  newFindings: number
+  errors: number
+}
+/**
+ * Discriminated union returned by `LoopUntilDone` methods. Inspect `kind`:
+ * - `"spawn"` → `round` (spawn that round's worker, then call `feed` with its report)
+ * - `"done"`  → `roundsUsed`, `reason` (`"noNewFindings"` | `"noErrors"` | `"maxRounds"`)
+ */
+export interface LoopAction {
+  kind: string
+  round?: number
+  roundsUsed?: number
+  reason?: string
+}
 /**
  * Versioned kernel ABI runtime. Accepts/returns JSON encoded
  * `KernelInput`/`KernelStep` payloads from deepstrike-core.
@@ -330,3 +374,41 @@ export declare class IdlePipeline {
   /** Reset to `Idle` after handling `CommitMemories` to allow the next cycle. */
   reset(): void
 }
+/**
+ * Single-elimination tournament control state machine.
+ *
+ * Drive it like this:
+ * 1. `new(entrants)` (throws if empty)
+ * 2. `start()` → `"judgeRound"` (or `"done"` for a single entrant)
+ * 3. Run one fresh-context pairwise judge per `action.matches`, collect the winner of each
+ * 4. `feedRound(winners)` → next `"judgeRound"` or `"done"`
+ */
+export declare class Tournament {
+  constructor(entrants: Array<string>)
+  /** Begin the tournament — emits the first round (or `"done"` for a single entrant). */
+  start(): TournamentAction
+  /**
+   * Report the winners of the round last emitted by `"judgeRound"`. `winners` must align
+   * one-to-one with that round's `matches`; each must be a participant in its match.
+   */
+  feedRound(winners: Array<string>): TournamentAction
+  isDone(): boolean
+}
+/**
+ * Loop-until-done control state machine.
+ *
+ * Construct with an ordered list of stop conditions (first match wins). A `maxRounds`
+ * backstop is injected automatically if you provide none, so the loop always terminates.
+ *
+ * 1. `new(conditions)`
+ * 2. `start()` → `"spawn"` (round 1)
+ * 3. Run the round's worker, then `feed({ newFindings, errors })` → next `"spawn"` or `"done"`
+ */
+export declare class LoopUntilDone {
+  constructor(conditions: Array<StopConditionSpec>)
+  /** Begin the loop — always emits `"spawn"` for round 1. */
+  start(): LoopAction
+  /** Feed the just-completed round's report and get the next action. */
+  feed(report: RoundReport): LoopAction
+  isDone(): boolean
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deepstrike/core",
-  "version": "0.2.6",
+  "version": "0.2.7",
   "description": "DeepStrike kernel — pre-built native addon",
   "main": "index.js",
   "types": "index.d.ts",
@@ -23,12 +23,12 @@
     ]
   },
   "optionalDependencies": {
-    "@deepstrike/core-darwin-arm64": "0.2.6",
-    "@deepstrike/core-darwin-x64": "0.2.6",
-    "@deepstrike/core-linux-arm64-gnu": "0.2.6",
-    "@deepstrike/core-linux-arm64-musl": "0.2.6",
-    "@deepstrike/core-linux-x64-gnu": "0.2.6",
-    "@deepstrike/core-linux-x64-musl": "0.2.6",
-    "@deepstrike/core-win32-x64-msvc": "0.2.6"
+    "@deepstrike/core-darwin-arm64": "0.2.7",
+    "@deepstrike/core-darwin-x64": "0.2.7",
+    "@deepstrike/core-linux-arm64-gnu": "0.2.7",
+    "@deepstrike/core-linux-arm64-musl": "0.2.7",
+    "@deepstrike/core-linux-x64-gnu": "0.2.7",
+    "@deepstrike/core-linux-x64-musl": "0.2.7",
+    "@deepstrike/core-win32-x64-msvc": "0.2.7"
   }
 }