@realtimex/sdk 1.0.4

package/README.md

@@ -0,0 +1,144 @@
+# RealtimeX Local App SDK
+
+TypeScript/JavaScript SDK for building Local Apps that integrate with RealtimeX.
+
+## Installation
+
+```bash
+npm install @realtimex/sdk
+```
+
+## Prerequisites
+
+Before using this SDK, ensure your Supabase database is set up:
+
+1. Open **RealtimeX Main App** → **Local Apps** → Your App → **Configure**
+2. Enter your Supabase **URL** and **Anon Key**
+3. Select **Compatible Mode** and click **Login to Supabase**
+4. Click **Auto-Setup Schema** to create the required tables and functions
+
+> **Note:** Schema setup is handled entirely by the Main App. You don't need to run any SQL manually.
+
+## Quick Start
+
+```typescript
+import { RealtimeXSDK } from '@realtimex/sdk';
+
+// No config needed - RTX_APP_ID is auto-detected from environment
+const sdk = new RealtimeXSDK();
+
+// Insert activity
+const activity = await sdk.activities.insert({
+  type: 'new_lead',
+  email: 'user@example.com',
+});
+
+// Trigger agent (optional - for auto-processing)
+await sdk.webhook.triggerAgent({
+  raw_data: activity,
+  auto_run: true,
+  agent_name: 'processor',
+  workspace_slug: 'sales',
+  thread_slug: 'general', //create_new for new thread
+  prompt: 'Process this lead',//optional
+});
+```
+
+## How It Works
+
+When you start your Local App from the RealtimeX Main App:
+
+1. Environment variables `RTX_APP_ID` and `RTX_APP_NAME` are automatically set
+2. The SDK auto-detects these - no manual configuration needed
+3. All operations go through the Main App's proxy endpoints
+
+## Configuration (Optional)
+
+```typescript
+const sdk = new RealtimeXSDK({
+  realtimex: {
+    url: 'http://custom-host:3001',  // Default: localhost:3001
+    appId: 'custom-id',               // Override auto-detected
+    appName: 'My App',                // Override auto-detected
+  }
+});
+```
+
+## API Reference
+
+### Activities CRUD
+
+```typescript
+// Insert
+const activity = await sdk.activities.insert({ type: 'order', amount: 100 });
+
+// List
+const pending = await sdk.activities.list({ status: 'pending', limit: 50 });
+
+// Get
+const item = await sdk.activities.get('activity-uuid');
+
+// Update
+await sdk.activities.update('activity-uuid', { status: 'processed' });
+
+// Delete
+await sdk.activities.delete('activity-uuid');
+```
+
+### Webhook - Trigger Agent
+
+```typescript
+// Manual mode (creates calendar event only)
+await sdk.webhook.triggerAgent({
+  raw_data: { email: 'customer@example.com' },
+});
+
+// Auto-run mode (creates event and triggers agent immediately)
+await sdk.webhook.triggerAgent({
+  raw_data: activity,
+  auto_run: true,
+  agent_name: 'processor',
+  workspace_slug: 'sales',
+  thread_slug: 'optional-thread',  // Optional: specific thread
+});
+```
+
+### Public APIs
+
+```typescript
+// Get available agents in a workspace
+const agents = await sdk.api.getAgents();
+
+// Get all workspaces
+const workspaces = await sdk.api.getWorkspaces();
+
+// Get threads in a workspace
+const threads = await sdk.api.getThreads('sales');
+
+// Get task status
+const task = await sdk.api.getTask('task-uuid');
+```
+
+## Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `RTX_APP_ID` | Auto-set by Main App when starting your app |
+| `RTX_APP_NAME` | Auto-set by Main App when starting your app |
+
+## Architecture
+
+```
+┌─────────────────┐     ┌──────────────────┐     ┌─────────────┐
+│   Your App      │────▶│  RealtimeX Main  │────▶│  Supabase   │
+│   (SDK)         │     │  App (Proxy)     │     │  Database   │
+└─────────────────┘     └──────────────────┘     └─────────────┘
+```
+
+- Your app uses the SDK to communicate with the Main App
+- Main App proxies all database operations to Supabase
+- Schema is managed by Main App (no direct database access needed)
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,167 @@
+/**
+ * RealtimeX Local App SDK - Types
+ */
+interface SDKConfig {
+    realtimex?: {
+        url?: string;
+        appId?: string;
+        appName?: string;
+    };
+}
+interface Activity {
+    id: string;
+    raw_data: Record<string, unknown>;
+    old_data?: Record<string, unknown>;
+    status: 'pending' | 'claimed' | 'completed' | 'failed';
+    locked_by?: string;
+    locked_at?: string;
+    completed_at?: string;
+    error_message?: string;
+    result?: Record<string, unknown>;
+    created_at: string;
+}
+interface TriggerAgentPayload {
+    raw_data: Record<string, unknown>;
+    auto_run?: boolean;
+    agent_name?: string;
+    workspace_slug?: string;
+    thread_slug?: string;
+    prompt?: string;
+}
+interface TriggerAgentResponse {
+    success: boolean;
+    task_uuid?: string;
+    calendar_event_uuid?: string;
+    auto_run?: boolean;
+    message?: string;
+    error?: string;
+}
+interface Agent {
+    slug: string;
+    name: string;
+    description?: string;
+    hub_id?: string;
+}
+interface Workspace {
+    id: number;
+    slug: string;
+    name: string;
+    type: string;
+    created_at: string;
+}
+interface Thread {
+    id: number;
+    slug: string;
+    name: string;
+    created_at: string;
+}
+interface TaskRun {
+    id: number;
+    agent_name: string;
+    workspace_slug: string;
+    thread_slug?: string;
+    status: string;
+    started_at?: string;
+    completed_at?: string;
+    error?: string;
+}
+interface Task {
+    uuid: string;
+    title: string;
+    status: string;
+    action_type: string;
+    source_app: string;
+    error?: string;
+    created_at: string;
+    updated_at: string;
+    runs: TaskRun[];
+}
+
+/**
+ * Activities Module - HTTP Proxy to RealtimeX Main App
+ * No direct Supabase access - all operations go through Main App
+ */
+
+declare class ActivitiesModule {
+    private baseUrl;
+    private appId;
+    constructor(realtimexUrl: string, appId: string);
+    private request;
+    /**
+     * Insert a new activity
+     */
+    insert(rawData: Record<string, unknown>): Promise<Activity>;
+    /**
+     * Update an existing activity
+     */
+    update(id: string, updates: Partial<Activity>): Promise<Activity>;
+    /**
+     * Delete an activity
+     */
+    delete(id: string): Promise<void>;
+    /**
+     * Get a single activity by ID
+     */
+    get(id: string): Promise<Activity | null>;
+    /**
+     * List activities with optional filters
+     */
+    list(options?: {
+        status?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<Activity[]>;
+}
+
+/**
+ * Webhook Module - Call RealtimeX webhook
+ */
+
+declare class WebhookModule {
+    private realtimexUrl;
+    private appName?;
+    private appId?;
+    constructor(realtimexUrl: string, appName?: string, appId?: string);
+    triggerAgent(payload: TriggerAgentPayload): Promise<TriggerAgentResponse>;
+    ping(): Promise<{
+        success: boolean;
+        app_name: string;
+        message: string;
+    }>;
+}
+
+/**
+ * API Module - Call RealtimeX public APIs
+ */
+
+declare class ApiModule {
+    private realtimexUrl;
+    constructor(realtimexUrl: string);
+    getAgents(): Promise<Agent[]>;
+    getWorkspaces(): Promise<Workspace[]>;
+    getThreads(workspaceSlug: string): Promise<Thread[]>;
+    getTask(taskUuid: string): Promise<Task>;
+}
+
+/**
+ * RealtimeX Local App SDK
+ *
+ * SDK for building Local Apps that integrate with RealtimeX
+ * All operations go through RealtimeX Main App proxy
+ */
+
+declare class RealtimeXSDK {
+    activities: ActivitiesModule;
+    webhook: WebhookModule;
+    api: ApiModule;
+    readonly appId: string;
+    readonly appName: string | undefined;
+    private static DEFAULT_REALTIMEX_URL;
+    constructor(config?: SDKConfig);
+    /**
+     * Get environment variable (works in Node.js and browser)
+     */
+    private getEnvVar;
+}
+
+export { ActivitiesModule, type Activity, type Agent, ApiModule, RealtimeXSDK, type SDKConfig, type Task, type TaskRun, type Thread, type TriggerAgentPayload, type TriggerAgentResponse, WebhookModule, type Workspace };

package/dist/index.d.ts

@@ -0,0 +1,167 @@
+/**
+ * RealtimeX Local App SDK - Types
+ */
+interface SDKConfig {
+    realtimex?: {
+        url?: string;
+        appId?: string;
+        appName?: string;
+    };
+}
+interface Activity {
+    id: string;
+    raw_data: Record<string, unknown>;
+    old_data?: Record<string, unknown>;
+    status: 'pending' | 'claimed' | 'completed' | 'failed';
+    locked_by?: string;
+    locked_at?: string;
+    completed_at?: string;
+    error_message?: string;
+    result?: Record<string, unknown>;
+    created_at: string;
+}
+interface TriggerAgentPayload {
+    raw_data: Record<string, unknown>;
+    auto_run?: boolean;
+    agent_name?: string;
+    workspace_slug?: string;
+    thread_slug?: string;
+    prompt?: string;
+}
+interface TriggerAgentResponse {
+    success: boolean;
+    task_uuid?: string;
+    calendar_event_uuid?: string;
+    auto_run?: boolean;
+    message?: string;
+    error?: string;
+}
+interface Agent {
+    slug: string;
+    name: string;
+    description?: string;
+    hub_id?: string;
+}
+interface Workspace {
+    id: number;
+    slug: string;
+    name: string;
+    type: string;
+    created_at: string;
+}
+interface Thread {
+    id: number;
+    slug: string;
+    name: string;
+    created_at: string;
+}
+interface TaskRun {
+    id: number;
+    agent_name: string;
+    workspace_slug: string;
+    thread_slug?: string;
+    status: string;
+    started_at?: string;
+    completed_at?: string;
+    error?: string;
+}
+interface Task {
+    uuid: string;
+    title: string;
+    status: string;
+    action_type: string;
+    source_app: string;
+    error?: string;
+    created_at: string;
+    updated_at: string;
+    runs: TaskRun[];
+}
+
+/**
+ * Activities Module - HTTP Proxy to RealtimeX Main App
+ * No direct Supabase access - all operations go through Main App
+ */
+
+declare class ActivitiesModule {
+    private baseUrl;
+    private appId;
+    constructor(realtimexUrl: string, appId: string);
+    private request;
+    /**
+     * Insert a new activity
+     */
+    insert(rawData: Record<string, unknown>): Promise<Activity>;
+    /**
+     * Update an existing activity
+     */
+    update(id: string, updates: Partial<Activity>): Promise<Activity>;
+    /**
+     * Delete an activity
+     */
+    delete(id: string): Promise<void>;
+    /**
+     * Get a single activity by ID
+     */
+    get(id: string): Promise<Activity | null>;
+    /**
+     * List activities with optional filters
+     */
+    list(options?: {
+        status?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<Activity[]>;
+}
+
+/**
+ * Webhook Module - Call RealtimeX webhook
+ */
+
+declare class WebhookModule {
+    private realtimexUrl;
+    private appName?;
+    private appId?;
+    constructor(realtimexUrl: string, appName?: string, appId?: string);
+    triggerAgent(payload: TriggerAgentPayload): Promise<TriggerAgentResponse>;
+    ping(): Promise<{
+        success: boolean;
+        app_name: string;
+        message: string;
+    }>;
+}
+
+/**
+ * API Module - Call RealtimeX public APIs
+ */
+
+declare class ApiModule {
+    private realtimexUrl;
+    constructor(realtimexUrl: string);
+    getAgents(): Promise<Agent[]>;
+    getWorkspaces(): Promise<Workspace[]>;
+    getThreads(workspaceSlug: string): Promise<Thread[]>;
+    getTask(taskUuid: string): Promise<Task>;
+}
+
+/**
+ * RealtimeX Local App SDK
+ *
+ * SDK for building Local Apps that integrate with RealtimeX
+ * All operations go through RealtimeX Main App proxy
+ */
+
+declare class RealtimeXSDK {
+    activities: ActivitiesModule;
+    webhook: WebhookModule;
+    api: ApiModule;
+    readonly appId: string;
+    readonly appName: string | undefined;
+    private static DEFAULT_REALTIMEX_URL;
+    constructor(config?: SDKConfig);
+    /**
+     * Get environment variable (works in Node.js and browser)
+     */
+    private getEnvVar;
+}
+
+export { ActivitiesModule, type Activity, type Agent, ApiModule, RealtimeXSDK, type SDKConfig, type Task, type TaskRun, type Thread, type TriggerAgentPayload, type TriggerAgentResponse, WebhookModule, type Workspace };

package/dist/index.js

@@ -0,0 +1,223 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  ActivitiesModule: () => ActivitiesModule,
+  ApiModule: () => ApiModule,
+  RealtimeXSDK: () => RealtimeXSDK,
+  WebhookModule: () => WebhookModule
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/modules/activities.ts
+var ActivitiesModule = class {
+  constructor(realtimexUrl, appId) {
+    this.baseUrl = realtimexUrl.replace(/\/$/, "");
+    this.appId = appId;
+  }
+  async request(path, options = {}) {
+    const url = `${this.baseUrl}${path}`;
+    const headers = {
+      "Content-Type": "application/json"
+    };
+    if (this.appId) {
+      headers["X-App-Id"] = this.appId;
+    }
+    const response = await fetch(url, {
+      ...options,
+      headers: {
+        ...headers,
+        ...options.headers
+      }
+    });
+    const data = await response.json();
+    if (!response.ok) {
+      throw new Error(data.error || `Request failed: ${response.status}`);
+    }
+    return data;
+  }
+  /**
+   * Insert a new activity
+   */
+  async insert(rawData) {
+    const result = await this.request("/activities", {
+      method: "POST",
+      body: JSON.stringify({ raw_data: rawData })
+    });
+    return result.data;
+  }
+  /**
+   * Update an existing activity
+   */
+  async update(id, updates) {
+    const result = await this.request(`/activities/${id}`, {
+      method: "PATCH",
+      body: JSON.stringify(updates)
+    });
+    return result.data;
+  }
+  /**
+   * Delete an activity
+   */
+  async delete(id) {
+    await this.request(`/activities/${id}`, {
+      method: "DELETE"
+    });
+  }
+  /**
+   * Get a single activity by ID
+   */
+  async get(id) {
+    try {
+      const result = await this.request(`/activities/${id}`);
+      return result.data;
+    } catch (error) {
+      if (error.message?.includes("not found")) return null;
+      throw error;
+    }
+  }
+  /**
+   * List activities with optional filters
+   */
+  async list(options) {
+    const params = new URLSearchParams();
+    if (options?.status) params.set("status", options.status);
+    if (options?.limit) params.set("limit", String(options.limit));
+    if (options?.offset) params.set("offset", String(options.offset));
+    const query = params.toString() ? `?${params}` : "";
+    const result = await this.request(`/activities${query}`);
+    return result.data;
+  }
+};
+
+// src/modules/webhook.ts
+var WebhookModule = class {
+  constructor(realtimexUrl, appName, appId) {
+    this.realtimexUrl = realtimexUrl.replace(/\/$/, "");
+    this.appName = appName;
+    this.appId = appId;
+  }
+  async triggerAgent(payload) {
+    if (payload.auto_run && (!payload.agent_name || !payload.workspace_slug)) {
+      throw new Error("auto_run requires agent_name and workspace_slug");
+    }
+    const response = await fetch(`${this.realtimexUrl}/webhooks/realtimex`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        app_name: this.appName,
+        app_id: this.appId,
+        event: "trigger-agent",
+        payload: {
+          raw_data: payload.raw_data,
+          auto_run: payload.auto_run ?? false,
+          agent_name: payload.agent_name,
+          workspace_slug: payload.workspace_slug,
+          thread_slug: payload.thread_slug,
+          prompt: payload.prompt ?? ""
+        }
+      })
+    });
+    const data = await response.json();
+    if (!response.ok) throw new Error(data.error || "Failed to trigger agent");
+    return data;
+  }
+  async ping() {
+    const response = await fetch(`${this.realtimexUrl}/webhooks/realtimex`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        app_name: this.appName,
+        app_id: this.appId,
+        event: "ping"
+      })
+    });
+    const data = await response.json();
+    if (!response.ok) throw new Error(data.error || "Ping failed");
+    return data;
+  }
+};
+
+// src/modules/api.ts
+var ApiModule = class {
+  constructor(realtimexUrl) {
+    this.realtimexUrl = realtimexUrl.replace(/\/$/, "");
+  }
+  async getAgents() {
+    const response = await fetch(`${this.realtimexUrl}/agents`);
+    const data = await response.json();
+    if (!response.ok) throw new Error(data.error || "Failed to get agents");
+    return data.agents;
+  }
+  async getWorkspaces() {
+    const response = await fetch(`${this.realtimexUrl}/workspaces`);
+    const data = await response.json();
+    if (!response.ok) throw new Error(data.error || "Failed to get workspaces");
+    return data.workspaces;
+  }
+  async getThreads(workspaceSlug) {
+    const response = await fetch(`${this.realtimexUrl}/workspaces/${encodeURIComponent(workspaceSlug)}/threads`);
+    const data = await response.json();
+    if (!response.ok) throw new Error(data.error || "Failed to get threads");
+    return data.threads;
+  }
+  async getTask(taskUuid) {
+    const response = await fetch(`${this.realtimexUrl}/task/${encodeURIComponent(taskUuid)}`);
+    const data = await response.json();
+    if (!response.ok) throw new Error(data.error || "Failed to get task");
+    return { ...data.task, runs: data.runs };
+  }
+};
+
+// src/index.ts
+var _RealtimeXSDK = class _RealtimeXSDK {
+  constructor(config = {}) {
+    const envAppId = this.getEnvVar("RTX_APP_ID");
+    const envAppName = this.getEnvVar("RTX_APP_NAME");
+    this.appId = config.realtimex?.appId || envAppId || "";
+    this.appName = config.realtimex?.appName || envAppName;
+    const realtimexUrl = config.realtimex?.url || _RealtimeXSDK.DEFAULT_REALTIMEX_URL;
+    this.activities = new ActivitiesModule(realtimexUrl, this.appId);
+    this.webhook = new WebhookModule(realtimexUrl, this.appName, this.appId);
+    this.api = new ApiModule(realtimexUrl);
+  }
+  /**
+   * Get environment variable (works in Node.js and browser)
+   */
+  getEnvVar(name) {
+    if (typeof process !== "undefined" && process.env) {
+      return process.env[name];
+    }
+    if (typeof window !== "undefined") {
+      return window[name];
+    }
+    return void 0;
+  }
+};
+_RealtimeXSDK.DEFAULT_REALTIMEX_URL = "http://localhost:3001";
+var RealtimeXSDK = _RealtimeXSDK;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ActivitiesModule,
+  ApiModule,
+  RealtimeXSDK,
+  WebhookModule
+});

package/dist/index.mjs

@@ -0,0 +1,193 @@
+// src/modules/activities.ts
+var ActivitiesModule = class {
+  constructor(realtimexUrl, appId) {
+    this.baseUrl = realtimexUrl.replace(/\/$/, "");
+    this.appId = appId;
+  }
+  async request(path, options = {}) {
+    const url = `${this.baseUrl}${path}`;
+    const headers = {
+      "Content-Type": "application/json"
+    };
+    if (this.appId) {
+      headers["X-App-Id"] = this.appId;
+    }
+    const response = await fetch(url, {
+      ...options,
+      headers: {
+        ...headers,
+        ...options.headers
+      }
+    });
+    const data = await response.json();
+    if (!response.ok) {
+      throw new Error(data.error || `Request failed: ${response.status}`);
+    }
+    return data;
+  }
+  /**
+   * Insert a new activity
+   */
+  async insert(rawData) {
+    const result = await this.request("/activities", {
+      method: "POST",
+      body: JSON.stringify({ raw_data: rawData })
+    });
+    return result.data;
+  }
+  /**
+   * Update an existing activity
+   */
+  async update(id, updates) {
+    const result = await this.request(`/activities/${id}`, {
+      method: "PATCH",
+      body: JSON.stringify(updates)
+    });
+    return result.data;
+  }
+  /**
+   * Delete an activity
+   */
+  async delete(id) {
+    await this.request(`/activities/${id}`, {
+      method: "DELETE"
+    });
+  }
+  /**
+   * Get a single activity by ID
+   */
+  async get(id) {
+    try {
+      const result = await this.request(`/activities/${id}`);
+      return result.data;
+    } catch (error) {
+      if (error.message?.includes("not found")) return null;
+      throw error;
+    }
+  }
+  /**
+   * List activities with optional filters
+   */
+  async list(options) {
+    const params = new URLSearchParams();
+    if (options?.status) params.set("status", options.status);
+    if (options?.limit) params.set("limit", String(options.limit));
+    if (options?.offset) params.set("offset", String(options.offset));
+    const query = params.toString() ? `?${params}` : "";
+    const result = await this.request(`/activities${query}`);
+    return result.data;
+  }
+};
+
+// src/modules/webhook.ts
+var WebhookModule = class {
+  constructor(realtimexUrl, appName, appId) {
+    this.realtimexUrl = realtimexUrl.replace(/\/$/, "");
+    this.appName = appName;
+    this.appId = appId;
+  }
+  async triggerAgent(payload) {
+    if (payload.auto_run && (!payload.agent_name || !payload.workspace_slug)) {
+      throw new Error("auto_run requires agent_name and workspace_slug");
+    }
+    const response = await fetch(`${this.realtimexUrl}/webhooks/realtimex`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        app_name: this.appName,
+        app_id: this.appId,
+        event: "trigger-agent",
+        payload: {
+          raw_data: payload.raw_data,
+          auto_run: payload.auto_run ?? false,
+          agent_name: payload.agent_name,
+          workspace_slug: payload.workspace_slug,
+          thread_slug: payload.thread_slug,
+          prompt: payload.prompt ?? ""
+        }
+      })
+    });
+    const data = await response.json();
+    if (!response.ok) throw new Error(data.error || "Failed to trigger agent");
+    return data;
+  }
+  async ping() {
+    const response = await fetch(`${this.realtimexUrl}/webhooks/realtimex`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        app_name: this.appName,
+        app_id: this.appId,
+        event: "ping"
+      })
+    });
+    const data = await response.json();
+    if (!response.ok) throw new Error(data.error || "Ping failed");
+    return data;
+  }
+};
+
+// src/modules/api.ts
+var ApiModule = class {
+  constructor(realtimexUrl) {
+    this.realtimexUrl = realtimexUrl.replace(/\/$/, "");
+  }
+  async getAgents() {
+    const response = await fetch(`${this.realtimexUrl}/agents`);
+    const data = await response.json();
+    if (!response.ok) throw new Error(data.error || "Failed to get agents");
+    return data.agents;
+  }
+  async getWorkspaces() {
+    const response = await fetch(`${this.realtimexUrl}/workspaces`);
+    const data = await response.json();
+    if (!response.ok) throw new Error(data.error || "Failed to get workspaces");
+    return data.workspaces;
+  }
+  async getThreads(workspaceSlug) {
+    const response = await fetch(`${this.realtimexUrl}/workspaces/${encodeURIComponent(workspaceSlug)}/threads`);
+    const data = await response.json();
+    if (!response.ok) throw new Error(data.error || "Failed to get threads");
+    return data.threads;
+  }
+  async getTask(taskUuid) {
+    const response = await fetch(`${this.realtimexUrl}/task/${encodeURIComponent(taskUuid)}`);
+    const data = await response.json();
+    if (!response.ok) throw new Error(data.error || "Failed to get task");
+    return { ...data.task, runs: data.runs };
+  }
+};
+
+// src/index.ts
+var _RealtimeXSDK = class _RealtimeXSDK {
+  constructor(config = {}) {
+    const envAppId = this.getEnvVar("RTX_APP_ID");
+    const envAppName = this.getEnvVar("RTX_APP_NAME");
+    this.appId = config.realtimex?.appId || envAppId || "";
+    this.appName = config.realtimex?.appName || envAppName;
+    const realtimexUrl = config.realtimex?.url || _RealtimeXSDK.DEFAULT_REALTIMEX_URL;
+    this.activities = new ActivitiesModule(realtimexUrl, this.appId);
+    this.webhook = new WebhookModule(realtimexUrl, this.appName, this.appId);
+    this.api = new ApiModule(realtimexUrl);
+  }
+  /**
+   * Get environment variable (works in Node.js and browser)
+   */
+  getEnvVar(name) {
+    if (typeof process !== "undefined" && process.env) {
+      return process.env[name];
+    }
+    if (typeof window !== "undefined") {
+      return window[name];
+    }
+    return void 0;
+  }
+};
+_RealtimeXSDK.DEFAULT_REALTIMEX_URL = "http://localhost:3001";
+var RealtimeXSDK = _RealtimeXSDK;
+export {
+  ActivitiesModule,
+  ApiModule,
+  RealtimeXSDK,
+  WebhookModule
+};

package/package.json

@@ -0,0 +1,43 @@
+{
+    "name": "@realtimex/sdk",
+    "version": "1.0.4",
+    "description": "SDK for building Local Apps that integrate with RealtimeX",
+    "main": "dist/index.js",
+    "module": "dist/index.mjs",
+    "types": "dist/index.d.ts",
+    "exports": {
+        ".": {
+            "import": "./dist/index.mjs",
+            "require": "./dist/index.js",
+            "types": "./dist/index.d.ts"
+        }
+    },
+    "scripts": {
+        "build": "tsup src/index.ts --format cjs,esm --dts --clean",
+        "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
+        "test": "vitest run",
+        "prepublishOnly": "npm run build"
+    },
+    "keywords": [
+        "realtimex",
+        "local-apps",
+        "sdk",
+        "supabase"
+    ],
+    "author": "RealtimeX Team",
+    "license": "MIT",
+    "devDependencies": {
+        "@types/node": "^20.10.0",
+        "rollup": "^4.55.1",
+        "tsup": "^8.0.0",
+        "typescript": "^5.3.0",
+        "vitest": "^1.0.0"
+    },
+    "files": [
+        "dist",
+        "README.md"
+    ],
+    "engines": {
+        "node": ">=18.0.0"
+    }
+}