Function create_command_context

src/command_system/engine.py:290–341

Create a command context. Args: workspace_root: Root directory of the workspace conversation: Conversation object cost_tracker: Cost tracker object history: History log object cwd: Current working directory (defaults to workspace_root) config

(
    workspace_root: str | Path,
    conversation: Any = None,
    cost_tracker: Any = None,
    history: Any = None,
    cwd: str | Path | None = None,
    config: dict[str, Any] | None = None,
    app_state_store: Any = None,
    provider: Any = None,
    ui: Any = None,
    tool_context: Any = None,
)

def create_command_context(
    workspace_root: str | Path,
    conversation: Any = None,
    cost_tracker: Any = None,
    history: Any = None,
    cwd: str | Path | None = None,
    config: dict[str, Any] | None = None,
    app_state_store: Any = None,
    provider: Any = None,
    ui: Any = None,
    tool_context: Any = None,
) -> CommandContext:
    """
    Create a command context.

    Args:
        workspace_root: Root directory of the workspace
        conversation: Conversation object
        cost_tracker: Cost tracker object
        history: History log object
        cwd: Current working directory (defaults to workspace_root)
        config: Optional configuration dict
        app_state_store: Optional reactive AppState store. Commands that
            mutate global session state (e.g. /advisor, /permissions) need
            this.
        provider: Optional active LLM provider. Commands that gate on
            provider type (e.g. /advisor) need this.
        ui: Optional ``UIHost`` interaction port. Interactive commands drive
            it; when None the engine substitutes a ``NullUIHost``.
        tool_context: Optional ``ToolContext``. Threaded onto the context so a
            ``SkillPromptCommand`` can render via the same ``_run_markdown_skill``
            path the Skill tool uses (session id + gated shell-exec). When None,
            skill prompts degrade to a headless render.

    Returns:
        CommandContext instance
    """
    root = Path(workspace_root).expanduser().resolve()
    current = Path(cwd).expanduser().resolve() if cwd is not None else root

    return CommandContext(
        workspace_root=root,
        cwd=current,
        conversation=conversation,
        cost_tracker=cost_tracker,
        history=history,
        config=config or {},
        app_state_store=app_state_store,
        provider=provider,
        ui=ui,
        tool_context=tool_context,
    )