Add engine v2 action discovery metadata

[henrypark133]

Summary

• add canonical discovery metadata to ActionDef and expose it through the engine crate
• map registry-backed tool discovery metadata into projected engine-v2 actions and move mission action metadata into a dedicated bridge module
• make engine-v2 tool_info read from the callable action snapshot first so advertised actions like mission_create are discoverable without changing callable exposure policy

Testing

• cargo fmt --all
• cargo test action_projector --lib
• cargo test action_discovery --lib
• cargo test tool_info_reads_callable_action_snapshot_for_engine_native_actions --lib
• cargo test available_actions_surfaces_leased_mission_capability --lib
• cargo test available_actions_respects_partial_lease_grant --lib
• cargo test available_actions_omits_capability_without_lease --lib
• cargo test mission_create_exposes_full_schema_and_curated_summary --lib
• cargo test mission_update_has_curated_summary_but_minimal_actions_do_not --lib
• cargo test --test engine_v2_gate_integration --no-run
• cargo test --test engine_v2_skill_codeact --no-run
• cargo test --test engine_v2_sandbox_integration --no-run

Closes #2793
Part of #2834 and Section 6 of #2767.

[gemini-code-assist]

Code Review

This pull request implements an action discovery system that enables models to retrieve detailed metadata, including curated summaries and schema overrides, through a new tool_info action. Key changes include adding discovery fields to ActionDef, incorporating an available_actions_snapshot into the ThreadExecutionContext, and centralizing mission-related action definitions. Review feedback focuses on centralizing name-matching logic (handling hyphen and underscore normalization) within ActionDef for better consistency and performance, and improving error feedback in the bridge when an action cannot be resolved.

[Copilot]

Pull request overview

This PR adds engine-v2 action discovery metadata so tool_info(...) and prompt surfaces can access canonical discovery names, curated summaries, and (optionally) richer discovery schemas without widening the callable tool surface.

Changes:

• Extended ironclaw_engine::ActionDef with optional ActionDiscoveryMetadata (+ helper methods for discovery name/schema/summary and name alias matching).
• Added bridge-side action discovery plumbing: projected tool-backed actions now carry discovery metadata; mission action metadata moved into a dedicated engine_actions module.
• Updated engine-v2 execution paths to snapshot callable actions into ThreadExecutionContext so tool_info can resolve engine-native actions that aren’t ToolRegistry-backed.

Reviewed changes

Copilot reviewed 30 out of 30 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
tests/engine_v2_skill_codeact.rs	Updates test ActionDef literals to include the new discovery field.
tests/engine_v2_sandbox_integration.rs	Updates ThreadExecutionContext construction to include available_actions_snapshot.
tests/engine_v2_gate_integration.rs	Updates test ActionDef literals and ThreadExecutionContext construction for new discovery/snapshot fields.
src/tools/mod.rs	Re-exports ToolDiscoverySummary and require_* helpers for bridge/tool discovery code.
src/gate/approval.rs	Updates test ActionDef literal to include discovery.
src/bridge/router.rs	Routes mission actions via new engine_actions::mission_capability_actions() and updates context init.
src/bridge/mod.rs	Registers new bridge modules (action_discovery, engine_actions).
src/bridge/llm_adapter.rs	Adds tool description hinting to call tool_info when discovery metadata exists; updates tests.
src/bridge/engine_actions.rs	New module defining mission actions + curated discovery summaries/schemas for engine-v2 surfacing.
src/bridge/effect_adapter.rs	Adds snapshot-based canonical name resolution and snapshot-backed tool_info handling; adds tests.
src/bridge/action_projector.rs	Projects ToolRegistry tools into ActionDefs with discovery metadata (summary + schema override).
src/bridge/action_discovery.rs	New helper to resolve actions and serve tool_info responses from the callable-action snapshot.
crates/ironclaw_engine/src/types/capability.rs	Adds discovery metadata structs/field to ActionDef and alias-aware matches_name.
crates/ironclaw_engine/src/traits/effect.rs	Adds available_actions_snapshot to ThreadExecutionContext.
crates/ironclaw_engine/src/runtime/mission.rs	Updates ThreadExecutionContext construction for new snapshot field.
crates/ironclaw_engine/src/runtime/manager.rs	Updates test ActionDef literals for the new discovery field.
crates/ironclaw_engine/src/lib.rs	Re-exports ActionDiscoveryMetadata and ActionDiscoverySummary.
crates/ironclaw_engine/src/gate/tool_tier.rs	Updates test ActionDef literal to include discovery.
crates/ironclaw_engine/src/gate/pipeline.rs	Updates test ActionDef literal to include discovery.
crates/ironclaw_engine/src/gate/lease.rs	Updates test ActionDef literal to include discovery.
crates/ironclaw_engine/src/executor/thread_context.rs	Updates ThreadExecutionContext construction for new snapshot field.
crates/ironclaw_engine/src/executor/structured.rs	Updates tests/context construction and ActionDef literals for discovery/snapshot fields.
crates/ironclaw_engine/src/executor/scripting.rs	Uses matches_name for alias-aware preflight + ensures gate paused action names are canonical.
crates/ironclaw_engine/src/executor/prompt.rs	Updates test ActionDef literal to include discovery.
crates/ironclaw_engine/src/executor/orchestrator.rs	Populates action snapshot and canonicalizes names for single/parallel action execution paths.
crates/ironclaw_engine/src/executor/loop_engine.rs	Updates test ActionDef literals to include discovery.
crates/ironclaw_engine/src/executor/context.rs	Updates ThreadExecutionContext construction for new snapshot field.
crates/ironclaw_engine/src/capability/registry.rs	Updates test ActionDef literals to include discovery.
crates/ironclaw_engine/src/capability/policy.rs	Updates test ActionDef literal to include discovery.
crates/ironclaw_engine/src/capability/planner.rs	Updates test ActionDef literal to include discovery.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.