agentic_fabric.core.runner

Runner module - executes fabric agents with inputs.

This module provides convenience functions that discover and run fabric agents. It routes through the framework-agnostic decomposer so that required_framework from framework-specific config directories (.crewai/, .langgraph/, .strands/) is honored.

Module Contents

Functions

run_fabric_agent

Run a fabric agent from a package with the given inputs.

run_fabric_agent_from_path

Run a fabric agent directly from a fabric config directory path.

API

agentic_fabric.core.runner.run_fabric_agent(package_name: str, fabric_agent_name: str, inputs: dict | None = None, workspace_root: pathlib.Path | None = None) str

Run a fabric agent from a package with the given inputs.

Routes through the framework-agnostic decomposer, so the required_framework from the config directory is honored.

Args: package_name: Name of the package. fabric_agent_name: Name of the fabric agent to run (e.g., ‘game_builder’). inputs: Optional dict of inputs to pass to the fabric agent. workspace_root: Optional workspace root path.

Returns: The fabric agent’s output as a string.

Raises: ValueError: If package or fabric agent not found.

agentic_fabric.core.runner.run_fabric_agent_from_path(config_dir: pathlib.Path, fabric_agent_name: str, inputs: dict | None = None) str

Run a fabric agent directly from a fabric config directory path.

Routes through the framework-agnostic decomposer, so the required_framework from the config directory is honored.

Args: config_dir: Path to the .fabric/ or runtime-specific config directory. fabric_agent_name: Name of the fabric agent to run. inputs: Optional dict of inputs to pass to the fabric agent.

Returns: The fabric agent’s output as a string.