@agentskit/harness 0.6.0 → 0.8.0

package/docs/LOOP.md

@@ -84,6 +84,25 @@ Optional SessionStart hook for Claude Code (`.claude/settings.json` of the targe
 
 It prints `loop: installed (2/2, last run …)` or the install command; it never installs or changes anything.
 
+## Worker handoff
+
+When a worker goes idle past `delivery.workerIdleTimeoutMin` (or its terminal disappears) **and** its provider is unavailable (exhausted usage, cooldown, missing binary), deliver does **not** immediately mark the issue stuck. Instead it:
+
+1. Picks the next available builder via the current routing mode (catalog/hybrid/…)
+2. Opens a **new terminal in the same worktree** (same Orca branch)
+3. Sends a continuation brief (`renderHandoffBrief`) — resume from `git status` / existing commits; do not recreate the branch
+4. Updates `dispatch.json` (`terminal`, `provider`, `model`) and appends `delivery.handoffs[]`
+
+Config (`delivery.handoff`, enabled by default):
+
+```yaml
+delivery:
+  handoff:
+    enabled: true
+    maxHandoffs: 2
+    onlyWhenProviderUnavailable: true
+```
+
 ## Deliver
 
 For every issue the loop dispatched (`<stateDir>/issues/<id>/dispatch.json`) and has not finished:
@@ -139,6 +158,20 @@ Start from [`loop.config.example.yaml`](../loop.config.example.yaml) at the pack
 | `machine.slots` | `sampleMachine` + `adaptiveConcurrency`, free RAM reserve, WSL cap, running worktrees | no — 0 free slots is a warning, not a failure |
 | `linear.queue` | `orca linear list-issues` per configured state, filtered and ordered locally | yes — an unreachable Linear blocks |
 
+
+## Dynamic model routing
+
+`models.routing.mode` controls how the loop picks `provider/model` for each role:
+
+| Mode | Behaviour |
+|---|---|
+| `tiers` (default) | YAML declaration order; usage only as available/unavailable (0.6 behaviour). |
+| `hybrid` | Keep tier bands (quality policy); **inside a tier** pick the provider with the most remaining Orca usage. |
+| `dynamic` | Flatten all YAML candidates; rank by remaining usage (YAML order is a soft tie-break). |
+| `catalog` | Discover models from CLI lists (`grok models`), builtin catalog, and optional [Artificial Analysis](https://artificialanalysis.ai/) (cached under `stateDir/catalog/`), then rank by usage + quality band (`models.roles.*.quality`). |
+
+Providers still need a `models.providers.<id>` block (`bin` / `tui` / `headless`) — Orca cannot invent argv. The doctor warns when Orca shows an integration that is not declared.
+
 ## Model routing
 
 `models.<role>` is a list of tiers; each tier is a list of `provider/model`. Tiers are tried in order and, inside a

package/loop.config.example.yaml

@@ -37,6 +37,15 @@ linear:
   needsInfoLabel: needs-info
 
 models:
+  # routing.mode: tiers (default) | hybrid | dynamic | catalog
+  # hybrid = keep quality tiers, pick highest remaining usage inside each tier
+  # catalog = discover models via CLI/builtin/(optional) Artificial Analysis + usage
+  routing:
+    mode: hybrid
+    usageMetric: max
+    preferKnownUsage: true
+  # roles: { orchestrator: { quality: frontier }, builder: { quality: balanced }, watcher: { quality: fast } }
+  # catalog: { sources: [cli, builtin], artificialAnalysis: { enabled: false } }
   # Tiers, in order. Inside a tier the first provider with usage available wins.
   # Tier 1 = subscriptions, tier 2 = cheap hosted, tier 3 = last resort.
   orchestrator: [[codex/gpt-5.6-sol, claude/opus], [opencode/opencode-go/glm-5.3], [grok/grok-4-fast]]
@@ -103,6 +112,7 @@ delivery:
     requireChecks: true
   maxFixRounds: 2
   workerIdleTimeoutMin: 45
+  handoff: { enabled: true, maxHandoffs: 2, onlyWhenProviderUnavailable: true }
   selfEditPaths: [loop.config.yaml, ".github/**"]   # PRs touching these never auto-merge
   ignoreChecks: []                   # advisory check names that never block
   requiredChecks: []                 # empty = every reported check must be green

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentskit/harness",
-  "version": "0.6.0",
+  "version": "0.8.0",
   "description": "Portable, evidence-backed development harness for coding agents.",
   "type": "module",
   "bin": {

package/release/manifest.json

@@ -2,7 +2,7 @@
   "type": "agentskit-harness-release-manifest",
   "schemaVersion": 1,
   "package": "@agentskit/harness",
-  "version": "0.6.0",
+  "version": "0.8.0",
   "channel": "latest",
   "sourceRevision": "b8cfe596e5f30f2c373b89f00f271079b296feaf",
   "requiredChecks": [

package/release/notes.md

@@ -1,3 +1,11 @@
+# 0.8.0 release candidate
+
+Worker handoff: continue in-flight tickets on the same Orca worktree/branch with another provider when usage runs out.
+
+# 0.7.0 release candidate
+
+Dynamic Orca-aware model routing (hybrid/dynamic/catalog) with remaining-usage ranking and a living model catalog (CLI + builtin + optional Artificial Analysis).
+
 # 0.6.0 release candidate
 
 Keep-pushing loop gains approved memory (token reduction + continuous improvement), Doc Bridge freshness/review doctor probes, brief guidance scopes, optional deliver smoke, agent registry YAML, RAG context provider, MCP adapter seam (ADR-0028), Docker verify config, and weekly Linear retro automation. Config defaults preserve 0.5.0 behaviour.