@pellux/goodvibes-agent 1.1.7 → 1.2.0

package/src/tools/agent-harness-mode-catalog.ts

@@ -12,6 +12,7 @@ interface HarnessModeDescriptor {
   readonly next?: string;
   readonly requiresConfirmation?: boolean;
   readonly aliases?: readonly AgentHarnessMode[];
+  readonly keywords?: readonly string[];
   readonly parameters?: readonly string[];
 }
 
@@ -31,54 +32,102 @@ export const HARNESS_MODE_DESCRIPTORS: readonly HarnessModeDescriptor[] = [
   { id: 'summary', kind: 'summary', family: 'start', summary: 'Compact harness map, counts, posture, and mode guide.', next: 'Use modes or a plural catalog mode to drill in.', parameters: ['includeParameters'] },
   { id: 'modes', kind: 'discover', family: 'start', summary: 'Search all agent_harness modes by task, family, effect, or id.', next: 'Use mode for one exact mode contract.', parameters: ['query', 'target', 'limit', 'includeParameters'] },
   { id: 'mode', kind: 'inspect', family: 'start', summary: 'Inspect one agent_harness mode contract and common next step.', next: 'Use target or query with a mode id or task phrase.', parameters: ['target', 'query'] },
-  { id: 'cli_commands', kind: 'discover', family: 'cli', summary: 'List top-level package CLI mirrors for discovery only.', next: 'Use cli_command for one command.', parameters: ['query', 'limit', 'includeParameters'] },
+  { id: 'route_decision', kind: 'inspect', family: 'start', summary: 'Choose the best visible Agent route for a plain user task.', next: 'Prefer route action:"plan" for first-class access.', keywords: ['where should this go', 'which tool', 'route user task', 'one assistant', 'user-first route'], parameters: ['query', 'target', 'limit', 'includeParameters'] },
+  { id: 'cli_commands', kind: 'discover', family: 'cli', summary: 'List top-level package CLI mirrors for discovery only.', next: 'Prefer workspace action:"cli_commands|cli_command".', parameters: ['query', 'limit', 'includeParameters'] },
   { id: 'cli_command', kind: 'inspect', family: 'cli', summary: 'Inspect one CLI command parser result, policy, aliases, and model route.', parameters: ['cliCommand', 'command', 'commandName', 'target', 'query'] },
-  { id: 'panels', kind: 'discover', family: 'ui', summary: 'List built-in panel catalog state and workspace routes.', next: 'Use panel or open_panel.', parameters: ['query', 'category', 'limit', 'includeParameters'] },
+  { id: 'panels', kind: 'discover', family: 'ui', summary: 'List built-in panel catalog state and workspace routes.', next: 'Prefer workspace action:"panels|panel|open_panel".', parameters: ['query', 'category', 'limit', 'includeParameters'] },
   { id: 'panel', kind: 'inspect', family: 'ui', summary: 'Inspect one built-in panel, open state, workspace route, and policy.', parameters: ['panelId', 'target', 'query'] },
   { id: 'open_panel', kind: 'effect', family: 'ui', summary: 'Route the visible shell to one built-in panel.', requiresConfirmation: true, parameters: ['panelId', 'target', 'query', 'pane', 'confirm', 'explicitUserRequest'] },
-  { id: 'ui_surfaces', kind: 'discover', family: 'ui', summary: 'List modal, picker, and visible UI surfaces the model can request.', next: 'Use ui_surface or open_ui_surface.', parameters: ['query', 'limit', 'includeParameters'] },
-  { id: 'ui_surface', kind: 'inspect', family: 'ui', summary: 'Inspect one visible modal or picker surface and route contract.', parameters: ['surfaceId', 'target', 'query'] },
-  { id: 'open_ui_surface', kind: 'effect', family: 'ui', summary: 'Open one visible modal, picker, or operator workspace route.', requiresConfirmation: true, parameters: ['surfaceId', 'target', 'query', 'confirm', 'explicitUserRequest'] },
-  { id: 'shortcuts', kind: 'discover', family: 'keyboard', summary: 'List fixed shortcuts and keybinding overview.', next: 'Use keybindings or keybinding for configurable actions.', parameters: ['query', 'limit', 'includeParameters'] },
-  { id: 'keybindings', kind: 'discover', family: 'keyboard', summary: 'List configurable keybinding actions and current/default combos.', next: 'Use keybinding, run_keybinding, set_keybinding, or reset_keybinding.', parameters: ['query', 'limit', 'includeParameters'] },
+  { id: 'ui_surfaces', kind: 'discover', family: 'ui', summary: 'List modal, picker, and visible UI surfaces the model can request.', next: 'Prefer workspace action:"surfaces|surface|open".', keywords: ['web dashboard', 'pwa', 'browser cockpit', 'connected browser', 'mobile web'], parameters: ['query', 'limit', 'includeParameters'] },
+  { id: 'ui_surface', kind: 'inspect', family: 'ui', summary: 'Inspect one visible modal or picker surface and route contract.', keywords: ['web dashboard', 'pwa', 'browser cockpit', 'connected browser', 'mobile web'], parameters: ['surfaceId', 'target', 'query'] },
+  { id: 'open_ui_surface', kind: 'effect', family: 'ui', summary: 'Open one visible modal, picker, or operator workspace route.', requiresConfirmation: true, keywords: ['web dashboard', 'pwa', 'browser cockpit', 'connected browser', 'mobile web'], parameters: ['surfaceId', 'target', 'query', 'confirm', 'explicitUserRequest'] },
+  { id: 'shortcuts', kind: 'discover', family: 'keyboard', summary: 'List fixed shortcuts and keybinding overview.', next: 'Prefer workspace action:"shortcuts|keybindings|keybinding".', parameters: ['query', 'limit', 'includeParameters'] },
+  { id: 'keybindings', kind: 'discover', family: 'keyboard', summary: 'List configurable keybinding actions and current/default combos.', next: 'Prefer workspace keybinding actions.', parameters: ['query', 'limit', 'includeParameters'] },
   { id: 'keybinding', kind: 'inspect', family: 'keyboard', summary: 'Inspect one keybinding action, current combos, defaults, and policy.', parameters: ['actionId', 'key', 'target', 'query'] },
   { id: 'run_keybinding', kind: 'effect', family: 'keyboard', summary: 'Run one supported keybinding action through the active UI route.', requiresConfirmation: true, parameters: ['actionId', 'key', 'target', 'query', 'confirm', 'explicitUserRequest'] },
   { id: 'set_keybinding', kind: 'effect', family: 'keyboard', summary: 'Set one configurable keybinding action.', requiresConfirmation: true, parameters: ['actionId', 'combo', 'combos', 'confirm', 'explicitUserRequest'] },
   { id: 'reset_keybinding', kind: 'effect', family: 'keyboard', summary: 'Reset one configurable keybinding action to defaults.', requiresConfirmation: true, parameters: ['actionId', 'confirm', 'explicitUserRequest'] },
-  { id: 'commands', kind: 'discover', family: 'slash', summary: 'List registered slash commands and compact policies.', next: 'Use command or run_command.', parameters: ['query', 'limit', 'includeParameters'] },
+  { id: 'commands', kind: 'discover', family: 'slash', summary: 'List registered slash commands and compact policies.', next: 'Prefer workspace action:"commands|command|run_command".', parameters: ['query', 'limit', 'includeParameters'] },
   { id: 'command', kind: 'inspect', family: 'slash', summary: 'Inspect slash command, parsed args, policy, aliases, and model route.', parameters: ['command', 'commandName', 'target', 'query'] },
   { id: 'run_command', kind: 'effect', family: 'slash', summary: 'Run one slash command through shared command dispatch.', requiresConfirmation: true, parameters: ['command', 'commandName', 'args', 'target', 'query', 'confirm', 'explicitUserRequest'] },
-  { id: 'channels', kind: 'discover', family: 'delivery', summary: 'List channel readiness, accounts, delivery posture, and safe setup keys.', next: 'Use channel or agent_channel_send.', parameters: ['query', 'limit', 'includeParameters'] },
-  { id: 'channel', kind: 'inspect', family: 'delivery', summary: 'Inspect one channel readiness entry and delivery policy.', parameters: ['channelId', 'target', 'query'] },
+  { id: 'channels', kind: 'discover', family: 'delivery', summary: 'List channel readiness, accounts, delivery posture, and safe setup keys.', next: 'Prefer channels action:"status|channel|setup".', parameters: ['query', 'limit', 'includeParameters'] },
+  { id: 'channel', kind: 'inspect', family: 'delivery', summary: 'Inspect one channel readiness entry and delivery policy.', next: 'Prefer channels action:"channel".', parameters: ['channelId', 'target', 'query'] },
+  { id: 'channel_setup_guide', kind: 'inspect', family: 'delivery', summary: 'Inspect the ordered channel setup guide and current per-channel step.', next: 'Prefer channels action:"setup".', parameters: ['channelId', 'target', 'query'] },
+  { id: 'channel_triage', kind: 'discover', family: 'delivery', summary: 'Triage blockers, retries, messages, routes, and receipts.', next: 'Prefer channels action:"triage".', keywords: ['inbox', 'triage', 'channel errors', 'delivery retries', 'pending messages', 'surface messages', 'route bindings'], parameters: ['limit', 'includeParameters'] },
+  { id: 'channel_deliveries', kind: 'discover', family: 'delivery', summary: 'List recent redacted confirmed channel delivery receipts.', next: 'Prefer channels action:"deliveries".', keywords: ['delivery receipts', 'channel history', 'sent messages', 'send outcomes'], parameters: ['limit', 'includeParameters'] },
   { id: 'notifications', kind: 'discover', family: 'delivery', summary: 'List notification target posture with webhook values redacted.', next: 'Use notification_target or agent_notify.', parameters: ['query', 'limit', 'includeParameters'] },
   { id: 'notification_target', kind: 'inspect', family: 'delivery', summary: 'Inspect one notification target and safe routing policy.', parameters: ['notificationTargetId', 'target', 'query'] },
-  { id: 'provider_accounts', kind: 'discover', family: 'providers', summary: 'List provider auth, subscription, usage-window, and repair posture.', next: 'Use provider_account.', parameters: ['query', 'limit', 'includeParameters'] },
+  { id: 'provider_accounts', kind: 'discover', family: 'providers', summary: 'List provider auth, subscription, usage-window, and repair posture.', next: 'Prefer models action:"providers"; provider_account for detail.', parameters: ['query', 'limit', 'includeParameters'] },
   { id: 'provider_account', kind: 'inspect', family: 'providers', summary: 'Inspect one provider account/auth posture without token leakage.', parameters: ['providerId', 'target', 'query'] },
   { id: 'mcp_servers', kind: 'discover', family: 'tools', summary: 'List MCP server/tool/security posture without exposing env or secrets.', next: 'Use mcp_server.', parameters: ['query', 'limit', 'includeParameters'] },
   { id: 'mcp_server', kind: 'inspect', family: 'tools', summary: 'Inspect one MCP server, tools, schemas, auth, and trust posture.', parameters: ['mcpServerId', 'target', 'query'] },
-  { id: 'setup_posture', kind: 'discover', family: 'setup', summary: 'Inspect first-run/setup capability posture and derived readiness flags.', next: 'Use setup_item.', parameters: ['query', 'limit', 'includeParameters'] },
-  { id: 'setup_item', kind: 'inspect', family: 'setup', summary: 'Inspect one setup/onboarding posture item and visible remediation route.', parameters: ['setupItemId', 'target', 'query'] },
-  { id: 'model_routing', kind: 'discover', family: 'providers', summary: 'List model/provider route, models, pins, and safe route settings.', next: 'Use model_route.', parameters: ['query', 'limit', 'includeParameters'] },
-  { id: 'model_route', kind: 'inspect', family: 'providers', summary: 'Inspect one model route or model candidate and visible selection paths.', parameters: ['modelRouteId', 'target', 'query'] },
-  { id: 'pairing_posture', kind: 'discover', family: 'companion', summary: 'List pairing routes, token posture, and safe handoff readiness.', next: 'Use pairing_route.', parameters: ['query', 'limit', 'includeParameters'] },
-  { id: 'pairing_route', kind: 'inspect', family: 'companion', summary: 'Inspect one companion pairing route and safe visible handoff.', parameters: ['pairingRouteId', 'target', 'query'] },
-  { id: 'delegation_posture', kind: 'discover', family: 'delegation', summary: 'List explicit build/fix/review delegation routes and boundaries.', next: 'Use delegation_route.', parameters: ['query', 'limit', 'includeParameters'] },
-  { id: 'delegation_route', kind: 'inspect', family: 'delegation', summary: 'Inspect one delegation route and exact visible submission contract.', parameters: ['delegationRouteId', 'target', 'query'] },
+  { id: 'setup_posture', kind: 'discover', family: 'setup', summary: 'Inspect first-run/always-on setup plan, posture, and flags.', next: 'Use setup_item.', keywords: ['sudo', 'sudo_password', 'SUDO_PASSWORD', 'pty', 'process write', 'credential posture'], parameters: ['query', 'limit', 'includeParameters'] },
+  { id: 'setup_item', kind: 'inspect', family: 'setup', summary: 'Inspect one first-run/always-on setup plan item.', keywords: ['sudo', 'sudo_password', 'SUDO_PASSWORD', 'pty', 'process write', 'credential posture'], parameters: ['setupItemId', 'target', 'query'] },
+  { id: 'setup_repair', kind: 'inspect', family: 'setup', summary: 'Choose the safest next setup repair route.', next: 'Prefer setup action:"repair".', keywords: ['repair setup', 'fix setup', 'launch host', 'start host', 'daemon repair', 'service status receipt', 'bootstrap host'], parameters: ['setupItemId', 'target', 'query', 'includeParameters'] },
+  { id: 'setup_checkpoint', kind: 'inspect', family: 'setup', summary: 'Inspect saved setup wizard checkpoint and current resume step.', parameters: ['includeParameters'] },
+  { id: 'mark_setup_checkpoint', kind: 'effect', family: 'setup', summary: 'Save the current setup wizard step as the resume checkpoint.', requiresConfirmation: true, parameters: ['setupItemId', 'confirm', 'explicitUserRequest'] },
+  { id: 'clear_setup_checkpoint', kind: 'effect', family: 'setup', summary: 'Clear the saved setup wizard checkpoint.', requiresConfirmation: true, parameters: ['confirm', 'explicitUserRequest'] },
+  { id: 'provision_connected_host_token', kind: 'effect', family: 'setup', summary: 'Create or repair local connected-host token safely.', requiresConfirmation: true, parameters: ['setupItemId', 'confirm', 'explicitUserRequest'] },
+  { id: 'run_setup_smoke', kind: 'effect', family: 'setup', summary: 'Run redacted first-run setup smoke evidence collection.', requiresConfirmation: true, parameters: ['setupItemId', 'fields', 'includeParameters', 'confirm', 'explicitUserRequest'] },
+  { id: 'project_context', kind: 'discover', family: 'context', summary: 'List AGENTS, HERMES, CLAUDE, SOUL, and Cursor context files.', next: 'Prefer context action:"files|file".', keywords: ['agents.md', 'hermes.md', '.hermes.md', 'claude.md', 'soul.md', '.cursorrules', '.cursor/rules', 'project instructions'], parameters: ['target', 'query', 'includeParameters'] },
+  { id: 'project_context_file', kind: 'inspect', family: 'context', summary: 'Inspect one project context file body, source, or blocked reason.', next: 'Prefer context action:"file".', keywords: ['agents.md', 'hermes.md', '.hermes.md', 'claude.md', 'soul.md', '.cursorrules', '.cursor/rules', 'project instructions'], parameters: ['contextFileId', 'target', 'query', 'includeParameters'] },
+  { id: 'prompt_context', kind: 'inspect', family: 'context', summary: 'Inspect prompt context, receipt outcomes, and token budget.', next: 'Prefer context action:"prompt|receipts|receipt".', keywords: ['prompt context', 'system prompt', 'why assistant acts', 'selected memory', 'active persona', 'suppressed context', 'token budget', 'receipt id', 'turn outcome', 'prompt receipt filters'], parameters: ['receiptId', 'turnId', 'outcomeStatus', 'limit', 'includeParameters'] },
+  { id: 'agent_orchestration', kind: 'discover', family: 'execution', summary: 'Inspect managed plan cards, closeout evidence, and dispatch routes.', next: 'Inspect one agent; dispatch approved plan items via agent_work_plan.', keywords: ['subagent', 'subagents', 'agent spawn', 'batch-spawn', 'dispatch agents', 'work plan dispatch', 'dispatch receipts', 'closeout evidence', 'multi-agent', 'multi-runner', 'managed plan', 'milestone', 'remote runner', 'artifact trail', 'visible agents', 'cancellable agents', 'wrfc', 'cohort'], parameters: ['query', 'limit', 'includeParameters'] },
+  { id: 'agent_orchestration_agent', kind: 'inspect', family: 'execution', summary: 'Inspect one visible Agent record with plan card and safe controls.', keywords: ['subagent', 'subagents', 'agent status', 'agent cancel', 'agent wait', 'agent message', 'batch-spawn', 'dispatch receipts', 'closeout evidence', 'multi-agent', 'multi-runner', 'managed plan', 'milestone', 'remote runner', 'artifact trail', 'visible agents', 'cancellable agents', 'wrfc', 'cohort'], parameters: ['agentId', 'target', 'query', 'includeParameters'] },
+  { id: 'model_routing', kind: 'discover', family: 'providers', summary: 'List model routes, readiness scores, local cookbook, and pins.', next: 'Prefer models action:"status|local|route|smoke".', parameters: ['query', 'limit', 'includeParameters'] },
+  { id: 'model_route', kind: 'inspect', family: 'providers', summary: 'Inspect one model route, local endpoint, fit score, or picker path.', parameters: ['modelRouteId', 'target', 'query'] },
+  { id: 'run_local_model_smoke', kind: 'effect', family: 'providers', summary: 'Run confirmed read-only model-list smoke checks for local endpoints.', requiresConfirmation: true, keywords: ['local model smoke', 'check local servers', 'ollama models', 'local endpoint probe'], parameters: ['modelRouteId', 'target', 'query', 'limit', 'timeoutMs', 'confirm', 'explicitUserRequest'] },
+  { id: 'execution_posture', kind: 'discover', family: 'execution', summary: 'Pick local shell/edit execution vs delegation.', next: 'Prefer execution action:"status"; use action:"route" for one.', keywords: ['sudo', 'sudo_password', 'SUDO_PASSWORD', 'foreground shell', 'privilege escalation'], parameters: ['query', 'limit', 'includeParameters'] },
+  { id: 'execution_route', kind: 'inspect', family: 'execution', summary: 'Inspect one local, browser, web, or delegation route.', next: 'Prefer execution action:"route".', keywords: ['sudo', 'sudo_password', 'SUDO_PASSWORD', 'foreground shell', 'privilege escalation'], parameters: ['executionRouteId', 'target', 'query'] },
+  { id: 'browser_control_route', kind: 'inspect', family: 'execution', summary: 'Plan browser, screenshot, or desktop-control route.', next: 'Prefer computer action:"plan".', keywords: ['browser control plan', 'take screenshot', 'screen observe', 'desktop control', 'live ui control', 'browser navigation'], parameters: ['target', 'query', 'includeParameters'] },
+  { id: 'background_processes', kind: 'discover', family: 'execution', summary: 'List tracked local background processes, logs, and lifecycle routes.', next: 'Prefer execution action:"processes"; use process for lifecycle effects.', parameters: ['query', 'target', 'limit', 'includeParameters'] },
+  { id: 'background_process', kind: 'inspect', family: 'execution', summary: 'Inspect one tracked background process with bounded output tails.', next: 'Prefer execution action:"process".', keywords: ['session id', 'process session', 'poll', 'log'], parameters: ['processId', 'processSessionId', 'sessionId', 'session_id', 'target', 'query', 'includeParameters'] },
+  { id: 'run_background_process', kind: 'effect', family: 'execution', summary: 'Process lifecycle with poll/log/kill aliases and PTY/sudo gaps.', requiresConfirmation: true, keywords: ['process tool', 'session id', 'process session', 'poll', 'kill', 'write', 'log', 'pty', 'sudo'], parameters: ['processAction', 'action', 'processId', 'processSessionId', 'sessionId', 'session_id', 'command', 'cwd', 'timeoutMs', 'pty', 'data', 'fields', 'confirm', 'explicitUserRequest'] },
+  { id: 'execution_history', kind: 'discover', family: 'execution', summary: 'List recent execution activity cards and raw records.', next: 'Prefer execution action:"history"; use action:"record" for one.', parameters: ['query', 'limit', 'includeParameters'] },
+  { id: 'execution_history_item', kind: 'inspect', family: 'execution', summary: 'Inspect one execution record with user card, routes, and recovery.', next: 'Prefer execution action:"record".', parameters: ['executionRecordId', 'recordId', 'target', 'query'] },
+  { id: 'file_recovery', kind: 'discover', family: 'execution', summary: 'Inspect local file edit undo/redo recovery.', next: 'Prefer execution action:"recovery"; apply with confirmation.', parameters: ['includeParameters'] },
+  { id: 'run_file_recovery', kind: 'effect', family: 'execution', summary: 'Apply one local file undo or redo snapshot.', requiresConfirmation: true, parameters: ['recoveryAction', 'target', 'query', 'confirm', 'explicitUserRequest'] },
+  { id: 'personal_ops_briefing', kind: 'discover', family: 'personal-ops', summary: 'Build a daily briefing plan across Personal Ops and autonomy.', next: 'Prefer personal_ops action:"briefing".', keywords: ['daily brief', 'morning brief', 'operator brief', 'personal briefing', 'daily ops', 'personal operations'], parameters: ['query', 'target', 'limit', 'includeParameters'] },
+  { id: 'personal_ops', kind: 'discover', family: 'personal-ops', summary: 'Map email/calendar tasks, reminders, records, and operation cards.', next: 'Prefer personal_ops action:"status".', keywords: ['personal operations'], parameters: ['includeParameters'] },
+  { id: 'personal_ops_queue', kind: 'discover', family: 'personal-ops', summary: 'List saved inbox/calendar review queues and fresh-read routes.', next: 'Prefer personal_ops action:"queue".', keywords: ['personal operations', 'inbox queue', 'email queue', 'calendar queue', 'agenda queue', 'saved review', 'daily ops'], parameters: ['query', 'target', 'limit', 'includeParameters'] },
+  { id: 'personal_ops_intake', kind: 'discover', family: 'personal-ops', summary: 'Plan personal requests to safe routes, fields, and confirmations.', next: 'Prefer personal_ops action:"intake".', keywords: ['personal operations', 'email calendar tasks reminders', 'email triage', 'inbox triage', 'draft reply', 'calendar briefing', 'agenda briefing', 'calendar conflicts', 'personal request', 'daily ops'], parameters: ['query', 'target', 'limit', 'includeParameters'] },
+  { id: 'personal_ops_lane', kind: 'inspect', family: 'personal-ops', summary: 'Inspect email/calendar tasks/reminders records, cards, and routes.', keywords: ['personal operations'], parameters: ['laneId', 'target', 'query'] },
+  { id: 'run_personal_ops_read', kind: 'effect', family: 'personal-ops', summary: 'Run one confirmed read-only inbox/calendar MCP operation.', next: 'Prefer personal_ops action:"read" for user-facing calls.', requiresConfirmation: true, keywords: ['email triage', 'inbox read', 'calendar read', 'agenda read', 'mcp call tool'], parameters: ['laneId', 'recordId', 'target', 'query', 'fields', 'includeParameters', 'confirm', 'explicitUserRequest'] },
+  { id: 'memory_posture', kind: 'discover', family: 'personal-ops', summary: 'Inspect Agent-local memory, vector recall, and provider posture.', next: 'Prefer memory action:"status"; use action:"provider" for one.', keywords: ['semantic recall', 'external memory', 'memory provider', 'honcho', 'openviking', 'mem0', 'hindsight', 'holographic', 'retaindb', 'byterover', 'supermemory'], parameters: ['query', 'limit', 'includeParameters'] },
+  { id: 'memory_provider', kind: 'inspect', family: 'personal-ops', summary: 'Inspect one memory embedding or external-memory provider record.', keywords: ['semantic recall', 'external memory', 'embedding provider', 'memory provider', 'honcho', 'openviking', 'mem0', 'hindsight', 'holographic', 'retaindb', 'byterover', 'supermemory'], parameters: ['providerId', 'target', 'query', 'includeParameters'] },
+  { id: 'autonomy_intake', kind: 'discover', family: 'personal-ops', summary: 'Route ongoing work with schedule and watcher trigger posture.', next: 'Prefer autonomy action:"intake"; use returned route or action:"queue".', keywords: ['incoming webhook', 'webhook watcher', 'watcher trigger', 'event trigger', 'gmail trigger', 'cron wakeup'], parameters: ['query', 'target', 'includeParameters'] },
+  { id: 'autonomy_queue', kind: 'discover', family: 'personal-ops', summary: 'List autonomy work with live records, tails, and controls.', next: 'Prefer autonomy action:"queue"; inspect one with action:"item".', parameters: ['query', 'limit', 'includeParameters'] },
+  { id: 'autonomy_queue_item', kind: 'inspect', family: 'personal-ops', summary: 'Inspect one autonomy card, live records, tails, and routes.', next: 'Prefer autonomy action:"item".', parameters: ['queueItemId', 'target', 'query'] },
+  { id: 'learning_curator', kind: 'discover', family: 'personal-ops', summary: 'Rank memory, notes, personas, skills, routines review/proposals.', next: 'Prefer memory action:"curator"; use action:"candidate" for one card.', parameters: ['query', 'limit', 'includeParameters'] },
+  { id: 'learning_candidate', kind: 'inspect', family: 'personal-ops', summary: 'Inspect one local-learning candidate and safe existing routes.', parameters: ['candidateId', 'target', 'query'] },
+  { id: 'research_briefing', kind: 'discover', family: 'research', summary: 'Show one next-action queue for research runs, sources, reports.', next: 'Use research action:"briefing".', keywords: ['deep research', 'research cockpit', 'research next actions', 'research queue', 'source review', 'report queue'], parameters: ['query', 'target', 'limit', 'includeParameters'] },
+  { id: 'research_workflow', kind: 'discover', family: 'research', summary: 'Plan research routes across run, source, report, browser, Knowledge.', next: 'Use research action:"plan"; runner checks browser readiness only.', parameters: ['query', 'target', 'runId', 'includeParameters'] },
+  { id: 'research_runs', kind: 'discover', family: 'research', summary: 'List deep-research runs, phase, log tails, and controls.', next: 'Use research_run for one run.', parameters: ['query', 'limit', 'includeParameters'] },
+  { id: 'research_run', kind: 'inspect', family: 'research', summary: 'Inspect one research run, log tail, checkpoints, and controls.', parameters: ['runId', 'target', 'query'] },
+  { id: 'research_queue', kind: 'discover', family: 'research', summary: 'List research sources, credibility, bundle route, and next actions.', next: 'Use research_source for one source.', parameters: ['query', 'limit', 'includeParameters'] },
+  { id: 'research_source', kind: 'inspect', family: 'research', summary: 'Inspect one source, report line, bundle, review, or ingest routes.', parameters: ['sourceId', 'target', 'query'] },
+  { id: 'document_ops', kind: 'discover', family: 'documents', summary: 'Map document uploads, artifacts, packet wizard, blind model compare.', next: 'Use document_ops_lane for wizard, readiness, artifacts, compare.', keywords: ['document upload', 'document uploads', 'artifact', 'artifacts', 'blind model comparison', 'blind model compare'], parameters: ['includeParameters'] },
+  { id: 'document_ops_lane', kind: 'inspect', family: 'documents', summary: 'Inspect document packet wizard, artifacts, readiness, blind compare.', keywords: ['document upload', 'document uploads', 'artifact', 'artifacts', 'blind model comparison', 'blind model compare'], parameters: ['laneId', 'target', 'query'] },
+  { id: 'pairing_posture', kind: 'discover', family: 'companion', summary: 'List pairing, tokens, and device capability readiness.', next: 'Use pairing_route.', keywords: ['mobile', 'phone', 'device', 'camera', 'screen', 'location', 'voice', 'pwa', 'companion capability', 'device commands'], parameters: ['query', 'limit', 'includeParameters'] },
+  { id: 'pairing_route', kind: 'inspect', family: 'companion', summary: 'Inspect one pairing or device capability handoff.', keywords: ['mobile', 'phone', 'device', 'camera', 'screen', 'location', 'voice', 'pwa', 'companion capability', 'device commands'], parameters: ['pairingRouteId', 'target', 'query'] },
+  { id: 'delegation_posture', kind: 'discover', family: 'delegation', summary: 'List explicit build/fix/review delegation routes and boundaries.', next: 'Prefer delegation action:"status|routes"; use action:"route" for one.', parameters: ['query', 'limit', 'includeParameters'] },
+  { id: 'delegation_route', kind: 'inspect', family: 'delegation', summary: 'Inspect one delegation route and exact visible submission contract.', next: 'Prefer delegation action:"route".', parameters: ['delegationRouteId', 'target', 'query'] },
   { id: 'security_posture', kind: 'discover', family: 'security', summary: 'List security posture findings without exposing secrets or raw config.', next: 'Use security_finding.', parameters: ['query', 'limit', 'includeParameters'] },
   { id: 'security_finding', kind: 'inspect', family: 'security', summary: 'Inspect one security posture finding and safe remediation route.', parameters: ['findingId', 'target', 'query'] },
+  { id: 'policy_explain', kind: 'inspect', family: 'security', summary: 'Explain one model action policy and confirmation route.', next: 'Prefer security action:"explain".', keywords: ['why allowed', 'why denied', 'requires confirmation', 'permission policy', 'tool policy'], parameters: ['toolName', 'tool', 'toolArgs', 'target', 'query', 'includeParameters'] },
   { id: 'support_bundles', kind: 'discover', family: 'support', summary: 'List support bundle artifacts and redacted export/import posture.', next: 'Use support_bundle.', parameters: ['query', 'limit', 'includeParameters'] },
   { id: 'support_bundle', kind: 'inspect', family: 'support', summary: 'Inspect one support bundle artifact and redaction posture.', parameters: ['bundlePath', 'target', 'query'] },
-  { id: 'media_posture', kind: 'discover', family: 'media', summary: 'List media/voice readiness, browser posture, and artifact routes.', next: 'Use media_provider or agent_media_generate.', parameters: ['query', 'limit', 'includeParameters'] },
-  { id: 'media_provider', kind: 'inspect', family: 'media', summary: 'Inspect one voice or media provider readiness entry.', parameters: ['mediaProviderId', 'target', 'query'] },
+  { id: 'media_posture', kind: 'discover', family: 'media', summary: 'List media/voice readiness, browser posture, and artifact routes.', next: 'Use media_provider or agent_media_generate.', keywords: ['push to talk', 'wake word', 'spoken response', 'tts voice', 'voice controls', 'phone voice'], parameters: ['query', 'limit', 'includeParameters'] },
+  { id: 'media_provider', kind: 'inspect', family: 'media', summary: 'Inspect one voice or media provider readiness entry.', keywords: ['push to talk', 'wake word', 'spoken response', 'tts voice', 'voice controls', 'phone voice'], parameters: ['mediaProviderId', 'target', 'query'] },
   { id: 'sessions', kind: 'discover', family: 'sessions', summary: 'List saved sessions, bookmarks, exports, and pending approvals posture.', next: 'Use session.', parameters: ['query', 'limit', 'includeParameters'] },
   { id: 'session', kind: 'inspect', family: 'sessions', summary: 'Inspect one saved session or bookmark entry.', parameters: ['sessionId', 'target', 'query'] },
-  { id: 'settings', kind: 'discover', family: 'settings', summary: 'Search Agent settings compactly by category, prefix, or query.', next: 'Use get_setting, set_setting, or reset_setting.', parameters: ['category', 'prefix', 'query', 'includeHidden', 'limit', 'includeParameters'] },
+  { id: 'settings', kind: 'discover', family: 'settings', summary: 'Search Agent settings compactly by category, prefix, or query.', next: 'Prefer settings action:"list|get|set|reset|import".', parameters: ['category', 'prefix', 'query', 'includeHidden', 'limit', 'includeParameters'] },
   { id: 'get_setting', kind: 'inspect', family: 'settings', summary: 'Inspect one Agent setting descriptor, value, default, and policy.', parameters: ['key', 'target', 'query'] },
   { id: 'set_setting', kind: 'effect', family: 'settings', summary: 'Set one Agent-owned setting through config/secret managers.', requiresConfirmation: true, parameters: ['key', 'target', 'query', 'value', 'confirm', 'explicitUserRequest'] },
   { id: 'reset_setting', kind: 'effect', family: 'settings', summary: 'Reset one Agent-owned setting and delete secret refs when needed.', requiresConfirmation: true, parameters: ['key', 'target', 'query', 'confirm', 'explicitUserRequest'] },
-  { id: 'workspace', kind: 'discover', family: 'workspace', summary: 'List Agent workspace categories and action counts.', next: 'Use workspace_actions or workspace_action.' },
-  { id: 'workspace_categories', kind: 'discover', family: 'workspace', summary: 'Alias of workspace for category discovery.', next: 'Use workspace_actions or workspace_action.', aliases: ['workspace'] },
-  { id: 'workspace_actions', kind: 'discover', family: 'workspace', summary: 'Search all user-facing Agent workspace actions and compact model routes.', next: 'Use workspace_action or run_workspace_action.', parameters: ['categoryId', 'query', 'limit', 'includeParameters'] },
+  { id: 'workspace', kind: 'discover', family: 'workspace', summary: 'List Agent workspace categories and action counts.', next: 'Prefer workspace action:"status|actions|action".' },
+  { id: 'workspace_categories', kind: 'discover', family: 'workspace', summary: 'Alias of workspace for category discovery.', next: 'Prefer workspace action:"status|actions|action".', aliases: ['workspace'] },
+  { id: 'workspace_actions', kind: 'discover', family: 'workspace', summary: 'Search all user-facing Agent workspace actions and compact model routes.', next: 'Prefer workspace action:"actions|action|run".', parameters: ['categoryId', 'query', 'limit', 'includeParameters'] },
   { id: 'workspace_action', kind: 'inspect', family: 'workspace', summary: 'Inspect one workspace action, editor schema, route, and safety policy.', parameters: ['actionId', 'command', 'target', 'query', 'recordId'] },
   { id: 'run_workspace_action', kind: 'effect', family: 'workspace', summary: 'Run a workspace action or return its model execution handoff.', requiresConfirmation: true, parameters: ['actionId', 'command', 'target', 'query', 'recordId', 'fields', 'confirm', 'explicitUserRequest'] },
   { id: 'tools', kind: 'discover', family: 'tools', summary: 'List first-class model tool definitions compactly.', next: 'Use tool for full schema.', parameters: ['query', 'limit', 'includeParameters'] },
@@ -87,15 +136,15 @@ export const HARNESS_MODE_DESCRIPTORS: readonly HarnessModeDescriptor[] = [
   { id: 'release_evidence_artifact', kind: 'inspect', family: 'operator-audit', summary: 'Inspect one operator/audit release artifact and optional content.', parameters: ['artifactId', 'target', 'query'] },
   { id: 'release_readiness', kind: 'discover', family: 'operator-audit', summary: 'Search the operator/audit release-quality inventory.', next: 'Use release_readiness_item.', parameters: ['query', 'limit', 'includeParameters'] },
   { id: 'release_readiness_item', kind: 'inspect', family: 'operator-audit', summary: 'Inspect one operator/audit readiness inventory item.', parameters: ['itemId', 'target', 'query'] },
-  { id: 'operator_methods', kind: 'discover', family: 'operator', summary: 'List public operator/Agent Knowledge methods and owning tools.', next: 'Use operator_method.', parameters: ['query', 'limit', 'includeParameters'] },
-  { id: 'operator_method', kind: 'inspect', family: 'operator', summary: 'Inspect one operator method and preferred first-class model tool.', parameters: ['methodId', 'target', 'query'] },
-  { id: 'service_posture', kind: 'discover', family: 'connected-host', summary: 'Inspect service endpoint posture, binding, issues, and probes.', next: 'Use service_endpoint.', parameters: ['includeParameters'] },
+  { id: 'operator_methods', kind: 'discover', family: 'operator', summary: 'List GoodVibes daemon operator methods from the live SDK contract.', next: 'Prefer host action:"methods|method"; execute with agent_operator_method.', parameters: ['query', 'limit', 'includeParameters'] },
+  { id: 'operator_method', kind: 'inspect', family: 'operator', summary: 'Inspect one daemon method, route, effect, and confirmation policy.', next: 'Prefer host action:"method".', parameters: ['methodId', 'target', 'query'] },
+  { id: 'service_posture', kind: 'discover', family: 'connected-host', summary: 'Inspect service endpoint posture, binding, issues, and probes.', next: 'Prefer host action:"services|service".', parameters: ['includeParameters'] },
   { id: 'service_endpoint', kind: 'inspect', family: 'connected-host', summary: 'Inspect one service endpoint binding and lifecycle boundary.', parameters: ['endpointId', 'target', 'query'] },
-  { id: 'connected_host', kind: 'discover', family: 'connected-host', summary: 'Map connected-host capabilities, boundaries, and tool availability.', next: 'Use connected_host_capability or connected_host_status.', parameters: ['includeParameters'] },
-  { id: 'connected_host_status', kind: 'inspect', family: 'connected-host', summary: 'Run live read-only connected-host readiness checks.', parameters: ['includeParameters'] },
-  { id: 'connected_host_capability', kind: 'inspect', family: 'connected-host', summary: 'Inspect one connected-host capability and blocked surfaces.', parameters: ['capabilityId', 'target', 'query'] },
-  { id: 'daemon', kind: 'alias', family: 'connected-host', summary: 'GoodVibes daemon -> connected_host; lifecycle external.', next: 'Use connected_host for canonical naming.', aliases: ['connected_host'], parameters: ['includeParameters'] },
-  { id: 'daemon_status', kind: 'alias', family: 'connected-host', summary: 'GoodVibes daemon status -> connected_host_status.', next: 'Use connected_host_status for canonical naming.', aliases: ['connected_host_status'], parameters: ['includeParameters'] },
+  { id: 'connected_host', kind: 'discover', family: 'connected-host', summary: 'Map connected-host capabilities, boundaries, and tool availability.', next: 'Prefer host action:"capabilities|capability|status".', parameters: ['includeParameters'] },
+  { id: 'connected_host_status', kind: 'inspect', family: 'connected-host', summary: 'Run live read-only connected-host readiness checks.', next: 'Prefer host action:"status".', parameters: ['includeParameters'] },
+  { id: 'connected_host_capability', kind: 'inspect', family: 'connected-host', summary: 'Inspect one connected-host capability and blocked surfaces.', next: 'Prefer host action:"capability".', parameters: ['capabilityId', 'target', 'query'] },
+  { id: 'daemon', kind: 'alias', family: 'connected-host', summary: 'GoodVibes daemon -> connected_host; mutations use confirmed methods.', next: 'Prefer host action:"capabilities".', aliases: ['connected_host'], parameters: ['includeParameters'] },
+  { id: 'daemon_status', kind: 'alias', family: 'connected-host', summary: 'GoodVibes daemon status -> connected_host_status.', next: 'Prefer host action:"status".', aliases: ['connected_host_status'], parameters: ['includeParameters'] },
 ] as const;
 
 function readString(value: unknown): string {
@@ -138,6 +187,7 @@ function harnessModeSearchText(descriptor: HarnessModeDescriptor): string {
     descriptor.summary,
     descriptor.next,
     ...(descriptor.aliases ?? []),
+    ...(descriptor.keywords ?? []),
     ...(descriptor.parameters ?? []),
   ].filter(Boolean).join('\n').toLowerCase();
 }
@@ -182,6 +232,7 @@ function harnessModeRelevance(descriptor: HarnessModeDescriptor, input: string):
   score += tokenScore(tokens, descriptor.kind, 500);
   score += tokenScore(tokens, (descriptor.parameters ?? []).join('\n'), 350);
   score += tokenScore(tokens, descriptor.summary, 200);
+  score += tokenScore(tokens, (descriptor.keywords ?? []).join('\n'), 150);
   score += tokenScore(tokens, descriptor.next, 100);
 
   const actionVerb = tokens.find((token) => ACTION_VERBS.has(token));

package/src/tools/agent-harness-model-catalog.ts

@@ -0,0 +1,162 @@
+import type { ArtifactDescriptor } from '@pellux/goodvibes-sdk/platform/artifacts';
+import type { CommandContext } from '../input/command-registry.ts';
+import { requireProviderApi } from '../input/commands/runtime-services.ts';
+import type { ArtifactListLike, ModelCandidate, ProviderApiLike } from './agent-harness-model-routing-types.ts';
+import { readRecord, readString, readStringArray } from './agent-harness-model-routing-utils.ts';
+
+export function readProviderModels(value: unknown, providerId: string): readonly string[] {
+  if (!Array.isArray(value)) return [];
+  return value.map((entry) => {
+    if (typeof entry === 'string') return providerId ? `${providerId}:${entry}` : entry;
+    const modelId = modelModelId(entry);
+    const registryKey = modelRegistryKey(entry);
+    return registryKey || (providerId && modelId ? `${providerId}:${modelId}` : modelId);
+  }).filter(Boolean);
+}
+
+export function readArtifactStore(context: CommandContext): ArtifactListLike | null {
+  const candidate = (context.platform as { readonly artifactStore?: unknown }).artifactStore;
+  return candidate && typeof candidate === 'object' ? candidate as ArtifactListLike : null;
+}
+
+export function readConfig(context: CommandContext, key: string): unknown {
+  try {
+    return (context.platform.configManager as { get(settingKey: string): unknown }).get(key);
+  } catch {
+    return undefined;
+  }
+}
+
+export function contextWindowFor(context: CommandContext, model: unknown): number | null {
+  const record = readRecord(model);
+  const direct = record.contextWindow;
+  if (typeof direct === 'number' && Number.isFinite(direct)) return direct;
+  try {
+    const registry = context.provider.providerRegistry as { getContextWindowForModel(candidate: unknown): number };
+    const value = registry.getContextWindowForModel(model);
+    return typeof value === 'number' && Number.isFinite(value) ? value : null;
+  } catch {
+    return null;
+  }
+}
+
+export function modelRegistryKey(model: unknown): string {
+  const record = readRecord(model);
+  return readString(record.registryKey) || readString(record.id) || readString(record.modelId);
+}
+
+export function modelProviderId(model: unknown): string {
+  const record = readRecord(model);
+  return readString(record.providerId) || readString(record.provider);
+}
+
+export function modelModelId(model: unknown): string {
+  const record = readRecord(model);
+  return readString(record.modelId) || readString(record.id) || modelRegistryKey(model);
+}
+
+export function modelDisplayName(model: unknown): string {
+  const record = readRecord(model);
+  return readString(record.displayName) || readString(record.name) || modelRegistryKey(model);
+}
+
+export function modelCurrent(model: unknown): boolean {
+  const record = readRecord(model);
+  return record.current === true;
+}
+
+export function modelReasoning(model: unknown): readonly string[] {
+  const record = readRecord(model);
+  return readStringArray(record.reasoningEffort);
+}
+
+export function modelCapabilities(model: unknown): unknown {
+  return readRecord(model).capabilities ?? null;
+}
+
+export function modelTier(model: unknown): string | undefined {
+  return readString(readRecord(model).tier) || undefined;
+}
+
+export function modelBenchmarkCompositeScore(model: unknown): number | null {
+  const benchmark = readRecord(readRecord(model).benchmark);
+  const value = benchmark.compositeScore;
+  return typeof value === 'number' && Number.isFinite(value) ? value : null;
+}
+
+export function modelBenchmarkQualityTier(model: unknown): string | undefined {
+  return readString(readRecord(readRecord(model).benchmark).qualityTier) || undefined;
+}
+
+export function readProviderApi(context: CommandContext): ProviderApiLike | null {
+  try {
+    return requireProviderApi(context) as ProviderApiLike;
+  } catch {
+    return null;
+  }
+}
+
+export async function loadPinnedModelIds(context: CommandContext): Promise<ReadonlySet<string>> {
+  const providerApi = readProviderApi(context);
+  if (!providerApi) return new Set();
+  try {
+    const favorites = await providerApi.getFavorites();
+    const pinned = readRecord(favorites).pinned;
+    if (!Array.isArray(pinned)) return new Set();
+    return new Set(pinned.flatMap((entry) => {
+      const record = readRecord(entry);
+      return [readString(record.registryKey), readString(record.modelId)].filter(Boolean);
+    }));
+  } catch {
+    return new Set();
+  }
+}
+
+export async function loadModels(context: CommandContext): Promise<readonly ModelCandidate[]> {
+  const providerApi = readProviderApi(context);
+  if (!providerApi) return [];
+  const pinned = await loadPinnedModelIds(context);
+  const models = await providerApi.listModels({ selectableOnly: true });
+  return models.map((model) => {
+    const registryKey = modelRegistryKey(model);
+    const modelId = modelModelId(model);
+    return {
+      kind: 'model',
+      id: registryKey,
+      registryKey,
+      modelId,
+      providerId: modelProviderId(model),
+      displayName: modelDisplayName(model),
+      current: modelCurrent(model) || registryKey === context.session.runtime.model,
+      contextWindow: contextWindowFor(context, model),
+      reasoningEffort: modelReasoning(model),
+      capabilities: modelCapabilities(model),
+      tier: modelTier(model),
+      benchmarkCompositeScore: modelBenchmarkCompositeScore(model),
+      benchmarkQualityTier: modelBenchmarkQualityTier(model),
+      pinned: pinned.has(registryKey) || pinned.has(modelId),
+    };
+  });
+}
+
+export function listProviderIds(context: CommandContext): readonly string[] {
+  return readProviderApi(context)?.listProviderIds() ?? [];
+}
+
+export function listRegistryModels(context: CommandContext): readonly unknown[] {
+  try {
+    const registry = context.provider.providerRegistry as { listModels?: () => readonly unknown[] };
+    return registry.listModels?.() ?? [];
+  } catch {
+    return [];
+  }
+}
+
+export function listProviderRegistryProviders(context: CommandContext): readonly unknown[] {
+  try {
+    const registry = context.provider.providerRegistry as { listProviders?: () => readonly unknown[] };
+    return registry.listProviders?.() ?? [];
+  } catch {
+    return [];
+  }
+}

package/src/tools/agent-harness-model-provider-health.ts

@@ -0,0 +1,186 @@
+import type { CommandContext } from '../input/command-registry.ts';
+import { previewHarnessText } from './agent-harness-text.ts';
+import type { ModelProviderHealthSignal } from './agent-harness-model-routing-types.ts';
+import { readBoolean, readFiniteNumber, readRecord, readString, safeIso } from './agent-harness-model-routing-utils.ts';
+
+function readPotentialProviderHealthSnapshot(source: unknown): unknown {
+  if (!source || typeof source !== 'object') return null;
+  const record = source as Record<string, unknown>;
+  const directSnapshot = typeof record.getSnapshot === 'function'
+    ? (record.getSnapshot as () => unknown)()
+    : null;
+  return directSnapshot ?? record.snapshot ?? record.data ?? record.state ?? source;
+}
+
+function providerHealthCandidatesFromSnapshot(snapshot: unknown): readonly Record<string, unknown>[] {
+  if (!snapshot || typeof snapshot !== 'object') return [];
+  if (snapshot instanceof Map) {
+    return [...snapshot.entries()].map(([key, entry]) => {
+      const record = readRecord(entry);
+      return { ...record, providerId: readString(record.providerId) || readString(key) };
+    });
+  }
+  const record = readRecord(snapshot);
+  const providers = record.providers;
+  const entries = record.entries;
+  if (providers instanceof Map) {
+    return [...providers.entries()].map(([key, entry]) => {
+      const providerRecord = readRecord(entry);
+      return { ...providerRecord, providerId: readString(providerRecord.providerId) || readString(key) };
+    });
+  }
+  if (Array.isArray(providers)) {
+    return providers.map((entry) => readRecord(entry));
+  }
+  if (providers && typeof providers === 'object') {
+    return Object.entries(providers as Record<string, unknown>).map(([key, entry]) => {
+      const providerRecord = readRecord(entry);
+      return { ...providerRecord, providerId: readString(providerRecord.providerId) || key };
+    });
+  }
+  if (entries instanceof Map) {
+    return [...entries.entries()].map(([key, entry]) => {
+      const entryRecord = readRecord(entry);
+      return { ...entryRecord, providerId: readString(entryRecord.providerId) || readString(key) };
+    });
+  }
+  if (Array.isArray(entries)) {
+    return entries.map((entry) => readRecord(entry));
+  }
+  return [];
+}
+
+function providerHealthCandidateId(candidate: Record<string, unknown>): string {
+  return readString(candidate.providerId)
+    || readString(candidate.id)
+    || readString(candidate.provider)
+    || readString(candidate.name);
+}
+
+function providerHealthRecordStats(candidate: Record<string, unknown>): Record<string, unknown> {
+  return readRecord(candidate.stats);
+}
+
+function providerHealthTimestamp(candidate: Record<string, unknown>, stats: Record<string, unknown>, key: string): string | null {
+  return safeIso(readFiniteNumber(candidate[key]) ?? readFiniteNumber(stats[key]));
+}
+
+export function readProviderHealthSignal(context: CommandContext, providerId: string): ModelProviderHealthSignal {
+  const base: Omit<ModelProviderHealthSignal, 'status' | 'daemonPublication' | 'agentConsumption' | 'missingSignals' | 'policy'> = {
+    providerId,
+    sdkContract: {
+      providerHealthTypes: 'available',
+      importSurface: '@pellux/goodvibes-sdk/platform/runtime/ui',
+      note: 'The SDK publishes provider-health domain and UI enrichment types; types alone do not prove live connected-host health.',
+    },
+  };
+  const policy = 'Provider health is live route-condition evidence. Local benchmark artifacts remain separate task-fit evidence and must not be treated as provider-health publication.';
+  const platform = context.platform as unknown as Record<string, unknown>;
+  const readModels = readRecord(platform.readModels);
+  const sourceEntries: readonly { readonly path: string; readonly source: unknown }[] = [
+    { path: 'context.platform.readModels.providerHealth', source: readModels.providerHealth },
+    { path: 'context.platform.readModels.providersHealth', source: readModels.providersHealth },
+    { path: 'context.platform.providerHealth', source: platform.providerHealth },
+  ];
+
+  for (const entry of sourceEntries) {
+    if (entry.source === undefined || entry.source === null) continue;
+    try {
+      const snapshot = readPotentialProviderHealthSnapshot(entry.source);
+      const candidates = providerHealthCandidatesFromSnapshot(snapshot);
+      const candidate = candidates.find((item) => providerHealthCandidateId(item) === providerId);
+      if (!candidate) {
+        return {
+          ...base,
+          status: 'read-model-empty',
+          daemonPublication: {
+            status: 'published-read-model',
+            requiredPath: entry.path,
+            evidence: 'A provider-health read model path exists, but no matching provider record was returned.',
+          },
+          agentConsumption: {
+            status: 'waiting-for-published-feed',
+            readModelPath: entry.path,
+            evidence: `No provider-health record matched provider "${providerId}".`,
+          },
+          missingSignals: [`No daemon-published provider-health record matched provider "${providerId}" in ${entry.path}.`],
+          policy,
+        };
+      }
+
+      const stats = providerHealthRecordStats(candidate);
+      const avgLatencyMs = readFiniteNumber(candidate.avgLatencyMs) ?? readFiniteNumber(stats.avgLatencyMs);
+      const minLatencyMs = readFiniteNumber(candidate.minLatencyMs) ?? readFiniteNumber(stats.minLatencyMs);
+      const maxLatencyMs = readFiniteNumber(candidate.maxLatencyMs) ?? readFiniteNumber(candidate.p95LatencyMs) ?? readFiniteNumber(stats.maxLatencyMs);
+      const healthStatus = readString(candidate.status) || 'unknown';
+      return {
+        ...base,
+        status: 'record-found',
+        daemonPublication: {
+          status: 'published-read-model',
+          requiredPath: entry.path,
+          evidence: `Provider-health record found for provider "${providerId}".`,
+        },
+        agentConsumption: {
+          status: 'consumed',
+          readModelPath: entry.path,
+          evidence: 'Agent consumed the published provider-health record for exact model-route readiness.',
+        },
+        healthStatus,
+        isConfigured: readBoolean(candidate.isConfigured),
+        isActive: readBoolean(candidate.isActive),
+        avgLatencyMs,
+        minLatencyMs,
+        maxLatencyMs,
+        lastSuccessAt: providerHealthTimestamp(candidate, stats, 'lastSuccessAt'),
+        lastErrorAt: providerHealthTimestamp(candidate, stats, 'lastErrorAt'),
+        lastErrorMessage: readString(candidate.lastErrorMessage) || readString(stats.lastErrorMessage) || undefined,
+        lastCheckedAt: providerHealthTimestamp(candidate, stats, 'lastCheckedAt'),
+        rateLimitResetAt: providerHealthTimestamp(candidate, stats, 'rateLimitResetAt'),
+        missingSignals: [
+          ...(avgLatencyMs === undefined ? ['Provider-health record did not include average latency.'] : []),
+          ...(minLatencyMs === undefined ? ['Provider-health record did not include minimum latency.'] : []),
+          ...(maxLatencyMs === undefined ? ['Provider-health record did not include maximum or p95 latency.'] : []),
+        ],
+        policy,
+      };
+    } catch (error) {
+      return {
+        ...base,
+        status: 'read-model-error',
+        daemonPublication: {
+          status: 'published-read-model',
+          requiredPath: entry.path,
+          evidence: `Provider-health read model exists but failed while reading: ${previewHarnessText(error instanceof Error ? error.message : String(error), 120)}`,
+        },
+        agentConsumption: {
+          status: 'waiting-for-published-feed',
+          readModelPath: entry.path,
+          evidence: 'Agent could not safely consume this provider-health read model.',
+        },
+        missingSignals: ['Provider-health read model exists but failed while Agent was reading it.'],
+        policy,
+      };
+    }
+  }
+
+  return {
+    ...base,
+    status: 'not-reachable-in-command-context',
+    daemonPublication: {
+      status: 'not-published',
+      requiredPath: 'context.platform.readModels.providerHealth',
+      evidence: 'No daemon-published provider-health read model is reachable from Agent CommandContext.',
+    },
+    agentConsumption: {
+      status: 'waiting-for-published-feed',
+      readModelPath: null,
+      evidence: 'Agent cannot attach provider status or latency to exact routes until the connected host publishes a stable feed.',
+    },
+    missingSignals: [
+      'SDK provider-health types are available, but no daemon-published provider.health feed is reachable in Agent CommandContext.',
+      'Agent has not consumed provider status, configured state, live latency, rate-limit posture, or last error for this route.',
+    ],
+    policy,
+  };
+}