@centrali-io/centrali-sdk 3.1.0 → 3.1.2

package/dist/index.js

@@ -203,6 +203,13 @@ class RealtimeManager {
                 if (options.functionId) {
                     url.searchParams.set('functionId', options.functionId);
                 }
+                // Add orchestration filters
+                if (options.orchestrationId) {
+                    url.searchParams.set('orchestrationId', options.orchestrationId);
+                }
+                if (options.runId) {
+                    url.searchParams.set('runId', options.runId);
+                }
                 // Create EventSource (uses polyfill in Node.js)
                 eventSource = new EventSourceImpl(url.toString());
                 // Handle connection open

package/index.ts

@@ -38,11 +38,16 @@ export type AnomalyEventType = 'anomaly_insight_created' | 'anomaly_detection_co
  */
 export type ComputeEventType = 'function_run_completed' | 'function_run_failed';
 
+/**
+ * Orchestration run event types emitted by the realtime service.
+ */
+export type OrchestrationEventType = 'orchestration_run_started' | 'orchestration_run_completed' | 'orchestration_run_failed';
+
 /**
  * All event types emitted by the realtime service.
  * Matches: services/backend/realtime/internal/redis/message.go
  */
-export type RealtimeEventType = RecordEventType | ValidationEventType | AnomalyEventType | ComputeEventType;
+export type RealtimeEventType = RecordEventType | ValidationEventType | AnomalyEventType | ComputeEventType | OrchestrationEventType;
 
 /**
  * Record event payload from the realtime service.
@@ -304,6 +309,45 @@ export interface RealtimeFunctionRunEvent {
     timestamp: string;
 }
 
+/**
+ * Orchestration failure reason details.
+ */
+export interface OrchestrationFailureReason {
+    /** Error code (e.g., "STEP_EXECUTION_FAILED") */
+    code: string;
+    /** Human-readable error message */
+    message: string;
+    /** ID of the step that failed */
+    stepId?: string;
+}
+
+/**
+ * Orchestration run event payload from the realtime service.
+ * Matches: services/backend/realtime/internal/redis/message.go OrchestrationRunEvent
+ */
+export interface RealtimeOrchestrationRunEvent {
+    /** Event type */
+    event: OrchestrationEventType;
+    /** Workspace slug */
+    workspaceSlug: string;
+    /** Orchestration run ID */
+    runId: string;
+    /** Orchestration definition ID */
+    orchestrationId: string;
+    /** Orchestration name */
+    orchestrationName: string;
+    /** Trigger type: on-demand, event-driven, scheduled, http-trigger */
+    triggerType: 'on-demand' | 'event-driven' | 'scheduled' | 'http-trigger';
+    /** Outputs from completed steps (for completed/failed events) */
+    stepOutputs?: Record<string, unknown>;
+    /** Execution time in milliseconds (for completed/failed events) */
+    duration?: number;
+    /** Failure details (for failed events only) */
+    failureReason?: OrchestrationFailureReason;
+    /** ISO timestamp when the event occurred */
+    timestamp: string;
+}
+
 /**
  * Close event payload from the realtime service.
  */
@@ -317,7 +361,7 @@ export interface RealtimeCloseEvent {
 /**
  * Union type of all realtime events.
  */
-export type RealtimeEvent = RealtimeRecordEvent | RealtimeValidationSuggestionEvent | RealtimeValidationBatchEvent | RealtimeAnomalyInsightEvent | RealtimeAnomalyDetectionEvent | RealtimeFunctionRunEvent;
+export type RealtimeEvent = RealtimeRecordEvent | RealtimeValidationSuggestionEvent | RealtimeValidationBatchEvent | RealtimeAnomalyInsightEvent | RealtimeAnomalyDetectionEvent | RealtimeFunctionRunEvent | RealtimeOrchestrationRunEvent;
 
 /**
  * Error object for realtime connection errors.
@@ -347,6 +391,10 @@ export interface RealtimeSubscribeOptions {
     triggerType?: 'on-demand' | 'event-driven' | 'scheduled' | 'http-trigger';
     /** Filter compute events to a specific function ID */
     functionId?: string;
+    /** Filter orchestration events to a specific orchestration ID */
+    orchestrationId?: string;
+    /** Filter orchestration events to a specific run ID */
+    runId?: string;
     /** Callback for record events */
     onEvent: (event: RealtimeEvent) => void;
     /** Callback for errors */
@@ -503,7 +551,7 @@ export interface AuthorizationResult {
 /**
  * Trigger execution types supported by Centrali.
  */
-export type TriggerExecutionType = 'on-demand' | 'event-driven' | 'scheduled' | 'webhook';
+export type TriggerExecutionType = 'on-demand' | 'event-driven' | 'scheduled' | 'http-trigger';
 
 /**
  * Function trigger definition.
@@ -2152,6 +2200,14 @@ export class RealtimeManager {
                     url.searchParams.set('functionId', options.functionId);
                 }
 
+                // Add orchestration filters
+                if (options.orchestrationId) {
+                    url.searchParams.set('orchestrationId', options.orchestrationId);
+                }
+                if (options.runId) {
+                    url.searchParams.set('runId', options.runId);
+                }
+
                 // Create EventSource (uses polyfill in Node.js)
                 eventSource = new EventSourceImpl(url.toString());
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@centrali-io/centrali-sdk",
-  "version": "3.1.0",
+  "version": "3.1.2",
   "description": "Centrali Node SDK",
   "main": "dist/index.js",
   "type": "commonjs",