orchestrator-client 5.6.0 → 5.7.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.cts CHANGED
@@ -57,6 +57,10 @@ interface TaskCreateResponse {
57
57
  interface TaskCancelResponse {
58
58
  taskId: string;
59
59
  killed: boolean;
60
+ via: "local" | "remote" | "none" | "fallback";
61
+ holderId?: string;
62
+ reason?: string;
63
+ message: string;
60
64
  }
61
65
  interface VSATaskCreateResponse extends TaskCreateResponse {
62
66
  }
@@ -170,6 +174,10 @@ interface ErrorCountResult {
170
174
  interface ErrorPurgeResult {
171
175
  deleted: number;
172
176
  }
177
+ interface ErrorEventListResult {
178
+ items: ErrorEventDetail[];
179
+ pagination: Pagination$1;
180
+ }
173
181
 
174
182
  interface HealthStatus {
175
183
  status: string;
@@ -317,10 +325,30 @@ interface ConfigurationStatus {
317
325
  orchestratorModel: string | null;
318
326
  summaryModel: string | null;
319
327
  translateModel: string | null;
328
+ llmBackendsCount: number;
329
+ mcpServersCount: number;
330
+ totalTasks: number;
331
+ queuedTasks: number;
332
+ activeTasks: number;
333
+ pendingApprovalTasks: number;
334
+ subagentsEnabled: boolean;
320
335
  localizationTargets: Record<string, string>[];
321
- llmbackends: LLMBackendInfo[];
322
- mcpservers: MCPServerInfo[];
323
- builtinTools: string[];
336
+ }
337
+ interface SubagentsStatus {
338
+ subagentsEnabled: boolean;
339
+ }
340
+ interface ReloadServicesResult {
341
+ timestamp: string;
342
+ llmBackends: Record<string, unknown>;
343
+ mcpServers: Record<string, unknown>;
344
+ slotManager: Record<string, unknown>;
345
+ nextScheduledReload?: string;
346
+ }
347
+ interface ReloadStatus {
348
+ enabled: boolean;
349
+ intervalHours: number | null;
350
+ lastReload?: string;
351
+ nextScheduledReload?: string;
324
352
  }
325
353
 
326
354
  interface ToolInfo {
@@ -333,6 +361,35 @@ interface ToolsListResult {
333
361
  totalTools: number;
334
362
  servers: string[];
335
363
  }
364
+ interface ToolCatalogEntry {
365
+ name: string;
366
+ description: string;
367
+ provenanceKind: string;
368
+ provenanceServer?: string;
369
+ category: string;
370
+ tags: string[];
371
+ workflowIds?: string[];
372
+ dangerous: boolean;
373
+ hasFragment: boolean;
374
+ }
375
+ interface ToolCatalogResult {
376
+ tools: ToolCatalogEntry[];
377
+ totalTools: number;
378
+ providers: string[];
379
+ }
380
+ interface MCPRefreshResult {
381
+ results: Record<string, unknown>;
382
+ totalRefreshed: number;
383
+ }
384
+ interface CatalogValidationIssue {
385
+ toolName: string;
386
+ issueType: string;
387
+ detail: string;
388
+ }
389
+ interface CatalogValidationResult {
390
+ issues: CatalogValidationIssue[];
391
+ totalIssues: number;
392
+ }
336
393
 
337
394
  interface CompactionEvent {
338
395
  id: number;
@@ -375,12 +432,13 @@ interface AuthConfig {
375
432
  }
376
433
  interface WebSocketClientInfo {
377
434
  clientId: string;
378
- subscription: Record<string, unknown>;
379
- connected: boolean;
435
+ connectedAt: string;
380
436
  }
381
437
  interface WebSocketStatus {
382
438
  connectedClients: number;
383
439
  clients: WebSocketClientInfo[];
440
+ eventListenerHealthy: boolean;
441
+ lastEventTime?: string;
384
442
  }
385
443
 
386
444
  interface SuccessResponse {
@@ -388,11 +446,34 @@ interface SuccessResponse {
388
446
  }
389
447
  interface MioContext {
390
448
  taskId: string;
449
+ modelId: string;
391
450
  currentTokens: number;
392
451
  contextLimit: number;
393
452
  usagePercentage: number;
394
- archivedCount: number;
395
- activeCount: number;
453
+ totalMessages: number;
454
+ activeMessages: number;
455
+ archivedMessages: number;
456
+ messagesWithoutTokenCount: number;
457
+ }
458
+ interface MioMemoryItem {
459
+ id: string;
460
+ taskId: string | null;
461
+ title: string;
462
+ content: string;
463
+ tags: string[];
464
+ linkedTaskId: string | null;
465
+ createdAt: string;
466
+ updatedAt: string;
467
+ }
468
+ interface MioMemoriesResult {
469
+ memories: MioMemoryItem[];
470
+ total: number;
471
+ }
472
+ interface MessageDeleteMultipleResult {
473
+ deletedIds: number[];
474
+ failedIds: number[];
475
+ totalDeleted: number;
476
+ totalFailed: number;
396
477
  }
397
478
  interface WorkflowStates {
398
479
  validStates: Record<string, string[]>;
@@ -476,98 +557,135 @@ declare class OrchestratorAsync {
476
557
  protected _put<T>(path: string, body?: unknown): Promise<T>;
477
558
  protected _delete<T>(path: string): Promise<T>;
478
559
  listTasks(params?: {
479
- workflowId?: string;
480
- status?: string;
560
+ page?: number;
481
561
  limit?: number;
482
- offset?: number;
483
- sortBy?: string;
484
- sortOrder?: string;
562
+ orderBy?: string;
563
+ orderDirection?: string;
564
+ workflowId?: string;
565
+ locale?: string;
485
566
  }): Promise<TaskListResult>;
486
567
  createTask(params: {
487
568
  workflowId: string;
488
569
  goalPrompt: string;
489
570
  maxIterations?: number;
490
- options?: Record<string, boolean>;
571
+ reasoningEffort?: string;
572
+ systemPrompt?: string;
573
+ developerPrompt?: string;
491
574
  ticketId?: string;
492
- title?: string;
493
- modelId?: string;
575
+ ticketText?: string;
576
+ summary?: string;
577
+ problemSummary?: string;
578
+ solutionStrategy?: string;
579
+ agentModelId?: string;
580
+ orchestratorModelId?: string;
581
+ availableTools?: string[];
582
+ attachmentIds?: string[];
583
+ options?: Record<string, boolean>;
494
584
  }): Promise<TaskCreateResponse>;
495
- getTaskStatus(taskId: string): Promise<TaskDetail>;
496
- getTaskConversation(taskId: string): Promise<ConversationResult>;
585
+ getTaskStatus(taskId: string, locale?: string): Promise<TaskDetail>;
586
+ setTaskStatus(taskId: string, status: string): Promise<SuccessResponse>;
587
+ getTaskConversation(taskId: string, params?: {
588
+ includeSummaries?: boolean;
589
+ excludeArchived?: boolean;
590
+ locale?: string;
591
+ }): Promise<ConversationResult>;
497
592
  getArchivedMessageContent(taskId: string, messageId: number): Promise<Record<string, unknown>>;
498
593
  getTaskCompactions(taskId: string): Promise<CompactionEvent[]>;
499
594
  getTaskJournal(taskId: string): Promise<TaskJournal>;
500
- cancelTask(taskId: string): Promise<SuccessResponse>;
595
+ cancelTask(taskId: string): Promise<TaskCancelResponse>;
501
596
  deleteTask(taskId: string): Promise<TaskDeleteResult>;
502
597
  deleteTasks(taskIds: string[]): Promise<TaskDeleteResult>;
503
- uploadAttachment(taskId: string, file: File | Blob, filename?: string): Promise<AttachmentUploadResponse>;
504
- downloadAttachment(taskId: string, attachmentId: string): Promise<Blob>;
505
- sendInteractiveMessage(taskId: string, content: string): Promise<SuccessResponse>;
598
+ uploadAttachment(file: File | Blob, filename?: string): Promise<AttachmentUploadResponse>;
599
+ downloadAttachment(attachmentId: string): Promise<Blob>;
600
+ sendInteractiveMessage(taskId: string, message: string, attachmentIds?: string[]): Promise<SuccessResponse>;
506
601
  markInteractiveComplete(taskId: string): Promise<SuccessResponse>;
507
602
  markInteractiveFailed(taskId: string): Promise<SuccessResponse>;
508
- approveInteractiveAction(taskId: string): Promise<SuccessResponse>;
509
- sendProactiveGuide(taskId: string, guide: string): Promise<SuccessResponse>;
603
+ approveInteractiveAction(taskId: string, approved?: boolean): Promise<SuccessResponse>;
604
+ stopInteractive(taskId: string): Promise<SuccessResponse>;
605
+ sendProactiveGuide(taskId: string, message: string, attachmentIds?: string[]): Promise<SuccessResponse>;
510
606
  respondProactiveHelp(taskId: string, response: string): Promise<SuccessResponse>;
511
- approveProactiveAction(taskId: string): Promise<SuccessResponse>;
512
- sendTicketGuide(taskId: string, guide: string): Promise<SuccessResponse>;
607
+ approveProactiveAction(taskId: string, approved?: boolean): Promise<SuccessResponse>;
608
+ sendTicketGuide(taskId: string, message: string, attachmentIds?: string[]): Promise<SuccessResponse>;
513
609
  respondTicketHelp(taskId: string, response: string): Promise<SuccessResponse>;
514
- approveTicketAction(taskId: string): Promise<SuccessResponse>;
610
+ approveTicketAction(taskId: string, approved?: boolean): Promise<SuccessResponse>;
515
611
  wakeTicket(taskId: string): Promise<SuccessResponse>;
516
- sendMatrixMessage(taskId: string, content: string): Promise<SuccessResponse>;
612
+ sendMatrixMessage(taskId: string, message: string, attachmentIds?: string[]): Promise<SuccessResponse>;
517
613
  markMatrixComplete(taskId: string): Promise<SuccessResponse>;
518
614
  markMatrixFailed(taskId: string): Promise<SuccessResponse>;
519
- approveMatrixAction(taskId: string): Promise<SuccessResponse>;
520
- getMatrixConversation(taskId: string): Promise<MatrixConversationResult>;
615
+ approveMatrixAction(taskId: string, approved?: boolean): Promise<SuccessResponse>;
616
+ getMatrixConversation(taskId: string, phase?: number, includeSummaries?: boolean): Promise<MatrixConversationResult>;
521
617
  createVSATask(params: {
618
+ userId: string;
522
619
  goalPrompt: string;
523
620
  title?: string;
524
- modelId?: string;
621
+ agentModelId?: string;
622
+ orchestratorModelId?: string;
623
+ attachmentIds?: string[];
624
+ options?: Record<string, boolean>;
625
+ delegatedToken?: string;
525
626
  }): Promise<VSATaskCreateResponse>;
526
- sendVSAMessage(taskId: string, content: string): Promise<SuccessResponse>;
627
+ sendVSAMessage(taskId: string, message: string, options?: {
628
+ attachmentIds?: string[];
629
+ /** Short-lived AiDIT delegated token. When provided, overwrites the
630
+ * token stored for the task. Omitting leaves the existing token unchanged. */
631
+ delegatedToken?: string;
632
+ }): Promise<SuccessResponse>;
527
633
  renameVSATask(taskId: string, title: string): Promise<SuccessResponse>;
528
634
  regenerateVSATitle(taskId: string): Promise<SuccessResponse>;
529
635
  markVSAComplete(taskId: string): Promise<SuccessResponse>;
530
636
  markVSAFailed(taskId: string): Promise<SuccessResponse>;
531
637
  stopVSA(taskId: string): Promise<SuccessResponse>;
532
638
  deleteVSA(taskId: string): Promise<SuccessResponse>;
533
- listVSATasks(params?: {
534
- status?: string;
639
+ listVSATasks(userId: string, params?: {
535
640
  limit?: number;
536
641
  offset?: number;
537
642
  }): Promise<TaskListResult>;
538
- searchVSATasks(query: string): Promise<TaskListResult>;
539
- deleteVSATasksBulk(taskIds: string[]): Promise<SuccessResponse>;
540
- sendMioMessage(taskId: string, content: string): Promise<SuccessResponse>;
541
- approveMioAction(taskId: string): Promise<SuccessResponse>;
643
+ searchVSATasks(userId: string, query: string, limit?: number): Promise<TaskListResult>;
644
+ deleteVSATasksBulk(taskIds: string[]): Promise<TaskDeleteResult>;
645
+ sendMioMessage(taskId: string, message: string, attachmentIds?: string[]): Promise<SuccessResponse>;
646
+ approveMioAction(taskId: string, approved?: boolean, feedback?: string): Promise<SuccessResponse>;
542
647
  wakeMio(taskId: string): Promise<SuccessResponse>;
543
648
  sendMioUserAway(taskId: string): Promise<SuccessResponse>;
544
649
  markMioComplete(taskId: string): Promise<SuccessResponse>;
545
650
  markMioFailed(taskId: string): Promise<SuccessResponse>;
546
651
  archiveMio(taskId: string): Promise<SuccessResponse>;
547
652
  getMioContext(taskId: string): Promise<MioContext>;
653
+ getMioMemories(taskId: string, includeCommon?: boolean): Promise<MioMemoriesResult>;
548
654
  listTools(): Promise<ToolsListResult>;
655
+ getToolCatalog(): Promise<ToolCatalogResult>;
656
+ refreshMCPTools(): Promise<MCPRefreshResult>;
657
+ validateToolCatalog(): Promise<CatalogValidationResult>;
549
658
  getWorkflowStates(): Promise<WorkflowStates>;
550
659
  updateTaskModels(taskId: string, models: {
551
- agent?: string;
552
- orchestrator?: string;
660
+ agentModelId?: string;
661
+ orchestratorModelId?: string;
553
662
  }): Promise<SuccessResponse>;
554
- updateTaskIteration(taskId: string, iteration: number): Promise<SuccessResponse>;
663
+ updateTaskIteration(taskId: string, iteration?: number, maxIterations?: number): Promise<SuccessResponse>;
555
664
  updateTaskWorkflowData(taskId: string, workflowData: Record<string, unknown>): Promise<SuccessResponse>;
556
665
  deleteMessage(taskId: string, messageId: number): Promise<SuccessResponse>;
557
- deleteMessages(taskId: string, messageIds: number[]): Promise<SuccessResponse>;
666
+ deleteMessages(taskId: string, messageIds: number[]): Promise<MessageDeleteMultipleResult>;
558
667
  updateMessage(taskId: string, messageId: number, update: {
559
668
  content?: string;
560
669
  reasoning?: string;
561
670
  }): Promise<SuccessResponse>;
562
671
  resetMatrixToPhase(taskId: string, phase: number): Promise<SuccessResponse>;
563
- getMessageTranslations(taskId: string, messageId: number, locale?: string): Promise<MessageTranslationsResult>;
672
+ getMessageTranslations(taskId: string, messageId: number): Promise<MessageTranslationsResult>;
564
673
  listErrors(params?: {
565
- since?: string;
566
- severity?: string;
567
- source?: string;
674
+ page?: number;
568
675
  limit?: number;
569
- offset?: number;
570
- }): Promise<ErrorEventDetail[]>;
676
+ taskId?: string;
677
+ severity?: string[];
678
+ source?: string[];
679
+ workflowId?: string;
680
+ errorCode?: string;
681
+ exceptionType?: string;
682
+ holderId?: string;
683
+ requestId?: string;
684
+ search?: string;
685
+ since?: string;
686
+ until?: string;
687
+ orderDirection?: string;
688
+ }): Promise<ErrorEventListResult>;
571
689
  getErrorDetail(errorId: string): Promise<ErrorEventDetail>;
572
690
  getErrorStats(since?: string): Promise<ErrorStatsResult>;
573
691
  countErrors(since?: string): Promise<ErrorCountResult>;
@@ -596,6 +714,10 @@ declare class OrchestratorAsync {
596
714
  setTranslateModel(modelName: string): Promise<SuccessResponse>;
597
715
  getTokenWorkerStatus(): Promise<TokenWorkerStatus>;
598
716
  getSlotsStatus(): Promise<SlotsStatus>;
717
+ getSubagentsStatus(): Promise<SubagentsStatus>;
718
+ setSubagentsEnabled(enabled: boolean): Promise<SuccessResponse>;
719
+ reloadServices(): Promise<ReloadServicesResult>;
720
+ getReloadStatus(): Promise<ReloadStatus>;
599
721
  getAuthConfig(): Promise<AuthConfig>;
600
722
  getWebSocketStatus(): Promise<WebSocketStatus>;
601
723
  streamTaskStatus(taskId: string): AsyncGenerator<Record<string, unknown>>;
@@ -614,68 +736,77 @@ declare class Orchestrator {
614
736
  close(): void;
615
737
  listTasks(params?: Parameters<OrchestratorAsync["listTasks"]>[0]): TaskListResult;
616
738
  createTask(params: Parameters<OrchestratorAsync["createTask"]>[0]): TaskCreateResponse;
617
- getTaskStatus(taskId: string): TaskDetail;
618
- getTaskConversation(taskId: string): ConversationResult;
739
+ getTaskStatus(taskId: string, locale?: string): TaskDetail;
740
+ setTaskStatus(taskId: string, status: string): SuccessResponse;
741
+ getTaskConversation(taskId: string, params?: Parameters<OrchestratorAsync["getTaskConversation"]>[1]): ConversationResult;
619
742
  getArchivedMessageContent(taskId: string, messageId: number): Record<string, unknown>;
620
743
  getTaskCompactions(taskId: string): CompactionEvent[];
621
744
  getTaskJournal(taskId: string): TaskJournal;
622
- cancelTask(taskId: string): SuccessResponse;
745
+ cancelTask(taskId: string): TaskCancelResponse;
623
746
  deleteTask(taskId: string): TaskDeleteResult;
624
747
  deleteTasks(taskIds: string[]): TaskDeleteResult;
625
- uploadAttachment(taskId: string, file: File | Blob, filename?: string): AttachmentUploadResponse;
626
- downloadAttachment(taskId: string, attachmentId: string): Blob;
627
- sendInteractiveMessage(taskId: string, content: string): SuccessResponse;
748
+ uploadAttachment(file: File | Blob, filename?: string): AttachmentUploadResponse;
749
+ downloadAttachment(attachmentId: string): Blob;
750
+ sendInteractiveMessage(taskId: string, message: string, attachmentIds?: string[]): SuccessResponse;
628
751
  markInteractiveComplete(taskId: string): SuccessResponse;
629
752
  markInteractiveFailed(taskId: string): SuccessResponse;
630
- approveInteractiveAction(taskId: string): SuccessResponse;
631
- sendProactiveGuide(taskId: string, guide: string): SuccessResponse;
753
+ approveInteractiveAction(taskId: string, approved?: boolean): SuccessResponse;
754
+ stopInteractive(taskId: string): SuccessResponse;
755
+ sendProactiveGuide(taskId: string, message: string, attachmentIds?: string[]): SuccessResponse;
632
756
  respondProactiveHelp(taskId: string, response: string): SuccessResponse;
633
- approveProactiveAction(taskId: string): SuccessResponse;
634
- sendTicketGuide(taskId: string, guide: string): SuccessResponse;
757
+ approveProactiveAction(taskId: string, approved?: boolean): SuccessResponse;
758
+ sendTicketGuide(taskId: string, message: string, attachmentIds?: string[]): SuccessResponse;
635
759
  respondTicketHelp(taskId: string, response: string): SuccessResponse;
636
- approveTicketAction(taskId: string): SuccessResponse;
760
+ approveTicketAction(taskId: string, approved?: boolean): SuccessResponse;
637
761
  wakeTicket(taskId: string): SuccessResponse;
638
- sendMatrixMessage(taskId: string, content: string): SuccessResponse;
762
+ sendMatrixMessage(taskId: string, message: string, attachmentIds?: string[]): SuccessResponse;
639
763
  markMatrixComplete(taskId: string): SuccessResponse;
640
764
  markMatrixFailed(taskId: string): SuccessResponse;
641
- approveMatrixAction(taskId: string): SuccessResponse;
642
- getMatrixConversation(taskId: string): MatrixConversationResult;
765
+ approveMatrixAction(taskId: string, approved?: boolean): SuccessResponse;
766
+ getMatrixConversation(taskId: string, phase?: number, includeSummaries?: boolean): MatrixConversationResult;
643
767
  createVSATask(params: Parameters<OrchestratorAsync["createVSATask"]>[0]): VSATaskCreateResponse;
644
- sendVSAMessage(taskId: string, content: string): SuccessResponse;
768
+ sendVSAMessage(taskId: string, message: string, options?: {
769
+ attachmentIds?: string[];
770
+ delegatedToken?: string;
771
+ }): SuccessResponse;
645
772
  renameVSATask(taskId: string, title: string): SuccessResponse;
646
773
  regenerateVSATitle(taskId: string): SuccessResponse;
647
774
  markVSAComplete(taskId: string): SuccessResponse;
648
775
  markVSAFailed(taskId: string): SuccessResponse;
649
776
  stopVSA(taskId: string): SuccessResponse;
650
777
  deleteVSA(taskId: string): SuccessResponse;
651
- listVSATasks(params?: Parameters<OrchestratorAsync["listVSATasks"]>[0]): TaskListResult;
652
- searchVSATasks(query: string): TaskListResult;
653
- deleteVSATasksBulk(taskIds: string[]): SuccessResponse;
654
- sendMioMessage(taskId: string, content: string): SuccessResponse;
655
- approveMioAction(taskId: string): SuccessResponse;
778
+ listVSATasks(userId: string, params?: Parameters<OrchestratorAsync["listVSATasks"]>[1]): TaskListResult;
779
+ searchVSATasks(userId: string, query: string, limit?: number): TaskListResult;
780
+ deleteVSATasksBulk(taskIds: string[]): TaskDeleteResult;
781
+ sendMioMessage(taskId: string, message: string, attachmentIds?: string[]): SuccessResponse;
782
+ approveMioAction(taskId: string, approved?: boolean, feedback?: string): SuccessResponse;
656
783
  wakeMio(taskId: string): SuccessResponse;
657
784
  sendMioUserAway(taskId: string): SuccessResponse;
658
785
  markMioComplete(taskId: string): SuccessResponse;
659
786
  markMioFailed(taskId: string): SuccessResponse;
660
787
  archiveMio(taskId: string): SuccessResponse;
661
788
  getMioContext(taskId: string): MioContext;
789
+ getMioMemories(taskId: string, includeCommon?: boolean): MioMemoriesResult;
662
790
  listTools(): ToolsListResult;
791
+ getToolCatalog(): ToolCatalogResult;
792
+ refreshMCPTools(): MCPRefreshResult;
793
+ validateToolCatalog(): CatalogValidationResult;
663
794
  getWorkflowStates(): WorkflowStates;
664
795
  updateTaskModels(taskId: string, models: {
665
- agent?: string;
666
- orchestrator?: string;
796
+ agentModelId?: string;
797
+ orchestratorModelId?: string;
667
798
  }): SuccessResponse;
668
- updateTaskIteration(taskId: string, iteration: number): SuccessResponse;
799
+ updateTaskIteration(taskId: string, iteration?: number, maxIterations?: number): SuccessResponse;
669
800
  updateTaskWorkflowData(taskId: string, workflowData: Record<string, unknown>): SuccessResponse;
670
801
  deleteMessage(taskId: string, messageId: number): SuccessResponse;
671
- deleteMessages(taskId: string, messageIds: number[]): SuccessResponse;
802
+ deleteMessages(taskId: string, messageIds: number[]): MessageDeleteMultipleResult;
672
803
  updateMessage(taskId: string, messageId: number, update: {
673
804
  content?: string;
674
805
  reasoning?: string;
675
806
  }): SuccessResponse;
676
807
  resetMatrixToPhase(taskId: string, phase: number): SuccessResponse;
677
- getMessageTranslations(taskId: string, messageId: number, locale?: string): MessageTranslationsResult;
678
- listErrors(params?: Parameters<OrchestratorAsync["listErrors"]>[0]): ErrorEventDetail[];
808
+ getMessageTranslations(taskId: string, messageId: number): MessageTranslationsResult;
809
+ listErrors(params?: Parameters<OrchestratorAsync["listErrors"]>[0]): ErrorEventListResult;
679
810
  getErrorDetail(errorId: string): ErrorEventDetail;
680
811
  getErrorStats(since?: string): ErrorStatsResult;
681
812
  countErrors(since?: string): ErrorCountResult;
@@ -704,6 +835,10 @@ declare class Orchestrator {
704
835
  setTranslateModel(modelName: string): SuccessResponse;
705
836
  getTokenWorkerStatus(): TokenWorkerStatus;
706
837
  getSlotsStatus(): SlotsStatus;
838
+ getSubagentsStatus(): SubagentsStatus;
839
+ setSubagentsEnabled(enabled: boolean): SuccessResponse;
840
+ reloadServices(): ReloadServicesResult;
841
+ getReloadStatus(): ReloadStatus;
707
842
  getAuthConfig(): AuthConfig;
708
843
  getWebSocketStatus(): WebSocketStatus;
709
844
  streamTaskStatus(_taskId: string): Record<string, unknown>[];
@@ -795,8 +930,9 @@ interface RealtimeClientOptions {
795
930
  /**
796
931
  * Socket.IO-based realtime client for receiving orchestrator events.
797
932
  *
798
- * Requires the consumer to provide their own `socket.io-client` instance
799
- * to avoid version conflicts.
933
+ * The server wraps all domain events in a `message` Socket.IO event with an
934
+ * inner `event_type` field. This client unwraps the envelope and dispatches
935
+ * to registered handlers by event_type.
800
936
  */
801
937
  declare class RealtimeClient {
802
938
  private _baseUrl;
@@ -809,16 +945,60 @@ declare class RealtimeClient {
809
945
  get connected(): boolean;
810
946
  connect(): Promise<void>;
811
947
  disconnect(): Promise<void>;
948
+ /**
949
+ * Dispatch a message envelope to registered handlers.
950
+ * The server sends: socket.emit("message", {type: "message", event: {..., event_type: "...", ...}})
951
+ */
952
+ private _dispatch;
812
953
  /**
813
954
  * Subscribe to realtime events for a specific task.
955
+ * Emits a `join` event with `{rooms: ["task:{taskId}"]}`.
814
956
  */
815
- subscribeTask(taskId: string): Promise<void>;
957
+ subscribeTask(taskId: string): void;
816
958
  /**
817
959
  * Unsubscribe from realtime events for a specific task.
960
+ * Emits a `leave` event with `{rooms: ["task:{taskId}"]}`.
961
+ */
962
+ unsubscribeTask(taskId: string): void;
963
+ /**
964
+ * Subscribe to event-type-scoped rooms.
965
+ * e.g. subscribeEvents("task_created", "task_deleted")
818
966
  */
819
- unsubscribeTask(taskId: string): Promise<void>;
967
+ subscribeEvents(...eventTypes: string[]): void;
968
+ /**
969
+ * Unsubscribe from event-type-scoped rooms.
970
+ */
971
+ unsubscribeEvents(...eventTypes: string[]): void;
972
+ /**
973
+ * Subscribe to the `all` broadcast room (receives all events).
974
+ */
975
+ subscribeAll(): void;
976
+ /**
977
+ * Subscribe to a locale-specific room.
978
+ */
979
+ subscribeLocale(locale: string): void;
980
+ /**
981
+ * Unsubscribe from a locale-specific room.
982
+ */
983
+ unsubscribeLocale(locale: string): void;
984
+ /**
985
+ * Join arbitrary rooms by name.
986
+ */
987
+ joinRooms(rooms: string[]): void;
988
+ /**
989
+ * Leave arbitrary rooms by name.
990
+ */
991
+ leaveRooms(rooms: string[]): void;
992
+ /**
993
+ * Send a ping to the server.
994
+ */
995
+ ping(): void;
820
996
  /**
821
997
  * Register a handler for a specific event type.
998
+ *
999
+ * Domain events (task_created, task_status_changed, etc.) are dispatched
1000
+ * via the message envelope. Raw socket events (connect, disconnect,
1001
+ * connection_established, rooms_updated, pong) are wired directly.
822
1002
  */
823
1003
  on(event: string, handler: EventHandler): void;
824
1004
  /**