ur-agent 1.19.0 → 1.20.0

package/docs/AGENT_FEATURES.md

@@ -31,6 +31,9 @@ ur safety check --command "rm -rf build"
 ur context-pack scan
 ur context-pack remember --decision "Use package scripts before ad hoc commands"
 ur context-pack compress
+ur acp serve --port 8123
+ur acp status --json
+ur exec "add tests for the parser" --concurrency 4 --json
 ur repo-edit index
 ur repo-edit preview rename oldName --to newName
 ur repo-edit apply rename oldName --to newName --check "bun test"
@@ -48,6 +51,19 @@ ur --discover-ollama
 ur --ollama-host http://192.168.1.50:11434
 ```
 
+## v1.20.0 Additions
+
+| Addition | Surface | What it adds |
+| --- | --- | --- |
+| ACP server for IDE extensions | `ur acp serve\|stop\|status` | HTTP+JSON-RPC Agent Communication Protocol server that exposes tool listing, tool calls, task submission, and status for VS Code/Cursor/Zed-like editors. |
+| Non-interactive pool execution | `ur exec [prompts...]` | Run one or more prompts headlessly with optional concurrency, worktrees, output capture, and dry-run. |
+| GitHub tool | `GitHub` | PR/issue/repo operations via the `gh` CLI. |
+| API tool | `Api` | REST HTTP calls with JSON/text output. |
+| Browser tool | `Browser` | Headless browser automation (fetch/goto/click/type/evaluate/screenshot); interactive actions require `UR_BROWSER_TOOL=1`. |
+| Docker tool | `Docker` | Container and compose operations via the `docker` CLI. |
+| Test-runner tool | `TestRunner` | Auto-detect and run project tests. |
+| Database tool | `Database` | SQL queries against SQLite, Postgres, MySQL, and DuckDB. |
+
 ## v1.19.0 Additions
 
 | Addition | Surface | What it adds |

package/docs/AGENT_TRENDS.md

@@ -46,6 +46,8 @@ ur safety check --command "rm -rf build"
 ur context-pack scan
 ur context-pack remember --decision "Use manifest commands first"
 ur context-pack compress
+ur acp serve --port 8123
+ur exec "add tests for the parser" --concurrency 4 --json
 ur ci-loop --command "bun test" --dry-run
 ur artifacts capture-diff
 ur artifacts capture-tests --command "bun test"
@@ -88,6 +90,8 @@ Inside an interactive session:
 | Self-healing CI | Covered | `ur ci-loop` runs a command, summarizes failures, invokes a fix agent, and re-runs with bounded retries; commits/pushes are self-review gated | Wire to `ur trigger` so a failed CI webhook auto-launches the loop |
 | Verifiable artifacts | Covered | `ur artifacts` records plans/diffs/test-runs with approve/reject/feedback under `.ur/artifacts/`; comments steer active background agents through stream-json inbox injection | Attach browser-QA screenshots and link artifacts to claim-ledger entries |
 | Native IDE review | Covered | `ur ide diff` writes `.ur/ide/diffs/` bundles and `extensions/vscode-ur-inline-diffs/` provides a VS Code tree/webview/comment surface | Add JetBrains packaging if demand appears |
+| ACP / IDE agent server | Covered | `ur acp serve|stop|status` exposes an HTTP+JSON-RPC agent server so VS Code/Cursor/Zed extensions can list tools, call tools, and submit tasks | Ship reference editor extensions |
+| External tool integration | Covered | Built-in `GitHub`, `Api`, `Browser`, `Docker`, `TestRunner`, and `Database` tools complement existing file-system, terminal, web, and MCP tools | Add richer output parsing and error recovery |
 
 ## v1.13.9 Direct CLI Surfaces
 

package/docs/AGENT_UPGRADE_1.20.0.md

@@ -0,0 +1,42 @@
+# UR Agent 1.20.0 Upgrade Notes
+
+UR 1.20.0 adds IDE integration and a richer tool surface for agent workflows.
+
+## What Changed
+
+- **ACP server** — `ur acp serve|stop|status` exposes an HTTP+JSON-RPC Agent
+  Communication Protocol server for VS Code/Cursor/Zed-like editors. It lists
+  tools, calls tools, sends tasks, and reports status. Existing A2A and MCP
+  support remains unchanged.
+- **`ur exec`** — run one or more prompts in non-interactive mode with optional
+  concurrency, worktrees, and output capture.
+- **New built-in tools** exposed through the agent loop, MCP server, and ACP
+  server:
+  - `GitHub` — PR/issue/repo operations via the `gh` CLI.
+  - `Api` — REST HTTP calls with JSON/text output and path extraction.
+  - `Browser` — headless browser automation (fetch/goto/click/type/evaluate/
+    screenshot); interactive actions require `UR_BROWSER_TOOL=1`.
+  - `Docker` — container and compose operations via the `docker` CLI.
+  - `TestRunner` — auto-detect and run project tests.
+  - `Database` — SQL queries against SQLite, Postgres, MySQL, and DuckDB.
+- File-system and terminal tools (`FileRead`, `FileEdit`, `FileWrite`, `Glob`,
+  `Grep`, `Bash`, `PowerShell`) remain built in and are now also reachable via
+  ACP/MCP.
+
+## New Commands
+
+```sh
+ur acp serve --host 127.0.0.1 --port 8123
+ur acp status --json
+ur exec "refactor the parser" --concurrency 2 --json
+ur exec --file prompts.jsonl --output-dir ./outputs
+```
+
+## Validate
+
+```sh
+ur acp status
+ur exec --dry-run "add tests"
+bun run typecheck
+bun test
+```

package/docs/USAGE.md

@@ -123,6 +123,8 @@ UR includes slash commands and CLI subcommands for common workflows:
 - `ur ci-loop ...` to run tests, repair failures, and rerun with a bounded loop
 - `ur artifacts ...` to capture reviewable diffs, test runs, notes, and feedback
 - `ur ide diff ...` to capture editor-readable inline diff bundles
+- `ur acp ...` to start/stop/status the Agent Communication Protocol server for IDE extensions
+- `ur exec ...` to run prompts in non-interactive mode with optional concurrency
 - `ur eval bench ...` to import local SWE-bench, Terminal-Bench, or Aider Polyglot exports
 - `ur doctor` to inspect CLI health
 - `ur update` or `ur upgrade` to check for updates
@@ -147,6 +149,8 @@ ur safety check --command "rm -rf build"
 ur context-pack scan
 ur context-pack remember --constraint "Run command evidence before claiming success"
 ur context-pack compress
+ur acp serve --port 8123
+ur exec "add tests for the parser" --concurrency 4 --json
 ur ci-loop --command "bun test" --dry-run
 ur artifacts capture-diff
 ur bg run "fix the flaky parser test" --worktree --dry-run

package/documentation/app.js

@@ -76,6 +76,13 @@ const commands = [
     summary: 'Run one prompt headlessly and exit. This is the base mode for scripts, CI, evals, triggers, SDK calls, and A2A tasks.',
     examples: ['ur -p "Summarize this repository"', 'ur -p --output-format json "Review the current diff"', 'ur -p --json-schema \'{"type":"object"}\' "Return structured output"'],
   },
+  {
+    name: 'acp',
+    category: 'Interop',
+    aliases: [],
+    summary: 'Agent Communication Protocol server for IDE extensions: serve, stop, and status.',
+    examples: ['ur acp serve --port 8123', 'ur acp status --json', 'ur acp stop'],
+  },
   {
     name: 'a2a',
     category: 'Interop',
@@ -335,6 +342,13 @@ const commands = [
     summary: 'Set up a long-lived authentication token when that subscription surface is enabled.',
     examples: ['ur setup-token'],
   },
+  {
+    name: 'exec',
+    category: 'Automation',
+    aliases: [],
+    summary: 'Run one or more prompts in non-interactive mode with optional concurrency, worktrees, and output capture.',
+    examples: ['ur exec "add tests for the parser" --json', 'ur exec --file prompts.jsonl --concurrency 4 --output-dir ./outputs', 'ur exec "refactor auth" --worktree --dry-run'],
+  },
   {
     name: 'trigger',
     category: 'Automation',

package/documentation/index.html

@@ -43,7 +43,7 @@
     <main id="content" class="content">
       <header class="topbar">
         <div>
-          <p class="eyebrow">Version 1.19.0</p>
+          <p class="eyebrow">Version 1.20.0</p>
           <h1>UR Agent Documentation</h1>
           <p class="lead">A practical, tutorial-style reference for installing, configuring, automating, extending, and operating UR Agent.</p>
         </div>
@@ -250,6 +250,19 @@ ur context-pack remember --decision "Use manifest commands first"
 ur context-pack compress</code></pre>
           </article>
 
+          <article>
+            <h3>Start the ACP server and run a prompt pool</h3>
+            <ol>
+              <li>Start the Agent Communication Protocol server for IDE extensions.</li>
+              <li>Run one or more prompts in non-interactive mode with concurrency.</li>
+              <li>Capture per-prompt outputs to a directory.</li>
+            </ol>
+            <pre><code>ur acp serve --port 8123
+ur acp status --json
+ur exec "add tests for the parser" --concurrency 4 --json
+ur exec --file prompts.jsonl --output-dir ./outputs --dry-run</code></pre>
+          </article>
+
           <article>
             <h3>Use a multi-agent pattern</h3>
             <ol>

package/extensions/vscode-ur-inline-diffs/package.json

@@ -2,7 +2,7 @@
   "name": "ur-inline-diffs",
   "displayName": "UR Inline Diffs",
   "description": "Review UR inline diff bundles from .ur/ide/diffs inside VS Code.",
-  "version": "1.19.0",
+  "version": "1.20.0",
   "publisher": "ur-agent",
   "engines": {
     "vscode": "^1.92.0"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ur-agent",
-  "version": "1.19.0",
+  "version": "1.20.0",
   "description": "UR terminal coding agent CLI",
   "type": "module",
   "packageManager": "bun@1.3.14",