pacework 1.7.11 → 1.7.12

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.
@@ -13,13 +13,14 @@ import os from "node:os"
13
13
  import path from "node:path"
14
14
  import process from "node:process"
15
15
  import readline from "node:readline"
16
- import { AVAILABILITY_MODES } from "../lib/runner-control.mjs"
16
+ import { AVAILABILITY_MODES, runRunnerControlCommand } from "../lib/runner-control.mjs"
17
17
  import { spawn, execFileSync, execSync } from "node:child_process"
18
18
  import { fileURLToPath } from "node:url"
19
19
  import { agentSecretsFrom, detectSetupCommand } from "../lib/environment.mjs"
20
20
  import { describeTriageJob, runTriageLoop } from "../lib/triage-worker.mjs"
21
21
  import { NPM_PACKAGE, isNewerVersion, latestPublishedVersion } from "../lib/version.mjs"
22
22
  import { EXECUTORS, EXECUTOR_DEFAULT_NAMES, checkBinaryExists, executorLabel } from "../lib/executors.mjs"
23
+ import { SHELL_COMMANDS, parseShellInput } from "../lib/shell-commands.mjs"
23
24
  import { BANNER_LINES } from "../lib/ui.mjs"
24
25
  import {
25
26
  PACEWORK_DIR,
@@ -55,6 +56,14 @@ import {
55
56
 
56
57
  const __dirname = path.dirname(fileURLToPath(import.meta.url))
57
58
 
59
+ function readRunnerId(config) {
60
+ try {
61
+ const stateFile = path.join(config.repoRoot ?? process.cwd(), ".agent", "runners", `${config.workspaceId}-${config.executor ?? "claude_code"}.json`)
62
+ const state = JSON.parse(fs.readFileSync(stateFile, "utf8"))
63
+ return state.runner_id ?? null
64
+ } catch { return null }
65
+ }
66
+
58
67
  // ── version ───────────────────────────────────────────────────────────────────
59
68
 
60
69
  const LOCAL_VERSION = (() => {
@@ -323,6 +332,8 @@ ${row("pacework open [ENG-42]", "Open the workspace or an issue in the browser")
323
332
 
324
333
  \x1b[1mRunner\x1b[0m ${d("takes development and triage jobs")}
325
334
  ${row("pacework start | stop", "Start or stop it in the background")}
335
+ ${row("pacework pause | resume", "Pause or resume job pickup on this runner")}
336
+ ${row("pacework capacity <1-16>", "Set the maximum parallel jobs on this runner")}
326
337
  ${row("pacework status [--json]", "Is it running, and what is it doing")}
327
338
  ${row("pacework logs [--lines N]", "Follow its log")}
328
339
  ${row("pacework connect", "Run it in this terminal instead")}
@@ -1158,6 +1169,12 @@ else if (command === "stop") {
1158
1169
 
1159
1170
  // ── status ────────────────────────────────────────────────────────────────────
1160
1171
 
1172
+ else if (["capacity", "pause", "resume"].includes(command)) {
1173
+ const config = readConfig()
1174
+ const result = await runRunnerControlCommand(config, readRunnerId(config), command, process.argv.slice(3))
1175
+ if (result.ok) console.log(result.message)
1176
+ else { console.error(result.message); process.exitCode = 1 }
1177
+ }
1161
1178
  else if (command === "status") {
1162
1179
  if (parsedArgs.json) {
1163
1180
  // For scripts: the same facts as the home screen, without the raw log or the key.
@@ -1319,9 +1336,8 @@ else if (command === "menu") {
1319
1336
  }
1320
1337
 
1321
1338
  else if (command === "shell" || command === "sh") {
1322
- printBanner(readConfig())
1323
-
1324
- const SHELL_COMMANDS = ["status", "jobs", "logs", "tail", "config", "use", "doctor", "start", "stop", "restart", "connect", "login", "logout", "whoami", "rename", "open", "update", "help", "exit", "quit", "clear"]
1339
+ const oneShot = process.argv[3] === "--command" ? process.argv[4] ?? "" : null
1340
+ if (oneShot === null) printBanner(readConfig())
1325
1341
 
1326
1342
  // ── fetch active runs from API ──────────────────────────────────────────────
1327
1343
  async function fetchActiveRuns(config) {
@@ -1412,10 +1428,9 @@ else if (command === "shell" || command === "sh") {
1412
1428
  console.log("")
1413
1429
  }
1414
1430
 
1415
- await printWelcome()
1416
-
1417
- // ── auto-start runner if logged in but not running ────────────────────────
1418
- {
1431
+ if (oneShot === null) {
1432
+ await printWelcome()
1433
+ // Auto-start the legacy interactive shell as before.
1419
1434
  const cfg = readConfig()
1420
1435
  const pid = readPid()
1421
1436
  const loggedIn = !!(cfg.apiKey || cfg.workspaceApiKey)
@@ -1440,46 +1455,6 @@ else if (command === "shell" || command === "sh") {
1440
1455
 
1441
1456
  // ── orchestrator helpers ──────────────────────────────────────────────────
1442
1457
 
1443
- function readRunnerId(config) {
1444
- try {
1445
- const stateFile = path.join(config.repoRoot ?? process.cwd(), ".agent", "runners", `${config.workspaceId}-${config.executor ?? "claude_code"}.json`)
1446
- const state = JSON.parse(fs.readFileSync(stateFile, "utf8"))
1447
- return state.runner_id ?? null
1448
- } catch { return null }
1449
- }
1450
-
1451
- async function runnerControlCommand(config, action, extra = {}) {
1452
- const key = config.apiKey ?? config.workspaceApiKey
1453
- const wsId = config.workspaceId
1454
- const appUrl = (config.appUrl ?? "https://pacework.io").replace(/\/$/, "")
1455
- if (!key || !wsId) { console.log("\n Not logged in — run /login first.\n"); return }
1456
-
1457
- const runnerId = readRunnerId(config)
1458
- if (!runnerId) {
1459
- console.log(`\n \x1b[33m⚠\x1b[0m Runner ID not found. Start the runner first (/start) so it registers.\n`)
1460
- return
1461
- }
1462
-
1463
- const labels = { pause: "Pausing", resume: "Resuming", set_capacity: "Updating capacity" }
1464
- console.log(`\n \x1b[2m${labels[action] ?? action} runner ${runnerId.slice(0,8)}…\x1b[0m`)
1465
- try {
1466
- const res = await fetch(`${appUrl}/api/workspaces/${wsId}/agent-runners/${runnerId}/control`, {
1467
- method: "POST",
1468
- headers: { "content-type": "application/json", "x-workspace-api-key": key },
1469
- body: JSON.stringify({ workspace_id: wsId, action, ...extra }),
1470
- signal: AbortSignal.timeout(5000),
1471
- })
1472
- if (res.ok) {
1473
- const msgs = { pause: "Runner paused — no new jobs will be picked up", resume: "Runner resumed", set_capacity: `Max parallel runs set to ${extra.max_parallel_runs}` }
1474
- console.log(` \x1b[32m✓\x1b[0m ${msgs[action] ?? "Done"}`)
1475
- } else {
1476
- const b = await res.json().catch(() => ({}))
1477
- console.log(` \x1b[31m✗\x1b[0m Failed (${res.status}): ${b.message ?? b.error ?? ""}`)
1478
- }
1479
- } catch (e) { console.log(` \x1b[31mFailed: ${e.message}\x1b[0m`) }
1480
- console.log("")
1481
- }
1482
-
1483
1458
  async function fetchMcpServerList(config) {
1484
1459
  const key = config.apiKey ?? config.workspaceApiKey
1485
1460
  const wsId = config.workspaceId
@@ -1498,9 +1473,7 @@ else if (command === "shell" || command === "sh") {
1498
1473
  }
1499
1474
 
1500
1475
  async function runShellCommand(input) {
1501
- const parts = input.trim().split(/\s+/)
1502
- const cmd = parts[0]
1503
- const args = parts.slice(1)
1476
+ const { command: cmd, args } = parseShellInput(input)
1504
1477
 
1505
1478
  switch (cmd) {
1506
1479
  case "help": {
@@ -2401,21 +2374,14 @@ else if (command === "shell" || command === "sh") {
2401
2374
  } catch (e) { console.log(` \x1b[31mFailed: ${e.message}\x1b[0m\n`) }
2402
2375
  break
2403
2376
  }
2404
- case "pause": {
2405
- const config = readConfig()
2406
- await runnerControlCommand(config, "pause")
2407
- break
2408
- }
2409
- case "resume": {
2410
- const config = readConfig()
2411
- await runnerControlCommand(config, "resume")
2412
- break
2413
- }
2377
+ case "pause":
2378
+ case "resume":
2414
2379
  case "capacity": {
2415
2380
  const config = readConfig()
2416
- const n = parseInt(args[0], 10)
2417
- if (!n || n < 1 || n > 16) { console.log(`\n Usage: /capacity <1-16> — set max parallel jobs\n`); break }
2418
- await runnerControlCommand(config, "set_capacity", { max_parallel_runs: n })
2381
+ const result = await runRunnerControlCommand(config, readRunnerId(config), cmd, args)
2382
+ const symbol = result.ok ? "\x1b[32m✓" : "\x1b[31m✗"
2383
+ console.log(` ${symbol}\x1b[0m ${result.message}\n`)
2384
+ if (oneShot !== null && !result.ok) process.exitCode = 1
2419
2385
  break
2420
2386
  }
2421
2387
  case "mcp": {
@@ -2743,42 +2709,20 @@ else if (command === "shell" || command === "sh") {
2743
2709
  }
2744
2710
  }
2745
2711
 
2712
+ if (oneShot !== null) {
2713
+ if (process.stdin.isTTY && parseShellInput(oneShot).command === "login") {
2714
+ process.stdin.setRawMode(true)
2715
+ process.stdin.resume()
2716
+ }
2717
+ try {
2718
+ await runShellCommand(oneShot)
2719
+ } finally {
2720
+ if (process.stdin.isTTY) process.stdin.setRawMode(false)
2721
+ process.stdin.pause()
2722
+ }
2723
+ } else {
2746
2724
  // ── raw TTY input loop with / dropdown ───────────────────────────────────
2747
2725
 
2748
- const SLASH_COMMANDS = [
2749
- { name: "status", desc: "Show runner status and config" },
2750
- { name: "jobs", desc: "Active runs + recent history" },
2751
- { name: "watch", desc: "Auto-refresh jobs table every 3s in-place (Ctrl+C to stop)" },
2752
- { name: "issues", desc: "List open issues in the workspace" },
2753
- { name: "run", desc: "Dispatch an issue to this runner (e.g. /run PLT-42)" },
2754
- { name: "cancel", desc: "Cancel a running job (e.g. /cancel <run-id>)" },
2755
- { name: "retry", desc: "Retry a failed job (e.g. /retry <run-id>)" },
2756
- { name: "pause", desc: "Pause this runner (maintenance mode)" },
2757
- { name: "resume", desc: "Resume a paused runner" },
2758
- { name: "capacity", desc: "Set max parallel jobs (e.g. /capacity 3)" },
2759
- { name: "mcp", desc: "MCP tools — /mcp install | status | test" },
2760
- { name: "executor", desc: "Executor tools — /executor test" },
2761
- { name: "stats", desc: "Job throughput — runs today, success rate, avg duration" },
2762
- { name: "tail", desc: "Live-stream the runner log" },
2763
- { name: "logs", desc: "Tail last N log lines" },
2764
- { name: "start", desc: "Start runner as background daemon" },
2765
- { name: "stop", desc: "Stop the background daemon" },
2766
- { name: "restart", desc: "Stop then start daemon" },
2767
- { name: "connect", desc: "Run runner in foreground (exit shell first)" },
2768
- { name: "use", desc: "Switch executor (e.g. /use gemini)" },
2769
- { name: "rename", desc: "Set runner display name" },
2770
- { name: "whoami", desc: "Show workspace and key info" },
2771
- { name: "open", desc: "Open workspace in browser" },
2772
- { name: "config", desc: "View or set config values" },
2773
- { name: "doctor", desc: "Check dependencies" },
2774
- { name: "update", desc: "Upgrade pacework to the latest version" },
2775
- { name: "login", desc: "Authenticate via browser" },
2776
- { name: "logout", desc: "Revoke API key and clear credentials" },
2777
- { name: "help", desc: "Show this help screen" },
2778
- { name: "clear", desc: "Clear screen" },
2779
- { name: "pid", desc: "Show runner process ID" },
2780
- { name: "exit", desc: "Exit the shell" },
2781
- ]
2782
2726
 
2783
2727
  // subcommand hints shown after "<cmd> "
2784
2728
  const SUBCOMMANDS = {
@@ -2944,7 +2888,7 @@ else if (command === "shell" || command === "sh") {
2944
2888
 
2945
2889
  function openDropdown(filter) {
2946
2890
  dropdownActive = true
2947
- dropdownItems = SLASH_COMMANDS.filter(c => c.name.startsWith(filter))
2891
+ dropdownItems = SHELL_COMMANDS.filter(c => c.name.startsWith(filter))
2948
2892
  dropdownIndex = 0
2949
2893
  dropdownOffset = 0
2950
2894
  }
@@ -3085,6 +3029,7 @@ else if (command === "shell" || command === "sh") {
3085
3029
  return
3086
3030
  }
3087
3031
  })
3032
+ }
3088
3033
  }
3089
3034
 
3090
3035
  // ── up (one-command setup) ─────────────────────────────────────────────────────
package/lib/home.mjs CHANGED
@@ -1,4 +1,5 @@
1
1
  import readline from "node:readline"
2
+ import { stripVTControlCharacters } from "node:util"
2
3
  import { spawn } from "node:child_process"
3
4
  import { readConfig, readRunnerSnapshot } from "./control-state.mjs"
4
5
  import { executorLabel } from "./executors.mjs"
@@ -8,6 +9,7 @@ import { runnerSettingRows } from "./runner-settings.mjs"
8
9
  import { TRIAGE_EXECUTORS } from "./triage-worker.mjs"
9
10
  import { BANNER_LINES, LOGO, formatDuration, hostOf, relativeTime, style, tildePath, truncate, visibleLength } from "./ui.mjs"
10
11
  import { formatIssueRows, listIssues } from "./issues-cli.mjs"
12
+ import { SHELL_COMMANDS, closestShellCommand, commandMatches, commandTakesTerminal, editCommandPrompt, parseShellInput } from "./shell-commands.mjs"
11
13
  import { workspaceUrl } from "./workspace-api.mjs"
12
14
 
13
15
  /**
@@ -25,6 +27,7 @@ const KEYS = [
25
27
  ["w", "switch"],
26
28
  ["o", "open"],
27
29
  ["d", "doctor"],
30
+ ["/", "command"],
28
31
  ["?", "help"],
29
32
  ["q", "quit"],
30
33
  ]
@@ -38,6 +41,7 @@ const HELP = [
38
41
  ["c", "Runner settings: AI tool, model, folder, parallel jobs, triage, sandbox, name"],
39
42
  ["o", "Open this workspace in your browser"],
40
43
  ["d", "Run the health check"],
44
+ ["/ or :", "Open the command prompt; Tab completes and Esc closes it"],
41
45
  ["q", "Quit this screen; the runner keeps working in the background"],
42
46
  ]
43
47
 
@@ -46,6 +50,8 @@ const PLAIN_COMMANDS = [
46
50
  ["pacework mcp add | status", "Connect AI tools to pacework"],
47
51
  ["pacework status [--json]", "Is the runner up, and what is it doing"],
48
52
  ["pacework start | stop", "Start or stop the background runner"],
53
+ ["pacework pause | resume", "Pause or resume pickup"],
54
+ ["pacework capacity <1-16>", "Set the maximum number of parallel runs"],
49
55
  ["pacework logs", "Follow the runner log"],
50
56
  ["pacework login | logout", "Sign in to a pacework, or sign out"],
51
57
  ["pacework settings", "Change runner settings"],
@@ -60,15 +66,18 @@ function runCtl(ctlScript, args) {
60
66
  child.stdout.on("data", (chunk) => { output += chunk })
61
67
  child.stderr.on("data", (chunk) => { output += chunk })
62
68
  child.on("error", () => resolve({ ok: false, output }))
63
- child.on("close", (code) => resolve({ ok: code === 0, output: output.replace(/\x1b\[[0-9;]*m/g, "").trim() }))
69
+ child.on("close", (code) => resolve({ ok: code === 0, output: stripVTControlCharacters(output).trim() }))
64
70
  })
65
71
  }
66
72
 
67
73
  function runCtlInteractive(ctlScript, args) {
68
74
  return new Promise((resolve) => {
69
75
  const child = spawn(process.execPath, [ctlScript, ...args], { stdio: "inherit", env: process.env })
70
- child.on("close", () => resolve())
71
- child.on("error", () => resolve())
76
+ const keepHomeOpen = () => {}
77
+ const done = () => { process.removeListener("SIGINT", keepHomeOpen); resolve() }
78
+ process.on("SIGINT", keepHomeOpen)
79
+ child.on("close", done)
80
+ child.on("error", done)
72
81
  })
73
82
  }
74
83
 
@@ -101,6 +110,10 @@ export async function runHome({ ctlScript, version }) {
101
110
  let flash = null
102
111
  let busy = false
103
112
  let timer = null
113
+ let prompt = null
114
+ const history = []
115
+ let resultView = { lines: [], offset: 0, command: "" }
116
+ let visibleResultRows = 1
104
117
 
105
118
  const setFlash = (text, tone = "info") => { flash = { text, tone, until: Date.now() + 6000 } }
106
119
 
@@ -128,7 +141,12 @@ export async function runHome({ ctlScript, version }) {
128
141
  lines.push(` ${style.gray(`model ${setting.model} · ${setting.maxParallelRuns} at a time${config.sandbox ? " · sandboxed" : ""} · c to change`)}`)
129
142
  lines.push("")
130
143
 
131
- if (mode === "issues") {
144
+ if (mode === "result") {
145
+ lines.push(` ${style.bold(resultView.command)} ${style.gray("↑/↓ scroll · Esc back")}`)
146
+ visibleResultRows = Math.max(1, height - lines.length - 2)
147
+ resultView.offset = Math.min(resultView.offset, Math.max(0, resultView.lines.length - visibleResultRows))
148
+ lines.push(...resultView.lines.slice(resultView.offset, resultView.offset + visibleResultRows).map((line) => truncate(line, width)))
149
+ } else if (mode === "issues") {
132
150
  lines.push(` ${style.bold("Assigned to you")} ${style.gray("↑/↓ choose · Enter open · r refresh · Esc back")}`)
133
151
  if (issues.state === "loading") lines.push(style.gray(" Loading…"))
134
152
  else if (issues.state === "error") lines.push(` ${style.red(issues.error)}`)
@@ -180,11 +198,20 @@ export async function runHome({ ctlScript, version }) {
180
198
  }
181
199
  }
182
200
 
183
- while (lines.length < height - 2) lines.push("")
201
+ const matches = prompt ? commandMatches(prompt.value).slice(0, 5) : []
202
+ const reserved = prompt ? matches.length + 2 : 2
203
+ lines.length = Math.min(lines.length, height - reserved)
204
+ while (lines.length < height - reserved) lines.push("")
184
205
  if (flash && flash.until < Date.now()) flash = null
185
- const flashText = busy ? style.brand(`${busy}…`) : flash ? (flash.tone === "error" ? style.red(flash.text) : style.green(flash.text)) : ""
186
- lines.push(` ${truncate(flashText, width + 20)}`)
187
- lines.push(` ${KEYS.map(([key, label]) => `${style.bold(key)} ${style.gray(label)}`).join(" ")}`)
206
+ if (prompt) {
207
+ matches.forEach((command, index) => lines.push(` ${index === prompt.selected ? style.brand("❯") : " "} /${command.name} ${style.gray(truncate(command.desc, width - command.name.length - 7))}`))
208
+ lines.push(` ${style.brand(">")} ${truncate(prompt.value, width - 4)}`)
209
+ lines.push(` ${style.gray("Enter run · Tab complete · Esc close")}`)
210
+ } else {
211
+ const flashText = busy ? style.brand(`${busy}…`) : flash ? (flash.tone === "error" ? style.red(flash.text) : style.green(flash.text)) : ""
212
+ lines.push(` ${truncate(flashText, width + 20)}`)
213
+ lines.push(` ${KEYS.map(([key, label]) => `${style.bold(key)} ${style.gray(label)}`).join(" ")}`)
214
+ }
188
215
 
189
216
  stdout.write(`\x1b[H${lines.slice(0, height).map((line) => `${line}\x1b[K`).join("\n")}\x1b[J`)
190
217
  }
@@ -259,10 +286,54 @@ export async function runHome({ ctlScript, version }) {
259
286
  render()
260
287
  }
261
288
 
289
+ async function executePrompt(input) {
290
+ const { command, args } = parseShellInput(input)
291
+ if (!command) return render()
292
+ if (history.at(-1) !== input) history.push(input)
293
+ if (command === "exit" || command === "quit") return quit()
294
+ if (command === "clear") { flash = null; return render() }
295
+ if (!SHELL_COMMANDS.some((item) => item.name === command)) {
296
+ const closest = closestShellCommand(command)
297
+ setFlash(`Unknown command: ${command}.${closest ? ` Try /${closest}.` : " Use /help to list commands."}`, "error")
298
+ return render()
299
+ }
300
+ const invocation = ["shell", "--command", input]
301
+ if (commandTakesTerminal(command, args)) return suspend(() => runCtlInteractive(ctlScript, invocation))
302
+ return withBusy(`Running /${command}`, async () => {
303
+ const result = await runCtl(ctlScript, invocation)
304
+ const output = result.output.split("\n")
305
+ if (output.length > 3) {
306
+ resultView = { command: `/${command}`, lines: output, offset: 0 }
307
+ mode = "result"
308
+ } else {
309
+ setFlash(output.join(" · ") || (result.ok ? "Done." : "The command failed."), result.ok ? "info" : "error")
310
+ }
311
+ })
312
+ }
313
+
262
314
  async function onKey(text, key = {}) {
263
315
  if (key.ctrl && key.name === "c") return quit()
264
316
  if (busy) return
265
317
  const name = key.name ?? text
318
+ if (prompt) {
319
+ if (name === "return") {
320
+ const input = prompt.value
321
+ prompt = null
322
+ return executePrompt(input)
323
+ }
324
+ prompt = editCommandPrompt(prompt, name, text, history)
325
+ return render()
326
+ }
327
+ if (mode === "result") {
328
+ if (name === "escape" || name === "q") mode = "home"
329
+ else if (name === "up") resultView.offset = Math.max(0, resultView.offset - 1)
330
+ else if (name === "down") resultView.offset = Math.min(Math.max(0, resultView.lines.length - visibleResultRows), resultView.offset + 1)
331
+ return render()
332
+ }
333
+ if (mode === "home" && (text === "/" || text === ":")) {
334
+ prompt = { value: "", selected: 0, historyIndex: history.length }
335
+ return render()
336
+ }
266
337
  if (mode === "issues") {
267
338
  if (name === "escape" || name === "i" || name === "q") { mode = "home"; return render() }
268
339
  if (name === "up") issues.selected = Math.max(0, issues.selected - 1)
@@ -59,3 +59,34 @@ export function describeRegistration(state) {
59
59
  const labels = state?.labels?.length ? state.labels.join(", ") : "none"
60
60
  return `Registered as "${state?.name ?? "unnamed"}" (labels: ${labels})`
61
61
  }
62
+
63
+ /** Shared by the interactive shell and the plain terminal commands. */
64
+ export async function runRunnerControlCommand(config, runnerId, command, args = [], request = fetch) {
65
+ const capacity = args.length === 1 && /^\d+$/.test(args[0]) ? Number(args[0]) : null
66
+ if (command === "capacity" && (!capacity || capacity > 16)) return { ok: false, message: "Usage: pacework capacity <1-16>" }
67
+ if (command !== "capacity" && args.length) return { ok: false, message: `Usage: pacework ${command}` }
68
+ const key = config.apiKey ?? config.workspaceApiKey
69
+ const workspaceId = config.workspaceId
70
+ if (!key || !workspaceId) return { ok: false, message: "Sign in with pacework login first." }
71
+ if (!runnerId) return { ok: false, message: "Start the runner first so it can register." }
72
+ const appUrl = (config.appUrl ?? "https://pacework.io").replace(/\/$/, "")
73
+ const action = command === "capacity" ? "set_capacity" : command
74
+ try {
75
+ const response = await request(`${appUrl}/api/workspaces/${workspaceId}/agent-runners/${runnerId}/control`, {
76
+ method: "POST",
77
+ headers: { "content-type": "application/json", "x-workspace-api-key": key },
78
+ body: JSON.stringify({ workspace_id: workspaceId, action, ...(capacity ? { max_parallel_runs: capacity } : {}) }),
79
+ signal: AbortSignal.timeout(5000),
80
+ })
81
+ if (!response.ok) {
82
+ const payload = await response.json().catch(() => ({}))
83
+ const detail = payload.message ?? payload.error
84
+ return { ok: false, message: Array.isArray(detail) ? detail.join(". ") : detail || `Runner control failed (HTTP ${response.status}).` }
85
+ }
86
+ const message = command === "capacity" ? `Max parallel runs set to ${capacity}`
87
+ : command === "pause" ? "Runner paused. It won’t pick up new jobs." : "Runner resumed."
88
+ return { ok: true, message }
89
+ } catch (error) {
90
+ return { ok: false, message: error instanceof Error ? error.message : "Could not reach the runner." }
91
+ }
92
+ }
@@ -0,0 +1,98 @@
1
+ export const SHELL_COMMANDS = [
2
+ { name: "status", desc: "Show runner status and config" },
3
+ { name: "jobs", desc: "Active runs + recent history" },
4
+ { name: "watch", desc: "Auto-refresh jobs table every 3s in-place (Ctrl+C to stop)" },
5
+ { name: "issues", desc: "List open issues in the workspace" },
6
+ { name: "run", desc: "Dispatch an issue to this runner (e.g. /run PLT-42)" },
7
+ { name: "cancel", desc: "Cancel a running job (e.g. /cancel <run-id>)" },
8
+ { name: "retry", desc: "Retry a failed job (e.g. /retry <run-id>)" },
9
+ { name: "pause", desc: "Pause this runner (maintenance mode)" },
10
+ { name: "resume", desc: "Resume a paused runner" },
11
+ { name: "capacity", desc: "Set max parallel jobs (e.g. /capacity 3)" },
12
+ { name: "mcp", desc: "MCP tools — /mcp install | status | test" },
13
+ { name: "executor", desc: "Executor tools — /executor test" },
14
+ { name: "stats", desc: "Job throughput — runs today, success rate, avg duration" },
15
+ { name: "tail", desc: "Live-stream the runner log" },
16
+ { name: "logs", desc: "Tail last N log lines" },
17
+ { name: "start", desc: "Start runner as background daemon" },
18
+ { name: "stop", desc: "Stop the background daemon" },
19
+ { name: "restart", desc: "Stop then start daemon" },
20
+ { name: "connect", desc: "Run runner in foreground" },
21
+ { name: "use", desc: "Switch executor (e.g. /use gemini)" },
22
+ { name: "rename", desc: "Set runner display name" },
23
+ { name: "whoami", desc: "Show workspace and key info" },
24
+ { name: "open", desc: "Open workspace in browser" },
25
+ { name: "config", desc: "View or set config values" },
26
+ { name: "doctor", desc: "Check dependencies" },
27
+ { name: "update", desc: "Upgrade pacework to the latest version" },
28
+ { name: "login", desc: "Authenticate via browser" },
29
+ { name: "logout", desc: "Revoke API key and clear credentials" },
30
+ { name: "help", desc: "Show this help screen" },
31
+ { name: "clear", desc: "Clear screen" },
32
+ { name: "pid", desc: "Show runner process ID" },
33
+ { name: "mine", desc: "Issues assigned to you" },
34
+ { name: "issue", desc: "Show a specific issue" },
35
+ { name: "agents", desc: "List workspace agents" },
36
+ { name: "dashboard", desc: "Show orchestration status" },
37
+ { name: "logtail", desc: "Stream the live log for a run" },
38
+ { name: "quit", desc: "Exit the shell" },
39
+ { name: "exit", desc: "Exit the shell" },
40
+ ]
41
+
42
+ export function parseShellInput(input) {
43
+ const [command, ...args] = input.trim().replace(/^[/:]/, "").trim().split(/\s+/)
44
+ return { command: command.toLowerCase(), args }
45
+ }
46
+
47
+ export function commandMatches(input) {
48
+ if (/\s/.test(input.replace(/^[/:]/, "").trimStart())) return []
49
+ const { command } = parseShellInput(input)
50
+ return SHELL_COMMANDS.filter((item) => item.name.startsWith(command))
51
+ }
52
+
53
+ export function closestShellCommand(input) {
54
+ let best = null
55
+ let distance = Infinity
56
+ for (const { name } of SHELL_COMMANDS) {
57
+ let row = Array.from({ length: name.length + 1 }, (_, index) => index)
58
+ for (let i = 0; i < input.length; i += 1) {
59
+ const next = [i + 1]
60
+ for (let j = 0; j < name.length; j += 1) {
61
+ next.push(Math.min(row[j + 1] + 1, next[j] + 1, row[j] + (input[i] === name[j] ? 0 : 1)))
62
+ }
63
+ row = next
64
+ }
65
+ if (row.at(-1) < distance) {
66
+ best = name
67
+ distance = row.at(-1)
68
+ }
69
+ }
70
+ return distance <= 2 ? best : null
71
+ }
72
+
73
+ export function commandTakesTerminal(command, args) {
74
+ return ["login", "connect", "tail", "watch", "logtail", "update"].includes(command)
75
+ || (command === "mcp" && args[0] === "install")
76
+ }
77
+
78
+ export function editCommandPrompt(prompt, key, text, history) {
79
+ const { value, selected, historyIndex } = prompt
80
+ const matches = commandMatches(value).slice(0, 5)
81
+ if (key === "escape") return null
82
+ if (key === "tab" && matches[selected]) {
83
+ return { value: `${matches[selected].name} `, selected: 0, historyIndex: history.length }
84
+ }
85
+ if (key === "up" || key === "down") {
86
+ const direction = key === "up" ? -1 : 1
87
+ if ((!value || historyIndex < history.length) && history.length) {
88
+ const index = Math.max(0, Math.min(history.length, historyIndex + direction))
89
+ return { value: history[index] ?? "", selected: 0, historyIndex: index }
90
+ }
91
+ return { ...prompt, selected: Math.max(0, Math.min(matches.length - 1, selected + direction)) }
92
+ }
93
+ if (key === "backspace") return { value: value.slice(0, -1), selected: 0, historyIndex: history.length }
94
+ if (text && !/[\u0000-\u001f\u007f]/.test(text)) {
95
+ return { value: (value + text).slice(0, 500), selected: 0, historyIndex: history.length }
96
+ }
97
+ return prompt
98
+ }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "pacework",
3
- "version": "1.7.11",
3
+ "version": "1.7.12",
4
4
  "description": "pacework CLI: connect this machine as a runner for pacework AI agents",
5
5
  "type": "module",
6
6
  "bin": {