Guides

API healing agents

Detect contract breaks — schema drift, consumer breakage, stale fixtures, bad canaries — and safely remediate with adapters, fixture refresh, and canary rollback. Flagship product wedge on Inferix (agent_id: apiheal).

Scenario

Producer renames a field overnight. Consumers 4xx. OpenAPI goes red. Golden fixtures rot. Canaries burn error budget before humans notice. Manual Pact and gateway canaries each cover a slice — Inferix closes detect → classify → patch → validate → promote.

What Inferix gives you

RouteIQ: owned/slm-apiheal cheap classify; hard path for heal proposals (capability matrix denies heal tools on classify-only SLM)
TraceForge: OpenAPI diff → adapter → contract test → canary spans
DriftWatch: schema drift (D03), format drift, authz drift
FineForge: adapter patches, fixture updates, canary promote/rollback
LensAI: cost and latency of classify vs hard heal path

Owned model roles

Piece	Role
owned/slm-apiheal (slm-apiheal-v*)	Cheap classifier / route assist — severity, diff narrate, fixture hints
Provider hard path	Hard diffs, heal proposals, HITL rationales
FineForge	Version adapters + fixtures; gate on contract tests + error budget

Setup

routing:
  rules:
    - name: apiheal-classify
      when: { agent: apiheal, intent: [severity_classify, fixture_hint] }
      model: owned/slm-apiheal
      capabilities: { tools: deny }   # classify only
    - name: apiheal-remediate
      when: { agent: apiheal, intent: [adapter_patch, canary_rollback] }
      model: provider/strong
      capabilities: { tools: allow }

drift:
  golden_set: /var/lib/inferix/golden/apiheal.jsonl
  slices: [breaking_vs_additive, consumer]

# Error budget burn gates auto-promote (FineForge F14)
# Emit deploy markers on adapter_version + openapi_hash

Models: Owned models. Loop: Drift & retrain.

Watch

Tool 4xx schema rate (T03) and contract test CI
Canary error-budget burn before full promote
Route mix: classify on SLM vs hard path share
DriftWatch slice: breaking vs additive OpenAPI diffs

Failure modes

Safe remediation only

Never auto-promote breaking producer changes without HITL
Adapter patch restores consumers — prefer over silent producer revert
Shadow tools must not hit prod systems (T21)
D19 — do not ship OpenAPI + adapter + route in one unbundled change

Checkpoint, resume, memory poison drift.

Durable agents →