@voltade/volty 0.1.13 → 0.1.15

package/dist/volty.js

@@ -1,21 +1,10 @@
 #!/usr/bin/env node
 
 // bin/volty.ts
-import { existsSync as existsSync3, mkdirSync as mkdirSync4, readFileSync as readFileSync5, writeFileSync as writeFileSync4 } from "node:fs";
+import { existsSync as existsSync3, mkdirSync as mkdirSync4, readFileSync as readFileSync5, writeFileSync as writeFileSync5 } from "node:fs";
 import { homedir as homedir3 } from "node:os";
 import { join as join4 } from "node:path";
 
-// ../shared/ops/retired-prefix.ts
-function retiredPrefix(retired, argv) {
-  for (let n = Math.min(argv.length, 4);n >= 1; n--) {
-    const name = argv.slice(0, n).join(" ");
-    const replacement = retired[name];
-    if (replacement !== undefined)
-      return { name, replacement };
-  }
-  return null;
-}
-
 // src/api.ts
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { tmpdir } from "node:os";
@@ -58,7 +47,7 @@ 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.renamed)
+      if (Date.now() - cached.at < CATALOG_TTL_MS && cached.renamed && cached.inApp)
         return cached;
     } catch {}
   }
@@ -69,11 +58,12 @@ async function fetchCatalog(ctx, env, useCache = true) {
   const ops = res.body.catalog;
   const retired = res.body.retired ?? {};
   const renamed = res.body.renamed ?? {};
+  const inApp = res.body.inApp ?? {};
   try {
     mkdirSync(tmpdir(), { recursive: true });
-    writeFileSync(path, JSON.stringify({ at: Date.now(), ops, retired, renamed }));
+    writeFileSync(path, JSON.stringify({ at: Date.now(), ops, retired, renamed, inApp }));
   } catch {}
-  return { ops, retired, renamed };
+  return { ops, retired, renamed, inApp };
 }
 async function fetchOrgs(ctx, env, useCache = true) {
   const path = join(tmpdir(), `volty-orgs-${env}.json`);
@@ -275,7 +265,7 @@ async function logout(config, env) {
 }
 
 // src/dispatch.ts
-import { readFileSync as readFileSync3 } from "node:fs";
+import { readFileSync as readFileSync3, writeFileSync as writeFileSync3 } from "node:fs";
 
 // ../shared/ops/flag-parse.ts
 function acceptsNull(prop) {
@@ -375,9 +365,29 @@ function parseFlagTokens(props, rest, UsageError) {
   return { input, json };
 }
 
+// ../shared/ops/retired-prefix.ts
+function retiredPrefix(retired, argv) {
+  for (let n = Math.min(argv.length, 4);n >= 1; n--) {
+    const name = argv.slice(0, n).join(" ");
+    const replacement = retired[name];
+    if (replacement !== undefined)
+      return { name, replacement };
+  }
+  return null;
+}
+
 // src/dispatch.ts
 class CliUsageError extends Error {
 }
+function missMessage(catalog, argv) {
+  const inApp = retiredPrefix(catalog.inApp, argv);
+  if (inApp)
+    return `\`${inApp.name}\` is not run from here. ${inApp.replacement}`;
+  const retired = retiredPrefix(catalog.retired, argv);
+  if (retired)
+    return `\`${retired.name}\` is retired: ${retired.replacement}`;
+  return `unknown operation '${argv.join(" ")}' — run \`volty help\``;
+}
 function resolveOp(catalog, argv) {
   const byName = new Map(catalog.ops.map((c) => [c.name, c]));
   for (let n = Math.min(argv.length, 4);n >= 1; n--) {
@@ -413,6 +423,22 @@ async function runOp(ctx, op, input) {
   const res = await apiFetch(ctx, pathForOp(op.name), { method: "POST", body: input });
   return { status: res.status, ok: res.ok, body: res.body };
 }
+function saveOutFile(body, path) {
+  const structured = body.structuredContent;
+  if (typeof structured?.fileBase64 !== "string") {
+    throw new CliUsageError("--out: this operation returns no file, so there is nothing to write");
+  }
+  const bytes = Buffer.from(structured.fileBase64, "base64");
+  try {
+    writeFileSync3(path, bytes);
+  } catch (err) {
+    throw new CliUsageError(`--out: cannot write ${path} (${err.code ?? "error"})`);
+  }
+  return {
+    body: { ...body, structuredContent: { ...structured, fileBase64: path } },
+    line: `Wrote ${path} (${bytes.byteLength} bytes)`
+  };
+}
 
 // src/format.ts
 function flagType(prop) {
@@ -540,7 +566,7 @@ function decideProposal(ctx, proposalId, decision, reason) {
 }
 
 // src/update.ts
-import { mkdirSync as mkdirSync3, readFileSync as readFileSync4, writeFileSync as writeFileSync3 } from "node:fs";
+import { mkdirSync as mkdirSync3, readFileSync as readFileSync4, writeFileSync as writeFileSync4 } 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");
@@ -574,7 +600,7 @@ function readCache() {
 function writeCache(cache) {
   try {
     mkdirSync3(dirname2(CACHE_PATH), { recursive: true });
-    writeFileSync3(CACHE_PATH, `${JSON.stringify(cache)}
+    writeFileSync4(CACHE_PATH, `${JSON.stringify(cache)}
 `);
   } catch {}
 }
@@ -813,7 +839,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"), readFileSync5(source, "utf8"));
+  writeFileSync5(join4(destDir, "SKILL.md"), readFileSync5(source, "utf8"));
   process.stdout.write(`Installed the volty-cli-ops skill → ${join4(destDir, "SKILL.md")}
 `);
 }
@@ -870,10 +896,7 @@ async function main() {
   }
   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\``);
+    fail(missMessage(catalog, argv));
   }
   if (resolved.renamedFrom)
     process.stderr.write(`${resolved.renamedFrom} is now ${resolved.op.name}
@@ -883,9 +906,12 @@ async function main() {
 `);
     return;
   }
+  const out = takeValue(resolved.rest, "--out");
+  if (out.rest.length !== resolved.rest.length && !out.value)
+    fail("--out needs a path, as in --out=./logo.png");
   let parsed;
   try {
-    parsed = parseFlags(resolved.op, resolved.rest);
+    parsed = parseFlags(resolved.op, out.rest);
   } catch (err) {
     if (err instanceof CliUsageError)
       fail(err.message);
@@ -894,7 +920,23 @@ async function main() {
   const result = await runOp(ctx, resolved.op, parsed.input);
   if (!result.ok)
     failResult(resolved.op.name, result.body, result.status, parsed.json);
-  process.stdout.write(`${renderResult(result.body, parsed.json)}
+  if (out.value === undefined) {
+    process.stdout.write(`${renderResult(result.body, parsed.json)}
+`);
+    return;
+  }
+  let saved;
+  try {
+    saved = saveOutFile(result.body, out.value);
+  } catch (err) {
+    if (err instanceof CliUsageError)
+      fail(err.message);
+    throw err;
+  }
+  process.stdout.write(`${renderResult(saved.body, parsed.json)}
+`);
+  if (!parsed.json)
+    process.stdout.write(`${saved.line}
 `);
 }
 main().catch((err) => fail(err instanceof Error ? err.message : String(err)));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voltade/volty",
-  "version": "0.1.13",
+  "version": "0.1.15",
   "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",