@rainfall-devkit/sdk 0.1.1

package/dist/cli/index.js

@@ -0,0 +1,1067 @@
+#!/usr/bin/env node
+"use strict";
+
+// src/cli/index.ts
+var import_fs = require("fs");
+var import_path = require("path");
+var import_os = require("os");
+
+// src/errors.ts
+var RainfallError = class _RainfallError extends Error {
+  constructor(message, code, statusCode, details) {
+    super(message);
+    this.code = code;
+    this.statusCode = statusCode;
+    this.details = details;
+    this.name = "RainfallError";
+    Object.setPrototypeOf(this, _RainfallError.prototype);
+  }
+  toJSON() {
+    return {
+      name: this.name,
+      code: this.code,
+      message: this.message,
+      statusCode: this.statusCode,
+      details: this.details
+    };
+  }
+};
+var AuthenticationError = class _AuthenticationError extends RainfallError {
+  constructor(message = "Invalid API key", details) {
+    super(message, "AUTHENTICATION_ERROR", 401, details);
+    this.name = "AuthenticationError";
+    Object.setPrototypeOf(this, _AuthenticationError.prototype);
+  }
+};
+var RateLimitError = class _RateLimitError extends RainfallError {
+  retryAfter;
+  limit;
+  remaining;
+  resetAt;
+  constructor(message = "Rate limit exceeded", retryAfter = 60, limit = 0, remaining = 0, resetAt) {
+    super(message, "RATE_LIMIT_ERROR", 429, { retryAfter, limit, remaining });
+    this.name = "RateLimitError";
+    this.retryAfter = retryAfter;
+    this.limit = limit;
+    this.remaining = remaining;
+    this.resetAt = resetAt || new Date(Date.now() + retryAfter * 1e3);
+    Object.setPrototypeOf(this, _RateLimitError.prototype);
+  }
+};
+var ValidationError = class _ValidationError extends RainfallError {
+  constructor(message, details) {
+    super(message, "VALIDATION_ERROR", 400, details);
+    this.name = "ValidationError";
+    Object.setPrototypeOf(this, _ValidationError.prototype);
+  }
+};
+var NotFoundError = class _NotFoundError extends RainfallError {
+  constructor(resource, identifier) {
+    super(
+      `${resource}${identifier ? ` '${identifier}'` : ""} not found`,
+      "NOT_FOUND_ERROR",
+      404,
+      { resource, identifier }
+    );
+    this.name = "NotFoundError";
+    Object.setPrototypeOf(this, _NotFoundError.prototype);
+  }
+};
+var ServerError = class _ServerError extends RainfallError {
+  constructor(message = "Internal server error", statusCode = 500) {
+    super(message, "SERVER_ERROR", statusCode);
+    this.name = "ServerError";
+    Object.setPrototypeOf(this, _ServerError.prototype);
+  }
+};
+var TimeoutError = class _TimeoutError extends RainfallError {
+  constructor(timeoutMs) {
+    super(`Request timed out after ${timeoutMs}ms`, "TIMEOUT_ERROR", 408);
+    this.name = "TimeoutError";
+    Object.setPrototypeOf(this, _TimeoutError.prototype);
+  }
+};
+var NetworkError = class _NetworkError extends RainfallError {
+  constructor(message = "Network error", details) {
+    super(message, "NETWORK_ERROR", void 0, details);
+    this.name = "NetworkError";
+    Object.setPrototypeOf(this, _NetworkError.prototype);
+  }
+};
+function parseErrorResponse(response, data) {
+  const statusCode = response.status;
+  if (statusCode === 429) {
+    const retryAfter = parseInt(response.headers.get("retry-after") || "60", 10);
+    const limit = parseInt(response.headers.get("x-ratelimit-limit") || "0", 10);
+    const remaining = parseInt(response.headers.get("x-ratelimit-remaining") || "0", 10);
+    const resetHeader = response.headers.get("x-ratelimit-reset");
+    const resetAt = resetHeader ? new Date(parseInt(resetHeader, 10) * 1e3) : void 0;
+    return new RateLimitError(
+      typeof data === "object" && data && "message" in data ? String(data.message) : "Rate limit exceeded",
+      retryAfter,
+      limit,
+      remaining,
+      resetAt
+    );
+  }
+  switch (statusCode) {
+    case 401:
+      return new AuthenticationError(
+        typeof data === "object" && data && "message" in data ? String(data.message) : "Invalid API key"
+      );
+    case 404:
+      return new NotFoundError(
+        typeof data === "object" && data && "resource" in data ? String(data.resource) : "Resource",
+        typeof data === "object" && data && "identifier" in data ? String(data.identifier) : void 0
+      );
+    case 400:
+      return new ValidationError(
+        typeof data === "object" && data && "message" in data ? String(data.message) : "Invalid request",
+        typeof data === "object" && data && "details" in data ? data.details : void 0
+      );
+    case 500:
+    case 502:
+    case 503:
+    case 504:
+      return new ServerError(
+        typeof data === "object" && data && "message" in data ? String(data.message) : "Server error",
+        statusCode
+      );
+    default:
+      return new RainfallError(
+        typeof data === "object" && data && "message" in data ? String(data.message) : `HTTP ${statusCode}`,
+        "UNKNOWN_ERROR",
+        statusCode,
+        typeof data === "object" ? data : void 0
+      );
+  }
+}
+
+// src/client.ts
+var DEFAULT_BASE_URL = "https://olympic-api.pragma-digital.org/v1";
+var DEFAULT_TIMEOUT = 3e4;
+var DEFAULT_RETRIES = 3;
+var DEFAULT_RETRY_DELAY = 1e3;
+var RainfallClient = class {
+  apiKey;
+  baseUrl;
+  defaultTimeout;
+  defaultRetries;
+  defaultRetryDelay;
+  lastRateLimitInfo;
+  constructor(config) {
+    this.apiKey = config.apiKey;
+    this.baseUrl = config.baseUrl || DEFAULT_BASE_URL;
+    this.defaultTimeout = config.timeout || DEFAULT_TIMEOUT;
+    this.defaultRetries = config.retries ?? DEFAULT_RETRIES;
+    this.defaultRetryDelay = config.retryDelay || DEFAULT_RETRY_DELAY;
+  }
+  /**
+   * Get the last rate limit info from the API
+   */
+  getRateLimitInfo() {
+    return this.lastRateLimitInfo;
+  }
+  /**
+   * Make an authenticated request to the Rainfall API
+   */
+  async request(path, options = {}, requestOptions) {
+    const timeout = requestOptions?.timeout ?? this.defaultTimeout;
+    const maxRetries = requestOptions?.retries ?? this.defaultRetries;
+    const retryDelay = requestOptions?.retryDelay ?? this.defaultRetryDelay;
+    const url = `${this.baseUrl}${path}`;
+    const method = options.method || "GET";
+    let lastError;
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+      try {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), timeout);
+        const response = await fetch(url, {
+          method,
+          headers: {
+            "Authorization": `Bearer ${this.apiKey}`,
+            "Content-Type": "application/json",
+            "Accept": "application/json",
+            "X-Rainfall-SDK-Version": "0.1.0",
+            ...options.headers
+          },
+          body: options.body ? JSON.stringify(options.body) : void 0,
+          signal: controller.signal
+        });
+        clearTimeout(timeoutId);
+        const limit = response.headers.get("x-ratelimit-limit");
+        const remaining = response.headers.get("x-ratelimit-remaining");
+        const reset = response.headers.get("x-ratelimit-reset");
+        if (limit && remaining && reset) {
+          this.lastRateLimitInfo = {
+            limit: parseInt(limit, 10),
+            remaining: parseInt(remaining, 10),
+            resetAt: new Date(parseInt(reset, 10) * 1e3)
+          };
+        }
+        let data;
+        const contentType = response.headers.get("content-type");
+        if (contentType?.includes("application/json")) {
+          data = await response.json();
+        } else {
+          data = await response.text();
+        }
+        if (!response.ok) {
+          throw parseErrorResponse(response, data);
+        }
+        return data;
+      } catch (error) {
+        if (error instanceof RainfallError) {
+          if (error.statusCode && error.statusCode >= 400 && error.statusCode < 500 && error.statusCode !== 429) {
+            throw error;
+          }
+          if (error.statusCode === 401) {
+            throw error;
+          }
+        }
+        if (error instanceof Error && error.name === "AbortError") {
+          lastError = new TimeoutError(timeout);
+        } else if (error instanceof TypeError) {
+          lastError = new NetworkError(error.message);
+        } else {
+          lastError = error instanceof Error ? error : new Error(String(error));
+        }
+        if (attempt >= maxRetries) {
+          break;
+        }
+        const delay = retryDelay * Math.pow(2, attempt) + Math.random() * 1e3;
+        await this.sleep(delay);
+      }
+    }
+    throw lastError || new RainfallError("Request failed", "REQUEST_FAILED");
+  }
+  /**
+   * Execute a tool/node by ID
+   */
+  async executeTool(toolId, params, options) {
+    return this.request(`/tools/${toolId}`, {
+      method: "POST",
+      body: params
+    }, options);
+  }
+  /**
+   * List all available tools
+   */
+  async listTools() {
+    return this.request("/tools");
+  }
+  /**
+   * Get tool schema/parameters
+   */
+  async getToolSchema(toolId) {
+    return this.request(`/tools/${toolId}/schema`);
+  }
+  /**
+   * Get subscriber info
+   */
+  async getMe() {
+    return this.request("/me");
+  }
+  sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+  }
+};
+
+// src/namespaces/integrations.ts
+function createIntegrations(client) {
+  return new IntegrationsNamespace(client);
+}
+var IntegrationsNamespace = class {
+  constructor(client) {
+    this.client = client;
+  }
+  get github() {
+    return {
+      issues: {
+        create: (params) => this.client.executeTool("github-create-issue", params),
+        list: (params) => this.client.executeTool("github-list-issues", params),
+        get: (params) => this.client.executeTool("github-get-issue", params),
+        update: (params) => this.client.executeTool("github-update-issue", params),
+        addComment: (params) => this.client.executeTool("github-add-issue-comment", params)
+      },
+      repos: {
+        get: (params) => this.client.executeTool("github-get-repository", params),
+        listBranches: (params) => this.client.executeTool("github-list-branches", params)
+      },
+      pullRequests: {
+        list: (params) => this.client.executeTool("github-list-pull-requests", params),
+        get: (params) => this.client.executeTool("github-get-pull-request", params)
+      }
+    };
+  }
+  get notion() {
+    return {
+      pages: {
+        create: (params) => this.client.executeTool("notion-pages-create", params),
+        retrieve: (params) => this.client.executeTool("notion-pages-retrieve", params),
+        update: (params) => this.client.executeTool("notion-pages-update", params)
+      },
+      databases: {
+        query: (params) => this.client.executeTool("notion-databases-query", params),
+        retrieve: (params) => this.client.executeTool("notion-databases-retrieve", params)
+      },
+      blocks: {
+        appendChildren: (params) => this.client.executeTool("notion-blocks-append-children", params),
+        retrieveChildren: (params) => this.client.executeTool("notion-blocks-retrieve-children", params)
+      }
+    };
+  }
+  get linear() {
+    return {
+      issues: {
+        create: (params) => this.client.executeTool("linear-core-issueCreate", params),
+        list: (params) => this.client.executeTool("linear-core-issues", params),
+        get: (params) => this.client.executeTool("linear-core-issue", params),
+        update: (params) => this.client.executeTool("linear-core-issueUpdate", params),
+        archive: (params) => this.client.executeTool("linear-core-issueArchive", params)
+      },
+      teams: {
+        list: () => this.client.executeTool("linear-core-teams", {})
+      }
+    };
+  }
+  get slack() {
+    return {
+      messages: {
+        send: (params) => this.client.executeTool("slack-core-postMessage", params),
+        list: (params) => this.client.executeTool("slack-core-listMessages", params)
+      },
+      channels: {
+        list: () => this.client.executeTool("slack-core-listChannels", {})
+      },
+      users: {
+        list: () => this.client.executeTool("slack-core-listUsers", {})
+      },
+      reactions: {
+        add: (params) => this.client.executeTool("slack-core-addReaction", params)
+      }
+    };
+  }
+  get figma() {
+    return {
+      files: {
+        get: (params) => this.client.executeTool("figma-files-getFile", { fileKey: params.fileKey }),
+        getNodes: (params) => this.client.executeTool("figma-files-getFileNodes", { fileKey: params.fileKey, nodeIds: params.nodeIds }),
+        getImages: (params) => this.client.executeTool("figma-files-getFileImage", { fileKey: params.fileKey, nodeIds: params.nodeIds, format: params.format }),
+        getComments: (params) => this.client.executeTool("figma-comments-getFileComments", { fileKey: params.fileKey }),
+        postComment: (params) => this.client.executeTool("figma-comments-postComment", { fileKey: params.fileKey, message: params.message, nodeId: params.nodeId })
+      },
+      projects: {
+        list: (params) => this.client.executeTool("figma-projects-getTeamProjects", { teamId: params.teamId }),
+        getFiles: (params) => this.client.executeTool("figma-projects-getProjectFiles", { projectId: params.projectId })
+      }
+    };
+  }
+  get stripe() {
+    return {
+      customers: {
+        create: (params) => this.client.executeTool("stripe-customers-create", params),
+        retrieve: (params) => this.client.executeTool("stripe-customers-retrieve", { customerId: params.customerId }),
+        update: (params) => this.client.executeTool("stripe-customers-update", params),
+        listPaymentMethods: (params) => this.client.executeTool("stripe-customers-list-payment-methods", { customerId: params.customerId })
+      },
+      paymentIntents: {
+        create: (params) => this.client.executeTool("stripe-payment-intents-create", params),
+        retrieve: (params) => this.client.executeTool("stripe-payment-intents-retrieve", { paymentIntentId: params.paymentIntentId }),
+        confirm: (params) => this.client.executeTool("stripe-payment-intents-confirm", { paymentIntentId: params.paymentIntentId })
+      },
+      subscriptions: {
+        create: (params) => this.client.executeTool("stripe-subscriptions-create", params),
+        retrieve: (params) => this.client.executeTool("stripe-subscriptions-retrieve", { subscriptionId: params.subscriptionId }),
+        cancel: (params) => this.client.executeTool("stripe-subscriptions-cancel", { subscriptionId: params.subscriptionId })
+      }
+    };
+  }
+};
+
+// src/namespaces/memory.ts
+function createMemory(client) {
+  return {
+    create: (params) => client.executeTool("memory-create", params),
+    get: (params) => client.executeTool("memory-get", { memoryId: params.memoryId }),
+    recall: (params) => client.executeTool("memory-recall", params),
+    list: (params) => client.executeTool("memory-list", params ?? {}),
+    update: (params) => client.executeTool("memory-update", params),
+    delete: (params) => client.executeTool("memory-delete", { memoryId: params.memoryId })
+  };
+}
+
+// src/namespaces/articles.ts
+function createArticles(client) {
+  return {
+    search: (params) => client.executeTool("article-search", params),
+    create: (params) => client.executeTool("article-create", params),
+    createFromUrl: (params) => client.executeTool("article-create-from-url", params),
+    fetch: (params) => client.executeTool("article-fetch", params),
+    recent: (params) => client.executeTool("article-recent", params ?? {}),
+    relevant: (params) => client.executeTool("article-relevant-news", params),
+    summarize: (params) => client.executeTool("article-summarize", params),
+    extractTopics: (params) => client.executeTool("article-topic-extractor", params)
+  };
+}
+
+// src/namespaces/web.ts
+function createWeb(client) {
+  return {
+    search: {
+      exa: (params) => client.executeTool("exa-web-search", params),
+      perplexity: (params) => client.executeTool("perplexity-search", params)
+    },
+    fetch: (params) => client.executeTool("web-fetch", params),
+    htmlToMarkdown: (params) => client.executeTool("html-to-markdown-converter", params),
+    extractHtml: (params) => client.executeTool("extract-html-selector", params)
+  };
+}
+
+// src/namespaces/ai.ts
+function createAI(client) {
+  return {
+    embeddings: {
+      document: (params) => client.executeTool("jina-document-embedding", params),
+      query: (params) => client.executeTool("jina-query-embedding", params),
+      image: (params) => client.executeTool("jina-image-embedding", { image: params.imageBase64 })
+    },
+    image: {
+      generate: (params) => client.executeTool("image-generation", params)
+    },
+    ocr: (params) => client.executeTool("ocr-text-extraction", { image: params.imageBase64 }),
+    vision: (params) => client.executeTool("llama-scout-vision", { image: params.imageBase64, prompt: params.prompt }),
+    chat: (params) => client.executeTool("xai-chat-completions", params),
+    complete: (params) => client.executeTool("fim", params),
+    classify: (params) => client.executeTool("jina-document-classifier", params),
+    segment: (params) => client.executeTool("jina-text-segmenter", params)
+  };
+}
+
+// src/namespaces/data.ts
+function createData(client) {
+  return {
+    csv: {
+      query: (params) => client.executeTool("query-csv", params),
+      convert: (params) => client.executeTool("csv-convert", params)
+    },
+    scripts: {
+      create: (params) => client.executeTool("create-saved-script", params),
+      execute: (params) => client.executeTool("execute-saved-script", params),
+      list: () => client.executeTool("list-saved-scripts", {}),
+      update: (params) => client.executeTool("update-saved-script", params),
+      delete: (params) => client.executeTool("delete-saved-script", params)
+    },
+    similarity: {
+      search: (params) => client.executeTool("duck-db-similarity-search", params),
+      duckDbSearch: (params) => client.executeTool("duck-db-similarity-search", params)
+    }
+  };
+}
+
+// src/namespaces/utils.ts
+function createUtils(client) {
+  return {
+    mermaid: (params) => client.executeTool("mermaid-diagram-generator", { mermaid: params.diagram }),
+    documentConvert: (params) => client.executeTool("document-format-converter", {
+      base64: `data:${params.mimeType};base64,${Buffer.from(params.document).toString("base64")}`,
+      format: params.format
+    }),
+    regex: {
+      match: (params) => client.executeTool("regex-match", params),
+      replace: (params) => client.executeTool("regex-replace", params)
+    },
+    jsonExtract: (params) => client.executeTool("json-extract", params),
+    digest: (params) => client.executeTool("digest-generator", { text: params.data }),
+    monteCarlo: (params) => client.executeTool("monte-carlo-simulation", params)
+  };
+}
+
+// src/sdk.ts
+var Rainfall = class {
+  client;
+  _integrations;
+  _memory;
+  _articles;
+  _web;
+  _ai;
+  _data;
+  _utils;
+  constructor(config) {
+    this.client = new RainfallClient(config);
+  }
+  /**
+   * Integrations namespace - GitHub, Notion, Linear, Slack, Figma, Stripe
+   * 
+   * @example
+   * ```typescript
+   * // GitHub
+   * await rainfall.integrations.github.issues.create({
+   *   owner: 'facebook',
+   *   repo: 'react',
+   *   title: 'Bug report'
+   * });
+   * 
+   * // Slack
+   * await rainfall.integrations.slack.messages.send({
+   *   channelId: 'C123456',
+   *   text: 'Hello team!'
+   * });
+   * 
+   * // Linear
+   * const issues = await rainfall.integrations.linear.issues.list();
+   * ```
+   */
+  get integrations() {
+    if (!this._integrations) {
+      this._integrations = createIntegrations(this.client);
+    }
+    return this._integrations;
+  }
+  /**
+   * Memory namespace - Semantic memory storage and retrieval
+   * 
+   * @example
+   * ```typescript
+   * // Store a memory
+   * await rainfall.memory.create({
+   *   content: 'User prefers dark mode',
+   *   keywords: ['preference', 'ui']
+   * });
+   * 
+   * // Recall similar memories
+   * const memories = await rainfall.memory.recall({
+   *   query: 'user preferences',
+   *   topK: 5
+   * });
+   * ```
+   */
+  get memory() {
+    if (!this._memory) {
+      this._memory = createMemory(this.client);
+    }
+    return this._memory;
+  }
+  /**
+   * Articles namespace - News aggregation and article management
+   * 
+   * @example
+   * ```typescript
+   * // Search news
+   * const articles = await rainfall.articles.search({
+   *   query: 'artificial intelligence'
+   * });
+   * 
+   * // Create from URL
+   * const article = await rainfall.articles.createFromUrl({
+   *   url: 'https://example.com/article'
+   * });
+   * 
+   * // Summarize
+   * const summary = await rainfall.articles.summarize({
+   *   text: article.content
+   * });
+   * ```
+   */
+  get articles() {
+    if (!this._articles) {
+      this._articles = createArticles(this.client);
+    }
+    return this._articles;
+  }
+  /**
+   * Web namespace - Web search, scraping, and content extraction
+   * 
+   * @example
+   * ```typescript
+   * // Search with Exa
+   * const results = await rainfall.web.search.exa({
+   *   query: 'latest AI research'
+   * });
+   * 
+   * // Fetch and convert
+   * const html = await rainfall.web.fetch({ url: 'https://example.com' });
+   * const markdown = await rainfall.web.htmlToMarkdown({ html });
+   * 
+   * // Extract specific elements
+   * const links = await rainfall.web.extractHtml({
+   *   html,
+   *   selector: 'a[href]'
+   * });
+   * ```
+   */
+  get web() {
+    if (!this._web) {
+      this._web = createWeb(this.client);
+    }
+    return this._web;
+  }
+  /**
+   * AI namespace - Embeddings, image generation, OCR, vision, chat
+   * 
+   * @example
+   * ```typescript
+   * // Generate embeddings
+   * const embedding = await rainfall.ai.embeddings.document({
+   *   text: 'Hello world'
+   * });
+   * 
+   * // Generate image
+   * const image = await rainfall.ai.image.generate({
+   *   prompt: 'A serene mountain landscape'
+   * });
+   * 
+   * // OCR
+   * const text = await rainfall.ai.ocr({ imageBase64: '...' });
+   * 
+   * // Chat
+   * const response = await rainfall.ai.chat({
+   *   messages: [{ role: 'user', content: 'Hello!' }]
+   * });
+   * ```
+   */
+  get ai() {
+    if (!this._ai) {
+      this._ai = createAI(this.client);
+    }
+    return this._ai;
+  }
+  /**
+   * Data namespace - CSV processing, scripts, similarity search
+   * 
+   * @example
+   * ```typescript
+   * // Query CSV with SQL
+   * const results = await rainfall.data.csv.query({
+   *   sql: 'SELECT * FROM data WHERE value > 100'
+   * });
+   * 
+   * // Execute saved script
+   * const result = await rainfall.data.scripts.execute({
+   *   name: 'my-script',
+   *   params: { input: 'data' }
+   * });
+   * ```
+   */
+  get data() {
+    if (!this._data) {
+      this._data = createData(this.client);
+    }
+    return this._data;
+  }
+  /**
+   * Utils namespace - Mermaid diagrams, document conversion, regex, JSON extraction
+   * 
+   * @example
+   * ```typescript
+   * // Generate diagram
+   * const diagram = await rainfall.utils.mermaid({
+   *   diagram: 'graph TD; A-->B;'
+   * });
+   * 
+   * // Convert document
+   * const pdf = await rainfall.utils.documentConvert({
+   *   document: markdownContent,
+   *   mimeType: 'text/markdown',
+   *   format: 'pdf'
+   * });
+   * 
+   * // Extract JSON from text
+   * const json = await rainfall.utils.jsonExtract({
+   *   text: 'Here is some data: {"key": "value"}'
+   * });
+   * ```
+   */
+  get utils() {
+    if (!this._utils) {
+      this._utils = createUtils(this.client);
+    }
+    return this._utils;
+  }
+  /**
+   * Get the underlying HTTP client for advanced usage
+   */
+  getClient() {
+    return this.client;
+  }
+  /**
+   * List all available tools
+   */
+  async listTools() {
+    return this.client.listTools();
+  }
+  /**
+   * Get schema for a specific tool
+   */
+  async getToolSchema(toolId) {
+    return this.client.getToolSchema(toolId);
+  }
+  /**
+   * Execute any tool by ID (low-level access)
+   */
+  async executeTool(toolId, params) {
+    return this.client.executeTool(toolId, params);
+  }
+  /**
+   * Get current subscriber info and usage
+   */
+  async getMe() {
+    return this.client.getMe();
+  }
+  /**
+   * Get current rate limit info
+   */
+  getRateLimitInfo() {
+    return this.client.getRateLimitInfo();
+  }
+};
+
+// src/cli/index.ts
+var CONFIG_DIR = (0, import_path.join)((0, import_os.homedir)(), ".rainfall");
+var CONFIG_FILE = (0, import_path.join)(CONFIG_DIR, "config.json");
+function loadConfig() {
+  if (!(0, import_fs.existsSync)(CONFIG_FILE)) {
+    return {};
+  }
+  try {
+    return JSON.parse((0, import_fs.readFileSync)(CONFIG_FILE, "utf8"));
+  } catch {
+    return {};
+  }
+}
+function saveConfig(config) {
+  if (!(0, import_fs.existsSync)(CONFIG_DIR)) {
+    (0, import_fs.mkdirSync)(CONFIG_DIR, { recursive: true });
+  }
+  (0, import_fs.writeFileSync)(CONFIG_FILE, JSON.stringify(config, null, 2));
+}
+function getRainfall() {
+  const config = loadConfig();
+  if (!config.apiKey) {
+    console.error("Error: No API key configured. Run: rainfall auth login");
+    process.exit(1);
+  }
+  return new Rainfall({
+    apiKey: config.apiKey,
+    baseUrl: config.baseUrl
+  });
+}
+function printHelp() {
+  console.log(`
+Rainfall CLI - 200+ tools, one key
+
+Usage:
+  rainfall <command> [options]
+
+Commands:
+  auth login                    Store API key
+  auth logout                   Remove stored API key
+  auth status                   Check authentication status
+  
+  tools list                    List all available tools
+  tools describe <tool>         Show tool schema and description
+  tools search <query>          Search for tools
+  
+  run <tool> [options]          Execute a tool
+  
+  me                            Show account info and usage
+  
+  config get [key]              Get configuration value
+  config set <key> <value>      Set configuration value
+  
+  help                          Show this help message
+
+Options for 'run':
+  --params, -p <json>           Tool parameters as JSON
+  --file, -f <path>             Read parameters from file
+  --raw                         Output raw JSON
+
+Examples:
+  rainfall auth login
+  rainfall tools list
+  rainfall tools describe github-create-issue
+  rainfall run exa-web-search -p '{"query": "AI news"}'
+  rainfall run article-summarize -f ./article.json
+  echo '{"query": "hello"}' | rainfall run exa-web-search
+`);
+}
+async function authLogin(args) {
+  const apiKey = args[0] || process.env.RAINFALL_API_KEY;
+  if (!apiKey) {
+    console.error("Error: API key required. Provide as argument or set RAINFALL_API_KEY environment variable.");
+    console.error("\nUsage: rainfall auth login <api-key>");
+    process.exit(1);
+  }
+  try {
+    const rainfall = new Rainfall({ apiKey });
+    const me = await rainfall.getMe();
+    saveConfig({ apiKey });
+    console.log(`\u2713 Authenticated as ${me.email}`);
+    console.log(`  Plan: ${me.plan}`);
+    console.log(`  Usage: ${me.usage.callsThisMonth.toLocaleString()} / ${me.usage.callsLimit.toLocaleString()} calls this month`);
+  } catch (error) {
+    console.error("Error: Invalid API key");
+    process.exit(1);
+  }
+}
+function authLogout() {
+  saveConfig({});
+  console.log("\u2713 Logged out");
+}
+async function authStatus() {
+  const config = loadConfig();
+  if (!config.apiKey) {
+    console.log("Not authenticated");
+    console.log("Run: rainfall auth login <api-key>");
+    return;
+  }
+  try {
+    const rainfall = new Rainfall({ apiKey: config.apiKey });
+    const me = await rainfall.getMe();
+    console.log(`Authenticated as ${me.email}`);
+    console.log(`Plan: ${me.plan}`);
+    console.log(`Usage: ${me.usage.callsThisMonth.toLocaleString()} / ${me.usage.callsLimit.toLocaleString()} calls this month`);
+  } catch (error) {
+    console.log("Authentication expired or invalid");
+    console.log("Run: rainfall auth login <api-key>");
+  }
+}
+async function listTools() {
+  const rainfall = getRainfall();
+  const tools = await rainfall.listTools();
+  const byCategory = /* @__PURE__ */ new Map();
+  for (const tool of tools) {
+    const category = tool.category || "uncategorized";
+    if (!byCategory.has(category)) {
+      byCategory.set(category, []);
+    }
+    byCategory.get(category).push(tool);
+  }
+  console.log(`Available tools (${tools.length} total):
+`);
+  for (const [category, categoryTools] of byCategory) {
+    console.log(`${category}:`);
+    for (const tool of categoryTools) {
+      console.log(`  ${tool.id.padEnd(30)} ${tool.description.slice(0, 50)}${tool.description.length > 50 ? "..." : ""}`);
+    }
+    console.log();
+  }
+}
+async function describeTool(args) {
+  const toolId = args[0];
+  if (!toolId) {
+    console.error("Error: Tool ID required");
+    console.error("\nUsage: rainfall tools describe <tool-id>");
+    process.exit(1);
+  }
+  const rainfall = getRainfall();
+  try {
+    const schema = await rainfall.getToolSchema(toolId);
+    console.log(`Tool: ${schema.name}`);
+    console.log(`Description: ${schema.description}`);
+    console.log(`Category: ${schema.category}`);
+    console.log(`
+Parameters:`);
+    console.log(JSON.stringify(schema.parameters, null, 2));
+    console.log(`
+Output:`);
+    console.log(JSON.stringify(schema.output, null, 2));
+  } catch (error) {
+    console.error(`Error: Tool '${toolId}' not found`);
+    process.exit(1);
+  }
+}
+async function searchTools(args) {
+  const query = args[0];
+  if (!query) {
+    console.error("Error: Search query required");
+    console.error("\nUsage: rainfall tools search <query>");
+    process.exit(1);
+  }
+  const rainfall = getRainfall();
+  const tools = await rainfall.listTools();
+  const lowerQuery = query.toLowerCase();
+  const matches = tools.filter(
+    (t) => t.id.toLowerCase().includes(lowerQuery) || t.description.toLowerCase().includes(lowerQuery) || t.category.toLowerCase().includes(lowerQuery)
+  );
+  if (matches.length === 0) {
+    console.log(`No tools found matching '${query}'`);
+    return;
+  }
+  console.log(`Found ${matches.length} tool(s) matching '${query}':
+`);
+  for (const tool of matches) {
+    console.log(`  ${tool.id.padEnd(30)} ${tool.description.slice(0, 50)}${tool.description.length > 50 ? "..." : ""}`);
+  }
+}
+async function runTool(args) {
+  const toolId = args[0];
+  if (!toolId) {
+    console.error("Error: Tool ID required");
+    console.error("\nUsage: rainfall run <tool-id> [options]");
+    process.exit(1);
+  }
+  let params = {};
+  for (let i = 1; i < args.length; i++) {
+    const arg = args[i];
+    if (arg === "--params" || arg === "-p") {
+      const json = args[++i];
+      if (!json) {
+        console.error("Error: --params requires a JSON string");
+        process.exit(1);
+      }
+      try {
+        params = JSON.parse(json);
+      } catch {
+        console.error("Error: Invalid JSON for --params");
+        process.exit(1);
+      }
+    } else if (arg === "--file" || arg === "-f") {
+      const filePath = args[++i];
+      if (!filePath) {
+        console.error("Error: --file requires a file path");
+        process.exit(1);
+      }
+      try {
+        params = JSON.parse((0, import_fs.readFileSync)(filePath, "utf8"));
+      } catch {
+        console.error(`Error: Could not read or parse file: ${filePath}`);
+        process.exit(1);
+      }
+    } else if (arg === "--raw") {
+    }
+  }
+  if (!process.stdin.isTTY) {
+    const chunks = [];
+    for await (const chunk of process.stdin) {
+      chunks.push(chunk);
+    }
+    if (chunks.length > 0) {
+      try {
+        const piped = JSON.parse(Buffer.concat(chunks).toString());
+        params = { ...params, ...piped };
+      } catch {
+      }
+    }
+  }
+  const rainfall = getRainfall();
+  try {
+    const result = await rainfall.executeTool(toolId, params);
+    if (args.includes("--raw")) {
+      console.log(JSON.stringify(result));
+    } else {
+      console.log(JSON.stringify(result, null, 2));
+    }
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(`Error: ${message}`);
+    process.exit(1);
+  }
+}
+async function showMe() {
+  const rainfall = getRainfall();
+  const me = await rainfall.getMe();
+  console.log(`Account: ${me.email}`);
+  console.log(`ID: ${me.id}`);
+  console.log(`Plan: ${me.plan}`);
+  console.log(`Usage: ${me.usage.callsThisMonth.toLocaleString()} / ${me.usage.callsLimit.toLocaleString()} calls this month`);
+  console.log(`Remaining: ${(me.usage.callsLimit - me.usage.callsThisMonth).toLocaleString()} calls`);
+}
+function configGet(args) {
+  const key = args[0];
+  const config = loadConfig();
+  if (key) {
+    console.log(config[key] || "");
+  } else {
+    console.log(JSON.stringify(config, null, 2));
+  }
+}
+function configSet(args) {
+  const key = args[0];
+  const value = args[1];
+  if (!key || !value) {
+    console.error("Error: Both key and value required");
+    console.error("\nUsage: rainfall config set <key> <value>");
+    process.exit(1);
+  }
+  const config = loadConfig();
+  config[key] = value;
+  saveConfig(config);
+  console.log(`\u2713 Set ${key} = ${value}`);
+}
+async function main() {
+  const args = process.argv.slice(2);
+  const command = args[0];
+  const subcommand = args[1];
+  const rest = args.slice(2);
+  switch (command) {
+    case "auth":
+      switch (subcommand) {
+        case "login":
+          await authLogin(rest);
+          break;
+        case "logout":
+          authLogout();
+          break;
+        case "status":
+          await authStatus();
+          break;
+        default:
+          console.error("Error: Unknown auth subcommand");
+          console.error("\nUsage: rainfall auth <login|logout|status>");
+          process.exit(1);
+      }
+      break;
+    case "tools":
+      switch (subcommand) {
+        case "list":
+          await listTools();
+          break;
+        case "describe":
+          await describeTool(rest);
+          break;
+        case "search":
+          await searchTools(rest);
+          break;
+        default:
+          console.error("Error: Unknown tools subcommand");
+          console.error("\nUsage: rainfall tools <list|describe|search>");
+          process.exit(1);
+      }
+      break;
+    case "run":
+      await runTool(rest);
+      break;
+    case "me":
+      await showMe();
+      break;
+    case "config":
+      switch (subcommand) {
+        case "get":
+          configGet(rest);
+          break;
+        case "set":
+          configSet(rest);
+          break;
+        default:
+          console.error("Error: Unknown config subcommand");
+          console.error("\nUsage: rainfall config <get|set>");
+          process.exit(1);
+      }
+      break;
+    case "help":
+    case "--help":
+    case "-h":
+    case void 0:
+      printHelp();
+      break;
+    default:
+      console.error(`Error: Unknown command '${command}'`);
+      console.error("\nRun `rainfall help` for usage information.");
+      process.exit(1);
+  }
+}
+main().catch((error) => {
+  console.error("Unexpected error:", error);
+  process.exit(1);
+});