agentera 0.0.0 → 3.0.0-dev.0

package/bundle/references/adapters/runtime-adapter-registry.yaml

@@ -0,0 +1,548 @@
+schema_version: agentera.runtimeAdapterRegistry.v1
+runtime_order:
+  - claude
+  - opencode
+  - copilot
+  - codex
+  - cursor
+  - cursor-agent
+records:
+  - identity:
+      runtime_id: claude
+      display_name: Claude Code
+      adapter_family: native-plugin
+      support_status: supported
+    host_detection:
+      binary_names:
+        - claude
+      host_config_locations:
+        - CLAUDE_PLUGIN_ROOT
+      availability_probe_label: runtime_binary
+    lifecycle_events:
+      supported_events:
+        - PreToolUse
+        - PostToolUse
+        - UserPromptSubmit
+        - SessionStart
+        - Stop
+        - SubagentStop
+      unsupported_events: []
+      event_status:
+        PreToolUse: native
+        PostToolUse: native
+        UserPromptSubmit: native
+        SessionStart: native
+        Stop: native
+        SubagentStop: native
+      limitations:
+        - Claude lifecycle behavior is validated through native hook files rather than lifecycle metadata.
+    artifact_validation:
+      validation_events:
+        - PreToolUse
+      hard_gate_claims:
+        - Native hook files can run artifact validation before tool writes.
+      payload_reconstruction_limitations: []
+    subagent_dispatch:
+      mechanism: Claude Code native subagent dispatch
+      setup_targets: []
+      descriptor_sources: []
+      invocation_pattern: Use the host Task/subagent surface with the selected Agentera capability context.
+      tool_configuration: none
+      limitations:
+        - Agentera does not install per-capability Claude descriptors in this package phase.
+    config_targets:
+      runtime_config_files: []
+      hook_targets:
+        - .claude-plugin/marketplace.json
+      plugin_targets:
+        - skills/*/.claude-plugin/plugin.json
+      environment_exports:
+        - CLAUDE_PLUGIN_ROOT
+      write_safety_labels:
+        - Claude Code plugin installs expose the app home without local config writes
+    diagnostics:
+      check_names:
+        - CLAUDE_PLUGIN_ROOT
+      status_labels:
+        - pass
+        - warn
+        - fail
+        - skip
+      gap_labels:
+        - runtime_config
+        - user_environment
+      primary_messages:
+        - runtime can reach shared Agentera helper scripts
+        - Claude Code plugin root is not present in this process environment
+    documentation_claims:
+      reference_paths:
+        - references/adapters/runtime-feature-parity.md
+      parity_claims:
+        - Claude Code uses native plugin and hook surfaces.
+      install_claims:
+        - Claude Code plugin installs expose the app home without local config writes.
+      known_drifts:
+        - Claude lifecycle behavior is validated through native hook files, not lifecycle metadata.
+  - identity:
+      runtime_id: opencode
+      display_name: OpenCode
+      adapter_family: javascript-plugin
+      support_status: supported
+    host_detection:
+      binary_names:
+        - opencode
+      host_config_locations:
+        - OPENCODE_CONFIG_DIR
+        - AGENTERA_HOME
+      availability_probe_label: runtime_binary
+    lifecycle_events:
+      supported_events:
+        - shell.env
+        - chat.message
+        - tool.execute.before
+        - tool.execute.after
+        - experimental.session.compacting
+        - session.created
+        - session.idle
+      unsupported_events: []
+      event_status:
+        shell.env: supported
+        chat.message: supported
+        tool.execute.before: supported
+        tool.execute.after: supported
+        experimental.session.compacting: supported
+        session.created: supported_via_event
+        session.idle: supported_via_event
+      limitations:
+        - OpenCode session preload observes session.created but has no verified context injection path.
+        - OpenCode docs omit chat.message, but the exported plugin Hooks interface defines it.
+        - OpenCode compaction context is bounded to CLI-first Agentera summaries.
+    artifact_validation:
+      validation_events:
+        - tool.execute.before
+      hard_gate_claims:
+        - Conditional hard gate for reconstructable write and edit candidates.
+      payload_reconstruction_limitations:
+        - Sparse payloads and apply_patch patchText without reconstructed full content are allowed.
+    subagent_dispatch:
+      mechanism: OpenCode .opencode/agents descriptors
+      setup_targets:
+        - ~/.config/opencode/agents
+      descriptor_sources:
+        - .opencode/agents/*.md
+      invocation_pattern: Use @<capability> for the installed Agentera capability descriptor.
+      tool_configuration: per_agent_permission
+      limitations:
+        - OpenCode descriptor bootstrap is file-based and preserves user-owned descriptor collisions.
+    config_targets:
+      runtime_config_files:
+        - ~/.config/opencode/plugins/agentera.js
+      hook_targets: []
+      plugin_targets:
+        - .opencode/plugins/agentera.js
+      environment_exports:
+        - AGENTERA_HOME
+      write_safety_labels:
+        - copy-plugin
+        - copy-agent
+    diagnostics:
+      check_names:
+        - plugin_file
+        - AGENTERA_HOME
+        - opencode_managed_commands
+        - opencode_skill_paths
+        - bundled_support_references
+      status_labels:
+        - pass
+        - warn
+        - fail
+        - skip
+      gap_labels:
+        - runtime_config
+        - user_environment
+        - command_drift
+        - skill_path_drift
+        - validation_drift
+      primary_messages:
+        - OpenCode plugin file is present
+        - OpenCode plugin file is not installed at the native plugin path
+        - runtime can reach shared Agentera helper scripts
+        - OpenCode cannot see AGENTERA_HOME or a documented default Agentera app home
+        - OpenCode managed Agentera commands are current
+        - OpenCode managed Agentera commands are missing or stale
+        - OpenCode Agentera skill paths resolve to SKILL.md
+        - OpenCode Agentera skill paths are missing or broken
+        - bundled support references validate separately from installer status
+        - bundled reference validation mismatch found despite installer status
+    documentation_claims:
+      reference_paths:
+        - references/adapters/runtime-feature-parity.md
+        - references/adapters/opencode.md
+      parity_claims:
+        - Blocks invalid reconstructable artifact candidates.
+        - Routes exact bare text hej through chat.message to the bundled Agentera dashboard path.
+      install_claims:
+        - OpenCode plugin is copied to the native plugin path.
+      known_drifts:
+        - OpenCode session preload observes session.created but has no verified context injection path.
+        - OpenCode docs omit chat.message even though the plugin source Hooks interface exposes it.
+  - identity:
+      runtime_id: copilot
+      display_name: Copilot CLI
+      adapter_family: portable-plugin
+      support_status: supported
+    host_detection:
+      binary_names:
+        - copilot
+      host_config_locations:
+        - AGENTERA_HOME
+        - ~/.bashrc
+        - ~/.zshrc
+        - ~/.config/fish/config.fish
+      availability_probe_label: runtime_binary
+    lifecycle_events:
+      supported_events:
+        - sessionStart
+        - sessionEnd
+        - userPromptSubmitted
+        - preToolUse
+        - postToolUse
+        - errorOccurred
+      unsupported_events: []
+      event_status:
+        sessionStart: supported
+        sessionEnd: supported
+        userPromptSubmitted: supported
+        preToolUse: supported
+        postToolUse: supported
+        errorOccurred: supported
+      limitations:
+        - Profilera exposes bounded corpus metadata limits with missing source families.
+    artifact_validation:
+      validation_events:
+        - preToolUse
+      hard_gate_claims:
+        - Conditional hard gate via preToolUse.
+      payload_reconstruction_limitations:
+        - Malformed, sparse, or non-reconstructable toolArgs are allowed.
+    subagent_dispatch:
+      mechanism: Copilot CLI host-managed dispatch
+      setup_targets: []
+      descriptor_sources: []
+      invocation_pattern: Use the host-native agent selection surface when available.
+      tool_configuration: none
+      limitations:
+        - Agentera does not install per-capability Copilot descriptors in this package phase.
+    config_targets:
+      runtime_config_files: []
+      hook_targets:
+        - .github/hooks
+      plugin_targets:
+        - plugin.json
+      environment_exports:
+        - AGENTERA_HOME
+      write_safety_labels:
+        - configure
+    diagnostics:
+      check_names:
+        - AGENTERA_HOME
+      status_labels:
+        - pass
+        - warn
+        - fail
+        - skip
+      gap_labels:
+        - runtime_config
+        - user_environment
+      primary_messages:
+        - runtime can reach shared Agentera helper scripts
+        - Copilot helper access is not configured in the environment or known shell rc files
+        - Copilot rc file is configured; restart the shell to load AGENTERA_HOME
+    documentation_claims:
+      reference_paths:
+        - references/adapters/runtime-feature-parity.md
+      parity_claims:
+        - Copilot supports lifecycle hook JSON files under .github/hooks.
+      install_claims:
+        - Copilot marketplace install path is verified working.
+      known_drifts:
+        - Upgrade package phase currently has no Copilot package command item.
+        - Upgrade runtime configure is noop; shell rc paths in host_detection are doctor diagnostic probes only.
+  - identity:
+      runtime_id: codex
+      display_name: Codex CLI
+      adapter_family: portable-plugin
+      support_status: degraded
+    host_detection:
+      binary_names:
+        - codex
+      host_config_locations:
+        - ~/.codex/config.toml
+      availability_probe_label: runtime_binary
+    lifecycle_events:
+      supported_events:
+        - SessionStart
+        - Stop
+        - UserPromptSubmit
+        - PreToolUse
+        - PostToolUse
+        - PermissionRequest
+      unsupported_events:
+        - SubagentStop
+        - PreCompact
+        - Notification
+      event_status:
+        SessionStart: beta
+        Stop: beta
+        UserPromptSubmit: beta
+        PreToolUse: beta
+        PostToolUse: beta
+        PermissionRequest: beta
+        SubagentStop: unsupported
+      limitations:
+        - codex_hooks status is beta and shipped Agentera wiring intercepts apply_patch validation only; see openai/codex#18391.
+    artifact_validation:
+      validation_events:
+        - PreToolUse
+      hard_gate_claims:
+        - Codex can route pre-tool validation through codex_hooks when configured.
+      payload_reconstruction_limitations:
+        - Shipped config wires apply_patch validation only.
+    subagent_dispatch:
+      mechanism: Codex ~/.codex/agents TOML descriptors
+      setup_targets:
+        - ~/.codex/agents
+      descriptor_sources:
+        - skills/agentera/agents/*.toml
+      invocation_pattern: Use the configured capability agent name through Codex-native subagent dispatch.
+      tool_configuration: global_sandbox_policy
+      limitations:
+        - Codex hook wiring remains limited to apply_patch validation; descriptor dispatch is separate runtime state.
+    config_targets:
+      runtime_config_files:
+        - ~/.codex/config.toml
+      hook_targets:
+        - ~/.codex/hooks.json
+      plugin_targets:
+        - .codex-plugin/plugin.json
+        - .agents/plugins/marketplace.json
+      environment_exports:
+        - AGENTERA_HOME
+      write_safety_labels:
+        - configure
+        - copy-hooks
+        - copy-agent
+    diagnostics:
+      check_names:
+        - config.AGENTERA_HOME
+      status_labels:
+        - pass
+        - warn
+        - fail
+        - skip
+      gap_labels:
+        - runtime_config
+        - user_environment
+      primary_messages:
+        - runtime can reach shared Agentera helper scripts
+        - Codex config cannot provide helper-script access
+    documentation_claims:
+      reference_paths:
+        - references/adapters/runtime-feature-parity.md
+      parity_claims:
+        - Codex supports codex_hooks events but shipped config wires only apply_patch validation.
+      install_claims:
+        - Codex config and hook files are planned as runtime updates.
+      known_drifts:
+        - Codex supports hook events but shipped config wires only apply_patch validation.
+  - identity:
+      runtime_id: cursor
+      display_name: Cursor IDE
+      adapter_family: native-plugin
+      support_status: supported
+    host_detection:
+      binary_names:
+        - cursor
+      host_config_locations:
+        - AGENTERA_HOME
+        - .cursor/hooks.json
+      availability_probe_label: runtime_binary
+    lifecycle_events:
+      supported_events:
+        - sessionStart
+        - sessionEnd
+        - preToolUse
+        - postToolUse
+        - subagentStart
+        - subagentStop
+        - beforeSubmitPrompt
+        - preCompact
+        - stop
+      unsupported_events:
+        - beforeShellExecution
+        - afterShellExecution
+        - beforeMCPExecution
+        - afterMCPExecution
+        - beforeReadFile
+        - afterFileEdit
+      event_status:
+        sessionStart: supported
+        sessionEnd: supported
+        preToolUse: supported
+        postToolUse: supported
+        subagentStart: supported
+        subagentStop: supported
+        beforeSubmitPrompt: supported
+        preCompact: supported
+        stop: supported
+      limitations:
+        - Cloud agents are unsupported in v1; repo hooks and managed agents target local IDE sessions only.
+        - Bare text hej routing is metadata-only; sessionStart injects context but does not rewrite prompts.
+    artifact_validation:
+      validation_events:
+        - preToolUse
+      hard_gate_claims:
+        - Conditional hard gate for reconstructable Write and Edit candidates via preToolUse; verified after live preToolUse Write smoke (2026-05-24).
+      payload_reconstruction_limitations:
+        - Malformed, sparse, or non-reconstructable tool_input payloads are allowed.
+    subagent_dispatch:
+      mechanism: Cursor .cursor/agents descriptors
+      setup_targets:
+        - .cursor/agents
+      descriptor_sources:
+        - .cursor/agents/*.md
+      invocation_pattern: Use the Cursor agent picker or @-mention the installed Agentera capability descriptor.
+      tool_configuration: global_full_access
+      limitations:
+        - Cloud agent sessions do not load project hooks or managed agents in v1.
+    config_targets:
+      runtime_config_files: []
+      hook_targets:
+        - .cursor/hooks.json
+      plugin_targets:
+        - .cursor-plugin/plugin.json
+      environment_exports:
+        - AGENTERA_HOME
+      write_safety_labels:
+        - copy-hooks
+        - copy-agent
+        - copy-plugin
+    diagnostics:
+      check_names:
+        - AGENTERA_HOME
+        - cursor_hooks
+        - cursor_managed_agents
+      status_labels:
+        - pass
+        - warn
+        - fail
+        - skip
+      gap_labels:
+        - runtime_config
+        - user_environment
+        - hook_drift
+        - agent_drift
+      primary_messages:
+        - runtime can reach shared Agentera helper scripts
+        - Cursor hooks.json is present and references Agentera helpers
+        - Cursor hooks.json is missing or stale
+        - Cursor managed capability agents are current
+        - Cursor managed capability agents are missing or stale
+    documentation_claims:
+      reference_paths:
+        - references/adapters/runtime-feature-parity.md
+        - references/adapters/cursor.md
+      parity_claims:
+        - Cursor sessionStart exports AGENTERA_HOME and injects bounded session context.
+        - Cursor preToolUse denies invalid reconstructable artifact candidates; live preToolUse Write smoke passed 2026-05-24.
+      install_claims:
+        - Repo-native .cursor/ surfaces ship in this repository; upgrade installs managed hooks and agents elsewhere.
+      known_drifts:
+        - Release tagging and marketplace publication remain blocked pending broader release closeout despite passed live preToolUse Write smoke.
+        - Cloud agents are unsupported in v1.
+  - identity:
+      runtime_id: cursor-agent
+      display_name: Cursor Agent CLI
+      adapter_family: portable-cli
+      support_status: degraded
+    host_detection:
+      binary_names:
+        - cursor-agent
+        - agent
+      host_config_locations:
+        - AGENTERA_HOME
+        - ~/.bashrc
+        - ~/.zshrc
+        - ~/.config/fish/config.fish
+      availability_probe_label: runtime_binary
+    lifecycle_events:
+      supported_events:
+        - sessionStart
+        - sessionEnd
+        - preToolUse
+        - postToolUse
+      unsupported_events:
+        - subagentStart
+        - subagentStop
+        - beforeSubmitPrompt
+        - preCompact
+        - stop
+      event_status:
+        sessionStart: degraded
+        sessionEnd: degraded
+        preToolUse: degraded
+        postToolUse: degraded
+      limitations:
+        - CLI sessions may not inherit IDE sessionStart env; persistent shell configuration is a fallback only when shell-tool smoke fails.
+        - Non-interactive print mode may hang after completion in some host builds; eval and smoke harnesses use bounded timeouts.
+        - Cloud agents are unsupported in v1.
+    artifact_validation:
+      validation_events:
+        - preToolUse
+      hard_gate_claims:
+        - CLI hook parity is degraded relative to IDE; hard-gate claims follow IDE smoke evidence only.
+      payload_reconstruction_limitations:
+        - CLI may omit hook wiring entirely when launched outside a Cursor workspace with project hooks.
+    subagent_dispatch:
+      mechanism: Cursor Agent CLI host-managed dispatch
+      setup_targets: []
+      descriptor_sources: []
+      invocation_pattern: Use cursor-agent with explicit capability context; managed .cursor/agents descriptors apply only when the workspace is loaded.
+      tool_configuration: global_full_access
+      limitations:
+        - Agentera does not install per-capability cursor-agent descriptors separately from IDE managed agents.
+    config_targets:
+      runtime_config_files: []
+      hook_targets: []
+      plugin_targets: []
+      environment_exports:
+        - AGENTERA_HOME
+      write_safety_labels:
+        - configure
+    diagnostics:
+      check_names:
+        - AGENTERA_HOME
+        - cursor-agent
+      status_labels:
+        - pass
+        - warn
+        - fail
+        - skip
+      gap_labels:
+        - runtime_config
+        - user_environment
+      primary_messages:
+        - runtime can reach shared Agentera helper scripts
+        - cursor-agent binary is not on PATH
+        - cursor-agent helper access depends on AGENTERA_HOME or shell rc configuration
+    documentation_claims:
+      reference_paths:
+        - references/adapters/runtime-feature-parity.md
+        - references/adapters/cursor.md
+      parity_claims:
+        - cursor-agent supports eval_skills --runtime cursor-agent print-mode dispatch.
+      install_claims:
+        - cursor-agent inherits IDE hook wiring only when run inside a workspace with installed Cursor surfaces.
+      known_drifts:
+        - CLI hook and session env parity is degraded relative to Cursor IDE.
+        - Bare text hej routing is metadata-only like Claude, Copilot, and Codex.