@genspark/cli 1.0.1

package/dist/client.js

@@ -0,0 +1,202 @@
+/**
+ * API Client for Genspark Tool CLI
+ */
+import { debug, info, error as logError } from "./logger.js";
+/**
+ * Make an unauthenticated request to the backend.
+ * Used for device-flow auth endpoints that don't require an API key.
+ */
+export async function unauthenticatedRequest(baseUrl, endpoint, method = "GET", body) {
+    const url = `${baseUrl.replace(/\/$/, "")}${endpoint}`;
+    debug(`Unauthenticated request: ${method} ${url}`);
+    const headers = {
+        "Content-Type": "application/json",
+    };
+    const response = await fetch(url, {
+        method,
+        headers,
+        body: body ? JSON.stringify(body) : undefined,
+    });
+    if (!response.ok) {
+        const errorText = await response.text();
+        throw new Error(`HTTP ${response.status}: ${errorText}`);
+    }
+    return (await response.json());
+}
+export class ApiClient {
+    baseUrl;
+    apiKey;
+    timeout;
+    debugMode;
+    projectId;
+    constructor(options) {
+        this.baseUrl = options.baseUrl.replace(/\/$/, "");
+        this.apiKey = options.apiKey || "";
+        this.timeout = options.timeout;
+        this.debugMode = options.debug;
+        this.projectId = options.projectId;
+    }
+    async request(endpoint, method = "GET", body) {
+        const url = `${this.baseUrl}/api/tool_cli${endpoint}`;
+        debug(`Request: ${method} ${url}`);
+        debug(`Project ID for header: ${this.projectId || "(not set)"}`);
+        if (body) {
+            debug(`Body: ${JSON.stringify(body)}`);
+        }
+        const headers = {
+            "Content-Type": "application/json",
+        };
+        if (this.apiKey) {
+            headers["X-Api-Key"] = this.apiKey;
+        }
+        // Add project ID header for sandbox lookup when sandbox_id is not provided
+        if (this.projectId) {
+            headers["X-Project-ID"] = this.projectId;
+        }
+        // Add debug header to request more details from server
+        if (this.debugMode) {
+            headers["X-Debug"] = "true";
+        }
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        try {
+            info(`Calling ${endpoint}...`);
+            const response = await fetch(url, {
+                method,
+                headers,
+                body: body ? JSON.stringify(body) : undefined,
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            debug(`Response status: ${response.status}`);
+            if (!response.ok) {
+                const errorText = await response.text();
+                debug(`Error response: ${errorText}`);
+                return {
+                    status: "error",
+                    message: `HTTP ${response.status}: ${response.statusText}`,
+                    data: null,
+                };
+            }
+            // Handle streaming NDJSON response (Protocol v1)
+            // Server sends newline-delimited JSON with version field:
+            // - Debug/heartbeat messages: {"version": 1, "debug": true, "message": "..."}
+            // - Final result: {"version": 1, "status": "ok"|"error", "message": "...", "data": {...}}
+            //
+            // Protocol compatibility:
+            // - CLI ignores messages with version > SUPPORTED_VERSION (forward compatibility)
+            // - Messages without version field are treated as version 1
+            const SUPPORTED_VERSION = 1;
+            const text = await response.text();
+            debug(`Raw response length: ${text.length}`);
+            const lines = text.trim().split("\n");
+            let finalResult = null;
+            for (const rawLine of lines) {
+                const line = rawLine.trim();
+                if (!line || !line.startsWith("{")) {
+                    continue;
+                }
+                try {
+                    const parsed = JSON.parse(line);
+                    // Check protocol version - ignore messages from future versions
+                    const messageVersion = parsed.version ?? 1;
+                    if (messageVersion > SUPPORTED_VERSION) {
+                        debug(`Ignoring message with version ${messageVersion} (supported: ${SUPPORTED_VERSION})`);
+                        continue;
+                    }
+                    // Check if it's a debug/heartbeat message
+                    if (parsed.debug === true) {
+                        // Only output debug messages to stderr when --debug is enabled
+                        if (this.debugMode) {
+                            debug(`[Server] ${parsed.message}`);
+                            // Output additional debug info if present
+                            if (parsed.tool) {
+                                debug(`  Tool: ${parsed.tool}`);
+                            }
+                            if (parsed.arguments) {
+                                debug(`  Arguments: ${JSON.stringify(parsed.arguments)}`);
+                            }
+                            if (parsed.heartbeat) {
+                                debug(`  Heartbeat #${parsed.heartbeat}`);
+                            }
+                            if (parsed.elapsed_seconds !== undefined) {
+                                debug(`  Elapsed: ${parsed.elapsed_seconds}s`);
+                            }
+                        }
+                    }
+                    else {
+                        // This is the final result (has status field, no debug field)
+                        finalResult = parsed;
+                    }
+                }
+                catch {
+                    // Skip malformed JSON lines
+                    debug(`Skipping malformed JSON line: ${line.substring(0, 100)}`);
+                }
+            }
+            if (!finalResult) {
+                return {
+                    status: "error",
+                    message: "No valid result found in response",
+                    data: null,
+                };
+            }
+            debug(`Final result status: ${finalResult.status}`);
+            return finalResult;
+        }
+        catch (err) {
+            clearTimeout(timeoutId);
+            if (err instanceof Error) {
+                if (err.name === "AbortError") {
+                    logError(`Request timeout after ${this.timeout}ms`);
+                    return {
+                        status: "error",
+                        message: `Request timeout after ${this.timeout}ms`,
+                        data: null,
+                    };
+                }
+                logError(`Request failed: ${err.message}`);
+                return {
+                    status: "error",
+                    message: err.message,
+                    data: null,
+                };
+            }
+            return {
+                status: "error",
+                message: "Unknown error",
+                data: null,
+            };
+        }
+    }
+    /**
+     * List available tools with full schemas
+     */
+    async listTools() {
+        const response = await this.request("/tools", "GET");
+        if (response.status === "error") {
+            throw new Error(response.message);
+        }
+        // The /tools endpoint returns the data directly, not wrapped in ApiResponse
+        return response;
+    }
+    /**
+     * Execute any tool by name with arguments
+     */
+    async executeTool(toolName, args) {
+        return this.request(`/${toolName}`, "POST", args);
+    }
+    /**
+     * Get a pre-signed URL for uploading a file
+     */
+    async getUploadUrl(params) {
+        return this.request("/file/upload_url", "POST", params);
+    }
+    /**
+     * Get a downloadable URL for a file wrapper URL
+     */
+    async getDownloadUrl(params) {
+        return this.request("/file/download", "POST", params);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/config.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Configuration loader for Genspark Tool CLI
+ *
+ * Loads configuration from multiple sources with the following priority (highest to lowest):
+ * 1. Command-line options
+ * 2. Environment variables (GSK_API_KEY, GSK_BASE_URL)
+ * 3. Config file (~/.genspark-tool-cli/config.json)
+ */
+import type { ToolSchema } from "./types.js";
+export interface ConfigFile {
+    api_key?: string;
+    base_url?: string;
+    timeout?: number;
+    debug?: boolean;
+    project_id?: string;
+    auto_update?: boolean;
+}
+/**
+ * Get the path to the config file
+ */
+export declare function getConfigPath(): string;
+/**
+ * Load configuration from the config file
+ * Returns an empty object if the file doesn't exist or is invalid
+ */
+export declare function loadConfigFile(): ConfigFile;
+/**
+ * Save configuration to the config file
+ */
+export declare function saveConfigFile(config: ConfigFile): void;
+/**
+ * Load tools from the cache file.
+ * Returns null if cache doesn't exist, is stale (>24h), or base_url doesn't match.
+ */
+export declare function loadToolsCache(baseUrl: string): ToolSchema[] | null;
+/**
+ * Save tools to the cache file.
+ */
+export declare function saveToolsCache(baseUrl: string, tools: ToolSchema[]): void;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAoBD;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,UAAU,CA6B3C;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAUvD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,EAAE,GAAG,IAAI,CA+BnE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,IAAI,CAezE"}

package/dist/config.js

@@ -0,0 +1,116 @@
+/**
+ * Configuration loader for Genspark Tool CLI
+ *
+ * Loads configuration from multiple sources with the following priority (highest to lowest):
+ * 1. Command-line options
+ * 2. Environment variables (GSK_API_KEY, GSK_BASE_URL)
+ * 3. Config file (~/.genspark-tool-cli/config.json)
+ */
+import * as fs from "fs";
+import * as path from "path";
+import * as os from "os";
+const CONFIG_DIR = ".genspark-tool-cli";
+const CONFIG_FILE = "config.json";
+const TOOLS_CACHE_FILE = "tools-cache.json";
+const CACHE_MAX_AGE_MS = 24 * 60 * 60 * 1000; // 24 hours
+/**
+ * Get the config directory path
+ */
+function getConfigDir() {
+    return path.join(os.homedir(), CONFIG_DIR);
+}
+/**
+ * Get the path to the config file
+ */
+export function getConfigPath() {
+    return path.join(getConfigDir(), CONFIG_FILE);
+}
+/**
+ * Load configuration from the config file
+ * Returns an empty object if the file doesn't exist or is invalid
+ */
+export function loadConfigFile() {
+    const configPath = getConfigPath();
+    try {
+        if (!fs.existsSync(configPath)) {
+            return {};
+        }
+        const content = fs.readFileSync(configPath, "utf-8");
+        const config = JSON.parse(content);
+        // Validate and return only known fields
+        return {
+            api_key: typeof config.api_key === "string" ? config.api_key : undefined,
+            base_url: typeof config.base_url === "string" ? config.base_url : undefined,
+            timeout: typeof config.timeout === "number" ? config.timeout : undefined,
+            debug: typeof config.debug === "boolean" ? config.debug : undefined,
+            project_id: typeof config.project_id === "string" ? config.project_id : undefined,
+            auto_update: typeof config.auto_update === "boolean"
+                ? config.auto_update
+                : undefined,
+        };
+    }
+    catch {
+        // Silently ignore errors (file not found, invalid JSON, etc.)
+        return {};
+    }
+}
+/**
+ * Save configuration to the config file
+ */
+export function saveConfigFile(config) {
+    const configDir = getConfigDir();
+    const configPath = path.join(configDir, CONFIG_FILE);
+    // Create config directory if it doesn't exist
+    if (!fs.existsSync(configDir)) {
+        fs.mkdirSync(configDir, { recursive: true });
+    }
+    fs.writeFileSync(configPath, JSON.stringify(config, null, 2), "utf-8");
+}
+/**
+ * Load tools from the cache file.
+ * Returns null if cache doesn't exist, is stale (>24h), or base_url doesn't match.
+ */
+export function loadToolsCache(baseUrl) {
+    const cachePath = path.join(getConfigDir(), TOOLS_CACHE_FILE);
+    try {
+        if (!fs.existsSync(cachePath)) {
+            return null;
+        }
+        const content = fs.readFileSync(cachePath, "utf-8");
+        const cache = JSON.parse(content);
+        // Validate base_url matches
+        if (cache.base_url !== baseUrl) {
+            return null;
+        }
+        // Check age (treat invalid timestamps as stale)
+        const fetchedAt = new Date(cache.fetched_at).getTime();
+        if (isNaN(fetchedAt) || Date.now() - fetchedAt > CACHE_MAX_AGE_MS) {
+            return null;
+        }
+        // Validate tools array
+        if (!Array.isArray(cache.tools) || cache.tools.length === 0) {
+            return null;
+        }
+        return cache.tools;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Save tools to the cache file.
+ */
+export function saveToolsCache(baseUrl, tools) {
+    const configDir = getConfigDir();
+    const cachePath = path.join(configDir, TOOLS_CACHE_FILE);
+    if (!fs.existsSync(configDir)) {
+        fs.mkdirSync(configDir, { recursive: true });
+    }
+    const cache = {
+        fetched_at: new Date().toISOString(),
+        base_url: baseUrl,
+        tools,
+    };
+    fs.writeFileSync(cachePath, JSON.stringify(cache, null, 2), "utf-8");
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/formatter.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Generic JSON-to-text formatter for --output text mode.
+ * No per-tool special cases — just walks the data structure:
+ *   - string/number/boolean → as-is
+ *   - array → numbered list
+ *   - object → key: value pairs
+ */
+/**
+ * Convert API response data to human-readable text.
+ * Unwraps { status, message, data } envelope if present.
+ */
+export declare function formatAsMarkdown(data: unknown): string;
+//# sourceMappingURL=formatter.d.ts.map

package/dist/formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../src/formatter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA8CH;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAetD"}

package/dist/formatter.js

@@ -0,0 +1,68 @@
+/**
+ * Generic JSON-to-text formatter for --output text mode.
+ * No per-tool special cases — just walks the data structure:
+ *   - string/number/boolean → as-is
+ *   - array → numbered list
+ *   - object → key: value pairs
+ */
+function formatValue(data, indent = 0) {
+    if (data === null || data === undefined)
+        return "";
+    if (typeof data === "string")
+        return data;
+    if (typeof data === "number" || typeof data === "boolean")
+        return String(data);
+    const pad = "  ".repeat(indent);
+    if (Array.isArray(data)) {
+        if (data.length === 0)
+            return "(empty)";
+        return data
+            .map((item, i) => {
+            const formatted = formatValue(item, indent + 1);
+            // For objects in arrays, put first line on same line as number, rest indented
+            if (typeof item === "object" && item !== null && !Array.isArray(item)) {
+                const lines = formatted.split("\n");
+                if (lines.length <= 1) {
+                    return `${pad}${i + 1}. ${lines[0]}`;
+                }
+                return `${pad}${i + 1}. ${lines[0]}\n${lines.slice(1).join("\n")}`;
+            }
+            return `${pad}${i + 1}. ${formatted}`;
+        })
+            .join("\n");
+    }
+    if (typeof data === "object") {
+        const obj = data;
+        const entries = Object.entries(obj).filter(([, v]) => v !== null && v !== undefined);
+        if (entries.length === 0)
+            return "(empty)";
+        return entries
+            .map(([k, v]) => {
+            if (typeof v === "object") {
+                return `${pad}${k}:\n${formatValue(v, indent + 1)}`;
+            }
+            return `${pad}${k}: ${String(v)}`;
+        })
+            .join("\n");
+    }
+    return String(data);
+}
+/**
+ * Convert API response data to human-readable text.
+ * Unwraps { status, message, data } envelope if present.
+ */
+export function formatAsMarkdown(data) {
+    if (data === null || data === undefined)
+        return "";
+    if (typeof data !== "object")
+        return String(data);
+    const obj = data;
+    // Error envelope
+    if (obj.status === "error") {
+        return `Error: ${obj.message || "Unknown error"}`;
+    }
+    // Unwrap ApiResponse { status: "ok", data: ... }
+    const inner = obj.status === "ok" && "data" in obj ? obj.data : data;
+    return formatValue(inner, 0);
+}
+//# sourceMappingURL=formatter.js.map

package/dist/formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.js","sourceRoot":"","sources":["../src/formatter.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+/**
+ * Genspark Tool CLI
+ *
+ * A command-line interface for Genspark Tool API.
+ * Designed for integration with AI agents (e.g., Claude Code).
+ *
+ * Output conventions:
+ * - stderr: Debug info, progress, errors (for human reading)
+ * - stdout: API response JSON (for AI agent context)
+ *
+ * Command Naming Convention:
+ * - CLI commands are dynamically generated from server tool schemas
+ * - Tool name is always the canonical command name
+ * - Aliases provide human-friendly shortcuts (e.g., `search` for `web_search`)
+ *
+ * Example:
+ *   Tool name: "web_search" -> Command: `gsk web_search`, Alias: `gsk search`
+ *   Tool name: "crawler"    -> Command: `gsk crawler`, Alias: `gsk crawl`
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;GAkBG"}