ur-agent 1.34.0 → 1.35.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +33 -0
- package/QUALITY.md +10 -5
- package/README.md +72 -22
- package/RELEASE.md +11 -1
- package/dist/cli.js +145 -130
- package/docs/AGENT_FEATURES.md +2 -2
- package/docs/AGENT_TRENDS.md +1 -1
- package/docs/CONFIGURATION.md +11 -9
- package/docs/TROUBLESHOOTING.md +204 -0
- package/docs/USAGE.md +38 -16
- package/docs/VALIDATION.md +1 -1
- package/docs/providers.md +29 -21
- package/documentation/app.js +55 -13
- package/documentation/index.html +5 -5
- package/examples/provider_selection.md +45 -0
- package/extensions/vscode-ur-inline-diffs/extension.js +125 -15
- package/extensions/vscode-ur-inline-diffs/package.json +19 -7
- package/package.json +1 -1
- package/docs/AGENT_UPGRADE_1.15.0.md +0 -129
- package/docs/AGENT_UPGRADE_1.16.0.md +0 -102
- package/docs/AGENT_UPGRADE_1.17.0.md +0 -32
- package/docs/AGENT_UPGRADE_1.18.0.md +0 -45
- package/docs/AGENT_UPGRADE_1.19.0.md +0 -41
- package/docs/AGENT_UPGRADE_1.20.0.md +0 -42
- package/docs/AGENT_UPGRADE_1.21.0.md +0 -58
- package/docs/AGENT_UPGRADE_1.22.0.md +0 -48
- package/docs/CODE_FEATURE_INVENTORY.md +0 -1042
|
@@ -1,42 +0,0 @@
|
|
|
1
|
-
# UR-AGENT 1.20.0 Upgrade Notes
|
|
2
|
-
|
|
3
|
-
UR 1.20.0 adds IDE integration and a richer tool surface for agent workflows.
|
|
4
|
-
|
|
5
|
-
## What Changed
|
|
6
|
-
|
|
7
|
-
- **ACP server** — `ur acp serve|stop|status` exposes an HTTP+JSON-RPC Agent
|
|
8
|
-
Communication Protocol server for VS Code/Cursor/Zed-like editors. It lists
|
|
9
|
-
tools, calls tools, sends tasks, and reports status. Existing A2A and MCP
|
|
10
|
-
support remains unchanged.
|
|
11
|
-
- **`ur exec`** — run one or more prompts in non-interactive mode with optional
|
|
12
|
-
concurrency, worktrees, and output capture.
|
|
13
|
-
- **New built-in tools** exposed through the agent loop, MCP server, and ACP
|
|
14
|
-
server:
|
|
15
|
-
- `GitHub` — PR/issue/repo operations via the `gh` CLI.
|
|
16
|
-
- `Api` — REST HTTP calls with JSON/text output and path extraction.
|
|
17
|
-
- `Browser` — headless browser automation (fetch/goto/click/type/evaluate/
|
|
18
|
-
screenshot); interactive actions require `UR_BROWSER_TOOL=1`.
|
|
19
|
-
- `Docker` — container and compose operations via the `docker` CLI.
|
|
20
|
-
- `TestRunner` — auto-detect and run project tests.
|
|
21
|
-
- `Database` — SQL queries against SQLite, Postgres, MySQL, and DuckDB.
|
|
22
|
-
- File-system and terminal tools (`FileRead`, `FileEdit`, `FileWrite`, `Glob`,
|
|
23
|
-
`Grep`, `Bash`, `PowerShell`) remain built in and are now also reachable via
|
|
24
|
-
ACP/MCP.
|
|
25
|
-
|
|
26
|
-
## New Commands
|
|
27
|
-
|
|
28
|
-
```sh
|
|
29
|
-
ur acp serve --host 127.0.0.1 --port 8123
|
|
30
|
-
ur acp status --json
|
|
31
|
-
ur exec "refactor the parser" --concurrency 2 --json
|
|
32
|
-
ur exec --file prompts.jsonl --output-dir ./outputs
|
|
33
|
-
```
|
|
34
|
-
|
|
35
|
-
## Validate
|
|
36
|
-
|
|
37
|
-
```sh
|
|
38
|
-
ur acp status
|
|
39
|
-
ur exec --dry-run "add tests"
|
|
40
|
-
bun run typecheck
|
|
41
|
-
bun test
|
|
42
|
-
```
|
|
@@ -1,58 +0,0 @@
|
|
|
1
|
-
# Upgrading to UR-AGENT v1.21.0
|
|
2
|
-
|
|
3
|
-
## What's new
|
|
4
|
-
|
|
5
|
-
v1.21.0 adds a set of worktree-first agent skills and a command to manage the worktrees they create.
|
|
6
|
-
|
|
7
|
-
- **Agent skill runner** — `src/services/agents/agentSkillRunner.ts` wraps
|
|
8
|
-
`startBackgroundTask({ worktree: true, pr: true })`, polls the background run to
|
|
9
|
-
completion, and returns a PR-style summary with branch, commits, PR URL, and
|
|
10
|
-
diff summary.
|
|
11
|
-
- **New bundled slash skills** — each skill expands into a prompt that instructs
|
|
12
|
-
the model to work in an isolated git worktree and produce a clean branch,
|
|
13
|
-
commits, and PR:
|
|
14
|
-
- `/debug-v2` — reproduce, root-cause, and fix a bug with a regression test
|
|
15
|
-
- `/refactor` — safe, test-backed refactoring
|
|
16
|
-
- `/paper-implementation` — implement an algorithm or system from a paper/URL
|
|
17
|
-
- `/benchmark` — add or run benchmarks and commit results
|
|
18
|
-
- `/security-review` — audit code for security issues, fix low-risk items
|
|
19
|
-
- `/dockerize` — add Dockerfile, compose file, health checks, `.dockerignore`
|
|
20
|
-
- `/latex-paper` — generate or compile a LaTeX paper/report
|
|
21
|
-
- **Matching agent templates** — `debug-v2`, `refactor`, `paper-implementation`,
|
|
22
|
-
`benchmark`, `security-review`, `dockerize`, and `latex-paper` are now part of
|
|
23
|
-
`AGENT_TEMPLATES`. Install them with `ur agent-templates install`.
|
|
24
|
-
- **`ur worktree`** — `ur worktree list|status|clean` inspects and cleans up UR
|
|
25
|
-
agent worktrees.
|
|
26
|
-
|
|
27
|
-
## Quick examples
|
|
28
|
-
|
|
29
|
-
```sh
|
|
30
|
-
# Run a bug-fix agent in an isolated worktree
|
|
31
|
-
ur -p /debug-v2 "parser crashes on empty input"
|
|
32
|
-
|
|
33
|
-
# Same through the CLI
|
|
34
|
-
ur bg run "reproduce and fix parser crash on empty input" --worktree --pr
|
|
35
|
-
|
|
36
|
-
# List active worktrees and clean up finished ones
|
|
37
|
-
ur worktree list
|
|
38
|
-
ur worktree clean --dry-run
|
|
39
|
-
ur worktree clean
|
|
40
|
-
|
|
41
|
-
# Install the new agent templates
|
|
42
|
-
ur agent-templates install debug-v2 refactor benchmark security-review dockerize latex-paper paper-implementation
|
|
43
|
-
```
|
|
44
|
-
|
|
45
|
-
## For users of `/debug`
|
|
46
|
-
|
|
47
|
-
The existing `/debug` skill still reads the session debug log. `/debug-v2` is a
|
|
48
|
-
separate skill for bug-fix work in a worktree. You can keep using `/debug` for
|
|
49
|
-
diagnosing the current session and use `/debug-v2` (or `ur bg run ... --worktree
|
|
50
|
-
--pr`) when you want a branch + PR.
|
|
51
|
-
|
|
52
|
-
## Upgrade steps
|
|
53
|
-
|
|
54
|
-
1. Pull the release and run `bun install`.
|
|
55
|
-
2. Run `bun run typecheck` and `bun test` to confirm the local state.
|
|
56
|
-
3. Install agent templates if you want the new `.ur/agents/*.md` files:
|
|
57
|
-
`ur agent-templates install`.
|
|
58
|
-
4. No settings or project file migration is required.
|
|
@@ -1,48 +0,0 @@
|
|
|
1
|
-
# Upgrading to UR-AGENT v1.22.0
|
|
2
|
-
|
|
3
|
-
## What's new
|
|
4
|
-
|
|
5
|
-
v1.22.0 turns `ur eval` into a real agent benchmark tool.
|
|
6
|
-
|
|
7
|
-
- **Execution metrics** — headless `ur -p` child runs now write a metrics JSON file
|
|
8
|
-
via `UR_EVAL_METRICS_FILE`. The eval runner reads it and also runs
|
|
9
|
-
`git diff --stat` and an optional per-case `expect.testCommand`. Captured
|
|
10
|
-
metrics: cost USD, input/output tokens, model, API duration, files changed,
|
|
11
|
-
insertions/deletions, command failures, human-edit heuristics, and test
|
|
12
|
-
pass/fail.
|
|
13
|
-
- **Parallel-safe by design** — each child writes its own metrics file, so
|
|
14
|
-
future parallel eval runs will not corrupt shared cost state.
|
|
15
|
-
- **Richer dashboard** — `ur eval dashboard` and
|
|
16
|
-
`ur eval report <suite> --dashboard` generate local HTML dashboards with
|
|
17
|
-
summary cards (pass rate, test pass rate, cost, tokens, files changed, command
|
|
18
|
-
failures, human edits, duration) and a per-case timeline showing model, time,
|
|
19
|
-
cost, tokens, diffs, test result, and output preview.
|
|
20
|
-
- **Per-case metrics persistence** — `ur eval run <suite> --metrics` writes
|
|
21
|
-
each case's metrics to `.ur/evals/.runs/<suite>/<case>.json`.
|
|
22
|
-
- **Aggregate reporting** — `ur eval report <suite>` now prints totals for cost,
|
|
23
|
-
tokens, files changed, command failures, human edits, duration, and test pass
|
|
24
|
-
rate.
|
|
25
|
-
|
|
26
|
-
## Quick examples
|
|
27
|
-
|
|
28
|
-
```sh
|
|
29
|
-
# Run the starter suite and print JSON with metrics
|
|
30
|
-
ur eval run starter --metrics --json
|
|
31
|
-
|
|
32
|
-
# Write a single-suite HTML timeline dashboard
|
|
33
|
-
ur eval report starter --dashboard
|
|
34
|
-
|
|
35
|
-
# Generate the combined dashboard across all saved reports
|
|
36
|
-
ur eval dashboard
|
|
37
|
-
|
|
38
|
-
# Import a SWE-bench-style export and run it
|
|
39
|
-
ur eval bench swe-bench --file issues.jsonl --name my-bench
|
|
40
|
-
ur eval run my-bench --metrics
|
|
41
|
-
```
|
|
42
|
-
|
|
43
|
-
## Upgrade steps
|
|
44
|
-
|
|
45
|
-
1. Pull the release and run `bun install`.
|
|
46
|
-
2. Run `bun run typecheck` and `bun test` to confirm the local state.
|
|
47
|
-
3. Rebuild the bundled CLI: `bun run bundle`.
|
|
48
|
-
4. No settings or project file migration is required.
|