mas-lab-ctl 0.2.0__tar.gz

mas_lab_ctl-0.2.0/.gitignore

@@ -0,0 +1,86 @@
+*.pyc
+__pycache__/
+*.egg-info/
+.DS_Store
+dist/
+build/
+.venv/
+.demo-ui/
+.demo-ui-mock/
+.env
+.env.local
+.env.*.local
+config.yaml
+!lab/src/mas/lab/templates/**/config.yaml
+!docs/tutorials/**/config.yaml
+!labs/**/config.yaml
+!library-samples/sample-workspace/config.yaml
+.mypy_cache/
+.ruff_cache/
+.pytest_cache/
+.test-venv/
+node_modules/
+*.log
+docs/tutorials/**/logs/
+.hypothesis/
+compliance-report.json
+COMPLIANCE_REPORT.md
+compliance/results/
+
+# MkDocs build output
+site/
+
+.vscode/
+.cursor/
+.claude/
+
+# Test / coverage artifacts
+.coverage
+coverage.xml
+coverage.json
+**/coverage.json
+
+# LaTeX build artifacts
+*.fdb_latexmk
+*.fls
+*.aux
+*.out
+*.toc
+*.synctex.gz
+
+# Run output / artifacts
+**/output/*.jsonl
+**/output/benchmark
+**/output/meta.json
+**/output/current_run_id.txt
+**/output/*/
+.tutorial-cache/
+tests/.tutorial-engine-cache/
+.demo-cache/
+# Local mas-ctl chat traces next to an agent (fixtures live under fixtures/ or T01 traces/)
+docs/tutorials/**/agents/**/traces/
+
+# Backup files
+*.bak
+*.bak2
+
+# Legacy dead code (removed from repo)
+lab/src/mas/lab/_cli_legacy.py
+.deepeval/
+~/.mas/
+
+
+# Docker local secrets + data (never commit)
+docker/.env
+docker/data/*
+!docker/data/.gitkeep
+
+# Local protocol compliance checkouts and reports
+compliance/vendor/
+
+# Local harness playbooks (not published)
+AGENTS.md
+# .agents/
+COVERAGE_REPORT.md
+MANIFEST_SCHEMA_MAPPING.md
+.lycheecache

mas_lab_ctl-0.2.0/PKG-INFO

@@ -0,0 +1,180 @@
+Metadata-Version: 2.5
+Name: mas-lab-ctl
+Version: 0.2.0
+Summary: MAS control plane V2 — compile, compose, session, placement
+Project-URL: Homepage, https://github.com/ioc-project/mas-lab
+Project-URL: Issues, https://github.com/ioc-project/mas-lab/issues
+License: Apache-2.0
+Requires-Python: >=3.11
+Requires-Dist: certifi>=2024.0
+Requires-Dist: click>=8.0
+Requires-Dist: httpx>=0.27
+Requires-Dist: jsonschema>=4.0
+Requires-Dist: mas-lab-library-skills
+Requires-Dist: mas-lab-library-standard
+Requires-Dist: mas-lab-runtime
+Requires-Dist: python-dotenv>=1.0
+Requires-Dist: pyyaml>=6.0
+Provides-Extra: curses
+Requires-Dist: windows-curses>=2.3.2; (sys_platform == 'win32') and extra == 'curses'
+Provides-Extra: dev
+Requires-Dist: import-linter>=2.0; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+<!--
+  Copyright (c) 2026 Cisco Systems, Inc. and its affiliates
+  SPDX-License-Identifier: Apache-2.0
+-->
+# ctl
+
+> Multi-agent orchestration — compile, compose, chat, validate, run.
+
+---
+
+## Objective
+
+`mas-ctl` manages multi-agent systems described by declarative **MAS manifests**
+(`mas.yaml`). It resolves topologies, applies flavours and infra bundles, runs
+workflows, and provides the **interactive** CLI (`chat`, `tui`) on top of
+`mas-runtime`.
+
+```
+mas-runtime  ←  single agent : kernel + contracts + design-pattern plugins
+mas-ctl      ←  multi-agent  : compile, compose, chat, run-mas, validate
+mas-lab      ←  evaluation   : benchmarks, pipelines, controller UI
+```
+
+Benchmarking is **`mas-lab`**, not `mas-ctl`.
+
+---
+
+## Install
+
+```bash
+uv sync --all-packages
+```
+
+---
+
+## Quickstart
+
+```bash
+# Validate / compile manifests
+mas-ctl validate agent.yaml
+mas-ctl compile agent.yaml -o overlays/tools.yaml
+
+# Interactive single agent
+mas-ctl chat agent.yaml -q "Hello"
+
+# Run a MAS
+mas-ctl run-mas library-samples/apps/trip-planner/mas.yaml --flavour local
+
+# Inspect workspace / infra
+mas-ctl infra list
+mas-ctl flavour list
+```
+
+---
+
+## Key concepts
+
+### MAS manifest (`mas.yaml`)
+
+Declares agents, workflow, and metadata. See
+[docs/manifests/mas.md](../docs/manifests/mas.md).
+
+### Flavour
+
+Selects model endpoint and non-secret configuration (`local`, `mock`, …) from
+`library-standard`.
+
+### Scenario
+
+Named overlay for A/B configuration without duplicating manifests.
+
+### Workspace
+
+`$XDG_CONFIG_HOME/mas/config.yaml` and optional project `config.yaml` — see
+[docs/user-config.md](../docs/user-config.md) for the full XDG layout.
+
+---
+
+## CLI reference
+
+| Command | What it does | Flags |
+|---------|-------------|-------|
+| `mas-ctl chat MANIFEST` | Interactive or scripted conversation | [docs/cli/mas-ctl.md](../docs/cli/mas-ctl.md) |
+| `mas-ctl tui MANIFEST` | Terminal UI for chat | same · [docs/ctl/tui.md](../docs/ctl/tui.md) |
+| `mas-ctl run-mas MANIFEST` | Run a multi-agent workflow | [docs/cli/mas-ctl.md](../docs/cli/mas-ctl.md) |
+| `mas-ctl compile …` | Dump resolved Agent/MAS YAML (overlays + defaults) | [docs/cli/compile.md](../docs/cli/compile.md) |
+| `mas-ctl compose …` | Compose effective manifests / placement | `mas-ctl compose --help` |
+| `mas-ctl plan …` | Dry-run placement plan | `mas-ctl plan --help` |
+| `mas-ctl validate PATH …` | Validate agent / MAS / experiment YAML | [docs/cli/mas-ctl.md](../docs/cli/mas-ctl.md) |
+| `mas-ctl schemas` | List JSON/YAML schemas | — |
+| `mas-ctl flavour list\|show` | List or show flavours | — |
+| `mas-ctl infra list\|show` | List or show infra bundles | — |
+| `mas-ctl registry …` | Plugin registry introspection | `mas-ctl registry --help` |
+| `mas-ctl checkpoint …` | Session checkpoint utilities | `mas-ctl checkpoint --help` |
+| `mas-ctl list-bundles` | List library bundles | — |
+
+Overview: [docs/cli/index.md](../docs/cli/index.md).
+Workspace YAML: [docs/references/config.yaml.md](../docs/references/config.yaml.md).
+
+---
+
+## Design philosophy
+
+1. **Declarative over imperative** — topology and policies in YAML.
+2. **Secrets separated from config** — only `*_env` names in manifests.
+3. **Thin CLI** — click handlers call library code in `mas.ctl.*`.
+4. **Library-first bench** — `mas-lab` imports ctl session/bootstrap, not subprocesses.
+
+---
+
+## Tutorials
+
+Primary path (MkDocs): **[docs/tutorials/index.md](../docs/tutorials/index.md)**
+
+| # | Tutorial | Topic |
+|---|----------|-------|
+| 0 | [Environment](../docs/tutorials/00-environment-setup/README.md) | Docker / `uv`, credentials, workspace |
+| 1 | [Building an agent](../docs/tutorials/01-building-an-agent/README.md) | `mas-ctl chat`, overlays |
+| 2 | [Creating a MAS](../docs/tutorials/02-creating-a-mas/README.md) | `mas.yaml`, `run-mas` |
+| 3 | [Experiments](../docs/tutorials/03-experiments-and-analysis/README.md) | `mas-lab benchmark run` |
+
+---
+
+## Examples
+
+| Path | Description |
+|------|-------------|
+| [library-samples/apps/](../library-samples/apps/) | Trip planner, Q&A, moderator variants |
+| [docs/tutorials/](../docs/tutorials/) | Copy-paste tutorial manifests |
+
+Flavours ship in **`library-standard`** and resolve by name:
+`mas-ctl run-mas … --flavour local`.
+
+---
+
+## Documentation
+
+| Document | Covers |
+|----------|--------|
+| [../docs/user-guide.md](../docs/user-guide.md) | Operational guide |
+| [../docs/cli/index.md](../docs/cli/index.md) | CLI overview |
+| [../docs/cli/mas-ctl.md](../docs/cli/mas-ctl.md) | `mas-ctl` flags (`--trace`, `--events`, …) |
+| [../docs/references/config.yaml.md](../docs/references/config.yaml.md) | `config.yaml` fields |
+| [../docs/cli/observability.md](../docs/cli/observability.md) | `events.jsonl` |
+| [../docs/manifests/](../docs/manifests/README.md) | YAML manifests |
+| [../docs/libraries.md](../docs/libraries.md) | Package matrix |
+
+---
+
+## Related packages
+
+| Package | Role |
+|---------|------|
+| [`mas-runtime`](../runtime/) | Kernel, contracts, design patterns |
+| [`mas-lab`](../lab/) | Benchmarks, pipelines, UI |
+| [`library-standard`](../library-standard/) | Flavours, overlays, infra |

mas_lab_ctl-0.2.0/README.md

@@ -0,0 +1,156 @@
+<!--
+  Copyright (c) 2026 Cisco Systems, Inc. and its affiliates
+  SPDX-License-Identifier: Apache-2.0
+-->
+# ctl
+
+> Multi-agent orchestration — compile, compose, chat, validate, run.
+
+---
+
+## Objective
+
+`mas-ctl` manages multi-agent systems described by declarative **MAS manifests**
+(`mas.yaml`). It resolves topologies, applies flavours and infra bundles, runs
+workflows, and provides the **interactive** CLI (`chat`, `tui`) on top of
+`mas-runtime`.
+
+```
+mas-runtime  ←  single agent : kernel + contracts + design-pattern plugins
+mas-ctl      ←  multi-agent  : compile, compose, chat, run-mas, validate
+mas-lab      ←  evaluation   : benchmarks, pipelines, controller UI
+```
+
+Benchmarking is **`mas-lab`**, not `mas-ctl`.
+
+---
+
+## Install
+
+```bash
+uv sync --all-packages
+```
+
+---
+
+## Quickstart
+
+```bash
+# Validate / compile manifests
+mas-ctl validate agent.yaml
+mas-ctl compile agent.yaml -o overlays/tools.yaml
+
+# Interactive single agent
+mas-ctl chat agent.yaml -q "Hello"
+
+# Run a MAS
+mas-ctl run-mas library-samples/apps/trip-planner/mas.yaml --flavour local
+
+# Inspect workspace / infra
+mas-ctl infra list
+mas-ctl flavour list
+```
+
+---
+
+## Key concepts
+
+### MAS manifest (`mas.yaml`)
+
+Declares agents, workflow, and metadata. See
+[docs/manifests/mas.md](../docs/manifests/mas.md).
+
+### Flavour
+
+Selects model endpoint and non-secret configuration (`local`, `mock`, …) from
+`library-standard`.
+
+### Scenario
+
+Named overlay for A/B configuration without duplicating manifests.
+
+### Workspace
+
+`$XDG_CONFIG_HOME/mas/config.yaml` and optional project `config.yaml` — see
+[docs/user-config.md](../docs/user-config.md) for the full XDG layout.
+
+---
+
+## CLI reference
+
+| Command | What it does | Flags |
+|---------|-------------|-------|
+| `mas-ctl chat MANIFEST` | Interactive or scripted conversation | [docs/cli/mas-ctl.md](../docs/cli/mas-ctl.md) |
+| `mas-ctl tui MANIFEST` | Terminal UI for chat | same · [docs/ctl/tui.md](../docs/ctl/tui.md) |
+| `mas-ctl run-mas MANIFEST` | Run a multi-agent workflow | [docs/cli/mas-ctl.md](../docs/cli/mas-ctl.md) |
+| `mas-ctl compile …` | Dump resolved Agent/MAS YAML (overlays + defaults) | [docs/cli/compile.md](../docs/cli/compile.md) |
+| `mas-ctl compose …` | Compose effective manifests / placement | `mas-ctl compose --help` |
+| `mas-ctl plan …` | Dry-run placement plan | `mas-ctl plan --help` |
+| `mas-ctl validate PATH …` | Validate agent / MAS / experiment YAML | [docs/cli/mas-ctl.md](../docs/cli/mas-ctl.md) |
+| `mas-ctl schemas` | List JSON/YAML schemas | — |
+| `mas-ctl flavour list\|show` | List or show flavours | — |
+| `mas-ctl infra list\|show` | List or show infra bundles | — |
+| `mas-ctl registry …` | Plugin registry introspection | `mas-ctl registry --help` |
+| `mas-ctl checkpoint …` | Session checkpoint utilities | `mas-ctl checkpoint --help` |
+| `mas-ctl list-bundles` | List library bundles | — |
+
+Overview: [docs/cli/index.md](../docs/cli/index.md).
+Workspace YAML: [docs/references/config.yaml.md](../docs/references/config.yaml.md).
+
+---
+
+## Design philosophy
+
+1. **Declarative over imperative** — topology and policies in YAML.
+2. **Secrets separated from config** — only `*_env` names in manifests.
+3. **Thin CLI** — click handlers call library code in `mas.ctl.*`.
+4. **Library-first bench** — `mas-lab` imports ctl session/bootstrap, not subprocesses.
+
+---
+
+## Tutorials
+
+Primary path (MkDocs): **[docs/tutorials/index.md](../docs/tutorials/index.md)**
+
+| # | Tutorial | Topic |
+|---|----------|-------|
+| 0 | [Environment](../docs/tutorials/00-environment-setup/README.md) | Docker / `uv`, credentials, workspace |
+| 1 | [Building an agent](../docs/tutorials/01-building-an-agent/README.md) | `mas-ctl chat`, overlays |
+| 2 | [Creating a MAS](../docs/tutorials/02-creating-a-mas/README.md) | `mas.yaml`, `run-mas` |
+| 3 | [Experiments](../docs/tutorials/03-experiments-and-analysis/README.md) | `mas-lab benchmark run` |
+
+---
+
+## Examples
+
+| Path | Description |
+|------|-------------|
+| [library-samples/apps/](../library-samples/apps/) | Trip planner, Q&A, moderator variants |
+| [docs/tutorials/](../docs/tutorials/) | Copy-paste tutorial manifests |
+
+Flavours ship in **`library-standard`** and resolve by name:
+`mas-ctl run-mas … --flavour local`.
+
+---
+
+## Documentation
+
+| Document | Covers |
+|----------|--------|
+| [../docs/user-guide.md](../docs/user-guide.md) | Operational guide |
+| [../docs/cli/index.md](../docs/cli/index.md) | CLI overview |
+| [../docs/cli/mas-ctl.md](../docs/cli/mas-ctl.md) | `mas-ctl` flags (`--trace`, `--events`, …) |
+| [../docs/references/config.yaml.md](../docs/references/config.yaml.md) | `config.yaml` fields |
+| [../docs/cli/observability.md](../docs/cli/observability.md) | `events.jsonl` |
+| [../docs/manifests/](../docs/manifests/README.md) | YAML manifests |
+| [../docs/libraries.md](../docs/libraries.md) | Package matrix |
+
+---
+
+## Related packages
+
+| Package | Role |
+|---------|------|
+| [`mas-runtime`](../runtime/) | Kernel, contracts, design patterns |
+| [`mas-lab`](../lab/) | Benchmarks, pipelines, UI |
+| [`library-standard`](../library-standard/) | Flavours, overlays, infra |

mas_lab_ctl-0.2.0/docs/developer-guide.md

@@ -0,0 +1,48 @@
+<!--
+  Copyright (c) 2026 Cisco Systems, Inc. and its affiliates
+  SPDX-License-Identifier: Apache-2.0
+-->
+# mas-ctl Developer Guide
+
+This guide is for developers who extend `mas-ctl` while keeping it declarative. `mas-ctl` stays a thin CLI over reusable orchestration library code.
+
+## Development principles
+
+- Keep orchestration logic in library modules, not command handlers.
+- Model topology and policy in manifests first.
+- Preserve deterministic resolution order (base + flavour + overlays + overrides).
+
+## Extension areas
+
+### Manifest resolution
+
+- Add new schema keys only with explicit validation rules.
+- Maintain strict secret-vs-config separation.
+
+### Workflow/topology
+
+- Add topology types with clear execution semantics.
+- Provide migration notes when changing default behavior.
+
+### Placement
+
+- Only `local-inproc` is OSS-supported; other strategies are planned for a later release (see `ctl/docs/schemas/component-registry.yaml`).
+- Validate placement strategy at compose time via `placement_validate.validate_placement_strategy`.
+
+### Policy enforcement
+
+- Implement checks as composable components.
+- Produce actionable policy errors with context.
+
+## Testing strategy
+
+- Unit tests for manifest parsing and overlay merge behavior.
+- Integration tests for representative topologies.
+- End-to-end tests with real runtime/lab coupling where needed.
+
+## Developer checklist
+
+- New config fields documented
+- Effective config output updated
+- CLI help updated
+- Backward-compatibility implications documented

mas_lab_ctl-0.2.0/docs/schemas/component-registry.yaml

@@ -0,0 +1,38 @@
+#  Copyright (c) 2026 Cisco Systems, Inc. and its affiliates
+#  SPDX-License-Identifier: Apache-2.0
+# Authoritative runtime/placement/framework IDs (mas-lab)
+apiVersion: mas/v1
+kind: ComponentRegistry
+
+metadata:
+  name: component-registry
+  description: Single source of truth for ctl dispatch IDs
+
+spec:
+  runtimes:
+    - id: mas-runtime-py
+      layer: ctl.runtime
+      module: mas.ctl.compose.backends.mas_runtime_py.MasRuntimePyKernelBackend
+      description: Python Mealy kernel (OSS default)
+      status: available
+
+  placement:
+    - id: local-inproc
+      layer: ctl.placement
+      module: mas.ctl.compose.placement_registry.LocalInprocBackend
+      description: In-process comm bus (OSS default)
+      status: available
+    - id: docker
+      layer: ctl.placement
+      description: Docker placement — not in this OSS release; future release
+      status: future_release
+    - id: kubernetes
+      layer: ctl.placement
+      description: Kubernetes placement — not in this OSS release; future release
+      status: future_release
+
+  framework:
+    - id: native
+      layer: ctl.framework
+      description: Native MAS kernel runner (OSS — mas-lab benchmark path)
+      status: available

mas_lab_ctl-0.2.0/docs/user-guide.md

@@ -0,0 +1,87 @@
+<!--
+  Copyright (c) 2026 Cisco Systems, Inc. and its affiliates
+  SPDX-License-Identifier: Apache-2.0
+-->
+# mas-ctl User Guide
+
+`mas-ctl` runs agents and multi-agent systems (MAS) from YAML manifests. This guide is for teams that run a MAS, switch environments with flavours, and apply overlays.
+
+## Install
+
+From a checkout of the repository (the PyPI upload is still pending):
+
+```bash
+uv sync --all-packages
+```
+
+`mas-ctl` is then available through `uv run mas-ctl ...` (or activate the virtual environment).
+
+## Quickstart
+
+Run from a MAS manifest:
+
+```bash
+mas-ctl run-mas mas.yaml --flavour local
+```
+
+Run with an explicit prompt and an overlay (a partial manifest merged on top of the base):
+
+```bash
+mas-ctl run-mas mas.yaml --overlay overlays/baseline.yaml --prompt "Plan a 3-day trip to Paris" --flavour local
+```
+
+Add `--override PATH=VALUE` (repeatable) for one-off, schema-validated changes applied last.
+
+## Core concepts
+
+- MAS manifest: declares agents, topology/workflow, metadata
+- Deployment: placement strategy and runtime binding (`local-inproc` is the only OSS-supported strategy)
+- Overlay: a partial manifest merged over the base (`--overlay`, `--override`). In `mas-lab`, a *scenario* is the experiment-level construct that selects overlays per run (hierarchy: Experiment, Scenario, Item, Run).
+- Flavour: a named environment profile shipped by a library (list them with `mas-ctl flavour list`). Only `local` is available today.
+- Policy: guardrails and runtime limits declared in the manifest
+
+### Placement (OSS)
+
+Only `local-inproc` placement is supported in mas-lab OSS. Strategies
+`local-multiprocess`, `docker`, and `kubernetes` are planned for a later release.
+`compose` and `plan` fail with a clear error if an unsupported strategy is used.
+
+## Common tasks
+
+### Validate effective topology
+
+- Dry-run composition and placement: `mas-ctl plan mas.yaml`.
+- Print the composed manifest: `mas-ctl compose mas.yaml` (write it with `--output`).
+- Check manifests against their schemas: `mas-ctl validate mas.yaml`.
+
+### Switch environments
+
+- Keep the same MAS manifest; switch only `--flavour` (or `--infra-ref` for an infra bundle).
+
+### Audit secret usage
+
+- Secrets are never stored in manifests. Verify that every `*_env` reference names an environment variable that is set at runtime.
+
+## CLI map
+
+Run `mas-ctl --help` and `mas-ctl <command> --help` for all options.
+
+- `chat`, `tui` — interactive conversation with an agent or MAS manifest
+- `run-mas` — execute a MAS workflow (`--prompt`/`--query`, `--interactive`)
+- `compile`, `compose`, `plan` — manifest compilation, composition and placement dry-run
+- `validate`, `schemas` — YAML validation and schema listing
+- `flavour list` — flavours shipped by installed libraries
+- `infra list` (alias `list-bundles`) — infra bundles
+- `registry list`, `registry query` — plugin registry introspection
+- `plugin list`, `plugin enable`, `plugin doctor` — plugin inspection and checks
+- `serve` — expose an agent through the endpoint plugin its infra selects
+- `checkpoint` (`list`, `show`, `fork`, `resume`) — session checkpoints
+- `control` (`attach`, `inspect`, `pause`, `resume`, `steer`, `snapshot`, ...) — drive a running session
+
+Benchmarking: **`mas-lab benchmark run`** (see [Tutorial 3](../../docs/tutorials/03-experiments-and-analysis/README.md)).
+
+## Troubleshooting
+
+- Overlay not applied: check the `--overlay` path and the `--override` session-tree path.
+- Agent startup failure: validate referenced agent manifests.
+- Policy mismatch: inspect effective config output before run.

mas_lab_ctl-0.2.0/pyproject.toml

@@ -0,0 +1,58 @@
+#  Copyright (c) 2026 Cisco Systems, Inc. and its affiliates
+#  SPDX-License-Identifier: Apache-2.0
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "mas-lab-ctl"
+version = "0.2.0"
+description = "MAS control plane V2 — compile, compose, session, placement"
+readme = "README.md"
+requires-python = ">=3.11"
+license = { text = "Apache-2.0" }
+dependencies = [
+    "mas-lab-runtime",
+    "mas-lab-library-standard",
+    "mas-lab-library-skills",
+    "click>=8.0",
+    "pyyaml>=6.0",
+    "python-dotenv>=1.0",
+    "jsonschema>=4.0",
+    "httpx>=0.27",
+    "certifi>=2024.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/ioc-project/mas-lab"
+Issues = "https://github.com/ioc-project/mas-lab/issues"
+
+[project.optional-dependencies]
+curses = [
+    "windows-curses>=2.3.2; sys_platform == 'win32'",
+]
+dev = [
+    "pytest>=8.0",
+    "import-linter>=2.0",
+]
+
+[project.scripts]
+mas-ctl = "mas.ctl.cli.main:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/mas"]
+# Test-support helpers (mas.ctl.testing) are used only by the repo test suite and
+# tutorial scenario scripts; they are not part of the public runtime surface and
+# are excluded from the published wheel.
+exclude = ["src/mas/ctl/testing/**"]
+
+# Package a copy of the canonical runtime/lab manifest schemas inside mas.ctl so
+# overlay merging and manifest validation still work when installed from PyPI,
+# where there is no repo checkout to read docs/schemas/ from. See
+# mas.ctl.validate.schemas.schema_root().
+[tool.hatch.build.targets.sdist.force-include]
+"../docs/schemas" = "src/mas/ctl/_schemas"
+
+[tool.uv.sources]
+mas-lab-runtime = { workspace = true }
+mas-lab-library-standard = { workspace = true }

mas_lab_ctl-0.2.0/src/mas/ctl/__init__.py

@@ -0,0 +1,11 @@
+#  Copyright (c) 2026 Cisco Systems, Inc. and its affiliates
+#  SPDX-License-Identifier: Apache-2.0
+"""MAS ctl — compose, placement, session UI, protocol adapters (not the Mealy kernel)."""
+
+from mas.ctl.session.controller import ConversationConfig, SessionController, TurnResult
+
+__all__ = [
+    "ConversationConfig",
+    "SessionController",
+    "TurnResult",
+]