ur-agent 1.34.0 → 1.35.1

package/examples/provider_selection.md

@@ -0,0 +1,45 @@
+# Provider and model selection
+
+Check what is connected, pick a provider, then pick a model scoped to it.
+
+```sh
+ur provider list          # all providers with access type and status
+ur connect status         # connection state for every provider
+ur provider doctor        # detailed checks for the selected provider
+```
+
+Local (default, no account needed — requires a running Ollama app):
+
+```sh
+ur config set provider ollama
+ur --model qwen2.5-coder:latest
+```
+
+API key (stored securely in the OS keychain):
+
+```sh
+ur connect openai-api --key <KEY>   # or: echo "$OPENAI_API_KEY" | ur connect openai-api
+ur config set provider openai-api
+ur config set model gpt-5.5
+```
+
+Local OpenAI-compatible server (LM Studio, llama.cpp, vLLM):
+
+```sh
+ur config set provider lmstudio
+ur config set base_url http://localhost:1234/v1
+```
+
+Subscription CLI (uses the vendor's official CLI and your subscription):
+
+```sh
+ur auth chatgpt           # official Codex CLI login
+ur config set provider codex-cli
+```
+
+Inside a session, `/model` gives the same flow interactively: provider first,
+then only that provider's models. Verify the active pair any time:
+
+```sh
+ur provider status
+```

package/extensions/vscode-ur-inline-diffs/extension.js

@@ -52,13 +52,58 @@ function escapeHtml(text) {
     .replace(/"/g, '"')
 }
 
+function formatCount(count, singular, plural = `${singular}s`) {
+  return `${count} ${count === 1 ? singular : plural}`
+}
+
+function formatRelativeTime(value) {
+  if (!value) return 'unknown time'
+  const date = new Date(value)
+  if (Number.isNaN(date.getTime())) return String(value)
+  const deltaMs = Date.now() - date.getTime()
+  const minute = 60 * 1000
+  const hour = 60 * minute
+  const day = 24 * hour
+  if (deltaMs < minute) return 'just now'
+  if (deltaMs < hour) return `${Math.max(1, Math.floor(deltaMs / minute))}m ago`
+  if (deltaMs < day) return `${Math.floor(deltaMs / hour)}h ago`
+  if (deltaMs < 7 * day) return `${Math.floor(deltaMs / day)}d ago`
+  return date.toLocaleDateString()
+}
+
+function statusIcon(status) {
+  switch (status) {
+    case 'applied':
+      return new vscode.ThemeIcon('check', new vscode.ThemeColor('testing.iconPassed'))
+    case 'rejected':
+      return new vscode.ThemeIcon('circle-slash', new vscode.ThemeColor('testing.iconFailed'))
+    case 'commented':
+      return new vscode.ThemeIcon('comment-discussion', new vscode.ThemeColor('charts.yellow'))
+    default:
+      return new vscode.ThemeIcon('diff', new vscode.ThemeColor('charts.blue'))
+  }
+}
+
 class DiffItem extends vscode.TreeItem {
   constructor(bundle) {
-    super(`${bundle.id}: ${bundle.title}`, vscode.TreeItemCollapsibleState.None)
+    const title = bundle.title || bundle.id
+    super(title, vscode.TreeItemCollapsibleState.None)
     this.bundle = bundle
     this.contextValue = 'diff'
-    this.description = `${bundle.status} · ${bundle.files?.length ?? 0} file(s)`
-    this.tooltip = `${bundle.title}\n${bundle.patchFile}`
+    const fileCount = bundle.files?.length ?? 0
+    const changedAt = bundle.updatedAt ?? bundle.createdAt
+    this.description = `${bundle.status ?? 'captured'} · ${formatCount(fileCount, 'file')} · ${formatRelativeTime(changedAt)}`
+    this.iconPath = statusIcon(bundle.status)
+    this.tooltip = new vscode.MarkdownString(
+      [
+        `**${escapeHtml(title)}**`,
+        '',
+        `- ID: \`${escapeHtml(bundle.id)}\``,
+        `- Status: ${escapeHtml(bundle.status ?? 'captured')}`,
+        `- Files: ${fileCount}`,
+        `- Patch: \`${escapeHtml(bundle.patchFile)}\``,
+      ].join('\n'),
+    )
     this.command = {
       command: 'urInlineDiffs.open',
       title: 'Open Inline Diff',
@@ -67,6 +112,27 @@ class DiffItem extends vscode.TreeItem {
   }
 }
 
+class ActionItem extends vscode.TreeItem {
+  constructor(label, description, icon, command, tooltip) {
+    super(label, vscode.TreeItemCollapsibleState.None)
+    this.contextValue = 'urAction'
+    this.description = description
+    this.iconPath = new vscode.ThemeIcon(icon)
+    this.tooltip = tooltip ?? `${label}${description ? ` — ${description}` : ''}`
+    this.command = command
+  }
+}
+
+class InfoItem extends vscode.TreeItem {
+  constructor(label, description, icon = 'info') {
+    super(label, vscode.TreeItemCollapsibleState.None)
+    this.contextValue = 'urInfo'
+    this.description = description
+    this.iconPath = new vscode.ThemeIcon(icon)
+    this.tooltip = `${label}${description ? ` — ${description}` : ''}`
+  }
+}
+
 class DiffProvider {
   constructor() {
     this._onDidChangeTreeData = new vscode.EventEmitter()
@@ -83,12 +149,41 @@ class DiffProvider {
 
   getChildren() {
     const root = workspaceRoot()
-    if (!root) return []
-    return loadManifest(root)
+    if (!root) {
+      return [
+        new InfoItem('Open a workspace folder', 'UR inline diffs are scoped to the active project', 'folder-opened'),
+      ]
+    }
+
+    const manifest = loadManifest(root)
+    const diffs = manifest
       .diffs
       .slice()
       .sort((a, b) => String(b.createdAt).localeCompare(String(a.createdAt)))
-      .map(bundle => new DiffItem(bundle))
+
+    if (diffs.length === 0) {
+      return [
+        new InfoItem(
+          'Ready for inline review',
+          fs.existsSync(manifestPath(root)) ? 'No pending diff bundles' : 'No diff bundles captured yet',
+          'pass',
+        ),
+        new ActionItem(
+          'Show UR status',
+          'Provider, model, plugins',
+          'pulse',
+          { command: 'urInlineDiffs.status', title: 'Show UR Status' },
+        ),
+        new ActionItem(
+          'Refresh',
+          path.relative(root, manifestPath(root)),
+          'refresh',
+          { command: 'urInlineDiffs.refresh', title: 'Refresh Inline Diffs' },
+        ),
+      ]
+    }
+
+    return diffs.map(bundle => new DiffItem(bundle))
   }
 }
 
@@ -103,18 +198,29 @@ function renderDiffHtml(root, bundle) {
   <meta charset="utf-8">
   <meta name="viewport" content="width=device-width, initial-scale=1">
   <style>
-    body { font: 13px/1.45 var(--vscode-editor-font-family); color: var(--vscode-editor-foreground); padding: 16px; }
-    h1 { font-size: 18px; margin: 0 0 4px; }
-    .meta { color: var(--vscode-descriptionForeground); margin-bottom: 14px; }
-    pre { background: var(--vscode-editor-background); border: 1px solid var(--vscode-panel-border); padding: 12px; overflow: auto; }
+    :root { color-scheme: light dark; }
+    body { font: 13px/1.5 var(--vscode-font-family); color: var(--vscode-foreground); padding: 20px; margin: 0; }
+    header { border-bottom: 1px solid var(--vscode-panel-border); padding-bottom: 14px; margin-bottom: 16px; }
+    h1 { font-size: 20px; font-weight: 600; margin: 0 0 6px; }
+    h2 { font-size: 14px; margin: 20px 0 10px; }
+    .meta, .where { color: var(--vscode-descriptionForeground); }
+    .chips { display: flex; flex-wrap: wrap; gap: 8px; margin-top: 10px; }
+    .chip { border: 1px solid var(--vscode-panel-border); border-radius: 4px; padding: 3px 8px; background: var(--vscode-sideBar-background); }
+    pre { background: var(--vscode-editor-background); border: 1px solid var(--vscode-panel-border); border-radius: 6px; padding: 14px; overflow: auto; font-family: var(--vscode-editor-font-family); }
     .comments { margin-top: 18px; }
-    .comment { border-top: 1px solid var(--vscode-panel-border); padding: 8px 0; }
-    .where { color: var(--vscode-descriptionForeground); }
+    .comment { border: 1px solid var(--vscode-panel-border); border-radius: 6px; padding: 10px 12px; margin-bottom: 10px; background: var(--vscode-sideBar-background); }
   </style>
 </head>
 <body>
-  <h1>${escapeHtml(bundle.title)}</h1>
-  <div class="meta">${escapeHtml(bundle.id)} · ${escapeHtml(bundle.status)} · ${escapeHtml(bundle.files?.length ?? 0)} file(s)</div>
+  <header>
+    <h1>${escapeHtml(bundle.title)}</h1>
+    <div class="meta">${escapeHtml(bundle.id)} · ${escapeHtml(formatRelativeTime(bundle.updatedAt ?? bundle.createdAt))}</div>
+    <div class="chips">
+      <span class="chip">${escapeHtml(bundle.status ?? 'captured')}</span>
+      <span class="chip">${escapeHtml(formatCount(bundle.files?.length ?? 0, 'file'))}</span>
+      <span class="chip">${escapeHtml(formatCount(comments.length, 'comment'))}</span>
+    </div>
+  </header>
   <pre>${escapeHtml(patch)}</pre>
   <section class="comments">
     <h2>Comments</h2>
@@ -256,9 +362,13 @@ async function showStatus(channel) {
 function activate(context) {
   const provider = new DiffProvider()
   const channel = vscode.window.createOutputChannel('UR')
+  const tree = vscode.window.createTreeView('urInlineDiffs', {
+    treeDataProvider: provider,
+    showCollapseAll: false,
+  })
   context.subscriptions.push(
     channel,
-    vscode.window.registerTreeDataProvider('urInlineDiffs', provider),
+    tree,
     vscode.commands.registerCommand('urInlineDiffs.refresh', () => provider.refresh()),
     vscode.commands.registerCommand('urInlineDiffs.open', item => openDiff(item)),
     vscode.commands.registerCommand('urInlineDiffs.comment', item => commentDiff(item, provider)),

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

@@ -2,7 +2,7 @@
   "name": "ur-inline-diffs",
   "displayName": "UR Inline Diffs",
   "description": "Review, apply, and reject UR inline diff bundles from .ur/ide/diffs inside VS Code.",
-  "version": "1.30.6",
+  "version": "1.35.1",
   "publisher": "ur-agent",
   "engines": {
     "vscode": "^1.92.0"
@@ -41,27 +41,39 @@
     "commands": [
       {
         "command": "urInlineDiffs.refresh",
-        "title": "UR: Refresh Inline Diffs"
+        "title": "UR: Refresh Inline Diffs",
+        "icon": "$(refresh)"
       },
       {
         "command": "urInlineDiffs.open",
-        "title": "UR: Open Inline Diff"
+        "title": "UR: Open Inline Diff",
+        "icon": "$(diff)"
       },
       {
         "command": "urInlineDiffs.comment",
-        "title": "UR: Comment On Inline Diff"
+        "title": "UR: Comment On Inline Diff",
+        "icon": "$(comment-discussion)"
       },
       {
         "command": "urInlineDiffs.apply",
-        "title": "UR: Apply Inline Diff"
+        "title": "UR: Apply Inline Diff",
+        "icon": "$(check)"
       },
       {
         "command": "urInlineDiffs.reject",
-        "title": "UR: Reject Inline Diff"
+        "title": "UR: Reject Inline Diff",
+        "icon": "$(circle-slash)"
       },
       {
         "command": "urInlineDiffs.status",
-        "title": "UR: Show Status (provider, model, plugins)"
+        "title": "UR: Show Status (provider, model, plugins)",
+        "icon": "$(pulse)"
+      }
+    ],
+    "viewsWelcome": [
+      {
+        "view": "urInlineDiffs",
+        "contents": "UR inline diffs appear here when a review bundle is captured.\n[Show Status](command:urInlineDiffs.status)  [Refresh](command:urInlineDiffs.refresh)"
       }
     ],
     "menus": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ur-agent",
-  "version": "1.34.0",
+  "version": "1.35.1",
   "description": "UR-AGENT — autonomous engineering workflow engine (plan, execute, test, verify, document, benchmark, reproduce)",
   "type": "module",
   "packageManager": "bun@1.3.14",

package/docs/AGENT_UPGRADE_1.15.0.md

@@ -1,129 +0,0 @@
-# UR-AGENT 1.15.0 Upgrade Notes
-
-UR 1.15.0 keeps the agent local-first and Ollama-centered. The new agent
-platform surfaces do not add Anthropic, OpenAI, or other direct provider API
-dependencies. Network-facing behavior remains opt-in.
-
-## New Local Agent Surfaces
-
-### Background agents
-
-```sh
-ur bg run "fix the flaky parser test" --worktree
-ur bg fanout "try three parser fixes" --agents 3 --worktree
-ur bg list
-ur bg status <id>
-ur bg logs <id> --tail 100
-ur bg attach <id>
-ur bg kill <id>
-```
-
-State is stored under `.ur/background/`. Worktrees are stored under
-`.ur/worktrees/`. Pull requests are created only when `--pr` is passed and then
-use the existing local `gh` CLI path.
-
-### Context and memory retention
-
-```sh
-ur config set compaction.autoThreshold 80
-ur memory retention show
-ur memory retention set --ttl-days 90 --max-entries 5000 --decay-days 30
-ur memory retention prune
-```
-
-`compaction.autoThreshold` is a global percentage threshold from 50 to 95. The
-retention command prunes project-local `.ur/memory/*.jsonl` files.
-
-### Code-index watcher
-
-```sh
-ur config set codeIndex.autoReindex true
-ur code-index watch --graph
-ur code-index watch --dry-run --json
-```
-
-The watcher uses local filesystem events and the same local Ollama embedding
-path as `ur code-index build`.
-
-### Artifact steering
-
-```sh
-ur artifacts add --kind plan --title "Plan" --task <bg_id>
-ur artifacts comment <artifact_id> --feedback "Prefer the simpler parser path"
-```
-
-Comments are written to the artifact and to the linked background task inbox so
-long-running work has durable steering feedback. Background workers now run in
-stream-json mode and inject new inbox comments into the child agent as
-`priority: "now"` user turns while the process is active.
-
-### A2A task server
-
-```sh
-ur a2a card
-ur a2a serve --host 127.0.0.1 --port 8765 --token "$UR_A2A_TOKEN"
-ur a2a token mint --secret "$UR_A2A_DELEGATION_SECRET" --scope coding-agent
-```
-
-The server is opt-in. It refuses off-loopback binds unless a static bearer token
-or delegation secret is configured. Task execution is backed by UR background
-tasks and local `ur -p`; no external model provider API is introduced.
-
-Useful routes:
-
-- `GET /healthz`
-- `GET /.well-known/agent-card.json`
-- `POST /a2a/tasks`
-- `GET /a2a/tasks`
-- `GET /a2a/tasks/:id`
-- `GET /a2a/tasks/:id/output`
-- `POST /a2a/tasks/:id/cancel`
-- `DELETE /a2a/tasks/:id`
-
-### IDE inline diff bundles
-
-```sh
-ur ide diff capture --title "Parser fix"
-ur ide diff list
-ur ide diff show diff-1
-ur ide diff comment diff-1 --feedback "Inline note" --file src/parser.ts --line 42
-ur ide diff schema
-```
-
-Bundles are stored under `.ur/ide/diffs/` as a manifest, per-diff metadata, and
-unified patch files. The repo also ships a native VS Code extension at
-`extensions/vscode-ur-inline-diffs/` that lists bundles, opens patch previews,
-and writes comments back into the UR metadata.
-
-### Benchmark adapters
-
-```sh
-ur eval bench list
-ur eval bench swe-bench --file swe.jsonl --name local-swe
-ur eval bench terminal-bench --file terminal.jsonl --name local-terminal
-ur eval bench aider-polyglot --file aider.jsonl --name local-polyglot
-ur eval run local-swe --dry-run
-```
-
-Adapters import local JSON or JSONL exports into UR eval suites. They do not
-download datasets or call external services.
-
-## Release Verification
-
-Run these before publishing:
-
-```sh
-bun test test/agentFeatureCommands.test.ts test/agentDelegation.test.ts test/codeIndex.test.ts
-bun run typecheck
-npm pack --dry-run
-```
-
-Optional local smoke checks:
-
-```sh
-bun src/entrypoints/cli.tsx bg list
-bun src/entrypoints/cli.tsx memory retention show
-bun src/entrypoints/cli.tsx code-index watch --dry-run
-bun src/entrypoints/cli.tsx eval bench list
-bun src/entrypoints/cli.tsx ide diff schema
-```

package/docs/AGENT_UPGRADE_1.16.0.md

@@ -1,102 +0,0 @@
-# UR-AGENT 1.16.0 Upgrade Notes
-
-UR 1.16.0 adds local-network Ollama discovery. The agent can now find Ollama
-servers on your LAN, let you pick one at startup, and remember the choice for
-future sessions. The endpoint is no longer hardcoded to `localhost:11434`; it
-can be set via settings, environment, or a CLI flag.
-
-## Network Ollama Discovery
-
-### One-time discovery at startup
-
-```sh
-ur --discover-ollama
-```
-
-UR scans the active local subnets (wired Ethernet and Wi-Fi/WLAN) for hosts
-listening on port `11434`, verifies each one by fetching `/api/tags`, then shows
-a picker with:
-
-- `This computer` — your local `ollama serve` at `http://localhost:11434`
-- every discovered LAN host and the number of models it advertises
-
-Select a host and UR uses it for that session only. The choice is **not**
-persisted, so plain `ur` continues to use `localhost:11434`.
-
-### Enable discovery on every startup
-
-Add to `~/.ur/settings.json`:
-
-```json
-{
-  "ollama": {
-    "lanDiscovery": true
-  }
-}
-```
-
-The picker appears on every startup. The choice is still session-only and is
-not written to settings.
-
-### Point to a specific host without scanning
-
-```sh
-ur --ollama-host http://192.168.1.50:11434
-```
-
-This is session-only and does not write settings. It takes precedence over
-settings and `OLLAMA_HOST`.
-
-### Persistent host via settings
-
-```json
-{
-  "ollama": {
-    "host": "http://192.168.1.50:11434"
-  }
-}
-```
-
-When `ollama.host` is set, UR uses it automatically. Precedence is:
-
-1. `--ollama-host <url>` CLI flag
-2. `OLLAMA_HOST` environment variable
-3. `ollama.host` in user settings
-4. fallback `http://localhost:11434`
-
-## What Uses the Chosen Host
-
-The resolved host is used everywhere UR talks to Ollama:
-
-- interactive chat requests (`/api/chat`)
-- installed-model listing (`/api/tags`)
-- model metadata refresh (`/api/show`)
-- local embeddings (`/api/embed`)
-- `ur model-doctor`
-- `ur doctor` / `ur sysinfo`
-- startup preflight connectivity check
-
-## Security Notes
-
-LAN scanning is opt-in only. It never runs automatically unless you pass
-`--discover-ollama` or set `ollama.lanDiscovery: true`. The scan is limited to
-active local IPv4 interfaces and ignores loopback and link-local addresses. It
-uses bounded concurrency and short timeouts so it finishes in a few seconds on a
-/24 subnet.
-
-## Release Verification
-
-Run these before publishing:
-
-```sh
-bun test test/ollamaDiscovery.test.ts test/ollamaModels.test.ts test/ollamaTimeout.test.ts
-bun run typecheck
-npm pack --dry-run
-```
-
-Optional local smoke checks:
-
-```sh
-bun src/entrypoints/cli.tsx --discover-ollama --help
-bun src/entrypoints/cli.tsx --ollama-host http://localhost:11434 -p "hello"
-```

package/docs/AGENT_UPGRADE_1.17.0.md

@@ -1,32 +0,0 @@
-# UR-AGENT 1.17.0 Upgrade Notes
-
-UR 1.17.0 adds the P0 reliable repo editing surface.
-
-## Reliable Repo Editing
-
-```sh
-ur repo-edit index
-ur repo-edit search checkoutTotal
-ur repo-edit plan rename oldName --to newName
-ur repo-edit preview rename oldName --to newName
-ur repo-edit apply rename oldName --to newName --check "bun test"
-```
-
-`repo-edit` is designed for safer repository-wide code changes:
-
-- Builds `.ur/repo-edit/index.json` with file metadata, tokens, and
-  JavaScript/TypeScript symbols.
-- Searches paths, indexed tokens, content lines, and symbols.
-- Plans JavaScript/TypeScript identifier renames from AST nodes instead of
-  replacing arbitrary text.
-- Prints a unified patch preview before writing.
-- Applies all files transactionally and rolls back touched files if syntax
-  validation or an optional check command fails.
-
-## Validation
-
-```sh
-bun test test/repoEdit.test.ts
-bun run typecheck
-node ./bin/ur.js repo-edit --help
-```

package/docs/AGENT_UPGRADE_1.18.0.md

@@ -1,45 +0,0 @@
-# UR-AGENT 1.18.0 Upgrade Notes
-
-UR 1.18.0 adds the P0 test-first execution loop.
-
-## New Command
-
-```sh
-ur test-first detect
-ur test-first --dry-run
-ur test-first --max-attempts 3
-ur test-first install
-```
-
-`test-first` is designed for command-evidence-driven repo work:
-
-- Detects project languages, package managers, and quality commands from the
-  existing project files.
-- Orders detected commands as compile, test, then lint.
-- Runs the command set and reports `passed` only when the commands exit 0.
-- On failure, stores a trace under `.ur/test-first/traces/` with the command,
-  phase, exit code, stdout, and stderr.
-- Invokes a bounded fix agent between failed attempts.
-- Installs detected commands into `.ur/verify.json` with `ur test-first install`
-  so the existing verifier can run them after future edits.
-
-Aliases:
-
-```sh
-ur quality-loop --dry-run
-ur tf-loop detect
-```
-
-## Verification
-
-```sh
-bun run typecheck
-bun run lint
-bun test test/testFirstLoop.test.ts
-node ./bin/ur.js test-first --help
-node ./bin/ur.js test-first detect
-```
-
-If an external project has no lint script, `test-first` reports lint as a
-missing phase instead of inventing a command. UR itself now exposes
-`bun run lint`, so local quality detection includes compile, test, and lint.

package/docs/AGENT_UPGRADE_1.19.0.md

@@ -1,41 +0,0 @@
-# UR-AGENT 1.19.0 Upgrade Notes
-
-UR 1.19.0 adds two P0 agent reliability surfaces: project safety policy and
-project context packing.
-
-## What Changed
-
-- `ur safety status|init|check` evaluates shell command risk before execution.
-- Bash permission checks consult the project safety policy before broad allow
-  rules and sandbox auto-allow.
-- The safety policy separates read, write, execute, and network permission
-  classes.
-- Destructive commands require approval.
-- Write, execute, and network operations receive sandbox guidance.
-- Common secret-file and secret-like environment exfiltration paths are denied.
-- `ur context-pack scan|remember|compress` writes a manifest-backed repository
-  architecture summary and durable task memory.
-
-## New Project Files
-
-- `.ur/safety-policy.json` from `ur safety init`
-- `.ur/project-manifest.json` from `ur context-pack scan`
-- `.ur/context/architecture.md`
-- `.ur/context/task-memory.jsonl`
-- `.ur/context/compressed.md`
-
-Commit only shared policy and architecture files that are safe for teammates.
-Keep local task memory private when it contains local decisions, file paths, or
-operational notes that should not be shared.
-
-## Validate
-
-```sh
-ur safety status
-ur safety check --command "rm -rf build"
-ur context-pack scan
-ur context-pack remember --decision "Use manifest commands first"
-ur context-pack compress
-bun run typecheck
-bun test
-```