@orth/cli 0.2.10 → 0.2.12

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;
@@ -71,6 +80,26 @@ export interface IntegrateResponse {
     path: string;
     snippets: Record<string, string>;
 }
+export interface ListApisResponse {
+    success: boolean;
+    apis: Array<{
+        name: string;
+        slug: string;
+        description?: string;
+        baseUrl: string;
+        verified: boolean;
+        endpoints: Array<{
+            path: string;
+            method: string;
+            description?: string;
+            price?: number;
+            isPayable?: boolean;
+        }>;
+    }>;
+    count: number;
+    hasMore: boolean;
+}
+export declare function listApis(limit?: number, offset?: number): Promise<ListApisResponse>;
 export declare function search(prompt: string, limit?: number): Promise<SearchResponse>;
 export interface ApiBySlugResponse {
     success: boolean;

package/dist/api.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.apiRequest = apiRequest;
+exports.listApis = listApis;
 exports.search = search;
 exports.getApiBySlug = getApiBySlug;
 exports.getDetails = getDetails;
@@ -54,6 +55,9 @@ async function apiRequest(endpoint, options = {}) {
     // Return the whole response, not just data field
     return data;
 }
+async function listApis(limit = 100, offset = 0) {
+    return apiRequest(`/list-endpoints?limit=${limit}&offset=${offset}`);
+}
 async function search(prompt, limit = 10) {
     return apiRequest("/search", {
         method: "POST",

package/dist/commands/api.js

@@ -11,32 +11,41 @@ async function apiCommand(slug, path, options) {
     const spinner = (0, ora_1.default)("Loading...").start();
     try {
         if (!slug) {
-            // List all APIs - search multiple terms to get broader coverage
-            const searches = await Promise.all([
-                (0, api_js_1.search)("api", 50),
-                (0, api_js_1.search)("data", 50),
-                (0, api_js_1.search)("search", 50),
-                (0, api_js_1.search)("email", 50),
-            ]);
-            spinner.stop();
-            // Merge and dedupe results
-            const allResults = searches.flatMap(s => s.results || []);
-            const data = {
-                results: allResults,
-                count: allResults.length,
-                apisCount: new Set(allResults.map(r => r.slug)).size,
-            };
-            console.log(chalk_1.default.bold("\nAvailable APIs:\n"));
-            const seen = new Set();
-            for (const api of data.results) {
-                if (!api.slug || seen.has(api.slug))
-                    continue;
-                seen.add(api.slug);
-                console.log(chalk_1.default.cyan.bold(api.slug.padEnd(20)) +
-                    chalk_1.default.white(api.name || "") +
-                    chalk_1.default.gray(` (${api.endpoints?.length || 0} endpoints)`));
+            // List all APIs using the list-endpoints endpoint
+            try {
+                const data = await (0, api_js_1.listApis)(500);
+                spinner.stop();
+                console.log(chalk_1.default.bold("\nAvailable APIs:\n"));
+                const apis = (data.apis || []).sort((a, b) => a.slug.localeCompare(b.slug));
+                for (const api of apis) {
+                    console.log(chalk_1.default.cyan.bold(api.slug.padEnd(20)) +
+                        chalk_1.default.white(api.name || "") +
+                        chalk_1.default.gray(` (${api.endpoints?.length || 0} endpoints)`));
+                }
+                console.log(chalk_1.default.gray("\nRun 'orth api show <slug>' to see endpoints for an API"));
+            }
+            catch {
+                // Fallback to search-based listing if list-endpoints not available
+                const searches = await Promise.all([
+                    (0, api_js_1.search)("api", 50),
+                    (0, api_js_1.search)("data", 50),
+                    (0, api_js_1.search)("search", 50),
+                    (0, api_js_1.search)("email", 50),
+                ]);
+                spinner.stop();
+                const allResults = searches.flatMap(s => s.results || []);
+                console.log(chalk_1.default.bold("\nAvailable APIs:\n"));
+                const seen = new Set();
+                for (const api of allResults) {
+                    if (!api.slug || seen.has(api.slug))
+                        continue;
+                    seen.add(api.slug);
+                    console.log(chalk_1.default.cyan.bold(api.slug.padEnd(20)) +
+                        chalk_1.default.white(api.name || "") +
+                        chalk_1.default.gray(` (${api.endpoints?.length || 0} endpoints)`));
+                }
+                console.log(chalk_1.default.gray("\nRun 'orth api show <slug>' to see endpoints for an API"));
             }
-            console.log(chalk_1.default.gray("\nRun 'orth api show <slug>' to see endpoints for an API"));
             return;
         }
         if (path) {
@@ -44,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.10",
+  "version": "0.2.12",
   "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"
+    "ora": "^5.4.1"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",