teamrunner 0.0.1__tar.gz → 0.0.2__tar.gz

teamrunner-0.0.2/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,37 @@
+name: Bug report
+description: Something went wrong, or did not do what the README says
+labels: [bug]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for trying TeamRunner. Please **never paste an API key**. A run folder
+        holds everything said in the run, so paste only the parts you are happy to make
+        public. A security problem? Please email security@teamrunner.ai instead.
+  - type: textarea
+    id: what
+    attributes:
+      label: What happened
+      description: What you ran, what you expected, and what you got. Paste error messages as text.
+    validations:
+      required: true
+  - type: input
+    id: version
+    attributes:
+      label: TeamRunner version
+      description: The output of `teamrunner --version`
+      placeholder: teamrunner 0.0.2
+    validations:
+      required: true
+  - type: input
+    id: system
+    attributes:
+      label: Operating system and Python
+      placeholder: macOS 15, Python 3.12
+    validations:
+      required: true
+  - type: textarea
+    id: team
+    attributes:
+      label: The team, if it helps
+      description: The files involved (team.yaml, chair.md, a member's file), or `teamrunner explain` output.

teamrunner-0.0.2/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,8 @@
+blank_issues_enabled: true
+contact_links:
+  - name: Report a security problem privately
+    url: https://github.com/teamrunner/teamrunner/blob/main/SECURITY.md
+    about: Please do not report security problems in a public issue.
+  - name: No GitHub account? Email us
+    url: https://github.com/teamrunner/teamrunner#questions-bugs-and-ideas
+    about: Comments, questions and bug reports by email, to hello@teamrunner.ai.

teamrunner-0.0.2/.github/ISSUE_TEMPLATE/question.yml

@@ -0,0 +1,18 @@
+name: Question or idea
+description: How do I…? Could TeamRunner…? Or anything else you noticed
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Questions and ideas are as welcome as bugs. Please never paste an API key.
+  - type: textarea
+    id: question
+    attributes:
+      label: Your question or idea
+    validations:
+      required: true
+  - type: input
+    id: version
+    attributes:
+      label: TeamRunner version, if it matters
+      placeholder: teamrunner 0.0.2

teamrunner-0.0.2/.github/workflows/publish.yml

@@ -0,0 +1,66 @@
+name: Publish to PyPI
+
+# A published GitHub release builds the package once, tests exactly those files on every
+# system the tests run on, and only then publishes them, from the `pypi` environment
+# (where a required approval is set). Started by hand, it builds and tests but never
+# publishes: a rehearsal of a release.
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1  # v7.0.1
+      - uses: actions/setup-python@6d4fd22b20465ccc0f7354476588e8df7c9ca0e0  # v7.1.0
+        with:
+          python-version: "3.12"
+
+      - name: The release names this version
+        if: github.event_name == 'release'
+        shell: bash
+        env:
+          TAG: ${{ github.event.release.tag_name }}
+        run: |
+          version=$(python -c "import tomllib; print(tomllib.load(open('pyproject.toml', 'rb'))['project']['version'])")
+          if [ "${TAG#v}" != "$version" ]; then
+            echo "The release is $TAG, but pyproject.toml says $version"; exit 1
+          fi
+
+      - name: Build the wheel and the sdist
+        run: |
+          python -m pip install --upgrade build
+          python -m build
+
+      - uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9  # v7.0.2
+        with:
+          name: dist
+          path: dist/
+          if-no-files-found: error
+
+  test:
+    needs: build
+    uses: ./.github/workflows/tests.yml
+    with:
+      dist: dist
+
+  publish:
+    needs: test
+    if: github.event_name == 'release'
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write # PyPI Trusted Publishing (OIDC)
+      contents: read
+    steps:
+      - uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333  # v8.0.2
+        with:
+          name: dist
+          path: dist
+      - uses: pypa/gh-action-pypi-publish@7245906fb61fa33a13554f9d5fb856fe61758086  # v1.14.3

teamrunner-0.0.2/.github/workflows/tests.yml

@@ -0,0 +1,70 @@
+name: Tests
+
+# Every push and pull request: build the wheel, install it into a clean Python, and run the
+# tests against the installed copy, on Linux, macOS and Windows, on the oldest and newest
+# Python claimed. Then make a team from a shipped example and check it, as a new user would.
+# No model is called and no key is needed.
+
+on:
+  push:
+  pull_request:
+  # The publishing workflow calls this one on the files it is about to publish
+  workflow_call:
+    inputs:
+      dist:
+        description: the name of an artifact holding the wheel to test, instead of building one
+        type: string
+        default: ""
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        python: ["3.10", "3.13"]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1  # v7.0.1
+      - uses: actions/setup-python@6d4fd22b20465ccc0f7354476588e8df7c9ca0e0  # v7.1.0
+        with:
+          python-version: ${{ matrix.python }}
+
+      - name: Build the wheel
+        if: inputs.dist == ''
+        shell: bash
+        run: |
+          python -m pip install --upgrade pip build
+          python -m build
+
+      - name: Take the wheel being published
+        if: inputs.dist != ''
+        uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333  # v8.0.2
+        with:
+          name: ${{ inputs.dist }}
+          path: dist
+
+      - name: Install it
+        shell: bash
+        run: python -m pip install dist/*.whl pytest
+
+      # src/ is never on the path, so the tests import the installed copy
+      - name: Tests
+        run: python -m pytest -q
+
+      # From an empty folder, in PowerShell everywhere (so Windows gets its own shell),
+      # stopping at the first command that fails
+      - name: A new team from a shipped example
+        shell: pwsh
+        working-directory: ${{ runner.temp }}
+        run: |
+          $PSNativeCommandUseErrorActionPreference = $true
+          teamrunner --version
+          teamrunner new debate --from multi_agent_debate
+          teamrunner validate debate
+          teamrunner explain debate
+          teamrunner run debate --rehearse -m "Should cities ban cars from their centres?"
+          teamrunner runs debate

{teamrunner-0.0.1 → teamrunner-0.0.2}/.gitignore

@@ -12,3 +12,6 @@ build/
 
 # OS
 .DS_Store
+
+# Pyodide fetched by the sandbox tests
+.cache/

teamrunner-0.0.2/CHANGELOG.md

@@ -0,0 +1,39 @@
+# Changelog
+
+TeamRunner is in preview: 0.0.x versions are a soft launch, and until 0.1.0
+is announced a version may change in ways that break teams and run folders
+made with an earlier one. Each such change is listed here.
+
+## 0.0.2 — the first preview
+
+What the roadmap calls 0.1, the org package: a folder of text files that gets
+a job done.
+
+- **Teams from files**: a folder with `team.yaml` is a team; each member is a
+  Markdown file (settings on top, the prompt as prose); `chair.md` is the
+  script of who acts when, with rounds and decisions; with no chair, members
+  take turns in name order. Model profiles in `models/` share a model and its
+  settings across a team.
+- **Commands**: `new` (empty, `--from` an example or another team, or
+  `--describe` for a team written by a model), `validate` (with `--online`
+  to check the models), `explain`, `run` (with `--message`, `--file`,
+  `--task-file`; `--rehearse` runs the whole flow with no model and no cost),
+  `runs`, `show`, `gather`, `skill`.
+- **Toolkeepers** hold the tools, with an access list and guardrails, and four
+  built-in tools: `web_search_brave`, `read_page`, `read_file`, and `run_code`
+  (Python in a WebAssembly sandbox).
+- **Every run is logged** in the team's `runs/` folder: `run.json`,
+  `events.jsonl` and `output.md`, with costs, and the Python, LiteLLM and Deno
+  versions it ran on. Search results are read by the team but not kept,
+  unless `keep_results: true`.
+- **Six examples ship**: `round_robin`, `multi_agent_debate`,
+  `orchestrators_lite`, `fact_checked`, `reference_check`, and
+  `hiring_committee` (a hidden-profile task, after Stasser and Titus 1985).
+- Models from OpenAI, Anthropic and Google, and local models through Ollama.
+  macOS, Linux and Windows; Python 3.10 to 3.13.
+- Licensed GPL-3.0-or-later; the examples, the files `new` writes and the
+  authoring guide are MIT-0.
+
+## 0.0.1
+
+Reserved the name on PyPI. No working code.

teamrunner-0.0.2/CLA.md

@@ -0,0 +1,80 @@
+# TeamRunner Individual Contributor License Agreement
+
+Thank you for your interest in contributing to TeamRunner (the "Project").
+
+This Contributor License Agreement ("Agreement") documents the rights granted
+by contributors to the Project's owner, Kumar Muthuraman, and his successors
+and assigns (the "Project Owner"). This Agreement is for your protection as a
+contributor as well as the protection of the Project and its users; it does
+not change your rights to use your own contributions for any other purpose.
+
+By commenting "I have read the CLA Document and I hereby sign the CLA" on a
+pull request in this repository, you accept and agree to the following terms
+and conditions for your present and future Contributions submitted to the
+Project.
+
+## 1. Definitions
+
+**"You"** (or **"Your"**) means the copyright owner or legal entity authorized
+by the copyright owner that is entering into this Agreement.
+
+**"Contribution"** means any original work of authorship, including any
+modifications or additions to an existing work, that You intentionally submit
+to the Project for inclusion in, or documentation of, the Project. "Submit"
+means any form of electronic or written communication sent to the Project,
+including but not limited to pull requests, issues, and comments, but
+excluding communication that You conspicuously mark "Not a Contribution."
+
+## 2. Grant of Copyright License
+
+Subject to the terms of this Agreement, You hereby grant to the Project Owner
+a perpetual, worldwide, non-exclusive, royalty-free, irrevocable copyright
+license to reproduce, prepare derivative works of, publicly display, publicly
+perform, sublicense, and distribute Your Contributions and such derivative
+works, and to license Your Contributions and such derivative works under any
+license terms of the Project Owner's choosing, including open-source,
+source-available, and proprietary licenses.
+
+## 3. Grant of Patent License
+
+Subject to the terms of this Agreement, You hereby grant to the Project Owner
+and to recipients of software distributed by the Project a perpetual,
+worldwide, non-exclusive, royalty-free, irrevocable (except as stated in this
+section) patent license to make, have made, use, offer to sell, sell, import,
+and otherwise transfer Your Contributions, where such license applies only to
+those patent claims licensable by You that are necessarily infringed by Your
+Contributions alone or by combination of Your Contributions with the Project.
+If any entity institutes patent litigation against You or any other entity
+alleging that Your Contribution, or the Project to which You have contributed,
+constitutes direct or contributory patent infringement, then any patent
+licenses granted to that entity under this Agreement for that Contribution or
+the Project shall terminate as of the date such litigation is filed.
+
+## 4. Your Representations
+
+You represent that:
+
+1. You are legally entitled to grant the above licenses.
+2. Each of Your Contributions is Your original creation. Should You wish to
+   submit work that is not Your original creation, You may submit it
+   separately, identifying the complete details of its source and of any
+   license or other restriction of which You are personally aware, and
+   conspicuously marking the work as "Submitted on behalf of a third party."
+3. If Your employer has rights to intellectual property that You create that
+   includes Your Contributions, You have received permission to make the
+   Contributions on behalf of that employer, or Your employer has waived such
+   rights for Your Contributions to the Project.
+4. You will notify the Project if You become aware of any facts or
+   circumstances that would make these representations inaccurate.
+
+## 5. No Obligation and No Warranty
+
+You are not expected to provide support for Your Contributions, except to the
+extent You desire to provide support. Unless required by applicable law or
+agreed to in writing, You provide Your Contributions on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+
+## 6. Retained Rights
+
+Except for the licenses granted herein, You reserve all right, title, and
+interest in and to Your Contributions.

teamrunner-0.0.2/CONTRIBUTING.md

@@ -0,0 +1,25 @@
+# Contributing to TeamRunner
+
+Thanks for your interest in contributing!
+
+## Not accepting pull requests yet
+
+TeamRunner is in early development, and we are not accepting pull requests
+yet. Pull requests opened now will be closed unmerged, so please don't put
+time into one.
+
+What helps most right now is an issue: bug reports, questions, and ideas are
+all very welcome. Please open one in this repository's Issues tab, or, if you
+have no GitHub account, write to hello@teamrunner.ai. Security problems go to
+security@teamrunner.ai (see SECURITY.md), not to an issue.
+
+We will announce here when pull requests open.
+
+## Contributor License Agreement
+
+Once pull requests open, you will need to sign our
+[Contributor License Agreement](CLA.md) before your first one can be merged.
+It's a one-time step that covers all your future contributions.
+
+The CLA keeps the project's ownership unambiguous — it protects both you
+and the project. TeamRunner itself remains licensed under GPL-3.0-or-later.