@vatio-ai/cli 0.47.1 → 0.48.1

package/README.md

@@ -56,7 +56,7 @@ login | logout              Authorize this machine in a browser, or forget it
 doctor                      Node, config, workspace and token status
 
 push [--env NAME]           Validate the workspace, then update a preview
-publish [--env NAME]        Promote a preview to live
+publish [--env NAME]        Promote the latest push to live, or the named preview
 diff [--env NAME]           What this directory would change
 status                      Preview and live deployment state
 rollback                    Restore the previous live deployment
@@ -64,6 +64,7 @@ tools check                 Validate the workspace against Vatio's contracts
 
 chat "message" [--env NAME] Talk to your own agent; the token is the identity
 chat transcript|debug|reset|destroy
+chat show CHAT_ID [--json]  Any chat in the workspace, with its deployment and tool calls
 
 kb list|show|create|rm       Knowledge bases
 kb write|cat|rm-entry        Entries, from a file or stdin

package/bin/vatio.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-// The Vatio CLI, as an npm package: `npx vatio push`.
+// The Vatio CLI, as an npm package: `npx @vatio-ai/cli push`.
 //
 // Same platform, same API, same ~/.vatio/config.json as the Ruby CLI that
 // `curl … /install.sh | bash` puts on a machine. Either can drive a workspace,
@@ -31,8 +31,8 @@ const RETIRED = {
   pull: "was removed: a deployed manifest only ever comes from a push, so it could never\n" +
     "hand back anything your repository did not already have. Use `vatio diff --env live`,\n" +
     "or read the manifest at GET /api/v1/:slug/deploy/manifest.",
-  update: "is npm's job now: `npx vatio@latest` always runs the current release, and\n" +
-    "`npm install -g vatio@latest` updates a global install."
+  update: "is npm's job now: `npx @vatio-ai/cli@latest` always runs the current release, and\n" +
+    "`npm install -g @vatio-ai/cli@latest` updates a global install."
 };
 
 async function main(argv) {

package/lib/commands/chat.mjs

@@ -10,11 +10,11 @@ import { existsSync, readFileSync, rmSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 
 import { ApiClient } from "../api-client.mjs";
-import { fail, sleep, takeEnv, takeValue } from "../support.mjs";
+import { fail, sleep, takeEnv, takeFlag, takeValue } from "../support.mjs";
 
 export const STATE_FILE = ".vatio-chat.json";
 
-const SUBCOMMANDS = new Set(["transcript", "debug", "reset", "destroy", "delete", "help"]);
+const SUBCOMMANDS = new Set(["show", "transcript", "debug", "reset", "destroy", "delete", "help"]);
 const REMOVED_FLAGS = ["--channel", "--from", "--as", "--sandbox-url"];
 
 export async function chat(config, args) {
@@ -30,14 +30,17 @@ export async function chat(config, args) {
 
   const environment = takeEnv(args, { fallback: "preview" });
   const timeout = Number(takeValue(args, "--timeout") ?? 120);
-  const last = Number(takeValue(args, "--last") ?? 10);
+  const lastValue = takeValue(args, "--last");
+  const last = Number(lastValue ?? 10);
+  const json = takeFlag(args, "--json");
   const apiUrl = takeValue(args, "--api-url");
   const token = takeValue(args, "--token");
 
-  const options = { environment, timeout, last, apiUrl, token };
+  const options = { environment, timeout, last, lastGiven: lastValue != null, json, apiUrl, token };
   const sub = SUBCOMMANDS.has(args[0]) ? args.shift() : null;
 
   if (sub === "help") return console.log(chatHelp());
+  if (sub === "show") return await showChat(config, options, args);
   if (sub === "transcript") return await transcript(config, options);
   if (sub === "debug") return await debugChat(config, options);
   if (sub === "reset") return await resetChat(config, options);
@@ -54,6 +57,7 @@ function chatHelp() {
   vatio chat "message" [--env NAME] [--timeout N]
   vatio chat transcript [--last N]
   vatio chat debug [--last N]
+  vatio chat show CHAT_ID [--last N] [--json]
   vatio chat reset
   vatio chat destroy CHAT_ID
 
@@ -61,6 +65,10 @@ function chatHelp() {
 name like pr-42. A chat against live is a real conversation and shows up in
 your inbox.
 
+\`show\` reads any chat in the workspace by id -- one a visitor had on the web,
+WhatsApp or Instagram, not only yours -- with the environment and deployment
+that answered it, and every tool call.
+
 The open chat per deployment is remembered in ${STATE_FILE}, so a second
 \`vatio chat\` continues the first. \`reset\` starts over as a visitor the
 workspace has never met.`;
@@ -200,6 +208,66 @@ async function debugChat(config, options) {
   }
 }
 
+// Every message, not the first page: a chat worth reading by id is usually one
+// that went wrong somewhere in the middle.
+async function allMessages(api, chatId) {
+  const messages = [];
+  let after = null;
+  for (;;) {
+    const payload = await api.chatMessages({ chatId, after, limit: 200 });
+    const page = Array.isArray(payload.data) ? payload.data : [];
+    messages.push(...page);
+    if (page.length < 200) return messages;
+    after = page[page.length - 1].id;
+  }
+}
+
+async function showChat(config, options, args) {
+  const chatId = args.shift();
+  if (!chatId || !/^\d+$/.test(chatId)) fail("Usage: vatio chat show CHAT_ID [--last N] [--json]");
+
+  const api = client(config, options);
+  const chat = await api.showChat({ chatId });
+  let messages = await allMessages(api, chatId);
+  if (options.lastGiven) messages = messages.slice(-options.last);
+
+  if (options.json) return console.log(JSON.stringify({ chat, messages }, null, 2));
+
+  const header = [
+    `Chat ${chat.chat_id}`,
+    chat.channel,
+    chat.environment,
+    chat.deployment_id && `deployment #${chat.deployment_id}`,
+    `agent ${chat.agent_slug}`
+  ];
+  console.log(header.filter(Boolean).join(" · "));
+  console.log(`Started ${chat.created_at}, last activity ${chat.updated_at}`);
+  if (chat.identity) console.log(`Identity: ${JSON.stringify(chat.identity)}`);
+  console.log("");
+
+  for (const message of messages) {
+    const content = String(message.content ?? "").trim();
+    if (message.role === "system") {
+      console.log(`[system] ${content.length} characters of prompt (--json prints it)`);
+      continue;
+    }
+    if (message.role === "tool") {
+      console.log(`  [tool result] ${truncate(content, 400)}`);
+      continue;
+    }
+    const flags = message.discarded ? " (discarded)" : "";
+    if (content !== "" || flags) console.log(`[${message.role}]${flags} ${content}`);
+    for (const call of Array.isArray(message.tool_calls) ? message.tool_calls : []) {
+      console.log(`  -> ${call.name}(${truncate(JSON.stringify(call.arguments ?? {}), 400)})`);
+    }
+  }
+  if (messages.length === 0) console.log("(no messages)");
+}
+
+function truncate(text, max) {
+  return text.length > max ? `${text.slice(0, max)}…` : text;
+}
+
 async function resetChat(config, options) {
   const apiUrl = config.resolveApiUrl({ explicit: options.apiUrl });
   const payload = await openChat(config, options, {

package/lib/commands/deploy.mjs

@@ -145,14 +145,17 @@ export async function push(config, args) {
 
 export async function publish(config, args) {
   // Here `--env` names the preview being promoted, not a destination: the
-  // destination of a publish is always live.
+  // destination of a publish is always live. Without it the platform promotes
+  // the most recent push, whichever preview it landed on.
   const environment = takeEnv(args, { fallback: null });
   const workspace = config.resolveWorkspaceRequired();
   const payload = await deployClient(config, workspace).publish({
     createdBy: process.env.USER ?? null,
     environment
   });
-  console.log(`Published live deployment #${payload.deployment_id} (git_sha=${JSON.stringify(payload.git_sha ?? null)})`);
+  const from = asArray(payload.published_from);
+  const source = from.length > 0 ? ` from ${from.join(", ")}` : "";
+  console.log(`Published live deployment #${payload.deployment_id}${source} (git_sha=${JSON.stringify(payload.git_sha ?? null)})`);
 }
 
 export async function rollback(config) {

package/lib/commands/mcp.mjs

@@ -67,7 +67,8 @@ const COMMANDS = {
   publish: {
     usage: "[--env NAME]",
     summary:
-      "Promote a preview to live, which is what customers see. Ask the developer first: this is " +
+      "Promote the latest push to live (or the preview `--env` names), which is what customers " +
+      "see. Ask the developer first: this is " +
       "the one step that changes what real visitors get.",
     annotations: { readOnlyHint: false, destructiveHint: true }
   },
@@ -77,11 +78,12 @@ const COMMANDS = {
     annotations: { readOnlyHint: false, destructiveHint: true }
   },
   chat: {
-    usage: '"message" | transcript | debug | reset [--env NAME]',
+    usage: '"message" | transcript | debug | reset [--env NAME] | show CHAT_ID [--json]',
     summary:
       "Talk to the deployed agent as the developer holding the token, and read the transcript. " +
       "`debug` shows the developer view, including tool calls. `--env live` is a real conversation " +
-      "that appears in the inbox.",
+      "that appears in the inbox. `show CHAT_ID` reads any chat in the workspace — a visitor's on " +
+      "the web or WhatsApp too — with the environment and deployment that answered it.",
     annotations: { readOnlyHint: false }
   },
   secrets: {

package/lib/config.mjs

@@ -2,7 +2,7 @@
 // ~/.vatio/config.json, or $VATIO_HOME/config.json.
 //
 // Deliberately the same file and the same keys. Someone who already ran
-// `vatio login` through the curl installer can run `npx vatio push` without
+// `vatio login` through the curl installer can run `npx @vatio-ai/cli push` without
 // logging in again, and can go back, because neither client owns the
 // credential -- the developer's home does.
 //

package/lib/help.mjs

@@ -24,7 +24,8 @@ flag, the directory decides.
 
   Deploy:
     push [--env NAME]          Validate the workspace, then update a preview
-    publish [--env NAME]       Promote a preview to live. --env names which one
+    publish [--env NAME]       Promote the latest push to live. --env promotes
+                               a specific preview instead
     rollback                   Restore the previous live deployment
     status                     Preview and live deployment state
     diff [--env NAME]          What this directory would change (default: preview)
@@ -35,6 +36,8 @@ flag, the directory decides.
   Talk to your agent (as yourself — the token is the identity):
     chat "message" [--env NAME]        preview by default; --env live is real
     chat transcript|debug|reset [--last N]
+    chat show CHAT_ID [--json] Any chat in the workspace (web, WhatsApp, ...) with
+                               its channel, environment, deployment and tool calls
     chat destroy CHAT_ID
 
   Knowledge:

package/lib/version.mjs

@@ -1,4 +1,4 @@
-// Read from package.json rather than written twice: `npx vatio` resolves a
+// Read from package.json rather than written twice: `npx @vatio-ai/cli` resolves a
 // version from the registry, and a constant in here could disagree with the
 // one the developer actually downloaded.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vatio-ai/cli",
-  "version": "0.47.1",
+  "version": "0.48.1",
   "description": "Vatio CLI — deploy and manage Vatio agent workspaces",
   "keywords": [
     "vatio",