@voltade/volty 0.1.10 → 0.1.12

package/dist/volty.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // bin/volty.ts
-import { existsSync as existsSync3, mkdirSync as mkdirSync4, readFileSync as readFileSync4, writeFileSync as writeFileSync4 } from "node:fs";
+import { existsSync as existsSync3, mkdirSync as mkdirSync4, readFileSync as readFileSync5, writeFileSync as writeFileSync4 } from "node:fs";
 import { homedir as homedir3 } from "node:os";
 import { join as join4 } from "node:path";
 
@@ -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`);
@@ -273,6 +274,9 @@ async function logout(config, env) {
   return `Logged out of '${env}' (key revoked).`;
 }
 
+// src/dispatch.ts
+import { readFileSync as readFileSync3 } from "node:fs";
+
 // ../shared/ops/flag-parse.ts
 function acceptsNull(prop) {
   if (prop.type === "null")
@@ -293,21 +297,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 +326,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 +366,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,16 +379,35 @@ 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;
 }
 function parseFlags(op, rest) {
-  return parseFlagTokens(op.input.properties ?? {}, rest, CliUsageError);
+  const props = op.input.properties ?? {};
+  const parsed = parseFlagTokens(props, rest, CliUsageError);
+  for (const [key, value] of Object.entries(parsed.input)) {
+    const prop = props[key];
+    if (typeof value === "string" && value.startsWith("@") && prop && isBase64(prop)) {
+      parsed.input[key] = readBase64File(key, value.slice(1));
+    }
+  }
+  return parsed;
+}
+function isBase64(prop) {
+  return [prop, ...prop.anyOf ?? []].some((branch) => branch.contentEncoding === "base64");
+}
+function readBase64File(flag, path) {
+  try {
+    return readFileSync3(path).toString("base64");
+  } catch (err) {
+    throw new CliUsageError(`--${flag}: cannot read ${path} (${err.code ?? "error"})`);
+  }
 }
 async function runOp(ctx, op, input) {
   const res = await apiFetch(ctx, pathForOp(op.name), { method: "POST", body: input });
@@ -511,7 +540,7 @@ function decideProposal(ctx, proposalId, decision, reason) {
 }
 
 // src/update.ts
-import { mkdirSync as mkdirSync3, readFileSync as readFileSync3, writeFileSync as writeFileSync3 } from "node:fs";
+import { mkdirSync as mkdirSync3, readFileSync as readFileSync4, writeFileSync as writeFileSync3 } from "node:fs";
 import { homedir as homedir2 } from "node:os";
 import { dirname as dirname2, join as join3 } from "node:path";
 var CACHE_PATH = join3(homedir2(), ".config", "volty", "update-check.json");
@@ -519,7 +548,7 @@ var CHECK_INTERVAL_MS = 24 * 60 * 60 * 1000;
 var REGISTRY_LATEST = "https://registry.npmjs.org/@voltade/volty/latest";
 function currentVersion() {
   try {
-    const pkg = JSON.parse(readFileSync3(join3(import.meta.dirname, "..", "package.json"), "utf8"));
+    const pkg = JSON.parse(readFileSync4(join3(import.meta.dirname, "..", "package.json"), "utf8"));
     return pkg.version ?? null;
   } catch {
     return null;
@@ -537,7 +566,7 @@ function cmpVersion(a, b) {
 }
 function readCache() {
   try {
-    return JSON.parse(readFileSync3(CACHE_PATH, "utf8"));
+    return JSON.parse(readFileSync4(CACHE_PATH, "utf8"));
   } catch {
     return null;
   }
@@ -784,7 +813,7 @@ function handleSkill(rest) {
     fail("bundled SKILL.md not found — reinstall the @voltade/volty package");
   const destDir = join4(homedir3(), ".claude", "skills", "volty-cli-ops");
   mkdirSync4(destDir, { recursive: true });
-  writeFileSync4(join4(destDir, "SKILL.md"), readFileSync4(source, "utf8"));
+  writeFileSync4(join4(destDir, "SKILL.md"), readFileSync5(source, "utf8"));
   process.stdout.write(`Installed the volty-cli-ops skill → ${join4(destDir, "SKILL.md")}
 `);
 }
@@ -839,13 +868,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.10",
+  "version": "0.1.12",
   "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",