@voltade/volty 0.1.12 → 0.1.14

package/dist/volty.js

@@ -1,7 +1,7 @@
 #!/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";
 
@@ -275,7 +275,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) {
@@ -413,6 +413,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 +556,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 +590,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 +829,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")}
 `);
 }
@@ -883,9 +899,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 +913,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.12",
+  "version": "0.1.14",
   "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",