@memberjunction/server 6.2.0-edge.0 → 6.2.0-edge.2

package/dist/realtimeWidget/widgetCore.js

@@ -11,7 +11,7 @@
  *
  * @module @memberjunction/server/widget
  */
-import { buildSessionClaims } from '../auth/magicLink/magicLinkCore.js';
+import { BuildSessionClaims } from '../auth/magicLink/magicLinkCore.js';
 /**
  * The magic-link resource-scope `resourceType` used for a widget guest session. Pairs with the
  * opaque session id as `resourceId` so the synthesized principal's MagicLinkScope.ResourceID is
@@ -24,7 +24,7 @@ export const WIDGET_SESSION_RESOURCE_TYPE = 'Widget Session';
  * comma-separated string (tolerated). Returns an empty array for null/blank/garbage
  * — which makes the allowlist FAIL-CLOSED (no origin is allowed) by construction.
  */
-export function parseAllowedOrigins(allowedOrigins) {
+export function ParseAllowedOrigins(allowedOrigins) {
     const raw = allowedOrigins?.trim();
     if (!raw) {
         return [];
@@ -42,6 +42,10 @@ export function parseAllowedOrigins(allowedOrigins) {
     }
     return list.filter((s) => typeof s === 'string').map(normalizeOrigin).filter((s) => !!s);
 }
+/** @deprecated Use {@link ParseAllowedOrigins}. */
+export function parseAllowedOrigins(allowedOrigins) {
+    return ParseAllowedOrigins(allowedOrigins);
+}
 /** Lowercases + trims an origin and strips a trailing slash for stable comparison. */
 function normalizeOrigin(origin) {
     return origin.trim().toLowerCase().replace(/\/+$/, '');
@@ -51,7 +55,7 @@ function normalizeOrigin(origin) {
  * JSON array (preferred, e.g. `["Whiteboard"]`) or a comma-separated string (tolerated). Returns an
  * empty array for null/blank/garbage — the backwards-compatible default (no channels attached).
  */
-export function parseEnabledChannels(enabledChannels) {
+export function ParseEnabledChannels(enabledChannels) {
     const raw = enabledChannels?.trim();
     if (!raw) {
         return [];
@@ -65,41 +69,57 @@ export function parseEnabledChannels(enabledChannels) {
         return clean(raw.split(','));
     }
 }
+/** @deprecated Use {@link ParseEnabledChannels}. */
+export function parseEnabledChannels(enabledChannels) {
+    return ParseEnabledChannels(enabledChannels);
+}
 /**
  * FAIL-CLOSED origin check. The request's `Origin` header must exactly match one of
  * the widget's allowed origins (after normalization). A missing request origin, or
  * an empty allowlist, is rejected — a public mint endpoint must never accept "*".
  */
-export function isOriginAllowed(requestOrigin, allowedOrigins) {
+export function IsOriginAllowed(requestOrigin, allowedOrigins) {
     if (!requestOrigin || allowedOrigins.length === 0) {
         return false;
     }
     const candidate = normalizeOrigin(requestOrigin);
     return allowedOrigins.some((o) => o === candidate);
 }
+/** @deprecated Use {@link IsOriginAllowed}. */
+export function isOriginAllowed(requestOrigin, allowedOrigins) {
+    return IsOriginAllowed(requestOrigin, allowedOrigins);
+}
 /** True when the requested modality (or the widget's default render) is enabled by the instance. */
-export function isModalityEnabled(widgetModality, requested) {
+export function IsModalityEnabled(widgetModality, requested) {
     const m = widgetModality.trim().toLowerCase();
     if (m === 'both') {
         return true;
     }
     return m === requested.toLowerCase();
 }
+/** @deprecated Use {@link IsModalityEnabled}. */
+export function isModalityEnabled(widgetModality, requested) {
+    return IsModalityEnabled(widgetModality, requested);
+}
 /**
  * Pure eligibility check for a mint: the widget must be Active and the request's
  * origin must be on the allowlist. Returns an error code on the first failure so the
  * router can map it to a precise HTTP status. Modality is checked separately by the
  * voice path (W4) since a text mint is always permitted for an enabled widget.
  */
-export function evaluateWidgetMint(widget, requestOrigin) {
+export function EvaluateWidgetMint(widget, requestOrigin) {
     if (widget.Status.trim().toLowerCase() !== 'active') {
         return { ok: false, errorCode: 'disabled' };
     }
-    if (!isOriginAllowed(requestOrigin, parseAllowedOrigins(widget.AllowedOrigins))) {
+    if (!IsOriginAllowed(requestOrigin, ParseAllowedOrigins(widget.AllowedOrigins))) {
         return { ok: false, errorCode: 'origin_not_allowed' };
     }
     return { ok: true };
 }
+/** @deprecated Use {@link EvaluateWidgetMint}. */
+export function evaluateWidgetMint(widget, requestOrigin) {
+    return EvaluateWidgetMint(widget, requestOrigin);
+}
 /**
  * Known automated-client User-Agent substrings (lowercased). A public mint endpoint is a cheap
  * target for crawlers and scripted abuse; this catches the obvious non-browser callers. It is a
@@ -117,13 +137,17 @@ const BOT_USER_AGENT_MARKERS = [
  * known automation marker. Deliberately conservative to avoid false positives on real browsers; pair
  * with the origin allowlist + rate limits, which are the hard controls.
  */
-export function looksLikeBot(userAgent) {
+export function LooksLikeBot(userAgent) {
     const ua = (userAgent ?? '').trim().toLowerCase();
     if (!ua) {
         return true;
     }
     return BOT_USER_AGENT_MARKERS.some((marker) => ua.includes(marker));
 }
+/** @deprecated Use {@link LooksLikeBot}. */
+export function looksLikeBot(userAgent) {
+    return LooksLikeBot(userAgent);
+}
 /**
  * Builds the guest-session JWT claims for a widget visitor. Reuses magic-link's
  * `buildSessionClaims` (anonymous mode → the shared Anonymous principal + claims-based
@@ -131,8 +155,8 @@ export function looksLikeBot(userAgent) {
  * principal is locked to one widget instance. The role name carried here is the
  * widget's restricted guest role (D5 backstop).
  */
-export function buildWidgetGuestClaims(args) {
-    const claims = buildSessionClaims({
+export function BuildWidgetGuestClaims(args) {
+    const claims = BuildSessionClaims({
         issuer: args.issuer,
         audience: args.audience,
         // No invite row for a direct-mint guest; the opaque session id stands in as the
@@ -170,4 +194,8 @@ export function buildWidgetGuestClaims(args) {
     }
     return claims;
 }
+/** @deprecated Use {@link BuildWidgetGuestClaims}. */
+export function buildWidgetGuestClaims(args) {
+    return BuildWidgetGuestClaims(args);
+}
 //# sourceMappingURL=widgetCore.js.map

package/dist/realtimeWidget/widgetCore.js.map

@@ -1 +1 @@
-{"version":3,"file":"widgetCore.js","sourceRoot":"","sources":["../../src/realtimeWidget/widgetCore.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"widgetCore.js","sourceRoot":"","sources":["../../src/realtimeWidget/widgetCore.ts"],"names":[],"mappings":"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"}

package/dist/realtimeWidget/widgetGuestElevation.d.ts

@@ -17,19 +17,19 @@ import type { MJConversationWidgetInstanceEntity } from '@memberjunction/core-en
 import type { UserPayload } from '../types.js';
 /**
  * Resolved elevation context for a widget-guest agent run. Returned only when the request is a
- * widget guest; the dispatch resolver runs the agent under {@link WidgetGuestRunContext.elevatedUser}
- * with {@link WidgetGuestRunContext.pinnedAgentId} (authoritative), keeping ownership checks under
+ * widget guest; the dispatch resolver runs the agent under {@link WidgetGuestRunContext.ElevatedUser}
+ * with {@link WidgetGuestRunContext.PinnedAgentId} (authoritative), keeping ownership checks under
  * the guest principal.
  */
 export interface WidgetGuestRunContext {
     /** The trusted server principal under which the agent run (and its run-entity writes) executes. */
-    elevatedUser: UserInfo;
+    ElevatedUser: UserInfo;
     /** The widget instance the guest session is bound to (authoritative config). */
-    widget: MJConversationWidgetInstanceEntity;
+    Widget: MJConversationWidgetInstanceEntity;
     /** The authoritative pinned support agent id — overrides any client-supplied agent id (D5). */
-    pinnedAgentId: string;
+    PinnedAgentId: string;
     /** The guest's per-session scope id (Conversation.ExternalID), used to validate conversation ownership. */
-    sessionScopeId?: string;
+    SessionScopeId?: string;
 }
 /**
  * Returns elevation context when the request is a public web-widget guest, else `null` (the common
@@ -41,6 +41,8 @@ export interface WidgetGuestRunContext {
  * Never throws: a resolution failure (no system user, widget not found, read error) returns `null`,
  * so the caller falls back to the normal (guest-principal) path rather than failing the request.
  */
+export declare function ResolveWidgetGuestRunContext(userPayload: UserPayload, provider: DatabaseProviderBase): Promise<WidgetGuestRunContext | null>;
+/** @deprecated Use {@link ResolveWidgetGuestRunContext}. */
 export declare function resolveWidgetGuestRunContext(userPayload: UserPayload, provider: DatabaseProviderBase): Promise<WidgetGuestRunContext | null>;
 /**
  * Returns the identity a realtime session's AI-RUN-ENTITY work (delegated tool dispatch +
@@ -69,5 +71,7 @@ export declare function ResolveScopedAnonymousRunUser(contextUser: UserInfo): Us
  * preserving the guest's `sessionId` — so progress/streaming PubSub still routes to the guest's
  * live websocket, but all AI run-entity writes happen under the trusted server principal.
  */
+export declare function ElevateUserPayload(userPayload: UserPayload, elevatedUser: UserInfo): UserPayload;
+/** @deprecated Use {@link ElevateUserPayload}. */
 export declare function elevateUserPayload(userPayload: UserPayload, elevatedUser: UserInfo): UserPayload;
 //# sourceMappingURL=widgetGuestElevation.d.ts.map

package/dist/realtimeWidget/widgetGuestElevation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"widgetGuestElevation.d.ts","sourceRoot":"","sources":["../../src/realtimeWidget/widgetGuestElevation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAqB,KAAK,QAAQ,EAAE,KAAK,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACnG,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,+BAA+B,CAAC;AAExF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI/C;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC,mGAAmG;IACnG,YAAY,EAAE,QAAQ,CAAC;IACvB,gFAAgF;IAChF,MAAM,EAAE,kCAAkC,CAAC;IAC3C,+FAA+F;IAC/F,aAAa,EAAE,MAAM,CAAC;IACtB,2GAA2G;IAC3G,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;GASG;AACH,wBAAsB,4BAA4B,CAChD,WAAW,EAAE,WAAW,EACxB,QAAQ,EAAE,oBAAoB,GAC7B,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAyBvC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,6BAA6B,CAAC,WAAW,EAAE,QAAQ,GAAG,QAAQ,CAkB7E;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,GAAG,WAAW,CAOhG"}
+{"version":3,"file":"widgetGuestElevation.d.ts","sourceRoot":"","sources":["../../src/realtimeWidget/widgetGuestElevation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAqB,KAAK,QAAQ,EAAE,KAAK,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACnG,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,+BAA+B,CAAC;AAExF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI/C;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC,mGAAmG;IACnG,YAAY,EAAE,QAAQ,CAAC;IACvB,gFAAgF;IAChF,MAAM,EAAE,kCAAkC,CAAC;IAC3C,+FAA+F;IAC/F,aAAa,EAAE,MAAM,CAAC;IACtB,2GAA2G;IAC3G,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;GASG;AACH,wBAAsB,4BAA4B,CAChD,WAAW,EAAE,WAAW,EACxB,QAAQ,EAAE,oBAAoB,GAC7B,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAyBvC;AAED,4DAA4D;AAC5D,wBAAsB,4BAA4B,CAChD,WAAW,EAAE,WAAW,EACxB,QAAQ,EAAE,oBAAoB,GAC7B,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAEvC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,6BAA6B,CAAC,WAAW,EAAE,QAAQ,GAAG,QAAQ,CAkB7E;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,GAAG,WAAW,CAOhG;AAED,kDAAkD;AAClD,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,GAAG,WAAW,CAEhG"}

package/dist/realtimeWidget/widgetGuestElevation.js

@@ -25,7 +25,7 @@ const WIDGET_ENTITY = 'MJ: Conversation Widget Instances';
  * Never throws: a resolution failure (no system user, widget not found, read error) returns `null`,
  * so the caller falls back to the normal (guest-principal) path rather than failing the request.
  */
-export async function resolveWidgetGuestRunContext(userPayload, provider) {
+export async function ResolveWidgetGuestRunContext(userPayload, provider) {
     const guest = userPayload?.userRecord;
     const widgetId = guest?.WidgetGuestContext?.WidgetID;
     if (!guest?.IsMagicLinkAnonymous || !widgetId) {
@@ -42,12 +42,16 @@ export async function resolveWidgetGuestRunContext(userPayload, provider) {
         return null;
     }
     return {
-        elevatedUser,
-        widget,
-        pinnedAgentId: widget.PinnedAgentID,
-        sessionScopeId: guest.MagicLinkScope?.ResourceID,
+        ElevatedUser: elevatedUser,
+        Widget: widget,
+        PinnedAgentId: widget.PinnedAgentID,
+        SessionScopeId: guest.MagicLinkScope?.ResourceID,
     };
 }
+/** @deprecated Use {@link ResolveWidgetGuestRunContext}. */
+export async function resolveWidgetGuestRunContext(userPayload, provider) {
+    return ResolveWidgetGuestRunContext(userPayload, provider);
+}
 /**
  * Returns the identity a realtime session's AI-RUN-ENTITY work (delegated tool dispatch +
  * observability run creation/append/finalize) should execute as: the trusted SYSTEM principal when
@@ -89,7 +93,7 @@ export function ResolveScopedAnonymousRunUser(contextUser) {
  * preserving the guest's `sessionId` — so progress/streaming PubSub still routes to the guest's
  * live websocket, but all AI run-entity writes happen under the trusted server principal.
  */
-export function elevateUserPayload(userPayload, elevatedUser) {
+export function ElevateUserPayload(userPayload, elevatedUser) {
     return {
         ...userPayload,
         email: elevatedUser.Email,
@@ -97,6 +101,10 @@ export function elevateUserPayload(userPayload, elevatedUser) {
         isSystemUser: true,
     };
 }
+/** @deprecated Use {@link ElevateUserPayload}. */
+export function elevateUserPayload(userPayload, elevatedUser) {
+    return ElevateUserPayload(userPayload, elevatedUser);
+}
 /** Loads a single widget instance by id under the elevated principal (read-only). */
 async function loadWidgetById(widgetId, elevatedUser, provider) {
     const rv = new RunView(provider);

package/dist/realtimeWidget/widgetGuestElevation.js.map

@@ -1 +1 @@
-{"version":3,"file":"widgetGuestElevation.js","sourceRoot":"","sources":["../../src/realtimeWidget/widgetGuestElevation.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"widgetGuestElevation.js","sourceRoot":"","sources":["../../src/realtimeWidget/widgetGuestElevation.ts"],"names":[],"mappings":"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"}

package/dist/resolvers/AdhocQueryResolver.js

@@ -18,7 +18,7 @@ import { GetReadOnlyDataSource, GetReadOnlyProvider } from '../util.js';
 import { ResolverBase } from '../generic/ResolverBase.js';
 import { IsScopeLimitedPrincipal } from '../auth/scopeLimitedPrincipal.js';
 import { RunQueryResultType } from './QueryResolver.js';
-import { exactTotalFromPage, resolveAdhocTotalRowCount } from './adhoc-query-helpers.js';
+import { ExactTotalFromPage, ResolveAdhocTotalRowCount } from './adhoc-query-helpers.js';
 import sql from 'mssql';
 /**
  * Input type for executing ad-hoc SQL queries directly.
@@ -195,7 +195,7 @@ let AdhocQueryResolver = class AdhocQueryResolver extends ResolverBase {
         const dataResult = await this.runSqlWithDeadline(ds, dataSQL, deadline);
         const recordset = (dataResult.recordset ?? []);
         // Total already known from the page alone (unpaged, or a short page)? Skip the count.
-        const exact = exactTotalFromPage(startRow, recordset.length, maxRows);
+        const exact = ExactTotalFromPage(startRow, recordset.length, maxRows);
         if (exact != null || !countSQL) {
             return { recordset, totalRowCount: exact ?? recordset.length };
         }
@@ -203,7 +203,7 @@ let AdhocQueryResolver = class AdhocQueryResolver extends ResolverBase {
         const lowerBound = startRow + recordset.length;
         try {
             const countResult = await this.runSqlWithDeadline(ds, countSQL, deadline);
-            return { recordset, totalRowCount: resolveAdhocTotalRowCount(countResult.recordset, lowerBound) };
+            return { recordset, totalRowCount: ResolveAdhocTotalRowCount(countResult.recordset, lowerBound) };
         }
         catch (countErr) {
             const msg = countErr instanceof Error ? countErr.message : String(countErr);

package/dist/resolvers/AgentRunStatusPublisher.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Publishes one agent run's live status on the caller's session.
+ *
+ * `RunAIAgentResolver` uses this for every status it sends. A host whose
+ * `AgentTurnHandler` answers with an In-Progress reply uses the same publisher,
+ * on that caller's session, so the chat follows the turn: significant-step
+ * progress, streamed text, the partial result, and the completion. When the
+ * turn throws instead of returning a result, call `PublishFailure` with the
+ * reply row's id and the error.
+ */
+import type { PubSubEngine } from 'type-graphql';
+import type { AgentExecutionProgressCallback, AgentExecutionStreamingCallback, ExecuteAgentResult } from '@memberjunction/ai-core-plus';
+import type { UserPayload } from '../types.js';
+/** The run fields the published messages read. Entities and test fakes both satisfy this. */
+interface StatusRun {
+    ID?: string;
+    ConversationDetailID?: string;
+    ErrorMessage?: string;
+    Steps?: Array<{
+        StepName?: string;
+    }>;
+    GetAll?: () => unknown;
+}
+export declare class AgentRunStatusPublisher {
+    private readonly pubSub;
+    private readonly userPayload;
+    private readonly sessionId;
+    private run;
+    /**
+     * @param sessionId Session stamped on the message body. Defaults to the payload's session.
+     *   The push itself is always addressed to `userPayload.sessionId`, matching the resolver.
+     */
+    constructor(pubSub: PubSubEngine, userPayload: UserPayload, sessionId?: string);
+    /** Latest run observed from a progress event, including steps that are not published. */
+    get AgentRun(): StatusRun | null;
+    /** AgentRunner's progress callback. Noise steps are kept for {@link AgentRun} and not published. */
+    get OnProgress(): AgentExecutionProgressCallback;
+    /** AgentRunner's streaming callback. Publishes nothing until a progress event has carried the run. */
+    get OnStreaming(): AgentExecutionStreamingCallback;
+    /**
+     * The partial result, then the completion. `conversationDetailId` is the reply row the
+     * chat should update. When omitted, the completion uses the run's own detail id.
+     */
+    PublishFinal(result: ExecuteAgentResult, conversationDetailId?: string, resultJson?: string): void;
+    /**
+     * Completion for a failure that has no run. The fire-and-forget path uses this when
+     * `executeAIAgent` rejects. A host uses it the same way: when the turn throws
+     * instead of returning a result, call `PublishFailure` with the reply row's id
+     * and the error. That completion is what tells the chat the reply finished.
+     */
+    PublishFailure(conversationDetailId: string | undefined, errorMessage: string): void;
+    private publish;
+}
+export {};
+//# sourceMappingURL=AgentRunStatusPublisher.d.ts.map

package/dist/resolvers/AgentRunStatusPublisher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentRunStatusPublisher.d.ts","sourceRoot":"","sources":["../../src/resolvers/AgentRunStatusPublisher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EACR,8BAA8B,EAC9B,+BAA+B,EAC/B,kBAAkB,EACrB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAK/C,6FAA6F;AAC7F,UAAU,SAAS;IACf,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrC,MAAM,CAAC,EAAE,MAAM,OAAO,CAAC;CAC1B;AAED,qBAAa,uBAAuB;IAQ5B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAT9B,OAAO,CAAC,GAAG,CAA0B;IAErC;;;OAGG;gBAEkB,MAAM,EAAE,YAAY,EACpB,WAAW,EAAE,WAAW,EACxB,SAAS,GAAE,MAA8B;IAG9D,yFAAyF;IACzF,IAAW,QAAQ,IAAI,SAAS,GAAG,IAAI,CAEtC;IAED,oGAAoG;IACpG,IAAW,UAAU,IAAI,8BAA8B,CAgCtD;IAED,sGAAsG;IACtG,IAAW,WAAW,IAAI,+BAA+B,CAsBxD;IAED;;;OAGG;IACI,YAAY,CAAC,MAAM,EAAE,kBAAkB,EAAE,oBAAoB,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI;IA+BzG;;;;;OAKG;IACI,cAAc,CAAC,oBAAoB,EAAE,MAAM,GAAG,SAAS,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI;IAa3F,OAAO,CAAC,OAAO;CAYlB"}

package/dist/resolvers/AgentRunStatusPublisher.js

@@ -0,0 +1,141 @@
+import { PublishStatusUpdate } from '../generic/PushStatusResolver.js';
+const SIGNIFICANT_STEPS = ['prompt_execution', 'action_execution', 'subagent_execution', 'decision_processing'];
+export class AgentRunStatusPublisher {
+    /**
+     * @param sessionId Session stamped on the message body. Defaults to the payload's session.
+     *   The push itself is always addressed to `userPayload.sessionId`, matching the resolver.
+     */
+    constructor(pubSub, userPayload, sessionId = userPayload.sessionId) {
+        this.pubSub = pubSub;
+        this.userPayload = userPayload;
+        this.sessionId = sessionId;
+        this.run = null;
+    }
+    /** Latest run observed from a progress event, including steps that are not published. */
+    get AgentRun() {
+        return this.run;
+    }
+    /** AgentRunner's progress callback. Noise steps are kept for {@link AgentRun} and not published. */
+    get OnProgress() {
+        return (progress) => {
+            const fromEvent = progress.metadata?.agentRun;
+            if (fromEvent) {
+                this.run = fromEvent;
+            }
+            if (!SIGNIFICANT_STEPS.includes(progress.step)) {
+                return;
+            }
+            const agentRun = fromEvent || this.run;
+            if (!agentRun?.ID) {
+                // A host that streams before the first progress event otherwise sees nothing and no reason.
+                console.error('❌ No agent run available for progress callback');
+                return;
+            }
+            this.publish('ExecutionProgress', {
+                sessionId: this.sessionId,
+                agentRunId: agentRun.ID,
+                type: 'progress',
+                agentRun: agentRun.GetAll ? agentRun.GetAll() : agentRun,
+                progress: {
+                    currentStep: progress.step,
+                    percentage: progress.percentage,
+                    message: progress.message,
+                    agentName: progress.metadata?.agentName,
+                    agentType: progress.metadata?.agentType,
+                    stepCount: progress.metadata?.stepCount,
+                    hierarchicalStep: progress.metadata?.hierarchicalStep,
+                },
+                timestamp: new Date(),
+            });
+        };
+    }
+    /** AgentRunner's streaming callback. Publishes nothing until a progress event has carried the run. */
+    get OnStreaming() {
+        return (chunk) => {
+            const agentRun = this.run;
+            if (!agentRun?.ID) {
+                console.error('❌ No agent run available for streaming callback');
+                return;
+            }
+            this.publish('StreamingContent', {
+                sessionId: this.sessionId,
+                agentRunId: agentRun.ID,
+                type: 'streaming',
+                agentRun: agentRun.GetAll ? agentRun.GetAll() : agentRun,
+                streaming: {
+                    content: chunk.content,
+                    isPartial: !chunk.isComplete,
+                    stepName: chunk.stepType,
+                    agentName: chunk.modelName,
+                    kind: chunk.kind,
+                },
+                timestamp: new Date(),
+            });
+        };
+    }
+    /**
+     * The partial result, then the completion. `conversationDetailId` is the reply row the
+     * chat should update. When omitted, the completion uses the run's own detail id.
+     */
+    PublishFinal(result, conversationDetailId, resultJson) {
+        const agentRun = result.agentRun;
+        if (agentRun?.ID) {
+            let lastStep = 'Completed';
+            const steps = agentRun.Steps;
+            if (steps && steps.length > 0) {
+                lastStep = steps[steps.length - 1]?.StepName || 'Completed';
+            }
+            this.publish('StreamingContent', {
+                sessionId: this.sessionId,
+                agentRunId: agentRun.ID,
+                type: 'partial_result',
+                partialResult: {
+                    currentStep: lastStep,
+                    partialOutput: result.payload || undefined,
+                },
+                timestamp: new Date(),
+            });
+        }
+        this.publish('StreamingContent', {
+            sessionId: this.sessionId,
+            agentRunId: agentRun?.ID || 'unknown',
+            type: 'complete',
+            timestamp: new Date(),
+            conversationDetailId: conversationDetailId || agentRun?.ConversationDetailID,
+            success: result.success,
+            errorMessage: agentRun?.ErrorMessage || undefined,
+            result: resultJson || undefined,
+        });
+    }
+    /**
+     * Completion for a failure that has no run. The fire-and-forget path uses this when
+     * `executeAIAgent` rejects. A host uses it the same way: when the turn throws
+     * instead of returning a result, call `PublishFailure` with the reply row's id
+     * and the error. That completion is what tells the chat the reply finished.
+     */
+    PublishFailure(conversationDetailId, errorMessage) {
+        this.publish('StreamingContent', {
+            sessionId: this.sessionId,
+            agentRunId: 'unknown',
+            type: 'complete',
+            timestamp: new Date(),
+            conversationDetailId,
+            success: false,
+            errorMessage,
+            result: JSON.stringify({ success: false, errorMessage }),
+        });
+    }
+    publish(type, data) {
+        PublishStatusUpdate(this.pubSub, {
+            sessionId: this.userPayload.sessionId,
+            ownerUserId: this.userPayload?.userRecord?.ID ?? '',
+            message: JSON.stringify({
+                resolver: 'RunAIAgentResolver',
+                type,
+                status: 'ok',
+                data,
+            }),
+        });
+    }
+}
+//# sourceMappingURL=AgentRunStatusPublisher.js.map

package/dist/resolvers/AgentRunStatusPublisher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentRunStatusPublisher.js","sourceRoot":"","sources":["../../src/resolvers/AgentRunStatusPublisher.ts"],"names":[],"mappings":"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"}

package/dist/resolvers/ConversationRunEventsResolver.d.ts

@@ -0,0 +1,90 @@
+import type { AppContext } from '../types.js';
+/**
+ * One step of an agent run, projected for the client's progress view.
+ *
+ * Carries metadata only. `InputData`, `OutputData` and the payload snapshots are
+ * deliberately excluded: they are the largest columns on the row and a run can hold
+ * hundreds of steps, so including them would let a single tail call return tens of
+ * megabytes. The final result is delivered once, via `FinalPayload`, when the run
+ * reaches a terminal state.
+ */
+export declare class ConversationRunEvent {
+    /** Monotonic position within the run. The cursor a client pages from. */
+    Seq: number;
+    StepType: string;
+    StepName: string;
+    Status: string;
+    Success?: boolean;
+    ErrorMessage?: string;
+    StartedAt: Date;
+    CompletedAt?: Date;
+}
+/** Result of a tail call. */
+export declare class ConversationRunEventsOutput {
+    Success: boolean;
+    Message: string;
+    Events: ConversationRunEvent[];
+    /**
+     * Highest `Seq` the caller has now seen. Pass it back as `sinceSeq` on the next call.
+     * Echoes the request's `sinceSeq` when nothing new has landed, so a client that polls
+     * a quiet run never rewinds.
+     */
+    LatestSeq: number;
+    /**
+     * True while the run is still executing, including a run `Paused` on a workflow that is still
+     * running. False means terminal — stop tailing, and `FinalPayload` / `RunStatus` hold the
+     * outcome. A failed call (`Success` false) reports true, because it knows nothing about the run.
+     */
+    IsInFlight: boolean;
+    RunID?: string;
+    RunStatus?: string;
+    /**
+     * The run's answer, returned only once the run is terminal.
+     *
+     * Sourced from `AIAgentRun.Result`, falling back to the conversation detail's message because
+     * `Result` is agent-dependent and null on many successful runs. Still nullable: a caller must
+     * decide a message is finished from {@link IsInFlight} / {@link DetailStatus}, never from the
+     * presence of this field, or it will wait forever on an agent that writes neither.
+     */
+    FinalPayload?: string;
+    /** `ConversationDetail.Status` — the value the chat UI renders from. */
+    DetailStatus?: string;
+}
+/**
+ * Durable, resumable read of an agent run's progress (MJ #4222).
+ *
+ * The `statusUpdates` subscription is the only live path a conversation has, and it has no
+ * replay: the server topic is an in-memory PubSub and the client subject is explicitly
+ * unbuffered. Anything published while a socket is half-open is gone, and the client cannot
+ * tell the difference between "nothing happened" and "I missed everything".
+ *
+ * This query is the durable counterpart, mirroring `IntegrationTailRunEvents` — the same
+ * shape the integration subsystem already uses, where the subscription is a latency
+ * optimization over a log rather than the only delivery path. A client keeps the `LatestSeq`
+ * it has seen and re-reads from there after any interruption.
+ *
+ * It is a READ MODEL over tables that already exist. `AIAgentRunStep` rows are inserted when
+ * a step starts and updated when it finishes, so progress is visible mid-run, and
+ * `StepNumber` is already monotonic per run. No new table and no migration.
+ *
+ * Authorization is delegated to `RunView` executed as the calling user, so MJ's existing
+ * row-level security decides what is visible. A caller who cannot read the conversation
+ * detail gets the same answer as one asking about a detail that does not exist.
+ */
+export declare class ConversationRunEventsResolver {
+    TailConversationEvents(conversationDetailID: string, ctx: AppContext, sinceSeq?: number): Promise<ConversationRunEventsOutput>;
+    /** Loads the conversation detail as the calling user; null when absent or not permitted. */
+    private loadDetail;
+    /**
+     * Newest run for the detail. A conversation detail can be retried, and the latest run is
+     * the one the UI is showing.
+     */
+    private loadLatestRun;
+    /** Steps after `sinceSeq`, oldest first, bounded by {@link MAX_EVENTS_PER_TAIL}. */
+    private loadSteps;
+    /** Projects a plain step row to an event. Plain rows may carry dates as strings. */
+    private toEvent;
+    /** Escapes a value for the `ExtraFilter` string. Ids are UUIDs, but never trust the shape. */
+    private escape;
+}
+//# sourceMappingURL=ConversationRunEventsResolver.d.ts.map

package/dist/resolvers/ConversationRunEventsResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConversationRunEventsResolver.d.ts","sourceRoot":"","sources":["../../src/resolvers/ConversationRunEventsResolver.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAiB9C;;;;;;;;GAQG;AACH,qBACa,oBAAoB;IAC7B,yEAAyE;IAEzE,GAAG,EAAE,MAAM,CAAC;IAGZ,QAAQ,EAAE,MAAM,CAAC;IAGjB,QAAQ,EAAE,MAAM,CAAC;IAGjB,MAAM,EAAE,MAAM,CAAC;IAGf,OAAO,CAAC,EAAE,OAAO,CAAC;IAGlB,YAAY,CAAC,EAAE,MAAM,CAAC;IAGtB,SAAS,EAAE,IAAI,CAAC;IAGhB,WAAW,CAAC,EAAE,IAAI,CAAC;CACtB;AAED,6BAA6B;AAC7B,qBACa,2BAA2B;IAEpC,OAAO,EAAE,OAAO,CAAC;IAGjB,OAAO,EAAE,MAAM,CAAC;IAGhB,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAE/B;;;;OAIG;IAEH,SAAS,EAAE,MAAM,CAAC;IAElB;;;;OAIG;IAEH,UAAU,EAAE,OAAO,CAAC;IAGpB,KAAK,CAAC,EAAE,MAAM,CAAC;IAGf,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;;;;OAOG;IAEH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,wEAAwE;IAExE,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAkBD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBACa,6BAA6B;IAEhC,sBAAsB,CACmB,oBAAoB,EAAE,MAAM,EAChE,GAAG,EAAE,UAAU,EAC2B,QAAQ,CAAC,EAAE,MAAM,GACnE,OAAO,CAAC,2BAA2B,CAAC;IAoEvC,4FAA4F;YAC9E,UAAU;IAmBxB;;;OAGG;YACW,aAAa;IAqB3B,oFAAoF;YACtE,SAAS;IAsBvB,oFAAoF;IACpF,OAAO,CAAC,OAAO;IAaf,8FAA8F;IAC9F,OAAO,CAAC,MAAM;CAGjB"}