ur-agent 1.37.4 → 1.40.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 +36 -9
- package/CONTRIBUTING.md +1 -1
- package/LICENSE +1 -1
- package/README.md +62 -12
- package/RELEASE.md +3 -3
- package/SECURITY.md +2 -2
- package/bin/ur.js +2 -2
- package/dist/cli.js +1926 -978
- package/docs/ACP.md +1 -1
- package/docs/AGENT_FEATURES.md +1 -1
- package/docs/CONFIGURATION.md +67 -2
- package/docs/IDE.md +1 -1
- package/docs/TROUBLESHOOTING.md +1 -1
- package/docs/USAGE.md +2 -2
- package/docs/VALIDATION.md +1 -1
- package/docs/plugins.md +4 -4
- package/docs/providers.md +10 -10
- package/documentation/README.md +2 -2
- package/documentation/app.js +5 -5
- package/documentation/assets/ur-architecture.svg +1 -1
- package/documentation/index.html +8 -8
- package/extensions/vscode-ur-inline-diffs/README.md +1 -1
- package/extensions/vscode-ur-inline-diffs/out/extension.js +4 -4
- package/extensions/vscode-ur-inline-diffs/package.json +2 -2
- package/package.json +3 -3
- package/plugins/examples/README.md +2 -2
- package/plugins/examples/command-template/README.md +1 -1
- package/plugins/examples/command-template/commands/example.md +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,9 +1,36 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
-
## 1.
|
|
3
|
+
## 1.40.1
|
|
4
|
+
|
|
5
|
+
- Pin `diff` to ^7 and OpenTelemetry packages to 2.6.1/0.214.0 to match the
|
|
6
|
+
source API, fixing type errors from accidental dependency bumps, and rebuild
|
|
7
|
+
the shipped bundle against these versions.
|
|
8
|
+
- Update branding and A2A delegation tests for the `ur-agent` package name.
|
|
9
|
+
|
|
10
|
+
## 1.40.0
|
|
11
|
+
|
|
12
|
+
- Version bump: align package, build macro, VS Code extension, docs eyebrow, and
|
|
13
|
+
changelog for the 1.40.0 release.
|
|
14
|
+
|
|
15
|
+
## 1.37.5
|
|
4
16
|
|
|
5
17
|
- Version bump: align package, build macro, VS Code extension, docs eyebrow, and
|
|
6
|
-
changelog for the 1.37.
|
|
18
|
+
changelog for the 1.37.5 patch release.
|
|
19
|
+
- Rename user-facing product/package branding to UR-Nexus while preserving the
|
|
20
|
+
`ur` CLI entrypoint and legacy configuration compatibility.
|
|
21
|
+
- Add a typed prompt-planning layer with deterministic task decomposition,
|
|
22
|
+
task-board rendering, dependency-aware parallel scheduling, file-lock
|
|
23
|
+
serialization, and verification checks for unsupported file/command claims.
|
|
24
|
+
- Wire prompt planning into real `ur exec` execution with task-board progress,
|
|
25
|
+
dependency-aware parallel scheduling, file-lock serialization, evidence-based
|
|
26
|
+
final reports, and compatibility flags for direct legacy prompt execution.
|
|
27
|
+
- Add live task-board streaming during real planned execution, workspace
|
|
28
|
+
before/after file evidence, verified versus unverified command reporting,
|
|
29
|
+
strict/non-strict verification policy, and final reports generated from
|
|
30
|
+
observed execution evidence.
|
|
31
|
+
- Fix project safety policy handling so projects that remove `network` from
|
|
32
|
+
`sandboxRequiredFor` can run user-controlled localhost network checks without
|
|
33
|
+
a hard sandbox-unavailable denial.
|
|
7
34
|
|
|
8
35
|
## 1.37.3
|
|
9
36
|
|
|
@@ -264,7 +291,7 @@
|
|
|
264
291
|
## 1.25.2
|
|
265
292
|
|
|
266
293
|
- Refresh public documentation so README, docs, static site, validation runbook,
|
|
267
|
-
and code inventory all describe the current UR-
|
|
294
|
+
and code inventory all describe the current UR-Nexus feature set.
|
|
268
295
|
- Document the recent provider auth, status bar, bundled VS Code extension,
|
|
269
296
|
`ur upgrade`, and AskUserQuestion schema fixes as first-class release
|
|
270
297
|
behavior.
|
|
@@ -273,7 +300,7 @@
|
|
|
273
300
|
|
|
274
301
|
## 1.25.1
|
|
275
302
|
|
|
276
|
-
- Fix VS Code extension installation to use the bundled UR-
|
|
303
|
+
- Fix VS Code extension installation to use the bundled UR-Nexus inline-diffs extension instead of the stale unpublished `urhq.ur` marketplace ID.
|
|
277
304
|
- Harden AskUserQuestion normalization for description-only option objects and keep the eight-option schema in the production bundle.
|
|
278
305
|
|
|
279
306
|
## 1.25.0
|
|
@@ -876,7 +903,7 @@
|
|
|
876
903
|
|
|
877
904
|
### Verified
|
|
878
905
|
- Rebuilt `dist/cli.js` at 1.13.5 and prepared npm package metadata for
|
|
879
|
-
`ur-
|
|
906
|
+
`ur-nexus@1.13.5`.
|
|
880
907
|
|
|
881
908
|
## 1.13.4
|
|
882
909
|
|
|
@@ -932,7 +959,7 @@
|
|
|
932
959
|
|
|
933
960
|
### Verified
|
|
934
961
|
- Rebuilt `dist/cli.js` at 1.13.3 and prepared npm package metadata for
|
|
935
|
-
`ur-
|
|
962
|
+
`ur-nexus@1.13.3`.
|
|
936
963
|
|
|
937
964
|
## 1.13.2
|
|
938
965
|
|
|
@@ -954,7 +981,7 @@
|
|
|
954
981
|
|
|
955
982
|
### Verified
|
|
956
983
|
- Rebuilt `dist/cli.js` at 1.13.2 and verified npm package metadata resolves
|
|
957
|
-
to `ur-
|
|
984
|
+
to `ur-nexus@1.13.2`.
|
|
958
985
|
|
|
959
986
|
## 1.13.1
|
|
960
987
|
|
|
@@ -1046,7 +1073,7 @@
|
|
|
1046
1073
|
agent identity, and multimodal workflows. The report includes source
|
|
1047
1074
|
references for each trend.
|
|
1048
1075
|
- **A2A Agent Card export.** New `ur a2a card` CLI command and `/a2a-card`
|
|
1049
|
-
slash command print UR-
|
|
1076
|
+
slash command print UR-Nexus Card metadata for discovery by A2A-aware tools.
|
|
1050
1077
|
- **Professional trend docs.** `docs/AGENT_TRENDS.md` documents the coverage
|
|
1051
1078
|
matrix, source/trust policy, and prioritized roadmap.
|
|
1052
1079
|
|
|
@@ -1075,7 +1102,7 @@
|
|
|
1075
1102
|
|
|
1076
1103
|
### Changed
|
|
1077
1104
|
- **Npm publication docs.** README installation guidance now reflects that
|
|
1078
|
-
`ur-
|
|
1105
|
+
`ur-nexus` is published on npm, while keeping the GitHub install path for
|
|
1079
1106
|
source-based installs.
|
|
1080
1107
|
|
|
1081
1108
|
## 1.11.0
|
package/CONTRIBUTING.md
CHANGED
package/LICENSE
CHANGED
package/README.md
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
# UR-
|
|
1
|
+
# UR-Nexus
|
|
2
2
|
|
|
3
3
|
<p align="center">
|
|
4
4
|
<strong>Autonomous engineering workflow engine for reproducible software work.</strong>
|
|
@@ -10,7 +10,7 @@
|
|
|
10
10
|
<a href="./QUALITY.md"><img alt="quality gate" src="https://img.shields.io/badge/quality-release%20gated-brightgreen.svg"></a>
|
|
11
11
|
</p>
|
|
12
12
|
|
|
13
|
-
UR-
|
|
13
|
+
UR-Nexus is a Bun and TypeScript autonomous engineering workflow engine: a
|
|
14
14
|
reproducible autonomous software engineering agent built for disciplined local
|
|
15
15
|
and CI-driven work. It is not only chat, autocomplete, or code edits: UR is
|
|
16
16
|
built to plan, execute, test, verify, document, benchmark, and reproduce
|
|
@@ -21,7 +21,7 @@ multi-agent execution, test-first quality loops, CI repair loops, background
|
|
|
21
21
|
agents, MCP servers, plugins, skills, memory, permission safety policy,
|
|
22
22
|
project context packing, verification, and local model routing.
|
|
23
23
|
|
|
24
|
-
UR-
|
|
24
|
+
UR-Nexus integrates official model access paths only: subscription CLIs,
|
|
25
25
|
explicit API-key mode, and local OpenAI-compatible runtimes. It never scrapes
|
|
26
26
|
browser sessions, extracts OAuth tokens, or bypasses provider restrictions.
|
|
27
27
|
|
|
@@ -64,13 +64,63 @@ handing work off to other tools or agents when needed.
|
|
|
64
64
|
adapters, LSP servers, role modes, custom agents, IDE diff bundles, A2A
|
|
65
65
|
endpoints, and local knowledge indexes.
|
|
66
66
|
|
|
67
|
+
## Prompt Planning and Task Board
|
|
68
|
+
|
|
69
|
+
UR-Nexus can decompose short or long `ur exec` prompts into small executable
|
|
70
|
+
task units before work starts. Each task records an id, title, description, status,
|
|
71
|
+
dependencies, assigned logical agent role, input, expected output, and
|
|
72
|
+
verification criteria. Simple prompts stay compact; complex prompts are split
|
|
73
|
+
only when the wording or ordering makes separate tasks useful.
|
|
74
|
+
|
|
75
|
+
During real `ur exec` runs the task board streams when a task status changes,
|
|
76
|
+
then appears again in the final report. Quiet/non-interactive runs can suppress
|
|
77
|
+
streaming while preserving the final board. Tasks move through `pending`,
|
|
78
|
+
`ready`, `running`, `blocked`, `finished`, and `failed`:
|
|
79
|
+
|
|
80
|
+
```text
|
|
81
|
+
[UR-Nexus Task Board]
|
|
82
|
+
|
|
83
|
+
1. ready | executor | Update CLI branding
|
|
84
|
+
2. running | executor | Update README references
|
|
85
|
+
3. blocked | verifier | Validate release archive
|
|
86
|
+
|
|
87
|
+
Progress: 0/3 finished, 1 running, 1 blocked, 0 failed
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
Before a task runs, UR-Nexus checks that required files/resources exist and
|
|
91
|
+
that assumptions are explicit. After a task runs, verification compares the
|
|
92
|
+
executor's claims with evidence from workspace snapshots and observed command
|
|
93
|
+
records. Strict verification rejects unsupported file-change and command claims;
|
|
94
|
+
non-strict verification records them as warnings.
|
|
95
|
+
Independent tasks can run through parallel logical workers, while tasks that
|
|
96
|
+
depend on another task or target the same file are serialized.
|
|
97
|
+
At the end of execution, `ur exec` reports task counts, finished/failed/blocked
|
|
98
|
+
tasks, actual changed files, unreported changed files, verified commands,
|
|
99
|
+
unverified command claims, verification failures, warnings, and remaining
|
|
100
|
+
limitations. Command tracking is limited to commands surfaced by the task
|
|
101
|
+
runner; provider-internal or detached activity is reported as unverified unless
|
|
102
|
+
the executor exposes it as observed evidence. Use `--no-task-planning` to keep
|
|
103
|
+
the legacy direct prompt execution path for a run.
|
|
104
|
+
|
|
105
|
+
Planning defaults are safe and can be configured with:
|
|
106
|
+
|
|
107
|
+
```json
|
|
108
|
+
{
|
|
109
|
+
"taskPlanning": true,
|
|
110
|
+
"parallelAgents": true,
|
|
111
|
+
"maxAgents": 3,
|
|
112
|
+
"showTaskBoard": true,
|
|
113
|
+
"strictVerification": true
|
|
114
|
+
}
|
|
115
|
+
```
|
|
116
|
+
|
|
67
117
|
## Quick Start
|
|
68
118
|
|
|
69
119
|
### Requirements
|
|
70
120
|
|
|
71
121
|
- Bun `>=1.3.0` (this repository pins `bun@1.3.14`). Bun is mandatory: every
|
|
72
122
|
install path — npm, GitHub, or source checkout — runs the CLI through Bun,
|
|
73
|
-
not Node. UR-
|
|
123
|
+
not Node. UR-Nexus is not Node-native.
|
|
74
124
|
- Node.js `>=18.18` only to start the npm-installed launcher script
|
|
75
125
|
(`bin/ur.js`), which immediately checks for Bun and re-execs into it. If Bun
|
|
76
126
|
is missing, the launcher errors out instead of falling back to Node.
|
|
@@ -159,7 +209,7 @@ requests use that provider backend; they do not fall back to Ollama unless
|
|
|
159
209
|
|
|
160
210
|
### Legal Provider Auth
|
|
161
211
|
|
|
162
|
-
UR-
|
|
212
|
+
UR-Nexus stores only safe provider preferences: provider name, model name,
|
|
163
213
|
base URL, fallback preference, and non-secret settings. API keys must stay in
|
|
164
214
|
environment variables. API, local, and OpenAI-compatible server providers are
|
|
165
215
|
UR-native runtimes and behave like Ollama: UR owns the conversation loop, tool
|
|
@@ -273,7 +323,7 @@ fallback: if dispatch fails, UR reports the selected provider, model, and runtim
|
|
|
273
323
|
backend. Use `ur provider status` (or `ur provider doctor <id>`) to inspect the
|
|
274
324
|
active provider, model, access type, and backend.
|
|
275
325
|
|
|
276
|
-
Security policy: UR-
|
|
326
|
+
Security policy: UR-Nexus never scrapes browser sessions, extracts OAuth
|
|
277
327
|
tokens, bypasses subscription/quota/region/organization restrictions, proxies a
|
|
278
328
|
consumer web session as an API, or claims support for a provider unless the
|
|
279
329
|
official CLI/API path works. See [Provider Guide](docs/providers.md).
|
|
@@ -333,7 +383,7 @@ as first-class subcommands in the shipped CLI.
|
|
|
333
383
|
| `ur acp` | Start/stop/status the Agent Communication Protocol server for IDE extensions. |
|
|
334
384
|
| `ur exec` | Run one or more prompts in non-interactive mode with optional concurrency. |
|
|
335
385
|
| `ur ide diff` | Capture editor-readable inline diff bundles. |
|
|
336
|
-
| `ur a2a card` | Print UR
|
|
386
|
+
| `ur a2a card` | Print UR Card metadata for agent interoperability. |
|
|
337
387
|
| `ur a2a serve` | Start an opt-in local A2A task server with bearer or delegation auth. |
|
|
338
388
|
| `ur sdk` | Show programmatic headless usage and scaffold SDK examples. |
|
|
339
389
|
| `ur trigger` | Parse a GitHub/Slack webhook payload and optionally launch a headless UR run. |
|
|
@@ -344,7 +394,7 @@ as first-class subcommands in the shipped CLI.
|
|
|
344
394
|
| `ur agent-trends` | Show UR coverage for current agent technology trends. |
|
|
345
395
|
| `ur agents` | List configured agents. |
|
|
346
396
|
| `ur doctor` | Check the health of the UR installation and auto-updater. |
|
|
347
|
-
| `ur update` | Check npm for UR-
|
|
397
|
+
| `ur update` | Check npm for UR-Nexus updates (`ur upgrade` is an alias). |
|
|
348
398
|
|
|
349
399
|
### Status Bar
|
|
350
400
|
|
|
@@ -361,7 +411,7 @@ Ollama | llama3 | ask | main
|
|
|
361
411
|
The bar reflects the active in-session provider/model immediately after a
|
|
362
412
|
`/model`, `/model <model>`, or `/provider` change — it does not wait for
|
|
363
413
|
persisted settings to reload. If a custom status-line hook is configured,
|
|
364
|
-
UR-
|
|
414
|
+
UR-Nexus uses that hook output instead of the built-in bar.
|
|
365
415
|
|
|
366
416
|
### IDE Integration
|
|
367
417
|
|
|
@@ -369,7 +419,7 @@ The professional UR IDE integration is the **UR Inline Diffs** VS Code
|
|
|
369
419
|
extension: a chat panel, inline diff review, an actions panel, an agent
|
|
370
420
|
status card, a searchable command palette, and an agent options panel for VS
|
|
371
421
|
Code, Cursor, and Windsurf. It is bundled inside this repository and
|
|
372
|
-
packaged as a local VSIX when installed from UR-
|
|
422
|
+
packaged as a local VSIX when installed from UR-Nexus; the public install
|
|
373
423
|
path does not depend on an unpublished marketplace extension ID. The
|
|
374
424
|
extension never talks to a model provider or network service directly —
|
|
375
425
|
every AI request goes through your local `ur` CLI, same as in a terminal.
|
|
@@ -670,8 +720,8 @@ research, browser, image, video, MCP, memory, and agent-platform tasks.
|
|
|
670
720
|
|
|
671
721
|
## License
|
|
672
722
|
|
|
673
|
-
UR-
|
|
674
|
-
[UR-
|
|
723
|
+
UR-Nexus is released under the
|
|
724
|
+
[UR-Nexus Non-Commercial Self-Responsibility License](LICENSE).
|
|
675
725
|
|
|
676
726
|
Personal, educational, research, evaluation, and other non-commercial use is
|
|
677
727
|
permitted. Commercial use requires prior written permission from Maitham
|
package/RELEASE.md
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
# UR-
|
|
1
|
+
# UR-Nexus release runbook
|
|
2
2
|
|
|
3
3
|
Release target:
|
|
4
4
|
|
|
@@ -48,7 +48,7 @@ Before committing a release, verify the public docs match the current feature
|
|
|
48
48
|
set and version:
|
|
49
49
|
|
|
50
50
|
```bash
|
|
51
|
-
rg -n "Version [0-9]|expected: [0-9]|UR-
|
|
51
|
+
rg -n "Version [0-9]|expected: [0-9]|UR-Nexus v[0-9]" README.md docs documentation
|
|
52
52
|
bun test test/docsCoverage.test.ts test/docsCommands.test.ts
|
|
53
53
|
```
|
|
54
54
|
|
|
@@ -76,7 +76,7 @@ Only after every check passes and the working tree is clean:
|
|
|
76
76
|
|
|
77
77
|
```bash
|
|
78
78
|
git add .
|
|
79
|
-
git commit -m "chore: polish UR-
|
|
79
|
+
git commit -m "chore: polish UR-Nexus production release"
|
|
80
80
|
git push origin master
|
|
81
81
|
npm publish
|
|
82
82
|
```
|
package/SECURITY.md
CHANGED
|
@@ -5,7 +5,7 @@ issue.
|
|
|
5
5
|
|
|
6
6
|
## Supported release
|
|
7
7
|
|
|
8
|
-
Only the latest npm release of `ur-
|
|
8
|
+
Only the latest npm release of `ur-nexus` is supported for security fixes.
|
|
9
9
|
|
|
10
10
|
## Handling secrets
|
|
11
11
|
|
|
@@ -17,6 +17,6 @@ release:
|
|
|
17
17
|
bun run secrets:scan
|
|
18
18
|
```
|
|
19
19
|
|
|
20
|
-
UR-
|
|
20
|
+
UR-Nexus can execute commands and load plugins. Treat plugins as trusted code,
|
|
21
21
|
review MCP server configuration before enabling it, and use permission modes or
|
|
22
22
|
sandboxes for risky workflows.
|
package/bin/ur.js
CHANGED
|
@@ -28,7 +28,7 @@ const version =
|
|
|
28
28
|
? packageMetadata.version
|
|
29
29
|
: '0.0.0-dev'
|
|
30
30
|
const packageName =
|
|
31
|
-
typeof packageMetadata.name === 'string' ? packageMetadata.name : 'ur-
|
|
31
|
+
typeof packageMetadata.name === 'string' ? packageMetadata.name : 'ur-nexus'
|
|
32
32
|
const issuesUrl =
|
|
33
33
|
typeof packageMetadata.bugs?.url === 'string'
|
|
34
34
|
? packageMetadata.bugs.url
|
|
@@ -50,7 +50,7 @@ function printBunRuntimeError(detail) {
|
|
|
50
50
|
: 'PATH'
|
|
51
51
|
console.error(
|
|
52
52
|
[
|
|
53
|
-
`UR-
|
|
53
|
+
`UR-Nexus requires Bun ${requiredBun} at runtime because the published CLI bundle is built with --target bun.`,
|
|
54
54
|
`Could not execute "${attempted}" from ${source}.${detail ? ` ${detail}` : ''}`,
|
|
55
55
|
'Install Bun from https://bun.sh, or set BUN_BIN to the absolute path of a Bun executable.',
|
|
56
56
|
].join('\n'),
|