@realtimex/sdk 1.0.4 → 1.0.5

package/dist/index.d.mts

@@ -143,6 +143,36 @@ declare class ApiModule {
     getTask(taskUuid: string): Promise<Task>;
 }
 
+/**
+ * Task Module - Report task status to RealtimeX
+ * Used by external agents/processors to update task status
+ */
+interface TaskStatusResponse {
+    success: boolean;
+    task_uuid: string;
+    status: string;
+    message?: string;
+}
+declare class TaskModule {
+    private realtimexUrl;
+    private appName?;
+    private appId?;
+    constructor(realtimexUrl: string, appName?: string, appId?: string);
+    /**
+     * Mark task as processing
+     */
+    start(taskUuid: string, machineId?: string): Promise<TaskStatusResponse>;
+    /**
+     * Mark task as completed with result
+     */
+    complete(taskUuid: string, result?: object, machineId?: string): Promise<TaskStatusResponse>;
+    /**
+     * Mark task as failed with error
+     */
+    fail(taskUuid: string, error: string, machineId?: string): Promise<TaskStatusResponse>;
+    private _sendEvent;
+}
+
 /**
  * RealtimeX Local App SDK
  *
@@ -154,6 +184,7 @@ declare class RealtimeXSDK {
     activities: ActivitiesModule;
     webhook: WebhookModule;
     api: ApiModule;
+    task: TaskModule;
     readonly appId: string;
     readonly appName: string | undefined;
     private static DEFAULT_REALTIMEX_URL;
@@ -164,4 +195,4 @@ declare class RealtimeXSDK {
     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 };
+export { ActivitiesModule, type Activity, type Agent, ApiModule, RealtimeXSDK, type SDKConfig, type Task, TaskModule, type TaskRun, type Thread, type TriggerAgentPayload, type TriggerAgentResponse, WebhookModule, type Workspace };

package/dist/index.d.ts

@@ -143,6 +143,36 @@ declare class ApiModule {
     getTask(taskUuid: string): Promise<Task>;
 }
 
+/**
+ * Task Module - Report task status to RealtimeX
+ * Used by external agents/processors to update task status
+ */
+interface TaskStatusResponse {
+    success: boolean;
+    task_uuid: string;
+    status: string;
+    message?: string;
+}
+declare class TaskModule {
+    private realtimexUrl;
+    private appName?;
+    private appId?;
+    constructor(realtimexUrl: string, appName?: string, appId?: string);
+    /**
+     * Mark task as processing
+     */
+    start(taskUuid: string, machineId?: string): Promise<TaskStatusResponse>;
+    /**
+     * Mark task as completed with result
+     */
+    complete(taskUuid: string, result?: object, machineId?: string): Promise<TaskStatusResponse>;
+    /**
+     * Mark task as failed with error
+     */
+    fail(taskUuid: string, error: string, machineId?: string): Promise<TaskStatusResponse>;
+    private _sendEvent;
+}
+
 /**
  * RealtimeX Local App SDK
  *
@@ -154,6 +184,7 @@ declare class RealtimeXSDK {
     activities: ActivitiesModule;
     webhook: WebhookModule;
     api: ApiModule;
+    task: TaskModule;
     readonly appId: string;
     readonly appName: string | undefined;
     private static DEFAULT_REALTIMEX_URL;
@@ -164,4 +195,4 @@ declare class RealtimeXSDK {
     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 };
+export { ActivitiesModule, type Activity, type Agent, ApiModule, RealtimeXSDK, type SDKConfig, type Task, TaskModule, type TaskRun, type Thread, type TriggerAgentPayload, type TriggerAgentResponse, WebhookModule, type Workspace };

package/dist/index.js

@@ -23,6 +23,7 @@ __export(index_exports, {
   ActivitiesModule: () => ActivitiesModule,
   ApiModule: () => ApiModule,
   RealtimeXSDK: () => RealtimeXSDK,
+  TaskModule: () => TaskModule,
   WebhookModule: () => WebhookModule
 });
 module.exports = __toCommonJS(index_exports);
@@ -187,6 +188,51 @@ var ApiModule = class {
   }
 };
 
+// src/modules/task.ts
+var TaskModule = class {
+  constructor(realtimexUrl, appName, appId) {
+    this.realtimexUrl = realtimexUrl.replace(/\/$/, "");
+    this.appName = appName;
+    this.appId = appId;
+  }
+  /**
+   * Mark task as processing
+   */
+  async start(taskUuid, machineId) {
+    return this._sendEvent("task-start", taskUuid, { machine_id: machineId });
+  }
+  /**
+   * Mark task as completed with result
+   */
+  async complete(taskUuid, result, machineId) {
+    return this._sendEvent("task-complete", taskUuid, { result, machine_id: machineId });
+  }
+  /**
+   * Mark task as failed with error
+   */
+  async fail(taskUuid, error, machineId) {
+    return this._sendEvent("task-fail", taskUuid, { error, machine_id: machineId });
+  }
+  async _sendEvent(event, taskUuid, extra) {
+    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,
+        payload: {
+          task_uuid: taskUuid,
+          ...extra
+        }
+      })
+    });
+    const data = await response.json();
+    if (!response.ok) throw new Error(data.error || `Failed to ${event}`);
+    return data;
+  }
+};
+
 // src/index.ts
 var _RealtimeXSDK = class _RealtimeXSDK {
   constructor(config = {}) {
@@ -198,6 +244,7 @@ var _RealtimeXSDK = class _RealtimeXSDK {
     this.activities = new ActivitiesModule(realtimexUrl, this.appId);
     this.webhook = new WebhookModule(realtimexUrl, this.appName, this.appId);
     this.api = new ApiModule(realtimexUrl);
+    this.task = new TaskModule(realtimexUrl, this.appName, this.appId);
   }
   /**
    * Get environment variable (works in Node.js and browser)
@@ -219,5 +266,6 @@ var RealtimeXSDK = _RealtimeXSDK;
   ActivitiesModule,
   ApiModule,
   RealtimeXSDK,
+  TaskModule,
   WebhookModule
 });

package/dist/index.mjs

@@ -158,6 +158,51 @@ var ApiModule = class {
   }
 };
 
+// src/modules/task.ts
+var TaskModule = class {
+  constructor(realtimexUrl, appName, appId) {
+    this.realtimexUrl = realtimexUrl.replace(/\/$/, "");
+    this.appName = appName;
+    this.appId = appId;
+  }
+  /**
+   * Mark task as processing
+   */
+  async start(taskUuid, machineId) {
+    return this._sendEvent("task-start", taskUuid, { machine_id: machineId });
+  }
+  /**
+   * Mark task as completed with result
+   */
+  async complete(taskUuid, result, machineId) {
+    return this._sendEvent("task-complete", taskUuid, { result, machine_id: machineId });
+  }
+  /**
+   * Mark task as failed with error
+   */
+  async fail(taskUuid, error, machineId) {
+    return this._sendEvent("task-fail", taskUuid, { error, machine_id: machineId });
+  }
+  async _sendEvent(event, taskUuid, extra) {
+    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,
+        payload: {
+          task_uuid: taskUuid,
+          ...extra
+        }
+      })
+    });
+    const data = await response.json();
+    if (!response.ok) throw new Error(data.error || `Failed to ${event}`);
+    return data;
+  }
+};
+
 // src/index.ts
 var _RealtimeXSDK = class _RealtimeXSDK {
   constructor(config = {}) {
@@ -169,6 +214,7 @@ var _RealtimeXSDK = class _RealtimeXSDK {
     this.activities = new ActivitiesModule(realtimexUrl, this.appId);
     this.webhook = new WebhookModule(realtimexUrl, this.appName, this.appId);
     this.api = new ApiModule(realtimexUrl);
+    this.task = new TaskModule(realtimexUrl, this.appName, this.appId);
   }
   /**
    * Get environment variable (works in Node.js and browser)
@@ -189,5 +235,6 @@ export {
   ActivitiesModule,
   ApiModule,
   RealtimeXSDK,
+  TaskModule,
   WebhookModule
 };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@realtimex/sdk",
-    "version": "1.0.4",
+    "version": "1.0.5",
     "description": "SDK for building Local Apps that integrate with RealtimeX",
     "main": "dist/index.js",
     "module": "dist/index.mjs",