Agent Provider Catalog
@mgreten/agent-provider-catalogv2026.07.31.1
01README
A pure, deterministic provider/model catalog with tiered fallback and dispatch resolution for agent-dispatch pipelines: a caller-supplied, versioned table maps abstract roles to ordered CLI-agent provider/model tiers, and only throttling signals advance a fallback tier.
02Models
@mgreten/agent-provider-catalogv2026.07.31.1agent_provider_catalog.ts
fn recordProviderFallback()
Decide and persist a tiered-provider-fallback decision for a role's agent-invocation signal. Only rate/session-limit signals advance a tier; contract/test/decline/infra signals are a no-op; exhausted tiers or the attempt bound park with the recorded chain. Fail-closed on an unknown role or signal class (writes no resource). Idempotent per (workItem, role, attempt). Does NOT re-dispatch the stage
fn resolveAgentDispatch()
Resolve and persist the effective {provider, model, tier} an agent
Resources
providerFallbackDecision(infinite)— An advisory tiered-provider-fallback decision: for a role's agent-invocation signal it records advance/no-fallback/park, the from (and, when advancing, to) provider/model tier, the full reason chain, the attempt bound, and the catalog/policy versions; keyed by (workItem, role, attempt) and idempotent per that key. Does NOT re-dispatch any stage
agentDispatch(infinite)— The effective agent dispatch a preflight step resolved for one (workItem, role, attempt): the {provider, model, tier} the role's agent step binds this attempt, the per-role instance recorded UNTOUCHED (so a fallback can never collapse distinct-instance roles onto fewer instances), the disposition (initial/advance/no-fallback/park) and, on a fallback, the fallbackRef into the recorded chain. Keyed by (workItem, role, attempt); idempotent per that key
03Previous Versions
2026.07.30.1
Modified 1 models
2026.07.25.1
Added 1 models
2026.07.20.1
Initial release: role-indexed provider/model catalog with tiered, signal-keyed fallback for CLI-agent dispatch.
04Stats
A
100 / 100
Downloads
1
Archive size
20.8 KB
- Has README or module doc2/2earned
- README has a code example1/1earned
- README is substantive1/1earned
- Most symbols documented1/1earned
- No slow types (deprecated)1/1earned
- Dependencies pass trust audit2/2earned
- Has description1/1earned
- Platform support declared (or universal)2/2earned
- License declared1/1earned
- Verified public repository2/2earned
05Platforms
06Labels