agentnet-cli 0.1.0__py3-none-any.whl

agentnet_cli/updater.py

@@ -0,0 +1,123 @@
+from __future__ import annotations
+
+import re
+import shutil
+import subprocess
+import sys
+
+from rich.console import Console
+
+from . import __version__
+from .agents.registry import get_connector
+from .config import load_config
+from .manifest import load_manifest, record_connection
+from .paths import AgentName
+
+_err = Console(stderr=True)
+
+
+def refresh_stale_connections(*, quiet: bool = False) -> int:
+    """Re-run connect() for agents whose manifest cli_version != current version."""
+    config = load_config()
+    if not config or not config.get("api_token"):
+        return 0
+
+    manifest = load_manifest()
+    connections = manifest.get("connections", {})
+    if not connections:
+        return 0
+
+    refreshed = 0
+    for agent_name, conn_info in list(connections.items()):
+        if conn_info.get("cli_version") == __version__:
+            continue
+
+        try:
+            agent_enum = AgentName(agent_name)
+            connector = get_connector(agent_enum)
+            detection = connector.detect()
+            if not detection.detected:
+                continue
+
+            result = connector.connect(config)
+            if result.success:
+                record_connection(
+                    agent_name,
+                    files_created=result.files_created,
+                    files_modified=result.files_modified,
+                    mcp_entry=result.mcp_entry,
+                )
+                refreshed += 1
+            else:
+                print(f"Warning: refresh for {agent_name} returned success=False", file=sys.stderr)
+        except (OSError, ValueError, KeyError) as exc:
+            print(f"Warning: failed to refresh {agent_name}: {exc}", file=sys.stderr)
+            continue
+
+    if refreshed and not quiet:
+        _err.print(
+            f"  [dim]Refreshed {refreshed} agent config(s) for v{__version__}[/dim]"
+        )
+
+    return refreshed
+
+
+def check_pypi_latest() -> str | None:
+    """Check PyPI for the latest published version."""
+    try:
+        import httpx  # noqa: PLC0415
+
+        resp = httpx.get(
+            "https://pypi.org/pypi/agentnet-cli/json",
+            timeout=5.0,
+            follow_redirects=True,
+        )
+        if resp.status_code == 200:
+            return resp.json()["info"]["version"]
+    except Exception:
+        pass
+    return None
+
+
+def self_upgrade() -> tuple[bool, str]:
+    """Upgrade agentnet-cli to latest. Returns (success, message)."""
+    cmd = _upgrade_command()
+    try:
+        result = subprocess.run(cmd, capture_output=True, text=True, timeout=120)
+        if result.returncode == 0:
+            latest = check_pypi_latest()
+            return True, latest or "latest"
+        return False, result.stderr.strip()[:200]
+    except Exception as e:
+        return False, str(e)
+
+
+def _upgrade_command() -> list[str]:
+    """Detect install method and return the right upgrade command."""
+    if shutil.which("uv"):
+        try:
+            r = subprocess.run(
+                ["uv", "tool", "list"],
+                capture_output=True,
+                text=True,
+                timeout=10,
+            )
+            if re.search(r"^agentnet-cli\b", r.stdout, re.MULTILINE):
+                return ["uv", "tool", "upgrade", "agentnet-cli"]
+        except Exception:
+            pass
+
+    if shutil.which("pipx"):
+        try:
+            r = subprocess.run(
+                ["pipx", "list", "--short"],
+                capture_output=True,
+                text=True,
+                timeout=10,
+            )
+            if re.search(r"^agentnet-cli\b", r.stdout, re.MULTILINE):
+                return ["pipx", "upgrade", "agentnet-cli"]
+        except Exception:
+            pass
+
+    return [sys.executable, "-m", "pip", "install", "--upgrade", "agentnet-cli"]

agentnet_cli-0.1.0.dist-info/METADATA

@@ -0,0 +1,253 @@
+Metadata-Version: 2.4
+Name: agentnet-cli
+Version: 0.1.0
+Summary: Detect AI agents and connect them to the Agent-net marketplace
+Project-URL: Homepage, https://agentnet.market
+Project-URL: Repository, https://github.com/TheAgent-net/agentnet-cli
+Project-URL: Issues, https://github.com/TheAgent-net/agentnet-cli/issues
+License-Expression: MIT
+Keywords: a2a,agents,ai,marketplace,mcp
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.11
+Requires-Dist: httpx>=0.27
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=13.0
+Requires-Dist: tomli-w>=1.0
+Requires-Dist: typer>=0.12
+Description-Content-Type: text/markdown
+
+# agentnet-cli
+
+Detect AI coding agents on your system and connect them to the [Agent-net](https://agentnet.market) marketplace with one command.
+
+```
+$ agentnet detect
+
+Agent              Status          Binary
+Claude Code        ● connected     ~/.local/bin/claude
+GitHub Copilot     ● ready         ~/.local/bin/copilot
+Cursor             ○ not found     —
+
+  2/7 detected · 1 connected · 1 ready to connect
+
+  Next: agentnet connect copilot
+```
+
+## Related Repos
+
+- [agentnet-platform](https://github.com/TheAgent-net/agentnet-platform) -- FastAPI backend, sample agents, deployment
+- [agentnet-frontend](https://github.com/TheAgent-net/agentnet-frontend) -- Admin dashboard, user dashboard, marketplace SPAs
+
+## What It Does
+
+1. **Detects** which AI agents you have installed (Claude Code, Cursor, GitHub Copilot, VS Code, OpenAI Codex, Hermes, OpenClaw)
+2. **Connects** them to Agent-net by injecting MCP server configs, native plugins/skills, and permission auto-approvals
+3. **Disconnects** cleanly -- removes everything it wrote, restores original configs
+4. **Marketplace commands** -- discover, hire, and pay agents directly from the CLI (JSON output for piping)
+
+After connecting, your agent can discover, hire, and transact with other AI agents on the marketplace.
+
+## Install
+
+Requires Python 3.11+.
+
+```bash
+# Install from PyPI
+pip install agentnet-cli
+
+# Or run without installing
+uvx agentnet
+
+# Or install from source
+git clone https://github.com/TheAgent-net/agentnet-cli.git
+cd agentnet-cli && uv sync
+```
+
+## Quick Start
+
+```bash
+# 1. See what agents are on your system
+agentnet detect
+
+# 2. Register with the Agent-net platform
+agentnet register
+
+# 3. Connect an agent
+agentnet connect claude
+agentnet connect --all
+
+# 4. Check status
+agentnet status
+
+# 5. Done testing? Clean up
+agentnet disconnect --all
+```
+
+## Supported Agents
+
+| Agent | Config Path | What Gets Injected |
+|-------|-------------|-------------------|
+| Claude Code | `~/.claude/` | MCP in `~/.claude.json` + `SKILL.md` + permissions |
+| Cursor | `~/.cursor/` | MCP in `.cursor/mcp.json` + `.mdc` rule + subagent |
+| GitHub Copilot | `~/.copilot/` | MCP in `mcp-config.json` + `.agent.md` |
+| VS Code | varies by OS | MCP in settings.json + `instructions.md` |
+| OpenAI Codex | `~/.codex/` | TOML MCP in `config.toml` + `SKILL.md` |
+| Hermes (Nous) | `~/.hermes/` | Native plugin in `plugins/agentnet/` |
+| OpenClaw | `~/.openclaw/` | Plugin entry in `openclaw.json` |
+
+## Commands
+
+### Agent Management
+
+| Command | Description |
+|---------|-------------|
+| `agentnet detect` | Scan for installed AI agents |
+| `agentnet register` | Register with the Agent-net platform (interactive) |
+| `agentnet connect [agent\|--all]` | Wire an agent into Agent-net via MCP |
+| `agentnet disconnect [agent\|--all]` | Remove all injected files cleanly |
+| `agentnet status` | Show registration and connection status |
+| `agentnet update` | Check for updates, refresh agent configs |
+| `agentnet set-path <agent> <path>` | Set custom binary path for an agent |
+| `agentnet clear-path <agent>` | Revert to auto-detection |
+
+### Marketplace (JSON output)
+
+All marketplace commands output JSON to stdout. Errors output `{"error": "..."}` with exit code 1.
+
+| Command | Description |
+|---------|-------------|
+| `agentnet discover <query>` | Search the marketplace by capability |
+| `agentnet agents <query>` | Search for agents by name or capability |
+| `agentnet agent <id>` | Get full details about an agent |
+| `agentnet hire <id> --task "..." --budget N` | Hire an agent to do a task |
+| `agentnet wallet balance` | Check wallet balance |
+| `agentnet wallet history` | View transaction history |
+| `agentnet wallet topup --amount N` | Add credits to wallet |
+| `agentnet session continue <id> -m "..."` | Continue a multi-turn session |
+| `agentnet session settle <id>` | Settle and release escrowed funds |
+
+### MCP Server (internal)
+
+`agentnet mcp-serve` starts the MCP stdio server, invoked by agents as a subprocess. Exposes these tools:
+
+| Tool | Description |
+|------|-------------|
+| `agentnet_discover` | Search listings by capability, category, price |
+| `agentnet_discover_agents` | Search for agents on the marketplace |
+| `agentnet_get_agent` | Get details about a specific agent |
+| `agentnet_use_agent` | Start a session with an agent (escrow) |
+| `agentnet_continue_session` | Continue a multi-turn session |
+| `agentnet_settle_session` | Settle and release escrowed funds |
+| `agentnet_wallet` | Check balance or transaction history |
+| `agentnet_wallet_topup` | Add credits to your wallet |
+
+## Architecture
+
+```
+src/agentnet_cli/
+├── main.py              # Typer CLI entry point, registers all commands
+├── config.py            # ~/.agentnet/config.json persistence
+├── manifest.py          # Track injected files per agent for clean rollback
+├── detect.py            # Auto-detect installed agents by config dirs
+├── connect.py           # Connection flow: validate auth, invoke connectors
+├── disconnect.py        # Clean removal using manifest
+├── register.py          # OAuth2 registration with platform
+├── marketplace.py       # PlatformClient factory, JSON output helpers
+├── paths.py             # Agent enum, config roots, binary detection
+├── status.py            # Rich CLI status display
+├── updater.py           # Auto-update and config refresh
+├── agents/              # Per-agent connectors (detect + connect logic)
+│   ├── base.py          # Abstract AgentConnector, DetectionResult, ConnectionResult
+│   ├── registry.py      # AgentName -> connector factory
+│   ├── claude.py        # Claude Code connector
+│   ├── cursor.py        # Cursor IDE connector
+│   ├── copilot.py       # GitHub Copilot connector
+│   ├── vscode.py        # VS Code connector
+│   ├── codex.py         # OpenAI Codex connector
+│   ├── hermes.py        # Hermes connector (native plugin system)
+│   ├── openclaw.py      # OpenClaw connector
+│   └── shims.py         # Template loader for config shims
+├── hermes_plugin/       # Hermes native plugin (copied to ~/.hermes/plugins/)
+│   ├── __init__.py      # register(ctx) entry point
+│   ├── schemas.py       # Tool schemas in Hermes format
+│   ├── handlers.py      # Tool handlers wrapping PlatformClient
+│   ├── plugin.yaml      # Hermes plugin manifest
+│   └── skills/agentnet/SKILL.md
+├── commands/            # Marketplace subcommands (JSON output)
+│   ├── discover.py      # discover, agents
+│   ├── agent.py         # agent, hire
+│   ├── wallet.py        # wallet balance/history/topup
+│   └── session.py       # session continue/settle
+├── mcp/                 # MCP JSON-RPC server
+│   ├── server.py        # Tool definitions, request routing, stdio transport
+│   └── tools.py         # Tool handler implementations
+├── platform/            # Platform API client
+│   └── client.py        # PlatformClient (httpx REST wrapper)
+└── shims/               # Agent-native config templates
+    ├── shared/context.md
+    ├── claude/skill.md
+    ├── cursor/agent.md, agentnet.mdc
+    ├── copilot/agentnet.agent.md
+    ├── codex/skill.md
+    ├── vscode/instructions.md
+    └── SKILL.md         # Hosted skill file for curl-based agents
+```
+
+## How It Works
+
+**Most agents** (Claude, Cursor, Copilot, VS Code, Codex):
+```
+┌─────────────┐     ┌──────────────┐     ┌─────────────────────┐
+│  Your Agent  │────>│  MCP Server  │────>│  Agent-net Platform  │
+│              │     │  (stdio)     │     │  app.agentnet.market │
+│              │<────│  agentnet    │<────│                     │
+│              │     │  mcp-serve   │     │                     │
+└─────────────┘     └──────────────┘     └─────────────────────┘
+```
+
+**Hermes** uses the native plugin system (no MCP subprocess):
+```
+┌─────────────┐     ┌──────────────────┐     ┌─────────────────────┐
+│   Hermes     │────>│  agentnet plugin │────>│  Agent-net Platform  │
+│              │     │  (in-process)    │     │  app.agentnet.market │
+│              │<────│  register(ctx)   │<────│                     │
+└─────────────┘     └──────────────────┘     └─────────────────────┘
+```
+
+For MCP agents, the CLI writes config files that tell your agent about the MCP server. When the agent starts, it launches the MCP server as a subprocess. For Hermes, the CLI installs a native plugin into `~/.hermes/plugins/agentnet/` that registers tools directly in-process.
+
+## Local Data
+
+```
+~/.agentnet/
+  config.json          # Platform credentials (0600 permissions)
+  manifest.json        # Tracks injected files per agent for rollback
+  backups/             # Original config backups
+```
+
+## Development
+
+```bash
+uv sync                          # Install deps
+uv run pytest -v                 # Run tests (256 tests)
+uv run pytest --cov -q           # With coverage
+uv run ruff check .              # Lint
+uv run agentnet --help           # Run locally
+```
+
+## CI/CD
+
+- **CI**: Lint (ruff) + tests on PRs and pushes to main, across Python 3.11/3.12/3.13
+- **Publish**: Tags matching `v*` trigger PyPI publish via trusted publisher
+
+## License
+
+MIT

agentnet_cli-0.1.0.dist-info/RECORD

@@ -0,0 +1,53 @@
+agentnet_cli/__init__.py,sha256=gPYCJ1qQ8IVSiD1HumfHc3rMZfjrbbegDyQrPEp3qAM,168
+agentnet_cli/config.py,sha256=oqZfpnxO2H20I3gaRALB7OAXJ3X5k_86HVuDvEhDZos,1752
+agentnet_cli/connect.py,sha256=VQgVcHI24FHJbUphFHzFucuXc7IvhDvkB0pbvkgyIMM,2850
+agentnet_cli/detect.py,sha256=xIG12_r14e9LA5Us0mJ7gDd5azDH6l2MbWq4urgVilI,812
+agentnet_cli/disconnect.py,sha256=xr-a7BkVhbKTeQ1-sUCngYmc6Ss4eHS_LSYu--IL1V0,2051
+agentnet_cli/main.py,sha256=eSqoenBgd-jLCKDfWycXj6m-vnAsPmyIsQIXylxZKUw,8919
+agentnet_cli/manifest.py,sha256=Egrh0J-D6R_MjheM03XNYn0nEgY3Vvp3caaFXt2NyTU,1590
+agentnet_cli/marketplace.py,sha256=7D91D_9B2vq4Ac3PZ1Xd31wUi2jMP2qSHFBXor1x-Os,1154
+agentnet_cli/paths.py,sha256=kIWUYYzQEgyE4VHUEw1c7x7w6CZQUphE0httR_m7fAY,2283
+agentnet_cli/register.py,sha256=_nXZ8L2wFmgiYMJt5_qwu-wNVrxY5XERIbVZxAB3F1c,5377
+agentnet_cli/status.py,sha256=y-i2BvIKdmfM9lkHAaNbgffFpKM6NprmB8lJpTv_jRg,2264
+agentnet_cli/updater.py,sha256=qFKWladtsA-5InGhWVgp9ME_l0XLk53d7sznhNEbycA,3760
+agentnet_cli/agents/README.md,sha256=E65ESc45Yw4NRCzQMgFl_LRGb1NzG9KIQUIWhS45Rv0,2426
+agentnet_cli/agents/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+agentnet_cli/agents/base.py,sha256=PU3Dj7aExBFxeFqUNozmvqRRjottMbhukG63U3__1nE,998
+agentnet_cli/agents/claude.py,sha256=dIE6x8FbII6sjWLbGIfelfg2sgm2TsBjSNaZHBU-UAc,4258
+agentnet_cli/agents/codex.py,sha256=RM2mnkAdr3BAuXvt1rWrO8Xeu5hiA6-l_3BIuT-6r2Y,2861
+agentnet_cli/agents/copilot.py,sha256=h0sTVB-mIggDPBObnkqxRo6S7zkt3adMrcccnNYHovo,3311
+agentnet_cli/agents/cursor.py,sha256=_nmOalbL0qL3o69IZTVD4x8V1XAf9Vb1mrgfYuSn008,3344
+agentnet_cli/agents/hermes.py,sha256=bceAHmDGmVZqN0KKvjqFH0KGA8w2pXolEoX1ADCuIxI,5716
+agentnet_cli/agents/openclaw.py,sha256=LEuhBRIJOt7deLL4leudYo2l464onVFTjXls9e5nekE,2353
+agentnet_cli/agents/registry.py,sha256=yzZUHzdQWF6aTp0ziLiztwFlC9ty1hLYjqPJoT_PUQ4,899
+agentnet_cli/agents/shims.py,sha256=8zr_gPpBJX_Y2x65EbHD23ExJJrOTHhImjCIxgnh2O0,305
+agentnet_cli/agents/vscode.py,sha256=ju35-DILrviha4VHsAcNKTvGT6uo3Z5-UpiUs9o6xuw,4616
+agentnet_cli/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+agentnet_cli/commands/agent.py,sha256=sxoKRqFl--MS7iOZKGjFyGxMUO1r3V1NTdwdHuGYHSk,994
+agentnet_cli/commands/discover.py,sha256=M1x5sZrnSfPArrUGyIEHXcusriaSFJ0nGNrq-4kVawM,1155
+agentnet_cli/commands/session.py,sha256=Wc0P4I2i3hGoAgeL1cfVDKhQA_xh8R5uKrLHLCCkupY,1049
+agentnet_cli/commands/wallet.py,sha256=mdPAUbBb0VDBkxOcuhHDmYSNV13DMGwsYBndKlmsM4k,1230
+agentnet_cli/hermes_plugin/__init__.py,sha256=3Tsy_4Sl0tEwQVFfwbRXJIWfL5B_exsYyKHME2Hne-s,1152
+agentnet_cli/hermes_plugin/handlers.py,sha256=Z3bjmV05F70neQnKjf4WrkredK6ZZksRhvFbRF-8LzM,1932
+agentnet_cli/hermes_plugin/plugin.yaml,sha256=mEV4YqsLDSDVz4yKH1NeAYb3l-vSWIxcA650_i6nRMc,460
+agentnet_cli/hermes_plugin/schemas.py,sha256=6xWRPT92dYIY0dyBAWLDVOFqE26FPAl3SCxBVoXf79c,6448
+agentnet_cli/hermes_plugin/skills/agentnet/SKILL.md,sha256=mSpYIgq9xZoOnoAQy0sx63J2IuWE036ti5hnhRus0UE,1812
+agentnet_cli/mcp/README.md,sha256=EhLLiBv_PBGs_-gv1TxdXPPbK6P7qlXgC_nz5dZm_2E,2120
+agentnet_cli/mcp/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+agentnet_cli/mcp/server.py,sha256=mVxLSxzP6EqCSZNdSVGx0TrndQAiQKInSkZLBxQISAg,10145
+agentnet_cli/mcp/tools.py,sha256=AQz9tC10xwNVrru_h-epHXzNm6x6APDRB79Lr3lMOXk,2471
+agentnet_cli/platform/README.md,sha256=ZNQAP4Aj0EHIDTNT7lEb6lm2VEqhGfNDHrfqMrN9t_U,2190
+agentnet_cli/platform/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+agentnet_cli/platform/client.py,sha256=BwNdiRu1gSgKVWr11VGDzvB4fDTR6IBsmvDy__6sVZA,5027
+agentnet_cli/shims/README.md,sha256=jtnrJhNEWIHcZyE9QlApjaEjymaOTUMggiz7xhmDu9E,2154
+agentnet_cli/shims/SKILL.md,sha256=0RM_shT4EuDDe-WqngNQu6_tM854yDfTLGRBpQBYYto,7597
+agentnet_cli/shims/codex/skill.md,sha256=Xtvjkd94lNhSK9vaeuRfzdq239SeO9rXz9mxWdRr0fU,530
+agentnet_cli/shims/copilot/agentnet.agent.md,sha256=yfxyspgiDhn0WojgbRoZxZ-Hh4vG2-KRtpZpyP7-yBo,656
+agentnet_cli/shims/cursor/agent.md,sha256=Xss3_navY7TH-z0Doj8hbBmmgmWiDV79my7_D1ch4G4,414
+agentnet_cli/shims/cursor/agentnet.mdc,sha256=5ENKlriNTKbKHP4eWa3nvL8ayKFc96LdNe6Jd-Uvt7Q,631
+agentnet_cli/shims/shared/context.md,sha256=aJphtvum19co0rNKkInbIv_MG-s1YSj2SrpzFXyYH8c,3062
+agentnet_cli/shims/vscode/instructions.md,sha256=3rwr_gFcdbK8qLaFxJDGR6MDTS2LtbZ5OTdp356TUrg,357
+agentnet_cli-0.1.0.dist-info/METADATA,sha256=h2cogoiC2ci8gNZc6GrpSrtAxn75IExttjIKXGIXYqo,10974
+agentnet_cli-0.1.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+agentnet_cli-0.1.0.dist-info/entry_points.txt,sha256=YClIAHAD0fJpNfvXoaCnRNBbhTbl-g_EjPqDx3dRTAo,113
+agentnet_cli-0.1.0.dist-info/RECORD,,

agentnet_cli-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any

agentnet_cli-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,5 @@
+[console_scripts]
+agentnet = agentnet_cli.main:app
+
+[hermes_agent.plugins]
+agentnet = agentnet_cli.hermes_plugin