# Provider Capability Matrix
#
# Single authoritative source of truth for what each provider supports
# natively vs. via AIWG emulation. Machine-readable; consumed by:
#   - src/providers/capability-matrix.ts  (TypeScript loader)
#   - aiwg runtime-info --capabilities    (CLI display)
#   - aiwg steward capabilities           (steward awareness)
#   - Scheduler (#597), Agent Teams (#598), Steward (#599) routing
#
# @issue #604
# @unblocks #597, #598, #599

version: "1.0"

providers:
  claude-code:
    display_name: Claude Code
    aliases:
      - claude
    route_feasibility:
      scope: in
      identity: runtime-configured-only
      evidence: H
      channel: "claude -p --output-format stream-json --verbose; terminal result extraction"
      fanout: unknown
      probe_budget: { status: authorized, calls: 3, tokens: 30000, authorized_by: operator, authorized_at: "2026-10-07", hosts: [titan, noodle] }
      coverage:
        profile_issue: "roctinam/aiwg#2900"
        source_date: "2026-11-07"
        live_qualified: false
        sources:
          - "host-help: claude 2.1.319 on titan (--version/--help/-p --help only)"
          - "tools/ralph-external/lib/claude-adapter.mjs"
    status: stable
    daemon_tier: unsupported
    daemon_pty_adapter: false
    artifact_paths:
      agents: .claude/agents/
      commands: .claude/commands/
      skills: .claude/skills/
      rules: .claude/rules/
      behaviors: .claude/rules/behaviors/
    native_features:
      cron: true
      agent_teams: true
      tasks: true
      mcp: true
      behaviors: false
      mission_control: false
      daemon: false
    emulation:
      cron: native
      agent_teams: native
      tasks: native
      mcp: native
      behaviors: hooks
      mission_control: aiwg-mc
      daemon: null
    hook_wiring:
      at_link_support: true
      hook_file: AIWG.md
      hook_directive: "@AIWG.md"
      context_file: CLAUDE.md
    # Interactive-question (native UX) capability — consumed by the native-ux-tools
    # rule and steward routing (#1668). `native` => agent may call the tool directly.
    interaction:
      structured_questions: native
      tool: AskUserQuestion
      notes: Always available in the agent tool surface.
    deploy_target: project
    aggregated_output: false
    agent_capabilities:
      default:
        context_window: 200000
        max_output_tokens: 12000
        max_tool_calls: 40
        max_concurrent_subagents: 4
        supports_streaming: true
        million_context_requires_extra_usage: true
        quota_available: false
        recovery:
          context_overflow: retry_with_prefiltered_context
          quota_exhausted: retry_with_standard_context
          timeout: retry_with_smaller_scope
      architecture-designer:
        context_window: 200000
      api-designer:
        context_window: 200000
        notes: Avoid 1M-context model unless extra usage is enabled.
      requirements-analyst:
        context_window: 200000
        notes: Avoid 1M-context model unless extra usage is enabled.

  codex:
    display_name: OpenAI Codex
    byok:
      status: documented
      settings:
        - 'Harness config.toml: model_provider and model select a model_providers entry with base_url, env_key and wire_api = "responses".'
        - 'env_key names an environment variable; inject its value from the environment or a secret-store command only.'
      verification: 'After approval, send "Reply with exactly: byok-ok" and check the Codex session log for the resolved model and provider.'
      notes: 'Custom providers require the Responses API; OpenRouter compatibility with the requested model is unverified. Do not copy a Chat Completions configuration.'
      docs: docs/agents/providers/codex.md#wire-protocol
    route_feasibility:
      scope: in
      identity: runtime-configured-only
      evidence: H
      channel: "codex debug models + exec --json -o F thread/turn/item/error event stream"
      fanout: unknown
      probe_budget: { status: authorized, calls: 3, tokens: 50000, authorized_by: operator, authorized_at: "2026-10-07", hosts: [titan, noodle] }
      coverage:
        profile_issue: "roctinam/aiwg#2897"
        source_date: "2026-10-08"
        live_qualified: false
        sources:
          - "host-help: codex-cli 0.161.0 on titan (--version/--help only); `codex mcp-server --help` still prints root help"
          - "tools/ralph-external/lib/codex-adapter.mjs"
    aliases:
      - openai
    status: stable
    daemon_tier: unsupported
    daemon_pty_adapter: false
    artifact_paths:
      agents: .codex/agents/
      commands: "~/.codex/prompts/"
      # Project-local .agents/skills/ is the cross-provider canonical path
      # codex-rs scans (codex-rs/core-skills/src/loader.rs). The legacy
      # ~/.codex/skills/ home dir is deprecated and pruned on deploy — writing
      # both made codex list every kernel skill twice (#766 regression fix).
      skills: .agents/skills/
      skills_legacy_deprecated: "~/.codex/skills/"
      rules: .codex/rules/
      behaviors: .codex/rules/behaviors/
    native_features:
      cron: false
      agent_teams: false
      tasks: false
      mcp: false
      behaviors: false
      mission_control: false
      daemon: false
    emulation:
      cron: external-trigger
      agent_teams: aiwg-mc
      tasks: aiwg-mc
      mcp: null
      behaviors: aiwg-mc
      mission_control: aiwg-mc
      daemon: null
    hook_wiring:
      at_link_support: false
      hook_file: AIWG-codex.md
      fallback: full-inject
      context_file: CODEX.md
    # Interactive-question (native UX) capability — see native-ux-tools rule (#1668).
    # Agent-initiated `request_user_input` is mode-gated and OFF by default
    # (feature `default_mode_request_user_input`, "under development"); MCP elicitation
    # (`tool_call_mcp_elicitation`, stable) is the server-initiated structured path.
    interaction:
      structured_questions: mode_gated
      tool: request_user_input
      feature_flag: default_mode_request_user_input
      default_available: false
      mcp_elicitation: stable
      fallback: markdown
      notes: >-
        In Default mode the agent has no interactive-question tool; falls back to
        formatted markdown. Structured forms reach the user via MCP elicitation.
    deploy_target: mixed
    aggregated_output: true
    agent_capabilities:
      default:
        context_window: 200000
        max_output_tokens: 12000
        max_tool_calls: 40
        max_concurrent_subagents: 4
        supports_streaming: true
        million_context_requires_extra_usage: false
        quota_available: true
        recovery:
          context_overflow: retry_with_prefiltered_context
          quota_exhausted: retry_with_different_model
          timeout: retry_with_smaller_scope

  copilot:
    display_name: GitHub Copilot
    byok:
      status: verified
      settings:
        - 'COPILOT_PROVIDER_BASE_URL=https://openrouter.ai/api/v1'
        - 'COPILOT_PROVIDER_TYPE=openai'
        - 'COPILOT_MODEL=qwen/qwen3.8-27b'
        - 'Key: COPILOT_PROVIDER_API_KEY environment variable or COPILOT_PROVIDER_API_KEY_COMMAND secret-store command.'
      verification: 'After approval, send "Reply with exactly: byok-ok" and check the Copilot harness log/session for the resolved model qwen/qwen3.8-27b.'
      notes: 'Operator live run, 2026-11-09 (#4054); harness BYOK settings do not qualify the AIWG direct-worker parser or its cleared-environment profile.'
      docs: docs/providers/copilot-direct.md#bring-your-own-key
    aliases:
      - github-copilot
    route_feasibility:
      scope: in
      identity: runtime-configured-only
      evidence: D
      channel: "copilot -p --output-format json; scoped --allow-tool permissions"
      fanout: unknown
      probe_budget: { status: authorized, calls: 3, tokens: 30000, authorized_by: operator, authorized_at: "2026-10-07", hosts: [titan, noodle] }
      coverage:
        profile_issue: "roctinam/aiwg#2901"
        source_date: "2026-10-08"
        live_qualified: false
        sources:
          - "https://docs.github.com/en/copilot/reference/copilot-cli-reference/cli-programmatic-reference"
    status: stable
    daemon_tier: unsupported
    daemon_pty_adapter: false
    artifact_paths:
      agents: .github/agents/
      commands: .github/agents/
      skills: .github/skills/
      rules: .github/copilot-rules/
      behaviors: .github/instructions/aiwg-behaviors/
    native_features:
      cron: false
      agent_teams: false
      tasks: false
      mcp: false
      behaviors: false
      mission_control: false
      daemon: false
    emulation:
      cron: null
      agent_teams: aiwg-mc
      tasks: aiwg-mc
      mcp: null
      behaviors: aiwg-mc
      mission_control: aiwg-mc
      daemon: null
    hook_wiring:
      at_link_support: false
      hook_file: AIWG-copilot.md
      fallback: full-inject
      context_file: .github/copilot-instructions.md
    deploy_target: project
    aggregated_output: false

  factory:
    display_name: Factory AI
    byok:
      status: verified
      settings:
        - 'Harness-owned BYOK custom models: select the exact registered custom: model ID with droid exec -m <custom-model-id>.'
        - 'Use only harness-supported environment or secret-store command injection at point of use; if the installed harness requires a plaintext apiKey in settings.json, stop and choose a secure route with the operator.'
      verification: 'After approval, send "Reply with exactly: byok-ok" on stdin and inspect the Droid session for the resolved model and reasoning_effort none.'
      notes: 'Operator live run, 2026-11-09 (#4054): -r reasoning effort is ignored for custom models. Copy the custom: selector from the harness model listing, not the upstream API ID or display name. #3969: heavy/medium/light aliases are rejected; use full built-in IDs for built-in models.'
      docs: docs/providers/factory-direct.md#bring-your-own-key
    aliases:
      - factory-ai
    route_feasibility:
      scope: in
      identity: runtime-configured-only
      evidence: R
      channel: "droid exec --output-format stream-json; terminal parser to qualify"
      fanout: unknown
      probe_budget: { status: authorized, calls: 3, tokens: 30000, authorized_by: operator, authorized_at: "2026-10-07", hosts: [titan, noodle] }
      coverage:
        profile_issue: "roctinam/aiwg#2902"
        source_date: "2026-10-07"
        live_qualified: false
        sources:
          - "tools/ralph-external/lib/factory-adapter.mjs"
    status: stable
    # droid CLI runs headless via `droid exec`; AIWG daemon provides persistence layer
    daemon_tier: unsupported
    daemon_pty_adapter: false
    artifact_paths:
      agents: .factory/droids/
      commands: .factory/commands/
      skills: .factory/skills/
      rules: .factory/rules/
      behaviors: .factory/rules/behaviors/
    native_features:
      cron: false
      agent_teams: true       # Missions (multi-agent orchestration)
      tasks: true             # Task tool for subagent delegation
      mcp: true               # Native MCP support (stdio + HTTP transports)
      behaviors: false
      mission_control: true   # Factory Missions maps to MC concept
      daemon: false
    emulation:
      cron: null
      agent_teams: null       # native Missions
      tasks: null             # native Task tool
      mcp: null               # native MCP
      behaviors: aiwg-mc
      mission_control: null   # native Missions
      daemon: null
    hook_wiring:
      at_link_support: false
      hook_file: AIWG-factory.md
      fallback: full-inject
      context_file: AGENTS.md
    deploy_target: project
    aggregated_output: false

  cursor:
    display_name: Cursor IDE
    route_feasibility:
      scope: in
      identity: runtime-configured-only
      evidence: D
      channel: "agent -p --output-format json; sandbox/permission profile to qualify"
      fanout: unknown
      probe_budget: { status: authorized, calls: 3, tokens: 30000, authorized_by: operator, authorized_at: "2026-10-07", hosts: [titan, noodle] }
      coverage:
        profile_issue: "roctinam/aiwg#2903"
        source_date: "2026-10-08"
        live_qualified: false
        sources:
          - "https://cursor.com/docs/cli/overview"
          - "https://cursor.com/docs/cli/reference/output-format"
    status: stable
    # Cursor requires a display server (VS Code extension host) — daemon not supported
    daemon_tier: unsupported
    daemon_pty_adapter: false
    artifact_paths:
      agents: .cursor/agents/
      commands: .cursor/commands/
      skills: .cursor/skills/
      rules: .cursor/rules/
      behaviors: .cursor/rules/behaviors/
    native_features:
      cron: false
      agent_teams: false
      tasks: false
      mcp: false
      behaviors: false
      mission_control: false
      daemon: false
    emulation:
      cron: null
      agent_teams: aiwg-mc
      tasks: aiwg-mc
      mcp: null
      behaviors: aiwg-mc
      mission_control: aiwg-mc
      daemon: null
    hook_wiring:
      at_link_support: true
      hook_file: AIWG-cursor.md
      hook_directive: "@AIWG-cursor.md"
      context_file: .cursorrules
    deploy_target: project
    aggregated_output: false

  opencode:
    display_name: OpenCode
    byok:
      status: verified
      settings:
        - 'Key: OPENROUTER_API_KEY environment variable; OpenRouter provider is harness-owned.'
        - 'Model: opencode run -m openrouter/qwen/qwen3.8-27b (provider-prefixed model selector).'
      verification: 'After approval, send "Reply with exactly: byok-ok" and inspect the OpenCode log/session for the resolved model qwen/qwen3.8-27b under openrouter.'
      notes: 'Operator live run, 2026-11-09 (#4054); this guidance does not change AIWG worker environment allowlists or qualify direct dispatch.'
      docs: docs/providers/opencode-direct.md#bring-your-own-key
    route_feasibility:
      scope: in
      identity: runtime-configured-only
      evidence: R
      channel: "opencode run --format json; JSONL framing to qualify"
      fanout: unknown
      probe_budget: { status: authorized, calls: 3, tokens: 30000, authorized_by: operator, authorized_at: "2026-10-07", hosts: [titan, noodle] }
      coverage:
        profile_issue: "roctinam/aiwg#2904"
        source_date: "2026-10-07"
        live_qualified: false
        sources:
          - "tools/ralph-external/lib/opencode-adapter.mjs"
          - "https://opencode.ai/docs/cli/"
    status: stable
    daemon_tier: unsupported
    daemon_pty_adapter: false
    artifact_paths:
      agents: .opencode/agent/
      commands: .opencode/command/
      skills: .opencode/skill/
      rules: .opencode/rule/
      behaviors: .opencode/rule/behaviors/
    native_features:
      cron: false
      agent_teams: false
      tasks: false
      mcp: false
      behaviors: false
      mission_control: false
      daemon: false
    emulation:
      cron: null
      agent_teams: aiwg-mc
      tasks: aiwg-mc
      mcp: null
      behaviors: aiwg-mc
      mission_control: aiwg-mc
      daemon: null
    hook_wiring:
      at_link_support: true
      hook_file: AIWG-opencode.md
      hook_directive: "@AIWG-opencode.md"
      context_file: .opencode/context.md
    deploy_target: project
    aggregated_output: false

  warp:
    display_name: Warp Terminal
    route_feasibility:
      scope: in
      identity: runtime-configured-only
      evidence: D
      channel: "oz agent run --prompt/--model/--cwd/--profile; stdout capture"
      fanout: unknown
      probe_budget: { status: authorized, calls: 3, tokens: 30000, authorized_by: operator, authorized_at: "2026-10-07", hosts: [titan, noodle] }
      coverage:
        profile_issue: "roctinam/aiwg#2905"
        source_date: "2026-10-08"
        live_qualified: false
        sources:
          - "https://docs.warp.dev/agents/cli/oz-cli/"
    status: stable
    daemon_tier: unsupported
    daemon_pty_adapter: false
    artifact_paths:
      agents: .warp/agents/
      commands: .warp/commands/
      skills: .warp/skills/
      skills_cross_agent: .agents/skills/
      rules: .warp/rules/
      behaviors: .warp/rules/behaviors/
    native_features:
      cron: false
      agent_teams: false
      tasks: false
      mcp: false
      behaviors: false
      mission_control: false
      daemon: false
    emulation:
      cron: null
      agent_teams: aiwg-mc
      tasks: aiwg-mc
      mcp: null
      behaviors: aiwg-mc
      mission_control: aiwg-mc
      daemon: null
    hook_wiring:
      at_link_support: true
      hook_file: AIWG-warp.md
      hook_directive: "@AIWG-warp.md"
      context_file: WARP.md
    deploy_target: project
    aggregated_output: true

  windsurf:
    display_name: Devin Desktop
    aliases:
      - devin
      - devin-desktop
      - devin-local
      - cascade
    route_feasibility:
      scope: out
      identity: unavailable
      evidence: R
      channel: "none - no verified headless Desktop worker command; recheck B-OG-47"
      fanout: unknown
      probe_budget: { status: authorized, calls: 1, tokens: 0, authorized_by: operator, authorized_at: "2026-10-07", hosts: [titan, noodle] }
      coverage:
        profile_issue: null
        source_date: "2026-10-08"
        live_qualified: false
        sources:
          - "src/providers/provider-definitions.ts#windsurf"
          - "https://docs.devin.ai/cli/reference/commands.md"
          - "https://docs.devin.ai/_llms/en/desktop.md"
        exclusion_gap: "Devin Desktop documents no headless worker command and no worker-serving MCP tool; its MCP settings configure clients, IDE startup is not inference."
        recheck: "Rechecked 2026-10-08: Desktop unchanged, still OUT. Devin CLI documents `devin -p/--print`, `--model`, `--prompt-file`, `--permission-mode` and `--sandbox` (no JSON output or effort flag found; `devin acp` is ACP, `devin mcp` manages client servers). Devin CLI stays a distinct future-provider surface, not a windsurf alias, until registry support exists."
    status: stable
    # Devin Desktop uses the Windsurf compatibility surface and requires a VS Code host — daemon not supported
    daemon_tier: unsupported
    daemon_pty_adapter: false
    artifact_paths:
      agents: .windsurf/agents/
      commands: .windsurf/workflows/
      skills: .windsurf/skills/
      skills_cross_agent: .agents/skills/
      rules: .windsurf/rules/
      behaviors: .windsurf/rules/behaviors/
    native_features:
      cron: false
      agent_teams: false
      tasks: false
      mcp: false
      behaviors: false
      mission_control: false
      daemon: false
    emulation:
      cron: null
      agent_teams: aiwg-mc
      tasks: aiwg-mc
      mcp: null
      behaviors: aiwg-mc
      mission_control: aiwg-mc
      daemon: null
    hook_wiring:
      at_link_support: false
      hook_file: AIWG-windsurf.md
      fallback: full-inject
      context_file: AGENTS.md
    deploy_target: project
    aggregated_output: true

  grokbot:
    display_name: Grok Bot
    route_feasibility:
      scope: out
      identity: unavailable
      evidence: R
      channel: "none - desktop CreateAgent is not a headless subprocess contract; recheck B-OG-47"
      fanout: unknown
      probe_budget: { status: authorized, calls: 1, tokens: 0, authorized_by: operator, authorized_at: "2026-10-07", hosts: [titan, noodle] }
      coverage:
        profile_issue: null
        source_date: "2026-10-08"
        live_qualified: false
        sources:
          - "src/providers/provider-definitions.ts#grokbot"
          - "https://docs.x.ai/grok-bot/overview.md"
          - "https://docs.x.ai/grok-bot/skills-routines-and-automations.md"
          - "https://docs.x.ai/grok-bot/computer-and-apps.md"
          - "https://docs.x.ai/grok-bot/faq.md"
        exclusion_gap: "Grok Bot runs Bots on xAI-hosted computers driven from desktop/mobile chat, routines and connectors; no documented local CLI, headless subprocess or worker-serving MCP tool."
        recheck: "Rechecked 2026-10-08 against the official Grok Bot docs: no change, still OUT. Third-party bridges are not official interfaces and were not evaluated; desktop CreateAgent names are never synthesized into a command."
    status: stable
    # Multi-agent desktop assistant runtime. Distinct from Cursor IDE and from
    # xAI Grok Build / API. Native skill root is operator-configured via
    # AIWG_GROKBOT_SKILLS_DIR (fail-closed; no invented ~/.grokbot).
    # ADR: docs/architecture/adr-grokbot-provider-target.md · epic #196.
    # Optional natives (routines/CreateAgent/connectors) deferred #209 — does not block stable.
    # #210: stable via Linux PUW + security + migration + maintainer waiver (no macOS/Windows gate).
    daemon_tier: unsupported
    daemon_pty_adapter: false
    artifact_paths:
      agents: "Indexed: aiwg discover / aiwg show agent"   # native CreateAgent teammates are Grok-owned (#209)
      commands: "Indexed: aiwg discover / aiwg show command"
      skills: "AIWG_GROKBOT_SKILLS_DIR when configured (fail-closed)"
      skills_cross_agent: "AIWG_GROKBOT_SKILLS_DIR/.aiwg/skills with --copy-all"
      rules: "Indexed: aiwg show rule + AGENTS.md discover-first bridge"
      behaviors: "Unsupported as automatic AIWG artifact; map manually to Grok routines (#209)"
    native_features:
      cron: true            # Grok routines — capability present; AIWG does not own the clock
      agent_teams: true     # CreateAgent/teammates — Grok-owned orchestration
      tasks: false          # no verified separate task contract
      mcp: true             # connectors/dynamic tools — capability; AIWG MCP install deferred #209
      behaviors: false
      mission_control: false
      daemon: false
    emulation:
      cron: null
      agent_teams: null
      tasks: aiwg-mc
      mcp: null
      behaviors: aiwg-mc
      mission_control: aiwg-mc
      daemon: null
    hook_wiring:
      at_link_support: false
      hook_file: null
      fallback: full-inject
      context_file: AGENTS.md
    deploy_target: mixed
    aggregated_output: false

  grok-build:
    display_name: Grok Build
    route_feasibility:
      scope: in
      identity: runtime-configured-only
      evidence: R
      channel: "grok -p --output-format streaming-json; 1.0.77 captures: headless/ACP parser contracts, workflow fan-out bypass; combined deny flags rendered (live enforcement and model/effort pins unverified)"
      fanout: unknown
      probe_budget: { status: authorized, calls: 3, tokens: 30000, authorized_by: operator, authorized_at: "2026-10-07", hosts: [titan, noodle] }
      coverage:
        profile_issue: "roctinam/aiwg#2906"
        source_date: "2026-10-07"
        live_qualified: false
        sources:
          - "src/providers/grok-build-headless.ts"
          - "test/unit/providers/grok-build-headless.test.ts"
          - "test/unit/providers/grok-build-acp.test.ts"
          - "test/unit/providers/grok-build-dispatch.test.ts"
          - "test/conformance/orchestration-v1/grok-build-direct.test.ts"
    status: experimental
    # xAI Grok Build CLI/TUI. Distinct from Grok Bot (`grokbot`).
    # #2577: every claim and its limits are recorded in
    # docs/providers/grok-build-native-agents.md (1.0.77 evidence table).
    # Captured headless shapes: test/unit/providers/grok-build-headless.test.ts.
    # 2026-11-10 1.0.77: captured-20261110 fixtures replayed by the tests above.
    # Default headless cancels spawn_subagent/workflow: "a headless run cannot ask
    # for approval". --allow spawn_subagent did not cover them; permission-mode auto
    # ran them. AIWG permission defaults stay unchanged (no automatic approval).
    # --no-subagents alone still permits workflow-spawned children. All AIWG leaf
    # argv builders also deny workflow with --disallowed-tools workflow; combined
    # live flag enforcement is unverified, so route_feasibility.fanout stays unknown.
    # Native -w is a standalone copy under ~/.grok/worktrees/<slug>/<name>, NOT a
    # git worktree; list --json ownership/recovery metadata parsing is fixture-backed
    # in grok-build-dispatch.test.ts. AIWG isolation still uses its own detached Git
    # worktree and never edits the user's working files (synthetic dispatch test).
    # ACP authMethods, logged-in session/new amid _x.ai/* notifications, end_turn
    # _meta usage, compact/summary notifications and cancelled/MidTurnAbort are
    # fixture-backed in grok-build-acp.test.ts; live ACP dispatch remains deferred.
    # 2026-11-10 set-b: project .grok/agents/*.md discovery and ignored model pins
    # replayed by grok-build-provider.test.ts with captured-20261110/native-agents.json.
    # Only name/description frontmatter is emitted; role/tier intent lives in the
    # body, not model pins. User-scope mirroring is offline-tested in grok-build-use.test.ts.
    # Resident lifecycle remains unverified.
    daemon_tier: unsupported
    daemon_pty_adapter: false
    artifact_paths:
      agents: .grok/agents/  # captured project discovery; grok-build-provider.test.ts
      commands: null
      skills: .grok/skills/
      skills_cross_agent: .grok/.aiwg/skills/  # --copy-all opt-in mirror
      rules: "Indexed: aiwg show rule + AGENTS.md / host .grok/rules (AIWG writer deferred #2577)"
      behaviors: null
    native_features:
      cron: false          # unverified: needs recurring-loop execution capture
      agent_teams: false   # unverified: needs team lifecycle capture
      tasks: false         # unverified: headless tool calls do not prove background task lifecycle
      mcp: true            # fixture-backed config only: grok-build-native-integration.test.ts; live MCP unverified
      behaviors: false     # unverified: needs behavior registration/execution capture
      mission_control: false # unverified: needs mission lifecycle capture
      daemon: false        # deferred: ACP frame replay is not resident lifecycle qualification (grok-build-acp.test.ts)
    emulation:
      cron: null
      agent_teams: aiwg-mc
      tasks: aiwg-mc
      mcp: null
      behaviors: aiwg-mc
      mission_control: aiwg-mc
      daemon: null
    hook_wiring:
      at_link_support: false
      hook_file: null
      fallback: full-inject
      context_file: AGENTS.md
    deploy_target: mixed
    aggregated_output: false

  hermes:
    display_name: Hermes
    byok:
      status: verified
      settings:
        - 'Key: OPENROUTER_API_KEY environment variable.'
        - 'Provider/model: hermes chat --provider openrouter -m qwen/qwen3.8-27b; never rely on auto provider selection.'
      verification: 'After approval, send "Reply with exactly: byok-ok" and inspect the Hermes log/session for the resolved model qwen/qwen3.8-27b under openrouter.'
      notes: 'Operator live run, 2026-11-09 (#4054); manual CLI guidance does not change the AIWG direct-worker cleared environment or its dispatch status.'
      docs: docs/providers/hermes-direct.md#bring-your-own-key
    route_feasibility:
      scope: in
      identity: runtime-configured-only
      evidence: H
      channel: "hermes -z plain final + --usage-file; session-filtered log binding"
      fanout: unknown
      probe_budget: { status: authorized, calls: 3, tokens: 30000, authorized_by: operator, authorized_at: "2026-10-07", hosts: [titan, noodle] }
      coverage:
        profile_issue: "roctinam/aiwg#2912"
        source_date: "2026-10-07"
        live_qualified: false
        sources:
          - "host-help: hermes 0.20.6 on titan (2026-10-07 observation; not rechecked in this pass)"
          - "/usr/local/lib/hermes-agent/mcp_serve.py"
    status: stable
    daemon_tier: unsupported
    daemon_pty_adapter: false
    artifact_paths:
      # MCP is OPTIONAL for Hermes (validated v2026.5.13, #1527): it integrates
      # like Claude Code / Codex via file deploy + aiwg discover/show + AGENTS.md
      # bridge. The "MCP:" entries below are the optional enrichment path, not a
      # requirement. Broader MCP modernization: #1533.
      agents: AGENTS.md
      commands: "Indexed: aiwg discover / aiwg show command (MCP command-run optional)"
      skills: "~/.hermes/skills/"
      skills_cross_agent: "~/.hermes/skills/.aiwg/"
      rules: "AGENTS.md ### Rule sections + aiwg show rule (MCP rule-list/rule-show optional)"
      behaviors: .hermes/behaviors/
    native_features:
      cron: false
      agent_teams: false
      tasks: false
      mcp: true
      behaviors: false
      mission_control: false
      daemon: false
    emulation:
      cron: null
      agent_teams: aiwg-mc
      tasks: aiwg-mc
      mcp: native
      behaviors: aiwg-mc
      mission_control: aiwg-mc
      daemon: null
    hook_wiring:
      at_link_support: false
      hook_file: .hermes.md
      fallback: full-inject
      context_file: AGENTS.md
    deploy_target: mixed
    aggregated_output: true

  muse:
    display_name: Muse Code
    byok:
      status: unverified
      settings:
        - 'Muse --provider / --model and harness settings select catalog models; an OpenRouter key setting is unverified. Do not invent an environment variable or endpoint flag.'
      verification: 'First confirm upstream BYOK support without a paid call; after explicit approval of a supported route, send "Reply with exactly: byok-ok" and check the Muse session log for the resolved model.'
      notes: 'Existing Muse notes cover the Meta model catalog only. Offer a verified Hermes, OpenCode or Copilot route when OpenRouter is required.'
      docs: docs/agents/providers/muse.md
    route_feasibility:
      scope: in
      identity: runtime-configured-only
      evidence: H
      channel: "model-catalog JSON + exec --json invocation-bound session logs"
      fanout: unknown
      probe_budget: { status: authorized, calls: 3, tokens: 30000, authorized_by: operator, authorized_at: "2026-10-07", hosts: [titan, noodle] }
      coverage:
        profile_issue: "roctinam/aiwg#2898"
        source_date: "2026-10-08"
        live_qualified: false
        sources:
          - "host-help: Muse Code 1.4.4 (1.4.4-R5419.1) on titan (--version/--help only)"
          - "tools/ralph-external/lib/muse-adapter.mjs"
          - "test/fixtures/providers/muse/direct-manifest.json (synthetic only; strict finals/live controls remain unqualified)"
          - "docs/providers/muse-ralph-exec.md (manual smoke run and S1 blockers)"
    status: stable
    # Meta's terminal/CI coding agent (Muse Spark-powered). Explicitly not a
    # model-API surface: Glimmer/Image/Voice are out of scope.
    # Skill writer (.agents/skills + XDG user root), discover-first AGENTS.md
    # bridge, managed .muse/hooks.json, and opt-in MCP settings profile.
    # ADR: docs/architecture/adr-muse-provider-target.md · epic #223.
    # #231: promoted stable — Linux PUW + security review; maintainer Linux-only waiver 2026-10-02.
    daemon_tier: unsupported
    daemon_pty_adapter: false
    artifact_paths:
      agents: "Indexed: aiwg discover / aiwg show agent (native writer deferred)"
      commands: null
      # Project root is fixed; the user root resolves at deploy time from
      # XDG_CONFIG_HOME (default ~/.config/muse/skills when unset). Never
      # advertise ~/.muse as a skill root, and never silently mirror into
      # ~/.agents/skills (#226).
      skills: .agents/skills/
      skills_cross_agent: null
      rules: "Indexed: aiwg show rule + AGENTS.md discover-first bridge"
      behaviors: null
    native_features:
      cron: false
      agent_teams: false
      tasks: false
      mcp: true
      behaviors: false
      mission_control: false
      daemon: false
    emulation:
      cron: null
      agent_teams: null
      tasks: aiwg-mc
      mcp: null
      behaviors: aiwg-mc
      mission_control: aiwg-mc
      daemon: null
    hook_wiring:
      at_link_support: false
      hook_file: .muse/hooks.json
      fallback: full-inject
      context_file: AGENTS.md
    deploy_target: mixed
    aggregated_output: false

  openclaw:
    display_name: OpenClaw
    route_feasibility:
      scope: in
      identity: runtime-configured-only
      evidence: D
      channel: "openclaw agent exec --json; workspace/settings mapping to qualify"
      fanout: unknown
      probe_budget: { status: authorized, calls: 3, tokens: 30000, authorized_by: operator, authorized_at: "2026-10-07", hosts: [titan, noodle] }
      coverage:
        profile_issue: "roctinam/aiwg#2907"
        source_date: "2026-10-08"
        live_qualified: false
        sources:
          - "https://docs.openclaw.ai/cli/agent"
    status: stable
    daemon_tier: unsupported
    daemon_pty_adapter: false
    artifact_paths:
      agents: "~/.openclaw/agents/"
      commands: "~/.openclaw/commands/"
      skills: "~/.openclaw/skills/"
      rules: "~/.openclaw/rules/"
      behaviors: "~/.openclaw/behaviors/"
    native_features:
      cron: false
      agent_teams: false
      tasks: false
      mcp: true
      behaviors: true
      mission_control: false
      daemon: false
    emulation:
      cron: null
      agent_teams: aiwg-mc
      tasks: aiwg-mc
      mcp: native
      behaviors: native
      mission_control: aiwg-mc
      daemon: null
    hook_wiring:
      at_link_support: false
      context_file: "~/.openclaw/config.yaml"
    deploy_target: home
    aggregated_output: false

  openhuman:
    display_name: OpenHuman
    aliases:
      - tinyhumansai
    route_feasibility:
      scope: in
      identity: runtime-configured-only
      evidence: D
      channel: "openhuman-core --model M call --method openhuman.agent_chat --params-stdin; conductor-framed params JSON on stdin to EOF, final JSON stdout, no event stream"
      fanout: unknown
      probe_budget: { status: proposed, calls: 3, tokens: 30000 }
      coverage:
        profile_issue: "roctinam/aiwg#2911"
        source_date: "2026-10-08"
        live_qualified: false
        sources:
          - "https://github.com/tinyhumansai/openhuman/blob/216ea322a3c1269dada70751ac5c08eac7dc7596/crates/openhuman-core/src/core/cli.rs"
          - "https://github.com/tinyhumansai/openhuman/blob/216ea322a3c1269dada70751ac5c08eac7dc7596/crates/openhuman-core/src/agent/schemas.rs"
          - "https://github.com/tinyhumansai/openhuman/blob/216ea322a3c1269dada70751ac5c08eac7dc7596/crates/openhuman-core/src/mcp/server/tools/specs.rs"
          - "https://github.com/tinyhumansai/openhuman/releases/tag/v0.64.14"
        recheck: "Rechecked 2026-10-08 and promoted into S1 (doc/source-only, unqualified): `openhuman-core --model M call --method openhuman.agent_chat --params-stdin` reads the `message`, `model_override` and `cwd` params as JSON from stdin until EOF, runs one in-process agent turn and prints the JSON result on stdout; the conductor frames the params from the brief so prompt text never enters argv. Profile pinned to 0.64.14; live qualification is an open S1 blocker (not installed on an authorized host, budget proposed). Effort, step cap, approval/sandbox mapping and child fan-out are unknown. Native `openhuman-core mcp` `agent.run_subagent` takes only `agent_id`/`prompt` (no model, effort or workspace pin) and may nest subagents, so it is not a qualifying worker MCP tool."
    status: experimental
    # tinyhumansai/openhuman — OSS personal-AI runtime (Rust core + Tauri shell).
    # AIWG-convention-aware out of the box (.agents/, AGENTS.md, .claude/, .codex/).
    # Bidirectional: OpenHuman can also DRIVE claude_code/factory as inference
    # backends. Induction epic #1552; agent decision adr-openhuman-agent-target.
    daemon_tier: unsupported
    daemon_pty_adapter: false
    artifact_paths:
      agents: "Indexed: aiwg discover / aiwg show agent"   # native TOML harness agents are opt-in (#1559)
      commands: "Indexed: aiwg discover / aiwg show command"
      skills: "~/.openhuman/skills/"                      # global/home-dir like OpenClaw — ungated user-scope native scan (ops_discover.rs); same root OpenHuman's own installer writes to (#1553)
      skills_cross_agent: "~/.openhuman/.aiwg/skills/"
      rules: "AGENTS.md ### Rule sections + aiwg show rule"
      behaviors: "(not supported)"
    native_features:
      cron: false
      agent_teams: false
      tasks: false
      mcp: false
      behaviors: false
      mission_control: false
      daemon: false
    emulation:
      cron: null
      agent_teams: aiwg-mc
      tasks: aiwg-mc
      mcp: null
      behaviors: aiwg-mc
      mission_control: aiwg-mc
      daemon: null
    hook_wiring:
      at_link_support: false
      context_file: AGENTS.md
    deploy_target: mixed
    aggregated_output: true

  antigravity:
    display_name: Google Antigravity CLI
    route_feasibility:
      scope: in
      identity: runtime-configured-only
      evidence: R
      channel: "agy -p stream-json per provider-contract; fixture-qualified flags only"
      fanout: unknown
      probe_budget: { status: authorized, calls: 3, tokens: 30000, authorized_by: operator, authorized_at: "2026-10-07", hosts: [titan, noodle] }
      coverage:
        profile_issue: "roctinam/aiwg#2908"
        source_date: "2026-10-07"
        live_qualified: false
        sources:
          - "agentic/code/providers/antigravity/provider-contract.v1.json"
          - "https://antigravity.google/docs/cli/headless/"
    aliases:
      - agy
    status: experimental
    executable: agy
    qualified_version: 1.1.26
    qualification_evidence: agentic/code/providers/antigravity/provider-contract.v1.json
    daemon_tier: unsupported
    daemon_pty_adapter: false
    artifact_paths:
      agents: .agents/agents/
      commands: "(not deployed; no qualified native command surface)"
      skills: .agents/skills/
      rules: AGENTS.md
      behaviors: "(not supported)"
      mcp_project: .agents/mcp_config.json
      mcp_user: "~/.gemini/config/mcp_config.json"
    native_features:
      cron: false
      agent_teams: false
      tasks: false
      mcp: true
      behaviors: false
      mission_control: false
      daemon: false
    emulation:
      cron: external-trigger
      agent_teams: aiwg-mc
      tasks: aiwg-mc
      mcp: native
      behaviors: null
      mission_control: aiwg-mc
      daemon: null
    hook_wiring:
      at_link_support: false
      fallback: full-inject
      context_file: AGENTS.md
    interaction:
      structured_questions: none
      fallback: markdown
      notes: No stable structured-question tool contract was qualified for CLI 1.1.26.
    deploy_target: project
    aggregated_output: false

  deepseek-harness:
    display_name: DeepSeek Harness
    route_feasibility:
      scope: in
      identity: runtime-configured-only
      evidence: R
      channel: "dsh --profile headless + validated Cordis route patch; no guessed --model flag"
      fanout: unknown
      probe_budget: { status: authorized, calls: 3, tokens: 30000, authorized_by: operator, authorized_at: "2026-10-07", hosts: [titan, noodle] }
      coverage:
        profile_issue: "roctinam/aiwg#2909"
        source_date: "2026-10-07"
        live_qualified: false
        sources:
          - "tools/ralph-external/lib/deepseek-harness-adapter.mjs"
    aliases:
      - dsh
    status: experimental
    daemon_tier: unsupported
    daemon_pty_adapter: false
    artifact_paths:
      agents: .agents/skills/
      commands: null
      skills: .agents/skills/
      rules: AGENTS.md
      behaviors: null
      cordis_patch: .dsh/aiwg.cordis.patch.yml
    native_features:
      cron: false
      agent_teams: true
      tasks: true
      mcp: true
      behaviors: true
      mission_control: false
      daemon: false
    emulation:
      cron: external-trigger
      agent_teams: native
      tasks: native
      mcp: native
      behaviors: null
      mission_control: aiwg-mc
      daemon: null
    hook_wiring:
      at_link_support: false
      fallback: full-inject
      context_file: AGENTS.md
      max_bytes: 65536
    interaction:
      structured_questions: none
      fallback: markdown
      notes: Headless and SDK profiles do not expose an interactive question UI.
    deploy_target: project
    aggregated_output: false

  flue:
    display_name: Flue (experimental)
    status: experimental
    route_feasibility:
      scope: out
      identity: unavailable
      evidence: R
      channel: "none - Flue 2.3.0 app target; no worker dispatch (#3120 D6)"
      coverage:
        profile_issue: null
        source_date: "2026-10-30"
        live_qualified: false
        exclusion_gap: "Flue run accepts prompts in argv and lacks worker model/effort flags; app deployment only."
        recheck: "Rechecked 2026-10-30 against installed Flue 2.3.0 source; #3120 D6 excludes worker dispatch."
        sources:
          - "tools/agents/providers/flue.mjs"
          - "docs/providers/flue.md"
          - "https://flueframework.com/docs/"
      fanout: unknown
      probe_budget: { status: proposed, calls: 0, tokens: 0 }
    daemon_tier: unsupported
    daemon_pty_adapter: false
    artifact_paths:
      agents: ""
      commands: ""
      skills: .agents/skills/
      rules: AGENTS.md
      behaviors: null
    native_features:
      cron: false
      agent_teams: false
      tasks: false
      mcp: false
      behaviors: false
      mission_control: false
      daemon: false
    emulation:
      cron: null
      agent_teams: null
      tasks: null
      mcp: null
      behaviors: null
      mission_control: null
      daemon: null
    hook_wiring:
      at_link_support: false
      fallback: full-inject
      context_file: AGENTS.md
    deploy_target: project
    aggregated_output: false

  pi:
    display_name: Pi Coding Agent
    route_feasibility:
      scope: in
      identity: runtime-configured-only
      evidence: R
      channel: "pi --mode json --model/--thinking/--tools; closed stdin, no RPC abort"
      fanout: unknown
      probe_budget: { status: authorized, calls: 3, tokens: 30000, authorized_by: operator, authorized_at: "2026-10-07", hosts: [titan, noodle] }
      coverage:
        profile_issue: "roctinam/aiwg#2910"
        source_date: "2026-10-07"
        live_qualified: false
        sources:
          - "tools/ralph-external/lib/pi-adapter.mjs"
    aliases:
      - pi-coding-agent
    status: experimental
    daemon_tier: unsupported
    daemon_pty_adapter: false
    artifact_paths:
      agents: .agents/skills/
      commands: .pi/prompts/
      skills: .pi/skills/
      skills_cross_agent: .agents/skills/
      rules: AGENTS.md
      behaviors: .pi/extensions/
    native_features:
      cron: false
      agent_teams: false
      tasks: false
      mcp: false
      behaviors: true
      mission_control: false
      daemon: false
    emulation:
      cron: external-trigger
      agent_teams: aiwg-mc
      tasks: aiwg-mc
      mcp: null
      behaviors: null
      mission_control: aiwg-mc
      daemon: null
    hook_wiring:
      at_link_support: false
      fallback: full-inject
      context_file: AGENTS.md
    interaction:
      structured_questions: none
      fallback: markdown
      notes: Pi does not expose a built-in structured question tool.
    deploy_target: project
    aggregated_output: false

  omp:
    display_name: Oh My Pi
    route_feasibility:
      scope: in
      identity: runtime-configured-only
      evidence: R
      channel: "omp --mode json --model/--thinking/--profile; --no-tools for text-only"
      fanout: unknown
      probe_budget: { status: authorized, calls: 3, tokens: 30000, authorized_by: operator, authorized_at: "2026-10-07", hosts: [titan, noodle] }
      coverage:
        profile_issue: "roctinam/aiwg#2910"
        source_date: "2026-10-07"
        live_qualified: false
        sources:
          - "tools/ralph-external/lib/omp-adapter.mjs"
    aliases:
      - oh-my-pi
    status: experimental
    daemon_tier: unsupported
    daemon_pty_adapter: false
    artifact_paths:
      agents: .omp/agents/
      commands: .omp/prompts/
      skills: .agents/skills/
      skills_cross_agent: .agents/skills/
      rules: .omp/rules/
      behaviors: .omp/extensions/
    native_features:
      cron: false
      agent_teams: true
      tasks: true
      mcp: true
      behaviors: true
      mission_control: false
      daemon: false
    emulation:
      cron: external-trigger
      agent_teams: null
      tasks: null
      mcp: null
      behaviors: null
      mission_control: aiwg-mc
      daemon: null
    hook_wiring:
      at_link_support: true
      fallback: full-inject
      context_file: .omp/AGENTS.md
    interaction:
      structured_questions: none
      fallback: markdown
      notes: OMP integration uses Markdown questions; native UI questions require an interactive runtime.
    deploy_target: project
    aggregated_output: false

# Feature definitions — documents what each feature key means and
# what emulation strategies are available when native support is absent.
features:
  cron:
    description: Scheduled task execution (recurring triggers)
    native_example: Claude Code CronCreate/CronList/CronDelete tools
    emulation_strategies:
      external-trigger: System cron, systemd timers, or CI own time and launch a reviewed provider command
  agent_teams:
    description: Multi-agent orchestration with team coordination
    native_example: Claude Code native agent teams
    emulation_strategies:
      aiwg-mc: AIWG Mission Control background orchestration
  tasks:
    description: Spawn focused sub-tasks or sub-agents
    native_example: Claude Code Task tool
    emulation_strategies:
      aiwg-mc: AIWG Mission Control dispatch
  mcp:
    description: Model Context Protocol server integration
    native_example: Claude Code MCP tool access
    emulation_strategies: {}
  behaviors:
    description: Reactive capabilities triggered by events (hooks/scripts)
    native_example: OpenClaw behavior directories with BEHAVIOR.md + scripts/
    emulation_strategies:
      hooks: Pre/post-tool hooks as behavior emulation
      aiwg-mc: Background monitoring via Mission Control
  mission_control:
    description: Background multi-task orchestration with monitoring
    native_example: null
    emulation_strategies:
      aiwg-mc: AIWG mc start/dispatch/status/watch CLI
  daemon:
    description: >
      Resident AIWG daemon lifecycle. The current production CLI does not expose
      a daemon command; bundled daemon sources are non-routable development artifacts.
    native_example: null
    emulation_strategies: {}
