agentic-fabric 1.2.0__tar.gz

agentic_fabric-1.2.0/.gitignore

@@ -0,0 +1,15 @@
+.DS_Store
+.coverage
+.mypy_cache/
+.pytest_cache/
+.ruff_cache/
+.tox/
+.venv/
+__pycache__/
+build/
+dist/
+htmlcov/
+*.egg-info/
+*.pyc
+docs/_build/
+docs/apidocs/

agentic_fabric-1.2.0/CHANGELOG.md

@@ -0,0 +1,54 @@
+# CHANGELOG
+
+<!-- version list -->
+
+## [1.2.0](https://github.com/jbcom/agentic-fabric/compare/agentic-fabric-v1.1.0...agentic-fabric-v1.2.0) (2026-06-27)
+
+
+### Features
+
+* fix all assessment findings + add Ollama E2E support ([#4](https://github.com/jbcom/agentic-fabric/issues/4)) ([37cc3b6](https://github.com/jbcom/agentic-fabric/commit/37cc3b6b62de867676d37a7959dab955ac1d331c))
+
+## [1.1.0](https://github.com/jbcom/agentic-fabric/compare/agentic-fabric-v1.0.0...agentic-fabric-v1.1.0) (2026-06-27)
+
+
+### Features
+
+* bootstrap agentic fabric workspace ([#1](https://github.com/jbcom/agentic-fabric/issues/1)) ([2704e67](https://github.com/jbcom/agentic-fabric/commit/2704e6758a77661477c01678073a1b78ca1abcbc))
+
+## v1.0.0 (2025-12-25)
+
+### Initial Stable Release
+
+Framework-agnostic AI fabric agent orchestration is now production-ready!
+
+### Features
+
+- **Multi-Framework Support**: Run fabric agents on CrewAI, LangGraph, or Strands
+- **Auto-Detection**: Automatically selects best available framework
+- **Universal YAML Format**: Define once, run anywhere
+- **Single-Agent CLI Runners**: Support for aider, claude-code, ollama, and more
+- **MCP Adapters**: Expose vendor-fabric catalog/data methods and Meshy capability metadata over MCP
+- **Knowledge Base Integration**: Load domain knowledge from markdown files
+- **Agent Archetypes**: Reusable agent templates
+- **Comprehensive Testing**: 122+ unit tests, E2E test suite
+
+### Breaking Changes
+
+- **Minimum Python version increased from 3.10 to 3.11**
+  - Required for CrewAI 1.5.0+ compatibility
+  - Python 3.11, 3.12, 3.13, 3.14 now supported
+
+### Documentation
+
+- Complete API documentation with Sphinx
+- Quick start guide and architecture overview
+- jbcom dark theme branding applied
+- Integration guides for vendor-fabric
+
+### Internal
+
+- Full test coverage across all runners
+- Ruff linting and formatting
+- Type hints with mypy
+- Tox for multi-version testing

agentic_fabric-1.2.0/PKG-INFO

@@ -0,0 +1,292 @@
+Metadata-Version: 2.4
+Name: agentic-fabric
+Version: 1.2.0
+Summary: Framework-agnostic agent fabric orchestration for CrewAI, LangGraph, Strands, local CLI runners, and vendor-fabric tools
+Project-URL: Documentation, https://jonbogaty.com/agentic-fabric/
+Project-URL: Issues, https://github.com/jbcom/agentic-fabric/issues
+Project-URL: Source, https://github.com/jbcom/agentic-fabric
+Project-URL: Changelog, https://github.com/jbcom/agentic-fabric/blob/main/CHANGELOG.md
+Author-email: Jon Bogaty <jon@jonbogaty.com>
+Maintainer-email: Jon Bogaty <jon@jonbogaty.com>
+License: MIT
+Keywords: ai-agents,crewai,langgraph,multi-agent,orchestration,strands,vendor-fabric
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: pyyaml>=6.0.3
+Provides-Extra: dev
+Requires-Dist: coverage[toml]>=7.14.3; extra == 'dev'
+Requires-Dist: mypy>=2.1.0; extra == 'dev'
+Requires-Dist: pytest-agentic-fabric[tests]; extra == 'dev'
+Requires-Dist: pytest-asyncio>=1.4.0; extra == 'dev'
+Requires-Dist: pytest-cov>=7.1.0; extra == 'dev'
+Requires-Dist: pytest-mock>=3.15.1; extra == 'dev'
+Requires-Dist: pytest-timeout>=2.4.0; extra == 'dev'
+Requires-Dist: pytest-xdist>=3.8.0; extra == 'dev'
+Requires-Dist: pytest>=9.1.1; extra == 'dev'
+Requires-Dist: ruff>=0.15.20; extra == 'dev'
+Requires-Dist: types-pyyaml>=6.0.12.20260518; extra == 'dev'
+Requires-Dist: types-requests>=2.33.0.20260518; extra == 'dev'
+Provides-Extra: docs
+Requires-Dist: furo>=2025.12.19; extra == 'docs'
+Requires-Dist: myst-parser<6.0.0,>=5.1.0; extra == 'docs'
+Requires-Dist: sphinx-autodoc2>=0.5.0; extra == 'docs'
+Requires-Dist: sphinx-copybutton>=0.5.2; extra == 'docs'
+Requires-Dist: sphinx<10.0.0,>=8.2.3; extra == 'docs'
+Provides-Extra: langgraph
+Requires-Dist: langchain-anthropic>=0.3.0; extra == 'langgraph'
+Requires-Dist: langchain-ollama>=0.3.0; extra == 'langgraph'
+Requires-Dist: langgraph>=0.2.0; extra == 'langgraph'
+Provides-Extra: mcp
+Requires-Dist: mcp>=1.0.0; extra == 'mcp'
+Provides-Extra: scraping
+Requires-Dist: beautifulsoup4>=4.12.0; extra == 'scraping'
+Requires-Dist: requests>=2.31.0; extra == 'scraping'
+Provides-Extra: strands
+Requires-Dist: strands-agents[ollama]>=0.1.0; extra == 'strands'
+Provides-Extra: tests
+Requires-Dist: coverage[toml]>=7.14.3; extra == 'tests'
+Requires-Dist: pytest-agentic-fabric[tests]; extra == 'tests'
+Requires-Dist: pytest-asyncio>=1.4.0; extra == 'tests'
+Requires-Dist: pytest-cov>=7.1.0; extra == 'tests'
+Requires-Dist: pytest-mock>=3.15.1; extra == 'tests'
+Requires-Dist: pytest-timeout>=2.4.0; extra == 'tests'
+Requires-Dist: pytest-xdist>=3.8.0; extra == 'tests'
+Requires-Dist: pytest>=9.1.1; extra == 'tests'
+Provides-Extra: typing
+Requires-Dist: mypy>=2.1.0; extra == 'typing'
+Requires-Dist: types-pyyaml>=6.0.12.20260518; extra == 'typing'
+Requires-Dist: types-requests>=2.33.0.20260518; extra == 'typing'
+Description-Content-Type: text/markdown
+
+# agentic-fabric
+
+[![PyPI version](https://img.shields.io/pypi/v/agentic-fabric.svg)](https://pypi.org/project/agentic-fabric/)
+[![CI](https://github.com/jbcom/agentic-fabric/actions/workflows/ci.yml/badge.svg)](https://github.com/jbcom/agentic-fabric/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python](https://img.shields.io/pypi/pyversions/agentic-fabric.svg)](https://pypi.org/project/agentic-fabric/)
+
+Framework-agnostic agent fabric orchestration. Declare fabric agents once in YAML, then
+run them on CrewAI, LangGraph, Strands, or local CLI runners without changing a
+single fabric agent definition. Runtime frameworks are optional and are detected lazily
+from what is installed.
+
+[Documentation](https://jonbogaty.com/agentic-fabric/) | [Source](https://github.com/jbcom/agentic-fabric) | [Issues](https://github.com/jbcom/agentic-fabric/issues)
+
+## Installation
+
+```bash
+# Core discovery, loading, runner selection, local CLI, and neutral file tools
+pip install agentic-fabric
+
+# With a specific framework
+pip install "agentic-fabric[langgraph]"
+pip install "agentic-fabric[strands]"
+
+# Non-framework optional surfaces
+pip install "agentic-fabric[mcp]"
+pip install "agentic-fabric[scraping]"
+```
+
+Local CLI runners do not require a Python extra. Install the external CLI
+(`aider`, `claude`, `codex`, `ollama`, or a custom executable) and inspect
+profiles with `agentic-fabric list-runners --json`.
+
+Vendor-backed passthrough extras will be added after the upstream
+`vendor-fabric` optional-extra contract is published and stable. Until then,
+vendor references stay lazy and report install guidance at use time.
+
+There is no aggregate AI extra. Install exactly the framework or provider path
+you use. The CrewAI adapter remains lazy, but `agentic-fabric` does not publish
+a CrewAI extra while CrewAI depends on ChromaDB releases covered by an upstream
+critical advisory with no patched version. Install CrewAI separately only after
+reviewing that advisory state. Core, local-CLI, and first-party scraping
+installs are unaffected.
+
+## Quick Start
+
+### 1. Define a Fabric Agent (YAML)
+
+```yaml
+# .fabric/fabric_agents/analyzer/agents.yaml
+code_reviewer:
+  role: Senior Code Reviewer
+  goal: Find bugs and improvements
+  backstory: Expert at code analysis
+```
+
+```yaml
+# .fabric/fabric_agents/analyzer/tasks.yaml
+review_code:
+  description: Review the provided code for issues
+  expected_output: List of findings with severity
+  agent: code_reviewer
+```
+
+### 2. Run It
+
+```python
+from pathlib import Path
+
+from agentic_fabric import detect_framework, get_fabric_agent_config, run_fabric_agent_auto
+
+# See what framework is available
+framework = detect_framework()
+
+# Load a fabric agent manifest discovered in a package or workspace
+config = get_fabric_agent_config(Path(".fabric"), "analyzer")
+
+# Auto-detect best framework and run
+result = run_fabric_agent_auto(config, inputs={"code": "..."})
+```
+
+Or from the CLI:
+
+```bash
+agentic-fabric run my-package analyzer --input "Review this code: ..."
+```
+
+### 3. Use a Specific Runner
+
+```python
+from agentic_fabric import get_runner
+
+runner = get_runner("langgraph")  # Force LangGraph
+fabric_agent = runner.build_fabric_agent(config)
+result = runner.run(fabric_agent, inputs)
+```
+
+### 4. Carry Runtime Context with Data
+
+```python
+from agentic_fabric import AgenticData, get_framework_info
+
+print(get_framework_info())
+
+session = AgenticData({"repo": "jbcom/agentic-fabric"})
+session.register_fabric_agent("reviewer", config)
+result = session.run_fabric_agent("reviewer", runtime="crewai")
+```
+
+## Key Features
+
+- Framework agnostic: one fabric agent definition, multiple runtime backends.
+- Lazy imports: core package import does not require CrewAI, LangGraph,
+  Strands, or vendor SDKs.
+- Framework-neutral file tools: built-in filesystem tools can be resolved
+  without installing CrewAI or Pydantic; framework adapters add schema wrappers
+  only when their optional dependencies are present.
+- Focused extras: `langgraph`, `strands`, `mcp`, `scraping`,
+  `tests`, `typing`, `docs`, and `dev`.
+- `AgenticData`: carries data, registered fabric agents, active runtime selection, and
+  vendor-layer context together.
+- Capability decorators: runners and tools expose declared capabilities through
+  read-only metadata and deterministic dispatch.
+- Tool resolution: built-in, vendor URI, and registered factories are preferred;
+  external dynamic imports require `AGENTIC_FABRIC_TOOL_IMPORT_ALLOWLIST`.
+- Vendor tool catalogs: `AgenticData.vendor_tools()` adapts inherited
+  `VendorData` capability metadata into agent-facing tools without importing
+  provider SDKs directly.
+- YAML-first: fabric agent configuration in YAML, not Python boilerplate.
+- Hierarchical orchestration: `ManagerAgent` delegates across fabric agents.
+- Package discovery: finds `.fabric/`, `.crewai/`, `.langgraph/`, and
+  `.strands/` directories.
+- Vendor passthrough extras are deferred until `vendor-fabric` is published
+  with a stable optional-extra contract.
+- CLI and library: use from the command line or import as a module.
+
+## Framework Priority
+
+1. CrewAI, if installed.
+2. LangGraph, if CrewAI is unavailable.
+3. Strands, if neither CrewAI nor LangGraph is available.
+
+You can always force a specific runner with `get_runner("langgraph")` or
+`agentic-fabric run --framework langgraph`.
+
+If the selected runtime is not installed, errors point to the matching
+`agentic-fabric[...]` extra. Framework-specific config directories also enforce
+their runtime: a fabric agent in `.langgraph/` will not silently run on CrewAI.
+
+## Local CLI Runners
+
+For single-agent coding tools, use the `--runner` CLI path:
+
+```bash
+agentic-fabric list-runners --json
+agentic-fabric run --runner aider --input "Add validation to auth.py"
+agentic-fabric run --runner ollama --model deepseek-coder --input "Explain this module"
+```
+
+Profiles are loaded from the packaged `local_cli_profiles.yaml`, validated
+before use, and rejected on POSIX systems if the profiles file is group- or
+world-writable.
+
+## MCP Adapters
+
+The `mcp` extra installs the MCP transport dependency and enables two console
+entry points:
+
+```bash
+agentic-fabric-vendor-mcp
+agentic-fabric-meshy-mcp
+```
+
+`agentic-fabric-vendor-mcp` exposes credential-free vendor catalog tools and
+public `vendor-fabric` data methods. `agentic-fabric-meshy-mcp` converts
+Meshy capability metadata from `vendor-fabric[meshy]` into MCP tools. Both
+servers import provider code lazily; install the matching `vendor-fabric`
+package/extras in the same environment before running provider-backed tools.
+If provider startup fails, the adapter error includes the `agentic-fabric[mcp]`
+or `vendor-fabric[...]` install guidance plus the original import failure so
+missing provider extras are visible.
+
+## Repository Boundary
+
+- `extended-data` owns base data containers, logging, input handling, files,
+  redaction, and generic workflows.
+- `vendor-fabric` owns vendor connectors, provider-backed sync, the SecretSync
+  Python facade/capability surfaces, provider capability metadata, and provider
+  dispatch.
+- `agentic-fabric` owns fabric agent discovery, runner selection, framework adapters,
+  agent-facing tool wrappers, and orchestration.
+
+Full guides and API documentation are published at
+[jonbogaty.com/agentic-fabric](https://jonbogaty.com/agentic-fabric/).
+`AGENTS.md` contains durable repository guidance for Codex sessions.
+
+## Documentation
+
+The docs are built with Sphinx, Furo, and sphinx-autodoc2:
+
+```bash
+tox -e docs
+```
+
+Local validation:
+
+```bash
+uv sync --all-packages --all-extras --dev
+tox -e lint
+tox -e typecheck
+tox -e audit
+tox -e py311
+tox -e py312
+tox -e py313
+tox -e py314
+tox -e coverage
+tox -e plugin
+tox -e examples
+tox -e build
+```
+
+## License
+
+MIT

agentic_fabric-1.2.0/README.md

@@ -0,0 +1,224 @@
+# agentic-fabric
+
+[![PyPI version](https://img.shields.io/pypi/v/agentic-fabric.svg)](https://pypi.org/project/agentic-fabric/)
+[![CI](https://github.com/jbcom/agentic-fabric/actions/workflows/ci.yml/badge.svg)](https://github.com/jbcom/agentic-fabric/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python](https://img.shields.io/pypi/pyversions/agentic-fabric.svg)](https://pypi.org/project/agentic-fabric/)
+
+Framework-agnostic agent fabric orchestration. Declare fabric agents once in YAML, then
+run them on CrewAI, LangGraph, Strands, or local CLI runners without changing a
+single fabric agent definition. Runtime frameworks are optional and are detected lazily
+from what is installed.
+
+[Documentation](https://jonbogaty.com/agentic-fabric/) | [Source](https://github.com/jbcom/agentic-fabric) | [Issues](https://github.com/jbcom/agentic-fabric/issues)
+
+## Installation
+
+```bash
+# Core discovery, loading, runner selection, local CLI, and neutral file tools
+pip install agentic-fabric
+
+# With a specific framework
+pip install "agentic-fabric[langgraph]"
+pip install "agentic-fabric[strands]"
+
+# Non-framework optional surfaces
+pip install "agentic-fabric[mcp]"
+pip install "agentic-fabric[scraping]"
+```
+
+Local CLI runners do not require a Python extra. Install the external CLI
+(`aider`, `claude`, `codex`, `ollama`, or a custom executable) and inspect
+profiles with `agentic-fabric list-runners --json`.
+
+Vendor-backed passthrough extras will be added after the upstream
+`vendor-fabric` optional-extra contract is published and stable. Until then,
+vendor references stay lazy and report install guidance at use time.
+
+There is no aggregate AI extra. Install exactly the framework or provider path
+you use. The CrewAI adapter remains lazy, but `agentic-fabric` does not publish
+a CrewAI extra while CrewAI depends on ChromaDB releases covered by an upstream
+critical advisory with no patched version. Install CrewAI separately only after
+reviewing that advisory state. Core, local-CLI, and first-party scraping
+installs are unaffected.
+
+## Quick Start
+
+### 1. Define a Fabric Agent (YAML)
+
+```yaml
+# .fabric/fabric_agents/analyzer/agents.yaml
+code_reviewer:
+  role: Senior Code Reviewer
+  goal: Find bugs and improvements
+  backstory: Expert at code analysis
+```
+
+```yaml
+# .fabric/fabric_agents/analyzer/tasks.yaml
+review_code:
+  description: Review the provided code for issues
+  expected_output: List of findings with severity
+  agent: code_reviewer
+```
+
+### 2. Run It
+
+```python
+from pathlib import Path
+
+from agentic_fabric import detect_framework, get_fabric_agent_config, run_fabric_agent_auto
+
+# See what framework is available
+framework = detect_framework()
+
+# Load a fabric agent manifest discovered in a package or workspace
+config = get_fabric_agent_config(Path(".fabric"), "analyzer")
+
+# Auto-detect best framework and run
+result = run_fabric_agent_auto(config, inputs={"code": "..."})
+```
+
+Or from the CLI:
+
+```bash
+agentic-fabric run my-package analyzer --input "Review this code: ..."
+```
+
+### 3. Use a Specific Runner
+
+```python
+from agentic_fabric import get_runner
+
+runner = get_runner("langgraph")  # Force LangGraph
+fabric_agent = runner.build_fabric_agent(config)
+result = runner.run(fabric_agent, inputs)
+```
+
+### 4. Carry Runtime Context with Data
+
+```python
+from agentic_fabric import AgenticData, get_framework_info
+
+print(get_framework_info())
+
+session = AgenticData({"repo": "jbcom/agentic-fabric"})
+session.register_fabric_agent("reviewer", config)
+result = session.run_fabric_agent("reviewer", runtime="crewai")
+```
+
+## Key Features
+
+- Framework agnostic: one fabric agent definition, multiple runtime backends.
+- Lazy imports: core package import does not require CrewAI, LangGraph,
+  Strands, or vendor SDKs.
+- Framework-neutral file tools: built-in filesystem tools can be resolved
+  without installing CrewAI or Pydantic; framework adapters add schema wrappers
+  only when their optional dependencies are present.
+- Focused extras: `langgraph`, `strands`, `mcp`, `scraping`,
+  `tests`, `typing`, `docs`, and `dev`.
+- `AgenticData`: carries data, registered fabric agents, active runtime selection, and
+  vendor-layer context together.
+- Capability decorators: runners and tools expose declared capabilities through
+  read-only metadata and deterministic dispatch.
+- Tool resolution: built-in, vendor URI, and registered factories are preferred;
+  external dynamic imports require `AGENTIC_FABRIC_TOOL_IMPORT_ALLOWLIST`.
+- Vendor tool catalogs: `AgenticData.vendor_tools()` adapts inherited
+  `VendorData` capability metadata into agent-facing tools without importing
+  provider SDKs directly.
+- YAML-first: fabric agent configuration in YAML, not Python boilerplate.
+- Hierarchical orchestration: `ManagerAgent` delegates across fabric agents.
+- Package discovery: finds `.fabric/`, `.crewai/`, `.langgraph/`, and
+  `.strands/` directories.
+- Vendor passthrough extras are deferred until `vendor-fabric` is published
+  with a stable optional-extra contract.
+- CLI and library: use from the command line or import as a module.
+
+## Framework Priority
+
+1. CrewAI, if installed.
+2. LangGraph, if CrewAI is unavailable.
+3. Strands, if neither CrewAI nor LangGraph is available.
+
+You can always force a specific runner with `get_runner("langgraph")` or
+`agentic-fabric run --framework langgraph`.
+
+If the selected runtime is not installed, errors point to the matching
+`agentic-fabric[...]` extra. Framework-specific config directories also enforce
+their runtime: a fabric agent in `.langgraph/` will not silently run on CrewAI.
+
+## Local CLI Runners
+
+For single-agent coding tools, use the `--runner` CLI path:
+
+```bash
+agentic-fabric list-runners --json
+agentic-fabric run --runner aider --input "Add validation to auth.py"
+agentic-fabric run --runner ollama --model deepseek-coder --input "Explain this module"
+```
+
+Profiles are loaded from the packaged `local_cli_profiles.yaml`, validated
+before use, and rejected on POSIX systems if the profiles file is group- or
+world-writable.
+
+## MCP Adapters
+
+The `mcp` extra installs the MCP transport dependency and enables two console
+entry points:
+
+```bash
+agentic-fabric-vendor-mcp
+agentic-fabric-meshy-mcp
+```
+
+`agentic-fabric-vendor-mcp` exposes credential-free vendor catalog tools and
+public `vendor-fabric` data methods. `agentic-fabric-meshy-mcp` converts
+Meshy capability metadata from `vendor-fabric[meshy]` into MCP tools. Both
+servers import provider code lazily; install the matching `vendor-fabric`
+package/extras in the same environment before running provider-backed tools.
+If provider startup fails, the adapter error includes the `agentic-fabric[mcp]`
+or `vendor-fabric[...]` install guidance plus the original import failure so
+missing provider extras are visible.
+
+## Repository Boundary
+
+- `extended-data` owns base data containers, logging, input handling, files,
+  redaction, and generic workflows.
+- `vendor-fabric` owns vendor connectors, provider-backed sync, the SecretSync
+  Python facade/capability surfaces, provider capability metadata, and provider
+  dispatch.
+- `agentic-fabric` owns fabric agent discovery, runner selection, framework adapters,
+  agent-facing tool wrappers, and orchestration.
+
+Full guides and API documentation are published at
+[jonbogaty.com/agentic-fabric](https://jonbogaty.com/agentic-fabric/).
+`AGENTS.md` contains durable repository guidance for Codex sessions.
+
+## Documentation
+
+The docs are built with Sphinx, Furo, and sphinx-autodoc2:
+
+```bash
+tox -e docs
+```
+
+Local validation:
+
+```bash
+uv sync --all-packages --all-extras --dev
+tox -e lint
+tox -e typecheck
+tox -e audit
+tox -e py311
+tox -e py312
+tox -e py313
+tox -e py314
+tox -e coverage
+tox -e plugin
+tox -e examples
+tox -e build
+```
+
+## License
+
+MIT

agentic_fabric-1.2.0/examples/README.md

@@ -0,0 +1,18 @@
+# Examples
+
+These examples are intentionally executable in CI. They avoid live LLM calls
+and optional framework imports unless explicitly noted, so they also serve as
+integration checks for the public API.
+
+```bash
+python examples/discovery_workflow.py
+python examples/tool_registry.py
+python examples/runtime_context.py
+python examples/mcp_adapters.py
+```
+
+The bundled `sample_workspace/` directory demonstrates a framework-agnostic
+`.fabric/` layout.
+
+`mcp_adapters.py` shows the agentic-fabric-owned MCP entry points and a
+client configuration shape without importing the MCP SDK or provider packages.

agentic_fabric-1.2.0/examples/__init__.py

@@ -0,0 +1 @@
+"""Runnable agentic-fabric examples."""

agentic_fabric-1.2.0/examples/discovery_workflow.py

@@ -0,0 +1,49 @@
+"""Discover and inspect a framework-agnostic fabric workspace."""
+
+from __future__ import annotations
+
+import json
+import sys
+
+from pathlib import Path
+from typing import Any
+
+from agentic_fabric.core.discovery import discover_packages, get_fabric_agent_config, load_manifest
+
+
+DEFAULT_WORKSPACE = Path(__file__).parent / "sample_workspace"
+
+
+def summarize_workspace(workspace_root: Path = DEFAULT_WORKSPACE) -> dict[str, Any]:
+    """Return a deterministic summary of fabric agents in a workspace."""
+    packages = discover_packages(workspace_root=workspace_root)
+    summary: dict[str, Any] = {"workspace": str(workspace_root), "packages": {}}
+
+    for package_name, config_dir in sorted(packages.items()):
+        manifest = load_manifest(config_dir)
+        fabric_agent_summaries = {}
+        for fabric_agent_name in sorted(manifest.get("fabric_agents", {})):
+            fabric_agent_config = get_fabric_agent_config(config_dir, fabric_agent_name)
+            fabric_agent_summaries[fabric_agent_name] = {
+                "description": fabric_agent_config.get("description", ""),
+                "required_framework": fabric_agent_config.get("required_framework"),
+                "agents": sorted(fabric_agent_config.get("agents", {})),
+                "tasks": sorted(fabric_agent_config.get("tasks", {})),
+            }
+
+        summary["packages"][package_name] = {
+            "config_dir": config_dir.name,
+            "fabric_agents": fabric_agent_summaries,
+        }
+
+    return summary
+
+
+def main() -> None:
+    """Print the sample workspace summary as JSON."""
+    sys.stdout.write(json.dumps(summarize_workspace(), indent=2, sort_keys=True))
+    sys.stdout.write("\n")
+
+
+if __name__ == "__main__":
+    main()