ur-agent 1.12.2 → 1.13.0

package/CHANGELOG.md

@@ -1,5 +1,42 @@
 # Changelog
 
+## 1.13.0
+
+### Fixed
+- **Image paste hint.** When the clipboard holds no image, the image paste
+  shortcut (`ctrl+v`, `alt+v` on Windows) no longer shows a circular "use
+  ctrl+v to paste images" message — the very key that was just pressed. It now
+  tells you to copy an image (e.g. a screenshot) first, then press the shortcut
+  to paste it. SSH sessions keep the existing `scp` hint.
+
+## 1.12.3
+
+### Added
+- **Agent feature expansion commands.** Added `ur agent-features`,
+  `ur agent-templates`, `ur automation`, `ur agent-task`, `ur model-doctor`,
+  `ur semantic-memory`, `ur claim-ledger`, and `ur browser-qa` so the agent
+  platform roadmap is visible and executable from both CLI and slash command
+  surfaces.
+- **Opt-in A2A task server.** `ur a2a serve` now exposes loopback Agent Card,
+  health, and dry-run task endpoints from the launcher, with off-loopback binds
+  requiring a bearer token.
+- **Project scaffolds and examples.** `ur agent-features init` creates reusable
+  project assets for agents, automations, GitHub workflow entrypoints, A2A,
+  memory, provenance, and browser QA, with `examples/agent_features.md`
+  documenting the workflow.
+
+### Fixed
+- **Agent template typo safety.** `ur agent-templates install <name>` now
+  rejects unknown template names instead of interpreting a misspelling as
+  "install all templates."
+- **Ollama model inspection request.** `ur model-doctor` now uses the preferred
+  `/api/show` request body key (`model`) when inspecting local Ollama models.
+
+### Verified
+- Added focused Bun tests for feature scaffolds, template installation,
+  automations, PR dry-run generation, local memory/provenance/browser QA
+  commands, and the model-doctor Ollama request body.
+
 ## 1.12.2
 
 ### Changed

package/README.md

@@ -104,9 +104,10 @@ ur plugin --help
 - [Usage Guide](docs/USAGE.md)
 - [Configuration](docs/CONFIGURATION.md)
 - [Agent Trend Coverage](docs/AGENT_TRENDS.md)
+- [Agent Feature Expansion](docs/AGENT_FEATURES.md)
 - [Development Guide](docs/DEVELOPMENT.md)
 
-The `examples/` directory also contains prompt examples for coding, research, browser, image, video, MCP, memory, and agent-trend workflows.
+The `examples/` directory also contains prompt examples for coding, research, browser, image, video, MCP, memory, agent-trend, and agent-feature workflows.
 
 ## License And Responsibility
 

package/bin/ur.js

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 import { spawn } from 'node:child_process'
 import { existsSync, readFileSync } from 'node:fs'
+import { createServer } from 'node:http'
 import { dirname, resolve } from 'node:path'
 import { fileURLToPath } from 'node:url'
 
@@ -38,6 +39,196 @@ const bun = process.env.BUN_BIN || process.env.BUN_EXECUTABLE || 'bun'
 const ollamaModel =
   process.env.OLLAMA_MODEL || process.env.UR_MODEL
 const userArgs = process.argv.slice(2)
+
+function argValue(flag, fallback) {
+  const index = userArgs.indexOf(flag)
+  return index === -1 ? fallback : (userArgs[index + 1] ?? fallback)
+}
+
+function isLoopback(host) {
+  return host === '127.0.0.1' || host === 'localhost' || host === '::1'
+}
+
+function sendJson(res, status, body) {
+  res.writeHead(status, { 'content-type': 'application/json' })
+  res.end(JSON.stringify(body, null, 2))
+}
+
+function readJson(req) {
+  return new Promise(resolve => {
+    const chunks = []
+    req.on('data', chunk => chunks.push(Buffer.from(chunk)))
+    req.on('end', () => {
+      try {
+        resolve(JSON.parse(Buffer.concat(chunks).toString('utf8') || '{}'))
+      } catch {
+        resolve(null)
+      }
+    })
+    req.on('error', () => resolve(null))
+  })
+}
+
+function buildAgentCard(baseUrl) {
+  return {
+    protocolVersion: '0.3.0',
+    name: 'UR Agent',
+    description:
+      'Local-first terminal coding agent powered through the local Ollama app, with MCP tools, custom agents, browser workflows, memory, verifier gates, and permission controls.',
+    url: `${baseUrl}/a2a`,
+    version,
+    documentationUrl:
+      'https://github.com/Maitham16/UR-mapek/blob/master/docs/AGENT_TRENDS.md',
+    capabilities: {
+      streaming: true,
+      pushNotifications: false,
+      stateTransitionHistory: true,
+    },
+    defaultInputModes: ['text/plain', 'text/markdown', 'application/json'],
+    defaultOutputModes: ['text/plain', 'text/markdown', 'application/json'],
+    provider: {
+      organization: 'Maitham Al-rubaye',
+      url: 'https://github.com/Maitham16/UR-mapek',
+    },
+    skills: [
+      {
+        id: 'coding-agent',
+        name: 'Coding Agent',
+        description:
+          'Read, edit, test, verify, and explain code inside a local workspace with permission controls.',
+        tags: ['coding', 'terminal', 'verification'],
+        examples: [
+          'Fix this failing test and run the relevant checks.',
+          'Review the current diff for behavioral regressions.',
+        ],
+        inputModes: ['text/plain', 'text/markdown'],
+        outputModes: ['text/plain', 'text/markdown'],
+      },
+    ],
+  }
+}
+
+function runAgentPrompt(prompt) {
+  const childArgs = existsSync(bundledEntrypoint)
+    ? [bundledEntrypoint, '-p', '--output-format', 'json', prompt]
+    : [
+        'run',
+        '--preload',
+        preload,
+        '--define',
+        defineMacro('MACRO.VERSION', version),
+        '--define',
+        defineMacro('MACRO.BUILD_TIME', ''),
+        '--define',
+        defineMacro('MACRO.PACKAGE_URL', packageName),
+        '--define',
+        defineMacro('MACRO.NATIVE_PACKAGE_URL', undefined),
+        '--define',
+        defineMacro('MACRO.FEEDBACK_CHANNEL', issuesUrl),
+        '--define',
+        defineMacro('MACRO.ISSUES_EXPLAINER', `file an issue at ${issuesUrl}`),
+        '--define',
+        defineMacro('MACRO.VERSION_CHANGELOG', ''),
+        entrypoint,
+        '-p',
+        '--output-format',
+        'json',
+        prompt,
+      ]
+
+  return new Promise(resolve => {
+    const child = spawn(bun, childArgs, {
+      cwd: process.cwd(),
+      env: {
+        ...process.env,
+        ...(ollamaModel ? { OLLAMA_MODEL: ollamaModel } : {}),
+      },
+      stdio: ['ignore', 'pipe', 'pipe'],
+    })
+    const stdout = []
+    const stderr = []
+    child.stdout.on('data', chunk => stdout.push(Buffer.from(chunk)))
+    child.stderr.on('data', chunk => stderr.push(Buffer.from(chunk)))
+    child.on('error', error => {
+      resolve({ code: 1, stdout: '', stderr: error.message })
+    })
+    child.on('exit', code => {
+      resolve({
+        code: code ?? 1,
+        stdout: Buffer.concat(stdout).toString('utf8'),
+        stderr: Buffer.concat(stderr).toString('utf8'),
+      })
+    })
+  })
+}
+
+function runA2AServer() {
+  const host = argValue('--host', '127.0.0.1')
+  const port = Number(argValue('--port', '8765'))
+  const token = argValue('--token')
+  const dryRun = userArgs.includes('--dry-run')
+  if (!Number.isInteger(port) || port < 0 || port > 65535) {
+    console.error(`Invalid --port value: ${argValue('--port')}`)
+    process.exit(1)
+  }
+  if (!isLoopback(host) && !token) {
+    console.error('Refusing to bind a2a server off-loopback without --token')
+    process.exit(1)
+  }
+
+  const baseUrl = `http://${host}:${port}`
+  const server = createServer(async (req, res) => {
+    const url = new URL(req.url ?? '/', baseUrl)
+    if (req.method === 'GET' && url.pathname === '/healthz') {
+      sendJson(res, 200, { ok: true })
+      return
+    }
+    if (
+      req.method === 'GET' &&
+      (url.pathname === '/.well-known/agent-card.json' ||
+        url.pathname === '/agent-card.json')
+    ) {
+      sendJson(res, 200, buildAgentCard(baseUrl))
+      return
+    }
+    if (req.method === 'POST' && url.pathname === '/a2a/tasks') {
+      if (token && req.headers.authorization !== `Bearer ${token}`) {
+        sendJson(res, 401, { error: 'unauthorized' })
+        return
+      }
+      const body = await readJson(req)
+      const prompt =
+        body && typeof body.prompt === 'string' ? body.prompt.trim() : ''
+      if (!prompt) {
+        sendJson(res, 400, { error: 'missing prompt' })
+        return
+      }
+      const command = [bun, bundledEntrypoint, '-p', '--output-format', 'json', prompt]
+      if (dryRun) {
+        sendJson(res, 200, { dryRun: true, command })
+        return
+      }
+      const result = await runAgentPrompt(prompt)
+      sendJson(res, result.code === 0 ? 200 : 500, result)
+      return
+    }
+    sendJson(res, 404, { error: 'not found' })
+  })
+  server.listen(port, host, () => {
+    const actual = server.address()
+    const actualPort = actual && typeof actual === 'object' ? actual.port : port
+    console.log(`A2A server listening on http://${host}:${actualPort}`)
+  })
+}
+
+if (
+  userArgs[0] === 'a2a' &&
+  userArgs[1] === 'serve' &&
+  !userArgs.includes('--help') &&
+  !userArgs.includes('-h')
+) {
+  runA2AServer()
+} else {
 const args =
   existsSync(bundledEntrypoint)
     ? [bundledEntrypoint, ...userArgs]
@@ -92,3 +283,4 @@ child.on('exit', (code, signal) => {
 
   process.exit(code ?? 1)
 })
+}