@memberjunction/ng-conversations 6.2.0-edge.2 → 6.2.0-edge.4

package/dist/lib/components/realtime/capture/realtime-capture-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-capture-model.js","sourceRoot":"","sources":["../../../../../src/lib/components/realtime/capture/realtime-capture-model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAmB,MAAM,MAAM,CAAC;AAGxD,OAAO,EAAE,2BAA2B,EAAuD,MAAM,kCAAkC,CAAC;AAsCpI;;;;;GAKG;AACH,MAAM,OAAO,oBAAoB;IAaH;IAZpB,MAAM,GAAkB,IAAI,CAAC;IAC7B,OAAO,GAAyB,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAClD,WAAW,GAAG,KAAK,CAAC;IAC5B;;;OAGG;IACK,UAAU,GAAmB,IAAI,CAAC;IAClC,QAAQ,GAA0G,IAAI,CAAC;IAC9G,IAAI,CAAuC;IACpD,aAAa,GAAqD,IAAI,CAAC;IAE/E,YAA4B,IAAyB;QAAzB,SAAI,GAAJ,IAAI,CAAqB;QACnD,IAAI,CAAC,IAAI,GAAG,IAAI,eAAe,CAAsB,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;IACzE,CAAC;IAED,kCAAkC;IAClC,IAAW,IAAI;QACb,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;IACzB,CAAC;IAED,uDAAuD;IACvD,IAAW,KAAK;QACd,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;IAClC,CAAC;IAED,8DAA8D;IACvD,QAAQ,CAAC,OAAyD;QACvE,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC;IAC/B,CAAC;IAED;;;;OAIG;IACI,GAAG,CAAC,MAAqB;QAC9B,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,UAAU,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;YACvE,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QACnC,IAAI,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACrF,OAAO,IAAI,CAAC;IACd,CAAC;IAED,sFAAsF;IAC/E,OAAO;QACZ,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;YACzB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;IAClD,CAAC;IAED;;;OAGG;IACI,aAAa,CAAC,OAA6B;QAChD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC;QACzB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,OAAO,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;YAC5B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACrB,CAAC;QACD,IAAI,GAAG,CAAC,QAAQ,IAAI,OAAO,CAAC,MAAM,KAAK,KAAK,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;YACrE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;YACnB,IAAI,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;YAChD,OAAO;QACT,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACnD,CAAC;IAED,oEAAoE;IAC7D,cAAc,CAAC,OAAgB;QACpC,IAAI,OAAO,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC;YACjC,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC;YAC3B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACI,kBAAkB,CAAC,OAAoC;QAC5D,MAAM,QAAQ,GAAG,2BAA2B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxD,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;QAC5D,MAAM,IAAI,GAAG,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC;QACrE,IAAI,IAAI,KAAK,IAAI,CAAC,UAAU,EAAE,CAAC;YAC7B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;YACvB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAED,iDAAiD;IAC1C,OAAO;QACZ,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACvB,MAAM,KAAK,GAAe,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;QAC1G,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC3B,KAAK,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC;QAClC,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,+EAA+E;IACvE,QAAQ,CAAC,GAAmC,EAAE,OAA6B;QACjF,IAAI,OAAO,CAAC,MAAM,KAAK,IAAI,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YAC5C,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAC/G,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,KAAK,KAAK,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YAC7C,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;QAC1C,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,KAAK,QAAQ,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;YACpD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE,EAAE,EAAE,CAAC;QAC9G,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,OAAO,CAAC,KAAqC;QACnD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;QACjC,IAAI,CAAC,aAAa,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IACzC,CAAC;IAEO,SAAS;QACf,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QACxC,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;YAC9B,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,OAAO,EAAE,OAAO,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,IAAI,8BAA8B,CAAC,CAAC,CAAC,CAAC,IAAI;YACjG,WAAW,EAAE,KAAK,EAAE,WAAW,IAAI,IAAI;YACvC,MAAM,EAAE,KAAK,EAAE,MAAM,IAAI,IAAI;YAC7B,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,SAAS;YACrC,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,IAAI;YACtC,WAAW,EAAE,OAAO,CAAC,MAAM,KAAK,IAAI,IAAI,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC;SACtF,CAAC;IACJ,CAAC;IAEO,QAAQ,CAAC,OAA6B;QAC5C,IAAI,OAAO,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;YAC7B,OAAO,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;QAChD,CAAC;QACD,OAAO,OAAO,CAAC,MAAM,CAAC;IACxB,CAAC;IAED,uGAAuG;IAC/F,WAAW,CAAC,OAA6B;QAC/C,IAAI,OAAO,CAAC,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YAC/C,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;YACrB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,IAAI,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC;YAC7C,MAAM,KAAK,GAAqB,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;YAC3E,IAAI,CAAC,QAAQ;gBACX,IAAI,CAAC,IAAI,KAAK,QAAQ;oBACpB,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE;oBAC5J,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QACrE,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;CACF","sourcesContent":["import { BehaviorSubject, type Observable } from 'rxjs';\nimport type { JSONObject } from '@memberjunction/ai';\nimport type { CapturedDisplaySurface, MediaParticipant, MediaVideoSource, VideoSourceState } from '@memberjunction/ai-realtime-client/media';\nimport { REALTIME_CAPTURE_SOURCE_IDS, type RealtimeCaptureKind, type RealtimeCaptureState } from '@memberjunction/realtime-runtime';\n\n/** Where a capture channel stands, as the agent reads it (its `status` noun) and its surface shows it. */\nexport type RealtimeCaptureStatus = 'off' | 'asked' | 'starting' | 'on' | 'failed';\n\n/** What the capture surface shows. */\nexport interface RealtimeCaptureView {\n  Kind: RealtimeCaptureKind;\n  Status: RealtimeCaptureStatus;\n  /** The agent's reason for asking, while its request stands. */\n  Reason: string | null;\n  /** Why the last start failed, while it stands. */\n  Problem: string | null;\n  /** The user's camera as `mj-self-view` takes it: while the camera is on, the same object for one stream. */\n  Participant: MediaParticipant | null;\n  /** The shared surface as `mj-share-preview` takes it: while a share is on, the same object for one stream. */\n  Source: MediaVideoSource | null;\n  /** What a share shows. */\n  Surface: CapturedDisplaySurface;\n  /** The shared panel's name, while the user shares one panel of the page; `null` otherwise. */\n  PanelLabel: string | null;\n  /**\n   * Whether the agent sees the capture now: it is on, the channel lets the agent see pixels, and the model is being sent\n   * its frames (its source among the session's video sources is on and active, which is what the \"Agent can see\" chip\n   * reads). On a model that takes one video stream, a screen share started after the camera is the one sent, so the camera\n   * is not seen until the user picks it again.\n   */\n  AgentCanSee: boolean;\n}\n\n/** The events a capture channel streams, by name. */\nexport type RealtimeCaptureEventName = 'asked' | 'declined' | 'started' | 'stopped' | 'failed';\n\n/** One change: the event to stream, if the change is one. */\nexport interface RealtimeCaptureChange {\n  Event: { Name: RealtimeCaptureEventName; Payload: JSONObject } | null;\n}\n\n/**\n * The state of one capture channel (the Camera or the Screen Share channel): the agent's request, the runtime's capture,\n * and whether the agent sees it. Framework-free: the channel feeds it and streams its changes; the surface shows its\n * {@link View$}. It decides nothing about policy: the runtime refuses a capture its channel's policy does not allow, and\n * reports that as a failed capture.\n */\nexport class RealtimeCaptureModel {\n  private reason: string | null = null;\n  private capture: RealtimeCaptureState = { Status: 'off' };\n  private agentCanSee = false;\n  /**\n   * Whether the model is being sent this capture's frames: its source is on and active. `null` until the host reports the\n   * session's sources ({@link FollowVideoSources}); a host that never does leaves the channel's exposure alone to decide.\n   */\n  private framesSent: boolean | null = null;\n  private onStream: { Stream: MediaStream; Participant: MediaParticipant | null; Source: MediaVideoSource | null } | null = null;\n  private readonly view: BehaviorSubject<RealtimeCaptureView>;\n  private changeHandler: ((change: RealtimeCaptureChange) => void) | null = null;\n\n  constructor(public readonly Kind: RealtimeCaptureKind) {\n    this.view = new BehaviorSubject<RealtimeCaptureView>(this.buildView());\n  }\n\n  /** What the surface shows now. */\n  public get View(): RealtimeCaptureView {\n    return this.view.value;\n  }\n\n  /** What the surface shows, now and on every change. */\n  public get View$(): Observable<RealtimeCaptureView> {\n    return this.view.asObservable();\n  }\n\n  /** Receives every change (one handler; `null` removes it). */\n  public OnChange(handler: ((change: RealtimeCaptureChange) => void) | null): void {\n    this.changeHandler = handler;\n  }\n\n  /**\n   * The agent asks to see the capture. A request while the capture is starting or on changes nothing.\n   *\n   * @returns Whether the request stands (the user now sees it).\n   */\n  public Ask(reason: string | null): boolean {\n    if (this.capture.Status === 'starting' || this.capture.Status === 'on') {\n      return false;\n    }\n    this.reason = reason?.trim() ?? '';\n    this.publish({ Name: 'asked', Payload: this.reason ? { reason: this.reason } : {} });\n    return true;\n  }\n\n  /** The user said \"Not now\" to the agent's request. Nothing to decline without one. */\n  public Decline(): void {\n    if (this.reason === null) {\n      return;\n    }\n    this.reason = null;\n    this.publish({ Name: 'declined', Payload: {} });\n  }\n\n  /**\n   * The runtime's capture changed. Turning on answers the agent's request, and so does a camera check that ends with the\n   * camera off: the user said not now.\n   */\n  public FollowCapture(capture: RealtimeCaptureState): void {\n    const was = this.capture;\n    this.capture = capture;\n    if (capture.Status === 'on') {\n      this.reason = null;\n    }\n    if (was.Checking && capture.Status === 'off' && this.reason !== null) {\n      this.reason = null;\n      this.publish({ Name: 'declined', Payload: {} });\n      return;\n    }\n    this.publish(this.eventFor(was.Status, capture));\n  }\n\n  /** Whether the channel lets the agent see pixels (its exposure). */\n  public SetAgentCanSee(visible: boolean): void {\n    if (visible !== this.agentCanSee) {\n      this.agentCanSee = visible;\n      this.publish(null);\n    }\n  }\n\n  /**\n   * The session's video sources changed (the runtime's `VideoSources$`). The model is sent this capture's frames only while\n   * its source (`REALTIME_CAPTURE_SOURCE_IDS`) is on and active; a capture with no source yet, or none any more, is not\n   * sent. Only the view changes: the channel's state is the same, so the change handler hears nothing and the agent is\n   * told nothing (the arbiter tells the model what it now sees).\n   */\n  public FollowVideoSources(sources: readonly VideoSourceState[]): void {\n    const sourceId = REALTIME_CAPTURE_SOURCE_IDS[this.Kind];\n    const source = sources.find((s) => s.SourceID === sourceId);\n    const sent = source !== undefined && source.Enabled && source.Active;\n    if (sent !== this.framesSent) {\n      this.framesSent = sent;\n      this.view.next(this.buildView());\n    }\n  }\n\n  /** The channel's state as the agent reads it. */\n  public ToState(): JSONObject {\n    const view = this.View;\n    const state: JSONObject = { status: view.Status, reason: view.Reason ?? '', problem: view.Problem ?? '' };\n    if (this.Kind === 'screen') {\n      state['surface'] = view.Surface;\n    }\n    return state;\n  }\n\n  /** The event a capture change is, if it is one: started, stopped or failed. */\n  private eventFor(was: RealtimeCaptureState['Status'], capture: RealtimeCaptureState): RealtimeCaptureChange['Event'] {\n    if (capture.Status === 'on' && was !== 'on') {\n      return { Name: 'started', Payload: this.Kind === 'screen' ? { surface: capture.Surface ?? 'unknown' } : {} };\n    }\n    if (capture.Status === 'off' && was === 'on') {\n      return { Name: 'stopped', Payload: {} };\n    }\n    if (capture.Status === 'failed' && was !== 'failed') {\n      return { Name: 'failed', Payload: { failure: capture.Failure ?? 'error', message: capture.Message ?? '' } };\n    }\n    return null;\n  }\n\n  private publish(event: RealtimeCaptureChange['Event']): void {\n    this.view.next(this.buildView());\n    this.changeHandler?.({ Event: event });\n  }\n\n  private buildView(): RealtimeCaptureView {\n    const capture = this.capture;\n    const shown = this.shownStream(capture);\n    return {\n      Kind: this.Kind,\n      Status: this.statusOf(capture),\n      Reason: this.reason,\n      Problem: capture.Status === 'failed' ? (capture.Message ?? 'The capture could not start.') : null,\n      Participant: shown?.Participant ?? null,\n      Source: shown?.Source ?? null,\n      Surface: capture.Surface ?? 'unknown',\n      PanelLabel: capture.PanelLabel ?? null,\n      AgentCanSee: capture.Status === 'on' && this.agentCanSee && (this.framesSent ?? true),\n    };\n  }\n\n  private statusOf(capture: RealtimeCaptureState): RealtimeCaptureStatus {\n    if (capture.Status === 'off') {\n      return this.reason !== null ? 'asked' : 'off';\n    }\n    return capture.Status;\n  }\n\n  /** The stream as the surface shows it, built once per stream so a re-render keeps the same objects. */\n  private shownStream(capture: RealtimeCaptureState): RealtimeCaptureModel['onStream'] {\n    if (capture.Status !== 'on' || !capture.Stream) {\n      this.onStream = null;\n      return null;\n    }\n    if (this.onStream?.Stream !== capture.Stream) {\n      const video: MediaVideoSource = { Kind: 'stream', Stream: capture.Stream };\n      this.onStream =\n        this.Kind === 'camera'\n          ? { Stream: capture.Stream, Participant: { Identity: 'self', DisplayName: 'You', Role: 'self', IsSpeaking: false, Video: { camera: video } }, Source: null }\n          : { Stream: capture.Stream, Participant: null, Source: video };\n    }\n    return this.onStream;\n  }\n}\n"]}

package/dist/lib/components/realtime/capture/realtime-capture-surface.component.d.ts

@@ -0,0 +1,48 @@
+import { EventEmitter, OnDestroy } from '@angular/core';
+import type { RealtimeCaptureModel, RealtimeCaptureView } from './realtime-capture-model';
+import * as i0 from "@angular/core";
+/** What the surface says for each capture. */
+interface CaptureWording {
+    Icon: string;
+    Asks: string;
+    Off: string;
+    Start: string;
+    Starting: string;
+    Hint: string;
+}
+/**
+ * `mj-realtime-capture-surface`: the Camera or Screen Share channel's surface. While the capture is off it is the ask:
+ * what the agent wants to see and why, with Turn on camera (or Share your screen) and, while the agent's request stands,
+ * Not now. While on, it is the user's own view of it: their camera mirrored (`mj-self-view`), or what they share
+ * (`mj-share-preview`, with Stop sharing and Change). It owns no rules: the {@link RealtimeCaptureModel} decides what it
+ * shows, and the channel runs the user's buttons.
+ */
+export declare class RealtimeCaptureSurfaceComponent implements OnDestroy {
+    private readonly cdr;
+    private model;
+    private viewSub;
+    /** What the surface shows now, or `null` until a model is bound. */
+    View: RealtimeCaptureView | null;
+    /** The agent's name, for "Sage asks to see your camera". */
+    AgentName: string;
+    /** The channel's state. */
+    set Model(value: RealtimeCaptureModel | null);
+    get Model(): RealtimeCaptureModel | null;
+    /** The user asked to turn the camera on, or to share a screen. */
+    StartRequested: EventEmitter<void>;
+    /** The user said "Not now" to the agent's request. */
+    DeclineRequested: EventEmitter<void>;
+    /** The user turned the camera off, or stopped sharing. */
+    StopRequested: EventEmitter<void>;
+    /** The user asked to share something else. */
+    ChangeRequested: EventEmitter<void>;
+    /** The words for this capture. */
+    get Wording(): CaptureWording;
+    /** The card's heading: the agent's request while it stands, else that the capture is off. */
+    get Heading(): string;
+    ngOnDestroy(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RealtimeCaptureSurfaceComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RealtimeCaptureSurfaceComponent, "mj-realtime-capture-surface", never, { "AgentName": { "alias": "AgentName"; "required": false; }; "Model": { "alias": "Model"; "required": false; }; }, { "StartRequested": "StartRequested"; "DeclineRequested": "DeclineRequested"; "StopRequested": "StopRequested"; "ChangeRequested": "ChangeRequested"; }, never, never, true, never>;
+}
+export {};
+//# sourceMappingURL=realtime-capture-surface.component.d.ts.map

package/dist/lib/components/realtime/capture/realtime-capture-surface.component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-capture-surface.component.d.ts","sourceRoot":"","sources":["../../../../../src/lib/components/realtime/capture/realtime-capture-surface.component.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyD,YAAY,EAAS,SAAS,EAAkB,MAAM,eAAe,CAAC;AAMtI,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;;AAE1F,8CAA8C;AAC9C,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAqBD;;;;;;GAMG;AACH,qBAQa,+BAAgC,YAAW,SAAS;IAC/D,OAAO,CAAC,QAAQ,CAAC,GAAG,CAA6B;IACjD,OAAO,CAAC,KAAK,CAAqC;IAClD,OAAO,CAAC,OAAO,CAA6B;IAE5C,oEAAoE;IAC7D,IAAI,EAAE,mBAAmB,GAAG,IAAI,CAAQ;IAE/C,4DAA4D;IACnD,SAAS,SAAmB;IAErC,2BAA2B;IAC3B,IACW,KAAK,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI,EAWlD;IACD,IAAW,KAAK,IAAI,oBAAoB,GAAG,IAAI,CAE9C;IAED,kEAAkE;IACxD,cAAc,qBAA4B;IACpD,sDAAsD;IAC5C,gBAAgB,qBAA4B;IACtD,0DAA0D;IAChD,aAAa,qBAA4B;IACnD,8CAA8C;IACpC,eAAe,qBAA4B;IAErD,kCAAkC;IAClC,IAAW,OAAO,IAAI,cAAc,CAEnC;IAED,6FAA6F;IAC7F,IAAW,OAAO,IAAI,MAAM,CAE3B;IAEM,WAAW,IAAI,IAAI;yCAhDf,+BAA+B;2CAA/B,+BAA+B;CAoD3C"}

package/dist/lib/components/realtime/capture/realtime-capture-surface.component.js

@@ -0,0 +1,205 @@
+import { ChangeDetectionStrategy, ChangeDetectorRef, Component, EventEmitter, Input, Output, inject } from '@angular/core';
+import { MJButtonDirective } from '@memberjunction/ng-ui-components';
+import { SelfViewComponent, SharePreviewComponent } from '@memberjunction/ng-realtime-media';
+import { SharedGenericModule } from '@memberjunction/ng-shared-generic';
+import * as i0 from "@angular/core";
+import * as i1 from "@memberjunction/ng-shared-generic";
+function RealtimeCaptureSurfaceComponent_Conditional_0_Case_0_Conditional_0_Template(rf, ctx) { if (rf & 1) {
+    const _r1 = i0.ɵɵgetCurrentView();
+    i0.ɵɵelementStart(0, "div", 2);
+    i0.ɵɵelement(1, "mj-self-view", 4);
+    i0.ɵɵelementStart(2, "div", 5)(3, "button", 6);
+    i0.ɵɵlistener("click", function RealtimeCaptureSurfaceComponent_Conditional_0_Case_0_Conditional_0_Template_button_click_3_listener() { i0.ɵɵrestoreView(_r1); const ctx_r1 = i0.ɵɵnextContext(3); return i0.ɵɵresetView(ctx_r1.StopRequested.emit()); });
+    i0.ɵɵtext(4, "Turn off camera");
+    i0.ɵɵelementEnd()()();
+} if (rf & 2) {
+    const view_r3 = i0.ɵɵnextContext(2);
+    i0.ɵɵadvance();
+    i0.ɵɵproperty("Participant", view_r3.Participant)("AgentCanSee", view_r3.AgentCanSee)("ShowHide", false)("ShowMeter", false)("ShowConnectionQuality", false)("ShowActiveSpeakerRing", false);
+} }
+function RealtimeCaptureSurfaceComponent_Conditional_0_Case_0_Conditional_1_Template(rf, ctx) { if (rf & 1) {
+    const _r4 = i0.ɵɵgetCurrentView();
+    i0.ɵɵelementStart(0, "mj-share-preview", 7);
+    i0.ɵɵlistener("StopRequested", function RealtimeCaptureSurfaceComponent_Conditional_0_Case_0_Conditional_1_Template_mj_share_preview_StopRequested_0_listener() { i0.ɵɵrestoreView(_r4); const ctx_r1 = i0.ɵɵnextContext(3); return i0.ɵɵresetView(ctx_r1.StopRequested.emit()); })("ChangeRequested", function RealtimeCaptureSurfaceComponent_Conditional_0_Case_0_Conditional_1_Template_mj_share_preview_ChangeRequested_0_listener() { i0.ɵɵrestoreView(_r4); const ctx_r1 = i0.ɵɵnextContext(3); return i0.ɵɵresetView(ctx_r1.ChangeRequested.emit()); });
+    i0.ɵɵelementEnd();
+} if (rf & 2) {
+    const view_r3 = i0.ɵɵnextContext(2);
+    i0.ɵɵproperty("Source", view_r3.Source)("Surface", view_r3.Surface)("PanelLabel", view_r3.PanelLabel);
+} }
+function RealtimeCaptureSurfaceComponent_Conditional_0_Case_0_Template(rf, ctx) { if (rf & 1) {
+    i0.ɵɵconditionalCreate(0, RealtimeCaptureSurfaceComponent_Conditional_0_Case_0_Conditional_0_Template, 5, 6, "div", 2)(1, RealtimeCaptureSurfaceComponent_Conditional_0_Case_0_Conditional_1_Template, 1, 3, "mj-share-preview", 3);
+} if (rf & 2) {
+    const view_r3 = i0.ɵɵnextContext();
+    i0.ɵɵconditional(view_r3.Kind === "camera" ? 0 : 1);
+} }
+function RealtimeCaptureSurfaceComponent_Conditional_0_Case_1_Template(rf, ctx) { if (rf & 1) {
+    i0.ɵɵelementStart(0, "div", 0);
+    i0.ɵɵelement(1, "mj-loading", 8);
+    i0.ɵɵelementEnd();
+} if (rf & 2) {
+    const ctx_r1 = i0.ɵɵnextContext(2);
+    i0.ɵɵadvance();
+    i0.ɵɵproperty("Text", ctx_r1.Wording.Starting);
+} }
+function RealtimeCaptureSurfaceComponent_Conditional_0_Case_2_Conditional_5_Template(rf, ctx) { if (rf & 1) {
+    i0.ɵɵelementStart(0, "p", 12);
+    i0.ɵɵtext(1);
+    i0.ɵɵelementEnd();
+} if (rf & 2) {
+    const view_r3 = i0.ɵɵnextContext(2);
+    i0.ɵɵadvance();
+    i0.ɵɵtextInterpolate(view_r3.Reason);
+} }
+function RealtimeCaptureSurfaceComponent_Conditional_0_Case_2_Conditional_6_Template(rf, ctx) { if (rf & 1) {
+    i0.ɵɵelementStart(0, "p", 13);
+    i0.ɵɵtext(1);
+    i0.ɵɵelementEnd();
+} if (rf & 2) {
+    const view_r3 = i0.ɵɵnextContext(2);
+    i0.ɵɵadvance();
+    i0.ɵɵtextInterpolate(view_r3.Problem);
+} }
+function RealtimeCaptureSurfaceComponent_Conditional_0_Case_2_Conditional_10_Template(rf, ctx) { if (rf & 1) {
+    const _r6 = i0.ɵɵgetCurrentView();
+    i0.ɵɵelementStart(0, "button", 18);
+    i0.ɵɵlistener("click", function RealtimeCaptureSurfaceComponent_Conditional_0_Case_2_Conditional_10_Template_button_click_0_listener() { i0.ɵɵrestoreView(_r6); const ctx_r1 = i0.ɵɵnextContext(3); return i0.ɵɵresetView(ctx_r1.DeclineRequested.emit()); });
+    i0.ɵɵtext(1, "Not now");
+    i0.ɵɵelementEnd();
+} }
+function RealtimeCaptureSurfaceComponent_Conditional_0_Case_2_Template(rf, ctx) { if (rf & 1) {
+    const _r5 = i0.ɵɵgetCurrentView();
+    i0.ɵɵelementStart(0, "div", 1)(1, "div", 9);
+    i0.ɵɵelement(2, "i", 10);
+    i0.ɵɵelementStart(3, "h3", 11);
+    i0.ɵɵtext(4);
+    i0.ɵɵelementEnd();
+    i0.ɵɵconditionalCreate(5, RealtimeCaptureSurfaceComponent_Conditional_0_Case_2_Conditional_5_Template, 2, 1, "p", 12);
+    i0.ɵɵconditionalCreate(6, RealtimeCaptureSurfaceComponent_Conditional_0_Case_2_Conditional_6_Template, 2, 1, "p", 13);
+    i0.ɵɵelementStart(7, "div", 14)(8, "button", 15);
+    i0.ɵɵlistener("click", function RealtimeCaptureSurfaceComponent_Conditional_0_Case_2_Template_button_click_8_listener() { i0.ɵɵrestoreView(_r5); const ctx_r1 = i0.ɵɵnextContext(2); return i0.ɵɵresetView(ctx_r1.StartRequested.emit()); });
+    i0.ɵɵtext(9);
+    i0.ɵɵelementEnd();
+    i0.ɵɵconditionalCreate(10, RealtimeCaptureSurfaceComponent_Conditional_0_Case_2_Conditional_10_Template, 2, 0, "button", 16);
+    i0.ɵɵelementEnd();
+    i0.ɵɵelementStart(11, "p", 17);
+    i0.ɵɵtext(12);
+    i0.ɵɵelementEnd()()();
+} if (rf & 2) {
+    const view_r3 = i0.ɵɵnextContext();
+    const ctx_r1 = i0.ɵɵnextContext();
+    i0.ɵɵadvance(2);
+    i0.ɵɵclassMap(ctx_r1.Wording.Icon);
+    i0.ɵɵadvance(2);
+    i0.ɵɵtextInterpolate(ctx_r1.Heading);
+    i0.ɵɵadvance();
+    i0.ɵɵconditional(view_r3.Reason ? 5 : -1);
+    i0.ɵɵadvance();
+    i0.ɵɵconditional(view_r3.Problem ? 6 : -1);
+    i0.ɵɵadvance(3);
+    i0.ɵɵtextInterpolate(ctx_r1.Wording.Start);
+    i0.ɵɵadvance();
+    i0.ɵɵconditional(view_r3.Reason !== null ? 10 : -1);
+    i0.ɵɵadvance(2);
+    i0.ɵɵtextInterpolate(ctx_r1.Wording.Hint);
+} }
+function RealtimeCaptureSurfaceComponent_Conditional_0_Template(rf, ctx) { if (rf & 1) {
+    i0.ɵɵconditionalCreate(0, RealtimeCaptureSurfaceComponent_Conditional_0_Case_0_Template, 2, 1)(1, RealtimeCaptureSurfaceComponent_Conditional_0_Case_1_Template, 2, 1, "div", 0)(2, RealtimeCaptureSurfaceComponent_Conditional_0_Case_2_Template, 13, 8, "div", 1);
+} if (rf & 2) {
+    let tmp_2_0;
+    i0.ɵɵconditional((tmp_2_0 = ctx.Status) === "on" ? 0 : tmp_2_0 === "starting" ? 1 : 2);
+} }
+const WORDING = {
+    camera: {
+        Icon: 'fa-solid fa-video',
+        Asks: 'asks to see your camera',
+        Off: 'Your camera is off',
+        Start: 'Turn on camera',
+        Starting: 'Waiting for your camera…',
+        Hint: 'Only you can turn your camera on or off.',
+    },
+    screen: {
+        Icon: 'fa-solid fa-display',
+        Asks: 'asks to see your screen',
+        Off: 'Nothing is shared',
+        Start: 'Share your screen',
+        Starting: "Choose what to share in your browser's window.",
+        Hint: 'Only you choose what to share, and you can stop at any time.',
+    },
+};
+/**
+ * `mj-realtime-capture-surface`: the Camera or Screen Share channel's surface. While the capture is off it is the ask:
+ * what the agent wants to see and why, with Turn on camera (or Share your screen) and, while the agent's request stands,
+ * Not now. While on, it is the user's own view of it: their camera mirrored (`mj-self-view`), or what they share
+ * (`mj-share-preview`, with Stop sharing and Change). It owns no rules: the {@link RealtimeCaptureModel} decides what it
+ * shows, and the channel runs the user's buttons.
+ */
+export class RealtimeCaptureSurfaceComponent {
+    cdr = inject(ChangeDetectorRef);
+    model = null;
+    viewSub = null;
+    /** What the surface shows now, or `null` until a model is bound. */
+    View = null;
+    /** The agent's name, for "Sage asks to see your camera". */
+    AgentName = 'The assistant';
+    /** The channel's state. */
+    set Model(value) {
+        if (value === this.model) {
+            return;
+        }
+        this.viewSub?.unsubscribe();
+        this.model = value;
+        this.viewSub =
+            value?.View$.subscribe((view) => {
+                this.View = view;
+                this.cdr.markForCheck();
+            }) ?? null;
+    }
+    get Model() {
+        return this.model;
+    }
+    /** The user asked to turn the camera on, or to share a screen. */
+    StartRequested = new EventEmitter();
+    /** The user said "Not now" to the agent's request. */
+    DeclineRequested = new EventEmitter();
+    /** The user turned the camera off, or stopped sharing. */
+    StopRequested = new EventEmitter();
+    /** The user asked to share something else. */
+    ChangeRequested = new EventEmitter();
+    /** The words for this capture. */
+    get Wording() {
+        return WORDING[this.View?.Kind ?? 'camera'];
+    }
+    /** The card's heading: the agent's request while it stands, else that the capture is off. */
+    get Heading() {
+        return this.View?.Reason !== null && this.View?.Reason !== undefined ? `${this.AgentName} ${this.Wording.Asks}` : this.Wording.Off;
+    }
+    ngOnDestroy() {
+        this.viewSub?.unsubscribe();
+        this.viewSub = null;
+    }
+    static ɵfac = function RealtimeCaptureSurfaceComponent_Factory(__ngFactoryType__) { return new (__ngFactoryType__ || RealtimeCaptureSurfaceComponent)(); };
+    static ɵcmp = /*@__PURE__*/ i0.ɵɵdefineComponent({ type: RealtimeCaptureSurfaceComponent, selectors: [["mj-realtime-capture-surface"]], inputs: { AgentName: "AgentName", Model: "Model" }, outputs: { StartRequested: "StartRequested", DeclineRequested: "DeclineRequested", StopRequested: "StopRequested", ChangeRequested: "ChangeRequested" }, decls: 1, vars: 1, consts: [["role", "status", 1, "capture", "capture--card"], [1, "capture", "capture--card"], [1, "capture", "capture--live"], [1, "capture", "capture--live", 3, "Source", "Surface", "PanelLabel"], [1, "capture__self", 3, "Participant", "AgentCanSee", "ShowHide", "ShowMeter", "ShowConnectionQuality", "ShowActiveSpeakerRing"], [1, "capture__bar"], ["type", "button", "mjButton", "", "Variant", "danger", "Size", "sm", 3, "click"], [1, "capture", "capture--live", 3, "StopRequested", "ChangeRequested", "Source", "Surface", "PanelLabel"], ["Size", "small", 1, "capture__loading", 3, "Text"], [1, "capture__ask"], ["aria-hidden", "true", 1, "capture__icon"], [1, "capture__title"], [1, "capture__reason"], ["role", "alert", 1, "capture__problem"], [1, "capture__actions"], ["type", "button", "mjButton", "", "Variant", "primary", 3, "click"], ["type", "button", "mjButton", "", "Variant", "secondary"], [1, "capture__hint"], ["type", "button", "mjButton", "", "Variant", "secondary", 3, "click"]], template: function RealtimeCaptureSurfaceComponent_Template(rf, ctx) { if (rf & 1) {
+            i0.ɵɵconditionalCreate(0, RealtimeCaptureSurfaceComponent_Conditional_0_Template, 3, 1);
+        } if (rf & 2) {
+            let tmp_0_0;
+            i0.ɵɵconditional((tmp_0_0 = ctx.View) ? 0 : -1, tmp_0_0);
+        } }, dependencies: [MJButtonDirective, SelfViewComponent, SharePreviewComponent, SharedGenericModule, i1.LoadingComponent], styles: ["[_nghost-%COMP%] {\n  display: block;\n  box-sizing: border-box;\n  height: 100%;\n  background: var(--mj-bg-surface);\n  color: var(--mj-text-primary);\n}\n\n.capture[_ngcontent-%COMP%] {\n  box-sizing: border-box;\n  height: 100%;\n}\n\n.capture--live[_ngcontent-%COMP%] {\n  display: flex;\n  flex-direction: column;\n}\n\n.capture__self[_ngcontent-%COMP%] {\n  flex: 1 1 auto;\n  min-height: 0;\n}\n\n.capture__bar[_ngcontent-%COMP%] {\n  display: flex;\n  justify-content: center;\n  padding: var(--mj-space-2, 8px);\n}\n\n.capture--card[_ngcontent-%COMP%] {\n  display: flex;\n  flex-direction: column;\n  padding: var(--mj-space-3, 12px);\n  text-align: center;\n  overflow-y: auto;\n}\n\n\n.capture__ask[_ngcontent-%COMP%] {\n  display: flex;\n  flex-direction: column;\n  align-items: center;\n  gap: var(--mj-space-2, 8px);\n  margin: auto 0;\n}\n\n.capture__loading[_ngcontent-%COMP%] {\n  flex: 1 1 auto;\n}\n\n.capture__icon[_ngcontent-%COMP%] {\n  font-size: 1.5rem;\n  color: var(--mj-text-secondary);\n}\n\n.capture__title[_ngcontent-%COMP%] {\n  margin: 0;\n  font-size: 1rem;\n  font-weight: 600;\n  color: var(--mj-text-primary);\n}\n\n.capture__hint[_ngcontent-%COMP%] {\n  margin: 0;\n  font-size: 0.875rem;\n  color: var(--mj-text-secondary);\n}\n\n.capture__reason[_ngcontent-%COMP%] {\n  margin: 0;\n  font-size: 0.9375rem;\n  color: var(--mj-text-primary);\n}\n\n.capture__problem[_ngcontent-%COMP%] {\n  margin: 0;\n  font-size: 0.875rem;\n  color: var(--mj-status-error-text);\n}\n\n.capture__actions[_ngcontent-%COMP%] {\n  display: flex;\n  flex-wrap: wrap;\n  justify-content: center;\n  gap: var(--mj-space-2, 8px);\n}"], changeDetection: 0 });
+}
+(() => { (typeof ngDevMode === "undefined" || ngDevMode) && i0.ɵsetClassMetadata(RealtimeCaptureSurfaceComponent, [{
+        type: Component,
+        args: [{ standalone: true, selector: 'mj-realtime-capture-surface', imports: [MJButtonDirective, SelfViewComponent, SharePreviewComponent, SharedGenericModule], changeDetection: ChangeDetectionStrategy.OnPush, template: "@if (View; as view) {\n  @switch (view.Status) {\n    @case ('on') {\n      @if (view.Kind === 'camera') {\n        <div class=\"capture capture--live\">\n          <mj-self-view\n            class=\"capture__self\"\n            [Participant]=\"view.Participant\"\n            [AgentCanSee]=\"view.AgentCanSee\"\n            [ShowHide]=\"false\"\n            [ShowMeter]=\"false\"\n            [ShowConnectionQuality]=\"false\"\n            [ShowActiveSpeakerRing]=\"false\">\n          </mj-self-view>\n          <div class=\"capture__bar\">\n            <button type=\"button\" mjButton Variant=\"danger\" Size=\"sm\" (click)=\"StopRequested.emit()\">Turn off camera</button>\n          </div>\n        </div>\n      } @else {\n        <mj-share-preview\n          class=\"capture capture--live\"\n          [Source]=\"view.Source\"\n          [Surface]=\"view.Surface\"\n          [PanelLabel]=\"view.PanelLabel\"\n          (StopRequested)=\"StopRequested.emit()\"\n          (ChangeRequested)=\"ChangeRequested.emit()\">\n        </mj-share-preview>\n      }\n    }\n    @case ('starting') {\n      <div class=\"capture capture--card\" role=\"status\">\n        <mj-loading class=\"capture__loading\" [Text]=\"Wording.Starting\" Size=\"small\"></mj-loading>\n      </div>\n    }\n    @default {\n      <!-- The ask centres itself while it fits and scrolls when the box is shorter than it. -->\n      <div class=\"capture capture--card\">\n        <div class=\"capture__ask\">\n          <i class=\"capture__icon\" [class]=\"Wording.Icon\" aria-hidden=\"true\"></i>\n          <h3 class=\"capture__title\">{{ Heading }}</h3>\n          @if (view.Reason) {\n            <p class=\"capture__reason\">{{ view.Reason }}</p>\n          }\n          @if (view.Problem) {\n            <p class=\"capture__problem\" role=\"alert\">{{ view.Problem }}</p>\n          }\n          <div class=\"capture__actions\">\n            <button type=\"button\" mjButton Variant=\"primary\" (click)=\"StartRequested.emit()\">{{ Wording.Start }}</button>\n            @if (view.Reason !== null) {\n              <button type=\"button\" mjButton Variant=\"secondary\" (click)=\"DeclineRequested.emit()\">Not now</button>\n            }\n          </div>\n          <p class=\"capture__hint\">{{ Wording.Hint }}</p>\n        </div>\n      </div>\n    }\n  }\n}\n", styles: [":host {\n  display: block;\n  box-sizing: border-box;\n  height: 100%;\n  background: var(--mj-bg-surface);\n  color: var(--mj-text-primary);\n}\n\n.capture {\n  box-sizing: border-box;\n  height: 100%;\n}\n\n.capture--live {\n  display: flex;\n  flex-direction: column;\n}\n\n.capture__self {\n  flex: 1 1 auto;\n  min-height: 0;\n}\n\n.capture__bar {\n  display: flex;\n  justify-content: center;\n  padding: var(--mj-space-2, 8px);\n}\n\n.capture--card {\n  display: flex;\n  flex-direction: column;\n  padding: var(--mj-space-3, 12px);\n  text-align: center;\n  overflow-y: auto;\n}\n\n/* Auto margins centre the ask while it fits; unlike justify-content, they never push it past the top when it does not. */\n.capture__ask {\n  display: flex;\n  flex-direction: column;\n  align-items: center;\n  gap: var(--mj-space-2, 8px);\n  margin: auto 0;\n}\n\n.capture__loading {\n  flex: 1 1 auto;\n}\n\n.capture__icon {\n  font-size: 1.5rem;\n  color: var(--mj-text-secondary);\n}\n\n.capture__title {\n  margin: 0;\n  font-size: 1rem;\n  font-weight: 600;\n  color: var(--mj-text-primary);\n}\n\n.capture__hint {\n  margin: 0;\n  font-size: 0.875rem;\n  color: var(--mj-text-secondary);\n}\n\n.capture__reason {\n  margin: 0;\n  font-size: 0.9375rem;\n  color: var(--mj-text-primary);\n}\n\n.capture__problem {\n  margin: 0;\n  font-size: 0.875rem;\n  color: var(--mj-status-error-text);\n}\n\n.capture__actions {\n  display: flex;\n  flex-wrap: wrap;\n  justify-content: center;\n  gap: var(--mj-space-2, 8px);\n}\n"] }]
+    }], null, { AgentName: [{
+            type: Input
+        }], Model: [{
+            type: Input
+        }], StartRequested: [{
+            type: Output
+        }], DeclineRequested: [{
+            type: Output
+        }], StopRequested: [{
+            type: Output
+        }], ChangeRequested: [{
+            type: Output
+        }] }); })();
+(() => { (typeof ngDevMode === "undefined" || ngDevMode) && i0.ɵsetClassDebugInfo(RealtimeCaptureSurfaceComponent, { className: "RealtimeCaptureSurfaceComponent", filePath: "src/lib/components/realtime/capture/realtime-capture-surface.component.ts", lineNumber: 53 }); })();
+//# sourceMappingURL=realtime-capture-surface.component.js.map

package/dist/lib/components/realtime/capture/realtime-capture-surface.component.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-capture-surface.component.js","sourceRoot":"","sources":["../../../../../src/lib/components/realtime/capture/realtime-capture-surface.component.ts","../../../../../src/lib/components/realtime/capture/realtime-capture-surface.component.html"],"names":[],"mappings":"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","sourcesContent":["import { ChangeDetectionStrategy, ChangeDetectorRef, Component, EventEmitter, Input, OnDestroy, Output, inject } from '@angular/core';\nimport type { Subscription } from 'rxjs';\nimport type { RealtimeCaptureKind } from '@memberjunction/realtime-runtime';\nimport { MJButtonDirective } from '@memberjunction/ng-ui-components';\nimport { SelfViewComponent, SharePreviewComponent } from '@memberjunction/ng-realtime-media';\nimport { SharedGenericModule } from '@memberjunction/ng-shared-generic';\nimport type { RealtimeCaptureModel, RealtimeCaptureView } from './realtime-capture-model';\n\n/** What the surface says for each capture. */\ninterface CaptureWording {\n  Icon: string;\n  Asks: string;\n  Off: string;\n  Start: string;\n  Starting: string;\n  Hint: string;\n}\n\nconst WORDING: Record<RealtimeCaptureKind, CaptureWording> = {\n  camera: {\n    Icon: 'fa-solid fa-video',\n    Asks: 'asks to see your camera',\n    Off: 'Your camera is off',\n    Start: 'Turn on camera',\n    Starting: 'Waiting for your camera…',\n    Hint: 'Only you can turn your camera on or off.',\n  },\n  screen: {\n    Icon: 'fa-solid fa-display',\n    Asks: 'asks to see your screen',\n    Off: 'Nothing is shared',\n    Start: 'Share your screen',\n    Starting: \"Choose what to share in your browser's window.\",\n    Hint: 'Only you choose what to share, and you can stop at any time.',\n  },\n};\n\n/**\n * `mj-realtime-capture-surface`: the Camera or Screen Share channel's surface. While the capture is off it is the ask:\n * what the agent wants to see and why, with Turn on camera (or Share your screen) and, while the agent's request stands,\n * Not now. While on, it is the user's own view of it: their camera mirrored (`mj-self-view`), or what they share\n * (`mj-share-preview`, with Stop sharing and Change). It owns no rules: the {@link RealtimeCaptureModel} decides what it\n * shows, and the channel runs the user's buttons.\n */\n@Component({\n  standalone: true,\n  selector: 'mj-realtime-capture-surface',\n  imports: [MJButtonDirective, SelfViewComponent, SharePreviewComponent, SharedGenericModule],\n  changeDetection: ChangeDetectionStrategy.OnPush,\n  templateUrl: './realtime-capture-surface.component.html',\n  styleUrls: ['./realtime-capture-surface.component.css'],\n})\nexport class RealtimeCaptureSurfaceComponent implements OnDestroy {\n  private readonly cdr = inject(ChangeDetectorRef);\n  private model: RealtimeCaptureModel | null = null;\n  private viewSub: Subscription | null = null;\n\n  /** What the surface shows now, or `null` until a model is bound. */\n  public View: RealtimeCaptureView | null = null;\n\n  /** The agent's name, for \"Sage asks to see your camera\". */\n  @Input() AgentName = 'The assistant';\n\n  /** The channel's state. */\n  @Input()\n  public set Model(value: RealtimeCaptureModel | null) {\n    if (value === this.model) {\n      return;\n    }\n    this.viewSub?.unsubscribe();\n    this.model = value;\n    this.viewSub =\n      value?.View$.subscribe((view) => {\n        this.View = view;\n        this.cdr.markForCheck();\n      }) ?? null;\n  }\n  public get Model(): RealtimeCaptureModel | null {\n    return this.model;\n  }\n\n  /** The user asked to turn the camera on, or to share a screen. */\n  @Output() StartRequested = new EventEmitter<void>();\n  /** The user said \"Not now\" to the agent's request. */\n  @Output() DeclineRequested = new EventEmitter<void>();\n  /** The user turned the camera off, or stopped sharing. */\n  @Output() StopRequested = new EventEmitter<void>();\n  /** The user asked to share something else. */\n  @Output() ChangeRequested = new EventEmitter<void>();\n\n  /** The words for this capture. */\n  public get Wording(): CaptureWording {\n    return WORDING[this.View?.Kind ?? 'camera'];\n  }\n\n  /** The card's heading: the agent's request while it stands, else that the capture is off. */\n  public get Heading(): string {\n    return this.View?.Reason !== null && this.View?.Reason !== undefined ? `${this.AgentName} ${this.Wording.Asks}` : this.Wording.Off;\n  }\n\n  public ngOnDestroy(): void {\n    this.viewSub?.unsubscribe();\n    this.viewSub = null;\n  }\n}\n","@if (View; as view) {\n  @switch (view.Status) {\n    @case ('on') {\n      @if (view.Kind === 'camera') {\n        <div class=\"capture capture--live\">\n          <mj-self-view\n            class=\"capture__self\"\n            [Participant]=\"view.Participant\"\n            [AgentCanSee]=\"view.AgentCanSee\"\n            [ShowHide]=\"false\"\n            [ShowMeter]=\"false\"\n            [ShowConnectionQuality]=\"false\"\n            [ShowActiveSpeakerRing]=\"false\">\n          </mj-self-view>\n          <div class=\"capture__bar\">\n            <button type=\"button\" mjButton Variant=\"danger\" Size=\"sm\" (click)=\"StopRequested.emit()\">Turn off camera</button>\n          </div>\n        </div>\n      } @else {\n        <mj-share-preview\n          class=\"capture capture--live\"\n          [Source]=\"view.Source\"\n          [Surface]=\"view.Surface\"\n          [PanelLabel]=\"view.PanelLabel\"\n          (StopRequested)=\"StopRequested.emit()\"\n          (ChangeRequested)=\"ChangeRequested.emit()\">\n        </mj-share-preview>\n      }\n    }\n    @case ('starting') {\n      <div class=\"capture capture--card\" role=\"status\">\n        <mj-loading class=\"capture__loading\" [Text]=\"Wording.Starting\" Size=\"small\"></mj-loading>\n      </div>\n    }\n    @default {\n      <!-- The ask centres itself while it fits and scrolls when the box is shorter than it. -->\n      <div class=\"capture capture--card\">\n        <div class=\"capture__ask\">\n          <i class=\"capture__icon\" [class]=\"Wording.Icon\" aria-hidden=\"true\"></i>\n          <h3 class=\"capture__title\">{{ Heading }}</h3>\n          @if (view.Reason) {\n            <p class=\"capture__reason\">{{ view.Reason }}</p>\n          }\n          @if (view.Problem) {\n            <p class=\"capture__problem\" role=\"alert\">{{ view.Problem }}</p>\n          }\n          <div class=\"capture__actions\">\n            <button type=\"button\" mjButton Variant=\"primary\" (click)=\"StartRequested.emit()\">{{ Wording.Start }}</button>\n            @if (view.Reason !== null) {\n              <button type=\"button\" mjButton Variant=\"secondary\" (click)=\"DeclineRequested.emit()\">Not now</button>\n            }\n          </div>\n          <p class=\"capture__hint\">{{ Wording.Hint }}</p>\n        </div>\n      </div>\n    }\n  }\n}\n"]}

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

@@ -1,4 +1,5 @@
 import { RealtimeToolDefinition } from '@memberjunction/ai';
+import { type RealtimeChannelDescriptor } from '@memberjunction/ai-core-plus';
 import { BaseRealtimeChannelClient } from '@memberjunction/realtime-runtime';
 /** The stable name of the single proxy tool this channel registers with the realtime provider. */
 export declare const CONTEXT_TOOL_NAME = "ContextTool";
@@ -19,11 +20,25 @@ export declare class ClientContextChannel extends BaseRealtimeChannelClient<obje
     /** Declares the single stable proxy tool. */
     GetToolDefinitions(): RealtimeToolDefinition[];
     /**
-     * Routes a `ContextTool({ action, params })` call to the host's registered surface client tool.
+     * The channel's self-description. It has NO verbs of its own: it is the door, not a room — `ContextTool`
+     * runs app client tools, or addresses another channel through `target`. Declaring that explicitly keeps
+     * it from being addressed as if it were a channel with things to do.
+     */
+    GetDescriptor(): RealtimeChannelDescriptor;
+    /**
+     * Routes a `ContextTool({ action, params, target? })` call. With a `target` the call is handed to the
+     * runtime, which validates it against the addressed channel's verb schema (a malformed call comes back
+     * as a structured, model-recoverable error) and opens an `on-demand` channel when asked; without one it
+     * runs the host's registered surface client tool, exactly as before.
+     *
      * Tolerant: malformed args, a missing host executor, or an unknown/throwing tool all serialize to
      * a structured `{ success: false, output }` the model narrates (never throws).
      */
     ApplyAgentTool(toolName: string, argsJson: string): Promise<string>;
+    /** Runs a channel-addressed call through the runtime and serializes its structured outcome. */
+    private applyChannelAction;
+    /** The model-facing shape of a dispatch outcome: success carries the result; a refusal carries what to fix. */
+    private serializeDispatchOutcome;
     /** Headless — no surface to bind. */
     BindSurface(): void;
     /**
@@ -32,8 +47,10 @@ export declare class ClientContextChannel extends BaseRealtimeChannelClient<obje
      * (custom apps) simply get no streaming, and the session-start prompt injection still applies.
      */
     protected OnInitialize(): void;
-    /** Tolerantly parses the `{ action, params }` arguments. */
+    /** Tolerantly parses the `{ action, params, target? }` arguments. */
     private parseArgs;
+    /** Reads a `target` — `{ channel, instance? }` — or `null` when absent or unusable (the call is then an app action). */
+    private parseTarget;
     /** Unsubscribes the app-context stream and tears down. */
     Dispose(): void;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"client-context-channel.d.ts","sourceRoot":"","sources":["../../../../../src/lib/components/realtime/channels/client-context-channel.ts"],"names":[],"mappings":"AA8BA,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAI5D,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAE7E,kGAAkG;AAClG,eAAO,MAAM,iBAAiB,gBAAgB,CAAC;AA0B/C;;;GAGG;AACH,qBACa,oBAAqB,SAAQ,yBAAyB,CAAC,MAAM,CAAC;IACzE,4FAA4F;IAC5F,OAAO,CAAC,aAAa,CAA6B;IAElD,+DAA+D;IAC/D,IAAW,WAAW,IAAI,MAAM,CAE/B;IAED,0FAA0F;IAC1F,IAAW,cAAc,IAAI,MAAM,CAElC;IAED,kFAAkF;IAClF,IAAW,QAAQ,IAAI,MAAM,CAE5B;IACD,IAAW,OAAO,IAAI,MAAM,CAE3B;IAED,6CAA6C;IACtC,kBAAkB,IAAI,sBAAsB,EAAE;IAIrD;;;;OAIG;IACU,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAqBhF,qCAAqC;IAC9B,WAAW,IAAI,IAAI;IAI1B;;;;OAIG;cACgB,YAAY,IAAI,IAAI;IAkBvC,4DAA4D;IAC5D,OAAO,CAAC,SAAS;IAcjB,0DAA0D;IAC1C,OAAO,IAAI,IAAI;CAKhC;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C"}
+{"version":3,"file":"client-context-channel.d.ts","sourceRoot":"","sources":["../../../../../src/lib/components/realtime/channels/client-context-channel.ts"],"names":[],"mappings":"AA8BA,OAAO,EAAc,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,EAA2D,KAAK,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AAGvI,OAAO,EAAE,yBAAyB,EAAoC,MAAM,kCAAkC,CAAC;AAE/G,kGAAkG;AAClG,eAAO,MAAM,iBAAiB,gBAAgB,CAAC;AAsC/C;;;GAGG;AACH,qBACa,oBAAqB,SAAQ,yBAAyB,CAAC,MAAM,CAAC;IACzE,4FAA4F;IAC5F,OAAO,CAAC,aAAa,CAA6B;IAElD,+DAA+D;IAC/D,IAAW,WAAW,IAAI,MAAM,CAE/B;IAED,0FAA0F;IAC1F,IAAW,cAAc,IAAI,MAAM,CAElC;IAED,kFAAkF;IAClF,IAAW,QAAQ,IAAI,MAAM,CAE5B;IACD,IAAW,OAAO,IAAI,MAAM,CAE3B;IAED,6CAA6C;IACtC,kBAAkB,IAAI,sBAAsB,EAAE;IAIrD;;;;OAIG;IACa,aAAa,IAAI,yBAAyB;IAgB1D;;;;;;;;OAQG;IACU,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAwBhF,+FAA+F;YACjF,kBAAkB;IAchC,+GAA+G;IAC/G,OAAO,CAAC,wBAAwB;IAahC,qCAAqC;IAC9B,WAAW,IAAI,IAAI;IAI1B;;;;OAIG;cACgB,YAAY,IAAI,IAAI;IAkBvC,qEAAqE;IACrE,OAAO,CAAC,SAAS;IAkBjB,wHAAwH;IACxH,OAAO,CAAC,WAAW;IAanB,0DAA0D;IAC1C,OAAO,IAAI,IAAI;CAKhC;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C"}

package/dist/lib/components/realtime/channels/client-context-channel.js

@@ -34,7 +34,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
  * @module @memberjunction/ng-conversations
  */
 import { RegisterClass } from '@memberjunction/global';
-import { FormatAppContextNote } from '@memberjunction/ai-core-plus';
+import { FormatAppContextNote, REALTIME_CHANNEL_CONTRACT_VERSION } from '@memberjunction/ai-core-plus';
 import { distinctUntilChanged } from 'rxjs/operators';
 import { BaseRealtimeChannelClient } from '@memberjunction/realtime-runtime';
 /** The stable name of the single proxy tool this channel registers with the realtime provider. */
@@ -42,10 +42,13 @@ export const CONTEXT_TOOL_NAME = 'ContextTool';
 /** The single stable proxy tool — declared once; the live catalog of valid `action`s rides context. */
 const CONTEXT_TOOL_DEFINITION = {
     Name: CONTEXT_TOOL_NAME,
-    Description: "Perform an action in the application the user is currently in. The set of valid actions (the " +
-        "client tools and the things you can do on the current surface) is provided to you continuously " +
-        "as context — only call actions listed as currently available. Pass the action name and its " +
-        "parameters.",
+    Description: "Perform an action in the application the user is currently in, or on one of the interactive " +
+        "channels listed in your channel notes. The set of valid actions (the client tools and the things " +
+        "you can do on the current surface) is provided to you continuously as context — only call actions " +
+        "listed as currently available. Pass the action name and its parameters. To act on an interactive " +
+        "channel instead of the app, also pass `target` naming the channel (and, for a channel that has " +
+        "several, the instance); to open a channel that is available but not open yet, use action \"open\" " +
+        "with that target.",
     ParametersSchema: {
         type: 'object',
         properties: {
@@ -56,6 +59,15 @@ const CONTEXT_TOOL_DEFINITION = {
             params: {
                 type: 'object',
                 description: "The action's parameters, matching its advertised input schema."
+            },
+            target: {
+                type: 'object',
+                description: 'Set this to act on an interactive channel rather than the app. Omit it for app actions.',
+                properties: {
+                    channel: { type: 'string', description: 'The channel to address (from your channel notes).' },
+                    instance: { type: 'string', description: 'Which instance, for a channel that has several. Usually omitted.' }
+                },
+                required: ['channel']
             }
         },
         required: ['action']
@@ -88,7 +100,30 @@ let ClientContextChannel = class ClientContextChannel extends BaseRealtimeChanne
         return [CONTEXT_TOOL_DEFINITION];
     }
     /**
-     * Routes a `ContextTool({ action, params })` call to the host's registered surface client tool.
+     * The channel's self-description. It has NO verbs of its own: it is the door, not a room — `ContextTool`
+     * runs app client tools, or addresses another channel through `target`. Declaring that explicitly keeps
+     * it from being addressed as if it were a channel with things to do.
+     */
+    GetDescriptor() {
+        return {
+            Key: this.ChannelName,
+            Version: REALTIME_CHANNEL_CONTRACT_VERSION,
+            DisplayName: this.TabTitle,
+            Instructions: 'Keeps you aware of where the user is in the app and lets you act there through ContextTool. ' +
+                'It is not itself something to operate.',
+            Nouns: [],
+            Verbs: [],
+            DisplayPolicy: 'headless',
+            DefaultAvailability: 'all-sessions',
+            MaxExposure: 'state'
+        };
+    }
+    /**
+     * Routes a `ContextTool({ action, params, target? })` call. With a `target` the call is handed to the
+     * runtime, which validates it against the addressed channel's verb schema (a malformed call comes back
+     * as a structured, model-recoverable error) and opens an `on-demand` channel when asked; without one it
+     * runs the host's registered surface client tool, exactly as before.
+     *
      * Tolerant: malformed args, a missing host executor, or an unknown/throwing tool all serialize to
      * a structured `{ success: false, output }` the model narrates (never throws).
      */
@@ -100,6 +135,9 @@ let ClientContextChannel = class ClientContextChannel extends BaseRealtimeChanne
         if (!parsed.action) {
             return JSON.stringify({ success: false, output: 'ContextTool requires an "action" naming the tool to run.' });
         }
+        if (parsed.target) {
+            return this.applyChannelAction(parsed.action, parsed.params, parsed.target);
+        }
         const executor = this.Context?.ExecuteClientTool;
         if (!executor) {
             return JSON.stringify({
@@ -112,6 +150,29 @@ let ClientContextChannel = class ClientContextChannel extends BaseRealtimeChanne
             ? JSON.stringify({ success: true, output: result.Result ?? 'Done.' })
             : JSON.stringify({ success: false, output: result.ErrorMessage ?? 'The action could not be performed.' });
     }
+    /** Runs a channel-addressed call through the runtime and serializes its structured outcome. */
+    async applyChannelAction(action, params, target) {
+        const dispatch = this.Context?.DispatchContextAction;
+        if (!dispatch) {
+            return JSON.stringify({ success: false, output: 'Channel actions are not available in this session.' });
+        }
+        // The params came off the wire as JSON, so they are JSON by construction.
+        const outcome = await dispatch({ Target: { Channel: target.channel, Instance: target.instance }, Action: action, Params: params });
+        return JSON.stringify(this.serializeDispatchOutcome(outcome));
+    }
+    /** The model-facing shape of a dispatch outcome: success carries the result; a refusal carries what to fix. */
+    serializeDispatchOutcome(outcome) {
+        if (outcome.Success) {
+            return { success: true, output: outcome.Result ?? 'Done.' };
+        }
+        return {
+            success: false,
+            output: outcome.ErrorMessage ?? 'The action could not be performed.',
+            errorCode: outcome.ErrorCode,
+            ...(outcome.Details ? { details: outcome.Details } : {}),
+            ...(outcome.Available ? { available: outcome.Available } : {})
+        };
+    }
     /** Headless — no surface to bind. */
     BindSurface() {
         /* no-op: this channel renders no surface */
@@ -138,7 +199,7 @@ let ClientContextChannel = class ClientContextChannel extends BaseRealtimeChanne
             }
         });
     }
-    /** Tolerantly parses the `{ action, params }` arguments. */
+    /** Tolerantly parses the `{ action, params, target? }` arguments. */
     parseArgs(argsJson) {
         try {
             const parsed = JSON.parse(argsJson);
@@ -146,11 +207,24 @@ let ClientContextChannel = class ClientContextChannel extends BaseRealtimeChanne
             const params = parsed.params && typeof parsed.params === 'object' && !Array.isArray(parsed.params)
                 ? parsed.params
                 : {};
-            return { action, params };
+            return { action, params, target: this.parseTarget(parsed.target) };
         }
         catch {
-            return { action: null, params: {} };
+            return { action: null, params: {}, target: null };
+        }
+    }
+    /** Reads a `target` — `{ channel, instance? }` — or `null` when absent or unusable (the call is then an app action). */
+    parseTarget(raw) {
+        if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {
+            return null;
+        }
+        const target = raw;
+        const channel = typeof target.channel === 'string' ? target.channel.trim() : '';
+        if (channel.length === 0) {
+            return null;
         }
+        const instance = typeof target.instance === 'string' && target.instance.trim().length > 0 ? target.instance.trim() : undefined;
+        return instance ? { channel, instance } : { channel };
     }
     /** Unsubscribes the app-context stream and tears down. */
     Dispose() {

package/dist/lib/components/realtime/channels/client-context-channel.js.map

@@ -1 +1 @@
-{"version":3,"file":"client-context-channel.js","sourceRoot":"","sources":["../../../../../src/lib/components/realtime/channels/client-context-channel.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @fileoverview The headless **Client Context** channel — the browser half of the live wire that\n * keeps the realtime co-agent continuously aware of the user's app context and lets it act in the\n * app through a single stable proxy tool.\n *\n * Paired with `ClientContextChannelServer` (`@memberjunction/ai-agents`) via the seeded\n * `MJ: AI Agent Channels` row (`Name: 'ClientContextChannel'`, `IsHeadless: 1`,\n * `ClientPluginClass: 'ClientContextChannel'`).\n *\n * Two responsibilities, both client-side (no server round-trip in the client-direct topology):\n *\n *  1. **Perception (streaming).** It subscribes to the host's live app-context stream\n *     ({@link RealtimeChannelContext.AppContext$}, fed by Explorer from `NavigationService`) and, on\n *     every change, pushes a compact `SendContextNote` so the model always knows where the user is,\n *     what they see, and which tools/agents are available — the *continuous* half of client-context\n *     delivery (the session-start half is injected into the companion prompt server-side at mint).\n *\n *  2. **Action (the `ContextTool` proxy).** It declares ONE stable tool, `ContextTool`, so the\n *     provider tool surface never changes mid-session (which connect-bound providers reject). The\n *     model invokes any currently-available surface client tool via `ContextTool({ action, params })`;\n *     the channel routes that to the host's {@link RealtimeChannelContext.ExecuteClientTool} (which runs\n *     the surface handler the host registered from `SetAgentClientTools`) and returns a structured\n *     result the model narrates.\n *\n * **Headless:** no surface component — it never mounts a tab (`GetSurfaceComponent` stays `null`;\n * `BindSurface` is a no-op). It is a wire, not a panel.\n *\n * @module @memberjunction/ng-conversations\n */\nimport { RegisterClass } from '@memberjunction/global';\nimport { RealtimeToolDefinition } from '@memberjunction/ai';\nimport { FormatAppContextNote } from '@memberjunction/ai-core-plus';\nimport { Subscription } from 'rxjs';\nimport { distinctUntilChanged } from 'rxjs/operators';\nimport { BaseRealtimeChannelClient } from '@memberjunction/realtime-runtime';\n\n/** The stable name of the single proxy tool this channel registers with the realtime provider. */\nexport const CONTEXT_TOOL_NAME = 'ContextTool';\n\n/** The single stable proxy tool — declared once; the live catalog of valid `action`s rides context. */\nconst CONTEXT_TOOL_DEFINITION: RealtimeToolDefinition = {\n  Name: CONTEXT_TOOL_NAME,\n  Description:\n    \"Perform an action in the application the user is currently in. The set of valid actions (the \" +\n    \"client tools and the things you can do on the current surface) is provided to you continuously \" +\n    \"as context — only call actions listed as currently available. Pass the action name and its \" +\n    \"parameters.\",\n  ParametersSchema: {\n    type: 'object',\n    properties: {\n      action: {\n        type: 'string',\n        description: 'The name of a currently-available action/tool to run (from the context you were given).'\n      },\n      params: {\n        type: 'object',\n        description: \"The action's parameters, matching its advertised input schema.\"\n      }\n    },\n    required: ['action']\n  }\n};\n\n/**\n * The headless Client Context channel client. One instance per realtime session (created by the\n * session service from the `MJ: AI Agent Channels` registry — never construct directly).\n */\n@RegisterClass(BaseRealtimeChannelClient, 'ClientContextChannel')\nexport class ClientContextChannel extends BaseRealtimeChannelClient<object> {\n  /** Subscription to the host app-context stream (perception); cleared on {@link Dispose}. */\n  private appContextSub: Subscription | null = null;\n\n  /** Matches the seeded `MJ: AI Agent Channels` row's `Name`. */\n  public get ChannelName(): string {\n    return 'ClientContextChannel';\n  }\n\n  /** Routing prefix — the single `ContextTool` matches `ContextTool`.startsWith(prefix). */\n  public get ToolNamePrefix(): string {\n    return CONTEXT_TOOL_NAME;\n  }\n\n  /** Headless — never rendered, but the abstract contract requires a label/icon. */\n  public get TabTitle(): string {\n    return 'App Context';\n  }\n  public get TabIcon(): string {\n    return 'fa-solid fa-satellite-dish';\n  }\n\n  /** Declares the single stable proxy tool. */\n  public GetToolDefinitions(): RealtimeToolDefinition[] {\n    return [CONTEXT_TOOL_DEFINITION];\n  }\n\n  /**\n   * Routes a `ContextTool({ action, params })` call to the host's registered surface client tool.\n   * Tolerant: malformed args, a missing host executor, or an unknown/throwing tool all serialize to\n   * a structured `{ success: false, output }` the model narrates (never throws).\n   */\n  public async ApplyAgentTool(toolName: string, argsJson: string): Promise<string> {\n    if (toolName !== CONTEXT_TOOL_NAME) {\n      return JSON.stringify({ success: false, output: `Unknown context tool \"${toolName}\".` });\n    }\n    const parsed = this.parseArgs(argsJson);\n    if (!parsed.action) {\n      return JSON.stringify({ success: false, output: 'ContextTool requires an \"action\" naming the tool to run.' });\n    }\n    const executor = this.Context?.ExecuteClientTool;\n    if (!executor) {\n      return JSON.stringify({\n        success: false,\n        output: 'No app surface is available to perform that action right now.'\n      });\n    }\n    const result = await executor(parsed.action, parsed.params);\n    return result.Success\n      ? JSON.stringify({ success: true, output: result.Result ?? 'Done.' })\n      : JSON.stringify({ success: false, output: result.ErrorMessage ?? 'The action could not be performed.' });\n  }\n\n  /** Headless — no surface to bind. */\n  public BindSurface(): void {\n    /* no-op: this channel renders no surface */\n  }\n\n  /**\n   * Subscribes to the host's live app-context stream and streams each change to the model as a\n   * compact context note (the perception half). Null-safe — hosts that supply no `AppContext$`\n   * (custom apps) simply get no streaming, and the session-start prompt injection still applies.\n   */\n  protected override OnInitialize(): void {\n    const stream = this.Context?.AppContext$;\n    if (!stream) {\n      return;\n    }\n    this.appContextSub = stream\n      .pipe(distinctUntilChanged((a, b) => JSON.stringify(a) === JSON.stringify(b)))\n      .subscribe((snapshot) => {\n        if (!snapshot) {\n          return;\n        }\n        const note = FormatAppContextNote(snapshot);\n        if (note) {\n          this.Context?.SendContextNote(note);\n        }\n      });\n  }\n\n  /** Tolerantly parses the `{ action, params }` arguments. */\n  private parseArgs(argsJson: string): { action: string | null; params: Record<string, unknown> } {\n    try {\n      const parsed = JSON.parse(argsJson) as { action?: unknown; params?: unknown };\n      const action = typeof parsed.action === 'string' && parsed.action.trim().length > 0 ? parsed.action.trim() : null;\n      const params =\n        parsed.params && typeof parsed.params === 'object' && !Array.isArray(parsed.params)\n          ? (parsed.params as Record<string, unknown>)\n          : {};\n      return { action, params };\n    } catch {\n      return { action: null, params: {} };\n    }\n  }\n\n  /** Unsubscribes the app-context stream and tears down. */\n  public override Dispose(): void {\n    this.appContextSub?.unsubscribe();\n    this.appContextSub = null;\n    super.Dispose();\n  }\n}\n\n/**\n * Tree-shaking prevention for {@link ClientContextChannel}'s `@RegisterClass` registration. Called\n * from a static code path in `conversations.module.ts` so the registration always executes —\n * mirroring every other realtime channel client.\n */\nexport function LoadClientContextChannel(): void {\n  // no-op — the import + call create a static reference bundlers cannot eliminate\n}\n"]}
+{"version":3,"file":"client-context-channel.js","sourceRoot":"","sources":["../../../../../src/lib/components/realtime/channels/client-context-channel.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @fileoverview The headless **Client Context** channel — the browser half of the live wire that\n * keeps the realtime co-agent continuously aware of the user's app context and lets it act in the\n * app through a single stable proxy tool.\n *\n * Paired with `ClientContextChannelServer` (`@memberjunction/ai-agents`) via the seeded\n * `MJ: AI Agent Channels` row (`Name: 'ClientContextChannel'`, `IsHeadless: 1`,\n * `ClientPluginClass: 'ClientContextChannel'`).\n *\n * Two responsibilities, both client-side (no server round-trip in the client-direct topology):\n *\n *  1. **Perception (streaming).** It subscribes to the host's live app-context stream\n *     ({@link RealtimeChannelContext.AppContext$}, fed by Explorer from `NavigationService`) and, on\n *     every change, pushes a compact `SendContextNote` so the model always knows where the user is,\n *     what they see, and which tools/agents are available — the *continuous* half of client-context\n *     delivery (the session-start half is injected into the companion prompt server-side at mint).\n *\n *  2. **Action (the `ContextTool` proxy).** It declares ONE stable tool, `ContextTool`, so the\n *     provider tool surface never changes mid-session (which connect-bound providers reject). The\n *     model invokes any currently-available surface client tool via `ContextTool({ action, params })`;\n *     the channel routes that to the host's {@link RealtimeChannelContext.ExecuteClientTool} (which runs\n *     the surface handler the host registered from `SetAgentClientTools`) and returns a structured\n *     result the model narrates.\n *\n * **Headless:** no surface component — it never mounts a tab (`GetSurfaceComponent` stays `null`;\n * `BindSurface` is a no-op). It is a wire, not a panel.\n *\n * @module @memberjunction/ng-conversations\n */\nimport { RegisterClass } from '@memberjunction/global';\nimport { JSONObject, RealtimeToolDefinition } from '@memberjunction/ai';\nimport { FormatAppContextNote, REALTIME_CHANNEL_CONTRACT_VERSION, type RealtimeChannelDescriptor } from '@memberjunction/ai-core-plus';\nimport { Subscription } from 'rxjs';\nimport { distinctUntilChanged } from 'rxjs/operators';\nimport { BaseRealtimeChannelClient, type RealtimeContextActionResult } from '@memberjunction/realtime-runtime';\n\n/** The stable name of the single proxy tool this channel registers with the realtime provider. */\nexport const CONTEXT_TOOL_NAME = 'ContextTool';\n\n/** The single stable proxy tool — declared once; the live catalog of valid `action`s rides context. */\nconst CONTEXT_TOOL_DEFINITION: RealtimeToolDefinition = {\n  Name: CONTEXT_TOOL_NAME,\n  Description:\n    \"Perform an action in the application the user is currently in, or on one of the interactive \" +\n    \"channels listed in your channel notes. The set of valid actions (the client tools and the things \" +\n    \"you can do on the current surface) is provided to you continuously as context — only call actions \" +\n    \"listed as currently available. Pass the action name and its parameters. To act on an interactive \" +\n    \"channel instead of the app, also pass `target` naming the channel (and, for a channel that has \" +\n    \"several, the instance); to open a channel that is available but not open yet, use action \\\"open\\\" \" +\n    \"with that target.\",\n  ParametersSchema: {\n    type: 'object',\n    properties: {\n      action: {\n        type: 'string',\n        description: 'The name of a currently-available action/tool to run (from the context you were given).'\n      },\n      params: {\n        type: 'object',\n        description: \"The action's parameters, matching its advertised input schema.\"\n      },\n      target: {\n        type: 'object',\n        description: 'Set this to act on an interactive channel rather than the app. Omit it for app actions.',\n        properties: {\n          channel: { type: 'string', description: 'The channel to address (from your channel notes).' },\n          instance: { type: 'string', description: 'Which instance, for a channel that has several. Usually omitted.' }\n        },\n        required: ['channel']\n      }\n    },\n    required: ['action']\n  }\n};\n\n/**\n * The headless Client Context channel client. One instance per realtime session (created by the\n * session service from the `MJ: AI Agent Channels` registry — never construct directly).\n */\n@RegisterClass(BaseRealtimeChannelClient, 'ClientContextChannel')\nexport class ClientContextChannel extends BaseRealtimeChannelClient<object> {\n  /** Subscription to the host app-context stream (perception); cleared on {@link Dispose}. */\n  private appContextSub: Subscription | null = null;\n\n  /** Matches the seeded `MJ: AI Agent Channels` row's `Name`. */\n  public get ChannelName(): string {\n    return 'ClientContextChannel';\n  }\n\n  /** Routing prefix — the single `ContextTool` matches `ContextTool`.startsWith(prefix). */\n  public get ToolNamePrefix(): string {\n    return CONTEXT_TOOL_NAME;\n  }\n\n  /** Headless — never rendered, but the abstract contract requires a label/icon. */\n  public get TabTitle(): string {\n    return 'App Context';\n  }\n  public get TabIcon(): string {\n    return 'fa-solid fa-satellite-dish';\n  }\n\n  /** Declares the single stable proxy tool. */\n  public GetToolDefinitions(): RealtimeToolDefinition[] {\n    return [CONTEXT_TOOL_DEFINITION];\n  }\n\n  /**\n   * The channel's self-description. It has NO verbs of its own: it is the door, not a room — `ContextTool`\n   * runs app client tools, or addresses another channel through `target`. Declaring that explicitly keeps\n   * it from being addressed as if it were a channel with things to do.\n   */\n  public override GetDescriptor(): RealtimeChannelDescriptor {\n    return {\n      Key: this.ChannelName,\n      Version: REALTIME_CHANNEL_CONTRACT_VERSION,\n      DisplayName: this.TabTitle,\n      Instructions:\n        'Keeps you aware of where the user is in the app and lets you act there through ContextTool. ' +\n        'It is not itself something to operate.',\n      Nouns: [],\n      Verbs: [],\n      DisplayPolicy: 'headless',\n      DefaultAvailability: 'all-sessions',\n      MaxExposure: 'state'\n    };\n  }\n\n  /**\n   * Routes a `ContextTool({ action, params, target? })` call. With a `target` the call is handed to the\n   * runtime, which validates it against the addressed channel's verb schema (a malformed call comes back\n   * as a structured, model-recoverable error) and opens an `on-demand` channel when asked; without one it\n   * runs the host's registered surface client tool, exactly as before.\n   *\n   * Tolerant: malformed args, a missing host executor, or an unknown/throwing tool all serialize to\n   * a structured `{ success: false, output }` the model narrates (never throws).\n   */\n  public async ApplyAgentTool(toolName: string, argsJson: string): Promise<string> {\n    if (toolName !== CONTEXT_TOOL_NAME) {\n      return JSON.stringify({ success: false, output: `Unknown context tool \"${toolName}\".` });\n    }\n    const parsed = this.parseArgs(argsJson);\n    if (!parsed.action) {\n      return JSON.stringify({ success: false, output: 'ContextTool requires an \"action\" naming the tool to run.' });\n    }\n    if (parsed.target) {\n      return this.applyChannelAction(parsed.action, parsed.params, parsed.target);\n    }\n    const executor = this.Context?.ExecuteClientTool;\n    if (!executor) {\n      return JSON.stringify({\n        success: false,\n        output: 'No app surface is available to perform that action right now.'\n      });\n    }\n    const result = await executor(parsed.action, parsed.params);\n    return result.Success\n      ? JSON.stringify({ success: true, output: result.Result ?? 'Done.' })\n      : JSON.stringify({ success: false, output: result.ErrorMessage ?? 'The action could not be performed.' });\n  }\n\n  /** Runs a channel-addressed call through the runtime and serializes its structured outcome. */\n  private async applyChannelAction(\n    action: string,\n    params: Record<string, unknown>,\n    target: { channel: string; instance?: string }\n  ): Promise<string> {\n    const dispatch = this.Context?.DispatchContextAction;\n    if (!dispatch) {\n      return JSON.stringify({ success: false, output: 'Channel actions are not available in this session.' });\n    }\n    // The params came off the wire as JSON, so they are JSON by construction.\n    const outcome = await dispatch({ Target: { Channel: target.channel, Instance: target.instance }, Action: action, Params: params as JSONObject });\n    return JSON.stringify(this.serializeDispatchOutcome(outcome));\n  }\n\n  /** The model-facing shape of a dispatch outcome: success carries the result; a refusal carries what to fix. */\n  private serializeDispatchOutcome(outcome: RealtimeContextActionResult): Record<string, unknown> {\n    if (outcome.Success) {\n      return { success: true, output: outcome.Result ?? 'Done.' };\n    }\n    return {\n      success: false,\n      output: outcome.ErrorMessage ?? 'The action could not be performed.',\n      errorCode: outcome.ErrorCode,\n      ...(outcome.Details ? { details: outcome.Details } : {}),\n      ...(outcome.Available ? { available: outcome.Available } : {})\n    };\n  }\n\n  /** Headless — no surface to bind. */\n  public BindSurface(): void {\n    /* no-op: this channel renders no surface */\n  }\n\n  /**\n   * Subscribes to the host's live app-context stream and streams each change to the model as a\n   * compact context note (the perception half). Null-safe — hosts that supply no `AppContext$`\n   * (custom apps) simply get no streaming, and the session-start prompt injection still applies.\n   */\n  protected override OnInitialize(): void {\n    const stream = this.Context?.AppContext$;\n    if (!stream) {\n      return;\n    }\n    this.appContextSub = stream\n      .pipe(distinctUntilChanged((a, b) => JSON.stringify(a) === JSON.stringify(b)))\n      .subscribe((snapshot) => {\n        if (!snapshot) {\n          return;\n        }\n        const note = FormatAppContextNote(snapshot);\n        if (note) {\n          this.Context?.SendContextNote(note);\n        }\n      });\n  }\n\n  /** Tolerantly parses the `{ action, params, target? }` arguments. */\n  private parseArgs(argsJson: string): {\n    action: string | null;\n    params: Record<string, unknown>;\n    target: { channel: string; instance?: string } | null;\n  } {\n    try {\n      const parsed = JSON.parse(argsJson) as { action?: unknown; params?: unknown; target?: unknown };\n      const action = typeof parsed.action === 'string' && parsed.action.trim().length > 0 ? parsed.action.trim() : null;\n      const params =\n        parsed.params && typeof parsed.params === 'object' && !Array.isArray(parsed.params)\n          ? (parsed.params as Record<string, unknown>)\n          : {};\n      return { action, params, target: this.parseTarget(parsed.target) };\n    } catch {\n      return { action: null, params: {}, target: null };\n    }\n  }\n\n  /** Reads a `target` — `{ channel, instance? }` — or `null` when absent or unusable (the call is then an app action). */\n  private parseTarget(raw: unknown): { channel: string; instance?: string } | null {\n    if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {\n      return null;\n    }\n    const target = raw as { channel?: unknown; instance?: unknown };\n    const channel = typeof target.channel === 'string' ? target.channel.trim() : '';\n    if (channel.length === 0) {\n      return null;\n    }\n    const instance = typeof target.instance === 'string' && target.instance.trim().length > 0 ? target.instance.trim() : undefined;\n    return instance ? { channel, instance } : { channel };\n  }\n\n  /** Unsubscribes the app-context stream and tears down. */\n  public override Dispose(): void {\n    this.appContextSub?.unsubscribe();\n    this.appContextSub = null;\n    super.Dispose();\n  }\n}\n\n/**\n * Tree-shaking prevention for {@link ClientContextChannel}'s `@RegisterClass` registration. Called\n * from a static code path in `conversations.module.ts` so the registration always executes —\n * mirroring every other realtime channel client.\n */\nexport function LoadClientContextChannel(): void {\n  // no-op — the import + call create a static reference bundlers cannot eliminate\n}\n"]}