@voltade/volty 0.1.9 → 0.1.11

package/README.md

@@ -46,7 +46,7 @@ Open Claude Code anywhere and ask in plain language. The skill you installed in
 - *"Why didn't the agent learn anything from that conversation?"*
 - *"Clean up the test conversations on prod."*
 
-Claude knows the safety rules: tests run against a sandboxed draft version of the agent with a synthetic contact, so nothing can ever be sent to a real contact, and Claude cleans up after itself when it's done.
+Claude knows the safety rules: tests run on your workspace's Sandbox from a synthetic contact, whose replies are recorded in the thread but never sent, so nothing can reach a real contact. Claude cleans up after itself when it's done, and anything left over is removed after 24 hours.
 
 ## Upgrading
 

package/dist/volty.js

@@ -58,8 +58,8 @@ async function fetchCatalog(ctx, env, useCache = true) {
   if (useCache && existsSync(path)) {
     try {
       const cached = JSON.parse(readFileSync(path, "utf8"));
-      if (Date.now() - cached.at < CATALOG_TTL_MS && cached.retired)
-        return { ops: cached.ops, retired: cached.retired };
+      if (Date.now() - cached.at < CATALOG_TTL_MS && cached.renamed)
+        return cached;
     } catch {}
   }
   const res = await apiFetch(ctx, "/api/v/_catalog");
@@ -68,11 +68,12 @@ async function fetchCatalog(ctx, env, useCache = true) {
   }
   const ops = res.body.catalog;
   const retired = res.body.retired ?? {};
+  const renamed = res.body.renamed ?? {};
   try {
     mkdirSync(tmpdir(), { recursive: true });
-    writeFileSync(path, JSON.stringify({ at: Date.now(), ops, retired }));
+    writeFileSync(path, JSON.stringify({ at: Date.now(), ops, retired, renamed }));
   } catch {}
-  return { ops, retired };
+  return { ops, retired, renamed };
 }
 async function fetchOrgs(ctx, env, useCache = true) {
   const path = join(tmpdir(), `volty-orgs-${env}.json`);
@@ -293,21 +294,21 @@ function coerce(flag, raw, prop0, UsageError) {
       return true;
     if (raw === "false")
       return false;
-    throw new UsageError(`--${flag} expects true|false`);
+    throw new UsageError(`--${flag} expects true|false`, flag);
   }
   if (raw === undefined)
-    throw new UsageError(`--${flag} requires a value`);
+    throw new UsageError(`--${flag} requires a value`, flag);
   if (prop.type === "number" || prop.type === "integer") {
     const n = Number(raw);
     if (Number.isNaN(n))
-      throw new UsageError(`--${flag} expects a number`);
+      throw new UsageError(`--${flag} expects a number`, flag);
     return n;
   }
   if (prop.type === "object") {
     try {
       return JSON.parse(raw);
     } catch {
-      throw new UsageError(`--${flag} expects JSON`);
+      throw new UsageError(`--${flag} expects JSON`, flag);
     }
   }
   return raw;
@@ -322,6 +323,16 @@ function jsonArrayValue(raw) {
     return null;
   }
 }
+function arrayItems(flag, raw, prop, UsageError) {
+  const spread = jsonArrayValue(raw);
+  if (spread)
+    return spread;
+  const items = prop.items ?? {};
+  if (items.entityId && raw?.includes(",")) {
+    return raw.split(",").map((id) => id.trim()).filter((id) => id !== "");
+  }
+  return [coerce(flag, raw, items, UsageError)];
+}
 function canonicalFlag(props, flag) {
   if (props[flag])
     return flag;
@@ -352,11 +363,7 @@ function parseFlagTokens(props, rest, UsageError) {
     }
     if (prop.type === "array") {
       const list = input[flag] ?? [];
-      const spread = jsonArrayValue(raw);
-      if (spread)
-        list.push(...spread);
-      else
-        list.push(coerce(flag, raw, prop.items ?? {}, UsageError));
+      list.push(...arrayItems(flag, raw, prop, UsageError));
       input[flag] = list;
     } else {
       input[flag] = coerce(flag, raw, prop, UsageError);
@@ -369,11 +376,12 @@ function parseFlagTokens(props, rest, UsageError) {
 class CliUsageError extends Error {
 }
 function resolveOp(catalog, argv) {
-  const byName = new Map(catalog.map((c) => [c.name, c]));
+  const byName = new Map(catalog.ops.map((c) => [c.name, c]));
   for (let n = Math.min(argv.length, 4);n >= 1; n--) {
-    const op = byName.get(argv.slice(0, n).join(" "));
+    const name = argv.slice(0, n).join(" ");
+    const op = byName.get(name) ?? byName.get(catalog.renamed[name] ?? "");
     if (op)
-      return { op, rest: argv.slice(n) };
+      return { op, rest: argv.slice(n), ...op.name !== name && { renamedFrom: name } };
   }
   return null;
 }
@@ -839,13 +847,16 @@ async function main() {
 `);
     return;
   }
-  const resolved = resolveOp(catalog.ops, argv);
+  const resolved = resolveOp(catalog, argv);
   if (!resolved) {
     const retired = retiredPrefix(catalog.retired, argv);
     if (retired)
       fail(`\`${retired.name}\` is retired: ${retired.replacement}`);
     fail(`unknown operation '${argv.join(" ")}' — run \`volty help\``);
   }
+  if (resolved.renamedFrom)
+    process.stderr.write(`${resolved.renamedFrom} is now ${resolved.op.name}
+`);
   if (resolved.rest.includes("--help")) {
     process.stdout.write(`${renderOpHelp(resolved.op)}
 `);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voltade/volty",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "description": "Remote CLI for the Volty platform — run operations, trigger real agent wakes, and inspect LLM I/O over an API key.",
   "license": "UNLICENSED",
   "type": "module",

package/skill/volty-cli-ops/SKILL.md

@@ -23,6 +23,6 @@ Use the lane the behaviour was reported on. On the contact lane Volty declines t
 ## On prod
 
 - Name the org on every command (`--env prod --org <id>`, or `VOLTY_ENV` and `VOLTY_ORG` in the process), and read the stderr line the CLI prints before each command to check it names the org you meant. Act only in the org the user named.
-- Test through the sandbox, where every reply stays a draft. A real conversation is never a test target.
+- Test through the Sandbox, where a reply to the synthetic contact is recorded as sent and never leaves. A real conversation is never a test target.
 - Run `volty debug sandbox-cleanup --all --env prod --org <id>` when you finish.
 - A `{pending:true}` result means the turn outran the wait, not that it failed: poll for it (`volty docs` names the command) instead of sending the message again.