agentpool-cli 0.1.0__tar.gz → 0.1.1__tar.gz

agentpool_cli-0.1.1/CHANGELOG.md

@@ -0,0 +1,23 @@
+# Changelog
+
+## Unreleased
+
+## 0.1.1 - 2026-05-29
+
+- Add command descriptions to `doctor`, `init`, `inventory`, `usage`,
+  `capacity-summary`, `setup`, `onboard`, `providers`, and `models` so `--help`
+  documents the full surface.
+- `spawn` now returns a top-level `session_id` (mirroring the nested
+  `session.id`) so it matches `observe`/`send`/`collect`; `terminate` now
+  includes `session_id` alongside `ok`/`state`.
+- `agentpool://quickstart` now serves a distinct quickstart guide instead of
+  aliasing `agentpool://skill.md`.
+- Publish `agentpool-cli` to PyPI; add the PyPI package entry to `server.json`
+  for the MCP registry.
+
+## 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 → agentpool_cli-0.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentpool-cli
-Version: 0.1.0
+Version: 0.1.1
 Summary: Local MCP-exposed control plane for live coding-agent sessions.
 Author: AgentPool contributors
 License-Expression: MIT

agentpool_cli-0.1.1/docs/quickstart.md

@@ -0,0 +1,56 @@
+# AgentPool Quickstart
+
+The shortest path from install to a working worker. AgentPool is a local
+control plane: you pick the provider and model explicitly; it never routes for
+you.
+
+## 1. Verify the environment
+
+```bash
+agentpool init
+agentpool doctor --deep --privacy
+```
+
+`doctor` confirms `tmux`, SQLite, and the artifact root, and lists each
+provider's install/auth state.
+
+## 2. Smoke test without a real provider
+
+```bash
+agentpool smoke --provider fake-question --repo . --json
+```
+
+A packaged fake provider runs the full spawn -> question -> send -> complete
+cycle. `"ok": true` means the control plane works end to end.
+
+## 3. See live provider and usage state
+
+```bash
+agentpool inventory --json
+agentpool usage-summary --json          # add --refresh for live probes
+```
+
+## 4. Run a real worker (explicit provider + isolation)
+
+```bash
+agentpool spawn --provider <provider-id> --repo . \
+  --task "Inspect this repo and ask one clarifying question." \
+  --isolation read_only --json
+```
+
+The result includes a top-level `session_id`. Drive it with:
+
+```bash
+agentpool observe <session-id> --wait-for question,completed,error --timeout 120 --json
+agentpool send <session-id> "Continue with the smallest useful check." --json
+agentpool collect <session-id> --json
+agentpool terminate <session-id> --json
+```
+
+Use `--isolation worktree` instead of `read_only` for tasks that edit files.
+
+## Next
+
+- Full agent guidance: `agentpool://skill.md`
+- Setup and privacy detail: `agentpool://onboarding`
+- MCP host config: `agentpool mcp-config --client <host> --absolute-command --install`

{agentpool_cli-0.1.0 → agentpool_cli-0.1.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "agentpool-cli"
-version = "0.1.0"
+version = "0.1.1"
 description = "Local MCP-exposed control plane for live coding-agent sessions."
 readme = "README.md"
 requires-python = ">=3.11"
@@ -31,6 +31,9 @@ dev = [
 
 [project.scripts]
 agentpool = "agentpool.cli:app"
+# Alias matching the PyPI distribution name so `uvx agentpool-cli mcp` resolves
+# (MCP registry runs the package by its identifier). Primary command stays `agentpool`.
+agentpool-cli = "agentpool.cli:app"
 
 [tool.pytest.ini_options]
 testpaths = ["tests"]
@@ -51,3 +54,4 @@ include = [
 [tool.hatch.build.targets.wheel.force-include]
 "docs/agentpool-skill.md" = "agentpool/docs/agentpool-skill.md"
 "docs/onboarding.md" = "agentpool/docs/onboarding.md"
+"docs/quickstart.md" = "agentpool/docs/quickstart.md"

agentpool_cli-0.1.1/server.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.sidduhere/agentpool",
+  "title": "AgentPool",
+  "description": "Local MCP control plane for coding-agent inventory, usage, spawn, and observe.",
+  "version": "0.1.1",
+  "repository": {
+    "url": "https://github.com/sidduHERE/agentpool",
+    "source": "github"
+  },
+  "websiteUrl": "https://github.com/sidduHERE/agentpool",
+  "packages": [
+    {
+      "registryType": "pypi",
+      "identifier": "agentpool-cli",
+      "version": "0.1.1",
+      "transport": {
+        "type": "stdio"
+      },
+      "packageArguments": [
+        {
+          "type": "positional",
+          "value": "mcp"
+        }
+      ]
+    }
+  ]
+}

{agentpool_cli-0.1.0 → agentpool_cli-0.1.1}/src/agentpool/__init__.py

@@ -1,3 +1,3 @@
 """AgentPool local agent control plane."""
 
-__version__ = "0.1.0"
+__version__ = "0.1.1"

{agentpool_cli-0.1.0 → agentpool_cli-0.1.1}/src/agentpool/cli.py

@@ -119,7 +119,7 @@ def _next_command_for_error(exc: ToolError) -> str | None:
     return None
 
 
-@app.command()
+@app.command(help="Check environment, runtime, and provider health.")
 def doctor(
     json_output: Annotated[bool, typer.Option("--json", help="Emit JSON.")] = False,
     deep: Annotated[bool, typer.Option("--deep", help="Run tmux/sqlite/artifact/cache checks.")] = False,
@@ -179,7 +179,7 @@ def doctor(
         console.print(f"  {command}")
 
 
-@app.command("init")
+@app.command("init", help="Initialize AgentPool config and local state.")
 def init_command(
     path: Annotated[Path, typer.Option("--path", help="Config path to initialize.")] = DEFAULT_CONFIG_PATH,
     force: Annotated[bool, typer.Option("--force", help="Back up and overwrite existing config.")] = False,
@@ -248,7 +248,7 @@ def mcp_config(
         console.print_json(json.dumps(data["config"]))
 
 
-@app.command()
+@app.command(help="List providers with install, auth, model, and usage state.")
 def inventory(json_output: Annotated[bool, typer.Option("--json", help="Emit JSON.")] = False) -> None:
     data = manager().inventory(include_usage=True)
     if json_output:
@@ -266,7 +266,7 @@ def inventory(json_output: Annotated[bool, typer.Option("--json", help="Emit JSO
         console.print(table)
 
 
-@app.command()
+@app.command(help="Show a provider usage snapshot (cached or freshly probed).")
 def usage(
     provider: Annotated[str | None, typer.Option("--provider", help="Provider id.")] = None,
     backend: Annotated[
@@ -320,7 +320,7 @@ def usage_summary(
         handle_tool_error(exc, json_output)
 
 
-@app.command("capacity-summary")
+@app.command("capacity-summary", help="Alias of usage-summary (human convenience).")
 def capacity_summary(
     provider: Annotated[str | None, typer.Option("--provider", help="Provider id.")] = None,
     refresh: Annotated[bool, typer.Option("--refresh", help="Run live probes before summarizing.")] = False,
@@ -333,7 +333,7 @@ def capacity_summary(
     usage_summary(provider=provider, refresh=refresh, backend=backend, json_output=json_output)
 
 
-@app.command("setup")
+@app.command("setup", help="Wire AgentPool into an MCP host or provider and report next steps.")
 def setup_command(
     target: Annotated[
         str,
@@ -434,7 +434,7 @@ def setup_command(
         raise typer.Exit(1)
 
 
-@app.command()
+@app.command(help="Print onboarding paths, first commands, and MCP host config.")
 def onboard(json_output: Annotated[bool, typer.Option("--json", help="Emit JSON.")] = False) -> None:
     mgr = manager()
     data = {
@@ -538,7 +538,7 @@ def smoke(
         handle_tool_error(exc, json_output)
 
 
-@app.command()
+@app.command(help="List configured provider ids.")
 def providers(json_output: Annotated[bool, typer.Option("--json", help="Emit JSON.")] = False) -> None:
     data = manager().inventory(include_usage=False)
     if json_output:
@@ -548,7 +548,7 @@ def providers(json_output: Annotated[bool, typer.Option("--json", help="Emit JSO
             console.print(provider["id"])
 
 
-@app.command("models")
+@app.command("models", help="List the model catalog, or validate it with 'models validate'.")
 def models_command(
     action: Annotated[
         str | None,

{agentpool_cli-0.1.0 → agentpool_cli-0.1.1}/src/agentpool/mcp/resources.py

@@ -13,7 +13,7 @@ PROJECT_ROOT = Path(__file__).resolve().parents[3]
 
 def read_resource(manager: SessionManager, uri: str, lockdown: bool = False) -> str:
     if uri == "agentpool://quickstart":
-        return _text_resource("agentpool-skill.md")
+        return _text_resource("quickstart.md")
     if uri == "agentpool://onboarding":
         return _text_resource("onboarding.md")
     if uri == "agentpool://skill.md":

{agentpool_cli-0.1.0 → agentpool_cli-0.1.1}/src/agentpool/session_manager.py

@@ -323,6 +323,7 @@ class SessionManager:
             self.store.save_session(session)
             self._event(session, "send_initial_prompt", state=session.state.value)
         return {
+            "session_id": session.id,
             "session": session.model_dump(mode="json"),
             "attach_command": self.runtime.attach_command(ref),
             "live_control": {
@@ -703,7 +704,7 @@ class SessionManager:
         final_state = state if not active_state(state) else SessionState.CANCELLED
         self.store.update_session_state(session_id, final_state, ended_at=utc_now_iso())
         self._event(session, "terminate", state=final_state.value, metadata={"reason": reason})
-        return {"ok": True, "state": final_state.value}
+        return {"session_id": session_id, "ok": True, "state": final_state.value}
 
     def reconcile_sessions(self) -> dict[str, Any]:
         reconciled = []

{agentpool_cli-0.1.0 → agentpool_cli-0.1.1}/tests/unit/test_onboarding.py

@@ -291,7 +291,15 @@ def test_server_json_matches_package_version() -> None:
     from agentpool import __version__
 
     assert payload["version"] == __version__
-    assert "packages" not in payload
+    # Now that agentpool-cli is on PyPI, server.json advertises the package.
+    packages = payload["packages"]
+    assert len(packages) == 1
+    pkg = packages[0]
+    assert pkg["registryType"] == "pypi"
+    assert pkg["identifier"] == "agentpool-cli"
+    assert pkg["version"] == __version__
+    assert pkg["transport"]["type"] == "stdio"
+    assert pkg["packageArguments"] == [{"type": "positional", "value": "mcp"}]
 
 
 def test_setup_provider_codex_reports_checks_and_mcp_config() -> None:

{agentpool_cli-0.1.0 → agentpool_cli-0.1.1}/uv.lock

@@ -3,7 +3,7 @@ requires-python = ">=3.11"
 
 [[package]]
 name = "agentpool-cli"
-version = "0.1.0"
+version = "0.1.1"
 source = { editable = "." }
 dependencies = [
     { name = "mcp" },

agentpool_cli-0.1.0/CHANGELOG.md

@@ -1,10 +0,0 @@
-# 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/server.json

@@ -1,12 +0,0 @@
-{
-  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
-  "name": "io.github.sidduhere/agentpool",
-  "title": "AgentPool",
-  "description": "Local MCP control plane for coding-agent inventory, usage, spawn, and observe.",
-  "version": "0.1.0",
-  "repository": {
-    "url": "https://github.com/sidduHERE/agentpool",
-    "source": "github"
-  },
-  "websiteUrl": "https://github.com/sidduHERE/agentpool"
-}