Metadata-Version: 2.4
Name: ai-agent-orchestrator
Version: 0.1.0b3
Summary: Model-independent orchestration of external coding-agent runtimes.
Author: belkovrv
Maintainer: belkovrv
License-Expression: MIT
Project-URL: Homepage, https://gitlab.com/belkov.ai-tools/ai-agent-orchestrator
Project-URL: Documentation, https://gitlab.com/belkov.ai-tools/ai-agent-orchestrator/-/blob/main/README.md
Project-URL: Issues, https://gitlab.com/belkov.ai-tools/ai-agent-orchestrator/-/work_items
Project-URL: Repository, https://gitlab.com/belkov.ai-tools/ai-agent-orchestrator
Keywords: ai-agents,automation,cline,claude-code,codex,mcp,orchestration
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Topic :: Software Development :: Build Tools
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: agent-client-protocol<0.13,>=0.12
Requires-Dist: pydantic<3,>=2.12
Provides-Extra: dev
Requires-Dist: build>=1.2; extra == "dev"
Requires-Dist: jsonschema>=4.26; extra == "dev"
Requires-Dist: pytest>=8.0; extra == "dev"
Requires-Dist: twine>=6.1; extra == "dev"
Provides-Extra: docs
Requires-Dist: ai-docs-toolkit==0.1.0b16; extra == "docs"
Provides-Extra: mcp
Requires-Dist: mcp<3,>=2; extra == "mcp"
Dynamic: license-file

# ai-agent-orchestrator

`ai-agent-orchestrator` запускает Codex, Claude Code, Cline и другие coding-agent runtimes как внешние процессы через versioned CLI и MCP contracts.

## Установка

```bash
python -m pip install "ai-agent-orchestrator[mcp]"
```

Требуются Python 3.11 или новее, Linux, Git и Bubblewrap. Runtime CLI устанавливаются отдельно. Authentication может принадлежать runtime либо задаваться literal environment values в user-global/ignored local orchestrator config; job artifacts и public results credential values не хранят.

## Начало работы

```bash
ai-agents --workspace /path/to/repository init
ai-agents --workspace /path/to/repository check
ai-agents --workspace /path/to/repository run --task task.json
```

`init` создаёт отсутствующие consumer-owned bootstrap files и создаёт либо обновляет package-managed instructions в `.ai-agents/docs/`. Он не перезаписывает `AGENTS.md`, config или shared instructions. `check` не выполняет provider call без explicit `--live`. Retained isolated worktrees удаляются только через dry-run-first `prune` и explicit `--apply`.

Task v3 объявляет external resources только через semantic capabilities. Consumer-owned role/profile выбирает exact binding, а resource values существуют только в памяти supervisor и scoped child environment. Provider-specific `transport_profile` отделён от task tools; unsupported runtime/version combinations завершаются fail closed до чтения provider values. Текущий scoped baseline доказан для exact `codex-cli 0.147.0`.

Local MCP server привязан к одному meta-workspace:

```bash
ai-agents-mcp --workspace /absolute/path/to/meta-workspace
```

Для полного делегирования consumer agent вызывает MCP `delegate(task_path)` один раз и получает terminal bounded result без промежуточного polling. `init` материализует [subagent usage](../../ai-docs/guides/subagent-usage.md) и [subagent creation](../../ai-docs/guides/subagent-creation.md) в `.ai-agents/docs/` и обновляет их до exact copies установленного package.

Полные contracts, configuration examples, host setup, upgrade и rollback procedures находятся в [репозитории проекта](https://gitlab.com/belkov.ai-tools/ai-agent-orchestrator).

## Лицензия

MIT. Copyright (c) 2026 belkovrv.
