@memberjunction/ng-conversations 5.43.0 → 5.45.0

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

@@ -0,0 +1,174 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+/**
+ * @fileoverview The headless **Client Context** channel — the browser half of the live wire that
+ * keeps the realtime co-agent continuously aware of the user's app context and lets it act in the
+ * app through a single stable proxy tool.
+ *
+ * Paired with `ClientContextChannelServer` (`@memberjunction/ai-agents`) via the seeded
+ * `MJ: AI Agent Channels` row (`Name: 'ClientContextChannel'`, `IsHeadless: 1`,
+ * `ClientPluginClass: 'ClientContextChannel'`).
+ *
+ * Two responsibilities, both client-side (no server round-trip in the client-direct topology):
+ *
+ *  1. **Perception (streaming).** It subscribes to the host's live app-context stream
+ *     ({@link RealtimeChannelContext.AppContext$}, fed by Explorer from `NavigationService`) and, on
+ *     every change, pushes a compact `SendContextNote` so the model always knows where the user is,
+ *     what they see, and which tools/agents are available — the *continuous* half of client-context
+ *     delivery (the session-start half is injected into the companion prompt server-side at mint).
+ *
+ *  2. **Action (the `ContextTool` proxy).** It declares ONE stable tool, `ContextTool`, so the
+ *     provider tool surface never changes mid-session (which connect-bound providers reject). The
+ *     model invokes any currently-available surface client tool via `ContextTool({ action, params })`;
+ *     the channel routes that to the host's {@link RealtimeChannelContext.ExecuteClientTool} (which runs
+ *     the surface handler the host registered from `SetAgentClientTools`) and returns a structured
+ *     result the model narrates.
+ *
+ * **Headless:** no surface component — it never mounts a tab (`GetSurfaceComponent` stays `null`;
+ * `BindSurface` is a no-op). It is a wire, not a panel.
+ *
+ * @module @memberjunction/ng-conversations
+ */
+import { RegisterClass } from '@memberjunction/global';
+import { FormatAppContextNote } from '@memberjunction/ai-core-plus';
+import { distinctUntilChanged } from 'rxjs/operators';
+import { BaseRealtimeChannelClient } from './base-realtime-channel-client';
+/** The stable name of the single proxy tool this channel registers with the realtime provider. */
+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.",
+    ParametersSchema: {
+        type: 'object',
+        properties: {
+            action: {
+                type: 'string',
+                description: 'The name of a currently-available action/tool to run (from the context you were given).'
+            },
+            params: {
+                type: 'object',
+                description: "The action's parameters, matching its advertised input schema."
+            }
+        },
+        required: ['action']
+    }
+};
+/**
+ * The headless Client Context channel client. One instance per realtime session (created by the
+ * session service from the `MJ: AI Agent Channels` registry — never construct directly).
+ */
+let ClientContextChannel = class ClientContextChannel extends BaseRealtimeChannelClient {
+    /** Subscription to the host app-context stream (perception); cleared on {@link Dispose}. */
+    appContextSub = null;
+    /** Matches the seeded `MJ: AI Agent Channels` row's `Name`. */
+    get ChannelName() {
+        return 'ClientContextChannel';
+    }
+    /** Routing prefix — the single `ContextTool` matches `ContextTool`.startsWith(prefix). */
+    get ToolNamePrefix() {
+        return CONTEXT_TOOL_NAME;
+    }
+    /** Headless — never rendered, but the abstract contract requires a label/icon. */
+    get TabTitle() {
+        return 'App Context';
+    }
+    get TabIcon() {
+        return 'fa-solid fa-satellite-dish';
+    }
+    /** Declares the single stable proxy tool. */
+    GetToolDefinitions() {
+        return [CONTEXT_TOOL_DEFINITION];
+    }
+    /**
+     * Routes a `ContextTool({ action, params })` call to the host's registered surface client tool.
+     * 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).
+     */
+    async ApplyAgentTool(toolName, argsJson) {
+        if (toolName !== CONTEXT_TOOL_NAME) {
+            return JSON.stringify({ success: false, output: `Unknown context tool "${toolName}".` });
+        }
+        const parsed = this.parseArgs(argsJson);
+        if (!parsed.action) {
+            return JSON.stringify({ success: false, output: 'ContextTool requires an "action" naming the tool to run.' });
+        }
+        const executor = this.Context?.ExecuteClientTool;
+        if (!executor) {
+            return JSON.stringify({
+                success: false,
+                output: 'No app surface is available to perform that action right now.'
+            });
+        }
+        const result = await executor(parsed.action, parsed.params);
+        return result.Success
+            ? JSON.stringify({ success: true, output: result.Result ?? 'Done.' })
+            : JSON.stringify({ success: false, output: result.ErrorMessage ?? 'The action could not be performed.' });
+    }
+    /** Headless — no surface to bind. */
+    BindSurface() {
+        /* no-op: this channel renders no surface */
+    }
+    /**
+     * Subscribes to the host's live app-context stream and streams each change to the model as a
+     * compact context note (the perception half). Null-safe — hosts that supply no `AppContext$`
+     * (custom apps) simply get no streaming, and the session-start prompt injection still applies.
+     */
+    OnInitialize() {
+        const stream = this.Context?.AppContext$;
+        if (!stream) {
+            return;
+        }
+        this.appContextSub = stream
+            .pipe(distinctUntilChanged((a, b) => JSON.stringify(a) === JSON.stringify(b)))
+            .subscribe((snapshot) => {
+            if (!snapshot) {
+                return;
+            }
+            const note = FormatAppContextNote(snapshot);
+            if (note) {
+                this.Context?.SendContextNote(note);
+            }
+        });
+    }
+    /** Tolerantly parses the `{ action, params }` arguments. */
+    parseArgs(argsJson) {
+        try {
+            const parsed = JSON.parse(argsJson);
+            const action = typeof parsed.action === 'string' && parsed.action.trim().length > 0 ? parsed.action.trim() : null;
+            const params = parsed.params && typeof parsed.params === 'object' && !Array.isArray(parsed.params)
+                ? parsed.params
+                : {};
+            return { action, params };
+        }
+        catch {
+            return { action: null, params: {} };
+        }
+    }
+    /** Unsubscribes the app-context stream and tears down. */
+    Dispose() {
+        this.appContextSub?.unsubscribe();
+        this.appContextSub = null;
+        super.Dispose();
+    }
+};
+ClientContextChannel = __decorate([
+    RegisterClass(BaseRealtimeChannelClient, 'ClientContextChannel')
+], ClientContextChannel);
+export { ClientContextChannel };
+/**
+ * Tree-shaking prevention for {@link ClientContextChannel}'s `@RegisterClass` registration. Called
+ * from a static code path in `conversations.module.ts` so the registration always executes —
+ * mirroring every other realtime channel client.
+ */
+export function LoadClientContextChannel() {
+    // no-op — the import + call create a static reference bundlers cannot eliminate
+}
+//# sourceMappingURL=client-context-channel.js.map

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

@@ -0,0 +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 './base-realtime-channel-client';\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"]}

package/dist/lib/components/realtime/evidence-playback/realtime-evidence-playback.component.d.ts

@@ -0,0 +1,123 @@
+import { EventEmitter, OnDestroy } from '@angular/core';
+import * as i0 from "@angular/core";
+/**
+ * The MINIMAL structural shape of a transcript turn this player needs — exactly the fields it reads
+ * for the click-to-seek transcript and the playhead-sync highlight. Deliberately NOT the full
+ * `MJConversationDetailEntity`: that keeps the player reusable by ANY caller that can supply these
+ * fields (the in-conversation session-review overlay passes its lighter `RealtimeSessionReviewTurn`;
+ * the Realtime Recordings dashboard passes full `MJConversationDetailEntity` rows — both satisfy this
+ * widened shape structurally).
+ *
+ * Field unions/nullability are intentionally WIDER than the generated entity so an
+ * `MJConversationDetailEntity[]` remains assignable here.
+ */
+export interface EvidencePlaybackTurn {
+    /** Stable identity for the `@for` track. */
+    ID: string;
+    /** Speaker. The player only distinguishes `'User'` (human) from everything else (the agent). */
+    Role: 'User' | 'AI' | 'Assistant' | 'Error' | string;
+    /** The transcript text shown on the turn. */
+    Message: string | null;
+    /** Persisted turn time — fallback offset origin when the turn has no `UtteranceStartMs`. */
+    __mj_CreatedAt: Date | null;
+    /**
+     * Precise media-relative start (ms from recording t0). `null`/absent when the driver supplied no
+     * timing — the player falls back to (`__mj_CreatedAt` − `RecordingStartedAt`).
+     */
+    UtteranceStartMs?: number | null;
+    /** Precise media-relative end (ms from recording t0). `null`/absent → derived from the next turn / duration. */
+    UtteranceEndMs?: number | null;
+}
+/**
+ * TIME-ALIGNED EVIDENCE PLAYBACK (`mj-realtime-evidence-playback`) — replays a realtime session's
+ * recorded audio next to its transcript, with the two kept in sync. The audio gets a custom transport
+ * (play/pause, a synthetic waveform scrubber, time/duration readout); the transcript is a scrollable
+ * list of clickable turns. Clicking a turn seeks the audio to that turn's start and plays; as the audio
+ * plays, the turn whose `[UtteranceStartMs, UtteranceEndMs]` window contains the playhead is highlighted.
+ *
+ * Timestamps come from {@link EvidencePlaybackTurn.UtteranceStartMs}; when a turn has none, the
+ * component falls back to (`__mj_CreatedAt` − {@link RecordingStartedAt}). Generic + Router-free: all
+ * state arrives via inputs, the only output is {@link TurnSeek}.
+ */
+export declare class RealtimeEvidencePlaybackComponent implements OnDestroy {
+    /** The session's transcript turns, in chronological order. */
+    set Turns(value: EvidencePlaybackTurn[] | null);
+    get Turns(): EvidencePlaybackTurn[];
+    private _turns;
+    /** The recorded session audio URL, or `null` when no recording is available. */
+    set AudioUrl(value: string | null);
+    get AudioUrl(): string | null;
+    private _audioUrl;
+    /** When the recording started, used to derive a turn's offset when it has no `UtteranceStartMs`. */
+    RecordingStartedAt: Date | null;
+    /** Display name of the agent — labels and colors AI turns. */
+    AgentName: string;
+    /** Emitted when the user clicks a transcript turn (to seek the audio to it). */
+    TurnSeek: EventEmitter<EvidencePlaybackTurn>;
+    /** Current playhead position in ms (driven by the audio element's `timeupdate`). */
+    CurrentMs: number;
+    /** Total audio duration in ms (set on `loadedmetadata`). */
+    DurationMs: number;
+    /** Whether the audio is currently playing. */
+    IsPlaying: boolean;
+    /** The synthetic waveform bar heights (stable per AudioUrl). */
+    readonly WaveformBars: number[];
+    private audioRef?;
+    private readonly cdr;
+    ngOnDestroy(): void;
+    /** The `<audio>` element, or `null` before the view initializes / when there's no audio. */
+    private get audioEl();
+    /** Playhead progress as a fraction (0..1), for the scrubber fill + waveform reveal. */
+    get Progress(): number;
+    /** Toggles audio play / pause. */
+    TogglePlay(): void;
+    /** Seeks to a fraction of the duration (scrubber click / keyboard). */
+    SeekToFraction(fraction: number): void;
+    /** Scrubber pointer handler — maps the click X within the track to a seek fraction. */
+    OnScrubberClick(event: MouseEvent, track: HTMLElement): void;
+    /** Scrubber keyboard handler — arrows nudge ±5s, Home/End jump to ends, Space toggles play. */
+    OnScrubberKeydown(event: KeyboardEvent): void;
+    /** Clicking a transcript turn → seek the audio to it, play, and emit {@link TurnSeek}. */
+    SeekToTurn(turn: EvidencePlaybackTurn): void;
+    /** True when the playhead falls within this turn's utterance window (drives the active highlight). */
+    IsTurnActive(turn: EvidencePlaybackTurn): boolean;
+    /** Whether a turn is from the human user (vs. the agent) — drives the speaker color + label. */
+    IsUserTurn(turn: EvidencePlaybackTurn): boolean;
+    /** The speaker label for a turn. */
+    SpeakerLabel(turn: EvidencePlaybackTurn): string;
+    /** The mm:ss timestamp shown on a turn (its start offset within the recording). */
+    TurnTimestamp(turn: EvidencePlaybackTurn): string;
+    /** mm:ss of the current playhead. */
+    get CurrentLabel(): string;
+    /** mm:ss of the total duration. */
+    get DurationLabel(): string;
+    /** Stable `@for` track for the transcript. */
+    TrackByTurn(_index: number, turn: EvidencePlaybackTurn): string;
+    /** `loadedmetadata` → capture the duration. */
+    OnLoadedMetadata(): void;
+    /** `timeupdate` → advance the playhead + re-evaluate the active turn. */
+    OnTimeUpdate(): void;
+    /** `play` / `pause` / `ended` → reflect the transport state. */
+    OnPlay(): void;
+    OnPause(): void;
+    OnEnded(): void;
+    /** Nudges the playhead by `deltaMs`, clamped to the duration. */
+    private seekByMs;
+    /**
+     * A turn's start offset (ms) within the recording: prefer {@link EvidencePlaybackTurn.UtteranceStartMs};
+     * fall back to (`__mj_CreatedAt` − {@link RecordingStartedAt}); 0 when neither is available.
+     */
+    private turnStartMs;
+    /**
+     * A turn's end offset (ms): prefer {@link EvidencePlaybackTurn.UtteranceEndMs}; otherwise the
+     * next turn's start; otherwise the recording duration (or start + a small window when duration is unknown).
+     */
+    private turnEndMs;
+    /** Formats a ms offset as mm:ss (clamped at 0). */
+    private formatMs;
+    /** Builds a stable pseudo-random waveform (deterministic, no per-render churn). */
+    private buildWaveform;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RealtimeEvidencePlaybackComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RealtimeEvidencePlaybackComponent, "mj-realtime-evidence-playback", never, { "Turns": { "alias": "Turns"; "required": false; }; "AudioUrl": { "alias": "AudioUrl"; "required": false; }; "RecordingStartedAt": { "alias": "RecordingStartedAt"; "required": false; }; "AgentName": { "alias": "AgentName"; "required": false; }; }, { "TurnSeek": "TurnSeek"; }, never, never, true, never>;
+}
+//# sourceMappingURL=realtime-evidence-playback.component.d.ts.map

package/dist/lib/components/realtime/evidence-playback/realtime-evidence-playback.component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-evidence-playback.component.d.ts","sourceRoot":"","sources":["../../../../../src/lib/components/realtime/evidence-playback/realtime-evidence-playback.component.ts"],"names":[],"mappings":"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"}