@agentskit/harness 0.6.0 → 0.7.0

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.7.0] - 2026-09-12
+
+- Dynamic model routing: `models.routing.mode` (`tiers` | `hybrid` | `dynamic` | `catalog`). Default `tiers` preserves 0.6 behaviour.
+- `hybrid`/`dynamic` rank available providers by **remaining Orca usage** (most-constrained window) so work follows quota instead of fixed YAML order.
+- Living model catalog (`catalog` mode): CLI discovery (`grok models`), builtin catalog, optional Artificial Analysis cache (`ARTIFICIAL_ANALYSIS_API_KEY`), role quality bands (`frontier`/`balanced`/`fast`).
+- Doctor reports remaining usage, why a model was chosen, and Orca integrations missing from `models.providers`.
+
 ## [0.6.0] - 2026-09-12
 
 - Loop **approved memory** for token reduction and continuous improvement: file store under `stateDir`, recall into contract/brief with `preferOverDocBridge` + issue-char shrink, human-only `ak-harness loop learning promote`, `memory.recalled` events.

package/capabilities/public-surface.json

@@ -2,13 +2,13 @@
   "type": "agentskit-harness-capability-manifest",
   "schemaVersion": 1,
   "package": "@agentskit/harness",
-  "packageVersion": "0.6.0",
+  "packageVersion": "0.7.0",
   "entryPoint": "src/index.ts",
-  "sourceDigest": "0c2f78dcedb17c5e4ea44206bee3a87cf370b94ab9f063cc780227897f3fad75",
+  "sourceDigest": "adc841b448dab0da269f1f61842bf723eae2d017cd05ed68c19c62732b63e28a",
   "capabilities": [
     {
       "id": "public-surface:adapters/agent",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "adapter",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -22,7 +22,7 @@
     },
     {
       "id": "public-surface:adapters/code-review",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "adapter",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -41,7 +41,7 @@
     },
     {
       "id": "public-surface:adapters/command",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "adapter",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -54,7 +54,7 @@
     },
     {
       "id": "public-surface:adapters/doc-bridge",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "adapter",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -65,7 +65,7 @@
     },
     {
       "id": "public-surface:adapters/github-cli",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "adapter",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -90,7 +90,7 @@
     },
     {
       "id": "public-surface:adapters/linear-orca",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "adapter",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -121,7 +121,7 @@
     },
     {
       "id": "public-surface:adapters/mcp",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "adapter",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -136,7 +136,7 @@
     },
     {
       "id": "public-surface:adapters/orca-cli",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "adapter",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -183,7 +183,7 @@
     },
     {
       "id": "public-surface:adapters/orca",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "adapter",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -198,7 +198,7 @@
     },
     {
       "id": "public-surface:adapters/providers",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "adapter",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -207,17 +207,21 @@
         "ProviderAvailability",
         "ProviderSpec",
         "ProviderUsage",
+        "UsageMetric",
         "UsageWindow",
         "authStatusFor",
         "cooldownUntil",
         "detectProviders",
         "parseProviderUsage",
-        "parseUsageWindows"
+        "parseUsageWindows",
+        "remainingUsagePercent",
+        "undeclaredOrcaProviders",
+        "usageRankTuple"
       ]
     },
     {
       "id": "public-surface:adapters/rag-context",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "adapter",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -231,7 +235,7 @@
     },
     {
       "id": "public-surface:adapters/tracking",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "adapter",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -243,7 +247,7 @@
     },
     {
       "id": "public-surface:context/index",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "kernel",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -258,7 +262,7 @@
     },
     {
       "id": "public-surface:delivery/index",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "kernel",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -285,7 +289,7 @@
     },
     {
       "id": "public-surface:execution/agent",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "execution",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -295,7 +299,7 @@
     },
     {
       "id": "public-surface:execution/bundle",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "execution",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -308,7 +312,7 @@
     },
     {
       "id": "public-surface:execution/config",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "execution",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -318,7 +322,7 @@
     },
     {
       "id": "public-surface:execution/coordination",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "execution",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -332,7 +336,7 @@
     },
     {
       "id": "public-surface:execution/files",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "execution",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -341,7 +345,7 @@
     },
     {
       "id": "public-surface:execution/machine",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "execution",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -355,7 +359,7 @@
     },
     {
       "id": "public-surface:execution/metrics",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "execution",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -369,7 +373,7 @@
     },
     {
       "id": "public-surface:execution/runtime",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "execution",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -382,7 +386,7 @@
     },
     {
       "id": "public-surface:execution/verification",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "execution",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -399,7 +403,7 @@
     },
     {
       "id": "public-surface:kernel/adapter-contract",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "kernel",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -413,7 +417,7 @@
     },
     {
       "id": "public-surface:kernel/artifacts",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "kernel",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -438,7 +442,7 @@
     },
     {
       "id": "public-surface:kernel/block",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "kernel",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -452,7 +456,7 @@
     },
     {
       "id": "public-surface:kernel/cache",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "kernel",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -466,7 +470,7 @@
     },
     {
       "id": "public-surface:kernel/capabilities",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "kernel",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -483,7 +487,7 @@
     },
     {
       "id": "public-surface:kernel/compatibility",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "kernel",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -502,7 +506,7 @@
     },
     {
       "id": "public-surface:kernel/constants",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "kernel",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -512,7 +516,7 @@
     },
     {
       "id": "public-surface:kernel/cycle",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "kernel",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -523,7 +527,7 @@
     },
     {
       "id": "public-surface:kernel/discovery",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "kernel",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -534,7 +538,7 @@
     },
     {
       "id": "public-surface:kernel/error-policy",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "kernel",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -547,7 +551,7 @@
     },
     {
       "id": "public-surface:kernel/errors",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "kernel",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -557,7 +561,7 @@
     },
     {
       "id": "public-surface:kernel/eval",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "kernel",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -585,7 +589,7 @@
     },
     {
       "id": "public-surface:kernel/events",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "kernel",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -606,7 +610,7 @@
     },
     {
       "id": "public-surface:kernel/experiment",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "kernel",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -616,7 +620,7 @@
     },
     {
       "id": "public-surface:kernel/learning",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "kernel",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -629,7 +633,7 @@
     },
     {
       "id": "public-surface:kernel/memory",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "kernel",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -646,7 +650,7 @@
     },
     {
       "id": "public-surface:kernel/model-policy",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "kernel",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -660,7 +664,7 @@
     },
     {
       "id": "public-surface:kernel/optimization",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "kernel",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -676,7 +680,7 @@
     },
     {
       "id": "public-surface:kernel/phase-executor",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "kernel",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -714,7 +718,7 @@
     },
     {
       "id": "public-surface:kernel/pilot",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "kernel",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -724,7 +728,7 @@
     },
     {
       "id": "public-surface:kernel/plugins",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "kernel",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -736,7 +740,7 @@
     },
     {
       "id": "public-surface:kernel/policy",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "kernel",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -746,7 +750,7 @@
     },
     {
       "id": "public-surface:kernel/preflight",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "kernel",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -758,7 +762,7 @@
     },
     {
       "id": "public-surface:kernel/quality",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "kernel",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -780,7 +784,7 @@
     },
     {
       "id": "public-surface:kernel/resilience",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "kernel",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -796,7 +800,7 @@
     },
     {
       "id": "public-surface:kernel/state-machine",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "kernel",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -807,7 +811,7 @@
     },
     {
       "id": "public-surface:kernel/status",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "kernel",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -819,7 +823,7 @@
     },
     {
       "id": "public-surface:kernel/types",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "kernel",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -828,7 +832,7 @@
     },
     {
       "id": "public-surface:kernel/wip",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "kernel",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -839,7 +843,7 @@
     },
     {
       "id": "public-surface:kernel/workflow",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "kernel",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -850,7 +854,7 @@
     },
     {
       "id": "public-surface:loop/agent-registry",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "composition",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -867,7 +871,7 @@
     },
     {
       "id": "public-surface:loop/brief",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "composition",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -877,7 +881,7 @@
     },
     {
       "id": "public-surface:loop/config",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "composition",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -903,7 +907,7 @@
     },
     {
       "id": "public-surface:loop/contract",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "composition",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -932,7 +936,7 @@
     },
     {
       "id": "public-surface:loop/cooldown",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "composition",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -947,7 +951,7 @@
     },
     {
       "id": "public-surface:loop/debrief",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "composition",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -960,7 +964,7 @@
     },
     {
       "id": "public-surface:loop/deliver",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "composition",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -978,7 +982,7 @@
     },
     {
       "id": "public-surface:loop/doctor",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "composition",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -993,7 +997,7 @@
     },
     {
       "id": "public-surface:loop/guided-install",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "composition",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -1006,7 +1010,7 @@
     },
     {
       "id": "public-surface:loop/install",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "composition",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -1030,7 +1034,7 @@
     },
     {
       "id": "public-surface:loop/local-config",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "composition",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -1048,7 +1052,7 @@
     },
     {
       "id": "public-surface:loop/memory",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "composition",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -1070,9 +1074,31 @@
         "writeLearningsLedger"
       ]
     },
+    {
+      "id": "public-surface:loop/model-catalog/index",
+      "version": "0.7.0",
+      "kind": "composition",
+      "entryPoint": "src/index.ts",
+      "exports": [
+        "ArtificialAnalysisModel",
+        "CatalogModel",
+        "ModelQuality",
+        "ProviderCatalog",
+        "fetchArtificialAnalysisModels",
+        "listCliModels",
+        "loadAliases",
+        "loadBuiltinCatalog",
+        "parseArtificialAnalysisPayload",
+        "parseGrokModelsOutput",
+        "readAaCache",
+        "resolveAlias",
+        "resolveCatalogCandidates",
+        "writeAaCache"
+      ]
+    },
     {
       "id": "public-surface:loop/process",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "composition",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -1081,7 +1107,7 @@
     },
     {
       "id": "public-surface:loop/retro",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "composition",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -1106,7 +1132,7 @@
     },
     {
       "id": "public-surface:loop/routing",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "composition",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -1120,7 +1146,7 @@
     },
     {
       "id": "public-surface:loop/slots",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "composition",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -1135,7 +1161,7 @@
     },
     {
       "id": "public-surface:loop/tick",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "composition",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -1159,7 +1185,7 @@
     },
     {
       "id": "public-surface:loop/ui/terminal",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "composition",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -1169,7 +1195,7 @@
     },
     {
       "id": "public-surface:loop/watch",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "kind": "composition",
       "entryPoint": "src/index.ts",
       "exports": [
@@ -1186,5 +1212,5 @@
       ]
     }
   ],
-  "digest": "9fe2e47222eccc6a31ffdd562631eef2bb9b125ced5b8ec99327610e366e32cf"
+  "digest": "61306b6e1d65e137568cd057af3ce9391772e72723eded38d07ebb293b1625ca"
 }