The agent that grows with you
Python aiai-agentai-agentsanthropicchatgptclaudeclaude-codecodexhermeshermes-agentllmnous-researchopenai
import { describe, expect, it } from 'vitest'
import { fetchRuntimeReadinessSignals, interpretRuntimeReadiness, runtimeReadinessDisplay } from './runtime-readiness'
describe('interpretRuntimeReadiness', () => {
it('prefers runtime_check when both signals exist', () => {
const result = interpretRuntimeReadiness({
setup: { provider_configured: false },
setupError: null,
runtime: { ok: true },
runtimeError: null
})
expect(result).toEqual({
checksDisagree: true,
ready: true,
reason: null,
source: 'runtime_check'
})
})
it('surfaces runtime mismatch details when runtime_check fails', () => {
const result = interpretRuntimeReadiness({
setup: { provider_configured: true },
setupError: null,
runtime: { error: 'No provider can serve the selected model.', ok: false },
runtimeError: null
})
expect(result.ready).toBe(false)
expect(result.source).toBe('runtime_check')
expect(result.checksDisagree).toBe(true)
expect(result.reason).toContain('No provider can serve the selected model.')
expect(result.reason).toContain('setup.status reports configured credentials')
})
it('falls back to setup.status when runtime_check has no boolean result', () => {
const result = interpretRuntimeReadiness({
setup: { provider_configured: true },
setupError: null,
runtime: null,
runtimeError: 'runtime check RPC unavailable'
})
expect(result).toEqual({
checksDisagree: false,
ready: true,
reason: null,
source: 'setup_status'
})
})
const NOT_CONNECTED = 'Hermes is not connected to any AI provider yet. Run `hermes model` to pick one.'
it.each([
['runtime_check', { runtime: { error: NOT_CONNECTED, ok: false }, runtimeError: null }],
['setup_status', { runtime: null, runtimeError: NOT_CONNECTED }]
] as const)('gives the default reason, not the CLI sentence, when nothing is set up (%s)', (source, runtime) => {
const result = interpretRuntimeReadiness(
{ setup: { provider_configured: false }, setupError: null, ...runtime },
{ defaultReason: 'Pick a provider.' }
)
expect(result).toMatchObject({ ready: false, reason: 'Pick a provider.', source })
})
it('keeps the cause for an explicitly requested provider even when nothing is set up', () => {
const result = interpretRuntimeReadiness(
{
setup: { provider_configured: false },
setupError: null,
runtime: { error: 'No usable credentials found for nous.', ok: false },
runtimeError: null
},
{ requestedProvider: 'nous' }
)
expect(result.reason).toBe('No usable credentials found for nous.')
})
it('uses explicit fallback when both checks are missing', () => {
const result = interpretRuntimeReadiness({
setup: null,
setupError: 'setup.status timeout',
runtime: null,
runtimeError: 'setup.runtime_check timeout'
})
expect(result.ready).toBe(false)
expect(result.source).toBe('fallback')
expect(result.reason).toBe('setup.runtime_check timeout')
})
})
describe('fetchRuntimeReadinessSignals', () => {
it('scopes setup.runtime_check to the requested provider', async () => {
const calls: Array<{ method: string; params?: Record<string, unknown> }> = []
const requestGateway = async <T = unknown>(method: string, params?: Record<string, unknown>) => {
calls.push({ method, params })
if (method === 'setup.status') {
return { provider_configured: true } as T
}
if (method === 'setup.runtime_check') {
return { ok: true } as T
}
throw new Error(`unexpected method: ${method}`)
}
await fetchRuntimeReadinessSignals(requestGateway, 'nous')
expect(calls).toEqual([{ method: 'setup.status' }, { method: 'setup.runtime_check', params: { provider: 'nous' } }])
})
})
describe('runtimeReadinessDisplay', () => {
it('does not call configured credentials setup when runtime resolution fails', () => {
expect(
runtimeReadinessDisplay({
checksDisagree: true,
ready: false,
reason: 'Anthropic cannot serve the selected model.',
source: 'runtime_check'
})
).toBe('unavailable')
})
it('keeps needs-setup for an authoritative unconfigured result', () => {
expect(
runtimeReadinessDisplay({
checksDisagree: false,
ready: false,
reason: 'No provider configured.',
source: 'setup_status'
})
).toBe('needs_setup')
})
})