@xevy/cli 0.1.12 → 0.1.14

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/README.md CHANGED
@@ -150,10 +150,14 @@ xevy dev VI22-07 --base https://xevy.example.com
150
150
  ```
151
151
 
152
152
  The CLI resolves an exact task ID or task code, attaches to its existing Dev
153
- Session, or starts one from an eligible running Preview. When several accessible
154
- tasks share a code, or several repositories have eligible Previews, it presents
153
+ Session, or starts one from a linked repository. When several accessible tasks
154
+ share a code, or a project has several linked repositories, it presents
155
155
  a numbered selector. It restores the recent conversation for the session branch
156
156
  and attaches to an already-running agent turn instead of submitting a duplicate.
157
+ Use it like a normal coding-agent conversation: ask questions, inspect the
158
+ workspace, or request changes. Conversational and read-only turns do not create
159
+ empty commits. When a turn changes code, the server commits any remaining edits
160
+ and pushes the resumable Dev Session branch automatically.
157
161
 
158
162
  `xevy dev` is a remote client. It does **not** install or run local Pi, clone the
159
163
  repository, open a shell or PTY, use SSH, or invoke Docker. Ctrl+C, terminal EOF,
@@ -166,7 +170,7 @@ Available commands while attached:
166
170
  /status Refresh the lifecycle status and URL
167
171
  /logs Show the latest session logs
168
172
  /open Request a fresh one-use browser link and open it when supported
169
- /finish Merge into the task branch, queue Preview redeploy, and stop
173
+ /finish Merge into the task branch and stop
170
174
  /stop Stop without merging (the pushed session branch remains preserved)
171
175
  /detach Disconnect this terminal without stopping anything
172
176
  /help Show the command list
@@ -80,17 +80,17 @@ export function resolveDevConnection({
80
80
  return { base, token };
81
81
  }
82
82
 
83
- export function redactSensitive(value, secrets = []) {
83
+ export function redactSensitive(value, secrets = [], maxLength = 2_000) {
84
84
  let text = String(value ?? "");
85
85
  for (const secret of secrets) {
86
86
  if (!secret) continue;
87
87
  text = text.split(String(secret)).join("[redacted]");
88
88
  }
89
- return text
89
+ text = text
90
90
  .replace(/xevy_pk_[A-Za-z0-9._~-]+/g, "xevy_pk_[redacted]")
91
91
  .replace(/(bearer\s+)[A-Za-z0-9._~+\/-]+/gi, "$1[redacted]")
92
- .replace(/([?&](?:access_token|token|ticket|capability|launch_ticket)=)[^&#\s]+/gi, "$1[redacted]")
93
- .slice(0, 2_000);
92
+ .replace(/([?&](?:access_token|token|ticket|capability|launch_ticket)=)[^&#\s]+/gi, "$1[redacted]");
93
+ return maxLength == null ? text : text.slice(0, maxLength);
94
94
  }
95
95
 
96
96
  export function createSseDecoder(onEvent) {
@@ -296,7 +296,14 @@ function messageText(message) {
296
296
  return typeof message?.content === "string" ? message.content.trim() : "";
297
297
  }
298
298
 
299
- function renderPersistedMessage(message, state, writeLine) {
299
+ function renderChatBlock(role, text, writeLine) {
300
+ writeLine("");
301
+ writeLine(role === "user" ? "you" : "xevy");
302
+ writeLine(text);
303
+ writeLine("");
304
+ }
305
+
306
+ function renderPersistedMessage(message, state, writeLine, { showUser = true } = {}) {
300
307
  if (!message || (message.id && state.messageIds.has(message.id))) return;
301
308
  if (message.id) state.messageIds.add(message.id);
302
309
  const text = messageText(message);
@@ -305,72 +312,53 @@ function renderPersistedMessage(message, state, writeLine) {
305
312
  state.currentExecutionAssistantSeen = true;
306
313
  state.pendingAssistantText = "";
307
314
  }
308
- if (message.role === "tool_call" || message.role === "tool_result") {
309
- const key = `${message.role}:${message.toolName || "tool"}`;
310
- const remaining = state.liveToolMessageBudget.get(key) || 0;
311
- if (remaining > 0) {
312
- if (remaining === 1) state.liveToolMessageBudget.delete(key);
313
- else state.liveToolMessageBudget.set(key, remaining - 1);
314
- return;
315
- }
316
- }
317
- if (message.role === "user") writeLine(`you> ${text}`);
318
- else if (message.role === "assistant") writeLine(`xevy> ${text}`);
319
- else if (message.role === "thinking") writeLine(`thinking> ${text}`);
320
- else if (message.role === "tool_call") {
321
- writeLine(`tool> ${message.toolName || "tool"}${text ? ` — ${text}` : ""}`);
322
- } else if (message.role === "tool_result") {
323
- writeLine(`tool result> ${message.toolName || "tool"}${text ? ` — ${text}` : ""}`);
324
- } else if (message.role === "system" && text) writeLine(`system> ${text}`);
315
+ if (message.role === "user" && showUser) renderChatBlock("user", text, writeLine);
316
+ else if (message.role === "assistant") renderChatBlock("assistant", text, writeLine);
325
317
  }
326
318
 
327
319
  function renderStreamEvent(eventName, payload, state, writeLine, secrets) {
328
320
  const event = payload && typeof payload === "object" ? payload : {};
329
321
  const type = event.type || eventName;
330
322
  if (type === "message" && event.message) {
331
- renderPersistedMessage(event.message, state, writeLine);
323
+ renderPersistedMessage(event.message, state, writeLine, { showUser: false });
332
324
  return;
333
325
  }
334
326
  // Persisted message events are the authoritative text. Ignoring deltas avoids
335
327
  // printing the same assistant answer again during post-stream reconciliation.
336
328
  if (type === "text_delta") {
337
- if (typeof event.text === "string") state.pendingAssistantText += event.text;
329
+ // Only final-answer deltas are eligible for the last-resort fallback. Pi's
330
+ // reasoning/thinking stream must never be rendered as user-facing chat.
331
+ if (event.kind === "assistant" && typeof event.text === "string") {
332
+ state.pendingAssistantText += event.text;
333
+ }
338
334
  return;
339
335
  }
340
336
  if (type === "usage" || type === "heartbeat" || type === "end") return;
341
337
  if (type === "tool_start") {
342
- const streamKey = `tool_start:${event.toolName || "tool"}:${event.summary || ""}`;
343
- if (state.lastToolStreamKey === streamKey) return;
344
- state.lastToolStreamKey = streamKey;
345
- const messageKey = `tool_call:${event.toolName || "tool"}`;
346
- state.liveToolMessageBudget.set(messageKey, (state.liveToolMessageBudget.get(messageKey) || 0) + 1);
347
- writeLine(`tool> ${event.toolName || "tool"}${event.summary ? ` — ${redactSensitive(event.summary, secrets)}` : ""}`);
338
+ const streamKey = `tool_start:${event.toolCallId || event.id || ""}:${event.toolName || "tool"}:${event.summary || ""}`;
339
+ if (state.toolStreamKeys.has(streamKey)) return;
340
+ state.toolStreamKeys.add(streamKey);
341
+ writeLine(` ↳ ${event.toolName || "tool"}${event.summary ? ` · ${redactSensitive(event.summary, secrets)}` : ""}`);
348
342
  return;
349
343
  }
350
344
  if (type === "tool_end") {
351
- const streamKey = `tool_end:${event.toolName || "tool"}:${event.summary || ""}:${event.ok !== false}`;
352
- if (state.lastToolStreamKey === streamKey) return;
353
- state.lastToolStreamKey = streamKey;
354
- const messageKey = `tool_result:${event.toolName || "tool"}`;
355
- state.liveToolMessageBudget.set(messageKey, (state.liveToolMessageBudget.get(messageKey) || 0) + 1);
356
- writeLine(`tool ${event.ok === false ? "failed" : "done"}> ${event.toolName || "tool"}${event.summary ? ` — ${redactSensitive(event.summary, secrets)}` : ""}`);
345
+ if (event.ok !== false) return;
346
+ const streamKey = `tool_end:${event.toolCallId || event.id || ""}:${event.toolName || "tool"}:${event.summary || ""}`;
347
+ if (state.toolStreamKeys.has(streamKey)) return;
348
+ state.toolStreamKeys.add(streamKey);
349
+ writeLine(` × ${event.toolName || "tool"} failed${event.summary ? ` · ${redactSensitive(event.summary, secrets)}` : ""}`);
357
350
  return;
358
351
  }
359
352
  if (type === "status" || eventName === "snapshot") {
360
353
  const status = event.status;
361
354
  if (status && status !== state.lastExecutionStatus) {
362
355
  state.lastExecutionStatus = status;
363
- writeLine(`execution> ${status}${event.errorMessage ? ` — ${redactSensitive(event.errorMessage, secrets)}` : ""}`);
356
+ if (status === "running") writeLine("Working…");
364
357
  }
365
358
  return;
366
359
  }
367
- if (type === "chunk" && typeof event.text === "string") {
368
- const safeLines = event.text
369
- .split(/\r?\n/)
370
- .map((line) => line.trim())
371
- .filter((line) => line.startsWith("[server]") || line.startsWith("[toolbox]"));
372
- for (const line of safeLines) writeLine(redactSensitive(line, secrets));
373
- }
360
+ // Raw server/toolbox chunks are operational logs, not chat. They remain
361
+ // available through /logs instead of interrupting the assistant response.
374
362
  }
375
363
 
376
364
  async function consumeExecutionStream({ api, taskId, executionId, state, writeLine, secrets, signal }) {
@@ -419,7 +407,7 @@ async function reconcileExecution({ api, taskId, executionId, state, writeLine }
419
407
  api.request(`/api/tasks/${encodeURIComponent(taskId)}/ai/executions/${encodeURIComponent(executionId)}/messages`),
420
408
  ]);
421
409
  for (const message of messageResult?.messages || []) {
422
- renderPersistedMessage(message, state, writeLine);
410
+ renderPersistedMessage(message, state, writeLine, { showUser: false });
423
411
  }
424
412
  return { execution, messageCount: (messageResult?.messages || []).length };
425
413
  }
@@ -436,8 +424,8 @@ async function followExecution({
436
424
  }) {
437
425
  state.pendingAssistantText = "";
438
426
  state.currentExecutionAssistantSeen = false;
439
- state.liveToolMessageBudget.clear();
440
- state.lastToolStreamKey = null;
427
+ state.lastExecutionStatus = null;
428
+ state.toolStreamKeys.clear();
441
429
  let reconnects = 0;
442
430
  while (true) {
443
431
  let streamError = null;
@@ -476,7 +464,7 @@ async function followExecution({
476
464
  }
477
465
  }
478
466
  if (!state.currentExecutionAssistantSeen && state.pendingAssistantText.trim()) {
479
- writeLine(`xevy> ${state.pendingAssistantText.trim()}`);
467
+ renderChatBlock("assistant", state.pendingAssistantText.trim(), writeLine);
480
468
  state.pendingAssistantText = "";
481
469
  state.currentExecutionAssistantSeen = true;
482
470
  }
@@ -495,7 +483,7 @@ async function showHistory({ api, taskId, branch, state, writeLine }) {
495
483
  const result = await api.request(`/api/tasks/${encodeURIComponent(taskId)}/ai/executions`);
496
484
  const executions = sessionExecutions(result?.executions || [], branch).slice(0, HISTORY_LIMIT).reverse();
497
485
  if (executions.length === 0) return result?.executions || [];
498
- writeLine("\nRecent Dev Session conversation:");
486
+ writeLine("\nRecent conversation");
499
487
  for (const execution of executions) {
500
488
  const messages = await api.request(
501
489
  `/api/tasks/${encodeURIComponent(taskId)}/ai/executions/${encodeURIComponent(execution.id)}/messages`,
@@ -528,7 +516,7 @@ async function waitForReady({ api, sessionPath, initialSession, writeLine, sleep
528
516
  const deadline = Date.now() + SESSION_START_TIMEOUT_MS;
529
517
  while (!SESSION_READY_STATUSES.has(session.status)) {
530
518
  if (session.status !== lastStatus) {
531
- writeLine(`session> ${session.status}`);
519
+ writeLine(`Preparing workspace · ${session.status}`);
532
520
  lastStatus = session.status;
533
521
  }
534
522
  if (SESSION_TERMINAL_STATUSES.has(session.status)) {
@@ -545,19 +533,19 @@ async function waitForReady({ api, sessionPath, initialSession, writeLine, sleep
545
533
  if (!result?.session) throw new Error("The Dev Session disappeared while starting.");
546
534
  session = result.session;
547
535
  }
548
- if (session.status !== lastStatus) writeLine(`session> ${session.status}`);
536
+ if (session.status !== lastStatus) writeLine("Dev Session ready");
549
537
  return session;
550
538
  }
551
539
 
552
540
  function sessionSummary(task, session, writeLine) {
553
541
  const url = canonicalSessionUrl(session.hostname);
554
- writeLine("\nDev Session attached");
555
- writeLine(`Task: ${formatTask(task)}`);
556
- writeLine(`Branch: ${session.config?.branch || "unknown"}`);
557
- writeLine(`Status: ${session.status}`);
558
- writeLine(`URL: ${url || "not available yet"}`);
559
- writeLine(`Expires: ${session.expiresAt || "server-managed"}`);
560
- writeLine("Use /open for a fresh browser link, or /help for commands.\n");
542
+ writeLine("\nDev Session");
543
+ writeLine(` Task ${formatTask(task)}`);
544
+ writeLine(` Site ${url || "not available yet"}`);
545
+ writeLine(` Branch ${session.config?.branch || "unknown"}`);
546
+ writeLine(` Status ${session.status}`);
547
+ writeLine(` Expires ${session.expiresAt || "server-managed"}`);
548
+ writeLine("\n/open · /status · /logs · /finish · /stop · /detach · /help\n");
561
549
  }
562
550
 
563
551
  function commandHelp(writeLine) {
@@ -565,7 +553,7 @@ function commandHelp(writeLine) {
565
553
  writeLine(" /status Refresh session status");
566
554
  writeLine(" /logs Show the latest Dev Session logs");
567
555
  writeLine(" /open Open a fresh one-use Dev Session URL");
568
- writeLine(" /finish Merge into the task branch, redeploy Preview, and stop");
556
+ writeLine(" /finish Merge into the task branch and stop");
569
557
  writeLine(" /stop Stop the Dev Session without finishing");
570
558
  writeLine(" /detach Leave it running and exit this CLI");
571
559
  writeLine(" /help Show these commands");
@@ -573,7 +561,7 @@ function commandHelp(writeLine) {
573
561
 
574
562
  async function confirmAction({ interactive, ask, action }) {
575
563
  if (!interactive) throw new Error(`/${action} requires an interactive confirmation.`);
576
- const answer = (await ask(`${action === "finish" ? "Finish, merge, redeploy Preview, and stop" : "Stop this Dev Session"}? [y/N]: `)).toLowerCase();
564
+ const answer = (await ask(`${action === "finish" ? "Finish, merge into the task branch, and stop" : "Stop this Dev Session"}? [y/N]: `)).toLowerCase();
577
565
  return answer === "y" || answer === "yes";
578
566
  }
579
567
 
@@ -622,7 +610,7 @@ export async function runDevSession(options) {
622
610
  const spawnImpl = options.spawnImpl || spawn;
623
611
  const sleep = options.sleep || defaultSleep;
624
612
  const secrets = [token];
625
- const writeLine = (value = "") => output.write(`${redactSensitive(value, secrets)}\n`);
613
+ const writeLine = (value = "") => output.write(`${redactSensitive(value, secrets, null)}\n`);
626
614
  const writeLaunchLine = (value) => output.write(`${String(value)}\n`);
627
615
 
628
616
  const controllers = new Set();
@@ -705,14 +693,14 @@ export async function runDevSession(options) {
705
693
  session = current?.session || null;
706
694
  if (!session) {
707
695
  const repositoryResult = await api.request(`${sessionPath}/repositories`, { signal: detachController.signal });
708
- const repositories = (repositoryResult?.repos || []).filter((repository) => repository.eligibleForDevSession);
696
+ const repositories = repositoryResult?.repos || [];
709
697
  if (repositories.length === 0) {
710
- throw new Error("No linked repository has a running Preview. Deploy Preview first, then rerun `xevy dev`.");
698
+ throw new Error("No linked repository is configured for this project.");
711
699
  }
712
700
  const repository = await selectOne({
713
701
  items: repositories,
714
702
  label: "repositories",
715
- describe: (item) => `${item.displayName || item.role}${item.previewStatus ? ` · Preview ${item.previewStatus}` : ""}`,
703
+ describe: (item) => `${item.displayName || item.role}${item.defaultBranch ? ` · ${item.defaultBranch}` : ""}`,
716
704
  interactive,
717
705
  ask,
718
706
  writeLine,
@@ -764,13 +752,12 @@ export async function runDevSession(options) {
764
752
  lastExecutionStatus: null,
765
753
  pendingAssistantText: "",
766
754
  currentExecutionAssistantSeen: false,
767
- liveToolMessageBudget: new Map(),
768
- lastToolStreamKey: null,
755
+ toolStreamKeys: new Set(),
769
756
  };
770
757
  const executions = await showHistory({ api, taskId: task.id, branch: session.config.branch, state: renderState, writeLine });
771
758
  const active = activeExecutionForSession(executions, session.config.branch);
772
759
  if (active) {
773
- writeLine(`\nReattaching to active agent turn ${active.id}…`);
760
+ writeLine("\nResuming the active agent turn…");
774
761
  const completed = await followExecution({
775
762
  api,
776
763
  taskId: task.id,
@@ -791,7 +778,7 @@ export async function runDevSession(options) {
791
778
  }
792
779
 
793
780
  while (!detached) {
794
- const prompt = await ask("dev> ");
781
+ const prompt = await ask("you › ");
795
782
  if (detached) break;
796
783
  if (!prompt) continue;
797
784
  if (prompt === "/help") {
@@ -853,7 +840,7 @@ export async function runDevSession(options) {
853
840
  if (completed.status !== "succeeded") {
854
841
  throw new Error(completed.errorMessage || `Finish ${completed.status}.`);
855
842
  }
856
- writeLine("Finished: the Dev Session branch was merged into the task branch and Preview redeploy was queued.");
843
+ writeLine("Finished: the Dev Session branch was merged into the task branch and the workspace was stopped.");
857
844
  detached = true;
858
845
  break;
859
846
  }
@@ -897,7 +884,7 @@ export async function runDevSession(options) {
897
884
  sleep,
898
885
  });
899
886
  if (completed.status === "succeeded") {
900
- writeLine(`Saved to Dev Session branch ${session.config.branch}.`);
887
+ if (!renderState.currentExecutionAssistantSeen) writeLine("Turn complete.");
901
888
  } else if (completed.status === "cancelled") {
902
889
  writeLine("Agent turn cancelled; the Dev Session remains attached.");
903
890
  } else {
package/bin/xevy.mjs CHANGED
@@ -133,7 +133,7 @@ function devUsage() {
133
133
  xevy dev <task-id-or-code> [--base <url>]
134
134
 
135
135
  Connects this terminal to the task's remote Dev Session. The command attaches
136
- to an existing session or starts one from an eligible Preview repository. It
136
+ to an existing session or starts one from a linked repository. It
137
137
  does not run a local coding agent, shell, Docker container, or repository clone.
138
138
 
139
139
  Inside the session:
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@xevy/cli",
3
- "version": "0.1.12",
3
+ "version": "0.1.14",
4
4
  "description": "Xevy CLI — connect to remote Dev Sessions, configure credentials, pi, coding-agent skills, and MCP, and keep integrations current.",
5
5
  "type": "module",
6
6
  "keywords": [