Method session_for_agent

core/src/agent_api.rs:398–405

Create a session pre-configured from an [`AgentDefinition`]. Maps the definition's `permissions`, `prompt`, `model`, and `max_steps` directly into [`SessionOptions`], so markdown/YAML-defined subagents can be used by delegation and advanced control-plane flows without manual wiring. The mapping follows the same logic as the built-in `task` tool: - `permissions` → `permission_checker` - `prompt`

(
        &self,
        workspace: impl Into<String>,
        def: &crate::subagent::AgentDefinition,
        extra: Option<SessionOptions>,
    )

    /// `extra` can supply additional overrides (e.g. `planning_enabled`) that
    /// take precedence over the definition's values.
    pub fn session_for_agent(
        &self,
        workspace: impl Into<String>,
        def: &crate::subagent::AgentDefinition,
        extra: Option<SessionOptions>,
    ) -> Result<AgentSession> {
        agent_sessions::create_session_for_agent(self, workspace, def, extra)
    }

    /// Create a session from a reproducible disposable worker recipe.
    ///