agentpool-cli 0.1.0__tar.gz

agentpool_cli-0.1.0/.cursor/mcp.json.example

@@ -0,0 +1,9 @@
+{
+  "mcpServers": {
+    "agentpool": {
+      "type": "stdio",
+      "command": "REPLACE_WITH_ABSOLUTE_AGENTPOOL_PATH",
+      "args": ["mcp"]
+    }
+  }
+}

agentpool_cli-0.1.0/.github/CODEOWNERS

@@ -0,0 +1 @@
+* @sidduHERE

agentpool_cli-0.1.0/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,32 @@
+---
+name: Bug report
+about: Report a reproducible AgentPool issue
+title: ""
+labels: bug
+assignees: ""
+---
+
+## Summary
+
+## Environment
+
+- AgentPool version or commit:
+- OS:
+- Python version:
+- tmux version:
+- Provider id, if relevant:
+
+## Command
+
+```bash
+
+```
+
+## Expected
+
+## Actual
+
+## Notes
+
+Please redact provider tokens, account emails, session cookies, SQLite data, and
+artifact excerpts that may contain private code or credentials.

agentpool_cli-0.1.0/.github/ISSUE_TEMPLATE/provider_probe.md

@@ -0,0 +1,34 @@
+---
+name: Provider probe
+about: Request or fix a provider usage probe
+title: ""
+labels: provider
+assignees: ""
+---
+
+## Provider
+
+## CLI command and version
+
+```bash
+
+```
+
+## Usage surface
+
+What command, local file, or API exposes usage?
+
+## Credential handling
+
+Does it rely on existing CLI auth state, environment variables, browser cookies,
+or a new login flow?
+
+## Quota windows
+
+List any daily, 5-hour, weekly, monthly, credit, on-demand, or session windows
+the provider exposes.
+
+## Notes
+
+AgentPool does not accept browser scraping, credential storage, or provider
+auto-routing as part of provider probes.

agentpool_cli-0.1.0/.github/dependabot.yml

@@ -0,0 +1,6 @@
+version: 2
+updates:
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"

agentpool_cli-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,65 @@
+name: CI
+
+on:
+  push:
+  pull_request:
+
+jobs:
+  test:
+    name: Python ${{ matrix.python-version }}
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12"]
+
+    steps:
+      - name: Check out
+        uses: actions/checkout@v6
+
+      - name: Install tmux
+        run: sudo apt-get update && sudo apt-get install -y tmux
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install package
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -e ".[dev]"
+
+      - name: Run tests
+        run: python -m pytest -q
+
+      - name: Validate embedded model catalog
+        run: agentpool models validate --path src/agentpool/provider_model_catalog.json --json
+
+      - name: Validate default config
+        run: agentpool config validate --json
+
+      - name: Run fake-provider smoke
+        run: agentpool smoke --provider fake-question --repo . --json
+
+      - name: Build wheel
+        run: |
+          python -m pip install build
+          python -m build
+
+      - name: Install wheel in clean venv
+        run: |
+          python -m venv /tmp/agentpool-wheel-venv
+          /tmp/agentpool-wheel-venv/bin/python -m pip install dist/*.whl
+          /tmp/agentpool-wheel-venv/bin/agentpool config validate --json
+          /tmp/agentpool-wheel-venv/bin/agentpool models validate --json
+          /tmp/agentpool-wheel-venv/bin/agentpool smoke --provider fake-question --repo . --json
+          /tmp/agentpool-wheel-venv/bin/python - <<'PY'
+          from agentpool.mcp.resources import read_resource
+          from agentpool.session_manager import SessionManager
+
+          manager = SessionManager()
+          for uri in ("agentpool://quickstart", "agentpool://skill.md", "agentpool://onboarding"):
+              text = read_resource(manager, uri)
+              assert text.startswith("# "), uri
+          PY

agentpool_cli-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,101 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Check out
+        uses: actions/checkout@v6
+
+      - name: Install tmux
+        run: sudo apt-get update && sudo apt-get install -y tmux
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.12"
+
+      - name: Install package
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -e ".[dev]"
+
+      - name: Run release checks
+        run: |
+          python -m pytest -q
+          agentpool models validate --path src/agentpool/provider_model_catalog.json --json
+          agentpool config validate --json
+          agentpool smoke --provider fake-question --repo . --json
+          python -m json.tool server.json >/dev/null
+
+      - name: Build distributions
+        run: |
+          python -m pip install build
+          python -m build
+
+      - name: Verify wheel install
+        run: |
+          python -m venv /tmp/agentpool-wheel-venv
+          /tmp/agentpool-wheel-venv/bin/python -m pip install --upgrade pip
+          /tmp/agentpool-wheel-venv/bin/python -m pip install dist/*.whl
+          /tmp/agentpool-wheel-venv/bin/agentpool config validate --json
+          /tmp/agentpool-wheel-venv/bin/agentpool models validate --json
+          /tmp/agentpool-wheel-venv/bin/agentpool smoke --provider fake-question --repo . --json
+          /tmp/agentpool-wheel-venv/bin/python - <<'PY'
+          from agentpool.mcp.resources import read_resource
+          from agentpool.session_manager import SessionManager
+
+          manager = SessionManager()
+          for uri in ("agentpool://quickstart", "agentpool://skill.md", "agentpool://onboarding"):
+              text = read_resource(manager, uri)
+              assert text.startswith("# "), uri
+          PY
+
+      - name: Upload build artifact
+        uses: actions/upload-artifact@v7
+        with:
+          name: agentpool-dist
+          path: dist/*
+
+      - name: Create GitHub release
+        if: startsWith(github.ref, 'refs/tags/')
+        uses: softprops/action-gh-release@v3
+        with:
+          # Mark as prerelease only for a/b/rc tags (e.g. v0.1.0a9); v0.1.0 is a full release.
+          prerelease: ${{ contains(github.ref_name, 'a') || contains(github.ref_name, 'b') || contains(github.ref_name, 'rc') }}
+          files: |
+            dist/*
+            server.json
+
+  publish-pypi:
+    name: Publish to PyPI
+    needs: release
+    runs-on: ubuntu-latest
+    # Gated on the PUBLISH_TO_PYPI repo variable so tagging never publishes by accident.
+    # Requires a configured PyPI Trusted Publisher and a `pypi` environment.
+    if: startsWith(github.ref, 'refs/tags/') && vars.PUBLISH_TO_PYPI == 'true'
+    environment:
+      name: pypi
+      url: https://pypi.org/p/agentpool-cli
+    permissions:
+      id-token: write
+
+    steps:
+      - name: Download built distributions
+        uses: actions/download-artifact@v7
+        with:
+          name: agentpool-dist
+          path: dist
+
+      - name: Publish to PyPI (Trusted Publishing)
+        uses: pypa/gh-action-pypi-publish@release/v1

agentpool_cli-0.1.0/.gitignore

@@ -0,0 +1,15 @@
+.DS_Store
+.mcp.json
+.cursor/mcp.json
+.venv/
+__pycache__/
+.pytest_cache/
+.ruff_cache/
+*.pyc
+*.pyo
+*.sqlite
+*.sqlite3
+.agentpool-worktrees/
+dist/
+build/
+*.egg-info/

agentpool_cli-0.1.0/.mcp.json.example

@@ -0,0 +1,10 @@
+{
+  "mcpServers": {
+    "agentpool": {
+      "type": "stdio",
+      "command": "REPLACE_WITH_ABSOLUTE_AGENTPOOL_PATH",
+      "args": ["mcp"],
+      "env": {}
+    }
+  }
+}

agentpool_cli-0.1.0/AGENTS.md

@@ -0,0 +1,28 @@
+Talk to the user as a fellow senior developer.
+
+AgentPool is a control plane, not an auto-router. Keep provider/model judgment with the primary agent.
+
+Project guardrails:
+
+- Treat the committed docs as the public source of truth, especially `README.md`,
+  `docs/architecture.md`, `docs/onboarding.md`, `docs/mcp-tools.md`, and
+  `docs/usage-detection.md`.
+- Use Python 3.11+.
+- Use tmux as the first runtime.
+- Preserve explicit provider selection. Do not add `provider=auto`.
+- Do not implement browser scraping, credential storage, model ranking, silent overage, silent merge, or silent push behavior.
+- Add fake-provider coverage before relying on real provider adapters.
+- Prefer worktree isolation for mutating tasks.
+- Use subprocess argument arrays; avoid shell strings for untrusted input.
+- Store sessions, events, usage snapshots, artifacts, and file leases in SQLite.
+- Keep artifacts outside the repo by default under `~/.agentpool/artifacts`.
+
+When AgentPool tools are available:
+
+1. Call inventory or usage before delegating.
+2. Choose provider/model/harness explicitly.
+3. Prefer `read_only` isolation for exploration and review.
+4. Use `worktree` isolation for edits.
+5. Spawn narrow tasks.
+6. Observe, steer, interrupt, collect, and terminate deliberately.
+7. Do not merge or push worker changes without user approval.

agentpool_cli-0.1.0/CHANGELOG.md

@@ -0,0 +1,10 @@
+# Changelog
+
+## Unreleased
+
+## 0.1.0 - 2026-05-29
+
+- First public release of AgentPool: local Python CLI, MCP server,
+  tmux-backed worker lifecycle, explicit provider/model selection, SQLite state,
+  packaged fake providers, conservative usage probes, agent-friendly CLI output,
+  lean MCP toolsets, redaction, session reconciliation, and worktree utilities.

agentpool_cli-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,80 @@
+# Contributing
+
+AgentPool is intentionally small and conservative. Please keep changes aligned
+with the product boundary: local control plane, explicit provider selection,
+truthful capacity data, no routing.
+
+## Local Setup
+
+```bash
+uv venv
+uv pip install -e ".[dev]"
+agentpool init
+agentpool setup cursor
+agentpool doctor --deep --privacy
+```
+
+If you do not have real provider CLIs configured, use the packaged fake
+providers:
+
+```bash
+agentpool smoke --provider fake-question --repo . --json
+```
+
+## Before Opening A PR
+
+Run:
+
+```bash
+.venv/bin/python -m pytest -q
+agentpool models validate --path src/agentpool/provider_model_catalog.json --json
+agentpool config validate --json
+agentpool smoke --provider fake-question --repo . --json
+```
+
+Do not include provider credentials, SQLite databases, artifacts, tmux logs, or
+screenshots containing account data.
+
+## Branching
+
+- `main` is the integration branch.
+- Use short feature branches such as `codex/mcp-client-docs` or
+  `codex/usage-probe-fix`.
+- Prefer pull requests for anything after the initial import.
+- Keep releases tag-driven. Do not hand-edit generated distribution artifacts.
+
+## Design Rules
+
+- Do not add `provider=auto`, ranking, scoring, or provider picking.
+- Do not add browser scraping or credential storage.
+- Add fake-provider coverage before relying on real-provider behavior.
+- Keep real-provider probes explicit and confidence-tagged.
+- Prefer subprocess argument arrays.
+- Keep worktree creation explicit; do not assume ownership of a user's repo
+  layout unless the user requested `--isolation worktree`.
+- Document what a probe reads and stores.
+
+## Provider Changes
+
+For a provider adapter or usage probe, update:
+
+- tests or fake-provider coverage;
+- `docs/provider-adapters.md`;
+- `docs/usage-detection.md`;
+- `README.md` provider matrix when user-visible.
+
+## Releases
+
+Releases are created from tags. See [docs/release.md](docs/release.md) for the
+full checklist, `server.json` alignment, and post-release MCP install smoke.
+
+```bash
+git tag v0.1.0a0
+git push origin v0.1.0a0
+```
+
+The release workflow runs tests, validates config/catalogs and `server.json`,
+runs the packaged fake-provider smoke, builds wheel/sdist artifacts, attaches
+`server.json` to the GitHub prerelease, and creates a GitHub prerelease. PyPI
+publishing is disabled unless repository variable `PUBLISH_TO_PYPI` is set to
+`true` and the PyPI trusted-publishing environment is configured.

agentpool_cli-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AgentPool contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.