<!-- AUTO-GENERATED by scripts/gen_docs.py — run `task docs-gen` to refresh -->
<!-- Do not edit this file manually. -->
# MAS Lab — Packages Reference
> **Auto-generated** from `pyproject.toml` files and `library.yaml` manifests.  Run `task docs-gen` to refresh after adding or modifying packages.

## Summary
| Package                | Layer         | Description                                                                               | CLI           |
| ---------------------- | ------------- | ----------------------------------------------------------------------------------------- | ------------- |
| `mas-runtime`          | Runtime core  | MAS Runtime V2 — Mealy kernel (embeddable library)                                        | `mas-runtime` |
| `mas-ctl`              | Orchestration | MAS control plane V2 — compose, session, placement                                        | `mas-ctl`     |
| `mas-lab`              | Lab framework | MAS Lab — Multi-Agent System experimentation, benchmarking, and analysis toolkit.         | `mas-lab`     |
| `mas-lab-core`         | Lab framework | Core contracts, telemetry, schemas and utilities shared across MAS Lab components.        | —             |
| `mas-lab-bench`        | Lab framework | Benchmark engine, pipeline execution, plots and validation for MAS Lab.                   | —             |
| `mas-lab-controller`   | Lab framework | MAS Lab controller daemon — workers, IPC, HTTP API for CLI and UI.                        | —             |
| `mas-lab-content`      | Lab framework | Shared content engine — markdown with widget directives, themes, and multi-mode rendering | —             |
| `mas-library-standard` | Libraries     | Standard library for MAS — infra bundles, tools, and pattern aliases.                     | —             |
| `mas-library-eval`     | Libraries     | Evaluation and quality metrics library for MAS Lab — MCE integration.                     | —             |
| `mas-library-lab`      | Libraries     | MAS Lab provider library with public eval plugins.                                        | —             |
| `mas-library-samples`  | Libraries     | Community-contributed MAS sample apps, datasets, and tools.                               | —             |
---

## Installation

### Minimal install (core toolchain)

Installs the four core packages needed to run and orchestrate agents,
execute benchmarks, and call `mas-lab`.

```bash
# From the repository root (uses UV_PROJECT_ENVIRONMENT if set):
task install
# Equivalent to:
uv pip install -e runtime -e ctl -e library-standard -e lab
```

### Full install (all packages + optional extras)

This is **not** a minimal install — it covers every package in this
repository plus all optional feature extras.  Use this when you need
evaluation metrics, or community sample
apps.

```bash
uv pip install \
  -e runtime \
  -e ctl \
  -e library-standard \
  -e lab \
  -e library-eval \
  -e library-lab \
  -e library-samples
```

See [Tutorial 0 — Environment Setup](tutorials/00-environment-setup/README.md)
for the complete walkthrough including LLM endpoint wiring and verification.

---

## Package Details

### `mas-runtime`
**Install path:** `runtime`  
**Layer:** Runtime core  
MAS Runtime V2 — Mealy kernel (embeddable library)

```bash
uv pip install -e runtime  # core
uv pip install -e "runtime[grpc,otel,dev]"  # with all extras
```

**Optional extras:**

| Extra  | Packages / features                                                                             |
| ------ | ----------------------------------------------------------------------------------------------- |
| `grpc` | `grpcio>=1.60.0`, `grpcio-tools>=1.60.0`                                                        |
| `otel` | `opentelemetry-api>=1.42.0`, `opentelemetry-sdk>=1.42.0`, `opentelemetry-exporter-otlp>=1.42.0` |
| `dev`  | `pytest>=8.0`, `pytest-asyncio>=0.24`                                                           |

**CLI commands:**

| Command       | Entry point                 |
| ------------- | --------------------------- |
| `mas-runtime` | `mas.runtime.cli.main:main` |

---

### `mas-ctl`
**Install path:** `ctl`  
**Layer:** Orchestration  
MAS control plane V2 — compose, session, placement

```bash
uv pip install -e ctl  # core
uv pip install -e "ctl[curses,dev]"  # with all extras
```

**Depends on:** `mas-runtime`  

**Optional extras:**

| Extra    | Packages / features                              |
| -------- | ------------------------------------------------ |
| `curses` | `windows-curses>=2.3.2; sys_platform == 'win32'` |
| `dev`    | `pytest>=8.0`, `import-linter>=2.0`              |

**CLI commands:**

| Command   | Entry point             |
| --------- | ----------------------- |
| `mas-ctl` | `mas.ctl.cli.main:main` |

---

### `mas-lab`
**Install path:** `lab`  
**Layer:** Lab framework  
MAS Lab — Multi-Agent System experimentation, benchmarking, and analysis toolkit.

```bash
uv pip install -e lab  # core
uv pip install -e "lab[extensions]"  # Letta memory scenarios (`extensions.lab`)
```

**Depends on:** `mas-runtime`, `mas-ctl`, `mas-lab-core`, `mas-lab-bench`, `mas-lab-controller`, `mas-library-eval`  

**Optional extras:**

| Extra        | Packages / features |
| ------------ | ------------------- |
| `extensions` | `letta` (Letta memory scenarios in `extensions.lab`) |
| `all`        | same as `extensions` |

For paper labs with Letta: `uv sync --group labs-full` or `pip install 'mas-lab[extensions]'`.
Extended OTel/KG observability is **not** an OSS extra — see `mas-lab-internal`.

**CLI commands:**

| Command   | Entry point       |
| --------- | ----------------- |
| `mas-lab` | `mas.lab.cli:app` |

---

### `mas-lab-core`
**Install path:** `lab/components/core`  
**Layer:** Lab framework  
Core contracts, telemetry, schemas and utilities shared across MAS Lab components.

```bash
uv pip install -e lab/components/core
```

**Depends on:** `mas-runtime`  

**Entry-point group `mas.lab.controller.plugins`:** registers 1 item(s) in `lab.controller.plugins`.

---

### `mas-lab-bench`
**Install path:** `lab/components/bench`  
**Layer:** Lab framework  
Benchmark engine, pipeline execution, plots and validation for MAS Lab.

```bash
uv pip install -e lab/components/bench
```

**Depends on:** `mas-lab-core`, `mas-library-eval`, `mas-runtime`, `mas-ctl`  

**Entry-point group `mas.lab.runners`:** registers 1 item(s) in `lab.runners`.

---

### `mas-lab-controller`
**Install path:** `lab/components/controller`  
**Layer:** Lab framework  
MAS Lab controller daemon — workers, IPC, HTTP API for CLI and UI.

```bash
uv pip install -e lab/components/controller  # core
uv pip install -e "lab/components/controller[dev]"  # with all extras
```

**Depends on:** `mas-lab-core`, `mas-lab-bench`, `mas-runtime`, `mas-ctl`  

**Optional extras:**

| Extra | Packages / features                                               |
| ----- | ----------------------------------------------------------------- |
| `dev` | `pytest>=9.0`, `pytest-asyncio`, `pytest-cov>=6.0`, `httpx>=0.27` |

**Entry-point group `mas.lab.cli.components`:** registers 1 item(s) in `lab.cli.components`.

---

### `mas-lab-content`
**Install path:** `lab/components/content`  
**Layer:** Lab framework  
Shared content engine — markdown with widget directives, themes, and multi-mode rendering

```bash
uv pip install -e lab/components/content
```

---

### `mas-library-standard`
**Install path:** `library-standard`  
**Layer:** Libraries  
Standard library for MAS — infra bundles, tools, and pattern aliases.

```bash
uv pip install -e library-standard
```

**Depends on:** `mas-runtime`  

**Entry-point group `mas.runtime.manifest_libraries`:** registers 1 item(s) in `runtime.manifest_libraries`.

---

### `mas-library-eval`
**Install path:** `library-eval`  
**Layer:** Libraries  
Evaluation and quality metrics library for MAS Lab — MCE integration.

```bash
uv pip install -e library-eval  # core
uv pip install -e "library-eval[dev]"  # with all extras
```

**Depends on:** `mas-lab-core`, `mas-lab-bench`, `mas-runtime`  

**Optional extras:**

| Extra | Packages / features                       |
| ----- | ----------------------------------------- |
| `dev` | `pytest>=7.0.0`, `pytest-asyncio>=0.21.0` |

**Entry-point group `mas.lab.cli.components`:** registers 1 item(s) in `lab.cli.components`.

---

### `mas-library-lab`
**Install path:** `library-lab`  
**Layer:** Libraries  
MAS Lab provider library with public eval plugins.

```bash
uv pip install -e library-lab
```

**Depends on:** `mas-lab`  

**Entry-point group `mas.lab.eval.plugins`:** registers 1 item(s) in `lab.eval.plugins`.

---

### `mas-library-samples`
**Install path:** `library-samples`  
**Layer:** Libraries  
Community-contributed MAS sample apps, datasets, and tools.

```bash
uv pip install -e library-samples
```

**Entry-point group `mas.runtime.manifest_libraries`:** registers 1 item(s) in `runtime.manifest_libraries`.

---