@orth/cli 0.2.11 → 0.2.13

package/dist/api.d.ts

@@ -58,6 +58,15 @@ export interface DetailsResponse {
             description?: string;
         }>;
     };
+    action?: {
+        description?: string;
+        parameters?: Array<{
+            name: string;
+            type: string;
+            required: boolean;
+            description?: string;
+        }>;
+    };
 }
 export interface RunResponse {
     success: boolean;

package/dist/commands/api.js

@@ -53,12 +53,13 @@ async function apiCommand(slug, path, options) {
             const data = await (0, api_js_1.getDetails)(slug, path);
             spinner.stop();
             console.log(chalk_1.default.bold(`\n${chalk_1.default.cyan(slug)}${chalk_1.default.white(path)}\n`));
-            // Get description from endpoint object if available
-            const desc = data.description || data.endpoint?.description;
+            // Get description from endpoint or action object if available
+            const desc = data.description || data.endpoint?.description || data.action?.description;
             console.log(chalk_1.default.gray(desc || "No description"));
-            // Get params from nested endpoint object if needed
+            // Get params from nested endpoint or action object if needed
+            const actionParams = data.action?.parameters ?? [];
             const queryParams = data.parameters?.query || data.endpoint?.queryParams || [];
-            const bodyParams = data.parameters?.body || data.endpoint?.bodyParams || [];
+            const bodyParams = data.parameters?.body || data.endpoint?.bodyParams || actionParams;
             if (queryParams.length > 0) {
                 console.log(chalk_1.default.bold("\nQuery Parameters:"));
                 for (const param of queryParams) {

package/dist/commands/auth.js

@@ -33,7 +33,7 @@ async function whoamiCommand() {
     const key = (0, config_js_1.getApiKey)();
     if (!key) {
         console.log(chalk_1.default.yellow("Not authenticated"));
-        console.log(chalk_1.default.gray("Run 'ortho login' to authenticate"));
+        console.log(chalk_1.default.gray("Run 'orth login' to authenticate"));
         return;
     }
     console.log(chalk_1.default.green("✓ Authenticated"));

package/dist/commands/run.d.ts

@@ -4,4 +4,5 @@ export declare function runCommand(api: string, path: string, options: {
     body?: string;
     data?: string;
     raw?: boolean;
+    output?: string;
 }): Promise<void>;

package/dist/commands/run.js

@@ -6,7 +6,58 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.runCommand = runCommand;
 const chalk_1 = __importDefault(require("chalk"));
 const ora_1 = __importDefault(require("ora"));
+const fs_1 = require("fs");
+const path_1 = require("path");
 const api_js_1 = require("../api.js");
+// Map content-type to file extension
+const CONTENT_TYPE_EXT = {
+    "image/jpeg": "jpg",
+    "image/png": "png",
+    "image/gif": "gif",
+    "image/webp": "webp",
+    "image/svg+xml": "svg",
+    "application/pdf": "pdf",
+    "application/zip": "zip",
+    "application/octet-stream": "bin",
+    "audio/mpeg": "mp3",
+    "audio/wav": "wav",
+    "video/mp4": "mp4",
+};
+const VALID_ENCODINGS = new Set(["base64", "base64url", "hex", "utf8", "utf-8", "ascii", "latin1", "binary"]);
+function writeExclusive(filePath, data) {
+    try {
+        (0, fs_1.writeFileSync)(filePath, data, { flag: "wx" });
+    }
+    catch (err) {
+        if (err?.code === "EEXIST") {
+            console.error(chalk_1.default.red(`\nError: File already exists: ${filePath}`));
+            console.error(chalk_1.default.gray("Remove it first or choose a different path."));
+            process.exit(1);
+        }
+        throw err;
+    }
+}
+function extFromContentType(contentType) {
+    // Try exact match first, then prefix match
+    if (CONTENT_TYPE_EXT[contentType])
+        return CONTENT_TYPE_EXT[contentType];
+    // Strip parameters (e.g., "image/jpeg; charset=utf-8")
+    const base = contentType.split(";")[0].trim();
+    if (CONTENT_TYPE_EXT[base])
+        return CONTENT_TYPE_EXT[base];
+    // Fallback: use subtype
+    const parts = base.split("/");
+    return parts[1] || "bin";
+}
+function isBinaryEnvelope(data) {
+    return (typeof data === "object" &&
+        data !== null &&
+        data._binary === true &&
+        typeof data.data === "string" &&
+        typeof data.encoding === "string" &&
+        typeof data.contentType === "string" &&
+        typeof data.size === "number");
+}
 async function runCommand(api, path, options) {
     const spinner = (0, ora_1.default)(`Calling ${api}${path}...`).start();
     try {
@@ -64,6 +115,35 @@ async function runCommand(api, path, options) {
             body,
         });
         spinner.stop();
+        // Handle binary responses (base64-encoded by the server)
+        if (isBinaryEnvelope(result.data)) {
+            if (!options.output) {
+                const ext = extFromContentType(result.data.contentType);
+                const methodHint = options.method !== "GET" ? ` -X ${options.method}` : "";
+                const bodyHint = options.body || options.data ? " --body '...'" : "";
+                const queryHint = options.query?.length ? " -q '...'" : "";
+                console.log(chalk_1.default.yellow(`\nResponse contains binary ${ext.toUpperCase()} data (${result.data.size} bytes).` +
+                    `\nUse -o to save it: orth api run ${api} ${path}${methodHint}${queryHint}${bodyHint} -o output.${ext}`));
+                return;
+            }
+            const ext = extFromContentType(result.data.contentType);
+            const outputPath = (0, path_1.resolve)(options.output);
+            if (!VALID_ENCODINGS.has(result.data.encoding)) {
+                console.error(chalk_1.default.red(`\nError: Server returned unsupported encoding "${result.data.encoding}".`));
+                process.exit(1);
+            }
+            const buffer = Buffer.from(result.data.data, result.data.encoding);
+            writeExclusive(outputPath, buffer);
+            console.log(chalk_1.default.green(`\n${ext.toUpperCase()} saved to: ${outputPath} (${buffer.length} bytes)`));
+            return;
+        }
+        // If --output specified for non-binary data, save JSON to file
+        if (options.output) {
+            const outputPath = (0, path_1.resolve)(options.output);
+            writeExclusive(outputPath, JSON.stringify(result.data, null, 2));
+            console.log(chalk_1.default.green(`\nResponse saved to: ${outputPath}`));
+            return;
+        }
         if (options.raw) {
             console.log(JSON.stringify(result.data, null, 2));
         }

package/dist/config.js

@@ -29,7 +29,7 @@ function clearApiKey() {
 function requireApiKey() {
     const key = getApiKey();
     if (!key) {
-        console.error("Error: Not authenticated. Run 'ortho login' first or set ORTHOGONAL_API_KEY.");
+        console.error("Error: Not authenticated. Run 'orth login' first or set ORTHOGONAL_API_KEY.");
         process.exit(1);
     }
     return key;

package/dist/index.js

@@ -110,6 +110,7 @@ apiGroup
     .option("-b, --body <json>", "Request body JSON")
     .option("-d, --data <json>", "Alias for --body")
     .option("--raw", "Output raw JSON without formatting")
+    .option("-o, --output <file>", "Save response to file (auto-detects binary like images)")
     .action(asyncAction(async (slug, path, options) => {
     (0, analytics_js_1.trackEvent)("api.run", { slug, path });
     await (0, run_js_1.runCommand)(slug, path, options);
@@ -253,6 +254,7 @@ program
     .option("-b, --body <json>", "Request body JSON")
     .option("-d, --data <json>", "Alias for --body")
     .option("--raw", "Output raw JSON without formatting")
+    .option("-o, --output <file>", "Save response to file (auto-detects binary like images)")
     .action(asyncAction(async (api, path, options) => {
     (0, analytics_js_1.trackEvent)("run", { api, path });
     await (0, run_js_1.runCommand)(api, path, options);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orth/cli",
-  "version": "0.2.11",
+  "version": "0.2.13",
   "description": "CLI to access all APIs and skills on the Orthogonal platform",
   "main": "dist/index.js",
   "bin": {
@@ -40,11 +40,11 @@
     "access": "public"
   },
   "dependencies": {
-    "chalk": "^5.3.0",
+    "chalk": "^4.1.2",
     "commander": "^12.0.0",
-    "conf": "^12.0.0",
-    "node-fetch": "^3.3.2",
-    "ora": "^8.0.1"
+    "conf": "^10.2.0",
+    "node-fetch": "^2.7.0",
+    "ora": "^5.4.1"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",