@memberjunction/ng-conversations 6.1.4 → 6.2.0-edge.1

package/dist/public-api.js

@@ -8,6 +8,9 @@ export * from './lib/models/conversation-state.model';
 export * from './lib/models/notification.model';
 export * from './lib/models/lazy-artifact-info';
 export * from './lib/models/navigation-request.model';
+// Host rules for an agent turn: reply mode, routes, and the host turn handler contract
+export * from './lib/models/agent-turn.model';
+export * from './lib/utils/agent-turn-routing';
 // Services - State
 export * from './lib/services/data-cache.service';
 export * from './lib/services/artifact-state.service';
@@ -29,14 +32,19 @@ export * from './lib/services/artifact-permission.service';
 export * from './lib/services/artifact-use-tracking.service';
 export * from './lib/services/collection-state.service';
 export * from './lib/services/conversation-attachment.service';
+export * from './lib/services/graphql-attachment-blob-store';
 export * from './lib/services/ui-command-handler.service';
 export * from './lib/services/conversation-bridge.service';
 export * from './lib/services/realtime-session.service';
+export * from './lib/services/browser-realtime-media-host';
+// NOTE: the realtime session types (RealtimeCaption, RealtimeConnectionState,
+// RealtimeSessionRunOptions, …), the channel plugin base class, and the delegation-result
+// parser now live in `@memberjunction/realtime-runtime`. Import them from there directly —
+// MJ does not re-export across package boundaries.
 export * from './lib/services/realtime-pairing';
 export * from './lib/services/user-authorization';
 export * from './lib/services/realtime-sessions-adapter';
 export * from './lib/services/realtime-session-review.service';
-export * from './lib/services/delegation-result-parser';
 // Components
 export * from './lib/components/workspace/conversation-workspace.component';
 export * from './lib/components/navigation/conversation-navigation.component';
@@ -136,7 +144,6 @@ export * from './lib/components/realtime/realtime-channel-strip.component';
 export * from './lib/components/realtime/realtime-session-timeline-card.component';
 export * from './lib/utils/realtime-session-timeline';
 // Pluggable interactive-channel contract (registry-resolved client plugins) + pane host
-export * from './lib/components/realtime/channels/base-realtime-channel-client';
 export * from './lib/components/realtime/channels/client-context-channel';
 export * from './lib/components/realtime/channels/realtime-channel-pane.component';
 export * from './lib/components/realtime/channels/channel-onboarding-panel.component';

package/dist/public-api.js.map

@@ -1 +1 @@
-{"version":3,"file":"public-api.js","sourceRoot":"","sources":["../src/public-api.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Public API Surface of @memberjunction/ng-conversations\n */\n\n// Module\nexport * from './lib/conversations.module';\n\n// Models\nexport * from './lib/models/conversation-state.model';\nexport * from './lib/models/notification.model';\nexport * from './lib/models/lazy-artifact-info';\nexport * from './lib/models/navigation-request.model';\n\n// Services - State\nexport * from './lib/services/data-cache.service';\nexport * from './lib/services/artifact-state.service';\nexport * from './lib/services/agent-state.service';\nexport * from './lib/services/conversation-agent.service';\nexport * from './lib/services/active-tasks.service';\nexport * from './lib/services/conversation-streaming.service';\nexport * from './lib/services/dialog.service';\nexport * from './lib/services/export.service';\nexport * from './lib/services/notification.service';\nexport * from './lib/services/toast.service';\nexport * from './lib/services/mention-parser.service';\n// AI-aware mention suggestion engine (BaseSingleton — use MentionAutocompleteService.Instance).\n// NOTE: the generic MentionSuggestion TYPE lives in @memberjunction/ng-composer — import it\n// from there directly (no re-exports between packages).\nexport * from './lib/services/mention-autocomplete.service';\nexport * from './lib/services/collection-permission.service';\nexport * from './lib/services/artifact-permission.service';\nexport * from './lib/services/artifact-use-tracking.service';\nexport * from './lib/services/collection-state.service';\nexport * from './lib/services/conversation-attachment.service';\nexport * from './lib/services/ui-command-handler.service';\nexport * from './lib/services/conversation-bridge.service';\nexport * from './lib/services/realtime-session.service';\nexport * from './lib/services/realtime-pairing';\nexport * from './lib/services/user-authorization';\nexport * from './lib/services/realtime-sessions-adapter';\nexport * from './lib/services/realtime-session-review.service';\nexport * from './lib/services/delegation-result-parser';\n\n// Components\nexport * from './lib/components/workspace/conversation-workspace.component';\nexport * from './lib/components/navigation/conversation-navigation.component';\nexport * from './lib/components/sidebar/conversation-sidebar.component';\nexport * from './lib/components/sidebar/routines-section.component';\nexport * from './lib/components/conversation/conversation-list.component';\nexport * from './lib/components/conversation/conversation-chat-area.component';\nexport * from './lib/components/conversation/conversation-empty-state.component';\nexport * from './lib/components/message/message-item.component';\nexport * from './lib/components/message/message-list.component';\nexport * from './lib/components/message/message-input.component';\n// AI-aware composer wrapper (mj-ai-composer): mj-message-input-box + the three AI trigger\n// plugins built in, proxying the input box's full inputs/outputs/methods surface.\nexport * from './lib/components/composer/ai-composer.component';\n// Composer trigger-provider plugins ('@' / '#' / '/') — ClassFactory-registered; also\n// directly instantiable for explicit provider lists.\nexport * from './lib/composer-plugins/base-conversation-mention.provider';\nexport * from './lib/composer-plugins/agent-mention.provider';\nexport * from './lib/composer-plugins/record-mention.provider';\nexport * from './lib/composer-plugins/skill-command.provider';\nexport * from './lib/composer-plugins/load-composer-plugins';\n// NOTE: MessageInputBoxComponent, MentionEditorComponent (+ PendingAttachment), and\n// MentionDropdownComponent live in @memberjunction/ng-composer — import from there directly.\nexport * from './lib/components/message/conversation-message-rating.component';\nexport * from './lib/components/collection/collection-tree.component';\nexport * from './lib/components/collection/collection-view.component';\nexport * from './lib/components/collection/collections-full-view.component';\nexport * from './lib/components/collection/collection-artifact-card.component';\nexport * from './lib/components/collection/artifact-collection-picker-modal.component';\nexport * from './lib/components/collection/collection-share-modal.component';\nexport * from './lib/components/artifact/artifact-share-modal.component';\nexport * from './lib/components/project/project-selector.component';\nexport * from './lib/components/project/project-form-modal.component';\nexport * from './lib/components/task/tasks-full-view.component';\nexport * from './lib/components/tasks/task-widget.component';\nexport * from './lib/components/agent/agent-process-panel.component';\nexport * from './lib/components/agent/active-agent-indicator.component';\nexport * from './lib/components/active-tasks/active-tasks-panel.component';\nexport * from './lib/components/share/share-modal.component';\nexport * from './lib/components/notification/notification-badge.component';\nexport * from './lib/components/notification/activity-indicator.component';\nexport * from './lib/components/toast/toast.component';\nexport * from './lib/components/global-tasks/global-tasks-panel.component';\nexport * from './lib/components/attachment/image-viewer.component';\nexport * from './lib/components/overlay/chat-overlay.component';\n\n// Components declared AND exported by ConversationsModule but previously missing\n// from public-api. They are used in the templates of exported components (e.g.\n// mj-conversation-chat-area), so a consumer app compiling in Angular's\n// local-compilation / HMR mode fails to build (NG3004: \"Unable to import\n// component … not exported from @memberjunction/ng-conversations\") unless every\n// module-exported component is importable from the package entry point.\nexport * from './lib/components/collection/artifact-create-modal.component';\nexport * from './lib/components/collection/collection-form-modal.component';\nexport * from './lib/components/conversation/conversation-agent-picker.component';\nexport * from './lib/components/conversation/conversation-mode-picker.component';\nexport * from './lib/components/conversation/pinned-messages-panel.component';\nexport * from './lib/components/dialogs/input-dialog.component';\nexport * from './lib/components/dialogs/rating-dialog.component';\nexport * from './lib/components/export/export-modal.component';\nexport * from './lib/components/library/library-full-view.component';\nexport * from './lib/components/members/members-modal.component';\nexport * from './lib/components/message/actionable-commands.component';\nexport * from './lib/components/message/workflow-plan-card.component';\nexport * from './lib/components/search/search-panel.component';\nexport * from './lib/components/shared/user-picker.component';\nexport * from './lib/components/tasks/tasks-dropdown.component';\nexport * from './lib/components/thread/thread-panel.component';\nexport * from './lib/directives/search-shortcut.directive';\n\n// PR 2c — Widget extension surface (slots, events, design tokens)\nexport * from './lib/services/conversations-runtime-bootstrap.service';\nexport * from './lib/directives/chat-slot.directive';\nexport * from './lib/components/slots/slot-interfaces';\nexport * from './lib/components/slots/mj-chat-empty-state-default.component';\nexport * from './lib/components/slots/mj-chat-agent-presence-default.component';\nexport * from './lib/components/slots/mj-chat-header-default.component';\nexport * from './lib/components/slots/mj-chat-message-extra-default.component';\nexport * from './lib/components/slots/mj-chat-demonstration-surface-default.component';\nexport * from './lib/components/slots/mj-chat-message-bubble-default.component';\nexport * from './lib/events/chat-events';\n\n// Realtime / voice (PR #2787 — co-agent realtime sessions)\nexport * from './lib/components/realtime/realtime-agent-picker.component';\n// Real-time \"call mode\" overlay + its componentized parts\nexport * from './lib/components/realtime/realtime-session-overlay.component';\nexport * from './lib/components/realtime/realtime-session-state';\nexport * from './lib/components/realtime/realtime-agent-banner.component';\nexport * from './lib/components/realtime/realtime-session-thread.component';\nexport * from './lib/components/realtime/realtime-delegation-card.component';\nexport * from './lib/components/realtime/realtime-activity-rail.component';\nexport * from './lib/components/realtime/realtime-surface-tabs.component';\nexport * from './lib/components/realtime/realtime-surface-tabs.model';\nexport * from './lib/components/realtime/realtime-surface-panel-prefs';\nexport * from './lib/components/realtime/realtime-disclosure';\nexport * from './lib/components/realtime/realtime-audio-visuals';\nexport * from './lib/components/realtime/realtime-composer.component';\nexport * from './lib/components/realtime/realtime-channel-strip.component';\n// Conversation-timeline collapse of past realtime sessions (one card per session) + its pure grouping pass\nexport * from './lib/components/realtime/realtime-session-timeline-card.component';\nexport * from './lib/utils/realtime-session-timeline';\n// Pluggable interactive-channel contract (registry-resolved client plugins) + pane host\nexport * from './lib/components/realtime/channels/base-realtime-channel-client';\nexport * from './lib/components/realtime/channels/client-context-channel';\nexport * from './lib/components/realtime/channels/realtime-channel-pane.component';\nexport * from './lib/components/realtime/channels/channel-onboarding-panel.component';\n// Live whiteboard channel plugin + artifact viewer (thin consumers of the generic board).\n// NOTE: the whiteboard itself (engine, tools, components, export builders) lives in\n// @memberjunction/ng-whiteboard — import board types/components from there directly.\nexport * from './lib/components/realtime/whiteboard/whiteboard-channel';\nexport * from './lib/components/realtime/whiteboard/whiteboard-artifact-viewer.component';\n// Remote Browser channel plugin (client-direct, server-hosted browser) + its live surface + tools.\nexport * from './lib/components/realtime/remote-browser/remote-browser-channel';\nexport * from './lib/components/realtime/remote-browser/remote-browser-surface.component';\nexport * from './lib/components/realtime/remote-browser/remote-browser-tools';\nexport * from './lib/components/realtime/remote-browser/remote-browser-audio-player';\n// Media channel plugin (Tabs-layout media display surface) + its state engine, tools, and surface.\nexport * from './lib/components/realtime/media/media-channel';\nexport * from './lib/components/realtime/media/media-channel-state';\nexport * from './lib/components/realtime/media/media-channel-tools';\nexport * from './lib/components/realtime/media/realtime-media-surface.component';\n// Time-aligned Evidence Playback component (recorded session audio synced to the transcript).\nexport * from './lib/components/realtime/evidence-playback/realtime-evidence-playback.component';\nexport * from './lib/services/composer-draft-store';\n"]}
+{"version":3,"file":"public-api.js","sourceRoot":"","sources":["../src/public-api.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Public API Surface of @memberjunction/ng-conversations\n */\n\n// Module\nexport * from './lib/conversations.module';\n\n// Models\nexport * from './lib/models/conversation-state.model';\nexport * from './lib/models/notification.model';\nexport * from './lib/models/lazy-artifact-info';\nexport * from './lib/models/navigation-request.model';\n// Host rules for an agent turn: reply mode, routes, and the host turn handler contract\nexport * from './lib/models/agent-turn.model';\nexport * from './lib/utils/agent-turn-routing';\n\n// Services - State\nexport * from './lib/services/data-cache.service';\nexport * from './lib/services/artifact-state.service';\nexport * from './lib/services/agent-state.service';\nexport * from './lib/services/conversation-agent.service';\nexport * from './lib/services/active-tasks.service';\nexport * from './lib/services/conversation-streaming.service';\nexport * from './lib/services/dialog.service';\nexport * from './lib/services/export.service';\nexport * from './lib/services/notification.service';\nexport * from './lib/services/toast.service';\nexport * from './lib/services/mention-parser.service';\n// AI-aware mention suggestion engine (BaseSingleton — use MentionAutocompleteService.Instance).\n// NOTE: the generic MentionSuggestion TYPE lives in @memberjunction/ng-composer — import it\n// from there directly (no re-exports between packages).\nexport * from './lib/services/mention-autocomplete.service';\nexport * from './lib/services/collection-permission.service';\nexport * from './lib/services/artifact-permission.service';\nexport * from './lib/services/artifact-use-tracking.service';\nexport * from './lib/services/collection-state.service';\nexport * from './lib/services/conversation-attachment.service';\nexport * from './lib/services/graphql-attachment-blob-store';\nexport * from './lib/services/ui-command-handler.service';\nexport * from './lib/services/conversation-bridge.service';\nexport * from './lib/services/realtime-session.service';\nexport * from './lib/services/browser-realtime-media-host';\n// NOTE: the realtime session types (RealtimeCaption, RealtimeConnectionState,\n// RealtimeSessionRunOptions, …), the channel plugin base class, and the delegation-result\n// parser now live in `@memberjunction/realtime-runtime`. Import them from there directly —\n// MJ does not re-export across package boundaries.\nexport * from './lib/services/realtime-pairing';\nexport * from './lib/services/user-authorization';\nexport * from './lib/services/realtime-sessions-adapter';\nexport * from './lib/services/realtime-session-review.service';\n\n// Components\nexport * from './lib/components/workspace/conversation-workspace.component';\nexport * from './lib/components/navigation/conversation-navigation.component';\nexport * from './lib/components/sidebar/conversation-sidebar.component';\nexport * from './lib/components/sidebar/routines-section.component';\nexport * from './lib/components/conversation/conversation-list.component';\nexport * from './lib/components/conversation/conversation-chat-area.component';\nexport * from './lib/components/conversation/conversation-empty-state.component';\nexport * from './lib/components/message/message-item.component';\nexport * from './lib/components/message/message-list.component';\nexport * from './lib/components/message/message-input.component';\n// AI-aware composer wrapper (mj-ai-composer): mj-message-input-box + the three AI trigger\n// plugins built in, proxying the input box's full inputs/outputs/methods surface.\nexport * from './lib/components/composer/ai-composer.component';\n// Composer trigger-provider plugins ('@' / '#' / '/') — ClassFactory-registered; also\n// directly instantiable for explicit provider lists.\nexport * from './lib/composer-plugins/base-conversation-mention.provider';\nexport * from './lib/composer-plugins/agent-mention.provider';\nexport * from './lib/composer-plugins/record-mention.provider';\nexport * from './lib/composer-plugins/skill-command.provider';\nexport * from './lib/composer-plugins/load-composer-plugins';\n// NOTE: MessageInputBoxComponent, MentionEditorComponent (+ PendingAttachment), and\n// MentionDropdownComponent live in @memberjunction/ng-composer — import from there directly.\nexport * from './lib/components/message/conversation-message-rating.component';\nexport * from './lib/components/collection/collection-tree.component';\nexport * from './lib/components/collection/collection-view.component';\nexport * from './lib/components/collection/collections-full-view.component';\nexport * from './lib/components/collection/collection-artifact-card.component';\nexport * from './lib/components/collection/artifact-collection-picker-modal.component';\nexport * from './lib/components/collection/collection-share-modal.component';\nexport * from './lib/components/artifact/artifact-share-modal.component';\nexport * from './lib/components/project/project-selector.component';\nexport * from './lib/components/project/project-form-modal.component';\nexport * from './lib/components/task/tasks-full-view.component';\nexport * from './lib/components/tasks/task-widget.component';\nexport * from './lib/components/agent/agent-process-panel.component';\nexport * from './lib/components/agent/active-agent-indicator.component';\nexport * from './lib/components/active-tasks/active-tasks-panel.component';\nexport * from './lib/components/share/share-modal.component';\nexport * from './lib/components/notification/notification-badge.component';\nexport * from './lib/components/notification/activity-indicator.component';\nexport * from './lib/components/toast/toast.component';\nexport * from './lib/components/global-tasks/global-tasks-panel.component';\nexport * from './lib/components/attachment/image-viewer.component';\nexport * from './lib/components/overlay/chat-overlay.component';\n\n// Components declared AND exported by ConversationsModule but previously missing\n// from public-api. They are used in the templates of exported components (e.g.\n// mj-conversation-chat-area), so a consumer app compiling in Angular's\n// local-compilation / HMR mode fails to build (NG3004: \"Unable to import\n// component … not exported from @memberjunction/ng-conversations\") unless every\n// module-exported component is importable from the package entry point.\nexport * from './lib/components/collection/artifact-create-modal.component';\nexport * from './lib/components/collection/collection-form-modal.component';\nexport * from './lib/components/conversation/conversation-agent-picker.component';\nexport * from './lib/components/conversation/conversation-mode-picker.component';\nexport * from './lib/components/conversation/pinned-messages-panel.component';\nexport * from './lib/components/dialogs/input-dialog.component';\nexport * from './lib/components/dialogs/rating-dialog.component';\nexport * from './lib/components/export/export-modal.component';\nexport * from './lib/components/library/library-full-view.component';\nexport * from './lib/components/members/members-modal.component';\nexport * from './lib/components/message/actionable-commands.component';\nexport * from './lib/components/message/workflow-plan-card.component';\nexport * from './lib/components/search/search-panel.component';\nexport * from './lib/components/shared/user-picker.component';\nexport * from './lib/components/tasks/tasks-dropdown.component';\nexport * from './lib/components/thread/thread-panel.component';\nexport * from './lib/directives/search-shortcut.directive';\n// SearchResult / SearchResultType are the payload of SearchPanelComponent's\n// ResultSelected output, so consumers cannot type a handler without them.\nexport type { SearchResult, SearchResultType } from './lib/services/search.service';\n\n// PR 2c — Widget extension surface (slots, events, design tokens)\nexport * from './lib/services/conversations-runtime-bootstrap.service';\nexport * from './lib/directives/chat-slot.directive';\nexport * from './lib/components/slots/slot-interfaces';\nexport * from './lib/components/slots/mj-chat-empty-state-default.component';\nexport * from './lib/components/slots/mj-chat-agent-presence-default.component';\nexport * from './lib/components/slots/mj-chat-header-default.component';\nexport * from './lib/components/slots/mj-chat-message-extra-default.component';\nexport * from './lib/components/slots/mj-chat-demonstration-surface-default.component';\nexport * from './lib/components/slots/mj-chat-message-bubble-default.component';\nexport * from './lib/events/chat-events';\n\n// Realtime / voice (PR #2787 — co-agent realtime sessions)\nexport * from './lib/components/realtime/realtime-agent-picker.component';\n// Real-time \"call mode\" overlay + its componentized parts\nexport * from './lib/components/realtime/realtime-session-overlay.component';\nexport * from './lib/components/realtime/realtime-session-state';\nexport * from './lib/components/realtime/realtime-agent-banner.component';\nexport * from './lib/components/realtime/realtime-session-thread.component';\nexport * from './lib/components/realtime/realtime-delegation-card.component';\nexport * from './lib/components/realtime/realtime-activity-rail.component';\nexport * from './lib/components/realtime/realtime-surface-tabs.component';\nexport * from './lib/components/realtime/realtime-surface-tabs.model';\nexport * from './lib/components/realtime/realtime-surface-panel-prefs';\nexport * from './lib/components/realtime/realtime-disclosure';\nexport * from './lib/components/realtime/realtime-audio-visuals';\nexport * from './lib/components/realtime/realtime-composer.component';\nexport * from './lib/components/realtime/realtime-channel-strip.component';\n// Conversation-timeline collapse of past realtime sessions (one card per session) + its pure grouping pass\nexport * from './lib/components/realtime/realtime-session-timeline-card.component';\nexport * from './lib/utils/realtime-session-timeline';\n// Pluggable interactive-channel contract (registry-resolved client plugins) + pane host\nexport * from './lib/components/realtime/channels/client-context-channel';\nexport * from './lib/components/realtime/channels/realtime-channel-pane.component';\nexport * from './lib/components/realtime/channels/channel-onboarding-panel.component';\n// Live whiteboard channel plugin + artifact viewer (thin consumers of the generic board).\n// NOTE: the whiteboard itself (engine, tools, components, export builders) lives in\n// @memberjunction/ng-whiteboard — import board types/components from there directly.\nexport * from './lib/components/realtime/whiteboard/whiteboard-channel';\nexport * from './lib/components/realtime/whiteboard/whiteboard-artifact-viewer.component';\n// Remote Browser channel plugin (client-direct, server-hosted browser) + its live surface + tools.\nexport * from './lib/components/realtime/remote-browser/remote-browser-channel';\nexport * from './lib/components/realtime/remote-browser/remote-browser-surface.component';\nexport * from './lib/components/realtime/remote-browser/remote-browser-tools';\nexport * from './lib/components/realtime/remote-browser/remote-browser-audio-player';\n// Media channel plugin (Tabs-layout media display surface) + its state engine, tools, and surface.\nexport * from './lib/components/realtime/media/media-channel';\nexport * from './lib/components/realtime/media/media-channel-state';\nexport * from './lib/components/realtime/media/media-channel-tools';\nexport * from './lib/components/realtime/media/realtime-media-surface.component';\n// Time-aligned Evidence Playback component (recorded session audio synced to the transcript).\nexport * from './lib/components/realtime/evidence-playback/realtime-evidence-playback.component';\nexport * from './lib/services/composer-draft-store';\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@memberjunction/ng-conversations",
-  "version": "6.1.4",
+  "version": "6.2.0-edge.1",
   "description": "MemberJunction: Conversation, Collection, and Artifact management components for any Angular application",
   "main": "./dist/public-api.js",
   "typings": "./dist/public-api.d.ts",
@@ -13,9 +13,9 @@
   "devDependencies": {
     "@angular/compiler": "21.2.22",
     "@angular/compiler-cli": "21.2.22",
+    "@memberjunction/ng-test-utils": "6.2.0-edge.1",
     "sass": "^1.97.3",
-    "vitest": "^4.0.18",
-    "@memberjunction/ng-test-utils": "6.1.4"
+    "vitest": "^4.0.18"
   },
   "peerDependencies": {
     "@angular/animations": "^21.2.22",
@@ -26,35 +26,36 @@
     "@angular/platform-browser": "^21.2.22"
   },
   "dependencies": {
-    "@memberjunction/ai": "6.1.4",
-    "@memberjunction/ai-agent-client": "6.1.4",
-    "@memberjunction/ai-core-plus": "6.1.4",
-    "@memberjunction/ai-engine-base": "6.1.4",
-    "@memberjunction/ai-realtime-client": "6.1.4",
-    "@memberjunction/conversations-runtime": "6.1.4",
-    "@memberjunction/core": "6.1.4",
-    "@memberjunction/core-entities": "6.1.4",
-    "@memberjunction/global": "6.1.4",
-    "@memberjunction/graphql-dataprovider": "6.1.4",
-    "@memberjunction/interactive-component-types": "6.1.4",
-    "@memberjunction/ng-agent-client": "6.1.4",
-    "@memberjunction/ng-artifacts": "6.1.4",
-    "@memberjunction/ng-base-types": "6.1.4",
-    "@memberjunction/ng-code-editor": "6.1.4",
-    "@memberjunction/ng-composer": "6.1.4",
-    "@memberjunction/ng-container-directives": "6.1.4",
-    "@memberjunction/ng-forms": "6.1.4",
-    "@memberjunction/ng-markdown": "6.1.4",
-    "@memberjunction/ng-media-player": "6.1.4",
-    "@memberjunction/ng-notifications": "6.1.4",
-    "@memberjunction/ng-resource-permissions": "6.1.4",
-    "@memberjunction/ng-shared-generic": "6.1.4",
-    "@memberjunction/ng-task-graph-editor": "6.1.4",
-    "@memberjunction/ng-tasks": "6.1.4",
-    "@memberjunction/ng-testing": "6.1.4",
-    "@memberjunction/ng-ui-components": "6.1.4",
-    "@memberjunction/ng-user-routines": "6.1.4",
-    "@memberjunction/ng-whiteboard": "6.1.4",
+    "@memberjunction/ai": "6.2.0-edge.1",
+    "@memberjunction/ai-agent-client": "6.2.0-edge.1",
+    "@memberjunction/ai-core-plus": "6.2.0-edge.1",
+    "@memberjunction/ai-engine-base": "6.2.0-edge.1",
+    "@memberjunction/ai-realtime-client": "6.2.0-edge.1",
+    "@memberjunction/conversations-runtime": "6.2.0-edge.1",
+    "@memberjunction/core": "6.2.0-edge.1",
+    "@memberjunction/core-entities": "6.2.0-edge.1",
+    "@memberjunction/global": "6.2.0-edge.1",
+    "@memberjunction/graphql-dataprovider": "6.2.0-edge.1",
+    "@memberjunction/interactive-component-types": "6.2.0-edge.1",
+    "@memberjunction/ng-agent-client": "6.2.0-edge.1",
+    "@memberjunction/ng-artifacts": "6.2.0-edge.1",
+    "@memberjunction/ng-base-types": "6.2.0-edge.1",
+    "@memberjunction/ng-code-editor": "6.2.0-edge.1",
+    "@memberjunction/ng-composer": "6.2.0-edge.1",
+    "@memberjunction/ng-container-directives": "6.2.0-edge.1",
+    "@memberjunction/ng-forms": "6.2.0-edge.1",
+    "@memberjunction/ng-markdown": "6.2.0-edge.1",
+    "@memberjunction/ng-media-player": "6.2.0-edge.1",
+    "@memberjunction/ng-notifications": "6.2.0-edge.1",
+    "@memberjunction/ng-resource-permissions": "6.2.0-edge.1",
+    "@memberjunction/ng-shared-generic": "6.2.0-edge.1",
+    "@memberjunction/ng-task-graph-editor": "6.2.0-edge.1",
+    "@memberjunction/ng-tasks": "6.2.0-edge.1",
+    "@memberjunction/ng-testing": "6.2.0-edge.1",
+    "@memberjunction/ng-ui-components": "6.2.0-edge.1",
+    "@memberjunction/ng-user-routines": "6.2.0-edge.1",
+    "@memberjunction/ng-whiteboard": "6.2.0-edge.1",
+    "@memberjunction/realtime-runtime": "6.2.0-edge.1",
     "angular-split": "^20.0.0",
     "rxjs": "^7.8.2",
     "tslib": "^2.8.1"

package/dist/lib/components/realtime/channels/base-realtime-channel-client.d.ts

@@ -1,384 +0,0 @@
-import type { Type } from '@angular/core';
-import type { Observable } from 'rxjs';
-import { IMetadataProvider } from '@memberjunction/core';
-import { JSONValue, RealtimeToolDefinition, RealtimeTrackDescriptor, RealtimeTrackDirection } from '@memberjunction/ai';
-import type { BaseRealtimeClient } from '@memberjunction/ai-realtime-client';
-import type { AppContextSnapshot } from '@memberjunction/ai-core-plus';
-/**
- * Host services handed to a {@link BaseRealtimeChannelClient} at {@link BaseRealtimeChannelClient.Initialize}.
- *
- * The context is the plugin's ONLY line back to the live session — channels never talk to
- * `RealtimeSessionService` (or any host component) directly, which is what keeps them drop-in
- * plugins. Every member is host-implemented:
- *
- *  - the SESSION SERVICE supplies {@link SendContextNote} (perception feed into the live
- *    model), {@link RequestSave} (debounced state-of-record persistence onto the session's
- *    `MJ: AI Agent Session Channels` row) and {@link AgentName};
- *  - the OVERLAY SHELL wires {@link SetFocusMode} (through the service's focus stream) so a
- *    channel surface can request the focus layout — main call column collapsed, surface
- *    panel filling the overlay, floating call pill riding on top.
- */
-export interface RealtimeChannelContext {
-    /** Display name of the agent the live session fronts (e.g. `"Sage"`), fixed at session start. */
-    AgentName: string;
-    /**
-     * The MJ metadata provider the live session runs on — the SAME `IMetadataProvider` instance that
-     * authenticates the session (NOT necessarily the global default). A channel whose surface renders
-     * MemberJunction-backed data (e.g. the Media channel streaming an `MJ: Files` record through
-     * `mj-storage-media-player`) threads THIS provider into its surface / GraphQL calls so it stays
-     * multi-provider safe. `null` only in degenerate/early states; channels fall back to the global
-     * default when absent.
-     */
-    Provider: IMetadataProvider | null;
-    /**
-     * Feeds a background context note into the live realtime model (no spoken reply is
-     * requested) — the PERCEPTION direction of the channel: serialized state deltas flow here
-     * so the agent stays aware of what's on the surface. No-op when the session isn't live.
-     */
-    SendContextNote(text: string): void;
-    /**
-     * Asks the host to persist `stateJson` as this channel's state of record. The host
-     * DEBOUNCES (a change burst becomes one save) and flushes any pending save at session
-     * teardown — the plugin just calls this on every state mutation and never schedules
-     * timers itself. Best-effort: persistence failures are logged host-side, never thrown.
-     */
-    RequestSave(stateJson: string): void;
-    /**
-     * Requests (or releases) the FOCUS layout for this channel's surface: the overlay
-     * collapses the main call column so the surface owns the screen, with a compact floating
-     * call pill keeping mute / thread / end reachable. Any channel may request it; the host
-     * tracks which channel holds focus and routes the pill's "exit" back to it via
-     * {@link BaseRealtimeChannelClient.RequestFocusExit}.
-     */
-    SetFocusMode(on: boolean): void;
-    /**
-     * Asks the live model to SPEAK a response to the supplied instructions RIGHT NOW —
-     * the channel's "react to this" path, e.g. a widget submission the user expects an
-     * audible reaction to ({@link SendContextNote} deliberately never triggers speech).
-     * Rides the realtime client's spoken-update channel, so on some providers the spoken
-     * reply is narration-kind (ephemeral, not persisted as a caption). OPTIONAL member:
-     * older host contexts may not supply it — plugins must call it null-safely.
-     */
-    RequestSpokenResponse?(instructions: string): void;
-    /**
-     * Persists a snapshot of the channel's state as a first-class versioned artifact
-     * (`MJ: Artifacts` + version, linked into conversation history when possible) — e.g. the
-     * whiteboard's "Save to artifacts". Distinct from {@link RealtimeChannelContext.RequestSave},
-     * which maintains the session's rolling state of record. Best-effort: resolves to the
-     * created Artifact ID, or `null` on failure (logged host-side, never thrown). Works during
-     * the call AND right after it ends (the host retains the session id for late saves).
-     */
-    SaveAsArtifact(name: string, contentJson: string): Promise<string | null>;
-    /**
-     * The live `MJ: AI Agent Sessions` id this channel belongs to, or `null` before the
-     * session has minted / after it has torn down. A channel whose tools or surface drive a
-     * SERVER-SIDE resource (e.g. the Remote Browser channel's server-hosted browser) passes
-     * this as the `agentSessionID` argument to its own GraphQL resolvers via
-     * {@link ExecuteServerAction}. Most channels (whiteboard, shared doc) keep all state
-     * client-side and never read it.
-     */
-    AgentSessionID: string | null;
-    /**
-     * Executes a CHANNEL-SPECIFIC GraphQL operation against the session's MJ server — the
-     * escape hatch for channels backed by a SERVER-SIDE resource that the generic
-     * {@link RequestSave} / {@link SaveAsArtifact} contract doesn't cover (e.g. the Remote
-     * Browser channel driving a server-hosted browser through its own
-     * `ExecuteRemoteBrowserAction` mutation + `RemoteBrowserSnapshot` query).
-     *
-     * The host runs the operation through the SAME provider the live session uses, so the
-     * request rides the authenticated session. Best-effort and tolerant: a transport or
-     * server error resolves to `null` (logged host-side) rather than throwing, so a channel
-     * can map the failure to a model-readable result string without `try/catch`.
-     *
-     * @typeParam TResult The expected shape of the GraphQL operation's data payload.
-     * @param query The GraphQL query/mutation document.
-     * @param variables The operation variables (all JSON-serializable).
-     * @returns The operation's `data` payload, or `null` on any failure / when no session is live.
-     */
-    ExecuteServerAction<TResult>(query: string, variables: Record<string, JSONValue>): Promise<TResult | null>;
-    /**
-     * OPTIONAL — the live app-context stream (where the user is, what they see, and the available
-     * client-tool + agent manifest), pushed by the host (Explorer) at session start and on subsequent
-     * changes. The headless `ClientContextChannel` subscribes to this and streams deltas to the model
-     * via {@link SendContextNote}. Absent on hosts that don't supply app context (e.g. custom apps);
-     * channels must read it null-safely.
-     */
-    AppContext$?: Observable<AppContextSnapshot | null>;
-    /**
-     * OPTIONAL — executes a host-registered surface CLIENT TOOL by name (the handlers the host wired
-     * from the active surface's `SetAgentClientTools`). The headless `ClientContextChannel`'s
-     * `ContextTool` proxy routes the model's `{ action, params }` here so a surface tool runs in the
-     * browser with no server round-trip. Best-effort and tolerant — resolves to a structured result
-     * (never throws); `Success: false` for an unknown tool or a thrown handler. Absent on hosts that
-     * register no client tools.
-     *
-     * @param name The client-tool name (the model's `action`).
-     * @param params The tool parameters (the model's `params`).
-     * @returns A structured result the channel serializes back to the model.
-     */
-    ExecuteClientTool?(name: string, params: Record<string, unknown>): Promise<{
-        Success: boolean;
-        Result?: unknown;
-        ErrorMessage?: string;
-    }>;
-    /**
-     * OPTIONAL — sends a visual frame into the live session's inbound video track
-     * (e.g. from Whiteboard or Remote Browser video bridges). No-op when the session
-     * has not established an inbound video track or is not live.
-     *
-     * @param base64Image The image data (base64-encoded JPEG/PNG).
-     * @param mimeType The image MIME type (defaults to 'image/jpeg').
-     */
-    SendVideoFrame?(base64Image: string, mimeType?: string): void;
-    /**
-     * OPTIONAL — checks whether a media track is currently established on the live session.
-     */
-    IsTrackEstablished?(modality: string, direction: RealtimeTrackDirection): boolean;
-    /**
-     * OPTIONAL — the underlying {@link BaseRealtimeClient} driving the media and transport planes.
-     */
-    Client?: BaseRealtimeClient | null;
-}
-/**
- * The first-run INTRO content for an interactive channel — the concise "what is this surface
- * and how do I use it" copy the overlay shows the very first time a user opens this channel's
- * tab (persisted "seen" per user, so it's shown ONCE per channel per user).
- *
- * A channel opts in by overriding {@link BaseRealtimeChannelClient.GetOnboardingDetails}; the
- * default returns `null`, so the base Voice/text channel (which has no plugin at all) AND any
- * plugin that doesn't override it show nothing.
- */
-export interface ChannelOnboardingDetails {
-    /** Short title, usually the surface name (e.g. `"Whiteboard"`). */
-    Heading: string;
-    /** One or two sentences: what the surface is and what the user can expect to see on it. */
-    Description: string;
-    /** Optional quick-tip bullets (kept to 2-3 short, scannable lines). */
-    Tips?: string[];
-    /** Optional Font Awesome icon class for the intro panel (e.g. `'fa-solid fa-chalkboard'`). */
-    IconClass?: string;
-}
-/**
- * Base class for CLIENT-SIDE interactive-channel plugins (per
- * `plans/ai-agent-sessions.md` → "Interactive Channels" / "Pluggable Channel Interfaces").
- *
- * An interactive channel is a bidirectional surface the session's single realtime agent
- * both PERCEIVES and ACTS UPON (whiteboard, shared doc, map, …). A concrete plugin
- * contributes everything the channel needs, so the session service / call overlay carry
- * ZERO channel-specific wiring:
- *
- *  1. a CLIENT-EXECUTED TOOL SET ({@link GetToolDefinitions}, declared to the realtime
- *     model at session mint) plus the local executor ({@link ApplyAgentTool}) the host
- *     routes `{@link ToolNamePrefix}*` calls to — the ACTION direction;
- *  2. a STATE→CONTEXT SERIALIZER policy — the plugin owns its state engine and pushes
- *     coalesced deltas through {@link RealtimeChannelContext.SendContextNote} — the
- *     PERCEPTION direction;
- *  3. an OPTIONAL ANGULAR SURFACE ({@link GetSurfaceComponent}) the overlay creates dynamically
- *     in a channel tab, handed back through {@link BindSurface} so the plugin wires its own
- *     inputs/outputs (the host never knows the component's API). A channel may be **server-only**
- *     (no rendered surface) — e.g. a bridge-contributed meeting-controls or native-whiteboard
- *     channel whose surface lives on the external platform, not in MJ. Such a channel returns
- *     `null` from {@link GetSurfaceComponent} ({@link HasSurface} is `false`) and the overlay
- *     simply skips its tab while still wiring its tools + perception;
- *  4. a STATE OF RECORD ({@link SerializeState}, persisted via
- *     {@link RealtimeChannelContext.RequestSave} under {@link ChannelName}).
- *
- * ### Registration & resolution (mirrors the realtime model drivers)
- * Concrete plugins are `@RegisterClass(BaseRealtimeChannelClient, '<ClientPluginClass>')`
- * and are resolved at session start from the `MJ: AI Agent Channels` registry: each ACTIVE
- * row's `ClientPluginClass` is the ClassFactory key (exactly how `BaseRealtimeClient`
- * drivers resolve by provider key). Ship a `Load<YourChannel>()` no-op alongside the class
- * and call it from a static code path to defeat tree-shaking.
- *
- * ### Lifecycle — ONE INSTANCE PER SESSION (not a singleton)
- * `ClassFactory.CreateInstance` → {@link Initialize}(ctx) → zero or more
- * {@link BindSurface}/{@link UnbindSurface} cycles (the surface pane is created/destroyed
- * with the overlay's tab panel, e.g. collapse/expand) → {@link Dispose} at teardown.
- * {@link ApplyAgentTool} MUST work with NO surface bound (apply to the state engine
- * directly; skip the UI garnish) — tool calls can arrive while the panel is collapsed.
- *
- * @typeParam TSurface The plugin's Angular surface component type. The host only ever
- *   sees the default (`object`) — the typed parameter exists so concrete plugins get a
- *   fully typed {@link BindSurface} without casts.
- */
-export declare abstract class BaseRealtimeChannelClient<TSurface extends object = object> {
-    /**
-     * The host context, available from {@link Initialize} until {@link Dispose}.
-     * `null` outside that window — guard with `?.` in any code that can run early/late.
-     */
-    protected Context: RealtimeChannelContext | null;
-    /**
-     * The channel definition name — MUST match the `MJ: AI Agent Channels` row's `Name`
-     * (e.g. `'Whiteboard'`). Used as the persistence key for {@link SerializeState} saves
-     * and as the channel tab's stable key.
-     */
-    abstract get ChannelName(): string;
-    /**
-     * The shared name prefix of every tool this channel exposes (e.g. `'Whiteboard_'`).
-     * The host registers ONE local-execution route per plugin: tool calls whose name starts
-     * with this prefix go to {@link ApplyAgentTool} instead of the server relay.
-     */
-    abstract get ToolNamePrefix(): string;
-    /** Label for the channel's tab on the overlay's surface panel (e.g. `'Whiteboard'`). */
-    abstract get TabTitle(): string;
-    /** Font Awesome icon class for the channel's tab (e.g. `'fa-solid fa-chalkboard'`). */
-    abstract get TabIcon(): string;
-    /**
-     * OPTIONAL accent color for the channel's tab (a CSS color string, e.g. an `hsl()` /
-     * token). When a plugin supplies one, the overlay paints the tab's dot + active underline
-     * with it; when omitted (the default `null`), the overlay derives a stable, deterministic
-     * color from the {@link ChannelName} so every channel still reads as a distinct, colored
-     * surface. A channel only overrides this to enforce a specific brand accent.
-     */
-    get TabColor(): string | null;
-    /**
-     * The channel's CLIENT-EXECUTED tool declarations, aggregated by the session service
-     * into the `clientTools` set declared to the realtime model at session mint. The server
-     * only DECLARES these — execution stays in the browser via {@link ApplyAgentTool}.
-     */
-    abstract GetToolDefinitions(): RealtimeToolDefinition[];
-    /**
-     * Executes ONE agent tool call locally (the ACTION direction) and returns the result
-     * JSON string fed back to the model as the `tool_response`. Called for every tool whose
-     * name starts with {@link ToolNamePrefix}. Must work both WITH a bound surface (apply +
-     * UI garnish) and WITHOUT one (apply to the state engine directly — the tab pane may not
-     * exist, e.g. the surface panel is collapsed). Should not throw: return a
-     * `{ success: false, error }` payload so the model can narrate the failure (the host
-     * additionally wraps anything thrown).
-     */
-    abstract ApplyAgentTool(toolName: string, argsJson: string): string | Promise<string>;
-    /**
-     * The Angular component the overlay creates dynamically as this channel's tab pane, or `null`
-     * for a **server-only** channel that renders no MJ surface (its surface, if any, lives on the
-     * external platform — e.g. a bridge-contributed native whiteboard or meeting-controls channel).
-     *
-     * When this returns `null`, the overlay renders NO tab for the channel and never calls
-     * {@link BindSurface}/{@link UnbindSurface} — but the channel's tools ({@link GetToolDefinitions} /
-     * {@link ApplyAgentTool}) and perception ({@link RealtimeChannelContext.SendContextNote}) still run.
-     * A created surface instance is handed straight back via {@link BindSurface}; the host treats it as
-     * opaque.
-     *
-     * Default: `null` (server-only). A channel with a rendered surface overrides this to return its
-     * component type.
-     */
-    GetSurfaceComponent(): Type<TSurface> | null;
-    /**
-     * Whether this channel has a rendered MJ surface ({@link GetSurfaceComponent} returns non-null).
-     * The overlay uses this to decide whether to register a surface tab; server-only channels are
-     * `false`. Override only if surface availability must be decided WITHOUT constructing the type
-     * (the default calls {@link GetSurfaceComponent} once).
-     */
-    HasSurface(): boolean;
-    /**
-     * The channel's FIRST-RUN INTRO content, or `null` when the channel offers no onboarding.
-     * The overlay shows this once per channel per user — the first time the user opens this
-     * channel's surface tab — and remembers "seen" via the user's settings (NOT localStorage),
-     * so it never re-appears on later sessions or other devices.
-     *
-     * Default: `null` (no intro). The base Voice/text channel has no plugin at all, so it never
-     * shows an intro; an interactive channel with a surface worth explaining (whiteboard, remote
-     * browser, …) overrides this to return its {@link ChannelOnboardingDetails}. A plugin that
-     * doesn't override it simply shows nothing — onboarding is strictly opt-in.
-     */
-    GetOnboardingDetails(): ChannelOnboardingDetails | null;
-    /**
-     * Called by the host right after it created the surface component (and BEFORE the
-     * component's first change detection, so inputs set here are visible in its `ngOnInit`).
-     * The plugin — which knows its own component type — sets inputs (state engine, agent
-     * name, …) and subscribes outputs here, wiring perception/garnish flows back through
-     * {@link Context}. May be called again with a NEW instance after an
-     * {@link UnbindSurface} (the pane is destroyed/recreated with the tab panel).
-     */
-    abstract BindSurface(instance: TSurface): void;
-    /**
-     * Called by the host when the surface component is being destroyed (tab panel
-     * collapsed / overlay torn down). Drop the instance reference and unsubscribe any
-     * output subscriptions — after this, {@link ApplyAgentTool} runs in its no-surface
-     * mode. Default: no-op.
-     */
-    UnbindSurface(): void;
-    /**
-     * Binds the host context and invokes the {@link OnInitialize} hook. Called exactly once
-     * per session, right after ClassFactory instantiation and before any tool call or
-     * surface bind.
-     */
-    Initialize(ctx: RealtimeChannelContext): void;
-    /**
-     * Subclass hook invoked from {@link Initialize} once {@link Context} is bound — wire
-     * state-engine subscriptions (e.g. state change → `Context.RequestSave(...)`) here.
-     * Default: no-op.
-     */
-    protected OnInitialize(): void;
-    /**
-     * Subclass hook invoked once the realtime session is connected and live (the client driver
-     * is created, connected, and media tracks negotiated). Channels that establish media bridges
-     * (e.g. video streaming) can start them here when `Context.Client` is available.
-     * Default: no-op.
-     */
-    OnSessionStarted(): void;
-    /**
-     * Max time {@link ResolveAgentSessionId} waits for the session id to bind before giving up, and the
-     * poll interval it re-checks on. Protected so tests can shrink the wait; production keeps the
-     * defaults (the real mint race is sub-second, 8s is generous headroom).
-     */
-    protected SessionIdWaitTimeoutMs: number;
-    protected SessionIdWaitIntervalMs: number;
-    /**
-     * Resolves the live {@link RealtimeChannelContext.AgentSessionID}, briefly WAITING for it when it
-     * isn't bound yet rather than giving up instantly. `AgentSessionID` is a live getter over the
-     * session service's current id: it reads `null` in the window BEFORE the session mints (the
-     * realtime model can fire a tool call the very first beat it connects, before `mintSession`
-     * resolves) and again AFTER teardown. Server-backed tool paths (e.g. the Remote Browser channel's
-     * `browser_*` tools) call this instead of reading `Context?.AgentSessionID` synchronously, so a tool
-     * invoked a beat early WAITS for the session to come live — defense-in-depth against the
-     * "session id missing" race — instead of returning a hard failure to the model.
-     *
-     * Returns the id as soon as it's non-null (the common path resolves immediately, no delay), or
-     * `null` if it's still unbound after {@link SessionIdWaitTimeoutMs} — or the channel was
-     * {@link Dispose}d in the meantime (`Context` goes null, so we stop waiting on a torn-down session).
-     */
-    protected ResolveAgentSessionId(): Promise<string | null>;
-    /**
-     * Serializes the channel's current state of record (the payload persisted on the
-     * session's channel row), or `null` when the channel keeps no persistent state.
-     * Default: `null`.
-     */
-    SerializeState(): string | null;
-    /**
-     * Restores a PRIOR session's saved channel state (the payload a previous session
-     * persisted via {@link SerializeState} / {@link RealtimeChannelContext.RequestSave}).
-     * Invoked by the session host AFTER {@link Initialize} and BEFORE any surface binding,
-     * when a prior session's saved state exists for this channel.
-     *
-     * Returns `true` when the state was applied; `false` when the channel ignored it —
-     * either because it keeps no persistent state (this default) or because the payload was
-     * malformed/incompatible. Implementations MUST be tolerant: never throw on bad input,
-     * just return `false` and start fresh.
-     */
-    RestoreState(stateJson: string): boolean;
-    /**
-     * The focus pill's "exit" affordance, routed by the overlay to the channel that holds
-     * focus. Implementations should leave focus mode through their OWN surface (so surface
-     * toggles stay in sync), ultimately emitting `Context.SetFocusMode(false)`. The overlay
-     * defensively clears its layout flag as well, so a no-op default is safe.
-     */
-    RequestFocusExit(): void;
-    /**
-     * Media tracks this client channel can SOURCE — samples flowing into the model.
-     * Default `[]`.
-     */
-    GetSourcedTracks(): readonly RealtimeTrackDescriptor[];
-    /**
-     * Media tracks this client channel can SINK — samples flowing from the model OUT.
-     * Default `[]`.
-     */
-    GetSunkTracks(): readonly RealtimeTrackDescriptor[];
-    /**
-     * Tears the plugin down at session end: release the surface binding, unsubscribe
-     * state-engine subscriptions, then drop the context. Subclasses overriding this MUST
-     * call `super.Dispose()`. Any final state save has already been flushed by the host
-     * (the debounced {@link RealtimeChannelContext.RequestSave} pipeline) before disposal.
-     */
-    Dispose(): void;
-}
-//# sourceMappingURL=base-realtime-channel-client.d.ts.map

package/dist/lib/components/realtime/channels/base-realtime-channel-client.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"base-realtime-channel-client.d.ts","sourceRoot":"","sources":["../../../../../src/lib/components/realtime/channels/base-realtime-channel-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AACxH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAEvE;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,sBAAsB;IACrC,iGAAiG;IACjG,SAAS,EAAE,MAAM,CAAC;IAElB;;;;;;;OAOG;IACH,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAEnC;;;;OAIG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAEpC;;;;;OAKG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAErC;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,CAAC;IAEhC;;;;;;;OAOG;IACH,qBAAqB,CAAC,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAEnD;;;;;;;OAOG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAE1E;;;;;;;OAOG;IACH,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAE9B;;;;;;;;;;;;;;;;OAgBG;IACH,mBAAmB,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAE3G;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,UAAU,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC;IAEpD;;;;;;;;;;;OAWG;IACH,iBAAiB,CAAC,CAChB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAE1E;;;;;;;OAOG;IACH,cAAc,CAAC,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE9D;;OAEG;IACH,kBAAkB,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,sBAAsB,GAAG,OAAO,CAAC;IAElF;;OAEG;IACH,MAAM,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAAC;CACpC;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,wBAAwB;IACvC,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAC;IAChB,2FAA2F;IAC3F,WAAW,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,8FAA8F;IAC9F,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,8BAAsB,yBAAyB,CAAC,QAAQ,SAAS,MAAM,GAAG,MAAM;IAC9E;;;OAGG;IACH,SAAS,CAAC,OAAO,EAAE,sBAAsB,GAAG,IAAI,CAAQ;IAExD;;;;OAIG;IACH,aAAoB,WAAW,IAAI,MAAM,CAAC;IAE1C;;;;OAIG;IACH,aAAoB,cAAc,IAAI,MAAM,CAAC;IAE7C,wFAAwF;IACxF,aAAoB,QAAQ,IAAI,MAAM,CAAC;IAEvC,uFAAuF;IACvF,aAAoB,OAAO,IAAI,MAAM,CAAC;IAEtC;;;;;;OAMG;IACH,IAAW,QAAQ,IAAI,MAAM,GAAG,IAAI,CAEnC;IAED;;;;OAIG;aACa,kBAAkB,IAAI,sBAAsB,EAAE;IAE9D;;;;;;;;OAQG;aACa,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAE5F;;;;;;;;;;;;;OAaG;IACI,mBAAmB,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,IAAI;IAInD;;;;;OAKG;IACI,UAAU,IAAI,OAAO;IAI5B;;;;;;;;;;OAUG;IACI,oBAAoB,IAAI,wBAAwB,GAAG,IAAI;IAI9D;;;;;;;OAOG;aACa,WAAW,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAErD;;;;;OAKG;IACI,aAAa,IAAI,IAAI;IAI5B;;;;OAIG;IACI,UAAU,CAAC,GAAG,EAAE,sBAAsB,GAAG,IAAI;IAKpD;;;;OAIG;IACH,SAAS,CAAC,YAAY,IAAI,IAAI;IAI9B;;;;;OAKG;IACI,gBAAgB,IAAI,IAAI;IAI/B;;;;OAIG;IACH,SAAS,CAAC,sBAAsB,SAAQ;IACxC,SAAS,CAAC,uBAAuB,SAAO;IAExC;;;;;;;;;;;;;OAaG;cACa,qBAAqB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAoB/D;;;;OAIG;IACI,cAAc,IAAI,MAAM,GAAG,IAAI;IAItC;;;;;;;;;;OAUG;IACI,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAI/C;;;;;OAKG;IACI,gBAAgB,IAAI,IAAI;IAI/B;;;OAGG;IACI,gBAAgB,IAAI,SAAS,uBAAuB,EAAE;IAI7D;;;OAGG;IACI,aAAa,IAAI,SAAS,uBAAuB,EAAE;IAI1D;;;;;OAKG;IACI,OAAO,IAAI,IAAI;CAIvB"}