ags-cli 0.1.0__py3-none-any.whl

ags_cli-0.1.0.dist-info/METADATA

@@ -0,0 +1,332 @@
+Metadata-Version: 2.4
+Name: ags-cli
+Version: 0.1.0
+Summary: AgentS: one unified interface over Claude Code, Google CLI (agy), and OpenAI-compatible local LLMs.
+Author: Platform Engineering
+License: Apache-2.0
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+Requires-Dist: fastapi>=0.115
+Requires-Dist: uvicorn[standard]>=0.32
+Requires-Dist: pydantic>=2.9
+Requires-Dist: pydantic-settings>=2.5
+Requires-Dist: python-dotenv>=1.0
+Requires-Dist: sqlalchemy[asyncio]>=2.0.35
+Requires-Dist: aiosqlite>=0.20
+Requires-Dist: httpx>=0.27
+Requires-Dist: typer>=0.12
+Requires-Dist: rich>=13.9
+Requires-Dist: structlog>=24.4
+Requires-Dist: prometheus-client>=0.21
+Requires-Dist: opentelemetry-api>=1.27
+Requires-Dist: opentelemetry-sdk>=1.27
+Requires-Dist: opentelemetry-instrumentation-fastapi>=0.48b0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: mcp>=1.2
+Requires-Dist: python-multipart>=0.0.12
+Requires-Dist: bcrypt>=4.2
+Requires-Dist: pyjwt>=2.9
+Requires-Dist: ags-sdk>=0.1.0
+Provides-Extra: embed
+Requires-Dist: fastembed>=0.4; extra == "embed"
+Provides-Extra: vec
+Requires-Dist: sqlite-vec>=0.1.6; extra == "vec"
+Provides-Extra: dev
+Requires-Dist: pytest>=8.3; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.24; extra == "dev"
+Requires-Dist: pytest-cov>=5.0; extra == "dev"
+Requires-Dist: anyio>=4.6; extra == "dev"
+Requires-Dist: ruff>=0.7; extra == "dev"
+Requires-Dist: mypy>=1.13; extra == "dev"
+Requires-Dist: respx>=0.21; extra == "dev"
+
+# AgentS
+
+One agent over many AI coding agents. AgentS gives you a single interface
+over **Claude Code**, **Antigravity** (Google's `agy`), and any
+**OpenAI-compatible local LLM** (Ollama / LM Studio / vLLM / OpenRouter / …).
+It keeps a shared, vendor-neutral **memory** and an append-only **run ledger**
+in your own database, so the same task can run on one provider or several, be
+compared and merged, and pick up where another agent left off — without sharing
+vendor credentials.
+
+# Install & Getting Started
+
+AgentS ships as a single desktop application for **Windows**, **macOS**, and
+**Linux**. This guide covers installing the app, satisfying its two
+prerequisites (the **Antigravity** and **Claude Code** CLIs), fixing the most
+common startup problem (agents not found on `PATH`), and taking your first
+steps in the GUI.
+
+> This guide covers the **GUI (desktop) application only**. The desktop app is
+> self-contained: it bundles the AgentS engine and starts it for you in the
+> background — there is nothing else to install or run from a terminal.
+
+---
+
+## 1. Prerequisites
+
+AgentS is an orchestrator: it drives the **official Antigravity and Claude Code
+CLIs** as subprocesses. It does **not** ship, replace, or embed them, and it
+never reads, stores, or reuses your credentials — each agent uses its own login.
+
+Before installing AgentS, both agent binaries must be **installed** *and*
+**authenticated** on your machine:
+
+| Agent | Binary | Install | Authenticate | Verify |
+|---|---|---|---|---|
+| **Claude Code** | `claude` | `npm i -g @anthropic-ai/claude-code` (or the official installer) | Run `claude` once and log in (or set `ANTHROPIC_API_KEY`) | `claude --version` |
+| **Antigravity** | `agy` | Follow Google's official Antigravity install guide | Run `agy` once and sign in (or set `ANTIGRAVITY_API_KEY`) | `agy --version` |
+
+Both checks must succeed in a terminal **before** you launch AgentS:
+
+```bash
+claude --version     # e.g. 1.x.x
+agy --version        # e.g. 0.x.x
+```
+
+If either command prints a version but the agent later fails **inside AgentS**,
+it is almost always a `PATH` problem — see [§4](#4-fixing-path-issues-agents-not-found)
+below.
+
+> You only need the agent(s) you intend to use. If you install just `claude`,
+> the Claude Code agent works and Antigravity simply shows as unavailable (and
+> vice-versa).
+
+---
+
+## 2. Download
+
+Download the installer for your operating system from the
+**[latest release](https://github.com/farookmfk/AgentS/releases/latest)**:
+
+| OS | Download | Notes |
+|---|---|---|
+| **Windows** | `AgentS_<version>_x64-setup.exe` (or the `.msi`) | 64-bit Windows 10/11 |
+| **macOS** | `AgentS_<version>_aarch64.dmg` | Apple Silicon (M-series) |
+| **Linux** | `AgentS_<version>_amd64.AppImage` or `.deb` | AppImage runs anywhere; `.deb` for Debian/Ubuntu |
+
+---
+
+## 3. Install
+
+### Windows
+
+1. Run the downloaded `.exe` (or `.msi`) installer and follow the prompts.
+2. Launch **AgentS** from the Start menu.
+3. If SmartScreen shows a "Windows protected your PC" dialog, click
+   **More info → Run anyway** (the app is signed on official releases; this can
+   appear on first launch).
+
+### macOS
+
+1. Open the `.dmg` and drag **AgentS** into **Applications**.
+2. Launch it from **Applications** (or Spotlight).
+3. Official releases are signed and notarized, so Gatekeeper clears the app on
+   first launch (an online check — the first launch needs network). If a
+   download is still flagged, clear the quarantine attribute once:
+   ```bash
+   xattr -d com.apple.quarantine /Applications/AgentS.app
+   ```
+
+### Linux
+
+**AppImage** (no install — runs anywhere):
+
+```bash
+chmod +x AgentS_*_amd64.AppImage
+./AgentS_*_amd64.AppImage
+```
+
+**Debian / Ubuntu (`.deb`):**
+
+```bash
+sudo apt install ./AgentS_*_amd64.deb
+# then launch "AgentS" from your app menu, or run:
+agents
+```
+
+On first launch AgentS creates its local state under `~/.ags/`
+(`%USERPROFILE%\.ags\` on Windows) — a configuration file, a SQLite database,
+and logs. Everything stays on your machine; there are no daemons or servers to
+manage.
+
+---
+
+## 4. Fixing PATH issues (agents not found)
+
+**The single most common problem.** Everything works in your terminal, but
+inside AgentS the Claude Code or Antigravity agent shows as unavailable or its
+runs fail with something like *"binary not on PATH"*.
+
+**Why it happens:** a desktop app launched from the Start menu, the macOS Dock,
+or an app menu does **not** inherit the `PATH` from your shell startup files
+(`.bashrc`, `.zshrc`, `.profile`). So agents installed to a non-standard
+location — npm's global prefix, `nvm`, Homebrew on Apple Silicon
+(`/opt/homebrew/bin`), a custom `~/.local/bin`, etc. — are visible in your
+terminal but invisible to AgentS.
+
+You have two ways to fix it. **Either one** works — pick whichever you prefer.
+
+### Option A — Put the agents on a system-wide PATH
+
+First, find where each agent actually lives:
+
+```bash
+# macOS / Linux
+which claude
+which agy
+
+# Windows (PowerShell)
+where.exe claude
+where.exe agy
+```
+
+Then make that location visible to GUI apps:
+
+- **macOS / Linux** — symlink (or move) each binary into a standard system
+  directory that GUI apps always see:
+  ```bash
+  sudo ln -sf "$(which claude)" /usr/local/bin/claude
+  sudo ln -sf "$(which agy)"    /usr/local/bin/agy
+  ```
+- **Windows** — add the folder that contains `claude.exe` / `agy.exe` (or the
+  npm global folder, e.g. `%APPDATA%\npm`) to the **System** `PATH`:
+  *Settings → System → About → Advanced system settings → Environment
+  Variables → System variables → Path → Edit → New*. Then **log out and back
+  in** so the desktop environment picks up the change.
+
+### Option B — Set the full path explicitly in `config.yaml`
+
+If you'd rather not touch your system `PATH`, tell AgentS exactly where each
+binary is. Edit the config file:
+
+| OS | Config file |
+|---|---|
+| macOS / Linux | `~/.ags/config.yaml` |
+| Windows | `%USERPROFILE%\.ags\config.yaml` |
+
+Find the `providers:` section and set each agent's `params.bin` to the **full
+absolute path** you got from `which` / `where.exe` above:
+
+```yaml
+providers:
+  - name: claude
+    kind: claude_code
+    enabled: true
+    model: claude-opus-4-8
+    params:
+      bin: /usr/local/bin/claude          # ← full path instead of just "claude"
+      permission_mode: plan
+      timeout_s: 600
+
+  - name: antigravity
+    kind: antigravity
+    enabled: true
+    model: gemini-1.5-pro
+    params:
+      bin: /opt/homebrew/bin/agy          # ← full path instead of just "agy"
+      pty: true
+      timeout_s: 600
+```
+
+**Windows path note:** use the full path including the extension, and prefer
+forward slashes or a quoted string, e.g.
+`bin: "C:/Users/you/AppData/Roaming/npm/claude.cmd"`. npm-installed CLIs on
+Windows are usually `claude.cmd` / `agy.cmd`, not `.exe`.
+
+### After either fix
+
+**Fully quit and reopen AgentS** so it restarts its engine and re-reads the
+config. Then confirm the agents are healthy in the GUI:
+
+- Open **Settings → Adapters** and click **Test** next to `claude` and
+  `antigravity`. A green result means the binary was found and responded.
+
+If it still fails, check the diagnostic logs for the exact error:
+
+- `~/.ags/sidecar.log` — did the engine start? (`%USERPROFILE%\.ags\sidecar.log`)
+- `~/.ags/server.log` — runtime errors from the engine.
+
+---
+
+## 5. Getting started with the GUI
+
+When AgentS opens you get a dashboard with a left sidebar:
+**Dashboard**, **New session**, **Sessions**, and a **Settings** group
+(**Project selection**, **Remote hosts**, **Adapters**, **MCP**, **Usage**,
+**Approvals**).
+
+### 5.1 Add a project (local or remote)
+
+Agents work inside a **project folder**. Set it under
+**Settings → Project selection**:
+
+- **Local** — keep the **Local** tab selected and browse to the folder on this
+  machine you want agents to read and edit. Click a folder to choose it.
+- **Remote** — run agents against a folder on another machine over SSH:
+  1. First save the machine under **Settings → Remote hosts**: give it a label
+     and an SSH target (e.g. `user@build-box`). AgentS uses your existing
+     `~/.ssh` config, keys, and agent. The agent CLI (`claude` / `agy`) must be
+     installed **on the remote host** too. Use **Test** to verify the
+     connection and that the CLI is present.
+  2. Back on **Project selection**, switch to the **Remote** tab, pick the saved
+     host, and browse to the folder on that host.
+
+Changes apply to the **next turn** — no restart needed. The current project
+(and whether it's local or remote) is shown at the top of the page.
+
+### 5.2 Start a session — pick an agent and model
+
+Click **New session** in the sidebar:
+
+1. **Agent** — choose **Antigravity** (`antigravity`) or **Claude Code**
+   (`claude`) from the dropdown. Only installed, healthy agents appear here.
+2. **Model (optional override)** — pick a specific model for the chosen agent
+   (e.g. `claude-opus-4-8` for Claude Code, `gemini-1.5-pro` for Antigravity), or
+   leave it to use the agent's default.
+3. **First message** — type your task (e.g. *"Audit the cache layer and propose
+   the safest fix"*). You can also drag-and-drop or paste files to attach them.
+4. **Mode** — **Plan** (read-only; the agent proposes but doesn't write) is the
+   default. Switch to **Edit** to let the agent modify files.
+5. **Private workspace** — leave checked to work on an isolated git branch and
+   merge back when you're happy; uncheck to edit the project folder directly.
+6. Click **Start session** (or press ⌘/Ctrl+Enter).
+
+Responses stream live with Markdown rendering, and tool calls (file reads,
+edits, commands) show compactly as the agent works. You can switch the active
+agent mid-conversation from within the session.
+
+### 5.3 Add MCP servers (external tools)
+
+MCP (Model Context Protocol) servers give agents extra tools — filesystems,
+GitHub, databases, and more. Manage them under **Settings → MCP**:
+
+1. Click **Add server** and choose a transport:
+   - **stdio** — a local command, e.g. command `npx` with args
+     `-y @modelcontextprotocol/server-filesystem /path/to/project`.
+   - **http** — a remote endpoint URL, e.g.
+     `https://api.githubcopilot.com/mcp/`. Provide the token via an environment
+     variable reference (stored as a `0600` secret file, never inline).
+2. Optionally set a **tool allowlist** (empty = all tools) and mark the server
+   **read-only** so its tools are offered even in Plan mode.
+3. **Enable** the server, then click **Test** to connect and list the tools it
+   advertises. Tools appear to agents namespaced as `mcp__<server>__<tool>`.
+
+Changes take effect immediately on the next run — no restart required.
+
+---
+
+## 6. Where things live
+
+| Path | What it is |
+|---|---|
+| `~/.ags/config.yaml` | Providers (agents), models, MCP servers, memory settings |
+| `~/.ags/harness.db` | Local SQLite database (sessions, run ledger, memory) |
+| `~/.ags/sidecar.log` | Desktop-app ↔ engine startup diagnostics |
+| `~/.ags/server.log` | Engine runtime log |
+
+On Windows these live under `%USERPROFILE%\.ags\`.
+
+To fully reset AgentS, quit the app and delete the `~/.ags` folder — it is
+recreated with defaults on the next launch.

ags_cli-0.1.0.dist-info/RECORD

@@ -0,0 +1,156 @@
+cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+cli/__main__.py,sha256=dPjp912dL0OMqmqWZyWm7H14z8nq0epiRI6Tr2IadeY,63
+cli/client.py,sha256=lFOgyuVloEcIQfrrEnmyXUMhtf_LctrVEGqDtlo87iY,6418
+cli/local.py,sha256=C1nw0kcfwTKFZOUCz-Ug-7wXdcfgTTgImgvmFRkkNk8,3048
+cli/main.py,sha256=RJAgv0pdMcYqH9N79ZULloFFXyzypZVMGGsMiXaNTXY,4819
+cli/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+cli/commands/adapter.py,sha256=ND5LiZTX-ZLs09t_5DOG0unXCeEAIdo8qX4sZ9eQjl8,1092
+cli/commands/artifact.py,sha256=VylM1duKGJmLFPYBxwEC0g_URXrrjSRlxlAQnip4wxU,678
+cli/commands/ask.py,sha256=q2VoLDsv_MQEnDnPRw-ogxspUG9dn3gJSPpYy70raoY,7898
+cli/commands/chat.py,sha256=dcjvDjdDy7zNvpxIjcJGpQzajnAFOQ2O8OsIc0QMogw,31066
+cli/commands/diff.py,sha256=NXGYmTcglm_iVuuprzXcYosIWxf_8ZmtzYxQ766bfXc,1568
+cli/commands/doctor.py,sha256=QQxGf64s5etd0qysuQzvU2vVLogoTFT0rS_WqojmPG0,2776
+cli/commands/gui.py,sha256=1ZUtQKzVmCSECij1qxqERr4rGtEX-9k0G983dylwHrA,1340
+cli/commands/init.py,sha256=_RC-ObHw0pzRMvDOUeH_K4ZjTuCfFEqtCXSYKLm8HCs,648
+cli/commands/mcp.py,sha256=-6LFZ4amFGgZ1xS88B00N98InWFkPoM8Tfxgnevkgtw,1700
+cli/commands/memory.py,sha256=R_8JW_d4aHAZbxCZ1N9G_FBGsPjFgU9ZtWB29a-KgZo,2307
+cli/commands/model.py,sha256=QtEGXKlJY0Qw3MsPkcmvcoJ7lO858snBIya5t36Si_I,2932
+cli/commands/policy.py,sha256=3vRzfy5Gp9dKeJKSwra9FM5JAHgzaYssLHQi3RErRJk,1604
+cli/commands/project.py,sha256=ki1MehVU3Nt0JhGgbzsGFUZPDbBn-eJ3hK71KTIrg5Q,4866
+cli/commands/quota.py,sha256=z8nAsG1X5845g6qFfMMwvKdP-XwviYkKNKly_cL2N_A,4344
+cli/commands/run.py,sha256=JHEFRC3IuEJZ5hBQlwnGqNx9eKcJxFwuiIGLEoadIK4,3165
+cli/commands/serve.py,sha256=gmV89t3Iro87QyvibELjyM450X425LuNReojtkFxfTQ,8211
+cli/commands/service.py,sha256=1anfl19V_PXKFdqLngdZZtpOJGQe4BlGBQdHVXDz5-g,7645
+cli/commands/session.py,sha256=VvUI46PXNDITEYGsIJMveIB8HRhkxJGB3GN1WR7p8Go,9067
+cli/commands/stats.py,sha256=JVe7JpYSmLvllGrj1Vvl6fIN-hPSHDfU0TT1CeXvvD4,3406
+cli/commands/status.py,sha256=FchjFH5S_MfGW6OkwFAk0S2BTmtRABfVyY5SdySlvF0,1381
+cli/commands/task.py,sha256=w6hebmqsmGA1KfhvPRwOpxaRx6UtZ_pMXytvri5vWgw,1109
+cli/commands/usage.py,sha256=EAaDAvaIHPvYE6DZiu4mszhQR1rb8NJCKdm8tFQy7JU,2630
+harness/__init__.py,sha256=lppaVKQ-IoXDncVdCB7EEX2n9aPjjPkTcJ8rkjE96xc,163
+harness/bootstrap.py,sha256=LLNTXXKXAQ-LILUk0tGbkgxJZ3_xQzrpHoUizkbUZNY,9014
+harness/db.py,sha256=KU_IXyG9lWpCAa1T_SWqnq5gPuREeReLh7BrZTn8jsk,6007
+harness/deps.py,sha256=bYTmGfcgF0yfO6WsZkdIsFbZRCGMdiiAJvq53UY7USg,1860
+harness/main.py,sha256=oodk4KDWfClQ0FldOZkrq5TRR7PpHoS_yLMWqx44q-U,5138
+harness/settings.py,sha256=OV9GcHIepuaYM15WxW-6T4tFAVcrBCj8EbBu9uMBAjg,7356
+harness/adapters/__init__.py,sha256=pFxdj9YlkBbAuisPo7LlhFNSMkJA8S54Qd1RZTw7gV4,492
+harness/adapters/antigravity.py,sha256=M7KckHTwtnoyyoA4sX3kKnk_FVcIoJWgpe989bK1br8,14436
+harness/adapters/claude_code.py,sha256=-e30Klf3CIWYYNY3UOk77LlFqQd_f-PE-WERJjGXvrw,24108
+harness/adapters/local_openai.py,sha256=PeEruIQvx17JmPtr3WqbqKT64VRZIPXQBtb15DPZ-6Q,23929
+harness/adapters/mock.py,sha256=6pcufTGbGWU-gfB08A67AzGAlVuMtRnwRgi7hEQvGXU,3616
+harness/adapters/probe.py,sha256=XOgeouVF2hEaJ6J3BwMBWoZc8sumTC3nEPa0C5EaUxU,2156
+harness/adapters/registry.py,sha256=myyAj6t2wvMY3ew5G7Aep-WHp85TafbCzEtMkW24-Sc,2197
+harness/adapters/warm_pool.py,sha256=QsQASV0XPsVm2Ik5ktOJCjELYHBFCN9yaCa9o3x194g,10838
+harness/api/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+harness/api/router.py,sha256=cUMgvrdorx6xJs-Pzl16cie4eiml2ufcCayqsVriJlk,957
+harness/api/v1/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+harness/api/v1/adapters.py,sha256=MAEWYceTtYSm-2e4eDM6B4EFgYXMCXUFNTGp0I-BCJg,3499
+harness/api/v1/approvals.py,sha256=w_nyR1xxRy_XZHBSnR1IjkJCa0g9_WRHB6KnBSmZDIY,7665
+harness/api/v1/artifacts.py,sha256=oaHrJunmQj9pkb4PnH5OkCzNzSjnkEQD-yQ6oN8INqQ,1782
+harness/api/v1/attachments.py,sha256=1ASOedzwn3zOhYA-qE2JyMQ_iyiyYbq2nLvddhB-Kyo,1652
+harness/api/v1/doctor.py,sha256=xcYDilo4CXI6Pcn-327zCYvqT4Wrq2xb8c0YCBE3seU,764
+harness/api/v1/health.py,sha256=Z3DDivINA1-Wq3AgaAAvPDDsGkPALafMEkUegdcrdTU,1295
+harness/api/v1/mcp.py,sha256=28SsCIzD21i1Wk8w1-4CfQIlypwo3Gxb-bdwGmlGJJI,4220
+harness/api/v1/memory.py,sha256=nzn3MrdX2sdihAGJgy_DHXciRDXjVsCjr2FuWDs5wQI,2740
+harness/api/v1/policies.py,sha256=jov7dqaL81aOMVLRrEbJsLWlInNhyN_rPMe1U3wUDsk,1992
+harness/api/v1/project.py,sha256=zJeVOyo5BY-wKB-35FosEiOsryZaDzUSitbP1-b4opU,11127
+harness/api/v1/runs.py,sha256=iNBt7tcxoBqXL01ubZyKg0086ndWNR3kD-uEN-uhq5w,3367
+harness/api/v1/sessions.py,sha256=kCd0lqeizwubiDbE6Zz1Ue3DZGe1Vu7-Ri393Q9_rMQ,9727
+harness/api/v1/stream.py,sha256=cxAe-DQx0lje4nk2d06aIzMxlvUmqKXNRLNF6jplrxI,3846
+harness/api/v1/tasks.py,sha256=k_6183jcO-uNpDR3ZWe2fdwJUIhsi6UwkqoZZgi4w5g,1086
+harness/api/v1/usage.py,sha256=_a6cm1iUD5NXDCutTamaYZKPMfoz1jgqSmP8pmJCCCk,2289
+harness/eventbus/__init__.py,sha256=vGZZxrANu8TB2kZJ23S71A6EhNrNE7tPbeaX9EeTiwA,465
+harness/eventbus/inprocess_bus.py,sha256=ym_GCTMagyHF--8yu8vJjnjeEee5ObqAzf0B9HyNLMY,3013
+harness/mcp/__init__.py,sha256=nsZJ31jRmvwoULSd5HnHdNzhFqjKA4to6sGFM0p4xuM,746
+harness/mcp/client.py,sha256=2WS7imUSYbNoCpni-U9-32Ow4uKgMb4LkpsPTFeGshE,5667
+harness/mcp/config_gen.py,sha256=3vlcOYhVrhkqWTcaQ_w2OSXGOKxSkUkGsiwYXXPQgLE,2966
+harness/mcp/registry.py,sha256=yHMfUOSYJsGe43mtGFMCzl9b_s1z-RMTPuBa2cCvsUo,6342
+harness/mcp/tools.py,sha256=rMojkFxcFtLlp76_GKOBtwh_eSYcxRxVg5Mhcf7rxdE,2806
+harness/memory/__init__.py,sha256=E75V_vRCajkSetcCBcXYyA9Fl-q_HJ4vFbfHTZwr02w,398
+harness/memory/context_budget.py,sha256=wUmEH-lAjJdoB8-py6aRWIdGpG4oW6hu1cz4EAvSBdQ,4354
+harness/memory/embed.py,sha256=2NMt1nvqnCh2F5tSKR55V9uqIPhrqeBoaoml_moWkY0,8297
+harness/memory/extract.py,sha256=QDE5TIlE3b46_iDrFOTolYlryR2vtSmsUoezB4JjISk,2756
+harness/memory/ingest.py,sha256=VQlxsqvk6Tio2bg8j-211BuRQKLoIRyb-meqCnbhmx8,3424
+harness/memory/namespaces.py,sha256=yydks9VKBigfOfuqL6A3H5ieQylq3EAVuodZY1ipSho,1971
+harness/memory/ranking.py,sha256=ek_1Go6fopvVrEVCdjFYm2-Dx70RH9odpeVXrsqtt-c,1047
+harness/memory/redact.py,sha256=2tciIKRYtpP8CURPRAv62Q4jpMV5Fvi3DCt_SmUmsEI,1505
+harness/memory/service.py,sha256=Ph17Mgf0BYC7tGwy86oahLvM_CpeRq2BWQ7lXeDGBR0,12893
+harness/memory/sqlite_vec_backend.py,sha256=ftadqBOqkvbZcVTHN_h8iWMCMQQc5YgSMiO1x0WJJhE,10465
+harness/memory/summarize.py,sha256=56HkdW5kFxtgutV-u8FVmHs5fQ93FZ28lqNxsUnwkgE,2381
+harness/models/__init__.py,sha256=K1KDTuKrreYl52jrWqRR_qjNKEY2xeLTFexnJiHLNMM,1096
+harness/models/adapter_health.py,sha256=NmtthKuIeQFnSl4kTPddNdA9lc66IDm0qBgWy7IhMBw,942
+harness/models/approval.py,sha256=kpYEF4TnAzH1_b_u75tomHfpAbTSypcYORMcEOw8y2U,1476
+harness/models/artifact.py,sha256=Y3SoK4gy6qEpfw55aqUbiVuTsPbjqAu5jQmn0Whteh0,1380
+harness/models/audit_log.py,sha256=KqihxlbZ8i0U0Olpg1-j5DOIgR5JAB1-teWEAhZgPPI,1268
+harness/models/comparison.py,sha256=olKQKL-VlIwVEqroe51H08SiAj6dSUv8hhFTb1lu8Dc,1218
+harness/models/enums.py,sha256=slOOVj96JgJbZg68FyvTTn3xRw6K6hm9e1fs-oSrv6Q,3559
+harness/models/mcp_server_config.py,sha256=hH8cOje_12QreusU_lE17mIwR9N0IJ27XfoiQ4oSSWQ,2429
+harness/models/memory.py,sha256=l9QdR2GuvtVVt7R9j4-T-XML_pLKv_0f3g2kjhL39_Q,2759
+harness/models/policy.py,sha256=361TzNd9NvDOEILHbrSd5PrtKodIOwSslLHuTOrh3VY,1058
+harness/models/provider_config.py,sha256=xfrWhVPjkUg13RFSEOeHFWK4_rlLa9rlQrjBSB8386Y,1620
+harness/models/run.py,sha256=f0XeDlD3S4AOZbudiQK7gmDFOJFSAcgeOqccDYPgDJE,2057
+harness/models/run_event.py,sha256=HyAiWoG_O6DH44AsBG0KLcaFX1HFNoWb7dC95D7cvAk,1285
+harness/models/session.py,sha256=mJcfQGrrrZy6QDOsXjSU1Ug_034y4pPPwuAE21w2nLc,2221
+harness/models/task.py,sha256=gknnwYVviS-aB5VAda83GOMui8MEtgCPHjnzxFaLEDM,1047
+harness/models/types.py,sha256=Tzk07kPbPMFyGWXmllQEw8fKRupoTWUALmecj8xehzg,1758
+harness/models/workspace.py,sha256=Koe_eUJ-KSgt27cN97RTRPR2gRoLIYAGKcZVli6NCX8,946
+harness/observability/__init__.py,sha256=JU3tP_e1z5bAGu2HaZlA5kRo1d7Y1byjd9Ktu3a8TGM,216
+harness/observability/audit.py,sha256=9437e_uE00qI69jKWpLAR-XhkmCDTzgz-c0Xo1IFLJw,2506
+harness/observability/logging.py,sha256=R-8Ts3Er9nUCgJrlqdINb96MpBPJ0IekyC7_d9XU2Fc,1337
+harness/observability/metrics.py,sha256=nI04K9eHp909rwyLh6yfBnd0_kLfn_7CqOHu9ENmqko,1388
+harness/observability/tracing.py,sha256=2QGOCQlOh6wZe__f2IssiG_mn7HHOHkJVUYOYnB3iI4,1175
+harness/orchestrator/__init__.py,sha256=se64wEHwDMBRcw1UVdSaWxLawiKE5Jg6zv0hArt2zHs,440
+harness/orchestrator/engine.py,sha256=SJp99IrTGFnPnaXYbeZf30YKG7A3MC0Bi25I-d0K4X0,37054
+harness/orchestrator/handoff.py,sha256=wEYFPCHJEM2PWFHZJ0SCrewA5yJllbbmft5p0_dwvOw,1159
+harness/orchestrator/lifecycle.py,sha256=ftNGSVq0OrIsAZ1JT61SOitBXaXJZBYcOypXSnZqkMk,2057
+harness/orchestrator/native_resume.py,sha256=j6ytXOPSRHrlibBsc5MfLYwHhVl3G699KP_nuaFnGjM,3243
+harness/orchestrator/policies.py,sha256=4BeKbtIqG04eDWAa0oV4eWcvNAgaZGVHCW2lOR4LKio,3269
+harness/orchestrator/reconcile.py,sha256=ScF3gKWMH-1hEQToINc156mim4pbMa1j43usI7cc9fs,1519
+harness/orchestrator/run_graph.py,sha256=woo2f_Zgqb7Ximc_Egm1u-Afum_kzVoVwJPJxAQk28Y,2173
+harness/orchestrator/snapshot.py,sha256=WBaAex4G2pZi7SVaw8NkY5j-IVr9RjHM6MgZLi7v-ok,1715
+harness/schemas/__init__.py,sha256=KQoa7duyjPTpEET4F6NKInF5x264Kv9qH36QbRe5igw,88
+harness/schemas/adapter.py,sha256=8h3yARV_UIBouBZ0dUUK_yO1rQZcv62GrKb5ynKMi2E,523
+harness/schemas/approval.py,sha256=YKIML6PTDbulG20OreYLS-4nKaRds0h3YL5dZlj3qYQ,599
+harness/schemas/artifact.py,sha256=ABl1iQ2qgwRI9PAXvlNUng8znemnzUyU644QdFG_B5A,353
+harness/schemas/common.py,sha256=X2WYRV7xPMj4qnSvv47eBTBpTUM3HVf3JV742YCBgfc,371
+harness/schemas/memory.py,sha256=kDmTcjKcSu_fgM9-kyTcZpmchxotX9-p-WJKlEuhn00,1016
+harness/schemas/policy.py,sha256=9wAQBjtuYupWDei2DtRxQs-T-UY5rN99FES0tDu2xzE,767
+harness/schemas/run.py,sha256=oY3syF3F7UqVfz3Rqe4FWE1tTAwS0y0-iVMb8yhIhKc,3988
+harness/schemas/session.py,sha256=-X0dI1WaerCRgEflY1mV0Y2jmMoHmsh0jBDRaHJeH58,2307
+harness/schemas/task.py,sha256=Wrq1cFOU0QTPNVSaFeOcENHHUeegwYVkoB5aymiIb2c,522
+harness/security/__init__.py,sha256=MAJlj1qcf2sbizh2fvOmkmVpJBySGO7Wb7N52U4rK4M,255
+harness/security/approval_policy.py,sha256=l1lY7qjN16vEAnoAFS9IpuYi_64_4IXbpUuq425cL08,4100
+harness/security/auth.py,sha256=spB64o0GLx6FMtT69E2hN4E1sTRgBQlvbIfj8slKNpw,3825
+harness/security/permissions.py,sha256=HPwVvMe65m9IW5P0QzdqoOZ8toHZzpim8--pOUiUJX8,2169
+harness/security/risk.py,sha256=4_ihRIt-fiYpixiQCSWGtLibDRPlFgyAtR0KMyub_vI,2058
+harness/security/secrets.py,sha256=zH89znNizPU9zk0f44PY996naaw0TdPFTBVLNbUewqw,1638
+harness/services/__init__.py,sha256=xEZgBBUOES34DrFkYdPLrwasLa9NX-W1lRxh6hu2iDI,80
+harness/services/adapters_health.py,sha256=v7J_O8no-tO8wAnijuAsYprk3vgjQ-yOj7P4VbZMLGE,8424
+harness/services/approvals.py,sha256=wbwE7OfRE8Hw7Nslc9qAmsMc9xuDbZGVwZBfyzvzZNU,2426
+harness/services/artifacts.py,sha256=ud76kbktnZ5e2dIwvQHRaMheWPtx-MrlbzSAson4lBw,3307
+harness/services/attachments.py,sha256=Fzw2nJ6GrADP7ami_qpopdzhA_pFiSVG17qAuvFMQxk,8332
+harness/services/comparison.py,sha256=mvZT_WtKEi353ICLgkm1tDL1Ybodq55pohWj2OUaNpI,12110
+harness/services/doctor.py,sha256=dwFHrjObB687sIXfjvkkJqs1OXdUYAZXUTOOScFYdMo,5751
+harness/services/files.py,sha256=xA03L05_8ZTNzaKBVtPmpwm3iCnlTzQTkLz0XIXpIE8,12372
+harness/services/mcp_servers.py,sha256=UY2L6p07CkaCT2cA2pM2bPGGW5WIaI69z9OF96OiMnQ,7353
+harness/services/project_git.py,sha256=T332U4cygbtCeXZiC5CS0NYMtvlwEPQxc1DTNWMaNjg,4289
+harness/services/retention.py,sha256=uUGZzwN62ADy5WykGxtFZ0Lkl6-ig2_U4d9kSMvXwrg,3148
+harness/services/runs.py,sha256=157W99csIAXc_sxUhsotsc8hGLloXLuKgmBaebF_9yY,6918
+harness/services/runs_diff.py,sha256=ul8pzMdi5KKoZjTxIeXwr_WzKcYbvwrknsK_fIpYpUc,7983
+harness/services/sessions.py,sha256=iTrJZrk4e7VcgSL7L23EoOtVQ0QG6WL1t0Jd1IPOxc8,9021
+harness/services/ssh.py,sha256=LAAgKxAv4v8zk2o4kS9PHGN4sLNbq80a-1cj-f8VsdM,11416
+harness/services/stats.py,sha256=ItXDnu7HN3t_7Ck3EEBwojS9n-qYcYoTR1IP0SbItoo,4321
+harness/services/tasks.py,sha256=xT_iHQvh50r40sJF2oWYiD5C4BRWG3QUYJL9kae2Kt4,1293
+harness/services/workspaces.py,sha256=IbLAbC4Xl0v17uOIn80QM02UT5l5hQiEOyvPOCYpxks,8095
+harness/services/worktrees.py,sha256=BIoPNgwKJ_PeGX4eMK-jdOSriYRxXVmOwcgxsjoYuF4,18051
+harness/skills/__init__.py,sha256=IxxsbP29LrGFrTxPJOZkjm9Ybt17cOakuwTyVhzjNqw,303
+harness/skills/manager.py,sha256=rKsW9RTrZRq2DOXfHPUJ6qRlcgje6tUUSNFp-DGVvS4,5101
+harness/tools/__init__.py,sha256=bmPE6AMB1fDv70WRlGb9YKPcS-EOSh7vMWrJQKqyNYo,74
+harness/tools/fs_tools.py,sha256=Hve5chc-Hvs644E7TKGFfl5e1dJLG-B0TEZ3VRQtgR4,12309
+harness/workers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+harness/workers/dispatch.py,sha256=NaGM-aqwqEW8D88ANtZG-XKDwCmyycwSlm8Wf5Z6j-4,794
+harness/workers/inprocess.py,sha256=Gjg4tjsSSH950qkBE5zoriG-BpgJJgU2txoDHxmc8PU,5834
+ags_cli-0.1.0.dist-info/METADATA,sha256=-SQcIq-C5RokRzgDK-spYuY8Z7bLVFUWwiTi7Gd7h24,12681
+ags_cli-0.1.0.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+ags_cli-0.1.0.dist-info/entry_points.txt,sha256=r19gV57ahT3XT9AxRtxYFwsCnDZHTL0YxtMR9xp_Gjw,38
+ags_cli-0.1.0.dist-info/top_level.txt,sha256=o1Col3u-amx5Ry6wEbAkJzb39qDlYn38y_kGECKVvbg,12
+ags_cli-0.1.0.dist-info/RECORD,,

ags_cli-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (83.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

ags_cli-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+ags = cli.main:main

ags_cli-0.1.0.dist-info/top_level.txt

@@ -0,0 +1,2 @@
+cli
+harness

cli/__main__.py

@@ -0,0 +1,4 @@
+from cli.main import app
+
+if __name__ == "__main__":
+    app()

cli/client.py

@@ -0,0 +1,145 @@
+"""Thin synchronous HTTP client to the AgentS API used by all CLI commands."""
+
+from __future__ import annotations
+
+import json
+import os
+import time
+from pathlib import Path
+from typing import Any
+
+import httpx
+
+# `ags serve` (via cli.local._write_api_url, on auto-start or explicit launch)
+# records the live API URL here so `ags` works in any terminal without
+# exporting env vars.
+_API_URL_FILE = Path.home() / ".ags" / "api_url"
+
+# Inline agent runs (agy reading a whole repo, a slow local LLM) can take many
+# minutes, so the read timeout is generous; connect stays short so a down API
+# fails fast with a clear message instead of hanging. Override with HARNESS_API_TIMEOUT.
+_READ_TIMEOUT = float(os.environ.get("HARNESS_API_TIMEOUT", "1800"))  # 30 min
+_LONG = httpx.Timeout(connect=5.0, read=_READ_TIMEOUT, write=30.0, pool=5.0)
+_SHORT = httpx.Timeout(connect=5.0, read=30.0, write=30.0, pool=5.0)
+
+
+def _default_base_url() -> str:
+    if env := os.environ.get("HARNESS_API_BASE_URL"):
+        return env
+    # Find or auto-spawn the daemonless `ags serve` server.
+    try:
+        from cli.local import LOCAL_BASE_URL, ensure_local_server
+
+        if url := ensure_local_server():
+            return url
+        return LOCAL_BASE_URL
+    except Exception:  # noqa: BLE001 - fall back to recorded URL / default below
+        pass
+    if _API_URL_FILE.exists() and (url := _API_URL_FILE.read_text().strip()):
+        return url
+    return "http://localhost:8000"
+
+
+class APIError(RuntimeError):
+    """A user-facing API/transport failure — carries a clean message, no traceback.
+    Caught centrally in ``cli.main.main`` so commands never dump httpx internals."""
+
+
+class HarnessClient:
+    def __init__(self, base_url: str | None = None, token: str | None = None) -> None:
+        self.base_url = (base_url or _default_base_url()).rstrip("/")
+        self.token = token or os.environ.get("HARNESS_API_TOKEN")
+
+    def _headers(self) -> dict[str, str]:
+        return {"Authorization": f"Bearer {self.token}"} if self.token else {}
+
+    def _url(self, path: str) -> str:
+        return f"{self.base_url}/api/v1{path}"
+
+    def _send(self, method: str, path: str, *, timeout, **kw: Any) -> Any:
+        try:
+            r = httpx.request(
+                method, self._url(path), headers=self._headers(), timeout=timeout, **kw
+            )
+            r.raise_for_status()
+            return r.json()
+        except httpx.ConnectError as exc:
+            raise APIError(
+                f"Can't reach the AgentS API at {self.base_url}.\n"
+                f"Is it running? Start it with:  ags serve"
+            ) from exc
+        except httpx.ReadTimeout as exc:
+            raise APIError(
+                f"The run is taking longer than {int(_READ_TIMEOUT)}s on the client side. "
+                "It may still be completing on the server — check `ags session list` "
+                "in a moment, or raise the limit with HARNESS_API_TIMEOUT."
+            ) from exc
+        except httpx.HTTPStatusError as exc:
+            detail = ""
+            try:
+                detail = exc.response.json().get("detail", "")
+            except Exception:  # noqa: BLE001
+                detail = exc.response.text[:300]
+            raise APIError(f"API error {exc.response.status_code}: {detail}") from exc
+        except httpx.HTTPError as exc:
+            raise APIError(f"Request failed: {exc}") from exc
+
+    def get(self, path: str, **params: Any) -> Any:
+        return self._send("GET", path, params=params, timeout=_SHORT)
+
+    def post(self, path: str, json: Any = None, **params: Any) -> Any:
+        # POSTs drive runs (inline can be slow) -> long read timeout.
+        return self._send("POST", path, json=json, params=params, timeout=_LONG)
+
+    def put(self, path: str, json: Any = None, **params: Any) -> Any:
+        return self._send("PUT", path, json=json, params=params, timeout=_SHORT)
+
+    def delete(self, path: str, **params: Any) -> Any:
+        return self._send("DELETE", path, params=params, timeout=_SHORT)
+
+    def _stream_once(self, run_id: str, *, after_seq: int, timeout_s: int):
+        """Open one SSE connection and yield raw data-frame strings; stop on event:end."""
+        sse_timeout = httpx.Timeout(connect=5.0, read=timeout_s + 30, write=30.0, pool=5.0)
+        with httpx.stream(
+            "GET", self._url(f"/stream/{run_id}"),
+            params={"timeout_s": timeout_s, "after_seq": after_seq},
+            headers=self._headers(),
+            timeout=sse_timeout,
+        ) as r:
+            # Buffer across raw byte chunks so we can detect the end-of-frame marker
+            # and the special "event: end" event type before yielding.
+            pending_event: list[str] = []
+            for line in r.iter_lines():
+                if line == "":
+                    # Blank line = end of one SSE event block
+                    event_lines = pending_event
+                    pending_event = []
+                    is_end = any(l == "event: end" for l in event_lines)
+                    if is_end:
+                        return
+                    for l in event_lines:
+                        if l.startswith("data:"):
+                            yield l[len("data:"):].strip()
+                else:
+                    pending_event.append(line)
+
+    def stream(self, run_id: str, timeout_s: int = 600):
+        """Yield SSE data frames for a run, reconnecting up to 3 times on transport errors.
+
+        Reconnect counter is 3 for the stream's lifetime (deliberate — a persistently
+        broken connection should surface as an error, not loop forever).
+        httpx.RemoteProtocolError is a TransportError subclass and is therefore covered.
+        """
+        last_seq, attempts = -1, 0  # -1 = nothing seen yet; seq=0 user event must not be skipped
+        while True:
+            try:
+                for frame in self._stream_once(run_id, after_seq=last_seq, timeout_s=timeout_s):
+                    ev = json.loads(frame)
+                    last_seq = max(last_seq, int(ev.get("seq", last_seq)))
+                    yield frame
+                return  # clean end (event: end received)
+            except httpx.TransportError:
+                attempts += 1
+                if attempts > 3:
+                    raise APIError("stream dropped and could not reconnect")
+                time.sleep(0.5 * attempts)  # linear backoff: 0.5 s × attempt