agent-teams 0.0.3__tar.gz

agent_teams-0.0.3/.gitignore

@@ -0,0 +1,141 @@
+*.egg-info/
+.ipynb_checkpoints
+
+# Node / TypeScript (the @datalayer/agent-teams package)
+node_modules/
+*.tsbuildinfo
+package-lock.json
+
+# Created by https://www.gitignore.io/api/python
+# Edit at https://www.gitignore.io/?templates=python
+
+### Python ###
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+dist/
+downloads/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+.installed.cfg
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Environment variables:
+.env
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# pyenv
+.python-version
+
+# celery beat schedule file
+celerybeat-schedule
+
+# SageMath parsed files
+*.sage.py
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# Mr Developer
+.mr.developer.cfg
+.project
+.pydevproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# ruff
+.ruff_cache
+
+# Pyre type checker
+.pyre/
+
+# End of https://www.gitignore.io/api/python
+
+# OSX files
+.DS_Store
+
+# Include
+!**/.*ignore
+!**/.*rc
+!**/.*rc.js
+!**/.*rc.json
+!**/.*rc.yml
+!**/.*config
+!*.*rc.json
+!.github
+!.devcontainer
+
+untracked_notebooks/*
+.jupyter_ystore
+.jupyter_ystore.db
+docs/.yarn/*
+
+uv.lock
+
+generated
+skills
+examples/agent/*.txt
+
+launcher.py
+
+!docs/docs/skills
+!examples/**/skills
+!skills

agent_teams-0.0.3/.licenserc.yaml

@@ -0,0 +1,18 @@
+header:
+  license:
+    content: |
+      Copyright (c) 2025-2026 Datalayer, Inc.
+
+      BSD 3-Clause License
+
+
+  paths-ignore:
+    - '**/*.ipynb'
+    - '**/*.json'
+    - '**/*.yaml'
+    - '**/*.yml'
+    - '**/.*'
+    - 'docs/**/*'
+    - 'LICENSE'
+
+  comment: on-failure

agent_teams-0.0.3/.pre-commit-config.yaml

@@ -0,0 +1,38 @@
+ci:
+  autoupdate_schedule: monthly
+
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: end-of-file-fixer
+      - id: check-case-conflict
+      - id: check-executables-have-shebangs
+      - id: requirements-txt-fixer
+      - id: check-added-large-files
+      - id: check-case-conflict
+      - id: check-toml
+      - id: check-yaml
+      - id: debug-statements
+      - id: forbid-new-submodules
+      - id: check-builtin-literals
+      - id: trailing-whitespace
+
+  - repo: https://github.com/python-jsonschema/check-jsonschema
+    rev: 0.29.4
+    hooks:
+      - id: check-github-workflows
+
+  - repo: https://github.com/executablebooks/mdformat
+    rev: 0.7.19
+    hooks:
+      - id: mdformat
+        additional_dependencies:
+          [mdformat-gfm, mdformat-frontmatter, mdformat-footnote]
+
+  - repo: https://github.com/charliermarsh/ruff-pre-commit
+    rev: v0.8.0
+    hooks:
+      - id: ruff
+        args: ["--fix"]
+      - id: ruff-format

agent_teams-0.0.3/.vscode/settings.json

@@ -0,0 +1,9 @@
+{
+    "python-envs.pythonProjects": [
+        {
+            "path": ".",
+            "envManager": "ms-python.python:conda",
+            "packageManager": "ms-python.python:conda"
+        }
+    ]
+}

agent_teams-0.0.3/CHANGELOG.md

@@ -0,0 +1,7 @@
+<!--
+  ~ Copyright (c) 2025-2026 Datalayer, Inc.
+  ~
+  ~ BSD 3-Clause License
+-->
+
+# Changelog

agent_teams-0.0.3/Dockerfile

@@ -0,0 +1,19 @@
+# Copyright (c) 2025-2026 Datalayer, Inc.
+#
+# BSD 3-Clause License
+
+FROM python:3.10-slim
+
+WORKDIR /app
+
+COPY pyproject.toml pyproject.toml
+COPY LICENSE LICENSE
+COPY README.md README.md
+COPY agent_teams/* agent_teams/
+
+RUN pip install -e .
+
+RUN pip uninstall -y pycrdt datalayer_pycrdt
+RUN pip install datalayer_pycrdt==0.12.17
+
+CMD ["python", "-m", "agent_teams.server"]

agent_teams-0.0.3/LICENSE

@@ -0,0 +1,29 @@
+BSD 3-Clause License
+
+Copyright (c) 2025, Datalayer
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

agent_teams-0.0.3/Makefile

@@ -0,0 +1,98 @@
+# Copyright (c) 2025-2026 Datalayer, Inc.
+#
+# BSD 3-Clause License
+
+SHELL=/bin/bash
+
+.DEFAULT_GOAL := default
+
+.PHONY: clean build test
+
+VERSION = "0.0.3"
+
+default: all ## Default target is all.
+
+help: ## display this help.
+	@awk 'BEGIN {FS = ":.*##"; printf "\nUsage:\n  make \033[36m<target>\033[0m\n"} /^[a-zA-Z_-]+:.*?##/ { printf "  \033[36m%-15s\033[0m %s\n", $$1, $$2 } /^##@/ { printf "\n\033[1m%s\033[0m\n", substr($$0, 5) } ' $(MAKEFILE_LIST)
+
+all: clean dev ## Clean Install and Build
+
+install:
+	pip install .
+
+dev:
+	pip install ".[test,lint,typing]"
+
+build:
+	pip install build
+	python -m build .
+
+clean: ## clean
+	git clean -fdx
+
+clean-npm: ## clean-npm
+	npm run clean
+
+build-npm: ## build-npm
+	npm run build
+
+build-lib: ## build-lib
+	npm run build:lib
+
+warning:
+	echo "\x1b[34m\x1b[43mEnsure you have run \x1b[1;37m\x1b[41m conda deactivate \x1b[22m\x1b[34m\x1b[43m before invoking this.\x1b[0m"
+
+publish-npm: clean-npm build-lib ## publish-npm
+	npm publish
+	echo open https://www.npmjs.com/package/@datalayer/agent-teams --public
+
+test: ## Run tests
+	python -m pytest tests/ -v
+
+start-agent: ## Start the MCP agent CLI (stdio server). Usage: make start-agent [MODEL=<model>]
+	python examples/agent/agent_cli.py $(if $(MODEL),--model $(MODEL),)
+
+start-agent-teams: ## Start the Agent Teams agent CLI (stdio server). Usage: make start-agent-teams [MODEL=<model>]
+	python examples/agent/agent_cli.py --codemode $(if $(MODEL),--model $(MODEL),)
+
+build-docker:
+	docker buildx build --platform linux/amd64,linux/arm64 -t datalayer/agent-teams:${VERSION} .
+	docker image tag datalayer/agent-teams:${VERSION} datalayer/agent-teams:latest
+
+start-docker:
+	docker run -i --rm \
+	  -e SERVER_URL=http://localhost:8888 \
+	  -e TOKEN=MY_TOKEN \
+	  -e NOTEBOOK_PATH=notebook.ipynb \
+	  --network=host \
+	  datalayer/agent-teams:latest
+
+pull-docker:
+	docker image pull datalayer/agent-teams:latest
+
+push-docker:
+	docker push datalayer/agent-teams:${VERSION}
+	docker push datalayer/agent-teams:latest
+
+claude-linux:
+	NIXPKGS_ALLOW_UNFREE=1 nix run github:k3d3/claude-desktop-linux-flake \
+		--impure \
+		--extra-experimental-features flakes \
+		--extra-experimental-features nix-command
+
+jupyterlab:
+	pip uninstall -y pycrdt datalayer_pycrdt
+	pip install datalayer_pycrdt
+	jupyter lab \
+		--port 8888 \
+		--ip 0.0.0.0 \
+		--ServerApp.root_dir ./dev/content \
+		--IdentityProvider.token MY_TOKEN
+
+publish-pypi: # publish the pypi package
+	git clean -fdx && \
+		python -m build
+	@exec echo
+	@exec echo twine upload ./dist/*-py3-none-any.whl
+	@exec echo
+	@exec echo https://pypi.org/project/agent-teams/#history

agent_teams-0.0.3/PKG-INFO

@@ -0,0 +1,132 @@
+Metadata-Version: 2.5
+Name: agent_teams
+Version: 0.0.3
+Project-URL: Home, https://github.com/datalayer/agent-teams
+Author-email: Datalayer <info@datalayer.io>
+License: BSD 3-Clause License
+        
+        Copyright (c) 2025, Datalayer
+        All rights reserved.
+        
+        Redistribution and use in source and binary forms, with or without
+        modification, are permitted provided that the following conditions are met:
+        
+        1. Redistributions of source code must retain the above copyright notice, this
+           list of conditions and the following disclaimer.
+        
+        2. Redistributions in binary form must reproduce the above copyright notice,
+           this list of conditions and the following disclaimer in the documentation
+           and/or other materials provided with the distribution.
+        
+        3. Neither the name of the copyright holder nor the names of its
+           contributors may be used to endorse or promote products derived from
+           this software without specific prior written permission.
+        
+        THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+        AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+        IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+        DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+        FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+        DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+        SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+        CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+        OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+        OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+License-File: LICENSE
+Keywords: A2A,AI,Agents,Jupyter,Orchestration,Teams
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.10
+Requires-Dist: fastapi>=0.100
+Requires-Dist: httpx>=0.24
+Requires-Dist: pydantic>=2.0
+Requires-Dist: typer>=0.9
+Requires-Dist: uvicorn[standard]>=0.20
+Provides-Extra: a2a
+Requires-Dist: fasta2a<2.1,>=2.0.0; extra == 'a2a'
+Provides-Extra: all
+Requires-Dist: fasta2a<2.1,>=2.0.0; extra == 'all'
+Requires-Dist: mcp[cli]>=1.0; extra == 'all'
+Requires-Dist: pydantic-ai-slim>=1.94.0; extra == 'all'
+Requires-Dist: pydantic-graph>=1.94.0; extra == 'all'
+Provides-Extra: lint
+Requires-Dist: mdformat-gfm>=0.3.5; extra == 'lint'
+Requires-Dist: mdformat>0.7; extra == 'lint'
+Requires-Dist: ruff; extra == 'lint'
+Provides-Extra: mcp
+Requires-Dist: mcp[cli]>=1.0; extra == 'mcp'
+Provides-Extra: pydantic-ai
+Requires-Dist: pydantic-ai-slim>=1.94.0; extra == 'pydantic-ai'
+Requires-Dist: pydantic-graph>=1.94.0; extra == 'pydantic-ai'
+Provides-Extra: test
+Requires-Dist: anyio; extra == 'test'
+Requires-Dist: fasta2a; extra == 'test'
+Requires-Dist: httpx>=0.24; extra == 'test'
+Requires-Dist: pytest-asyncio>=0.21; extra == 'test'
+Requires-Dist: pytest>=7.0; extra == 'test'
+Provides-Extra: typing
+Requires-Dist: mypy>=0.990; extra == 'typing'
+Description-Content-Type: text/markdown
+
+<!--
+  ~ Copyright (c) 2025-2026 Datalayer, Inc.
+  ~
+  ~ BSD 3-Clause License
+-->
+
+[![Datalayer](https://assets.datalayer.tech/datalayer-25.svg)](https://datalayer.io)
+
+[![Become a Sponsor](https://img.shields.io/static/v1?label=Become%20a%20Sponsor&message=%E2%9D%A4&logo=GitHub&style=flat&color=1ABC9C)](https://github.com/sponsors/datalayer)
+
+# 🤖 👥 Agent Teams
+
+[![PyPI - Version](https://img.shields.io/pypi/v/agent-teams)](https://pypi.org/project/agent-teams)
+[![npm](https://img.shields.io/npm/v/%40datalayer%2Fagent-teams)](https://www.npmjs.com/package/@datalayer/agent-teams)
+
+## The Datalayer orchestration extension
+
+`agent_teams.a2a` (Python) and `@datalayer/agent-teams` (TypeScript)
+implement the [Datalayer orchestration
+extension](https://datalayer.ai/extensions/orchestration/v1) — an optional
+A2A extension that lets a worker and an orchestrator say the things about
+*delegated work* that A2A leaves unsaid: which execution a delegation is
+part of and where it sits in its tree, a budget to decline before
+exceeding, a checkpoint to resume from, and instructions delivered to a
+turn already in progress.
+
+```python
+from agent_teams.a2a import ExecutionRef, build_delegation_meta
+
+meta = build_delegation_meta(
+    ExecutionRef(execution_id="exec_1", root_execution_id="exec_1", depth=0),
+    budget={"outputTokens": 4000},
+)
+```
+
+```typescript
+import { buildDelegationMeta } from '@datalayer/agent-teams';
+
+const meta = buildDelegationMeta(
+  { executionId: 'exec_1', rootExecutionId: 'exec_1', depth: 0 },
+  { budget: { outputTokens: 4000 } },
+);
+```
+
+Nothing here requires the rest of this package, and nothing here imports
+Datalayer's own platform — `agent_teams.a2a.orchestration_extension` and
+`@datalayer/agent-teams`'s `src/orchestrationExtension.ts` are each a
+standalone module (Python built on `fasta2a` alone; TypeScript with zero
+runtime dependencies at all) implementing the identical wire shape, field
+for field. A worker implementing none of it still runs; see the normative
+specification and its JSON Schema at
+[`docs/extension-v1.md`](https://github.com/datalayer-research/context-orchestration-protocols/blob/main/docs/extension-v1.md)
+for the full field-by-field contract both modules implement.
+
+This is distinct from `agent_teams.a2a.extensions`' own
+**team-coordination** extension (`https://datalayer.io/ext/team-coordination/v1`)
+— member assignment, task dependencies, health and reactions for a team's
+*own* internal coordination. The two extensions are independent and
+separately negotiated; a card may advertise either, both, or neither.

agent_teams-0.0.3/README.md

@@ -0,0 +1,59 @@
+<!--
+  ~ Copyright (c) 2025-2026 Datalayer, Inc.
+  ~
+  ~ BSD 3-Clause License
+-->
+
+[![Datalayer](https://assets.datalayer.tech/datalayer-25.svg)](https://datalayer.io)
+
+[![Become a Sponsor](https://img.shields.io/static/v1?label=Become%20a%20Sponsor&message=%E2%9D%A4&logo=GitHub&style=flat&color=1ABC9C)](https://github.com/sponsors/datalayer)
+
+# 🤖 👥 Agent Teams
+
+[![PyPI - Version](https://img.shields.io/pypi/v/agent-teams)](https://pypi.org/project/agent-teams)
+[![npm](https://img.shields.io/npm/v/%40datalayer%2Fagent-teams)](https://www.npmjs.com/package/@datalayer/agent-teams)
+
+## The Datalayer orchestration extension
+
+`agent_teams.a2a` (Python) and `@datalayer/agent-teams` (TypeScript)
+implement the [Datalayer orchestration
+extension](https://datalayer.ai/extensions/orchestration/v1) — an optional
+A2A extension that lets a worker and an orchestrator say the things about
+*delegated work* that A2A leaves unsaid: which execution a delegation is
+part of and where it sits in its tree, a budget to decline before
+exceeding, a checkpoint to resume from, and instructions delivered to a
+turn already in progress.
+
+```python
+from agent_teams.a2a import ExecutionRef, build_delegation_meta
+
+meta = build_delegation_meta(
+    ExecutionRef(execution_id="exec_1", root_execution_id="exec_1", depth=0),
+    budget={"outputTokens": 4000},
+)
+```
+
+```typescript
+import { buildDelegationMeta } from '@datalayer/agent-teams';
+
+const meta = buildDelegationMeta(
+  { executionId: 'exec_1', rootExecutionId: 'exec_1', depth: 0 },
+  { budget: { outputTokens: 4000 } },
+);
+```
+
+Nothing here requires the rest of this package, and nothing here imports
+Datalayer's own platform — `agent_teams.a2a.orchestration_extension` and
+`@datalayer/agent-teams`'s `src/orchestrationExtension.ts` are each a
+standalone module (Python built on `fasta2a` alone; TypeScript with zero
+runtime dependencies at all) implementing the identical wire shape, field
+for field. A worker implementing none of it still runs; see the normative
+specification and its JSON Schema at
+[`docs/extension-v1.md`](https://github.com/datalayer-research/context-orchestration-protocols/blob/main/docs/extension-v1.md)
+for the full field-by-field contract both modules implement.
+
+This is distinct from `agent_teams.a2a.extensions`' own
+**team-coordination** extension (`https://datalayer.io/ext/team-coordination/v1`)
+— member assignment, task dependencies, health and reactions for a team's
+*own* internal coordination. The two extensions are independent and
+separately negotiated; a card may advertise either, both, or neither.