Agent Skill Warnings Resolver (src/skill-warnings.ts)

Tracks and resolves missing skill references for AI agents, providing structured UI visibility for uninstalled tools. Reuse in agent runtimes.

// Source: https://github.com/markus-global/markus | License: Apache-2.0 | Copyright 2026 Markus Contributors
// Provided via justclaw.it.com; keep this notice with the code.
import type { Agent } from './agent.js';

/**
 * H9 — structured visibility for "agent references a skill that is not installed".
 *
 * Before this module the two places that build agents (create + restore) each did
 * their own `config.skills.filter(s => !registry.get(s))` and then **only**
 * `log.warn`-ed the result. With dozens of agents restored on startup that meant
 * dozens of warnings buried in the log and *zero* visibility in the UI: every
 * affected agent silently degraded (its tools never registered) and looked fine.
 *
 * This module is the single source of truth for that computation:
 *   • `resolveMiss

... (truncated -- full source via MCP)